@genesislcap/ai-assistant 15.28.1-FUI-0.7 → 15.28.1-FUI-0.8

package/dist/ai-assistant.d.ts

@@ -646,6 +646,24 @@ export declare class AiChatMarkdown extends GenesisElement {
     content: string;
     /** @internal */
     renderMarkdown(): string;
+    /**
+     * Tag the generated elements with shadow parts so an embedding app can style them.
+     *
+     * Runs AFTER sanitising, deliberately. It only ever *adds* attributes to DOM DOMPurify has
+     * already cleared, so it introduces no new sanitiser surface - reversing the order would mean
+     * sanitising our own output and inviting the question of whether these attributes survive it.
+     *
+     * Lists additionally carry a level: a top-level list is `md-ul md-ul-level-1`, a list nested
+     * inside it is `md-ul-level-2`, and an `li` takes the level of the list holding it. Chat markdown
+     * rarely nests, so this is a safety valve rather than a feature - without it, every list at every
+     * depth would answer to one selector and there would be no way to tell them apart afterwards.
+     * Depth comes from walking the tree rather than from marked's renderers, which are invoked
+     * innermost-first and so cannot count downwards.
+     *
+     * An author-supplied `part` on inline HTML is overwritten: these parts are the documented
+     * contract, and two sources for one attribute would make which-wins depend on the markdown.
+     */
+    private annotateParts;
 }
 
 /**

package/dist/custom-elements.json

@@ -4929,48 +4929,6 @@
       "declarations": [],
       "exports": []
     },
-    {
-      "kind": "javascript-module",
-      "path": "src/provider/ai-provider-switcher.ts",
-      "declarations": [
-        {
-          "kind": "variable",
-          "name": "AIProviderSwitcher",
-          "description": "The DI token for the (AIProviderSwitcher:interface). Resolves a noop until the app\nregisters one."
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "AIProviderSwitcher",
-          "declaration": {
-            "name": "AIProviderSwitcher",
-            "module": "src/provider/ai-provider-switcher.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/provider/assistant-app-settings.ts",
-      "declarations": [
-        {
-          "kind": "variable",
-          "name": "AssistantAppSettingsProvider",
-          "description": "The DI token for the (AssistantAppSettingsProvider:interface). Resolves a noop\nuntil the host registers one."
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "AssistantAppSettingsProvider",
-          "declaration": {
-            "name": "AssistantAppSettingsProvider",
-            "module": "src/provider/assistant-app-settings.ts"
-          }
-        }
-      ]
-    },
     {
       "kind": "javascript-module",
       "path": "src/state/ai-assistant-slice.ts",
@@ -5661,6 +5619,48 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/provider/ai-provider-switcher.ts",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "AIProviderSwitcher",
+          "description": "The DI token for the (AIProviderSwitcher:interface). Resolves a noop until the app\nregisters one."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "AIProviderSwitcher",
+          "declaration": {
+            "name": "AIProviderSwitcher",
+            "module": "src/provider/ai-provider-switcher.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/provider/assistant-app-settings.ts",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "AssistantAppSettingsProvider",
+          "description": "The DI token for the (AssistantAppSettingsProvider:interface). Resolves a noop\nuntil the host registers one."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "AssistantAppSettingsProvider",
+          "declaration": {
+            "name": "AssistantAppSettingsProvider",
+            "module": "src/provider/assistant-app-settings.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/suggestions/chat-suggestions.ts",
@@ -11939,6 +11939,25 @@
               },
               "default": "''",
               "description": "The markdown string to render."
+            },
+            {
+              "kind": "method",
+              "name": "annotateParts",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "string"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "html",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "Tag the generated elements with shadow parts so an embedding app can style them.\n\nRuns AFTER sanitising, deliberately. It only ever *adds* attributes to DOM DOMPurify has\nalready cleared, so it introduces no new sanitiser surface - reversing the order would mean\nsanitising our own output and inviting the question of whether these attributes survive it.\n\nLists additionally carry a level: a top-level list is `md-ul md-ul-level-1`, a list nested\ninside it is `md-ul-level-2`, and an `li` takes the level of the list holding it. Chat markdown\nrarely nests, so this is a safety valve rather than a feature - without it, every list at every\ndepth would answer to one selector and there would be no way to tell them apart afterwards.\nDepth comes from walking the tree rather than from marked's renderers, which are invoked\ninnermost-first and so cannot count downwards.\n\nAn author-supplied `part` on inline HTML is overwritten: these parts are the documented\ncontract, and two sources for one attribute would make which-wins depend on the markdown."
             }
           ],
           "superclass": {

package/dist/dts/components/chat-markdown/chat-markdown.d.ts

@@ -4,5 +4,23 @@ export declare class AiChatMarkdown extends GenesisElement {
     content: string;
     /** @internal */
     renderMarkdown(): string;
+    /**
+     * Tag the generated elements with shadow parts so an embedding app can style them.
+     *
+     * Runs AFTER sanitising, deliberately. It only ever *adds* attributes to DOM DOMPurify has
+     * already cleared, so it introduces no new sanitiser surface - reversing the order would mean
+     * sanitising our own output and inviting the question of whether these attributes survive it.
+     *
+     * Lists additionally carry a level: a top-level list is `md-ul md-ul-level-1`, a list nested
+     * inside it is `md-ul-level-2`, and an `li` takes the level of the list holding it. Chat markdown
+     * rarely nests, so this is a safety valve rather than a feature - without it, every list at every
+     * depth would answer to one selector and there would be no way to tell them apart afterwards.
+     * Depth comes from walking the tree rather than from marked's renderers, which are invoked
+     * innermost-first and so cannot count downwards.
+     *
+     * An author-supplied `part` on inline HTML is overwritten: these parts are the documented
+     * contract, and two sources for one attribute would make which-wins depend on the markdown.
+     */
+    private annotateParts;
 }
 //# sourceMappingURL=chat-markdown.d.ts.map

package/dist/dts/components/chat-markdown/chat-markdown.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chat-markdown.d.ts","sourceRoot":"","sources":["../../../../src/components/chat-markdown/chat-markdown.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,cAAc,EAAoB,MAAM,uBAAuB,CAAC;AAuE7F,qBAOa,cAAe,SAAQ,cAAc;IAChD,qCAAqC;IACzB,OAAO,EAAE,MAAM,CAAM;IAEjC,gBAAgB;IAChB,cAAc;CAKf"}
+{"version":3,"file":"chat-markdown.d.ts","sourceRoot":"","sources":["../../../../src/components/chat-markdown/chat-markdown.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,cAAc,EAAoB,MAAM,uBAAuB,CAAC;AAkH7F,qBAOa,cAAe,SAAQ,cAAc;IAChD,qCAAqC;IACzB,OAAO,EAAE,MAAM,CAAM;IAEjC,gBAAgB;IAChB,cAAc;IAMd;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,aAAa;CAsBtB"}

package/dist/esm/components/chat-markdown/chat-markdown.js

@@ -68,6 +68,47 @@ const styles = css `
     font-weight: 600;
   }
 `;
+/**
+ * Element tag -> the shadow part it is exposed as.
+ *
+ * Markdown is rendered from a string at runtime, so there is no template on which to author
+ * `part=` attributes - which is why this component previously exposed nothing at all and an
+ * embedding app could only reach it through whichever global design tokens the rules below happen
+ * to use. Annotating the generated DOM gives an app ordinary CSS over each element type
+ * (`ai-chat-markdown::part(md-li) { ... }`) instead of a per-property token API that would have to
+ * grow every time someone wants to style something new.
+ *
+ * The vocabulary is deliberately a fixed list of element kinds rather than anything derived from
+ * the content: it is a public API surface, so it should change only when this map does.
+ */
+const MARKDOWN_PARTS = {
+    P: 'md-p',
+    UL: 'md-ul',
+    OL: 'md-ol',
+    LI: 'md-li',
+    PRE: 'md-pre',
+    CODE: 'md-code',
+    A: 'md-link',
+    BLOCKQUOTE: 'md-quote',
+    TABLE: 'md-table',
+    THEAD: 'md-thead',
+    TBODY: 'md-tbody',
+    TR: 'md-tr',
+    TH: 'md-th',
+    TD: 'md-td',
+    HR: 'md-hr',
+    IMG: 'md-img',
+    STRONG: 'md-strong',
+    EM: 'md-em',
+    H1: 'md-h1',
+    H2: 'md-h2',
+    H3: 'md-h3',
+    H4: 'md-h4',
+    H5: 'md-h5',
+    H6: 'md-h6',
+};
+/** Tags whose part is also emitted with a nesting level (see {@link annotateParts}). */
+const DEPTH_TAGGED = new Set(['UL', 'OL', 'LI']);
 let AiChatMarkdown = class AiChatMarkdown extends GenesisElement {
     constructor() {
         super(...arguments);
@@ -79,7 +120,41 @@ let AiChatMarkdown = class AiChatMarkdown extends GenesisElement {
         if (!this.content)
             return '';
         const rawHtml = marked.parse(this.content);
-        return DOMPurify.sanitize(rawHtml);
+        return this.annotateParts(DOMPurify.sanitize(rawHtml));
+    }
+    /**
+     * Tag the generated elements with shadow parts so an embedding app can style them.
+     *
+     * Runs AFTER sanitising, deliberately. It only ever *adds* attributes to DOM DOMPurify has
+     * already cleared, so it introduces no new sanitiser surface - reversing the order would mean
+     * sanitising our own output and inviting the question of whether these attributes survive it.
+     *
+     * Lists additionally carry a level: a top-level list is `md-ul md-ul-level-1`, a list nested
+     * inside it is `md-ul-level-2`, and an `li` takes the level of the list holding it. Chat markdown
+     * rarely nests, so this is a safety valve rather than a feature - without it, every list at every
+     * depth would answer to one selector and there would be no way to tell them apart afterwards.
+     * Depth comes from walking the tree rather than from marked's renderers, which are invoked
+     * innermost-first and so cannot count downwards.
+     *
+     * An author-supplied `part` on inline HTML is overwritten: these parts are the documented
+     * contract, and two sources for one attribute would make which-wins depend on the markdown.
+     */
+    annotateParts(html) {
+        const template = document.createElement('template');
+        template.innerHTML = html;
+        const walk = (parent, listDepth) => {
+            for (const el of Array.from(parent.children)) {
+                const base = MARKDOWN_PARTS[el.tagName];
+                // A list opens the next level; everything else sits at its parent list's level.
+                const depth = el.tagName === 'UL' || el.tagName === 'OL' ? listDepth + 1 : listDepth;
+                if (base) {
+                    el.setAttribute('part', DEPTH_TAGGED.has(el.tagName) ? `${base} ${base}-level-${depth}` : base);
+                }
+                walk(el, depth);
+            }
+        };
+        walk(template.content, 0);
+        return template.innerHTML;
     }
 };
 __decorate([

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@genesislcap/ai-assistant",
   "description": "Genesis AI Assistant micro-frontend",
-  "version": "15.28.1-FUI-0.7",
+  "version": "15.28.1-FUI-0.8",
   "license": "SEE LICENSE IN license.txt",
   "main": "dist/esm/index.js",
   "types": "dist/ai-assistant.d.ts",
@@ -74,26 +74,26 @@
     }
   },
   "devDependencies": {
-    "@genesislcap/foundation-testing": "15.28.1-FUI-0.7",
-    "@genesislcap/genx": "15.28.1-FUI-0.7",
-    "@genesislcap/rollup-builder": "15.28.1-FUI-0.7",
-    "@genesislcap/ts-builder": "15.28.1-FUI-0.7",
-    "@genesislcap/uvu-playwright-builder": "15.28.1-FUI-0.7",
-    "@genesislcap/vite-builder": "15.28.1-FUI-0.7",
-    "@genesislcap/webpack-builder": "15.28.1-FUI-0.7",
+    "@genesislcap/foundation-testing": "15.28.1-FUI-0.8",
+    "@genesislcap/genx": "15.28.1-FUI-0.8",
+    "@genesislcap/rollup-builder": "15.28.1-FUI-0.8",
+    "@genesislcap/ts-builder": "15.28.1-FUI-0.8",
+    "@genesislcap/uvu-playwright-builder": "15.28.1-FUI-0.8",
+    "@genesislcap/vite-builder": "15.28.1-FUI-0.8",
+    "@genesislcap/webpack-builder": "15.28.1-FUI-0.8",
     "@types/dompurify": "^3.0.5",
     "@types/marked": "^5.0.2",
     "esbuild": "0.25.12"
   },
   "dependencies": {
-    "@genesislcap/foundation-ai": "15.28.1-FUI-0.7",
-    "@genesislcap/foundation-logger": "15.28.1-FUI-0.7",
-    "@genesislcap/foundation-notifications": "15.28.1-FUI-0.7",
-    "@genesislcap/foundation-redux": "15.28.1-FUI-0.7",
-    "@genesislcap/foundation-ui": "15.28.1-FUI-0.7",
-    "@genesislcap/foundation-utils": "15.28.1-FUI-0.7",
-    "@genesislcap/rapid-design-system": "15.28.1-FUI-0.7",
-    "@genesislcap/web-core": "15.28.1-FUI-0.7",
+    "@genesislcap/foundation-ai": "15.28.1-FUI-0.8",
+    "@genesislcap/foundation-logger": "15.28.1-FUI-0.8",
+    "@genesislcap/foundation-notifications": "15.28.1-FUI-0.8",
+    "@genesislcap/foundation-redux": "15.28.1-FUI-0.8",
+    "@genesislcap/foundation-ui": "15.28.1-FUI-0.8",
+    "@genesislcap/foundation-utils": "15.28.1-FUI-0.8",
+    "@genesislcap/rapid-design-system": "15.28.1-FUI-0.8",
+    "@genesislcap/web-core": "15.28.1-FUI-0.8",
     "dompurify": "^3.3.1",
     "marked": "^17.0.3"
   },