@ds-mo/ui 11.1.0 → 12.0.0

package/dist/docs/components.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2026-07-21T23:24:49",
+  "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",
@@ -1643,7 +1492,380 @@
       "usage": {},
       "props": [
         {
-          "name": "basePath",
+          "name": "basePath",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "base-path",
+          "reflectToAttr": false,
+          "docs": "Section base path (e.g. `/dashboard/safety`). Used with `currentUrl` to derive `value`.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "''"
+            }
+          ],
+          "default": "''",
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "currentUrl",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "current-url",
+          "reflectToAttr": false,
+          "docs": "Current route URL. When set with `basePath`, the active tab is derived automatically.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "''"
+            }
+          ],
+          "default": "''",
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "heading",
+          "type": "string | undefined",
+          "complexType": {
+            "original": "string | undefined",
+            "resolved": "string | undefined",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "heading",
+          "reflectToAttr": false,
+          "docs": "Fallback heading shown when no tabs are provided.\nWhen tabs are present the heading is hidden.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "undefined"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "moreTabsLabel",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "more-tabs-label",
+          "reflectToAttr": false,
+          "docs": "",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "'More tabs'"
+            }
+          ],
+          "default": "'More tabs'",
+          "values": [
+            {
+              "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": "Style slot: `dashboard` or `settings`. Colors match for now.",
+          "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": "tabs",
+          "type": "TabItem[]",
+          "complexType": {
+            "original": "BarNavTab[]",
+            "resolved": "TabItem[]",
+            "references": {
+              "BarNavTab": {
+                "location": "import",
+                "path": "./bar-nav-types",
+                "id": "src/wc/components/BarNav/bar-nav-types.ts::BarNavTab",
+                "referenceLocation": "BarNavTab"
+              }
+            }
+          },
+          "mutable": false,
+          "reflectToAttr": false,
+          "docs": "Tab items for the left section.\nSet via JS property: `el.tabs = [...]`. Replace the array reference to update.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "[]"
+            }
+          ],
+          "default": "[]",
+          "values": [
+            {
+              "type": "TabItem[]"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "tabsJson",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "tabs-json",
+          "reflectToAttr": false,
+          "docs": "JSON fallback for `tabs` — useful when framework bindings don't propagate arrays.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "''"
+            }
+          ],
+          "default": "''",
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "value",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": true,
+          "attr": "value",
+          "reflectToAttr": false,
+          "docs": "ID of the currently active tab. Overridden when `currentUrl` + `basePath` are set.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "''"
+            }
+          ],
+          "default": "''",
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        }
+      ],
+      "methods": [],
+      "events": [
+        {
+          "event": "dsTabChange",
+          "detail": "string",
+          "bubbles": true,
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "cancelable": true,
+          "composed": true,
+          "docs": "Emitted when the active tab changes. Detail = tab id.",
+          "docsTags": []
+        }
+      ],
+      "listeners": [],
+      "styles": [],
+      "slots": [],
+      "parts": [],
+      "states": [],
+      "dependents": [],
+      "dependencies": [
+        "ds-text",
+        "ds-badge",
+        "ds-button-unfilled",
+        "ds-menu"
+      ],
+      "dependencyGraph": {
+        "ds-bar-nav": [
+          "ds-text",
+          "ds-badge",
+          "ds-button-unfilled",
+          "ds-menu"
+        ],
+        "ds-badge": [
+          "ds-text"
+        ],
+        "ds-button-unfilled": [
+          "ds-loader",
+          "ds-icon",
+          "ds-badge",
+          "ds-text"
+        ],
+        "ds-menu": [
+          "ds-text",
+          "ds-swatch-picker",
+          "ds-badge",
+          "ds-switch"
+        ]
+      }
+    },
+    {
+      "filePath": "src/wc/components/BarTitle/BarTitle.tsx",
+      "encapsulation": "scoped",
+      "tag": "ds-bar-title",
+      "docs": "",
+      "docsTags": [],
+      "usage": {},
+      "props": [
+        {
+          "name": "actions",
+          "type": "BarTitleActionItem[]",
+          "complexType": {
+            "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,
+          "reflectToAttr": false,
+          "docs": "Secondary page actions shown in the overflow menu. Dividers create groups.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "[]"
+            }
+          ],
+          "default": "[]",
+          "values": [
+            {
+              "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"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "backAriaLabel",
           "type": "string",
           "complexType": {
             "original": "string",
@@ -1651,16 +1873,16 @@
             "references": {}
           },
           "mutable": false,
-          "attr": "base-path",
+          "attr": "back-aria-label",
           "reflectToAttr": false,
-          "docs": "Section base path (e.g. `/dashboard/safety`). Used with `currentUrl` to derive `value`.",
+          "docs": "Accessible name for the leading Back action.",
           "docsTags": [
             {
               "name": "default",
-              "text": "''"
+              "text": "'Back'"
             }
           ],
-          "default": "''",
+          "default": "'Back'",
           "values": [
             {
               "type": "string"
@@ -1672,7 +1894,7 @@
           "setter": false
         },
         {
-          "name": "currentUrl",
+          "name": "backLabel",
           "type": "string",
           "complexType": {
             "original": "string",
@@ -1680,16 +1902,16 @@
             "references": {}
           },
           "mutable": false,
-          "attr": "current-url",
+          "attr": "back-label",
           "reflectToAttr": false,
-          "docs": "Current route URL. When set with `basePath`, the active tab is derived automatically.",
+          "docs": "Visible parent-page label used by the expanded Back breadcrumb.",
           "docsTags": [
             {
               "name": "default",
-              "text": "''"
+              "text": "'Back'"
             }
           ],
-          "default": "''",
+          "default": "'Back'",
           "values": [
             {
               "type": "string"
@@ -1701,24 +1923,27 @@
           "setter": false
         },
         {
-          "name": "heading",
-          "type": "string | undefined",
+          "name": "description",
+          "type": "string",
           "complexType": {
-            "original": "string | undefined",
-            "resolved": "string | undefined",
+            "original": "string",
+            "resolved": "string",
             "references": {}
           },
           "mutable": false,
-          "attr": "heading",
+          "attr": "description",
           "reflectToAttr": false,
-          "docs": "Fallback heading shown when no tabs are provided.\nWhen tabs are present the heading is hidden.",
-          "docsTags": [],
+          "docs": "Optional supporting copy shown in the expanded presentation.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "''"
+            }
+          ],
+          "default": "''",
           "values": [
             {
               "type": "string"
-            },
-            {
-              "type": "undefined"
             }
           ],
           "optional": false,
@@ -1727,7 +1952,7 @@
           "setter": false
         },
         {
-          "name": "moreTabsLabel",
+          "name": "heading",
           "type": "string",
           "complexType": {
             "original": "string",
@@ -1735,60 +1960,51 @@
             "references": {}
           },
           "mutable": false,
-          "attr": "more-tabs-label",
+          "attr": "heading",
           "reflectToAttr": false,
-          "docs": "",
-          "docsTags": [
-            {
-              "name": "default",
-              "text": "'More tabs'"
-            }
-          ],
-          "default": "'More tabs'",
+          "docs": "The page's single visible h1.",
+          "docsTags": [],
           "values": [
             {
               "type": "string"
             }
           ],
           "optional": false,
-          "required": false,
+          "required": true,
           "getter": false,
           "setter": false
         },
         {
-          "name": "navStyle",
-          "type": "\"dashboard\" | \"settings\"",
+          "name": "primaryAction",
+          "type": "BarTitlePrimaryAction | null",
           "complexType": {
-            "original": "NavChromeStyle",
-            "resolved": "\"dashboard\" | \"settings\"",
+            "original": "BarTitlePrimaryAction | null",
+            "resolved": "BarTitlePrimaryAction | null",
             "references": {
-              "NavChromeStyle": {
+              "BarTitlePrimaryAction": {
                 "location": "import",
-                "path": "../../shell/nav-chrome",
-                "id": "src/wc/shell/nav-chrome.ts::NavChromeStyle",
-                "referenceLocation": "NavChromeStyle"
+                "path": "./bar-title-types",
+                "id": "src/wc/components/BarTitle/bar-title-types.ts::BarTitlePrimaryAction",
+                "referenceLocation": "BarTitlePrimaryAction"
               }
             }
           },
           "mutable": false,
-          "attr": "nav-style",
-          "reflectToAttr": true,
-          "docs": "Style slot: `dashboard` or `settings`. Colors match for now.",
+          "reflectToAttr": false,
+          "docs": "The one highest-emphasis page action.",
           "docsTags": [
             {
               "name": "default",
-              "text": "'dashboard'"
+              "text": "null"
             }
           ],
-          "default": "'dashboard'",
+          "default": "null",
           "values": [
             {
-              "value": "dashboard",
-              "type": "string"
+              "type": "BarTitlePrimaryAction"
             },
             {
-              "value": "settings",
-              "type": "string"
+              "type": "null"
             }
           ],
           "optional": false,
@@ -1797,23 +2013,23 @@
           "setter": false
         },
         {
-          "name": "tabs",
-          "type": "TabItem[]",
+          "name": "sections",
+          "type": "BarTitleSectionItem[]",
           "complexType": {
-            "original": "BarNavTab[]",
-            "resolved": "TabItem[]",
+            "original": "BarTitleSectionItem[]",
+            "resolved": "BarTitleSectionItem[]",
             "references": {
-              "BarNavTab": {
+              "BarTitleSectionItem": {
                 "location": "import",
-                "path": "./bar-nav-types",
-                "id": "src/wc/components/BarNav/bar-nav-types.ts::BarNavTab",
-                "referenceLocation": "BarNavTab"
+                "path": "./bar-title-types",
+                "id": "src/wc/components/BarTitle/bar-title-types.ts::BarTitleSectionItem",
+                "referenceLocation": "BarTitleSectionItem"
               }
             }
           },
           "mutable": false,
           "reflectToAttr": false,
-          "docs": "Tab items for the left section.\nSet via JS property: `el.tabs = [...]`. Replace the array reference to update.",
+          "docs": "Optional page sections exposed through the active-section menu.",
           "docsTags": [
             {
               "name": "default",
@@ -1823,7 +2039,7 @@
           "default": "[]",
           "values": [
             {
-              "type": "TabItem[]"
+              "type": "BarTitleSectionItem[]"
             }
           ],
           "optional": false,
@@ -1832,7 +2048,7 @@
           "setter": false
         },
         {
-          "name": "tabsJson",
+          "name": "sectionsAriaLabel",
           "type": "string",
           "complexType": {
             "original": "string",
@@ -1840,16 +2056,16 @@
             "references": {}
           },
           "mutable": false,
-          "attr": "tabs-json",
+          "attr": "sections-aria-label",
           "reflectToAttr": false,
-          "docs": "JSON fallback for `tabs` — useful when framework bindings don't propagate arrays.",
+          "docs": "Accessible name for the page-section menu.",
           "docsTags": [
             {
               "name": "default",
-              "text": "''"
+              "text": "'Change page section'"
             }
           ],
-          "default": "''",
+          "default": "'Change page section'",
           "values": [
             {
               "type": "string"
@@ -1860,6 +2076,35 @@
           "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",
@@ -1868,10 +2113,10 @@
             "resolved": "string",
             "references": {}
           },
-          "mutable": true,
+          "mutable": false,
           "attr": "value",
           "reflectToAttr": false,
-          "docs": "ID of the currently active tab. Overridden when `currentUrl` + `basePath` are set.",
+          "docs": "Id of the active page section.",
           "docsTags": [
             {
               "name": "default",
@@ -1888,12 +2133,57 @@
           "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": "dsTabChange",
+          "event": "dsAction",
           "detail": "string",
           "bubbles": true,
           "complexType": {
@@ -1903,7 +2193,40 @@
           },
           "cancelable": true,
           "composed": true,
-          "docs": "Emitted when the active tab changes. Detail = tab id.",
+          "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": []
         }
       ],
@@ -1915,18 +2238,24 @@
       "dependents": [],
       "dependencies": [
         "ds-text",
-        "ds-badge",
+        "ds-icon",
+        "ds-button-filled",
         "ds-button-unfilled",
+        "ds-tooltip",
         "ds-menu"
       ],
       "dependencyGraph": {
-        "ds-bar-nav": [
+        "ds-bar-title": [
           "ds-text",
-          "ds-badge",
+          "ds-icon",
+          "ds-button-filled",
           "ds-button-unfilled",
+          "ds-tooltip",
           "ds-menu"
         ],
-        "ds-badge": [
+        "ds-button-filled": [
+          "ds-loader",
+          "ds-icon",
           "ds-text"
         ],
         "ds-button-unfilled": [
@@ -1935,6 +2264,12 @@
           "ds-badge",
           "ds-text"
         ],
+        "ds-badge": [
+          "ds-text"
+        ],
+        "ds-tooltip": [
+          "ds-text"
+        ],
         "ds-menu": [
           "ds-text",
           "ds-swatch-picker",
@@ -2552,6 +2887,7 @@
       "parts": [],
       "states": [],
       "dependents": [
+        "ds-bar-title",
         "ds-card-setting",
         "ds-message-composer"
       ],
@@ -2566,6 +2902,9 @@
           "ds-icon",
           "ds-text"
         ],
+        "ds-bar-title": [
+          "ds-button-filled"
+        ],
         "ds-card-setting": [
           "ds-button-filled"
         ],
@@ -3326,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",
@@ -3359,6 +3700,9 @@
         "ds-bar-nav": [
           "ds-button-unfilled"
         ],
+        "ds-bar-title": [
+          "ds-button-unfilled"
+        ],
         "ds-card-data-viz-donut": [
           "ds-button-unfilled"
         ],
@@ -3371,6 +3715,9 @@
         "ds-input": [
           "ds-button-unfilled"
         ],
+        "ds-message-composer": [
+          "ds-button-unfilled"
+        ],
         "ds-message-scroller": [
           "ds-button-unfilled"
         ],
@@ -5581,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",
@@ -6950,6 +7302,7 @@
         "ds-agent-tool-call",
         "ds-attachment-list",
         "ds-avatar",
+        "ds-bar-title",
         "ds-button-filled",
         "ds-button-unfilled",
         "ds-chip",
@@ -6979,6 +7332,9 @@
         "ds-avatar": [
           "ds-icon"
         ],
+        "ds-bar-title": [
+          "ds-icon"
+        ],
         "ds-button-filled": [
           "ds-icon"
         ],
@@ -8288,8 +8644,12 @@
         ],
         "ds-code-block": [
           "ds-text",
+          "ds-tooltip",
           "ds-button-unfilled"
         ],
+        "ds-tooltip": [
+          "ds-text"
+        ],
         "ds-button-unfilled": [
           "ds-loader",
           "ds-icon",
@@ -8916,7 +9276,8 @@
       "parts": [],
       "states": [],
       "dependents": [
-        "ds-bar-nav"
+        "ds-bar-nav",
+        "ds-bar-title"
       ],
       "dependencies": [
         "ds-text",
@@ -8936,6 +9297,9 @@
         ],
         "ds-bar-nav": [
           "ds-menu"
+        ],
+        "ds-bar-title": [
+          "ds-menu"
         ]
       }
     },
@@ -9666,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",
@@ -9927,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",
@@ -10140,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",
@@ -10845,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": []
         },
         {
@@ -11575,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",
@@ -12026,6 +12421,7 @@
       "dependents": [],
       "dependencies": [
         "ds-divider",
+        "ds-tooltip",
         "ds-button-unfilled",
         "ds-icon",
         "ds-text"
@@ -12033,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",
@@ -12642,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,
@@ -12713,6 +13113,7 @@
           "ds-text"
         ],
         "ds-panel-tool-header": [
+          "ds-tooltip",
           "ds-button-unfilled",
           "ds-text"
         ]
@@ -14114,6 +14515,7 @@
         "ds-loader",
         "ds-text",
         "ds-empty-state",
+        "ds-tooltip",
         "ds-button-unfilled"
       ],
       "dependencyGraph": {
@@ -14122,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",
@@ -15070,114 +15476,274 @@
           "setter": false
         }
       ],
-      "methods": [
-        {
-          "name": "setFocus",
-          "returns": {
-            "type": "Promise<void>",
-            "docs": ""
-          },
-          "complexType": {
-            "signature": "() => Promise<void>",
-            "parameters": [],
-            "references": {
-              "Promise": {
-                "location": "global",
-                "id": "global::Promise"
-              }
-            },
-            "return": "Promise<void>"
-          },
-          "signature": "setFocus() => Promise<void>",
-          "parameters": [],
-          "docs": "",
-          "docsTags": []
-        }
-      ],
-      "events": [
-        {
-          "event": "dsChange",
-          "detail": "string[]",
-          "bubbles": true,
-          "complexType": {
-            "original": "string[]",
-            "resolved": "string[]",
-            "references": {}
-          },
-          "cancelable": true,
-          "composed": true,
-          "docs": "Emitted after user toggles or clearing with a new values array.",
-          "docsTags": []
-        },
+      "methods": [
+        {
+          "name": "setFocus",
+          "returns": {
+            "type": "Promise<void>",
+            "docs": ""
+          },
+          "complexType": {
+            "signature": "() => Promise<void>",
+            "parameters": [],
+            "references": {
+              "Promise": {
+                "location": "global",
+                "id": "global::Promise"
+              }
+            },
+            "return": "Promise<void>"
+          },
+          "signature": "setFocus() => Promise<void>",
+          "parameters": [],
+          "docs": "",
+          "docsTags": []
+        }
+      ],
+      "events": [
+        {
+          "event": "dsChange",
+          "detail": "string[]",
+          "bubbles": true,
+          "complexType": {
+            "original": "string[]",
+            "resolved": "string[]",
+            "references": {}
+          },
+          "cancelable": true,
+          "composed": true,
+          "docs": "Emitted after user toggles or clearing with a new values array.",
+          "docsTags": []
+        },
+        {
+          "event": "dsClear",
+          "detail": "void",
+          "bubbles": true,
+          "complexType": {
+            "original": "void",
+            "resolved": "void",
+            "references": {}
+          },
+          "cancelable": true,
+          "composed": true,
+          "docs": "Emitted after the footer clear-all action.",
+          "docsTags": []
+        },
+        {
+          "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": {}
+          },
+          "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": "dsClear",
-          "detail": "void",
-          "bubbles": true,
-          "complexType": {
-            "original": "void",
-            "resolved": "void",
-            "references": {}
-          },
-          "cancelable": true,
-          "composed": true,
-          "docs": "Emitted after the footer clear-all action.",
-          "docsTags": []
+          "event": "dsPresentationChange",
+          "capture": false,
+          "passive": false
         },
         {
-          "event": "dsOpenChange",
-          "detail": "boolean",
-          "bubbles": true,
-          "complexType": {
-            "original": "boolean",
-            "resolved": "boolean",
-            "references": {}
-          },
-          "cancelable": true,
-          "composed": true,
-          "docs": "Emitted whenever popup visibility changes.",
-          "docsTags": []
+          "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",
@@ -15506,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",
@@ -18708,6 +19384,7 @@
         "ds-attachment-list",
         "ds-badge",
         "ds-bar-nav",
+        "ds-bar-title",
         "ds-button-filled",
         "ds-button-unfilled",
         "ds-card-setting",
@@ -18759,6 +19436,9 @@
         "ds-bar-nav": [
           "ds-text"
         ],
+        "ds-bar-title": [
+          "ds-text"
+        ],
         "ds-button-filled": [
           "ds-text"
         ],
@@ -19478,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"
@@ -19488,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"
         ]
       }
     },
@@ -20165,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.",
@@ -20265,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": "",