@ds-mo/ui 11.0.0 → 12.0.0

package/dist/docs/components.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2026-07-21T22:37:19",
+  "timestamp": "2026-07-22T06:31:24",
   "compiler": {
     "name": "@stencil/core",
     "version": "4.43.5",
@@ -353,8 +353,12 @@
         ],
         "ds-code-block": [
           "ds-text",
+          "ds-tooltip",
           "ds-button-unfilled"
         ],
+        "ds-tooltip": [
+          "ds-text"
+        ],
         "ds-button-unfilled": [
           "ds-loader",
           "ds-icon",
@@ -758,161 +762,6 @@
         ]
       }
     },
-    {
-      "filePath": "src/wc/components/AppShell/AppShell.tsx",
-      "encapsulation": "scoped",
-      "tag": "ds-app-shell",
-      "docs": "",
-      "docsTags": [],
-      "usage": {},
-      "props": [
-        {
-          "name": "gradientPreset",
-          "type": "\"cool\" | \"fresh\" | \"neutral\" | \"none\" | \"warm\"",
-          "complexType": {
-            "original": "ShellGradientPreset",
-            "resolved": "\"cool\" | \"fresh\" | \"neutral\" | \"none\" | \"warm\"",
-            "references": {
-              "ShellGradientPreset": {
-                "location": "import",
-                "path": "../../shell/shell-gradient-presets",
-                "id": "src/wc/shell/shell-gradient-presets.ts::ShellGradientPreset",
-                "referenceLocation": "ShellGradientPreset"
-              }
-            }
-          },
-          "mutable": false,
-          "attr": "gradient-preset",
-          "reflectToAttr": true,
-          "docs": "Shell chrome wash preset. `none` renders solid chrome; the remaining\npresets use token-based washes that adapt to the active color theme.",
-          "docsTags": [
-            {
-              "name": "default",
-              "text": "'neutral'"
-            }
-          ],
-          "default": "'neutral'",
-          "values": [
-            {
-              "value": "cool",
-              "type": "string"
-            },
-            {
-              "value": "fresh",
-              "type": "string"
-            },
-            {
-              "value": "neutral",
-              "type": "string"
-            },
-            {
-              "value": "none",
-              "type": "string"
-            },
-            {
-              "value": "warm",
-              "type": "string"
-            }
-          ],
-          "optional": false,
-          "required": false,
-          "getter": false,
-          "setter": false
-        },
-        {
-          "name": "navStyle",
-          "type": "\"dashboard\" | \"settings\"",
-          "complexType": {
-            "original": "NavChromeStyle",
-            "resolved": "\"dashboard\" | \"settings\"",
-            "references": {
-              "NavChromeStyle": {
-                "location": "import",
-                "path": "../../shell/nav-chrome",
-                "id": "src/wc/shell/nav-chrome.ts::NavChromeStyle",
-                "referenceLocation": "NavChromeStyle"
-              }
-            }
-          },
-          "mutable": false,
-          "attr": "nav-style",
-          "reflectToAttr": true,
-          "docs": "Chrome style propagated to slotted `ds-panel-nav` and `ds-bar-nav`.",
-          "docsTags": [
-            {
-              "name": "default",
-              "text": "'dashboard'"
-            }
-          ],
-          "default": "'dashboard'",
-          "values": [
-            {
-              "value": "dashboard",
-              "type": "string"
-            },
-            {
-              "value": "settings",
-              "type": "string"
-            }
-          ],
-          "optional": false,
-          "required": false,
-          "getter": false,
-          "setter": false
-        },
-        {
-          "name": "shortcutsEnabled",
-          "type": "boolean",
-          "complexType": {
-            "original": "boolean",
-            "resolved": "boolean",
-            "references": {}
-          },
-          "mutable": false,
-          "attr": "shortcuts-enabled",
-          "reflectToAttr": false,
-          "docs": "When `true` (default), registers global shell keyboard shortcuts. `[` toggles panel nav; `]` closes tools; K/A/S/M/N/? toggle tool drawers. Modifiers are ignored so browser chords like ⌘N stay native.",
-          "docsTags": [
-            {
-              "name": "default",
-              "text": "true"
-            }
-          ],
-          "default": "true",
-          "values": [
-            {
-              "type": "boolean"
-            }
-          ],
-          "optional": false,
-          "required": false,
-          "getter": false,
-          "setter": false
-        }
-      ],
-      "methods": [],
-      "events": [],
-      "listeners": [
-        {
-          "event": "dsPresentationChange",
-          "capture": false,
-          "passive": false
-        },
-        {
-          "event": "keydown",
-          "target": "window",
-          "capture": true,
-          "passive": false
-        }
-      ],
-      "styles": [],
-      "slots": [],
-      "parts": [],
-      "states": [],
-      "dependents": [],
-      "dependencies": [],
-      "dependencyGraph": {}
-    },
     {
       "filePath": "src/wc/components/AttachmentList/AttachmentList.tsx",
       "encapsulation": "scoped",
@@ -1373,7 +1222,7 @@
           "mutable": false,
           "attr": "gradient-background",
           "reflectToAttr": true,
-          "docs": "Ring samples the shell gradient stack (base fill + wash) instead of a flat\n`box-shadow`. Auto-enabled under an AppShell with an active gradient preset;\nset `gradient-background` to opt in/out explicitly.\n\nThe attribute must NOT start with `on` — Stencil's setAccessor routes any\nunknown `on*` member down the event-listener path during attribute\nreflection, calling addEventListener with a non-listener and throwing.",
+          "docs": "Ring samples the shell gradient stack (base fill + wash) instead of a flat\n`box-shadow`. Auto-enabled under an ShellApp with an active gradient preset;\nset `gradient-background` to opt in/out explicitly.\n\nThe attribute must NOT start with `on` — Stencil's setAccessor routes any\nunknown `on*` member down the event-listener path during attribute\nreflection, calling addEventListener with a non-listener and throwing.",
           "docsTags": [
             {
               "name": "default",
@@ -1944,36 +1793,68 @@
       }
     },
     {
-      "filePath": "src/wc/components/ButtonFilled/ButtonFilled.tsx",
+      "filePath": "src/wc/components/BarTitle/BarTitle.tsx",
       "encapsulation": "scoped",
-      "tag": "ds-button-filled",
+      "tag": "ds-bar-title",
       "docs": "",
       "docsTags": [],
       "usage": {},
       "props": [
         {
-          "name": "ariaLabel",
-          "type": "null | string",
+          "name": "actions",
+          "type": "BarTitleActionItem[]",
           "complexType": {
-            "original": "string | null",
-            "resolved": "null | string",
-            "references": {}
+            "original": "BarTitleActionItem[]",
+            "resolved": "BarTitleActionItem[]",
+            "references": {
+              "BarTitleActionItem": {
+                "location": "import",
+                "path": "./bar-title-types",
+                "id": "src/wc/components/BarTitle/bar-title-types.ts::BarTitleActionItem",
+                "referenceLocation": "BarTitleActionItem"
+              }
+            }
           },
           "mutable": false,
-          "attr": "aria-label",
           "reflectToAttr": false,
-          "docs": "Accessible name override. Required for icon-only buttons.",
+          "docs": "Secondary page actions shown in the overflow menu. Dividers create groups.",
           "docsTags": [
             {
               "name": "default",
-              "text": "null"
+              "text": "[]"
             }
           ],
-          "default": "null",
+          "default": "[]",
           "values": [
             {
-              "type": "null"
-            },
+              "type": "BarTitleActionItem[]"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "actionsAriaLabel",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "actions-aria-label",
+          "reflectToAttr": false,
+          "docs": "Accessible name for the page-actions menu.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "'More page actions'"
+            }
+          ],
+          "default": "'More page actions'",
+          "values": [
             {
               "type": "string"
             }
@@ -1984,46 +1865,590 @@
           "setter": false
         },
         {
-          "name": "contrast",
-          "type": "\"bold\" | \"faint\" | \"medium\" | \"strong\"",
+          "name": "backAriaLabel",
+          "type": "string",
           "complexType": {
-            "original": "ButtonFilledContrast",
-            "resolved": "\"bold\" | \"faint\" | \"medium\" | \"strong\"",
-            "references": {
-              "ButtonFilledContrast": {
-                "location": "local",
-                "path": "/home/runner/work/compomo/compomo/src/wc/components/ButtonFilled/ButtonFilled.tsx",
-                "id": "src/wc/components/ButtonFilled/ButtonFilled.tsx::ButtonFilledContrast"
-              }
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "back-aria-label",
+          "reflectToAttr": false,
+          "docs": "Accessible name for the leading Back action.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "'Back'"
+            }
+          ],
+          "default": "'Back'",
+          "values": [
+            {
+              "type": "string"
             }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "backLabel",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
           },
           "mutable": false,
-          "attr": "contrast",
+          "attr": "back-label",
+          "reflectToAttr": false,
+          "docs": "Visible parent-page label used by the expanded Back breadcrumb.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "'Back'"
+            }
+          ],
+          "default": "'Back'",
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "description",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "description",
+          "reflectToAttr": false,
+          "docs": "Optional supporting copy shown in the expanded presentation.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "''"
+            }
+          ],
+          "default": "''",
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "heading",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "heading",
+          "reflectToAttr": false,
+          "docs": "The page's single visible h1.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": true,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "primaryAction",
+          "type": "BarTitlePrimaryAction | null",
+          "complexType": {
+            "original": "BarTitlePrimaryAction | null",
+            "resolved": "BarTitlePrimaryAction | null",
+            "references": {
+              "BarTitlePrimaryAction": {
+                "location": "import",
+                "path": "./bar-title-types",
+                "id": "src/wc/components/BarTitle/bar-title-types.ts::BarTitlePrimaryAction",
+                "referenceLocation": "BarTitlePrimaryAction"
+              }
+            }
+          },
+          "mutable": false,
+          "reflectToAttr": false,
+          "docs": "The one highest-emphasis page action.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "null"
+            }
+          ],
+          "default": "null",
+          "values": [
+            {
+              "type": "BarTitlePrimaryAction"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "sections",
+          "type": "BarTitleSectionItem[]",
+          "complexType": {
+            "original": "BarTitleSectionItem[]",
+            "resolved": "BarTitleSectionItem[]",
+            "references": {
+              "BarTitleSectionItem": {
+                "location": "import",
+                "path": "./bar-title-types",
+                "id": "src/wc/components/BarTitle/bar-title-types.ts::BarTitleSectionItem",
+                "referenceLocation": "BarTitleSectionItem"
+              }
+            }
+          },
+          "mutable": false,
+          "reflectToAttr": false,
+          "docs": "Optional page sections exposed through the active-section menu.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "[]"
+            }
+          ],
+          "default": "[]",
+          "values": [
+            {
+              "type": "BarTitleSectionItem[]"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "sectionsAriaLabel",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "sections-aria-label",
+          "reflectToAttr": false,
+          "docs": "Accessible name for the page-section menu.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "'Change page section'"
+            }
+          ],
+          "default": "'Change page section'",
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "showBack",
+          "type": "boolean",
+          "complexType": {
+            "original": "boolean",
+            "resolved": "boolean",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "show-back",
+          "reflectToAttr": false,
+          "docs": "Show the leading page-level Back action.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "false"
+            }
+          ],
+          "default": "false",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "value",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "value",
+          "reflectToAttr": false,
+          "docs": "Id of the active page section.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "''"
+            }
+          ],
+          "default": "''",
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "variant",
+          "type": "\"compact\" | \"constrained\" | \"expanded\"",
+          "complexType": {
+            "original": "BarTitleVariant",
+            "resolved": "\"compact\" | \"constrained\" | \"expanded\"",
+            "references": {
+              "BarTitleVariant": {
+                "location": "import",
+                "path": "./bar-title-types",
+                "id": "src/wc/components/BarTitle/bar-title-types.ts::BarTitleVariant",
+                "referenceLocation": "BarTitleVariant"
+              }
+            }
+          },
+          "mutable": false,
+          "attr": "variant",
+          "reflectToAttr": false,
+          "docs": "Explicit visual/capacity variant. ShellPage owns automatic selection.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "'expanded'"
+            }
+          ],
+          "default": "'expanded'",
+          "values": [
+            {
+              "value": "compact",
+              "type": "string"
+            },
+            {
+              "value": "constrained",
+              "type": "string"
+            },
+            {
+              "value": "expanded",
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        }
+      ],
+      "methods": [],
+      "events": [
+        {
+          "event": "dsAction",
+          "detail": "string",
+          "bubbles": true,
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "cancelable": true,
+          "composed": true,
+          "docs": "Emitted with the activated primary or overflow action id.",
+          "docsTags": []
+        },
+        {
+          "event": "dsBack",
+          "detail": "MouseEvent",
+          "bubbles": true,
+          "complexType": {
+            "original": "MouseEvent",
+            "resolved": "MouseEvent",
+            "references": {
+              "MouseEvent": {
+                "location": "global",
+                "id": "global::MouseEvent"
+              }
+            }
+          },
+          "cancelable": true,
+          "composed": true,
+          "docs": "Emitted when the leading Back action is activated.",
+          "docsTags": []
+        },
+        {
+          "event": "dsSectionChange",
+          "detail": "string",
+          "bubbles": true,
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "cancelable": true,
+          "composed": true,
+          "docs": "Emitted with the newly selected page-section id.",
+          "docsTags": []
+        }
+      ],
+      "listeners": [],
+      "styles": [],
+      "slots": [],
+      "parts": [],
+      "states": [],
+      "dependents": [],
+      "dependencies": [
+        "ds-text",
+        "ds-icon",
+        "ds-button-filled",
+        "ds-button-unfilled",
+        "ds-tooltip",
+        "ds-menu"
+      ],
+      "dependencyGraph": {
+        "ds-bar-title": [
+          "ds-text",
+          "ds-icon",
+          "ds-button-filled",
+          "ds-button-unfilled",
+          "ds-tooltip",
+          "ds-menu"
+        ],
+        "ds-button-filled": [
+          "ds-loader",
+          "ds-icon",
+          "ds-text"
+        ],
+        "ds-button-unfilled": [
+          "ds-loader",
+          "ds-icon",
+          "ds-badge",
+          "ds-text"
+        ],
+        "ds-badge": [
+          "ds-text"
+        ],
+        "ds-tooltip": [
+          "ds-text"
+        ],
+        "ds-menu": [
+          "ds-text",
+          "ds-swatch-picker",
+          "ds-badge",
+          "ds-switch"
+        ]
+      }
+    },
+    {
+      "filePath": "src/wc/components/ButtonFilled/ButtonFilled.tsx",
+      "encapsulation": "scoped",
+      "tag": "ds-button-filled",
+      "docs": "",
+      "docsTags": [],
+      "usage": {},
+      "props": [
+        {
+          "name": "ariaLabel",
+          "type": "null | string",
+          "complexType": {
+            "original": "string | null",
+            "resolved": "null | string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "aria-label",
+          "reflectToAttr": false,
+          "docs": "Accessible name override. Required for icon-only buttons.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "null"
+            }
+          ],
+          "default": "null",
+          "values": [
+            {
+              "type": "null"
+            },
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "background",
+          "type": "\"always-dark\" | \"bold\" | \"faint\" | \"inverted\" | \"media\" | \"medium\" | \"strong\" | \"translucent\" | undefined",
+          "complexType": {
+            "original": "ButtonFilledBackground | undefined",
+            "resolved": "\"always-dark\" | \"bold\" | \"faint\" | \"inverted\" | \"media\" | \"medium\" | \"strong\" | \"translucent\" | undefined",
+            "references": {
+              "ButtonFilledBackground": {
+                "location": "local",
+                "path": "/home/runner/work/compomo/compomo/src/wc/components/ButtonFilled/ButtonFilled.tsx",
+                "id": "src/wc/components/ButtonFilled/ButtonFilled.tsx::ButtonFilledBackground"
+              }
+            }
+          },
+          "mutable": false,
+          "attr": "background",
+          "reflectToAttr": false,
+          "docs": "Actual parent surface context for the optional inset border color only.\nOmit on primary and secondary surfaces.",
+          "docsTags": [],
+          "values": [
+            {
+              "value": "always-dark",
+              "type": "string"
+            },
+            {
+              "value": "bold",
+              "type": "string"
+            },
+            {
+              "value": "faint",
+              "type": "string"
+            },
+            {
+              "value": "inverted",
+              "type": "string"
+            },
+            {
+              "value": "media",
+              "type": "string"
+            },
+            {
+              "value": "medium",
+              "type": "string"
+            },
+            {
+              "value": "strong",
+              "type": "string"
+            },
+            {
+              "value": "translucent",
+              "type": "string"
+            },
+            {
+              "type": "undefined"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "contrast",
+          "type": "\"bold\" | \"faint\" | \"medium\" | \"strong\"",
+          "complexType": {
+            "original": "ButtonFilledContrast",
+            "resolved": "\"bold\" | \"faint\" | \"medium\" | \"strong\"",
+            "references": {
+              "ButtonFilledContrast": {
+                "location": "local",
+                "path": "/home/runner/work/compomo/compomo/src/wc/components/ButtonFilled/ButtonFilled.tsx",
+                "id": "src/wc/components/ButtonFilled/ButtonFilled.tsx::ButtonFilledContrast"
+              }
+            }
+          },
+          "mutable": false,
+          "attr": "contrast",
+          "reflectToAttr": false,
+          "docs": "Background fill weight. Foreground uses the paired contrast token:\nbold → faint, strong → medium, medium → strong, faint → bold.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "'bold'"
+            }
+          ],
+          "default": "'bold'",
+          "values": [
+            {
+              "value": "bold",
+              "type": "string"
+            },
+            {
+              "value": "faint",
+              "type": "string"
+            },
+            {
+              "value": "medium",
+              "type": "string"
+            },
+            {
+              "value": "strong",
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "hasBorder",
+          "type": "boolean",
+          "complexType": {
+            "original": "boolean",
+            "resolved": "boolean",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "has-border",
           "reflectToAttr": false,
-          "docs": "Background fill weight. Foreground uses the paired contrast token:\nbold → faint, strong → medium, medium → strong, faint → bold.",
+          "docs": "Show a 1px secondary inset border.",
           "docsTags": [
             {
               "name": "default",
-              "text": "'bold'"
+              "text": "false"
             }
           ],
-          "default": "'bold'",
+          "default": "false",
           "values": [
             {
-              "value": "bold",
-              "type": "string"
-            },
-            {
-              "value": "faint",
-              "type": "string"
-            },
-            {
-              "value": "medium",
-              "type": "string"
-            },
-            {
-              "value": "strong",
-              "type": "string"
+              "type": "boolean"
             }
           ],
           "optional": false,
@@ -2462,6 +2887,7 @@
       "parts": [],
       "states": [],
       "dependents": [
+        "ds-bar-title",
         "ds-card-setting",
         "ds-message-composer"
       ],
@@ -2476,6 +2902,9 @@
           "ds-icon",
           "ds-text"
         ],
+        "ds-bar-title": [
+          "ds-button-filled"
+        ],
         "ds-card-setting": [
           "ds-button-filled"
         ],
@@ -3236,10 +3665,12 @@
       "states": [],
       "dependents": [
         "ds-bar-nav",
+        "ds-bar-title",
         "ds-card-data-viz-donut",
         "ds-card-setting",
         "ds-code-block",
         "ds-input",
+        "ds-message-composer",
         "ds-message-scroller",
         "ds-modal",
         "ds-panel-nav",
@@ -3269,6 +3700,9 @@
         "ds-bar-nav": [
           "ds-button-unfilled"
         ],
+        "ds-bar-title": [
+          "ds-button-unfilled"
+        ],
         "ds-card-data-viz-donut": [
           "ds-button-unfilled"
         ],
@@ -3281,6 +3715,9 @@
         "ds-input": [
           "ds-button-unfilled"
         ],
+        "ds-message-composer": [
+          "ds-button-unfilled"
+        ],
         "ds-message-scroller": [
           "ds-button-unfilled"
         ],
@@ -3939,7 +4376,7 @@
           "mutable": false,
           "attr": "active-label",
           "reflectToAttr": false,
-          "docs": "Externally controlled highlight, matched by `label` — e.g. drive this from a sibling\n`ds-chart-legend`'s `dsItemHover` event to keep chart and legend hover in sync.\nFalls back to this component's own pointer/focus hover when unset.\nSlice hover dims peer slices and emits `dsSliceHover` for legend sync — no data-viz\ntooltip (the legend already surfaces label/value).",
+          "docs": "Externally controlled highlight, matched by `label` — e.g. drive this from a sibling\n`ds-chart-legend`'s `dsItemHover` event to keep chart and legend hover in sync.\nFalls back to this component's own pointer/focus hover when unset.\nSlice hover dims peer slices and emits `dsSliceHover` for legend sync. External\nhighlight never opens the local tooltip.",
           "docsTags": [
             {
               "name": "default",
@@ -4163,6 +4600,35 @@
           "getter": false,
           "setter": false
         },
+        {
+          "name": "showTooltip",
+          "type": "boolean",
+          "complexType": {
+            "original": "boolean",
+            "resolved": "boolean",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "show-tooltip",
+          "reflectToAttr": false,
+          "docs": "Show a chart-owned value callout for genuine pointer or keyboard focus.\nDisable when a visible legend already owns persistent label and value detail.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "true"
+            }
+          ],
+          "default": "true",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
         {
           "name": "size",
           "type": "number | undefined",
@@ -4252,8 +4718,17 @@
       "parts": [],
       "states": [],
       "dependents": [],
-      "dependencies": [],
-      "dependencyGraph": {}
+      "dependencies": [
+        "ds-tooltip-data-viz"
+      ],
+      "dependencyGraph": {
+        "ds-chart-donut": [
+          "ds-tooltip-data-viz"
+        ],
+        "ds-tooltip-data-viz": [
+          "ds-text"
+        ]
+      }
     },
     {
       "filePath": "src/wc/components/ChartLegend/ChartLegend.tsx",
@@ -5453,13 +5928,18 @@
       ],
       "dependencies": [
         "ds-text",
+        "ds-tooltip",
         "ds-button-unfilled"
       ],
       "dependencyGraph": {
         "ds-code-block": [
           "ds-text",
+          "ds-tooltip",
           "ds-button-unfilled"
         ],
+        "ds-tooltip": [
+          "ds-text"
+        ],
         "ds-button-unfilled": [
           "ds-loader",
           "ds-icon",
@@ -6822,6 +7302,7 @@
         "ds-agent-tool-call",
         "ds-attachment-list",
         "ds-avatar",
+        "ds-bar-title",
         "ds-button-filled",
         "ds-button-unfilled",
         "ds-chip",
@@ -6851,6 +7332,9 @@
         "ds-avatar": [
           "ds-icon"
         ],
+        "ds-bar-title": [
+          "ds-icon"
+        ],
         "ds-button-filled": [
           "ds-icon"
         ],
@@ -8160,8 +8644,12 @@
         ],
         "ds-code-block": [
           "ds-text",
+          "ds-tooltip",
           "ds-button-unfilled"
         ],
+        "ds-tooltip": [
+          "ds-text"
+        ],
         "ds-button-unfilled": [
           "ds-loader",
           "ds-icon",
@@ -8788,7 +9276,8 @@
       "parts": [],
       "states": [],
       "dependents": [
-        "ds-bar-nav"
+        "ds-bar-nav",
+        "ds-bar-title"
       ],
       "dependencies": [
         "ds-text",
@@ -8808,6 +9297,9 @@
         ],
         "ds-bar-nav": [
           "ds-menu"
+        ],
+        "ds-bar-title": [
+          "ds-menu"
         ]
       }
     },
@@ -9538,12 +10030,28 @@
       "states": [],
       "dependents": [],
       "dependencies": [
+        "ds-tooltip",
+        "ds-button-unfilled",
         "ds-button-filled"
       ],
       "dependencyGraph": {
         "ds-message-composer": [
+          "ds-tooltip",
+          "ds-button-unfilled",
           "ds-button-filled"
         ],
+        "ds-tooltip": [
+          "ds-text"
+        ],
+        "ds-button-unfilled": [
+          "ds-loader",
+          "ds-icon",
+          "ds-badge",
+          "ds-text"
+        ],
+        "ds-badge": [
+          "ds-text"
+        ],
         "ds-button-filled": [
           "ds-loader",
           "ds-icon",
@@ -9799,12 +10307,17 @@
       "states": [],
       "dependents": [],
       "dependencies": [
+        "ds-tooltip",
         "ds-button-unfilled"
       ],
       "dependencyGraph": {
         "ds-message-scroller": [
+          "ds-tooltip",
           "ds-button-unfilled"
         ],
+        "ds-tooltip": [
+          "ds-text"
+        ],
         "ds-button-unfilled": [
           "ds-loader",
           "ds-icon",
@@ -10012,13 +10525,18 @@
       "dependents": [],
       "dependencies": [
         "ds-text",
+        "ds-tooltip",
         "ds-button-unfilled"
       ],
       "dependencyGraph": {
         "ds-modal": [
           "ds-text",
+          "ds-tooltip",
           "ds-button-unfilled"
         ],
+        "ds-tooltip": [
+          "ds-text"
+        ],
         "ds-button-unfilled": [
           "ds-loader",
           "ds-icon",
@@ -10717,7 +11235,7 @@
           },
           "cancelable": true,
           "composed": true,
-          "docs": "Bubbling lifecycle — `ds-app-shell` pauses chrome metrics during width motion.",
+          "docs": "Bubbling lifecycle — `ds-shell-app` pauses chrome metrics during width motion.",
           "docsTags": []
         },
         {
@@ -11447,14 +11965,19 @@
         "ds-panel-tools"
       ],
       "dependencies": [
+        "ds-tooltip",
         "ds-button-unfilled",
         "ds-text"
       ],
       "dependencyGraph": {
         "ds-panel-tool-header": [
+          "ds-tooltip",
           "ds-button-unfilled",
           "ds-text"
         ],
+        "ds-tooltip": [
+          "ds-text"
+        ],
         "ds-button-unfilled": [
           "ds-loader",
           "ds-icon",
@@ -11898,6 +12421,7 @@
       "dependents": [],
       "dependencies": [
         "ds-divider",
+        "ds-tooltip",
         "ds-button-unfilled",
         "ds-icon",
         "ds-text"
@@ -11905,10 +12429,14 @@
       "dependencyGraph": {
         "ds-panel-tool-search": [
           "ds-divider",
+          "ds-tooltip",
           "ds-button-unfilled",
           "ds-icon",
           "ds-text"
         ],
+        "ds-tooltip": [
+          "ds-text"
+        ],
         "ds-button-unfilled": [
           "ds-loader",
           "ds-icon",
@@ -12514,11 +13042,11 @@
         },
         {
           "event": "dsPresentationChange",
-          "detail": "{ presentation: \"fullscreen\" | \"drawer\"; }",
+          "detail": "{ presentation: \"drawer\" | \"fullscreen\"; }",
           "bubbles": true,
           "complexType": {
             "original": "{\n    presentation: 'drawer' | 'fullscreen';\n  }",
-            "resolved": "{ presentation: \"fullscreen\" | \"drawer\"; }",
+            "resolved": "{ presentation: \"drawer\" | \"fullscreen\"; }",
             "references": {}
           },
           "cancelable": true,
@@ -12585,6 +13113,7 @@
           "ds-text"
         ],
         "ds-panel-tool-header": [
+          "ds-tooltip",
           "ds-button-unfilled",
           "ds-text"
         ]
@@ -13986,6 +14515,7 @@
         "ds-loader",
         "ds-text",
         "ds-empty-state",
+        "ds-tooltip",
         "ds-button-unfilled"
       ],
       "dependencyGraph": {
@@ -13994,12 +14524,16 @@
           "ds-loader",
           "ds-text",
           "ds-empty-state",
+          "ds-tooltip",
           "ds-button-unfilled"
         ],
         "ds-empty-state": [
           "ds-icon",
           "ds-text"
         ],
+        "ds-tooltip": [
+          "ds-text"
+        ],
         "ds-button-unfilled": [
           "ds-loader",
           "ds-icon",
@@ -14996,60 +15530,220 @@
           "docsTags": []
         },
         {
-          "event": "dsOpenChange",
-          "detail": "boolean",
-          "bubbles": true,
+          "event": "dsOpenChange",
+          "detail": "boolean",
+          "bubbles": true,
+          "complexType": {
+            "original": "boolean",
+            "resolved": "boolean",
+            "references": {}
+          },
+          "cancelable": true,
+          "composed": true,
+          "docs": "Emitted whenever popup visibility changes.",
+          "docsTags": []
+        }
+      ],
+      "listeners": [],
+      "styles": [],
+      "slots": [],
+      "parts": [],
+      "states": [],
+      "dependents": [],
+      "dependencies": [
+        "ds-checkbox",
+        "ds-loader",
+        "ds-icon",
+        "ds-text",
+        "ds-empty-state",
+        "ds-tooltip",
+        "ds-button-unfilled"
+      ],
+      "dependencyGraph": {
+        "ds-select-multi": [
+          "ds-checkbox",
+          "ds-loader",
+          "ds-icon",
+          "ds-text",
+          "ds-empty-state",
+          "ds-tooltip",
+          "ds-button-unfilled"
+        ],
+        "ds-checkbox": [
+          "ds-text"
+        ],
+        "ds-empty-state": [
+          "ds-icon",
+          "ds-text"
+        ],
+        "ds-tooltip": [
+          "ds-text"
+        ],
+        "ds-button-unfilled": [
+          "ds-loader",
+          "ds-icon",
+          "ds-badge",
+          "ds-text"
+        ],
+        "ds-badge": [
+          "ds-text"
+        ]
+      }
+    },
+    {
+      "filePath": "src/wc/components/ShellApp/ShellApp.tsx",
+      "encapsulation": "scoped",
+      "tag": "ds-shell-app",
+      "docs": "",
+      "docsTags": [],
+      "usage": {},
+      "props": [
+        {
+          "name": "gradientPreset",
+          "type": "\"cool\" | \"fresh\" | \"neutral\" | \"none\" | \"warm\"",
+          "complexType": {
+            "original": "ShellGradientPreset",
+            "resolved": "\"cool\" | \"fresh\" | \"neutral\" | \"none\" | \"warm\"",
+            "references": {
+              "ShellGradientPreset": {
+                "location": "import",
+                "path": "../../shell/shell-gradient-presets",
+                "id": "src/wc/shell/shell-gradient-presets.ts::ShellGradientPreset",
+                "referenceLocation": "ShellGradientPreset"
+              }
+            }
+          },
+          "mutable": false,
+          "attr": "gradient-preset",
+          "reflectToAttr": true,
+          "docs": "Shell chrome wash preset. `none` renders solid chrome; the remaining\npresets use token-based washes that adapt to the active color theme.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "'neutral'"
+            }
+          ],
+          "default": "'neutral'",
+          "values": [
+            {
+              "value": "cool",
+              "type": "string"
+            },
+            {
+              "value": "fresh",
+              "type": "string"
+            },
+            {
+              "value": "neutral",
+              "type": "string"
+            },
+            {
+              "value": "none",
+              "type": "string"
+            },
+            {
+              "value": "warm",
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "navStyle",
+          "type": "\"dashboard\" | \"settings\"",
+          "complexType": {
+            "original": "NavChromeStyle",
+            "resolved": "\"dashboard\" | \"settings\"",
+            "references": {
+              "NavChromeStyle": {
+                "location": "import",
+                "path": "../../shell/nav-chrome",
+                "id": "src/wc/shell/nav-chrome.ts::NavChromeStyle",
+                "referenceLocation": "NavChromeStyle"
+              }
+            }
+          },
+          "mutable": false,
+          "attr": "nav-style",
+          "reflectToAttr": true,
+          "docs": "Chrome style propagated to slotted `ds-panel-nav` and `ds-bar-nav`.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "'dashboard'"
+            }
+          ],
+          "default": "'dashboard'",
+          "values": [
+            {
+              "value": "dashboard",
+              "type": "string"
+            },
+            {
+              "value": "settings",
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "shortcutsEnabled",
+          "type": "boolean",
           "complexType": {
             "original": "boolean",
             "resolved": "boolean",
             "references": {}
           },
-          "cancelable": true,
-          "composed": true,
-          "docs": "Emitted whenever popup visibility changes.",
-          "docsTags": []
+          "mutable": false,
+          "attr": "shortcuts-enabled",
+          "reflectToAttr": false,
+          "docs": "When `true` (default), registers global shell keyboard shortcuts. `[` toggles panel nav; `]` closes tools; K, A, S, M, N, and / toggle tool drawers. Modifiers are ignored so browser chords like ⌘N stay native.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "true"
+            }
+          ],
+          "default": "true",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        }
+      ],
+      "methods": [],
+      "events": [],
+      "listeners": [
+        {
+          "event": "dsPresentationChange",
+          "capture": false,
+          "passive": false
+        },
+        {
+          "event": "keydown",
+          "target": "window",
+          "capture": true,
+          "passive": false
         }
       ],
-      "listeners": [],
       "styles": [],
       "slots": [],
       "parts": [],
       "states": [],
       "dependents": [],
-      "dependencies": [
-        "ds-checkbox",
-        "ds-loader",
-        "ds-icon",
-        "ds-text",
-        "ds-empty-state",
-        "ds-button-unfilled"
-      ],
-      "dependencyGraph": {
-        "ds-select-multi": [
-          "ds-checkbox",
-          "ds-loader",
-          "ds-icon",
-          "ds-text",
-          "ds-empty-state",
-          "ds-button-unfilled"
-        ],
-        "ds-checkbox": [
-          "ds-text"
-        ],
-        "ds-empty-state": [
-          "ds-icon",
-          "ds-text"
-        ],
-        "ds-button-unfilled": [
-          "ds-loader",
-          "ds-icon",
-          "ds-badge",
-          "ds-text"
-        ],
-        "ds-badge": [
-          "ds-text"
-        ]
-      }
+      "dependencies": [],
+      "dependencyGraph": {}
     },
     {
       "filePath": "src/wc/components/ShellGradientPicker/ShellGradientPicker.tsx",
@@ -15378,6 +16072,116 @@
       "dependencyGraph": {},
       "deprecation": "Use `ds-swatch-picker`; individual swatches are implementation detail."
     },
+    {
+      "filePath": "src/wc/components/ShellPage/ShellPage.tsx",
+      "encapsulation": "scoped",
+      "tag": "ds-shell-page",
+      "docs": "",
+      "docsTags": [],
+      "usage": {},
+      "props": [
+        {
+          "name": "contentInset",
+          "type": "\"default\" | \"none\"",
+          "complexType": {
+            "original": "ShellPageContentInset",
+            "resolved": "\"default\" | \"none\"",
+            "references": {
+              "ShellPageContentInset": {
+                "location": "import",
+                "path": "./shell-page-types",
+                "id": "src/wc/components/ShellPage/shell-page-types.ts::ShellPageContentInset",
+                "referenceLocation": "ShellPageContentInset"
+              }
+            }
+          },
+          "mutable": false,
+          "attr": "content-inset",
+          "reflectToAttr": false,
+          "docs": "Standard page gutters, or no inset for full-bleed page content.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "'default'"
+            }
+          ],
+          "default": "'default'",
+          "values": [
+            {
+              "value": "default",
+              "type": "string"
+            },
+            {
+              "value": "none",
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "headerPresentation",
+          "type": "\"auto\" | \"compact\" | \"constrained\" | \"expanded\"",
+          "complexType": {
+            "original": "ShellPageHeaderPresentation",
+            "resolved": "\"auto\" | \"compact\" | \"constrained\" | \"expanded\"",
+            "references": {
+              "ShellPageHeaderPresentation": {
+                "location": "import",
+                "path": "./shell-page-types",
+                "id": "src/wc/components/ShellPage/shell-page-types.ts::ShellPageHeaderPresentation",
+                "referenceLocation": "ShellPageHeaderPresentation"
+              }
+            }
+          },
+          "mutable": false,
+          "attr": "header-presentation",
+          "reflectToAttr": false,
+          "docs": "Automatic container/scroll behavior, or an explicit header variant override.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "'auto'"
+            }
+          ],
+          "default": "'auto'",
+          "values": [
+            {
+              "value": "auto",
+              "type": "string"
+            },
+            {
+              "value": "compact",
+              "type": "string"
+            },
+            {
+              "value": "constrained",
+              "type": "string"
+            },
+            {
+              "value": "expanded",
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        }
+      ],
+      "methods": [],
+      "events": [],
+      "listeners": [],
+      "styles": [],
+      "slots": [],
+      "parts": [],
+      "states": [],
+      "dependents": [],
+      "dependencies": [],
+      "dependencyGraph": {}
+    },
     {
       "filePath": "src/wc/components/Skeleton/Skeleton.tsx",
       "encapsulation": "shadow",
@@ -18580,6 +19384,7 @@
         "ds-attachment-list",
         "ds-badge",
         "ds-bar-nav",
+        "ds-bar-title",
         "ds-button-filled",
         "ds-button-unfilled",
         "ds-card-setting",
@@ -18631,6 +19436,9 @@
         "ds-bar-nav": [
           "ds-text"
         ],
+        "ds-bar-title": [
+          "ds-text"
+        ],
         "ds-button-filled": [
           "ds-text"
         ],
@@ -19350,8 +20158,17 @@
       "parts": [],
       "states": [],
       "dependents": [
+        "ds-bar-title",
+        "ds-code-block",
+        "ds-message-composer",
+        "ds-message-scroller",
+        "ds-modal",
         "ds-panel-nav",
-        "ds-panel-tools"
+        "ds-panel-tool-header",
+        "ds-panel-tool-search",
+        "ds-panel-tools",
+        "ds-select",
+        "ds-select-multi"
       ],
       "dependencies": [
         "ds-text"
@@ -19360,11 +20177,38 @@
         "ds-tooltip": [
           "ds-text"
         ],
+        "ds-bar-title": [
+          "ds-tooltip"
+        ],
+        "ds-code-block": [
+          "ds-tooltip"
+        ],
+        "ds-message-composer": [
+          "ds-tooltip"
+        ],
+        "ds-message-scroller": [
+          "ds-tooltip"
+        ],
+        "ds-modal": [
+          "ds-tooltip"
+        ],
         "ds-panel-nav": [
           "ds-tooltip"
         ],
+        "ds-panel-tool-header": [
+          "ds-tooltip"
+        ],
+        "ds-panel-tool-search": [
+          "ds-tooltip"
+        ],
         "ds-panel-tools": [
           "ds-tooltip"
+        ],
+        "ds-select": [
+          "ds-tooltip"
+        ],
+        "ds-select-multi": [
+          "ds-tooltip"
         ]
       }
     },
@@ -19372,7 +20216,7 @@
       "filePath": "src/wc/components/TooltipDataViz/TooltipDataViz.tsx",
       "encapsulation": "scoped",
       "tag": "ds-tooltip-data-viz",
-      "docs": "Positioned value/label callout for chart hover interactions (bar, line point, …).\nDonut charts skip this — legend sync already surfaces the hovered slice.\nUnlike `ds-tooltip`, this doesn't bind to a slotted anchor element —\ncharts hover-highlight data that lives inside an SVG, so the chart itself computes\nthe anchor point (e.g. the cursor position while hovering) and passes it in as `x`/`y`.\n\nRenders `position: absolute` — place inside a `position: relative` chart wrapper,\nwith `x`/`y` as pixel coordinates within that wrapper. Defaults to sitting below-right\nof the anchor (matching cursor-following tooltips), flipping to whichever side/edge\nkeeps it on-screen.\n\nMount (or remount) when a hover session starts so `delay` applies once per hover;\nkeep the instance mounted while the cursor moves so tracking stays instant.",
+      "docs": "Positioned value/label callout for chart hover interactions (bar, line point,\nstandalone donut slice, …). Donut compositions suppress it when a visible\nlegend already surfaces the hovered slice.\nUnlike `ds-tooltip`, this doesn't bind to a slotted anchor element —\ncharts hover-highlight data that lives inside an SVG, so the chart itself computes\nthe anchor point (e.g. the cursor position while hovering) and passes it in as `x`/`y`.\n\nRenders `position: absolute` — place inside a `position: relative` chart wrapper,\nwith `x`/`y` as pixel coordinates within that wrapper. Defaults to sitting below-right\nof the anchor (matching cursor-following tooltips), flipping to whichever side/edge\nkeeps it on-screen.\n\nMount (or remount) when a hover session starts so `delay` applies once per hover;\nkeep the instance mounted while the cursor moves so tracking stays instant.",
       "docsTags": [],
       "usage": {},
       "props": [
@@ -19535,13 +20379,18 @@
       "slots": [],
       "parts": [],
       "states": [],
-      "dependents": [],
+      "dependents": [
+        "ds-chart-donut"
+      ],
       "dependencies": [
         "ds-text"
       ],
       "dependencyGraph": {
         "ds-tooltip-data-viz": [
           "ds-text"
+        ],
+        "ds-chart-donut": [
+          "ds-tooltip-data-viz"
         ]
       }
     },
@@ -19647,6 +20496,11 @@
       "docstring": "",
       "path": "src/wc/components/ButtonFilled/ButtonFilled.tsx"
     },
+    "src/wc/components/ButtonFilled/ButtonFilled.tsx::ButtonFilledBackground": {
+      "declaration": "export type ChoiceBackground =\n  | 'faint'\n  | 'medium'\n  | 'bold'\n  | 'strong'\n  | 'translucent'\n  | 'inverted'\n  | 'media'\n  | 'always-dark';",
+      "docstring": "",
+      "path": "src/wc/components/ButtonFilled/ButtonFilled.tsx"
+    },
     "src/wc/components/ButtonUnfilled/ButtonUnfilled.tsx::ButtonUnfilledVariant": {
       "declaration": "export type ButtonUnfilledVariant = 'icon' | 'label' | 'icon-label';",
       "docstring": "",
@@ -20027,21 +20881,41 @@
       "docstring": "",
       "path": "src/wc/components/conversation-types.ts"
     },
-    "src/wc/shell/nav-chrome.ts::NavChromeStyle": {
-      "declaration": "export type NavChromeStyle = 'dashboard' | 'settings';",
-      "docstring": "",
-      "path": "src/wc/shell/nav-chrome.ts"
-    },
     "src/wc/components/conversation-types.ts::ConversationAttachment": {
       "declaration": "export interface ConversationAttachment {\n  id: string;\n  name: string;\n  mediaType?: string;\n  size?: string;\n  url?: string;\n}",
       "docstring": "",
       "path": "src/wc/components/conversation-types.ts"
     },
+    "src/wc/shell/nav-chrome.ts::NavChromeStyle": {
+      "declaration": "export type NavChromeStyle = 'dashboard' | 'settings';",
+      "docstring": "",
+      "path": "src/wc/shell/nav-chrome.ts"
+    },
     "src/wc/components/BarNav/bar-nav-types.ts::BarNavTab": {
       "declaration": "export type TabItem = TabItemTab | TabItemDivider;",
       "docstring": "",
       "path": "src/wc/components/BarNav/bar-nav-types.ts"
     },
+    "src/wc/components/BarTitle/bar-title-types.ts::BarTitleSectionItem": {
+      "declaration": "export type BarTitleSectionItem = BarTitleSection | BarTitleDivider;",
+      "docstring": "",
+      "path": "src/wc/components/BarTitle/bar-title-types.ts"
+    },
+    "src/wc/components/BarTitle/bar-title-types.ts::BarTitlePrimaryAction": {
+      "declaration": "export interface BarTitlePrimaryAction extends BarTitleAction {\n  icon?: string;\n  intent?: ButtonFilledIntent;\n  contrast?: ButtonFilledContrast;\n  isLoading?: boolean;\n  type?: 'button' | 'submit' | 'reset';\n  collapse?: BarTitlePrimaryActionCollapse;\n}",
+      "docstring": "",
+      "path": "src/wc/components/BarTitle/bar-title-types.ts"
+    },
+    "src/wc/components/BarTitle/bar-title-types.ts::BarTitleActionItem": {
+      "declaration": "export type BarTitleActionItem = BarTitleAction | BarTitleDivider;",
+      "docstring": "",
+      "path": "src/wc/components/BarTitle/bar-title-types.ts"
+    },
+    "src/wc/components/BarTitle/bar-title-types.ts::BarTitleVariant": {
+      "declaration": "export type BarTitleVariant = 'expanded' | 'compact' | 'constrained';",
+      "docstring": "",
+      "path": "src/wc/components/BarTitle/bar-title-types.ts"
+    },
     "src/wc/utils/chart-types.ts::ChartDatum": {
       "declaration": "export interface ChartDatum {\n  label: string;\n  value: number;\n  /** CSS color override; defaults to the next `--color-data-category-*` token. */\n  color?: string;\n}",
       "docstring": "Shared data shapes for `ds-chart-*` components — kept minimal for the initial scaffold, expect these to grow per component once design is finalized.",
@@ -20127,6 +21001,16 @@
       "docstring": "",
       "path": "src/wc/components/ShellGradientSwatch/shell-gradient-swatch-types.ts"
     },
+    "src/wc/components/ShellPage/shell-page-types.ts::ShellPageHeaderPresentation": {
+      "declaration": "export type ShellPageHeaderPresentation = 'auto' | BarTitleVariant;",
+      "docstring": "",
+      "path": "src/wc/components/ShellPage/shell-page-types.ts"
+    },
+    "src/wc/components/ShellPage/shell-page-types.ts::ShellPageContentInset": {
+      "declaration": "export type ShellPageContentInset = 'default' | 'none';",
+      "docstring": "",
+      "path": "src/wc/components/ShellPage/shell-page-types.ts"
+    },
     "src/wc/components/SwatchPicker/swatch-picker-types.ts::SwatchPickerOption": {
       "declaration": "export interface SwatchPickerOption {\n  /** Stable value emitted when this option is selected. */\n  value: string;\n  /** Accessible option name; the visual preview never replaces this label. */\n  label: string;\n  preview: SwatchPickerPreview;\n  isInactive?: boolean;\n}",
       "docstring": "",