Patch release 2026.5.7

.github/CODEOWNERS

@@ -2,11 +2,11 @@
 # We start with defining ownership globally and later on can get more granular.
 
 # General content
-* @renejeglinsky @danjoa
+* @smahati @danjoa
 
-node.js/ @smahati @renejeglinsky @danjoa
-java/    @smahati @renejeglinsky @danjoa
-tools/   @chgeo @swaldmann @renejeglinsky
+node.js/ @smahati @danjoa
+java/    @smahati @danjoa
+tools/   @chgeo @swaldmann @smahati
 
 # Infra
 .github/    @chgeo @swaldmann

.github/workflows/main.yml

@@ -25,13 +25,13 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v7
       - name: Setup Pages
-        uses: actions/configure-pages@v5
+        uses: actions/configure-pages@v6
       - name: Use Node.js
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v6
         with:
-          node-version: 22
+          node-version: 24
           cache: 'npm'
       - run: npm ci
       - run: npm run lint
@@ -58,4 +58,4 @@ jobs:
     steps:
       - name: Deploy to GitHub Pages
         id: deployment
-        uses: actions/deploy-pages@v4
+        uses: actions/deploy-pages@v5

.vitepress/config.js

@@ -97,11 +97,6 @@ const config = defineConfig({
 
   vite: {
     plugins: [...playground.plugins()],
-    esbuild: {
-      supported: {
-        'top-level-await': true //browsers can handle top-level-await features in special cases
-      },
-    },
     build: {
       chunkSizeWarningLimit: 6000, // chunk for local search index dominates
     },
@@ -139,8 +134,8 @@ const siteURL = new URL(process.env.SITE_HOSTNAME || 'http://localhost:4173/docs
 if (!siteURL.pathname.endsWith('/'))  siteURL.pathname += '/'
 config.themeConfig.capire = {
   versions: {
-    java_services: '5.0.0',
-    java_cds4j: '5.0.0',
+    java_services: '5.0.2',
+    java_cds4j: '5.0.2',
     cloud_sec_ams: '3.8.1'
   },
   gotoLinks: [],
@@ -169,7 +164,7 @@ config.themeConfig.search = {
         tokenize: text => text.split( /[\n\r #%*,=/:;?[\]{}()&]+/u ), // simplified charset: removed [-_.@] and non-english chars (diacritics etc.)
         processTerm: (term, fieldName) => {
           term = term.trim().toLowerCase().replace(/^\.+/, '').replace(/\.+$/, '')
-          const stopWords = ['frontmatter', '$frontmatter.synopsis', 'and', 'about', 'but', 'now', 'the', 'with', 'you']
+          const stopWords = ['frontmatter', '$frontmatter.description', 'and', 'about', 'but', 'now', 'the', 'with', 'you']
           if (term.length < 2 || stopWords.includes(term))  return false
 
           if (fieldName === 'text') {

.vitepress/theme/components/ConfigInspect.vue

@@ -120,7 +120,7 @@
 
     pkgStr.value = JSON.stringify(pkg, null, 2)
     rcJsonStr.value = JSON.stringify(pkg.cds??{}, null, 2)
-    rcJsStr.value = 'exports.' + Object.keys(pkg.cds??{})[0] + ' = ' + (JSON.stringify(Object.values(pkg.cds??{})[0], null, 2)??'').replaceAll('"', '')
+    rcJsStr.value = 'exports.' + Object.keys(pkg.cds??{})[0] + ' = ' + (JSON.stringify(Object.values(pkg.cds??{})[0], null, 2)??'').replace(/"([^"]+)":/g, '$1:')
     rcYmlStr.value = yaml.stringify(pkg.cds)
 
     let envKey = fqn.replaceAll('_', '__').replaceAll(keyDel, '_')

.vitepress/theme/components/IndexList.vue

@@ -11,7 +11,7 @@
   <dl class="index" v-else>
     <template v-for="p in pages" :key="p.url">
       <dt><a :href="p.url">{{ p.title }}</a></dt>
-      <dd v-html="p.frontmatter?.synopsis || ''"></dd>
+      <dd v-html="p.frontmatter?.description || ''"></dd>
     </template>
   </dl>
 </template>

.vitepress/theme/components/ShortcutsList.vue

@@ -6,7 +6,7 @@
           <span class="modal-close" title="Close dialog" @click="visible = false">&times;</span>
           <h5 class="no-anchor">Keyboard Shortcuts</h5>
         </div>
-        <div id="shortcuts-list" class="modal-body">
+        <div id="shortcuts-list" class="modal-body no-wide">
           <table>
             <tr v-for="cmd in activeCommands" :key="cmd.name">
               <td>{{ cmd.name }}</td>
@@ -194,8 +194,11 @@ td, th {
 /* Modal Content */
 .modal-content {
   position: relative;
+  display: flex;
+  flex-direction: column;
   overflow: hidden;
   resize: both;
+  box-sizing: border-box;
   background-color: var(--vp-c-bg-soft);
   margin: 10% auto;
   border: 1px solid var(--vp-c-divider);
@@ -219,6 +222,9 @@ td, th {
 
 /* Modal Body */
 .modal-body {
+  flex: 1 1 auto;
+  min-height: 0;
+  overflow: auto;
   font-size: 14px;
 }
 

.vitepress/theme/components/StatusBadge.vue

@@ -1,17 +1,11 @@
 <template>
-  <Badge
-    :type="type"
-    :text="text"
-    :title="title"
-    @click="click" style="cursor: pointer"
-  />
+  <!-- ignore-header: excludes this link's text from the outline/TOC (see VitePress serializeHeader) -->
+  <a :href="withBase('/releases/#status-badges')" class="ignore-header">
+    <Badge :type="type" :text="text" :title="title" />
+  </a>
 </template>
 
 <script setup lang="ts">
 defineProps<{ type: string, text:string, title:string  }>()
-
 import { withBase } from 'vitepress'
-function click() {
-  location.href = withBase('/releases/index#status-badges')
-}
 </script>

.vitepress/theme/components/cds-playground/MonacoEditor.vue

@@ -10,7 +10,6 @@
 
 <script setup>
 import { ref, watch, onMounted, onUnmounted } from 'vue'
-import 'monaco-editor/min/vs/editor/editor.main.css'
 import { useData } from 'vitepress'
 
 const { isDark } = useData()

.vitepress/theme/components/cds-playground/monaco.js

@@ -3,14 +3,7 @@ import { shikiToMonaco } from '@shikijs/monaco'
 
 // no correct top-level await in Safari
 async function setupMonaco() {
-  const [monaco, editorWorker, tsWorker] = await Promise.all([
-    import('monaco-editor/esm/vs/editor/editor.api'),
-    import('monaco-editor/esm/vs/editor/editor.worker?worker'),
-    import('monaco-editor/esm/vs/language/typescript/ts.worker?worker'),
-    import('monaco-editor/esm/vs/basic-languages/javascript/javascript.contribution'),
-    import('monaco-editor/esm/vs/language/typescript/monaco.contribution'),
-    import('monaco-editor/esm/vs/language/json/monaco.contribution')
-  ])
+  const monaco = await import('monaco-editor')
 
   monaco.languages.register({ id: 'javascript' })
   monaco.languages.register({ id: 'js' })
@@ -20,8 +13,15 @@ async function setupMonaco() {
 
   self.MonacoEnvironment = {
     getWorker(_, label) {
-      if (label === 'typescript' || label === 'javascript') return new tsWorker.default()
-      return new editorWorker.default()
+      const getWorkerModule = (moduleUrl, label) => {
+        return new Worker(self.MonacoEnvironment.getWorkerUrl(moduleUrl), {
+          name: label,
+          type: 'module'
+        });
+      };
+
+      if (label === 'typescript' || label === 'javascript') return getWorkerModule('/monaco-editor/esm/vs/language/typescript/ts.worker?worker', label)
+      return getWorkerModule('/monaco-editor/esm/vs/editor/editor.worker?worker', label);
     }
   }
 

.vitepress/theme/components/indexFilter.ts

@@ -31,7 +31,7 @@ export default (pages:ContentDataCustom[], basePath:string):ContentDataCustom[]
       url: p.url,
       title: p.title,
       frontmatter: {
-        synopsis: p.frontmatter.synopsis
+        description: p.frontmatter.description
       },
       // this data is inlined in each index page, so omit unnecessary data
       src:undefined, html:undefined, excerpt:undefined

.vitepress/theme/styles.scss

@@ -358,6 +358,22 @@ img, video.bright {
   white-space: nowrap;
 }
 
+// Safari may render the invisible Unicode marker used by VitePress as tofu blocks.
+// Apply this workaround only to Safari-capable engines.
+@supports (font: -apple-system-body) and (-webkit-appearance: none) {
+  .vp-external-link-icon::after,
+  .external-link-icon-enabled :is(.vp-doc a[href*='://'], .vp-doc a[target='_blank']):not(:is(.no-icon, svg a, :has(img, svg)))::after {
+    content: '';
+    display: inline-block;
+    width: 11px;
+    height: 11px;
+    padding-left: 0;
+    margin-left: 4px;
+    line-height: 1;
+    vertical-align: text-top;
+  }
+}
+
 
 
 

cds/annotations.md

@@ -1,15 +1,12 @@
 ---
-# layout: cds-ref
-shorty: Annotations
-synopsis: >
+description: >
   Find here a reference and glossary of common annotations intrinsically supported by the CDS compiler and runtimes.
-status: released
 uacp: Used as link target from Help Portal at https://help.sap.com/products/BTP/65de2977205c403bbc107264b8eccf4b/855e00bd559742a3b8276fbed4af1008.html
 ---
 
 # Common Annotations
 
-{{ $frontmatter.synopsis }}
+{{ $frontmatter.description }}
 
 [Learn more about the syntax of annotations.](./cdl#annotations){.learn-more}
 

cds/aspects.md

@@ -1,7 +1,6 @@
 ---
-synopsis: >
+description: >
   Discusses the differences of the mixin-based approach of Aspects to inheritance as known from languages like Java.
-status: released
 ---
 
 # Aspect-Oriented Modeling

cds/cdl.md

@@ -1,7 +1,6 @@
 ---
-# shorty: Definition Language
-synopsis: >
-  Specification of the definition language used to model data models and services in an easy and user-centric syntax. Includes a reference and overview of all CDS concepts and features with compact examples.
+description: >
+  Specification of the definition language used to model data models and services in an easy, user-centric syntax, including a reference and overview of all CDS concepts and features with compact examples.
 #permalink: /cds/cdl/
 uacp: Used as link target from Help Portal at https://help.sap.com/products/BTP/65de2977205c403bbc107264b8eccf4b/855e00bd559742a3b8276fbed4af1008.html
 ---
@@ -285,7 +284,7 @@ CDL supports line-end, block comments, and *doc* comments as in Java and JavaScr
 /** doc comment */
 ```
 
-#### Doc Comments 
+#### Doc Comments
 
 A multi-line comment of the form `/** … */` at an [annotation position](#annotation-targets) is considered a *doc comment*:
 
@@ -451,7 +450,7 @@ type EmailAddress : { kind:String; address:String; }
 
 > Keywords `many` and `array of` are mere syntax variants with identical semantics and implementations.
 
-When deployed to SQL databases, such fields are mapped to [LargeString](./types) columns and the data is stored denormalized as JSON array. 
+When deployed to SQL databases, such fields are mapped to [LargeString](./types) columns and the data is stored denormalized as JSON array.
 With OData V4, arrayed types are rendered as `Collection` in the EDM(X).
 
 
@@ -858,7 +857,7 @@ Result result = service.run(Select.from("UsingView"), params);
 
 ### Runtime Views { #runtimeviews }
 
-To add or update CDS views without redeploying the database schema, annotate them with [@cds.persistence.skip](../guides/databases/cdl-to-ddl#cdspersistenceskip). This advises the CDS compiler to skip generating database views for these CDS views. Instead, CAP resolves them *at runtime* on each request. 
+To add or update CDS views without redeploying the database schema, annotate them with [@cds.persistence.skip](../guides/databases/cdl-to-ddl#cdspersistenceskip). This advises the CDS compiler to skip generating database views for these CDS views. Instead, CAP resolves them *at runtime* on each request.
 
 Runtime views must be simple [projections](#as-projection-on), not using *aggregations*, *join*, *union* or *subqueries* in the *from* clause, but may have a *where* condition if they are only used to read.
 
@@ -934,7 +933,7 @@ entity Addresses {
 ```
 
 
-### Managed (To-One) Associations 
+### Managed (To-One) Associations
 ###### managed-associations
 
 For to-one associations, CDS can automatically resolve and add requisite foreign key elements from the target's primary keys and implicitly add respective join conditions.
@@ -1154,7 +1153,7 @@ entity P_Authors as projection on Authors {
 In this example, in addition to `books` projection `P_Authors` has a new association `availableBooks`
 that points only to those books where `stock > 0`.
 
-If the filter condition effectively reduces the cardinality of the association
+If the filter condition effectively reduces the cardinality of the association (or composition)
 to one, you should make this explicit in the filter by adding a `1:` before the condition:
 
 ```cds
@@ -1164,6 +1163,12 @@ entity P_Employees as projection on Employees {
 }
 ```
 
+::: warning `:1` doesn't itself reduce the cardinality
+The `:1` syntax itself has no effect on the cardinality. It is only an information by the developer
+that the specified condition reduces the cardinality of the association or composition to one.
+:::
+
+
 Filters usually are provided only for to-many associations, which usually are unmanaged.
 Thus publishing with a filter is almost exclusively used for unmanaged associations.
 Nevertheless you can also publish a managed association with a filter. This will automatically

cds/common.md

@@ -1,6 +1,5 @@
 ---
-# layout: cds-ref
-synopsis: >
+description: >
   Introduces <i>@sap/cds/common</i>, a prebuilt CDS model shipped with <i>@sap/cds</i> that provides common types and aspects.
 uacp: Used as link target from Help Portal at https://help.sap.com/products/BTP/65de2977205c403bbc107264b8eccf4b/855e00bd559742a3b8276fbed4af1008.html
 ---

cds/compiler/hdbcds-to-hdbtable.md

@@ -1,6 +1,6 @@
 ---
-# layout: cds-ref
-status: released
+description: >
+  Step-by-step instructions for migrating SAP HANA database deployments from the deprecated `hdbcds` format to `hdbtable`.
 ---
 
 # Moving From _.hdbcds_ To _.hdbtable_

cds/compiler/v2.md

@@ -1,18 +1,13 @@
 ---
-shorty: Compiler v2
-synopsis: >
-  This document describes the upgrade to compiler version 2, released March 2021. As both compiler version 1 and version 2 are out of maintenance by now,
-  we expect that all projects have already upgraded. If in doubt, run `cds v` to find out which version of the CAP modules you have in use.
-
-# layout: cds-ref
-status: released
+description: >
+  Describes the upgrade to CDS compiler version 2 (released March 2021), which is now out of maintenance and expected to already be in use by all projects.
 ---
 
 <!-- Keep this page, as _many_ links point to it! -->
 
 # Upgrade to Compiler v2
 
-{{ $frontmatter.synopsis }}
+{{ $frontmatter.description }}
 
 CDS compiler version 2 brings numerous improvements, which allow us to significantly streamline model processing going forward.
 Changes mostly affect internal implementations of the compiler and nonpublic parts of the artifacts produced by the compiler (CSN, EDMX, ...), hence are unlikely to be observed by users of CDS.
@@ -636,7 +631,7 @@ CAP Java supports using CDS models that have been compiled with the CDS complier
 
 For every entity that has *localized* elements the CDS compiler [behind the scenes](../../guides/uis/localized-data#behind-the-scenes) generates a corresponding "texts" entity that holds the translated texts. The name of this entity changes with CDS compiler v2.
 
-::: warning 
+::: warning
 With compiler v1 the "texts" entity is generated with the suffix `_texts`, while the compiler v2 uses the suffix `.texts`!
 :::
 
@@ -711,7 +706,7 @@ CAP Java allows to [provide initial data](../../guides/databases/initial-data) t
 mv bookshop-Books_texts.csv bookshop-Books.texts.csv
 ```
 
-::: warning 
+::: warning
 If a CSV file has already been deployed to a productive SAP HANA schema it can't be renamed any longer. To support this situation cds deploy as well as the CSV data loader in CAP Java still suppport CSV files with a `_texts` suffix.
 :::
 
@@ -754,7 +749,7 @@ In this example, the return type of the `cancel` function is automatically expos
 
 With compiler v1 this change was also reflected in the CSN. With compiler v2 this is not the case any longer.
 
-::: warning 
+::: warning
 If types are used in a service that are defined outside of the service the [generated accessor interface](../../java/cds-data#generated-accessor-interfaces) will change when upgrading from compiler v1 to v2!
 :::
 
@@ -838,7 +833,7 @@ OData, however, does not support anonymous types. Hence, the compiler will autom
 
 In this example the compiler generated the type `Person_emails` in the OData service `hr`.
 
-::: warning 
+::: warning
 If an inline defined type is used in a service the [generated accessor interface](../../java/cds-data#generated-accessor-interfaces) will change (an inner interface is generated) when upgrading from compiler v1 to v2!
 :::