PackagePackagetypeA library you install and call yourself.See every one →What this type is →by SAPby SAPoriginPublished by SAP itself. A visible facet, never an input to a reading — a dormant official plugin reads exactly like a dormant independent one.See every one →

@sap-ux/odata-vocabularies

Carries the OASIS and SAP OData vocabularies as a package, with a VocabularyService for asking which terms exist, where they apply and what their types and properties are.

Annotation tooling needs the vocabularies before it can check anything: which terms exist, what they may be applied to, and what a term's type and properties are. This package keeps copies of the vocabularies OASIS and SAP publish and exposes them through VocabularyService, whose methods answer term applicability, types and properties, and documentation. The questions it answers are about the vocabulary rather than about a project, so nothing in it reads or writes the annotations of a particular service; that half is @sap-ux/fiori-annotation-api's. It declares Node.js 22 or later.

Facts

Latestv1.1.3ReleasedLast pushLicenceApache-2.0

Where it sits

Lives in
Provides
Fiori annotationsUI5CAPFiori annotationscapabilityDescribing a service so a Fiori client can render it without hand-written UI code — titles, value helps, hierarchies and visibility expressed as model annotations rather than screen logic.
Serves

Who is behind it

Austin DevineAustin DevinePersonMaintains this
In the atlas: maintains 7, contributes to 25
@devinea
SAPSAPOrganisationMaintains this
In the atlas: maintains 137, wrote 14
@SAP
maintainersCian MorrinPersonContributes to this
In the atlas: contributes to 15
@cianmSAP
Donal Tobin (SAP)PersonContributes to this
In the atlas: contributes to 13
@donal-tobin-sap
fionan-SAPPersonContributes to this
In the atlas: contributes to 14
@fionan-SAP
gernotkuhrPersonContributes to this
In the atlas: contributes to 10
@gernotkuhr
Dominik HeimPersonContributes to this
In the atlas: contributes to 25
@heimwege
Maruf RasullyPersonContributes to this
In the atlas: contributes to 12
@marufrasully
Vilim MikicPersonContributes to this
In the atlas: contributes to 16
@mikicvi-SAP
Nafees AhmedPersonContributes to this
In the atlas: contributes to 11
@nahmed22
Tobias QueckPersonContributes to this
In the atlas: contributes to 17
@tobiasqueck
Uwe SchwerkPersonContributes to this
In the atlas: contributes to 9
@UweSchwerk
13 contributors

What it declares

Every artifact

Type
Package
Origin
By SAP
Runtime
Node.js

As a package

Where it runs
does not say
Distributed through
npm

Connections1

Install

npm add @sap-ux/odata-vocabularies

Derived from the package name. No recipe recorded; the README has the configuration.

README

quoted from SAP/open-ux-tools under Apache-2.0, read
SAP/open-ux-tools/packages/odata-vocabularies/README.mdOn GitHub

Changelog Github repo

@sap-ux/odata-vocabularies

Library that contains the most recent copies of the OData vocabularies authored by OASIS and SAP

Supported Vocabularies

OASIS Vocabularies

  • Aggregation
  • Authorization
  • Core
  • Capabilities
  • Measures
  • Temporal
  • Repeatability
  • Validation
  • JSON

SAP Vocabularies

  • Analytics
  • Auditing
  • CodeList
  • Common
  • Communication
  • DataIntegration
  • DirectEdit
  • Graph
  • Hierarchy
  • HTML5
  • ODM
  • PDF
  • PersonalData
  • Session
  • Support
  • UI

Maintaining Vocabularies

Use the odata-vocabularies-sync skill (.agents/skills/odata-vocabularies-sync/SKILL.md) via an AI agent:

  • No argument — update all existing vocabularies to their latest published versions
  • With a JSON URL (must end in .json, XML is not supported) — register a new vocabulary, then update all

Local testing in tools-suite

To test local changes to this package inside the XML annotation language server of tools-suite, use yalc. pnpm link does not work there because the language server is an esbuild bundle and dependencies are resolved at build time.

Quick reference — after every change:

# in open-ux-tools/packages/odata-vocabularies
pnpm --filter @sap-ux/odata-vocabularies build
yalc push

# in tools-suite root
yalc add @sap-ux/odata-vocabularies
yarn build:scope sap-ux-annotation-modeler-extension
# restart the Extension Host in VS Code

Installation

Npm npm install --save @sap-ux/odata-vocabularies

Yarn yarn add @sap-ux/odata-vocabularies

Pnpm pnpm add @sap-ux/odata-vocabularies

Usage

  1. Import the needed functions in your modules

    import { VocabularyService } from '@sap-ux/odata-vocabularies';

Vocabulary API

The vocabulary API is implemented via class VocabularyService and currently exposes the following functions:

  • checkTermApplicability

  • getComplexType

  • getComplexTypeProperty

  • getDerivedTypeNames

  • getDocumentation

  • getTerm

  • getTermsForTargetKinds

  • getType

  • getVocabularies

  • getVocabulary

  • getVocabularyNamespace

Apache-2.0, read

History

Latest

v1.1.3

Dependencies 1

Notes
Patch Changes
Workspace Updates
  • @sap-ux/odata-annotation-core-types 1.0.3 → 1.0.4
  1. v1.1.2

    Dependencies 1

    Notes
    Patch Changes
    Workspace Updates
    • @sap-ux/odata-annotation-core-types 1.0.2 → 1.0.3
  2. v1.1.1

    Dependencies 1

    Notes
    Patch Changes
    Workspace Updates
    • @sap-ux/odata-annotation-core-types 1.0.1 → 1.0.2
  3. v1.1.0

    Features 1

    Notes
    Minor Changes
    Release Date

    2026-08-06

    Features
    • Correct README — add missing SAP vocabularies (Auditing, CDS, Support) and fix wrong package import path [9b18470]
  4. v1.0.5

    Fixes 1

    Notes
    Patch Changes
    Release Date

    2026-07-22

    Bug Fixes
    • vocabulary loader - support vocabulary [b7f0c85]
  5. v1.0.4

    Dependencies 1

    Notes
    Patch Changes
    Dependency Updates
    • upgrade axios dependency [526d59b]
  6. v1.0.3

    Dependencies 1

    Notes
    Patch Changes
    Dependency Updates
    • Bulk upgrade of minor dependencies and devDependencies [5ce779c]
  7. v1.0.2

    Fixes 1

    Notes
    Patch Changes
    Release Date

    2026-06-23

    Bug Fixes
  8. v1.0.1

    Fixes 2

    Notes

    Released: 2026-06-03T14:58:37Z

    Patch Changes
    • 21a3de7: FIX: TypeScript type errors in test files (ESM migration follow-up)
    • Updated dependencies [21a3de7]
      • @sap-ux/odata-annotation-core-types@1.0.1
  9. v1.0.0dated in the atlas

    Breaking 1, Fixes 1

    Notes

    Released: 2026-05-30T20:54:07Z

    Major Changes
    • 32609a7: # Migration to ECMAScript Modules (ESM)

      Packages in the SAP Open UX Tools monorepo have been migrated from CommonJS (CJS) to ECMAScript Modules (ESM) with NodeNext module resolution.

      '@sap-ux/backend-proxy-middleware-cf' is experimental and will remain at major version 0. '@sap-ux/generator-odata-downloader' is a top level yeoman generator and will remain as CJS until validation as ESM is done.

      What Changed

      • Module System: Most packages now use native ESM ("type": "module" in package.json)
      • TypeScript Configuration: Updated to module: "NodeNext" and moduleResolution: "NodeNext"
      • Import Statements: All relative imports now include explicit .js extensions (per ESM spec)
      • Build Output: Generated JavaScript files are now ESM modules
      • Node.js Requirement: Minimum Node.js version remains >=22.x
      Jest Configuration (for Testing)

      If your project tests code that imports these packages, update your Jest configuration:

      export default {
          extensionsToTreatAsEsm: ['.ts'],
          transform: {
              '^.+\\.ts$': ['ts-jest', { useESM: true }]
          }
      };

      And run Jest with: NODE_OPTIONS='--experimental-vm-modules' jest

    Patch Changes
    • Updated dependencies [32609a7]
      • @sap-ux/odata-annotation-core-types@1.0.0
  10. v0.5.1

    Fixes 1

    Notes

    Released: 2026-05-20T13:39:22Z

    Patch Changes
    • Updated dependencies [2f1ece0]
      • @sap-ux/odata-annotation-core-types@0.6.1
  11. v0.5.0

    Features 1, Fixes 1

    Notes

    Released: 2026-05-15T08:12:20Z

    Minor Changes
    • 72695e5: chore: drop Node 20 support as it is no longer maintained
    Patch Changes
    • Updated dependencies [72695e5]
      • @sap-ux/odata-annotation-core-types@0.6.0
  12. v0.4.32

    Fixes 2

    Notes

    Released: 2026-05-14T11:45:51Z

    Patch Changes
    • 50a8ba5: chore: fresh release after workflow updates
    • Updated dependencies [50a8ba5]
      • @sap-ux/odata-annotation-core-types@0.5.9
  13. v0.4.31

    Fixes 1

    Notes

    Released: 2026-04-30T14:23:24Z

    Patch Changes
    • @sap-ux/odata-annotation-core-types@0.5.8
  14. v0.4.30

    Fixes 1

    Notes

    Released: 2026-03-30T22:24:11Z

    Patch Changes
    • c53a4ba: chore(odata-vocabularies): upgrade prettier 2.5.1 → 3.8.1; remove @types/prettier (types now bundled in prettier 3.x)
  15. v0.4.29

    Fixes 1

    Notes

    Released: 2026-03-16T17:06:45Z

    Patch Changes
    • Updated dependencies [dfa433e]
      • @sap-ux/odata-annotation-core-types@0.5.7
  16. v0.4.28

    Fixes 1

    Notes

    Released: 2026-03-11T16:49:00Z

    Patch Changes
    • 79e69b9: fix: update vocabularies
  17. v0.4.27

    Fixes 1

    Notes

    Released: 2026-03-04T09:03:38Z

    Patch Changes
    • Updated dependencies [a2cbf4e]
      • @sap-ux/odata-annotation-core-types@0.5.6
  18. v0.4.26

    Fixes 2

    Notes

    Released: 2026-02-23T19:07:48Z

    Patch Changes
    • cc1c422: fix(deps): update dependency npm-run-all2 to v8
    • Updated dependencies [cc1c422]
      • @sap-ux/odata-annotation-core-types@0.5.5
  19. v0.4.25

    Fixes 1

    Notes

    Released: 2026-02-17T01:38:30Z

    Patch Changes
    • 1fa3bb7: update vocabularies
  20. v0.4.24

    Fixes 1

    Notes

    Released: 2026-02-10T23:50:15Z

    Patch Changes
    • 2fc459c: Upgrade axios
  21. v0.4.23

    Fixes 2

    Notes

    Released: 2026-02-10T21:03:43Z

    Patch Changes
    • 3795bb2: Add Node.js engine requirement (>=20.x)
    • Updated dependencies [3795bb2]
      • @sap-ux/odata-annotation-core-types@0.5.4
  22. v0.4.22

    Fixes 1

    Notes

    Released: 2026-01-29T14:02:02Z

    Patch Changes
    • Updated dependencies [6d71400]
      • @sap-ux/odata-annotation-core-types@0.5.3
  23. v0.4.21

    Fixes 1

    Notes

    Released: 2025-12-18T21:05:02Z

    Patch Changes
    • a9471d0: fix sonar issues
  24. v0.4.20

    Fixes 2

    Notes

    Released: 2025-12-15T10:50:50Z

    Patch Changes
    • 4ecfbe2: Chore - upgrade eslint devDependenies, convert to flat config and fix lint issues.
    • Updated dependencies [4ecfbe2]
      • @sap-ux/odata-annotation-core-types@0.5.2
  25. v0.4.19

    Fixes 1

    Notes

    Released: 2025-12-04T09:20:42Z

    Patch Changes
    • 76742fa: vocabulary update
  26. v0.4.18

    Fixes 2

    Notes

    Released: 2025-11-05T06:53:42Z

    Patch Changes
    • cfe9c13: Add deep link to package and changelog to README.md
    • Updated dependencies [cfe9c13]
      • @sap-ux/odata-annotation-core-types@0.5.1
  27. v0.4.17

    Fixes 1

    Notes

    Released: 2025-10-15T11:57:34Z

    Patch Changes
    • ccb5285: vocabulary update
  28. v0.4.16

    Fixes 1

    Notes

    Released: 2025-10-06T17:09:01Z

    Patch Changes
    • 43a2446: chore: fix Sonar issues
  29. v0.4.15

    Fixes 1

    Notes

    Released: 2025-09-23T16:06:33Z

    Patch Changes
    • Updated dependencies [aa8bb7a]
      • @sap-ux/odata-annotation-core-types@0.5.0
  30. v0.4.14

    Fixes 1

    Notes

    Released: 2025-09-19T16:36:41Z

    Patch Changes
    • 9872384: Upgrade axios module
  31. v0.4.13

    Fixes 1

    Notes

    Released: 2025-09-16T20:04:56Z

    Patch Changes
    • Updated dependencies [1f18878]
      • @sap-ux/odata-annotation-core-types@0.4.6
  32. v0.4.12

    Fixes 1

    Notes

    Released: 2025-08-28T13:37:07Z

    Patch Changes
    • 4cfebaf: Update axios module
  33. v0.4.11

    Fixes 1

    Notes

    Released: 2025-08-13T10:00:10Z

    Patch Changes
    • Updated dependencies [c7db726]
      • @sap-ux/odata-annotation-core-types@0.4.5
  34. v0.4.10

    Fixes 1

    Notes

    Released: 2025-06-16T13:15:49Z

    Patch Changes
    • 070dcb2: update vocabularies
  35. v0.4.9

    Fixes 1

    Notes

    Released: 2025-06-10T10:19:01Z

    Patch Changes
    • Updated dependencies [08ed948]
      • @sap-ux/odata-annotation-core-types@0.4.4
  36. v0.4.8

    Fixes 1

    Notes

    Released: 2025-05-14T22:35:53Z

    Patch Changes
    • @sap-ux/odata-annotation-core-types@0.4.3
  37. v0.4.7

    Fixes 1

    Notes

    Released: 2025-03-10T20:40:35Z

    Patch Changes
    • 011c8c5: fix(deps): update dependency axios to v1.8.2 [security]
  38. v0.4.6

    Fixes 1

    Notes

    Released: 2025-02-11T12:08:20Z

    Patch Changes
    • 3f273c9: update vocabularies
  39. v0.4.5

    Fixes 1

    Notes

    Released: 2025-01-15T13:31:47Z

    Patch Changes
    • 54b6d61: fix: updateVocabularies
  40. v0.4.4

    Fixes 1

    Notes

    Released: 2024-10-22T09:42:10Z

    Patch Changes
    • 8af1ba2: update vocabularies
  41. v0.4.3

    Fixes 2

    Notes

    Released: 2024-10-04T15:21:13Z

    Patch Changes
    • 93f8a83: chore - upgrade typescript 5.6.2
    • Updated dependencies [93f8a83]
      • @sap-ux/odata-annotation-core-types@0.4.2
  42. v0.4.2

    Fixes 1

    Notes

    Released: 2024-08-19T09:48:14Z

    Patch Changes
    • 9c8dc5c: fix: update axios to 1.7.4
  43. v0.4.1

    Fixes 1

    Notes

    Released: 2024-08-07T11:06:05Z

    Patch Changes
    • @sap-ux/odata-annotation-core-types@0.4.1
  44. v0.4.0

    Breaking 1, Features 1, Fixes 1

    Notes

    Released: 2024-07-05T15:03:05Z

    Minor Changes
    • c2359077: [BREAKING CHANGE] Change TypeScript transpile target to ES2021 to align with NodeJS 18+
    Patch Changes
    • Updated dependencies [c2359077]
      • @sap-ux/odata-annotation-core-types@0.4.0
  45. v0.3.8

    Fixes 1

    Notes

    Released: 2024-06-20T13:03:49Z

    Patch Changes
    • d09edfd5: Update vocabularies June 2024
  46. v0.3.7

    Fixes 1

    Notes

    Released: 2024-04-03T09:16:44Z

    Patch Changes
    • 95c72dff: update vocabularies content
  47. v0.3.6

    Fixes 1

    Notes

    Released: 2024-03-22T08:51:54Z

    Patch Changes
    • 61b46bc8: Security upgrade fixes
  48. v0.3.5

    Fixes 1

    Notes

    Released: 2024-03-14T15:29:35Z

    Patch Changes
    • 82c07285: OData Vocabularies: Update Some Texts in Specific Vocabularies For Analytics Support in CDS
  49. v0.3.4

    Fixes 2

    Notes

    Released: 2024-02-07T11:10:48Z

    Patch Changes
    • eb0b7b37: Chore - TypeScript 5 upgrade
    • Updated dependencies [eb0b7b37]
      • @sap-ux/odata-annotation-core-types@0.3.1
  50. v0.3.3

    Fixes 1

    Notes

    Released: 2024-01-24T11:05:22Z

    Patch Changes
    • aa8469f3: OData Vocabularies: Update Vocabularies Containing Cds Specific Analytics Annotations
  51. v0.3.2

    Fixes 1

    Notes

    Released: 2024-01-19T16:44:06Z

    Patch Changes
    • 820ad0dc: odata-vocabularies for CDS analytics: use IsFLags for collection of enums, remove empty lines
  52. v0.3.1

    Fixes 1

    Notes

    Released: 2024-01-17T08:59:35Z

    Patch Changes
    • 2f1f8366: fix(odata-vocabularies): replace alias ODataJSON with JSON
  53. v0.3.0

    Features 1

    Notes

    Released: 2024-01-16T12:59:00Z

    Minor Changes
    • 39877d71: support loading additional terms for cap cds analytics features
  54. v0.2.1

    Fixes 1

    Notes

    Released: 2024-01-09T09:27:13Z

    Patch Changes
    • Updated dependencies [d6151909]
      • @sap-ux/odata-annotation-core-types@0.3.0
  55. v0.2.0

    Features 1, Fixes 1

    Notes

    Released: 2023-12-12T07:54:42Z

    Minor Changes
    • 5b256cea: support applicable terms constraint
    Patch Changes
    • Updated dependencies [5b256cea]
      • @sap-ux/odata-annotation-core-types@0.2.0
  56. v0.1.6

    Fixes 1

    Notes

    Released: 2023-12-07T12:16:28Z

    Patch Changes
    • Updated dependencies [807e2857]
      • @sap-ux/odata-annotation-core-types@0.1.3
  57. v0.1.5

    Fixes 1

    Notes

    Released: 2023-12-04T14:20:02Z

    Patch Changes
    • 1df7493f: fix: enable and fill applicableterms
  58. v0.1.4

    Fixes 1

    Notes

    Released: 2023-11-24T09:29:29Z

    Patch Changes
    • 89a1bf27: fix: change access type of uppercaseNameMap prop
  59. v0.1.3

    Fixes 1

    Notes

    Released: 2023-11-24T08:58:15Z

    Patch Changes
    • fd883c14: fix: enable uppercaseNameMap property in vocabulary service
  60. v0.1.2

    Fixes 1

    Notes

    Released: 2023-11-22T12:13:22Z

    Patch Changes
    • 860a43a6: fix: update tesconfig to generate correct files order in dist
  61. v0.1.1

    Fixes 1

    Notes
    Patch Changes
    • 284c396c: feat: move ux vocabulary module
9,942downloads per week, npm
Weekly downloads for @sap-ux/odata-vocabularies26 complete calendar weeks from 2026-04-20 to 2026-10-18; the latest total is 9942.20 Apr – 26 Apr: 61,98927 Apr – 3 May: 55,2314 May – 10 May: 55,73611 May – 17 May: 63,13918 May – 24 May: 71,80925 May – 31 May: 65,5241 Jun – 7 Jun: 52,5938 Jun – 14 Jun: 66,96115 Jun – 21 Jun: 60,29322 Jun – 28 Jun: 50,45029 Jun – 5 Jul: 43,6756 Jul – 12 Jul: 34,77013 Jul – 19 Jul: 31,85620 Jul – 26 Jul: 29,81027 Jul – 2 Aug: 23,3603 Aug – 9 Aug: 24,79110 Aug – 16 Aug: 17,91917 Aug – 23 Aug: 21,19224 Aug – 30 Aug: 20,04031 Aug – 6 Sept: 17,0027 Sept – 13 Sept: 13,40714 Sept – 20 Sept: 16,10821 Sept – 27 Sept: 20,76028 Sept – 4 Oct: 20,4075 Oct – 11 Oct: 18,43812 Oct – 18 Oct: 9,942

Details

Sources5
GitHub APIdiscovered here, SAP/open-ux-toolschecked
npm registrydiscovered herechecked
npm registry, @sap-ux/odata-vocabulariesversion, releases, installschecked
github.com/https://github.com/SAP/open-ux-tools.gittree, pushes, contributors, CIchecked
packages/odata-vocabularies/README.mdquoted, and what the entry declareschecked

Sources are graph entities: the same page may back several entries, and an unreachable source flags every row that rests on it.

Compatibility and provenance
runtimesnode
latestv1.1.3
first release
releases and cadence61, ~19d median
discovered viaGitHub API · SAP/open-ux-tools, npm registry
first seen in the atlas
ecosystem and domainui5, ui-and-frontend-bridge
Contributors13
History in the atlas1
  1. First seen.
For your agent
Ref
artifact:sap-ux-odata-vocabularies
JSON
/artifacts/sap-ux-odata-vocabularies.json
MCP
Connecting an agent