docs: add semantic search and agentic chatbox

.gitignore

@@ -14,6 +14,7 @@ docs/api
 docs/_src/fonts
 docs/_src/style
 docs/_src/icon-viewer
+docs/_src/docs-chat
 
 # dependencies
 /node_modules

angular.json

@@ -972,6 +972,58 @@
         }
       }
     },
+    "docs-chat": {
+      "projectType": "application",
+      "root": "projects/docs-chat",
+      "sourceRoot": "projects/docs-chat/src",
+      "prefix": "app",
+      "architect": {
+        "build": {
+          "builder": "@angular/build:application",
+          "options": {
+            "outputPath": {
+              "base": "docs/_src/docs-chat",
+              "browser": ""
+            },
+            "index": "projects/docs-chat/src/index.html",
+            "browser": "projects/docs-chat/src/main.ts",
+            "polyfills": ["@angular/localize/init"],
+            "tsConfig": "projects/docs-chat/tsconfig.app.json",
+            "inlineStyleLanguage": "scss",
+            "assets": [
+              {
+                "glob": "siemens-element-icons.{woff,woff2}",
+                "input": "node_modules/@siemens/element-icons/dist/fonts",
+                "output": "fonts"
+              }
+            ],
+            "preserveSymlinks": true
+          },
+          "configurations": {
+            "production": {
+              "outputHashing": "none",
+              "optimization": true,
+              "sourceMap": false
+            },
+            "development": {
+              "outputPath": {
+                "base": "dist/docs-chat",
+                "browser": ""
+              },
+              "optimization": false,
+              "sourceMap": true
+            }
+          },
+          "defaultConfiguration": "production"
+        },
+        "lint": {
+          "builder": "@angular-eslint/builder:lint",
+          "options": {
+            "lintFilePatterns": ["projects/docs-chat/**/*.ts", "projects/docs-chat/**/*.html"]
+          }
+        }
+      }
+    },
     "icon-viewer": {
       "projectType": "application",
       "schematics": {

mkdocs.yml

@@ -234,6 +234,10 @@ extra_css:
   - '_src/color-grid.css'
 
 extra_javascript:
+  - path: '_src/docs-chat/polyfills.js'
+    type: module
+  - path: '_src/docs-chat/main.js'
+    type: module
   - '//w3.siemens.com/ote/ote_config.js'
   - '//w3.siemens.com/ote/sinet/ote.js'
   - 'https://assets.adobedtm.com/5dfc7d97c6fb/f16b45bec907/launch-af252bb19983.min.js'
@@ -273,5 +277,17 @@ markdown_extensions:
 
 plugins:
   - material/search
+  - websem-build:
+      dims: 128
+      markdown_reader_path: source/docs/
+      exclude:
+        - api/**
+      index_path: websem/index
+  - websem-search:
+      factor: 1.0
+      index_path: websem/index
+      limit: 10
+      min_score: 0.2
+      mode: hybrid
   - minify_html
   - element-docs-builder

package.json

@@ -43,14 +43,15 @@
     "schematics:test": "vitest run --config projects/element-ng/vitest.config.schematics.ts",
     "translate:test": "ng test element-translate-ng",
     "translate:build": "ng build element-translate-ng",
-    "docs:build": "uv run mkdocs build --strict",
-    "docs:build:api": "cross-env DOCS_COMPOSER=true DOCS_COMPOSER_OPTIONS='{ \"structured\": true, \"structuredRemoveEncoded\": true }' uv run mkdocs build --strict",
-    "docs:build:generate": "cross-env DOCS_COMPOSER=true DOCS_COMPOSER_GENERATE=true DOCS_COMPOSER_OPTIONS='{ \"structured\": true, \"structuredRemoveEncoded\": true, \"structuredExcludeGenerated\": true }' uv run mkdocs build --strict",
-    "docs:serve": "uv run mkdocs serve",
-    "docs:serve:api": "cross-env DOCS_COMPOSER=true uv run mkdocs serve",
-    "docs:serve:generate": "cross-env DOCS_COMPOSER=true DOCS_COMPOSER_GENERATE=true uv run mkdocs serve",
+    "docs:build": "pnpm docs-chat:build && uv run mkdocs build --strict",
+    "docs:build:api": "pnpm docs-chat:build && cross-env DOCS_COMPOSER=true DOCS_COMPOSER_OPTIONS='{ \"structured\": true, \"structuredRemoveEncoded\": true }' uv run mkdocs build --strict",
+    "docs:build:generate": "pnpm docs-chat:build && cross-env DOCS_COMPOSER=true DOCS_COMPOSER_GENERATE=true DOCS_COMPOSER_OPTIONS='{ \"structured\": true, \"structuredRemoveEncoded\": true, \"structuredExcludeGenerated\": true }' uv run mkdocs build --strict",
+    "docs:serve": "pnpm docs-chat:build && node tools/docs-chat-relay.mjs uv run mkdocs serve",
+    "docs:serve:api": "pnpm docs-chat:build && cross-env DOCS_COMPOSER=true uv run mkdocs serve",
+    "docs:serve:generate": "pnpm docs-chat:build && cross-env DOCS_COMPOSER=true DOCS_COMPOSER_GENERATE=true uv run mkdocs serve",
     "icon-viewer:build-docs": "ng build icon-viewer --configuration=production",
     "icon-viewer:serve": "ng serve icon-viewer",
+    "docs-chat:build": "ng build docs-chat",
     "live-preview:build": "ng build live-preview",
     "prepare": "husky; exit 0",
     "prepare-brand": "cpy --flat node_modules/@simpl/brand/assets/favicon/sie-favicon_internet_64px.png docs/_src --rename=favicon.png && cpy --flat node_modules/@simpl/brand/assets/favicon/sie-favicon_internet_64px.png src --rename=favicon.png && cpy --flat node_modules/@simpl/brand/assets/favicon/sie-favicon_internet_64px.png projects/dashboards-demo/src --rename=favicon.png && cpy --flat node_modules/@simpl/brand/assets/favicon/sie-favicon_internet_64px.png projects/dashboards-demo/mfe/src --rename=favicon.png",
@@ -86,7 +87,10 @@
     "@angular/forms": "22.0.8",
     "@angular/platform-browser": "22.0.8",
     "@angular/router": "22.0.8",
+    "@cfworker/json-schema": "^4.1.1",
     "@maplibre/ngx-maplibre-gl": "22.0.0",
+    "@mcp-b/webmcp-polyfill": "^4.0.0",
+    "@mcp-b/webmcp-types": "^4.0.0",
     "@meteocons/svg-static": "0.1.0",
     "@module-federation/enhanced": "2.7.0",
     "@module-federation/runtime": "2.7.0",
@@ -96,6 +100,9 @@
     "@ngx-translate/http-loader": "18.0.0",
     "@siemens/element-icons": "1.3.0",
     "@siemens/ngx-datatable": "26.2.1",
+    "@websem/angular": "0.1.5",
+    "@websem/client": "0.1.5",
+    "@websem/types": "0.1.5",
     "@softarc/native-federation": "4.3.2",
     "@softarc/native-federation-orchestrator": "4.5.2",
     "ag-grid-angular": "^36.0.0",
@@ -178,5 +185,17 @@
     "@siemens-ux/design-tokens": "0.6.0",
     "@simpl/brand": "4.0.0-rc.1",
     "@simpl/docs-composer": "12.0.2"
+  },
+  "workspaces": {
+    "packages": [
+      "projects/*"
+    ],
+    "catalog": {
+      "typescript": "6.0.3"
+    }
+  },
+  "overrides": {
+    "@microsoft/api-extractor>typescript": "catalog:",
+    "@simpl/brand>@siemens/element-theme": "workspace:*"
   }
 }