feat: add CDS grammar definition for syntax highlighting

Author: jung-thomas

docs/.vitepress/config.ts

@@ -3,6 +3,12 @@ import { withMermaid } from 'vitepress-plugin-mermaid'
 import { agentmarkup } from '@agentmarkup/vite'
 import { externalTutorialsPlugin } from './plugins/external-tutorials.js'
 import { expandTutorialsPlugin } from './plugins/md-expand-tutorials.js'
+import { readFileSync } from 'fs'
+import { fileURLToPath } from 'url'
+import { join, dirname } from 'path'
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+const cdsGrammar = JSON.parse(readFileSync(join(__dirname, 'grammars/cds.tmLanguage.json'), 'utf-8'))
 
 const BASE = '/cap-hana-exercises-codejam/'
 const SITE_URL = 'https://SAP-samples.github.io/cap-hana-exercises-codejam'
@@ -28,7 +34,9 @@ export default withMermaid(
     appearance: true,
 
     markdown: {
-      languageAlias: { cds: 'typescript' },
+      languages: [
+        { ...cdsGrammar, name: 'cds', aliases: ['cap', 'name'] },
+      ],
       // Fix: markdown-it wraps loose list items in <p>, but <details> is a
       // block element that cannot be inside <p> (HTML5 content model).
       // Vue's strict SFC parser throws "Element is missing end tag" for this.

docs/.vitepress/grammars/cds.tmLanguage.json

@@ -0,0 +1,81 @@
+{
+  "$schema": "https://raw.githubusercontent.com/martinring/tmlanguage/master/tmlanguage.json",
+  "name": "CDS",
+  "scopeName": "source.cds",
+  "fileTypes": ["cds"],
+  "patterns": [
+    {
+      "include": "#keywords"
+    },
+    {
+      "include": "#strings"
+    },
+    {
+      "include": "#comments"
+    },
+    {
+      "include": "#types"
+    }
+  ],
+  "repository": {
+    "keywords": {
+      "patterns": [
+        {
+          "name": "keyword.control.cds",
+          "match": "\\b(namespace|using|context|service|entity|type|aspect|annotation|extend|annotate|view|key|virtual|as|where|on|select|from|into|distinct|order by|group by|having)\\b"
+        },
+        {
+          "name": "keyword.other.cds",
+          "match": "\\b(managed|aspect|composition|association|many|optional|not null|default|enum)\\b"
+        }
+      ]
+    },
+    "types": {
+      "patterns": [
+        {
+          "name": "storage.type.cds",
+          "match": "\\b(String|Integer|Int32|Int64|Decimal|Double|Boolean|Date|Time|DateTime|Timestamp|Binary|LargeBinary|LargeString|UUID|UInt8|Int16|LocalDate|LocalTime)\\b"
+        }
+      ]
+    },
+    "strings": {
+      "patterns": [
+        {
+          "name": "string.quoted.single.cds",
+          "begin": "'",
+          "end": "'",
+          "patterns": [
+            {
+              "name": "constant.character.escape.cds",
+              "match": "\\\\."
+            }
+          ]
+        },
+        {
+          "name": "string.quoted.double.cds",
+          "begin": "\"",
+          "end": "\"",
+          "patterns": [
+            {
+              "name": "constant.character.escape.cds",
+              "match": "\\\\."
+            }
+          ]
+        }
+      ]
+    },
+    "comments": {
+      "patterns": [
+        {
+          "name": "comment.line.double-slash.cds",
+          "match": "//.*$"
+        },
+        {
+          "name": "comment.block.cds",
+          "begin": "/\\*",
+          "end": "\\*/"
+        }
+      ]
+    }
+  }
+}