@ds-mo/ui 12.9.0 → 13.1.0

package/dist/docs/components.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2026-07-30T02:29:14",
+  "timestamp": "2026-07-31T00:00:25",
   "compiler": {
     "name": "@stencil/core",
     "version": "4.43.5",
@@ -1494,6 +1494,7 @@
       "states": [],
       "dependents": [
         "ds-bar-nav",
+        "ds-button-filled",
         "ds-button-unfilled",
         "ds-conversation-list-item",
         "ds-menu",
@@ -1512,6 +1513,9 @@
         "ds-bar-nav": [
           "ds-badge"
         ],
+        "ds-button-filled": [
+          "ds-badge"
+        ],
         "ds-button-unfilled": [
           "ds-badge"
         ],
@@ -1732,35 +1736,6 @@
           "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",
@@ -1813,7 +1788,9 @@
       "slots": [],
       "parts": [],
       "states": [],
-      "dependents": [],
+      "dependents": [
+        "ds-shell-app"
+      ],
       "dependencies": [
         "ds-text",
         "ds-badge",
@@ -1841,6 +1818,9 @@
           "ds-swatch-picker",
           "ds-badge",
           "ds-switch"
+        ],
+        "ds-shell-app": [
+          "ds-bar-nav"
         ]
       }
     },
@@ -2372,7 +2352,9 @@
       "slots": [],
       "parts": [],
       "states": [],
-      "dependents": [],
+      "dependents": [
+        "ds-shell-app"
+      ],
       "dependencies": [
         "ds-text",
         "ds-icon",
@@ -2395,6 +2377,10 @@
         "ds-button-filled": [
           "ds-loader",
           "ds-icon",
+          "ds-badge",
+          "ds-text"
+        ],
+        "ds-badge": [
           "ds-text"
         ],
         "ds-tooltip": [
@@ -2406,9 +2392,6 @@
           "ds-badge",
           "ds-text"
         ],
-        "ds-badge": [
-          "ds-text"
-        ],
         "ds-breadcrumb": [
           "ds-text"
         ],
@@ -2417,6 +2400,9 @@
           "ds-swatch-picker",
           "ds-badge",
           "ds-switch"
+        ],
+        "ds-shell-app": [
+          "ds-bar-title"
         ]
       }
     },
@@ -2823,6 +2809,10 @@
         "ds-button-filled": [
           "ds-loader",
           "ds-icon",
+          "ds-badge",
+          "ds-text"
+        ],
+        "ds-badge": [
           "ds-text"
         ],
         "ds-mobile-header": [
@@ -2839,9 +2829,6 @@
           "ds-badge",
           "ds-switch"
         ],
-        "ds-badge": [
-          "ds-text"
-        ],
         "ds-button-unfilled": [
           "ds-loader",
           "ds-icon",
@@ -3492,32 +3479,6 @@
           "getter": false,
           "setter": false
         },
-        {
-          "name": "pressed",
-          "type": "boolean | undefined",
-          "complexType": {
-            "original": "boolean | undefined",
-            "resolved": "boolean | undefined",
-            "references": {}
-          },
-          "mutable": false,
-          "attr": "pressed",
-          "reflectToAttr": false,
-          "docs": "Pressed semantics for a toggle command that reports state elsewhere.",
-          "docsTags": [],
-          "values": [
-            {
-              "type": "boolean"
-            },
-            {
-              "type": "undefined"
-            }
-          ],
-          "optional": false,
-          "required": false,
-          "getter": false,
-          "setter": false
-        },
         {
           "name": "rounded",
           "type": "boolean",
@@ -3777,12 +3738,17 @@
       "dependencies": [
         "ds-loader",
         "ds-icon",
+        "ds-badge",
         "ds-text"
       ],
       "dependencyGraph": {
         "ds-button-filled": [
           "ds-loader",
           "ds-icon",
+          "ds-badge",
+          "ds-text"
+        ],
+        "ds-badge": [
           "ds-text"
         ],
         "ds-bar-title": [
@@ -4187,7 +4153,7 @@
           "mutable": false,
           "attr": "is-active",
           "reflectToAttr": false,
-          "docs": "Active/selected visual state. Always promotes foreground to primary.",
+          "docs": "Owner-controlled visual emphasis inside a composite. This does not add\ntoggle semantics and does not emit dsChange.",
           "docsTags": [
             {
               "name": "default",
@@ -4332,7 +4298,7 @@
           "mutable": false,
           "attr": "pressed",
           "reflectToAttr": false,
-          "docs": "",
+          "docs": "Controlled state for a genuine toggle button. Adds aria-pressed, promotes\nactive styling, and makes activation emit dsChange with the requested state.",
           "docsTags": [],
           "values": [
             {
@@ -4615,9 +4581,7 @@
         "ds-bar-nav",
         "ds-bar-title",
         "ds-bar-workflow",
-        "ds-card-data-viz-bar",
-        "ds-card-data-viz-donut",
-        "ds-card-data-viz-line",
+        "ds-card-data-viz",
         "ds-card-setting",
         "ds-code-block",
         "ds-input",
@@ -4630,7 +4594,7 @@
         "ds-panel-tool-search",
         "ds-panel-tools",
         "ds-select",
-        "ds-select-multi",
+        "ds-shell-app",
         "ds-shell-tools",
         "ds-toast"
       ],
@@ -4659,13 +4623,7 @@
         "ds-bar-workflow": [
           "ds-button-unfilled"
         ],
-        "ds-card-data-viz-bar": [
-          "ds-button-unfilled"
-        ],
-        "ds-card-data-viz-donut": [
-          "ds-button-unfilled"
-        ],
-        "ds-card-data-viz-line": [
+        "ds-card-data-viz": [
           "ds-button-unfilled"
         ],
         "ds-card-setting": [
@@ -4704,7 +4662,7 @@
         "ds-select": [
           "ds-button-unfilled"
         ],
-        "ds-select-multi": [
+        "ds-shell-app": [
           "ds-button-unfilled"
         ],
         "ds-shell-tools": [
@@ -4716,10 +4674,10 @@
       }
     },
     {
-      "filePath": "src/wc/components/CardDataVizBar/CardDataVizBar.tsx",
+      "filePath": "src/wc/components/CardDataViz/CardDataViz.tsx",
       "encapsulation": "scoped",
-      "tag": "ds-card-data-viz-bar",
-      "docs": "Bar-chart data-viz card — dedicated `ds-card-shell-data-viz` chrome with a fill chart\nregion and an optional, content-sized static legend.",
+      "tag": "ds-card-data-viz",
+      "docs": "Standard data-visualization card chrome and composition. The variant owns\nonly the chart/legend relationship; applications continue to own data.",
       "docsTags": [],
       "usage": {},
       "props": [
@@ -4727,20 +4685,20 @@
           "name": "cardWidth",
           "type": "\"lg\" | \"md\" | \"sm\"",
           "complexType": {
-            "original": "CardDataVizBarWidth",
+            "original": "CardDataVizWidth",
             "resolved": "\"lg\" | \"md\" | \"sm\"",
             "references": {
-              "CardDataVizBarWidth": {
+              "CardDataVizWidth": {
                 "location": "local",
-                "path": "/home/runner/work/compomo/compomo/src/wc/components/CardDataVizBar/CardDataVizBar.tsx",
-                "id": "src/wc/components/CardDataVizBar/CardDataVizBar.tsx::CardDataVizBarWidth"
+                "path": "/home/runner/work/compomo/compomo/src/wc/components/CardDataViz/CardDataViz.tsx",
+                "id": "src/wc/components/CardDataViz/CardDataViz.tsx::CardDataVizWidth"
               }
             }
           },
           "mutable": false,
           "attr": "card-width",
           "reflectToAttr": false,
-          "docs": "Card width token — also sets matching min-height.",
+          "docs": "Width token with the matching data-visualization card min-height.",
           "docsTags": [
             {
               "name": "default",
@@ -4807,7 +4765,7 @@
           "mutable": false,
           "attr": "heading",
           "reflectToAttr": false,
-          "docs": "Widget heading shown in the card header.",
+          "docs": "Data-visualization heading shown in the card header.",
           "docsTags": [],
           "values": [
             {
@@ -4818,99 +4776,29 @@
           "required": true,
           "getter": false,
           "setter": false
-        }
-      ],
-      "methods": [],
-      "events": [
+        },
         {
-          "event": "dsFilterClick",
-          "detail": "void",
-          "bubbles": true,
+          "name": "showFilter",
+          "type": "boolean",
           "complexType": {
-            "original": "void",
-            "resolved": "void",
+            "original": "boolean",
+            "resolved": "boolean",
             "references": {}
           },
-          "cancelable": true,
-          "composed": true,
-          "docs": "Emits when the header filter control is activated.",
-          "docsTags": []
-        }
-      ],
-      "listeners": [],
-      "styles": [],
-      "slots": [],
-      "parts": [],
-      "states": [],
-      "dependents": [],
-      "dependencies": [
-        "ds-card-shell-data-viz",
-        "ds-button-unfilled"
-      ],
-      "dependencyGraph": {
-        "ds-card-data-viz-bar": [
-          "ds-card-shell-data-viz",
-          "ds-button-unfilled"
-        ],
-        "ds-card-shell-data-viz": [
-          "ds-text"
-        ],
-        "ds-button-unfilled": [
-          "ds-loader",
-          "ds-icon",
-          "ds-badge",
-          "ds-text"
-        ],
-        "ds-badge": [
-          "ds-text"
-        ]
-      }
-    },
-    {
-      "filePath": "src/wc/components/CardDataVizDonut/CardDataVizDonut.tsx",
-      "encapsulation": "scoped",
-      "tag": "ds-card-data-viz-donut",
-      "docs": "Donut data-viz card — dedicated `ds-card-shell-data-viz` chrome with a fill chart region and\ncontent-sized legend. Hover sync between chart and legend stays here.",
-      "docsTags": [],
-      "usage": {},
-      "props": [
-        {
-          "name": "cardWidth",
-          "type": "\"lg\" | \"md\" | \"sm\"",
-          "complexType": {
-            "original": "CardDataVizDonutWidth",
-            "resolved": "\"lg\" | \"md\" | \"sm\"",
-            "references": {
-              "CardDataVizDonutWidth": {
-                "location": "local",
-                "path": "/home/runner/work/compomo/compomo/src/wc/components/CardDataVizDonut/CardDataVizDonut.tsx",
-                "id": "src/wc/components/CardDataVizDonut/CardDataVizDonut.tsx::CardDataVizDonutWidth"
-              }
-            }
-          },
           "mutable": false,
-          "attr": "card-width",
+          "attr": "show-filter",
           "reflectToAttr": false,
-          "docs": "Card width token — also sets matching min-height.",
+          "docs": "Renders the standard filter action before custom actions.",
           "docsTags": [
             {
               "name": "default",
-              "text": "'md'"
+              "text": "false"
             }
           ],
-          "default": "'md'",
+          "default": "false",
           "values": [
             {
-              "value": "lg",
-              "type": "string"
-            },
-            {
-              "value": "md",
-              "type": "string"
-            },
-            {
-              "value": "sm",
-              "type": "string"
+              "type": "boolean"
             }
           ],
           "optional": false,
@@ -4919,54 +4807,50 @@
           "setter": false
         },
         {
-          "name": "filterLabel",
-          "type": "string",
+          "name": "variant",
+          "type": "\"bar\" | \"custom\" | \"donut\" | \"line\"",
           "complexType": {
-            "original": "string",
-            "resolved": "string",
-            "references": {}
+            "original": "CardDataVizVariant",
+            "resolved": "\"bar\" | \"custom\" | \"donut\" | \"line\"",
+            "references": {
+              "CardDataVizVariant": {
+                "location": "local",
+                "path": "/home/runner/work/compomo/compomo/src/wc/components/CardDataViz/CardDataViz.tsx",
+                "id": "src/wc/components/CardDataViz/CardDataViz.tsx::CardDataVizVariant"
+              }
+            }
           },
           "mutable": false,
-          "attr": "filter-label",
+          "attr": "variant",
           "reflectToAttr": false,
-          "docs": "",
+          "docs": "Chart composition behavior.",
           "docsTags": [
             {
               "name": "default",
-              "text": "'Filter'"
+              "text": "'custom'"
             }
           ],
-          "default": "'Filter'",
+          "default": "'custom'",
           "values": [
             {
+              "value": "bar",
               "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": "Widget heading shown in the card header.",
-          "docsTags": [],
-          "values": [
+            },
+            {
+              "value": "custom",
+              "type": "string"
+            },
+            {
+              "value": "donut",
+              "type": "string"
+            },
             {
+              "value": "line",
               "type": "string"
             }
           ],
           "optional": false,
-          "required": true,
+          "required": false,
           "getter": false,
           "setter": false
         }
@@ -4984,7 +4868,7 @@
           },
           "cancelable": true,
           "composed": true,
-          "docs": "Emits when the header filter control is activated.",
+          "docs": "Emits when the standard header filter control is activated.",
           "docsTags": []
         }
       ],
@@ -4995,17 +4879,14 @@
       "states": [],
       "dependents": [],
       "dependencies": [
-        "ds-card-shell-data-viz",
+        "ds-text",
         "ds-button-unfilled"
       ],
       "dependencyGraph": {
-        "ds-card-data-viz-donut": [
-          "ds-card-shell-data-viz",
+        "ds-card-data-viz": [
+          "ds-text",
           "ds-button-unfilled"
         ],
-        "ds-card-shell-data-viz": [
-          "ds-text"
-        ],
         "ds-button-unfilled": [
           "ds-loader",
           "ds-icon",
@@ -5018,49 +4899,34 @@
       }
     },
     {
-      "filePath": "src/wc/components/CardDataVizLine/CardDataVizLine.tsx",
+      "filePath": "src/wc/components/CardOverview/CardOverview.tsx",
       "encapsulation": "scoped",
-      "tag": "ds-card-data-viz-line",
-      "docs": "Line-chart data-viz card — dedicated `ds-card-shell-data-viz` chrome with a fill chart\nregion and a content-sized, static legend.",
+      "tag": "ds-card-overview",
+      "docs": "",
       "docsTags": [],
       "usage": {},
       "props": [
         {
-          "name": "cardWidth",
-          "type": "\"lg\" | \"md\" | \"sm\"",
+          "name": "comparisonLabel",
+          "type": "string",
           "complexType": {
-            "original": "CardDataVizLineWidth",
-            "resolved": "\"lg\" | \"md\" | \"sm\"",
-            "references": {
-              "CardDataVizLineWidth": {
-                "location": "local",
-                "path": "/home/runner/work/compomo/compomo/src/wc/components/CardDataVizLine/CardDataVizLine.tsx",
-                "id": "src/wc/components/CardDataVizLine/CardDataVizLine.tsx::CardDataVizLineWidth"
-              }
-            }
+            "original": "string",
+            "resolved": "string",
+            "references": {}
           },
           "mutable": false,
-          "attr": "card-width",
+          "attr": "comparison-label",
           "reflectToAttr": false,
-          "docs": "Card width token — also sets matching min-height.",
+          "docs": "Comparison caption, for example `vs Previous period`.",
           "docsTags": [
             {
               "name": "default",
-              "text": "'md'"
+              "text": "''"
             }
           ],
-          "default": "'md'",
+          "default": "''",
           "values": [
             {
-              "value": "lg",
-              "type": "string"
-            },
-            {
-              "value": "md",
-              "type": "string"
-            },
-            {
-              "value": "sm",
               "type": "string"
             }
           ],
@@ -5070,157 +4936,21 @@
           "setter": false
         },
         {
-          "name": "filterLabel",
-          "type": "string",
+          "name": "isLoading",
+          "type": "boolean",
           "complexType": {
-            "original": "string",
-            "resolved": "string",
+            "original": "boolean",
+            "resolved": "boolean",
             "references": {}
           },
           "mutable": false,
-          "attr": "filter-label",
+          "attr": "is-loading",
           "reflectToAttr": false,
-          "docs": "",
+          "docs": "Replace the score and metrics with skeletons while data resolves.",
           "docsTags": [
             {
               "name": "default",
-              "text": "'Filter'"
-            }
-          ],
-          "default": "'Filter'",
-          "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": "Widget heading shown in the card header.",
-          "docsTags": [],
-          "values": [
-            {
-              "type": "string"
-            }
-          ],
-          "optional": false,
-          "required": true,
-          "getter": false,
-          "setter": false
-        }
-      ],
-      "methods": [],
-      "events": [
-        {
-          "event": "dsFilterClick",
-          "detail": "void",
-          "bubbles": true,
-          "complexType": {
-            "original": "void",
-            "resolved": "void",
-            "references": {}
-          },
-          "cancelable": true,
-          "composed": true,
-          "docs": "Emits when the header filter control is activated.",
-          "docsTags": []
-        }
-      ],
-      "listeners": [],
-      "styles": [],
-      "slots": [],
-      "parts": [],
-      "states": [],
-      "dependents": [],
-      "dependencies": [
-        "ds-card-shell-data-viz",
-        "ds-button-unfilled"
-      ],
-      "dependencyGraph": {
-        "ds-card-data-viz-line": [
-          "ds-card-shell-data-viz",
-          "ds-button-unfilled"
-        ],
-        "ds-card-shell-data-viz": [
-          "ds-text"
-        ],
-        "ds-button-unfilled": [
-          "ds-loader",
-          "ds-icon",
-          "ds-badge",
-          "ds-text"
-        ],
-        "ds-badge": [
-          "ds-text"
-        ]
-      }
-    },
-    {
-      "filePath": "src/wc/components/CardOverview/CardOverview.tsx",
-      "encapsulation": "scoped",
-      "tag": "ds-card-overview",
-      "docs": "",
-      "docsTags": [],
-      "usage": {},
-      "props": [
-        {
-          "name": "comparisonLabel",
-          "type": "string",
-          "complexType": {
-            "original": "string",
-            "resolved": "string",
-            "references": {}
-          },
-          "mutable": false,
-          "attr": "comparison-label",
-          "reflectToAttr": false,
-          "docs": "Comparison caption, for example `vs Previous period`.",
-          "docsTags": [
-            {
-              "name": "default",
-              "text": "''"
-            }
-          ],
-          "default": "''",
-          "values": [
-            {
-              "type": "string"
-            }
-          ],
-          "optional": false,
-          "required": false,
-          "getter": false,
-          "setter": false
-        },
-        {
-          "name": "isLoading",
-          "type": "boolean",
-          "complexType": {
-            "original": "boolean",
-            "resolved": "boolean",
-            "references": {}
-          },
-          "mutable": false,
-          "attr": "is-loading",
-          "reflectToAttr": false,
-          "docs": "Replace the score and metrics with skeletons while data resolves.",
-          "docsTags": [
-            {
-              "name": "default",
-              "text": "false"
+              "text": "false"
             }
           ],
           "default": "false",
@@ -5455,6 +5185,35 @@
           "getter": false,
           "setter": false
         },
+        {
+          "name": "scrollCollapseProgress",
+          "type": "number",
+          "complexType": {
+            "original": "number",
+            "resolved": "number",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "scroll-collapse-progress",
+          "reflectToAttr": false,
+          "docs": "Page-controlled visual collapse from the full card (`0`) toward its 48px\ncompact handoff height (`1`). The component preserves its expanded flow\nheight, keeps elevation on the shrinking surface, and clips translated\ncontent internally. The page still owns sticky positioning and the final\nswap to `variant=\"compact\"`.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "0"
+            }
+          ],
+          "default": "0",
+          "values": [
+            {
+              "type": "number"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
         {
           "name": "variant",
           "type": "\"compact\" | \"default\"",
@@ -5802,55 +5561,40 @@
         "ds-button-filled": [
           "ds-loader",
           "ds-icon",
+          "ds-badge",
           "ds-text"
         ]
       }
     },
     {
-      "filePath": "src/wc/components/CardShellDataViz/CardShellDataViz.tsx",
+      "filePath": "src/wc/components/ChartBar/ChartBar.tsx",
       "encapsulation": "scoped",
-      "tag": "ds-card-shell-data-viz",
-      "docs": "Dedicated shell chrome for data-visualization cards. Chart-specific layout,\nlegends, hover synchronization, and empty states belong to composing cards.",
+      "tag": "ds-chart-bar",
+      "docs": "",
       "docsTags": [],
       "usage": {},
       "props": [
         {
-          "name": "cardWidth",
-          "type": "\"lg\" | \"md\" | \"sm\"",
+          "name": "categories",
+          "type": "string[]",
           "complexType": {
-            "original": "CardShellDataVizWidth",
-            "resolved": "\"lg\" | \"md\" | \"sm\"",
-            "references": {
-              "CardShellDataVizWidth": {
-                "location": "local",
-                "path": "/home/runner/work/compomo/compomo/src/wc/components/CardShellDataViz/CardShellDataViz.tsx",
-                "id": "src/wc/components/CardShellDataViz/CardShellDataViz.tsx::CardShellDataVizWidth"
-              }
-            }
+            "original": "string[]",
+            "resolved": "string[]",
+            "references": {}
           },
           "mutable": false,
-          "attr": "card-width",
           "reflectToAttr": false,
-          "docs": "Width token with the matching data-visualization shell min-height.",
+          "docs": "X-axis labels for stacked and percentage variants. Set as a JS property.",
           "docsTags": [
             {
               "name": "default",
-              "text": "'md'"
+              "text": "[]"
             }
           ],
-          "default": "'md'",
+          "default": "[]",
           "values": [
             {
-              "value": "lg",
-              "type": "string"
-            },
-            {
-              "value": "md",
-              "type": "string"
-            },
-            {
-              "value": "sm",
-              "type": "string"
+              "type": "string[]"
             }
           ],
           "optional": false,
@@ -5858,68 +5602,6 @@
           "getter": false,
           "setter": false
         },
-        {
-          "name": "heading",
-          "type": "string",
-          "complexType": {
-            "original": "string",
-            "resolved": "string",
-            "references": {}
-          },
-          "mutable": false,
-          "attr": "heading",
-          "reflectToAttr": false,
-          "docs": "Data-visualization heading shown in the shell header.",
-          "docsTags": [],
-          "values": [
-            {
-              "type": "string"
-            }
-          ],
-          "optional": false,
-          "required": true,
-          "getter": false,
-          "setter": false
-        }
-      ],
-      "methods": [],
-      "events": [],
-      "listeners": [],
-      "styles": [],
-      "slots": [],
-      "parts": [],
-      "states": [],
-      "dependents": [
-        "ds-card-data-viz-bar",
-        "ds-card-data-viz-donut",
-        "ds-card-data-viz-line"
-      ],
-      "dependencies": [
-        "ds-text"
-      ],
-      "dependencyGraph": {
-        "ds-card-shell-data-viz": [
-          "ds-text"
-        ],
-        "ds-card-data-viz-bar": [
-          "ds-card-shell-data-viz"
-        ],
-        "ds-card-data-viz-donut": [
-          "ds-card-shell-data-viz"
-        ],
-        "ds-card-data-viz-line": [
-          "ds-card-shell-data-viz"
-        ]
-      }
-    },
-    {
-      "filePath": "src/wc/components/ChartBar/ChartBar.tsx",
-      "encapsulation": "scoped",
-      "tag": "ds-chart-bar",
-      "docs": "",
-      "docsTags": [],
-      "usage": {},
-      "props": [
         {
           "name": "data",
           "type": "ChartDatum[]",
@@ -5985,129 +5667,23 @@
           "setter": false
         },
         {
-          "name": "width",
-          "type": "number",
+          "name": "series",
+          "type": "ChartSeries[]",
           "complexType": {
-            "original": "number",
-            "resolved": "number",
-            "references": {}
-          },
-          "mutable": false,
-          "attr": "width",
-          "reflectToAttr": false,
-          "docs": "Standalone intrinsic width. Container constraints reflow the plot at rendered pixel size.",
-          "docsTags": [
-            {
-              "name": "default",
-              "text": "480"
-            }
-          ],
-          "default": "480",
-          "values": [
-            {
-              "type": "number"
-            }
-          ],
-          "optional": false,
-          "required": false,
-          "getter": false,
-          "setter": false
-        }
-      ],
-      "methods": [],
-      "events": [],
-      "listeners": [],
-      "styles": [],
-      "slots": [],
-      "parts": [],
-      "states": [],
-      "dependents": [],
-      "dependencies": [],
-      "dependencyGraph": {}
-    },
-    {
-      "filePath": "src/wc/components/ChartBarStacked/ChartBarStacked.tsx",
-      "encapsulation": "scoped",
-      "tag": "ds-chart-bar-stacked",
-      "docs": "",
-      "docsTags": [],
-      "usage": {},
-      "props": [
-        {
-          "name": "categories",
-          "type": "string[]",
-          "complexType": {
-            "original": "string[]",
-            "resolved": "string[]",
-            "references": {}
-          },
-          "mutable": false,
-          "reflectToAttr": false,
-          "docs": "X-axis labels — must match each series' `data` length. Set as a JS property.",
-          "docsTags": [
-            {
-              "name": "default",
-              "text": "[]"
-            }
-          ],
-          "default": "[]",
-          "values": [
-            {
-              "type": "string[]"
-            }
-          ],
-          "optional": false,
-          "required": false,
-          "getter": false,
-          "setter": false
-        },
-        {
-          "name": "height",
-          "type": "number",
-          "complexType": {
-            "original": "number",
-            "resolved": "number",
-            "references": {}
-          },
-          "mutable": false,
-          "attr": "height",
-          "reflectToAttr": false,
-          "docs": "Standalone intrinsic height. Container constraints reflow the plot at rendered pixel size.",
-          "docsTags": [
-            {
-              "name": "default",
-              "text": "240"
-            }
-          ],
-          "default": "240",
-          "values": [
-            {
-              "type": "number"
-            }
-          ],
-          "optional": false,
-          "required": false,
-          "getter": false,
-          "setter": false
-        },
-        {
-          "name": "series",
-          "type": "ChartSeries[]",
-          "complexType": {
-            "original": "ChartSeries[]",
-            "resolved": "ChartSeries[]",
-            "references": {
-              "ChartSeries": {
-                "location": "import",
-                "path": "../../utils/chart-types",
-                "id": "src/wc/utils/chart-types.ts::ChartSeries",
-                "referenceLocation": "ChartSeries"
-              }
-            }
+            "original": "ChartSeries[]",
+            "resolved": "ChartSeries[]",
+            "references": {
+              "ChartSeries": {
+                "location": "import",
+                "path": "../../utils/chart-types",
+                "id": "src/wc/utils/chart-types.ts::ChartSeries",
+                "referenceLocation": "ChartSeries"
+              }
+            }
           },
           "mutable": false,
           "reflectToAttr": false,
-          "docs": "Ordered stack series. Set as a JS property (not an HTML attribute).",
+          "docs": "Ordered stack series for stacked and percentage variants. Set as a JS property.",
           "docsTags": [
             {
               "name": "default",
@@ -6127,34 +5703,38 @@
         },
         {
           "name": "variant",
-          "type": "\"percentage\" | \"stacked\"",
+          "type": "\"percentage\" | \"single\" | \"stacked\"",
           "complexType": {
-            "original": "ChartBarStackedVariant",
-            "resolved": "\"percentage\" | \"stacked\"",
+            "original": "ChartBarVariant",
+            "resolved": "\"percentage\" | \"single\" | \"stacked\"",
             "references": {
-              "ChartBarStackedVariant": {
+              "ChartBarVariant": {
                 "location": "local",
-                "path": "/home/runner/work/compomo/compomo/src/wc/components/ChartBarStacked/ChartBarStacked.tsx",
-                "id": "src/wc/components/ChartBarStacked/ChartBarStacked.tsx::ChartBarStackedVariant"
+                "path": "/home/runner/work/compomo/compomo/src/wc/components/ChartBar/ChartBar.tsx",
+                "id": "src/wc/components/ChartBar/ChartBar.tsx::ChartBarVariant"
               }
             }
           },
           "mutable": false,
           "attr": "variant",
           "reflectToAttr": false,
-          "docs": "",
+          "docs": "Rendering model. Single uses `data`; stacked and percentage use `series` and `categories`.",
           "docsTags": [
             {
               "name": "default",
-              "text": "'stacked'"
+              "text": "'single'"
             }
           ],
-          "default": "'stacked'",
+          "default": "'single'",
           "values": [
             {
               "value": "percentage",
               "type": "string"
             },
+            {
+              "value": "single",
+              "type": "string"
+            },
             {
               "value": "stacked",
               "type": "string"
@@ -7414,7 +6994,7 @@
       "parts": [],
       "states": [],
       "dependents": [
-        "ds-select-multi"
+        "ds-select"
       ],
       "dependencies": [
         "ds-text"
@@ -7423,7 +7003,7 @@
         "ds-checkbox": [
           "ds-text"
         ],
-        "ds-select-multi": [
+        "ds-select": [
           "ds-checkbox"
         ]
       }
@@ -8705,8 +8285,7 @@
       "parts": [],
       "states": [],
       "dependents": [
-        "ds-select",
-        "ds-select-multi"
+        "ds-select"
       ],
       "dependencies": [
         "ds-icon",
@@ -8719,9 +8298,6 @@
         ],
         "ds-select": [
           "ds-empty-state"
-        ],
-        "ds-select-multi": [
-          "ds-empty-state"
         ]
       }
     },
@@ -9237,7 +8813,6 @@
         "ds-panel-nav",
         "ds-panel-tool-search",
         "ds-select",
-        "ds-select-multi",
         "ds-tab-group",
         "ds-tag"
       ],
@@ -9294,9 +8869,6 @@
         "ds-select": [
           "ds-icon"
         ],
-        "ds-select-multi": [
-          "ds-icon"
-        ],
         "ds-tab-group": [
           "ds-icon"
         ],
@@ -10469,8 +10041,7 @@
         "ds-button-filled",
         "ds-button-unfilled",
         "ds-conversation-list-item",
-        "ds-select",
-        "ds-select-multi"
+        "ds-select"
       ],
       "dependencies": [],
       "dependencyGraph": {
@@ -10491,9 +10062,6 @@
         ],
         "ds-select": [
           "ds-loader"
-        ],
-        "ds-select-multi": [
-          "ds-loader"
         ]
       }
     },
@@ -11194,27 +10762,6 @@
           "docs": "",
           "docsTags": []
         },
-        {
-          "event": "dsGradientSelect",
-          "detail": "\"cool\" | \"fresh\" | \"neutral\" | \"none\" | \"warm\"",
-          "bubbles": true,
-          "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"
-              }
-            }
-          },
-          "cancelable": true,
-          "composed": true,
-          "docs": "Emitted when a `gradient-picker` section swatch is chosen.",
-          "docsTags": []
-        },
         {
           "event": "dsSelect",
           "detail": "MenuItemData",
@@ -12046,6 +11593,7 @@
         "ds-button-filled": [
           "ds-loader",
           "ds-icon",
+          "ds-badge",
           "ds-text"
         ]
       }
@@ -12766,7 +12314,9 @@
       "slots": [],
       "parts": [],
       "states": [],
-      "dependents": [],
+      "dependents": [
+        "ds-shell-app"
+      ],
       "dependencies": [
         "ds-icon",
         "ds-badge"
@@ -12778,6 +12328,9 @@
         ],
         "ds-badge": [
           "ds-text"
+        ],
+        "ds-shell-app": [
+          "ds-mobile-bar-nav"
         ]
       }
     },
@@ -12923,35 +12476,6 @@
           "getter": false,
           "setter": false
         },
-        {
-          "name": "sectionsJson",
-          "type": "string",
-          "complexType": {
-            "original": "string",
-            "resolved": "string",
-            "references": {}
-          },
-          "mutable": false,
-          "attr": "sections-json",
-          "reflectToAttr": false,
-          "docs": "JSON fallback for `sections`.",
-          "docsTags": [
-            {
-              "name": "default",
-              "text": "''"
-            }
-          ],
-          "default": "''",
-          "values": [
-            {
-              "type": "string"
-            }
-          ],
-          "optional": false,
-          "required": false,
-          "getter": false,
-          "setter": false
-        },
         {
           "name": "subsections",
           "type": "TabItem[]",
@@ -13016,35 +12540,6 @@
           "getter": false,
           "setter": false
         },
-        {
-          "name": "subsectionsJson",
-          "type": "string",
-          "complexType": {
-            "original": "string",
-            "resolved": "string",
-            "references": {}
-          },
-          "mutable": false,
-          "attr": "subsections-json",
-          "reflectToAttr": false,
-          "docs": "JSON fallback for `subsections`.",
-          "docsTags": [
-            {
-              "name": "default",
-              "text": "''"
-            }
-          ],
-          "default": "''",
-          "values": [
-            {
-              "type": "string"
-            }
-          ],
-          "optional": false,
-          "required": false,
-          "getter": false,
-          "setter": false
-        },
         {
           "name": "subvalue",
           "type": "string",
@@ -13183,6 +12678,7 @@
       "states": [],
       "dependents": [
         "ds-bar-workflow",
+        "ds-shell-app",
         "ds-shell-tools"
       ],
       "dependencies": [
@@ -13210,6 +12706,9 @@
         "ds-bar-workflow": [
           "ds-mobile-header"
         ],
+        "ds-shell-app": [
+          "ds-mobile-header"
+        ],
         "ds-shell-tools": [
           "ds-mobile-header"
         ]
@@ -13287,35 +12786,6 @@
           "getter": false,
           "setter": false
         },
-        {
-          "name": "sectionsJson",
-          "type": "string",
-          "complexType": {
-            "original": "string",
-            "resolved": "string",
-            "references": {}
-          },
-          "mutable": false,
-          "attr": "sections-json",
-          "reflectToAttr": false,
-          "docs": "JSON fallback for `sections`.",
-          "docsTags": [
-            {
-              "name": "default",
-              "text": "''"
-            }
-          ],
-          "default": "''",
-          "values": [
-            {
-              "type": "string"
-            }
-          ],
-          "optional": false,
-          "required": false,
-          "getter": false,
-          "setter": false
-        },
         {
           "name": "value",
           "type": "string",
@@ -13780,7 +13250,9 @@
       "slots": [],
       "parts": [],
       "states": [],
-      "dependents": [],
+      "dependents": [
+        "ds-shell-app"
+      ],
       "dependencies": [
         "ds-icon",
         "ds-text",
@@ -13814,6 +13286,9 @@
           "ds-icon",
           "ds-text",
           "ds-badge"
+        ],
+        "ds-shell-app": [
+          "ds-mobile-sheet-nav"
         ]
       }
     },
@@ -14795,7 +14270,9 @@
       "slots": [],
       "parts": [],
       "states": [],
-      "dependents": [],
+      "dependents": [
+        "ds-shell-app"
+      ],
       "dependencies": [
         "ds-tooltip",
         "ds-button-unfilled",
@@ -14822,6 +14299,9 @@
         ],
         "ds-badge": [
           "ds-text"
+        ],
+        "ds-shell-app": [
+          "ds-panel-nav"
         ]
       }
     },
@@ -15946,10 +15426,10 @@
       "props": [
         {
           "name": "activeTool",
-          "type": "\"\" | \"activity\" | \"agents\" | \"help\" | \"messages\" | \"search\" | \"stacks\"",
+          "type": "string",
           "complexType": {
             "original": "PanelToolsToolId | ''",
-            "resolved": "\"\" | \"activity\" | \"agents\" | \"help\" | \"messages\" | \"search\" | \"stacks\"",
+            "resolved": "string",
             "references": {
               "PanelToolsToolId": {
                 "location": "import",
@@ -15972,30 +15452,6 @@
           "default": "''",
           "values": [
             {
-              "type": "\"\""
-            },
-            {
-              "value": "activity",
-              "type": "string"
-            },
-            {
-              "value": "agents",
-              "type": "string"
-            },
-            {
-              "value": "help",
-              "type": "string"
-            },
-            {
-              "value": "messages",
-              "type": "string"
-            },
-            {
-              "value": "search",
-              "type": "string"
-            },
-            {
-              "value": "stacks",
               "type": "string"
             }
           ],
@@ -16040,10 +15496,10 @@
         },
         {
           "name": "headers",
-          "type": "\"activity\" | \"agents\" | \"help\" | \"messages\" | \"search\" | \"stacks\" | PanelToolsHeaderConfig",
+          "type": "PanelToolsHeaderConfig | string",
           "complexType": {
             "original": "PanelToolsHeaders",
-            "resolved": "\"activity\" | \"agents\" | \"help\" | \"messages\" | \"search\" | \"stacks\" | PanelToolsHeaderConfig",
+            "resolved": "PanelToolsHeaderConfig | string",
             "references": {
               "PanelToolsHeaders": {
                 "location": "import",
@@ -16064,59 +15520,9 @@
           ],
           "default": "{}",
           "values": [
-            {
-              "value": "activity",
-              "type": "string"
-            },
-            {
-              "value": "agents",
-              "type": "string"
-            },
-            {
-              "value": "help",
-              "type": "string"
-            },
-            {
-              "value": "messages",
-              "type": "string"
-            },
-            {
-              "value": "search",
-              "type": "string"
-            },
-            {
-              "value": "stacks",
-              "type": "string"
-            },
             {
               "type": "PanelToolsHeaderConfig"
-            }
-          ],
-          "optional": false,
-          "required": false,
-          "getter": false,
-          "setter": false
-        },
-        {
-          "name": "headersJson",
-          "type": "string",
-          "complexType": {
-            "original": "string",
-            "resolved": "string",
-            "references": {}
-          },
-          "mutable": false,
-          "attr": "headers-json",
-          "reflectToAttr": false,
-          "docs": "JSON fallback for `headers`. The `headers` property takes precedence when non-empty.",
-          "docsTags": [
-            {
-              "name": "default",
-              "text": "''"
-            }
-          ],
-          "default": "''",
-          "values": [
+            },
             {
               "type": "string"
             }
@@ -16161,35 +15567,6 @@
           "getter": false,
           "setter": false
         },
-        {
-          "name": "itemsJson",
-          "type": "string",
-          "complexType": {
-            "original": "string",
-            "resolved": "string",
-            "references": {}
-          },
-          "mutable": false,
-          "attr": "items-json",
-          "reflectToAttr": false,
-          "docs": "JSON fallback for `items` — 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": "open",
           "type": "boolean",
@@ -16353,7 +15730,7 @@
             "parameters": [
               {
                 "name": "id",
-                "type": "\"activity\" | \"search\" | \"agents\" | \"messages\" | \"stacks\" | \"help\"",
+                "type": "string",
                 "docs": ""
               }
             ],
@@ -16375,7 +15752,7 @@
           "parameters": [
             {
               "name": "id",
-              "type": "\"activity\" | \"search\" | \"agents\" | \"messages\" | \"stacks\" | \"help\"",
+              "type": "string",
               "docs": ""
             }
           ],
@@ -16488,11 +15865,11 @@
         },
         {
           "event": "dsHeaderAction",
-          "detail": "{ tool: PanelToolsToolId; id: string; }",
+          "detail": "{ tool: string; id: string; }",
           "bubbles": true,
           "complexType": {
             "original": "{\n    tool: PanelToolsToolId;\n    id: string;\n  }",
-            "resolved": "{ tool: PanelToolsToolId; id: string; }",
+            "resolved": "{ tool: string; id: string; }",
             "references": {
               "PanelToolsToolId": {
                 "location": "import",
@@ -16509,11 +15886,11 @@
         },
         {
           "event": "dsHeaderBack",
-          "detail": "{ tool: PanelToolsToolId; }",
+          "detail": "{ tool: string; }",
           "bubbles": true,
           "complexType": {
             "original": "{\n    tool: PanelToolsToolId;\n  }",
-            "resolved": "{ tool: PanelToolsToolId; }",
+            "resolved": "{ tool: string; }",
             "references": {
               "PanelToolsToolId": {
                 "location": "import",
@@ -16544,11 +15921,11 @@
         },
         {
           "event": "dsToolChange",
-          "detail": "{ id: PanelToolsToolId; selected: boolean; }",
+          "detail": "{ id: string; selected: boolean; }",
           "bubbles": true,
           "complexType": {
             "original": "{\n    id: PanelToolsToolId;\n    selected: boolean;\n  }",
-            "resolved": "{ id: PanelToolsToolId; selected: boolean; }",
+            "resolved": "{ id: string; selected: boolean; }",
             "references": {
               "PanelToolsToolId": {
                 "location": "import",
@@ -17656,6 +17033,35 @@
           "getter": false,
           "setter": false
         },
+        {
+          "name": "multiple",
+          "type": "boolean",
+          "complexType": {
+            "original": "boolean",
+            "resolved": "boolean",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "multiple",
+          "reflectToAttr": true,
+          "docs": "Enable independent multi-value selection while keeping the popup open.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "false"
+            }
+          ],
+          "default": "false",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
         {
           "name": "name",
           "type": "string | undefined",
@@ -17953,6 +17359,35 @@
           "getter": false,
           "setter": false
         },
+        {
+          "name": "selectedLabel",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "selected-label",
+          "reflectToAttr": false,
+          "docs": "Localized noun displayed after the selected count in multiple mode.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "'selected'"
+            }
+          ],
+          "default": "'selected'",
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
         {
           "name": "size",
           "type": "\"lg\" | \"md\" | \"sm\" | \"xs\"",
@@ -18003,16 +17438,22 @@
         },
         {
           "name": "value",
-          "type": "string",
+          "type": "string | string[]",
           "complexType": {
-            "original": "string",
-            "resolved": "string",
-            "references": {}
+            "original": "SelectValue",
+            "resolved": "string | string[]",
+            "references": {
+              "SelectValue": {
+                "location": "local",
+                "path": "/home/runner/work/compomo/compomo/src/wc/components/Select/Select.tsx",
+                "id": "src/wc/components/Select/Select.tsx::SelectValue"
+              }
+            }
           },
           "mutable": true,
           "attr": "value",
           "reflectToAttr": false,
-          "docs": "Selected string value. Unknown values render the placeholder and are not submitted.",
+          "docs": "Selected scalar or array value according to `multiple`.",
           "docsTags": [
             {
               "name": "default",
@@ -18023,6 +17464,9 @@
           "values": [
             {
               "type": "string"
+            },
+            {
+              "type": "string[]"
             }
           ],
           "optional": false,
@@ -18098,16 +17542,22 @@
       "events": [
         {
           "event": "dsChange",
-          "detail": "string",
+          "detail": "string | string[]",
           "bubbles": true,
           "complexType": {
-            "original": "string",
-            "resolved": "string",
-            "references": {}
+            "original": "SelectValue",
+            "resolved": "string | string[]",
+            "references": {
+              "SelectValue": {
+                "location": "local",
+                "path": "/home/runner/work/compomo/compomo/src/wc/components/Select/Select.tsx",
+                "id": "src/wc/components/Select/Select.tsx::SelectValue"
+              }
+            }
           },
           "cancelable": true,
           "composed": true,
-          "docs": "Emitted after user selection or clearing with the next scalar value.",
+          "docs": "Emitted after selection or clearing with the next scalar or array value.",
           "docsTags": []
         },
         {
@@ -18146,6 +17596,7 @@
       "states": [],
       "dependents": [],
       "dependencies": [
+        "ds-checkbox",
         "ds-icon",
         "ds-loader",
         "ds-text",
@@ -18155,6 +17606,7 @@
       ],
       "dependencyGraph": {
         "ds-select": [
+          "ds-checkbox",
           "ds-icon",
           "ds-loader",
           "ds-text",
@@ -18162,6 +17614,9 @@
           "ds-tooltip",
           "ds-button-unfilled"
         ],
+        "ds-checkbox": [
+          "ds-text"
+        ],
         "ds-empty-state": [
           "ds-icon",
           "ds-text"
@@ -18181,35 +17636,47 @@
       }
     },
     {
-      "filePath": "src/wc/components/SelectMulti/SelectMulti.tsx",
+      "filePath": "src/wc/components/ShellApp/ShellApp.tsx",
       "encapsulation": "scoped",
-      "tag": "ds-select-multi",
+      "tag": "ds-shell-app",
       "docs": "",
       "docsTags": [],
       "usage": {},
       "props": [
         {
-          "name": "activeFill",
-          "type": "boolean",
+          "name": "composition",
+          "type": "\"managed\" | \"slotted\"",
           "complexType": {
-            "original": "boolean",
-            "resolved": "boolean",
-            "references": {}
+            "original": "ShellAppComposition",
+            "resolved": "\"managed\" | \"slotted\"",
+            "references": {
+              "ShellAppComposition": {
+                "location": "import",
+                "path": "./shell-app-types",
+                "id": "src/wc/components/ShellApp/shell-app-types.ts::ShellAppComposition",
+                "referenceLocation": "ShellAppComposition"
+              }
+            }
           },
           "mutable": false,
-          "attr": "active-fill",
-          "reflectToAttr": false,
-          "docs": "Show the selected interaction fill when at least one value exists.",
+          "attr": "composition",
+          "reflectToAttr": true,
+          "docs": "Managed renders the complete responsive chrome; slotted exposes the advanced composition.",
           "docsTags": [
             {
               "name": "default",
-              "text": "true"
+              "text": "'managed'"
             }
           ],
-          "default": "true",
+          "default": "'managed'",
           "values": [
             {
-              "type": "boolean"
+              "value": "managed",
+              "type": "string"
+            },
+            {
+              "value": "slotted",
+              "type": "string"
             }
           ],
           "optional": false,
@@ -18218,27 +17685,51 @@
           "setter": false
         },
         {
-          "name": "allowClear",
-          "type": "boolean",
+          "name": "gradientPreset",
+          "type": "\"cool\" | \"fresh\" | \"neutral\" | \"none\" | \"warm\"",
           "complexType": {
-            "original": "boolean",
-            "resolved": "boolean",
-            "references": {}
+            "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": "allow-clear",
-          "reflectToAttr": false,
-          "docs": "Show the clear-all footer action when values exist.",
+          "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": "true"
+              "text": "'neutral'"
             }
           ],
-          "default": "true",
+          "default": "'neutral'",
           "values": [
             {
-              "type": "boolean"
+              "value": "cool",
+              "type": "string"
+            },
+            {
+              "value": "fresh",
+              "type": "string"
+            },
+            {
+              "value": "neutral",
+              "type": "string"
+            },
+            {
+              "value": "none",
+              "type": "string"
+            },
+            {
+              "value": "warm",
+              "type": "string"
             }
           ],
           "optional": false,
@@ -18247,143 +17738,51 @@
           "setter": false
         },
         {
-          "name": "ariaDescribedby",
-          "type": "string | undefined",
+          "name": "mobileDestination",
+          "type": "\"agents\" | \"area\" | \"help\" | \"inbox\" | \"search\"",
           "complexType": {
-            "original": "string | undefined",
-            "resolved": "string | undefined",
-            "references": {}
+            "original": "MobileDestination",
+            "resolved": "\"agents\" | \"area\" | \"help\" | \"inbox\" | \"search\"",
+            "references": {
+              "MobileDestination": {
+                "location": "import",
+                "path": "../../shell/shell-responsive",
+                "id": "src/wc/shell/shell-responsive.ts::MobileDestination",
+                "referenceLocation": "MobileDestination"
+              }
+            }
           },
           "mutable": false,
-          "attr": "aria-describedby",
+          "attr": "mobile-destination",
           "reflectToAttr": false,
-          "docs": "Additional IDs that describe the combobox.",
-          "docsTags": [],
+          "docs": "Controlled mobile surface shown above the persistent bottom bar.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "'area'"
+            }
+          ],
+          "default": "'area'",
           "values": [
             {
+              "value": "agents",
               "type": "string"
             },
             {
-              "type": "undefined"
-            }
-          ],
-          "optional": false,
-          "required": false,
-          "getter": false,
-          "setter": false
-        },
-        {
-          "name": "ariaLabel",
-          "type": "null | string",
-          "complexType": {
-            "original": "string | null",
-            "resolved": "null | string",
-            "references": {}
-          },
-          "mutable": false,
-          "attr": "aria-label",
-          "reflectToAttr": false,
-          "docs": "Direct accessible name when no external label is available.",
-          "docsTags": [
-            {
-              "name": "default",
-              "text": "null"
-            }
-          ],
-          "default": "null",
-          "values": [
-            {
-              "type": "null"
-            },
-            {
-              "type": "string"
-            }
-          ],
-          "optional": false,
-          "required": false,
-          "getter": false,
-          "setter": false
-        },
-        {
-          "name": "ariaLabelledby",
-          "type": "string | undefined",
-          "complexType": {
-            "original": "string | undefined",
-            "resolved": "string | undefined",
-            "references": {}
-          },
-          "mutable": false,
-          "attr": "aria-labelledby",
-          "reflectToAttr": false,
-          "docs": "IDs of elements that label the combobox.",
-          "docsTags": [],
-          "values": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "undefined"
-            }
-          ],
-          "optional": false,
-          "required": false,
-          "getter": false,
-          "setter": false
-        },
-        {
-          "name": "background",
-          "type": "\"always-dark\" | \"bold\" | \"faint\" | \"inverted\" | \"media\" | \"medium\" | \"strong\" | \"translucent\" | undefined",
-          "complexType": {
-            "original": "SelectMultiBackground | undefined",
-            "resolved": "\"always-dark\" | \"bold\" | \"faint\" | \"inverted\" | \"media\" | \"medium\" | \"strong\" | \"translucent\" | undefined",
-            "references": {
-              "SelectMultiBackground": {
-                "location": "local",
-                "path": "/home/runner/work/compomo/compomo/src/wc/components/SelectMulti/SelectMulti.tsx",
-                "id": "src/wc/components/SelectMulti/SelectMulti.tsx::SelectMultiBackground"
-              }
-            }
-          },
-          "mutable": false,
-          "attr": "background",
-          "reflectToAttr": false,
-          "docs": "Actual parent surface context; omit 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",
+              "value": "area",
               "type": "string"
             },
             {
-              "value": "medium",
+              "value": "help",
               "type": "string"
             },
             {
-              "value": "strong",
+              "value": "inbox",
               "type": "string"
             },
             {
-              "value": "translucent",
+              "value": "search",
               "type": "string"
-            },
-            {
-              "type": "undefined"
             }
           ],
           "optional": false,
@@ -18392,27 +17791,27 @@
           "setter": false
         },
         {
-          "name": "clearLabel",
-          "type": "string",
+          "name": "mobileSheetNavOpen",
+          "type": "boolean",
           "complexType": {
-            "original": "string",
-            "resolved": "string",
+            "original": "boolean",
+            "resolved": "boolean",
             "references": {}
           },
           "mutable": false,
-          "attr": "clear-label",
+          "attr": "mobile-sheet-nav-open",
           "reflectToAttr": false,
-          "docs": "Localized clear-all action label.",
+          "docs": "Controlled full-stage Mobile Sheet Nav state.",
           "docsTags": [
             {
               "name": "default",
-              "text": "'Clear'"
+              "text": "false"
             }
           ],
-          "default": "'Clear'",
+          "default": "false",
           "values": [
             {
-              "type": "string"
+              "type": "boolean"
             }
           ],
           "optional": false,
@@ -18421,27 +17820,39 @@
           "setter": false
         },
         {
-          "name": "disabled",
-          "type": "boolean",
+          "name": "navStyle",
+          "type": "\"dashboard\" | \"settings\"",
           "complexType": {
-            "original": "boolean",
-            "resolved": "boolean",
-            "references": {}
+            "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": "disabled",
+          "attr": "nav-style",
           "reflectToAttr": true,
-          "docs": "Native disabled state.",
+          "docs": "Chrome style propagated to slotted `ds-panel-nav` and `ds-bar-nav`.",
           "docsTags": [
             {
               "name": "default",
-              "text": "false"
+              "text": "'dashboard'"
             }
           ],
-          "default": "false",
+          "default": "'dashboard'",
           "values": [
             {
-              "type": "boolean"
+              "value": "dashboard",
+              "type": "string"
+            },
+            {
+              "value": "settings",
+              "type": "string"
             }
           ],
           "optional": false,
@@ -18450,27 +17861,33 @@
           "setter": false
         },
         {
-          "name": "error",
-          "type": "boolean",
+          "name": "navigation",
+          "type": "ShellNavigationConfig",
           "complexType": {
-            "original": "boolean",
-            "resolved": "boolean",
-            "references": {}
+            "original": "ShellNavigationConfig",
+            "resolved": "ShellNavigationConfig",
+            "references": {
+              "ShellNavigationConfig": {
+                "location": "import",
+                "path": "./shell-app-types",
+                "id": "src/wc/components/ShellApp/shell-app-types.ts::ShellNavigationConfig",
+                "referenceLocation": "ShellNavigationConfig"
+              }
+            }
           },
           "mutable": false,
-          "attr": "error",
           "reflectToAttr": false,
-          "docs": "Show invalid visual state.",
+          "docs": "Router-owned navigation data used by managed composition.",
           "docsTags": [
             {
               "name": "default",
-              "text": "false"
+              "text": "{}"
             }
           ],
-          "default": "false",
+          "default": "{}",
           "values": [
             {
-              "type": "boolean"
+              "type": "ShellNavigationConfig"
             }
           ],
           "optional": false,
@@ -18479,24 +17896,33 @@
           "setter": false
         },
         {
-          "name": "errorMessage",
-          "type": "string | undefined",
+          "name": "pageChrome",
+          "type": "ShellPageChromeConfig",
           "complexType": {
-            "original": "string | undefined",
-            "resolved": "string | undefined",
-            "references": {}
+            "original": "ShellPageChromeConfig",
+            "resolved": "ShellPageChromeConfig",
+            "references": {
+              "ShellPageChromeConfig": {
+                "location": "import",
+                "path": "./shell-app-types",
+                "id": "src/wc/components/ShellApp/shell-app-types.ts::ShellPageChromeConfig",
+                "referenceLocation": "ShellPageChromeConfig"
+              }
+            }
           },
           "mutable": false,
-          "attr": "error-message",
           "reflectToAttr": false,
-          "docs": "Error text rendered below the trigger when error is true.",
-          "docsTags": [],
-          "values": [
+          "docs": "Route-owned page title and section data used by managed composition.",
+          "docsTags": [
             {
-              "type": "string"
-            },
+              "name": "default",
+              "text": "{}"
+            }
+          ],
+          "default": "{}",
+          "values": [
             {
-              "type": "undefined"
+              "type": "ShellPageChromeConfig"
             }
           ],
           "optional": false,
@@ -18505,7 +17931,7 @@
           "setter": false
         },
         {
-          "name": "hasBorder",
+          "name": "shortcutsEnabled",
           "type": "boolean",
           "complexType": {
             "original": "boolean",
@@ -18513,9 +17939,9 @@
             "references": {}
           },
           "mutable": false,
-          "attr": "has-border",
+          "attr": "shortcuts-enabled",
           "reflectToAttr": false,
-          "docs": "Show the surface-aware inset border.",
+          "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",
@@ -18534,590 +17960,88 @@
           "setter": false
         },
         {
-          "name": "icon",
-          "type": "string | undefined",
+          "name": "tools",
+          "type": "ShellToolsConfig",
           "complexType": {
-            "original": "string | undefined",
-            "resolved": "string | undefined",
-            "references": {}
+            "original": "ShellToolsConfig",
+            "resolved": "ShellToolsConfig",
+            "references": {
+              "ShellToolsConfig": {
+                "location": "import",
+                "path": "./shell-app-types",
+                "id": "src/wc/components/ShellApp/shell-app-types.ts::ShellToolsConfig",
+                "referenceLocation": "ShellToolsConfig"
+              }
+            }
           },
           "mutable": false,
-          "attr": "icon",
           "reflectToAttr": false,
-          "docs": "Optional trigger prefix icon name.",
-          "docsTags": [],
-          "values": [
-            {
-              "type": "string"
-            },
+          "docs": "Product-owned global tool definitions used by managed composition.",
+          "docsTags": [
             {
-              "type": "undefined"
+              "name": "default",
+              "text": "{}"
             }
           ],
-          "optional": false,
-          "required": false,
-          "getter": false,
-          "setter": false
-        },
-        {
-          "name": "inputId",
-          "type": "string | undefined",
-          "complexType": {
-            "original": "string | undefined",
-            "resolved": "string | undefined",
-            "references": {}
-          },
-          "mutable": false,
-          "attr": "input-id",
-          "reflectToAttr": false,
-          "docs": "ID applied to the internal combobox trigger for external labels.",
-          "docsTags": [],
+          "default": "{}",
           "values": [
             {
-              "type": "string"
-            },
-            {
-              "type": "undefined"
+              "type": "ShellToolsConfig"
             }
           ],
           "optional": false,
           "required": false,
           "getter": false,
           "setter": false
-        },
+        }
+      ],
+      "methods": [
         {
-          "name": "isInactive",
-          "type": "boolean",
+          "name": "activateTool",
+          "returns": {
+            "type": "Promise<void>",
+            "docs": ""
+          },
           "complexType": {
-            "original": "boolean",
-            "resolved": "boolean",
-            "references": {}
-          },
-          "mutable": false,
-          "attr": "is-inactive",
-          "reflectToAttr": false,
-          "docs": "Shared inactive treatment; removes interaction and form submission.",
-          "docsTags": [
-            {
-              "name": "default",
-              "text": "false"
-            }
-          ],
-          "default": "false",
-          "values": [
-            {
-              "type": "boolean"
-            }
-          ],
-          "optional": false,
-          "required": false,
-          "getter": false,
-          "setter": false
-        },
-        {
-          "name": "isLoading",
-          "type": "boolean",
-          "complexType": {
-            "original": "boolean",
-            "resolved": "boolean",
-            "references": {}
-          },
-          "mutable": false,
-          "attr": "is-loading",
-          "reflectToAttr": false,
-          "docs": "Replace the prefix with a loader and disable option interaction.",
-          "docsTags": [
-            {
-              "name": "default",
-              "text": "false"
-            }
-          ],
-          "default": "false",
-          "values": [
-            {
-              "type": "boolean"
-            }
-          ],
-          "optional": false,
-          "required": false,
-          "getter": false,
-          "setter": false
-        },
-        {
-          "name": "loadingLabel",
-          "type": "string",
-          "complexType": {
-            "original": "string",
-            "resolved": "string",
-            "references": {}
-          },
-          "mutable": false,
-          "attr": "loading-label",
-          "reflectToAttr": false,
-          "docs": "Accessible loading status label.",
-          "docsTags": [
-            {
-              "name": "default",
-              "text": "'Loading'"
-            }
-          ],
-          "default": "'Loading'",
-          "values": [
-            {
-              "type": "string"
-            }
-          ],
-          "optional": false,
-          "required": false,
-          "getter": false,
-          "setter": false
-        },
-        {
-          "name": "name",
-          "type": "string | undefined",
-          "complexType": {
-            "original": "string | undefined",
-            "resolved": "string | undefined",
-            "references": {}
-          },
-          "mutable": false,
-          "attr": "name",
-          "reflectToAttr": true,
-          "docs": "Native form field name used for each repeated selected-value entry.",
-          "docsTags": [],
-          "values": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "undefined"
-            }
-          ],
-          "optional": false,
-          "required": false,
-          "getter": false,
-          "setter": false
-        },
-        {
-          "name": "noResultsText",
-          "type": "string",
-          "complexType": {
-            "original": "string",
-            "resolved": "string",
-            "references": {}
-          },
-          "mutable": false,
-          "attr": "no-results-text",
-          "reflectToAttr": false,
-          "docs": "Localized empty-filter result text.",
-          "docsTags": [
-            {
-              "name": "default",
-              "text": "'No results found'"
-            }
-          ],
-          "default": "'No results found'",
-          "values": [
-            {
-              "type": "string"
-            }
-          ],
-          "optional": false,
-          "required": false,
-          "getter": false,
-          "setter": false
-        },
-        {
-          "name": "open",
-          "type": "boolean",
-          "complexType": {
-            "original": "boolean",
-            "resolved": "boolean",
-            "references": {}
-          },
-          "mutable": true,
-          "attr": "open",
-          "reflectToAttr": true,
-          "docs": "Controlled popup visibility.",
-          "docsTags": [
-            {
-              "name": "default",
-              "text": "false"
-            }
-          ],
-          "default": "false",
-          "values": [
-            {
-              "type": "boolean"
-            }
-          ],
-          "optional": false,
-          "required": false,
-          "getter": false,
-          "setter": false
-        },
-        {
-          "name": "options",
-          "type": "SelectMultiOption[]",
-          "complexType": {
-            "original": "SelectMultiOption[]",
-            "resolved": "SelectMultiOption[]",
-            "references": {
-              "SelectMultiOption": {
-                "location": "local",
-                "path": "/home/runner/work/compomo/compomo/src/wc/components/SelectMulti/SelectMulti.tsx",
-                "id": "src/wc/components/SelectMulti/SelectMulti.tsx::SelectMultiOption"
-              }
-            }
-          },
-          "mutable": false,
-          "reflectToAttr": false,
-          "docs": "Flat choices. Assign arrays through the JavaScript property.",
-          "docsTags": [
-            {
-              "name": "default",
-              "text": "[]"
-            }
-          ],
-          "default": "[]",
-          "values": [
-            {
-              "type": "SelectMultiOption[]"
-            }
-          ],
-          "optional": false,
-          "required": false,
-          "getter": false,
-          "setter": false
-        },
-        {
-          "name": "placeholder",
-          "type": "string",
-          "complexType": {
-            "original": "string",
-            "resolved": "string",
-            "references": {}
-          },
-          "mutable": false,
-          "attr": "placeholder",
-          "reflectToAttr": false,
-          "docs": "Persistent trigger label; selected option labels never replace it.",
-          "docsTags": [
-            {
-              "name": "default",
-              "text": "'Select'"
-            }
-          ],
-          "default": "'Select'",
-          "values": [
-            {
-              "type": "string"
-            }
-          ],
-          "optional": false,
-          "required": false,
-          "getter": false,
-          "setter": false
-        },
-        {
-          "name": "required",
-          "type": "boolean",
-          "complexType": {
-            "original": "boolean",
-            "resolved": "boolean",
-            "references": {}
-          },
-          "mutable": false,
-          "attr": "required",
-          "reflectToAttr": true,
-          "docs": "Require at least one valid selected value.",
-          "docsTags": [
-            {
-              "name": "default",
-              "text": "false"
-            }
-          ],
-          "default": "false",
-          "values": [
-            {
-              "type": "boolean"
-            }
-          ],
-          "optional": false,
-          "required": false,
-          "getter": false,
-          "setter": false
-        },
-        {
-          "name": "requiredMessage",
-          "type": "string",
-          "complexType": {
-            "original": "string",
-            "resolved": "string",
-            "references": {}
-          },
-          "mutable": false,
-          "attr": "required-message",
-          "reflectToAttr": false,
-          "docs": "Validation message used when required is missing.",
-          "docsTags": [
-            {
-              "name": "default",
-              "text": "'This field is required.'"
-            }
-          ],
-          "default": "'This field is required.'",
-          "values": [
-            {
-              "type": "string"
-            }
-          ],
-          "optional": false,
-          "required": false,
-          "getter": false,
-          "setter": false
-        },
-        {
-          "name": "searchPlaceholder",
-          "type": "string",
-          "complexType": {
-            "original": "string",
-            "resolved": "string",
-            "references": {}
-          },
-          "mutable": false,
-          "attr": "search-placeholder",
-          "reflectToAttr": false,
-          "docs": "Localized search-field placeholder and accessible name.",
-          "docsTags": [
-            {
-              "name": "default",
-              "text": "'Search'"
-            }
-          ],
-          "default": "'Search'",
-          "values": [
-            {
-              "type": "string"
-            }
-          ],
-          "optional": false,
-          "required": false,
-          "getter": false,
-          "setter": false
-        },
-        {
-          "name": "searchable",
-          "type": "boolean",
-          "complexType": {
-            "original": "boolean",
-            "resolved": "boolean",
-            "references": {}
-          },
-          "mutable": false,
-          "attr": "searchable",
-          "reflectToAttr": false,
-          "docs": "Show immediate local filtering over option labels, subtext, and section headings.",
-          "docsTags": [
-            {
-              "name": "default",
-              "text": "false"
-            }
-          ],
-          "default": "false",
-          "values": [
-            {
-              "type": "boolean"
-            }
-          ],
-          "optional": false,
-          "required": false,
-          "getter": false,
-          "setter": false
-        },
-        {
-          "name": "sections",
-          "type": "SelectMultiSection[]",
-          "complexType": {
-            "original": "SelectMultiSection[]",
-            "resolved": "SelectMultiSection[]",
-            "references": {
-              "SelectMultiSection": {
-                "location": "local",
-                "path": "/home/runner/work/compomo/compomo/src/wc/components/SelectMulti/SelectMulti.tsx",
-                "id": "src/wc/components/SelectMulti/SelectMulti.tsx::SelectMultiSection"
-              }
-            }
-          },
-          "mutable": false,
-          "reflectToAttr": false,
-          "docs": "Grouped choices; takes precedence over options. Assign through JavaScript.",
-          "docsTags": [
-            {
-              "name": "default",
-              "text": "[]"
-            }
-          ],
-          "default": "[]",
-          "values": [
-            {
-              "type": "SelectMultiSection[]"
-            }
-          ],
-          "optional": false,
-          "required": false,
-          "getter": false,
-          "setter": false
-        },
-        {
-          "name": "selectedLabel",
-          "type": "string",
-          "complexType": {
-            "original": "string",
-            "resolved": "string",
-            "references": {}
-          },
-          "mutable": false,
-          "attr": "selected-label",
-          "reflectToAttr": false,
-          "docs": "Localized noun displayed after the selected count.",
-          "docsTags": [
-            {
-              "name": "default",
-              "text": "'selected'"
-            }
-          ],
-          "default": "'selected'",
-          "values": [
-            {
-              "type": "string"
-            }
-          ],
-          "optional": false,
-          "required": false,
-          "getter": false,
-          "setter": false
-        },
-        {
-          "name": "size",
-          "type": "\"lg\" | \"md\" | \"sm\" | \"xs\"",
-          "complexType": {
-            "original": "SelectMultiSize",
-            "resolved": "\"lg\" | \"md\" | \"sm\" | \"xs\"",
-            "references": {
-              "SelectMultiSize": {
-                "location": "local",
-                "path": "/home/runner/work/compomo/compomo/src/wc/components/SelectMulti/SelectMulti.tsx",
-                "id": "src/wc/components/SelectMulti/SelectMulti.tsx::SelectMultiSize"
+            "signature": "(id: PanelToolsToolId) => Promise<void>",
+            "parameters": [
+              {
+                "name": "id",
+                "type": "string",
+                "docs": ""
               }
-            }
-          },
-          "mutable": false,
-          "attr": "size",
-          "reflectToAttr": false,
-          "docs": "Control density.",
-          "docsTags": [
-            {
-              "name": "default",
-              "text": "'md'"
-            }
-          ],
-          "default": "'md'",
-          "values": [
-            {
-              "value": "lg",
-              "type": "string"
-            },
-            {
-              "value": "md",
-              "type": "string"
-            },
-            {
-              "value": "sm",
-              "type": "string"
-            },
-            {
-              "value": "xs",
-              "type": "string"
-            }
-          ],
-          "optional": false,
-          "required": false,
-          "getter": false,
-          "setter": false
-        },
-        {
-          "name": "values",
-          "type": "string[]",
-          "complexType": {
-            "original": "string[]",
-            "resolved": "string[]",
-            "references": {}
-          },
-          "mutable": true,
-          "reflectToAttr": false,
-          "docs": "Selected values. Assign arrays through the JavaScript property.",
-          "docsTags": [
-            {
-              "name": "default",
-              "text": "[]"
-            }
-          ],
-          "default": "[]",
-          "values": [
-            {
-              "type": "string[]"
-            }
-          ],
-          "optional": false,
-          "required": false,
-          "getter": false,
-          "setter": false
-        },
-        {
-          "name": "width",
-          "type": "\"fill\" | \"hug\"",
-          "complexType": {
-            "original": "SelectMultiWidth",
-            "resolved": "\"fill\" | \"hug\"",
+            ],
             "references": {
-              "SelectMultiWidth": {
-                "location": "local",
-                "path": "/home/runner/work/compomo/compomo/src/wc/components/SelectMulti/SelectMulti.tsx",
-                "id": "src/wc/components/SelectMulti/SelectMulti.tsx::SelectMultiWidth"
-              }
-            }
-          },
-          "mutable": false,
-          "attr": "width",
-          "reflectToAttr": false,
-          "docs": "Width fit — hug content (default) or fill the parent.",
-          "docsTags": [
-            {
-              "name": "default",
-              "text": "'hug'"
-            }
-          ],
-          "default": "'hug'",
-          "values": [
-            {
-              "value": "fill",
-              "type": "string"
+              "Promise": {
+                "location": "global",
+                "id": "global::Promise"
+              },
+              "PanelToolsToolId": {
+                "location": "import",
+                "path": "../PanelTools/panel-tools-types",
+                "id": "src/wc/components/PanelTools/panel-tools-types.ts::PanelToolsToolId",
+                "referenceLocation": "PanelToolsToolId"
+              },
+              "HTMLElement": {
+                "location": "global",
+                "id": "global::HTMLElement"
+              }
             },
+            "return": "Promise<void>"
+          },
+          "signature": "activateTool(id: PanelToolsToolId) => Promise<void>",
+          "parameters": [
             {
-              "value": "hug",
-              "type": "string"
+              "name": "id",
+              "type": "string",
+              "docs": ""
             }
           ],
-          "optional": false,
-          "required": false,
-          "getter": false,
-          "setter": false
-        }
-      ],
-      "methods": [
+          "docs": "Open or toggle a managed global tool from application-owned UI.",
+          "docsTags": []
+        },
         {
-          "name": "setFocus",
+          "name": "closeGlobalSurface",
           "returns": {
             "type": "Promise<void>",
             "docs": ""
@@ -19129,252 +18053,80 @@
               "Promise": {
                 "location": "global",
                 "id": "global::Promise"
+              },
+              "HTMLElement": {
+                "location": "global",
+                "id": "global::HTMLElement"
               }
             },
             "return": "Promise<void>"
           },
-          "signature": "setFocus() => Promise<void>",
+          "signature": "closeGlobalSurface() => 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.",
+          "docs": "Close whichever managed global surface is currently visible.",
           "docsTags": []
         },
         {
-          "event": "dsOpenChange",
-          "detail": "boolean",
-          "bubbles": true,
-          "complexType": {
-            "original": "boolean",
-            "resolved": "boolean",
-            "references": {}
+          "name": "setToolPresentation",
+          "returns": {
+            "type": "Promise<void>",
+            "docs": ""
           },
-          "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"
+            "signature": "(presentation: \"drawer\" | \"fullscreen\") => Promise<void>",
+            "parameters": [
+              {
+                "name": "presentation",
+                "type": "\"drawer\" | \"fullscreen\"",
+                "docs": ""
               }
-            }
-          },
-          "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": "mobileDestination",
-          "type": "\"agents\" | \"area\" | \"help\" | \"inbox\" | \"search\"",
-          "complexType": {
-            "original": "MobileDestination",
-            "resolved": "\"agents\" | \"area\" | \"help\" | \"inbox\" | \"search\"",
+            ],
             "references": {
-              "MobileDestination": {
-                "location": "import",
-                "path": "../../shell/shell-responsive",
-                "id": "src/wc/shell/shell-responsive.ts::MobileDestination",
-                "referenceLocation": "MobileDestination"
+              "Promise": {
+                "location": "global",
+                "id": "global::Promise"
               }
-            }
-          },
-          "mutable": false,
-          "attr": "mobile-destination",
-          "reflectToAttr": false,
-          "docs": "Controlled mobile surface shown above the persistent bottom bar.",
-          "docsTags": [
-            {
-              "name": "default",
-              "text": "'area'"
-            }
-          ],
-          "default": "'area'",
-          "values": [
-            {
-              "value": "agents",
-              "type": "string"
-            },
-            {
-              "value": "area",
-              "type": "string"
-            },
-            {
-              "value": "help",
-              "type": "string"
-            },
-            {
-              "value": "inbox",
-              "type": "string"
             },
+            "return": "Promise<void>"
+          },
+          "signature": "setToolPresentation(presentation: \"drawer\" | \"fullscreen\") => Promise<void>",
+          "parameters": [
             {
-              "value": "search",
-              "type": "string"
-            }
-          ],
-          "optional": false,
-          "required": false,
-          "getter": false,
-          "setter": false
-        },
-        {
-          "name": "mobileSheetNavOpen",
-          "type": "boolean",
-          "complexType": {
-            "original": "boolean",
-            "resolved": "boolean",
-            "references": {}
-          },
-          "mutable": false,
-          "attr": "mobile-sheet-nav-open",
-          "reflectToAttr": false,
-          "docs": "Controlled full-stage Mobile Sheet Nav state.",
-          "docsTags": [
-            {
-              "name": "default",
-              "text": "false"
+              "name": "presentation",
+              "type": "\"drawer\" | \"fullscreen\"",
+              "docs": ""
             }
           ],
-          "default": "false",
-          "values": [
-            {
-              "type": "boolean"
+          "docs": "Request drawer or fullscreen presentation for the active managed tool.",
+          "docsTags": []
+        }
+      ],
+      "events": [
+        {
+          "event": "dsBreadcrumbSelect",
+          "detail": "BreadcrumbSelectDetail",
+          "bubbles": true,
+          "complexType": {
+            "original": "BreadcrumbSelectDetail",
+            "resolved": "BreadcrumbSelectDetail",
+            "references": {
+              "BreadcrumbSelectDetail": {
+                "location": "import",
+                "path": "../Breadcrumb/breadcrumb-types",
+                "id": "src/wc/components/Breadcrumb/breadcrumb-types.ts::BreadcrumbSelectDetail",
+                "referenceLocation": "BreadcrumbSelectDetail"
+              }
             }
-          ],
-          "optional": false,
-          "required": false,
-          "getter": false,
-          "setter": false
+          },
+          "cancelable": true,
+          "composed": true,
+          "docs": "Managed breadcrumb intent from BarTitle.",
+          "docsTags": []
         },
         {
-          "name": "navStyle",
-          "type": "\"dashboard\" | \"settings\"",
+          "event": "dsBrowseContextChange",
+          "detail": "\"dashboard\" | \"settings\"",
+          "bubbles": true,
           "complexType": {
             "original": "NavChromeStyle",
             "resolved": "\"dashboard\" | \"settings\"",
@@ -19387,433 +18139,354 @@
               }
             }
           },
-          "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
+          "cancelable": true,
+          "composed": true,
+          "docs": "Managed mobile Dashboard/Settings browsing intent.",
+          "docsTags": []
         },
         {
-          "name": "shortcutsEnabled",
-          "type": "boolean",
+          "event": "dsHeaderAction",
+          "detail": "{ tool: string; id: string; }",
+          "bubbles": true,
           "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"
+            "original": "{ tool: PanelToolsToolId; id: string }",
+            "resolved": "{ tool: string; id: string; }",
+            "references": {
+              "PanelToolsToolId": {
+                "location": "import",
+                "path": "../PanelTools/panel-tools-types",
+                "id": "src/wc/components/PanelTools/panel-tools-types.ts::PanelToolsToolId",
+                "referenceLocation": "PanelToolsToolId"
+              }
             }
-          ],
-          "optional": false,
-          "required": false,
-          "getter": false,
-          "setter": false
-        }
-      ],
-      "methods": [],
-      "events": [
+          },
+          "cancelable": true,
+          "composed": true,
+          "docs": "Managed tool-header action intent.",
+          "docsTags": []
+        },
         {
-          "event": "dsResponsiveModeChange",
-          "detail": "{ mode: ShellResponsiveMode; }",
+          "event": "dsHeaderBack",
+          "detail": "{ tool: string; }",
           "bubbles": true,
           "complexType": {
-            "original": "{ mode: ShellResponsiveMode }",
-            "resolved": "{ mode: ShellResponsiveMode; }",
+            "original": "{ tool: PanelToolsToolId }",
+            "resolved": "{ tool: string; }",
             "references": {
-              "ShellResponsiveMode": {
+              "PanelToolsToolId": {
                 "location": "import",
-                "path": "../../shell/shell-responsive",
-                "id": "src/wc/shell/shell-responsive.ts::ShellResponsiveMode",
-                "referenceLocation": "ShellResponsiveMode"
+                "path": "../PanelTools/panel-tools-types",
+                "id": "src/wc/components/PanelTools/panel-tools-types.ts::PanelToolsToolId",
+                "referenceLocation": "PanelToolsToolId"
               }
             }
           },
           "cancelable": true,
           "composed": true,
-          "docs": "Emitted after crossing the fixed 768px or 1200px shell boundaries.",
+          "docs": "Managed tool-header Back intent.",
           "docsTags": []
-        }
-      ],
-      "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/ShellGradientPicker/ShellGradientPicker.tsx",
-      "encapsulation": "scoped",
-      "tag": "ds-shell-gradient-picker",
-      "docs": "",
-      "docsTags": [
-        {
-          "name": "deprecated",
-          "text": "Use `ds-swatch-picker` with shell preset options."
-        }
-      ],
-      "usage": {},
-      "props": [
-        {
-          "name": "groupLabel",
-          "type": "string",
+          "event": "dsNavFooterAction",
+          "detail": "void",
+          "bubbles": true,
           "complexType": {
-            "original": "string",
-            "resolved": "string",
+            "original": "void",
+            "resolved": "void",
             "references": {}
           },
-          "mutable": false,
-          "attr": "group-label",
-          "reflectToAttr": false,
-          "docs": "",
-          "docsTags": [
-            {
-              "name": "default",
-              "text": "'Shell gradient theme'"
-            }
-          ],
-          "default": "'Shell gradient theme'",
-          "values": [
-            {
-              "type": "string"
-            }
-          ],
-          "optional": false,
-          "required": false,
-          "getter": false,
-          "setter": false
+          "cancelable": true,
+          "composed": true,
+          "docs": "Managed account-footer action intent.",
+          "docsTags": []
         },
         {
-          "name": "value",
-          "type": "\"cool\" | \"fresh\" | \"neutral\" | \"none\" | \"warm\"",
+          "event": "dsNavSelect",
+          "detail": "string",
+          "bubbles": true,
           "complexType": {
-            "original": "ShellGradientPreset",
-            "resolved": "\"cool\" | \"fresh\" | \"neutral\" | \"none\" | \"warm\"",
-            "references": {
-              "ShellGradientPreset": {
-                "location": "import",
-                "path": "../ShellGradientSwatch/shell-gradient-swatch-types",
-                "id": "src/wc/components/ShellGradientSwatch/shell-gradient-swatch-types.ts::ShellGradientPreset",
-                "referenceLocation": "ShellGradientPreset"
-              }
-            }
+            "original": "string",
+            "resolved": "string",
+            "references": {}
           },
-          "mutable": true,
-          "attr": "value",
-          "reflectToAttr": true,
-          "docs": "Active shell wash preset.",
-          "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
-        }
-      ],
-      "methods": [],
-      "events": [
+          "cancelable": true,
+          "composed": true,
+          "docs": "Managed primary-navigation intent; the application router performs navigation.",
+          "docsTags": []
+        },
         {
-          "event": "dsChange",
-          "detail": "\"cool\" | \"fresh\" | \"neutral\" | \"none\" | \"warm\"",
+          "event": "dsNavUserAction",
+          "detail": "PanelNavUserActionDetail",
           "bubbles": true,
           "complexType": {
-            "original": "ShellGradientPreset",
-            "resolved": "\"cool\" | \"fresh\" | \"neutral\" | \"none\" | \"warm\"",
+            "original": "PanelNavUserActionDetail",
+            "resolved": "PanelNavUserActionDetail",
             "references": {
-              "ShellGradientPreset": {
+              "PanelNavUserActionDetail": {
                 "location": "import",
-                "path": "../ShellGradientSwatch/shell-gradient-swatch-types",
-                "id": "src/wc/components/ShellGradientSwatch/shell-gradient-swatch-types.ts::ShellGradientPreset",
-                "referenceLocation": "ShellGradientPreset"
+                "path": "../PanelNav/panel-nav-types",
+                "id": "src/wc/components/PanelNav/panel-nav-types.ts::PanelNavUserActionDetail",
+                "referenceLocation": "PanelNavUserActionDetail"
               }
             }
           },
           "cancelable": true,
           "composed": true,
-          "docs": "",
+          "docs": "Managed user/account trigger intent.",
           "docsTags": []
-        }
-      ],
-      "listeners": [],
-      "styles": [],
-      "slots": [],
-      "parts": [],
-      "states": [],
-      "dependents": [],
-      "dependencies": [
-        "ds-swatch-picker"
-      ],
-      "dependencyGraph": {
-        "ds-shell-gradient-picker": [
-          "ds-swatch-picker"
-        ]
-      },
-      "deprecation": "Use `ds-swatch-picker` with shell preset options."
-    },
-    {
-      "filePath": "src/wc/components/ShellGradientSwatch/ShellGradientSwatch.tsx",
-      "encapsulation": "scoped",
-      "tag": "ds-shell-gradient-swatch",
-      "docs": "",
-      "docsTags": [
-        {
-          "name": "deprecated",
-          "text": "Use `ds-swatch-picker`; individual swatches are implementation detail."
-        }
-      ],
-      "usage": {},
-      "props": [
+        },
         {
-          "name": "ariaLabel",
-          "type": "null | string",
+          "event": "dsPageAction",
+          "detail": "string",
+          "bubbles": true,
           "complexType": {
-            "original": "string | null",
-            "resolved": "null | string",
+            "original": "string",
+            "resolved": "string",
             "references": {}
           },
-          "mutable": false,
-          "attr": "aria-label",
-          "reflectToAttr": false,
-          "docs": "",
-          "docsTags": [
-            {
-              "name": "default",
-              "text": "null"
-            }
-          ],
-          "default": "null",
-          "values": [
-            {
-              "type": "null"
-            },
-            {
-              "type": "string"
+          "cancelable": true,
+          "composed": true,
+          "docs": "Managed page action intent from BarTitle.",
+          "docsTags": []
+        },
+        {
+          "event": "dsPageBack",
+          "detail": "MouseEvent",
+          "bubbles": true,
+          "complexType": {
+            "original": "MouseEvent",
+            "resolved": "MouseEvent",
+            "references": {
+              "MouseEvent": {
+                "location": "global",
+                "id": "global::MouseEvent"
+              }
             }
-          ],
-          "optional": false,
-          "required": false,
-          "getter": false,
-          "setter": false
+          },
+          "cancelable": true,
+          "composed": true,
+          "docs": "Managed page-level Back intent.",
+          "docsTags": []
         },
         {
-          "name": "isInactive",
-          "type": "boolean",
+          "event": "dsPresentationChange",
+          "detail": "{ presentation: \"drawer\" | \"fullscreen\"; }",
+          "bubbles": true,
           "complexType": {
-            "original": "boolean",
-            "resolved": "boolean",
+            "original": "{ presentation: 'drawer' | 'fullscreen' }",
+            "resolved": "{ presentation: \"drawer\" | \"fullscreen\"; }",
             "references": {}
           },
-          "mutable": false,
-          "attr": "is-inactive",
-          "reflectToAttr": false,
-          "docs": "",
-          "docsTags": [
-            {
-              "name": "default",
-              "text": "false"
-            }
-          ],
-          "default": "false",
-          "values": [
-            {
-              "type": "boolean"
-            }
-          ],
-          "optional": false,
-          "required": false,
-          "getter": false,
-          "setter": false
+          "cancelable": true,
+          "composed": true,
+          "docs": "Managed drawer/fullscreen presentation state.",
+          "docsTags": []
         },
         {
-          "name": "preset",
-          "type": "\"cool\" | \"fresh\" | \"neutral\" | \"none\" | \"warm\"",
+          "event": "dsResponsiveModeChange",
+          "detail": "{ mode: ShellResponsiveMode; }",
+          "bubbles": true,
           "complexType": {
-            "original": "ShellGradientPreset",
-            "resolved": "\"cool\" | \"fresh\" | \"neutral\" | \"none\" | \"warm\"",
+            "original": "{ mode: ShellResponsiveMode }",
+            "resolved": "{ mode: ShellResponsiveMode; }",
             "references": {
-              "ShellGradientPreset": {
+              "ShellResponsiveMode": {
                 "location": "import",
-                "path": "./shell-gradient-swatch-types",
-                "id": "src/wc/components/ShellGradientSwatch/shell-gradient-swatch-types.ts::ShellGradientPreset",
-                "referenceLocation": "ShellGradientPreset"
+                "path": "../../shell/shell-responsive",
+                "id": "src/wc/shell/shell-responsive.ts::ShellResponsiveMode",
+                "referenceLocation": "ShellResponsiveMode"
               }
             }
           },
-          "mutable": false,
-          "attr": "preset",
-          "reflectToAttr": true,
-          "docs": "Wash preset this orb previews.",
-          "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
+          "cancelable": true,
+          "composed": true,
+          "docs": "Emitted after crossing the fixed 768px or 1200px shell boundaries.",
+          "docsTags": []
         },
         {
-          "name": "selected",
-          "type": "boolean",
+          "event": "dsSubsectionChange",
+          "detail": "string",
+          "bubbles": true,
           "complexType": {
-            "original": "boolean",
-            "resolved": "boolean",
+            "original": "string",
+            "resolved": "string",
             "references": {}
           },
-          "mutable": false,
-          "attr": "selected",
-          "reflectToAttr": true,
-          "docs": "Selected — brand stroke + halo over inner fill/border/interaction stack.",
-          "docsTags": [
-            {
-              "name": "default",
-              "text": "false"
-            }
-          ],
-          "default": "false",
-          "values": [
-            {
-              "type": "boolean"
-            }
-          ],
-          "optional": false,
-          "required": false,
-          "getter": false,
-          "setter": false
-        }
-      ],
-      "methods": [],
-      "events": [
+          "cancelable": true,
+          "composed": true,
+          "docs": "Managed page-subsection intent from BarTitle or MobileHeader.",
+          "docsTags": []
+        },
         {
-          "event": "dsSelect",
-          "detail": "\"cool\" | \"fresh\" | \"neutral\" | \"none\" | \"warm\"",
+          "event": "dsTabChange",
+          "detail": "string",
           "bubbles": true,
           "complexType": {
-            "original": "ShellGradientPreset",
-            "resolved": "\"cool\" | \"fresh\" | \"neutral\" | \"none\" | \"warm\"",
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "cancelable": true,
+          "composed": true,
+          "docs": "Managed desktop BarNav or mobile section-selection intent.",
+          "docsTags": []
+        },
+        {
+          "event": "dsToolChange",
+          "detail": "{ id: string; selected: boolean; }",
+          "bubbles": true,
+          "complexType": {
+            "original": "{ id: PanelToolsToolId; selected: boolean }",
+            "resolved": "{ id: string; selected: boolean; }",
             "references": {
-              "ShellGradientPreset": {
+              "PanelToolsToolId": {
                 "location": "import",
-                "path": "./shell-gradient-swatch-types",
-                "id": "src/wc/components/ShellGradientSwatch/shell-gradient-swatch-types.ts::ShellGradientPreset",
-                "referenceLocation": "ShellGradientPreset"
+                "path": "../PanelTools/panel-tools-types",
+                "id": "src/wc/components/PanelTools/panel-tools-types.ts::PanelToolsToolId",
+                "referenceLocation": "PanelToolsToolId"
               }
             }
           },
           "cancelable": true,
           "composed": true,
-          "docs": "",
+          "docs": "Managed tools selection state.",
           "docsTags": []
         }
       ],
-      "listeners": [],
+      "listeners": [
+        {
+          "event": "dsPresentationChange",
+          "capture": false,
+          "passive": false
+        },
+        {
+          "event": "keydown",
+          "target": "window",
+          "capture": true,
+          "passive": false
+        }
+      ],
       "styles": [],
       "slots": [],
       "parts": [],
       "states": [],
       "dependents": [],
-      "dependencies": [],
-      "dependencyGraph": {},
-      "deprecation": "Use `ds-swatch-picker`; individual swatches are implementation detail."
+      "dependencies": [
+        "ds-panel-nav",
+        "ds-bar-nav",
+        "ds-shell-tools",
+        "ds-mobile-sheet-nav",
+        "ds-mobile-bar-nav",
+        "ds-tooltip",
+        "ds-button-unfilled",
+        "ds-shell-page",
+        "ds-bar-title",
+        "ds-mobile-header"
+      ],
+      "dependencyGraph": {
+        "ds-shell-app": [
+          "ds-panel-nav",
+          "ds-bar-nav",
+          "ds-shell-tools",
+          "ds-mobile-sheet-nav",
+          "ds-mobile-bar-nav",
+          "ds-tooltip",
+          "ds-button-unfilled",
+          "ds-shell-page",
+          "ds-bar-title",
+          "ds-mobile-header"
+        ],
+        "ds-panel-nav": [
+          "ds-tooltip",
+          "ds-button-unfilled",
+          "ds-text",
+          "ds-icon",
+          "ds-badge"
+        ],
+        "ds-tooltip": [
+          "ds-text"
+        ],
+        "ds-button-unfilled": [
+          "ds-loader",
+          "ds-icon",
+          "ds-badge",
+          "ds-text"
+        ],
+        "ds-badge": [
+          "ds-text"
+        ],
+        "ds-bar-nav": [
+          "ds-text",
+          "ds-badge",
+          "ds-button-unfilled",
+          "ds-menu"
+        ],
+        "ds-menu": [
+          "ds-text",
+          "ds-swatch-picker",
+          "ds-badge",
+          "ds-switch"
+        ],
+        "ds-shell-tools": [
+          "ds-panel-tools",
+          "ds-mobile-header",
+          "ds-tooltip",
+          "ds-button-unfilled"
+        ],
+        "ds-panel-tools": [
+          "ds-tooltip",
+          "ds-button-unfilled",
+          "ds-panel-tool-header"
+        ],
+        "ds-panel-tool-header": [
+          "ds-tooltip",
+          "ds-button-unfilled",
+          "ds-text"
+        ],
+        "ds-mobile-header": [
+          "ds-mobile-section-switcher",
+          "ds-text"
+        ],
+        "ds-mobile-section-switcher": [
+          "ds-text",
+          "ds-menu"
+        ],
+        "ds-mobile-sheet-nav": [
+          "ds-icon",
+          "ds-text",
+          "ds-badge",
+          "ds-tooltip",
+          "ds-button-unfilled",
+          "ds-tab-group"
+        ],
+        "ds-tab-group": [
+          "ds-icon",
+          "ds-text",
+          "ds-badge"
+        ],
+        "ds-mobile-bar-nav": [
+          "ds-icon",
+          "ds-badge"
+        ],
+        "ds-bar-title": [
+          "ds-text",
+          "ds-icon",
+          "ds-button-filled",
+          "ds-tooltip",
+          "ds-button-unfilled",
+          "ds-breadcrumb",
+          "ds-menu"
+        ],
+        "ds-button-filled": [
+          "ds-loader",
+          "ds-icon",
+          "ds-badge",
+          "ds-text"
+        ],
+        "ds-breadcrumb": [
+          "ds-text"
+        ]
+      }
     },
     {
       "filePath": "src/wc/components/ShellPage/ShellPage.tsx",
@@ -20008,9 +18681,15 @@
       "slots": [],
       "parts": [],
       "states": [],
-      "dependents": [],
+      "dependents": [
+        "ds-shell-app"
+      ],
       "dependencies": [],
-      "dependencyGraph": {}
+      "dependencyGraph": {
+        "ds-shell-app": [
+          "ds-shell-page"
+        ]
+      }
     },
     {
       "filePath": "src/wc/components/ShellTools/ShellTools.tsx",
@@ -20022,10 +18701,10 @@
       "props": [
         {
           "name": "activeTool",
-          "type": "\"\" | \"activity\" | \"agents\" | \"help\" | \"messages\" | \"search\" | \"stacks\"",
+          "type": "string",
           "complexType": {
             "original": "PanelToolsToolId | ''",
-            "resolved": "\"\" | \"activity\" | \"agents\" | \"help\" | \"messages\" | \"search\" | \"stacks\"",
+            "resolved": "string",
             "references": {
               "PanelToolsToolId": {
                 "location": "import",
@@ -20048,30 +18727,6 @@
           "default": "''",
           "values": [
             {
-              "type": "\"\""
-            },
-            {
-              "value": "activity",
-              "type": "string"
-            },
-            {
-              "value": "agents",
-              "type": "string"
-            },
-            {
-              "value": "help",
-              "type": "string"
-            },
-            {
-              "value": "messages",
-              "type": "string"
-            },
-            {
-              "value": "search",
-              "type": "string"
-            },
-            {
-              "value": "stacks",
               "type": "string"
             }
           ],
@@ -20116,10 +18771,10 @@
         },
         {
           "name": "headers",
-          "type": "\"activity\" | \"agents\" | \"help\" | \"messages\" | \"search\" | \"stacks\" | PanelToolsHeaderConfig",
+          "type": "PanelToolsHeaderConfig | string",
           "complexType": {
             "original": "PanelToolsHeaders",
-            "resolved": "\"activity\" | \"agents\" | \"help\" | \"messages\" | \"search\" | \"stacks\" | PanelToolsHeaderConfig",
+            "resolved": "PanelToolsHeaderConfig | string",
             "references": {
               "PanelToolsHeaders": {
                 "location": "import",
@@ -20140,59 +18795,9 @@
           ],
           "default": "{}",
           "values": [
-            {
-              "value": "activity",
-              "type": "string"
-            },
-            {
-              "value": "agents",
-              "type": "string"
-            },
-            {
-              "value": "help",
-              "type": "string"
-            },
-            {
-              "value": "messages",
-              "type": "string"
-            },
-            {
-              "value": "search",
-              "type": "string"
-            },
-            {
-              "value": "stacks",
-              "type": "string"
-            },
             {
               "type": "PanelToolsHeaderConfig"
-            }
-          ],
-          "optional": false,
-          "required": false,
-          "getter": false,
-          "setter": false
-        },
-        {
-          "name": "headersJson",
-          "type": "string",
-          "complexType": {
-            "original": "string",
-            "resolved": "string",
-            "references": {}
-          },
-          "mutable": false,
-          "attr": "headers-json",
-          "reflectToAttr": false,
-          "docs": "",
-          "docsTags": [
-            {
-              "name": "default",
-              "text": "''"
-            }
-          ],
-          "default": "''",
-          "values": [
+            },
             {
               "type": "string"
             }
@@ -20295,35 +18900,6 @@
           "getter": false,
           "setter": false
         },
-        {
-          "name": "itemsJson",
-          "type": "string",
-          "complexType": {
-            "original": "string",
-            "resolved": "string",
-            "references": {}
-          },
-          "mutable": false,
-          "attr": "items-json",
-          "reflectToAttr": false,
-          "docs": "",
-          "docsTags": [
-            {
-              "name": "default",
-              "text": "''"
-            }
-          ],
-          "default": "''",
-          "values": [
-            {
-              "type": "string"
-            }
-          ],
-          "optional": false,
-          "required": false,
-          "getter": false,
-          "setter": false
-        },
         {
           "name": "open",
           "type": "boolean",
@@ -20532,7 +19108,7 @@
             "parameters": [
               {
                 "name": "id",
-                "type": "\"activity\" | \"search\" | \"agents\" | \"messages\" | \"stacks\" | \"help\"",
+                "type": "string",
                 "docs": ""
               }
             ],
@@ -20554,7 +19130,7 @@
           "parameters": [
             {
               "name": "id",
-              "type": "\"activity\" | \"search\" | \"agents\" | \"messages\" | \"stacks\" | \"help\"",
+              "type": "string",
               "docs": ""
             }
           ],
@@ -20625,11 +19201,11 @@
       "events": [
         {
           "event": "dsHeaderAction",
-          "detail": "{ tool: PanelToolsToolId; id: string; }",
+          "detail": "{ tool: string; id: string; }",
           "bubbles": true,
           "complexType": {
             "original": "{\n    tool: PanelToolsToolId;\n    id: string;\n  }",
-            "resolved": "{ tool: PanelToolsToolId; id: string; }",
+            "resolved": "{ tool: string; id: string; }",
             "references": {
               "PanelToolsToolId": {
                 "location": "import",
@@ -20646,11 +19222,11 @@
         },
         {
           "event": "dsHeaderBack",
-          "detail": "{ tool: PanelToolsToolId; }",
+          "detail": "{ tool: string; }",
           "bubbles": true,
           "complexType": {
             "original": "{\n    tool: PanelToolsToolId;\n  }",
-            "resolved": "{ tool: PanelToolsToolId; }",
+            "resolved": "{ tool: string; }",
             "references": {
               "PanelToolsToolId": {
                 "location": "import",
@@ -20681,11 +19257,11 @@
         },
         {
           "event": "dsToolChange",
-          "detail": "{ id: PanelToolsToolId; selected: boolean; }",
+          "detail": "{ id: string; selected: boolean; }",
           "bubbles": true,
           "complexType": {
             "original": "{\n    id: PanelToolsToolId;\n    selected: boolean;\n  }",
-            "resolved": "{ id: PanelToolsToolId; selected: boolean; }",
+            "resolved": "{ id: string; selected: boolean; }",
             "references": {
               "PanelToolsToolId": {
                 "location": "import",
@@ -20706,7 +19282,9 @@
       "slots": [],
       "parts": [],
       "states": [],
-      "dependents": [],
+      "dependents": [
+        "ds-shell-app"
+      ],
       "dependencies": [
         "ds-panel-tools",
         "ds-mobile-header",
@@ -20755,6 +19333,9 @@
           "ds-swatch-picker",
           "ds-badge",
           "ds-switch"
+        ],
+        "ds-shell-app": [
+          "ds-shell-tools"
         ]
       }
     },
@@ -22262,16 +20843,12 @@
       "parts": [],
       "states": [],
       "dependents": [
-        "ds-menu",
-        "ds-shell-gradient-picker"
+        "ds-menu"
       ],
       "dependencies": [],
       "dependencyGraph": {
         "ds-menu": [
           "ds-swatch-picker"
-        ],
-        "ds-shell-gradient-picker": [
-          "ds-swatch-picker"
         ]
       }
     },
@@ -23984,9 +22561,9 @@
         "ds-breadcrumb",
         "ds-button-filled",
         "ds-button-unfilled",
+        "ds-card-data-viz",
         "ds-card-overview",
         "ds-card-setting",
-        "ds-card-shell-data-viz",
         "ds-chart-legend",
         "ds-checkbox",
         "ds-chip",
@@ -24008,7 +22585,6 @@
         "ds-panel-tool-search",
         "ds-radio",
         "ds-select",
-        "ds-select-multi",
         "ds-slider",
         "ds-tab-group",
         "ds-tag",
@@ -24052,13 +22628,13 @@
         "ds-button-unfilled": [
           "ds-text"
         ],
-        "ds-card-overview": [
+        "ds-card-data-viz": [
           "ds-text"
         ],
-        "ds-card-setting": [
+        "ds-card-overview": [
           "ds-text"
         ],
-        "ds-card-shell-data-viz": [
+        "ds-card-setting": [
           "ds-text"
         ],
         "ds-chart-legend": [
@@ -24124,9 +22700,6 @@
         "ds-select": [
           "ds-text"
         ],
-        "ds-select-multi": [
-          "ds-text"
-        ],
         "ds-slider": [
           "ds-text"
         ],
@@ -24819,7 +23392,7 @@
         "ds-panel-tool-search",
         "ds-panel-tools",
         "ds-select",
-        "ds-select-multi",
+        "ds-shell-app",
         "ds-shell-tools"
       ],
       "dependencies": [
@@ -24868,7 +23441,7 @@
         "ds-select": [
           "ds-tooltip"
         ],
-        "ds-select-multi": [
+        "ds-shell-app": [
           "ds-tooltip"
         ],
         "ds-shell-tools": [
@@ -25141,12 +23714,12 @@
       "path": "src/wc/components/Badge/Badge.tsx"
     },
     "src/wc/components/ButtonFilled/ButtonFilled.tsx::ButtonFilledVariant": {
-      "declaration": "export type ButtonFilledVariant = 'icon' | 'label' | 'icon-label';",
+      "declaration": "export type ButtonVariant = 'icon' | 'label' | 'icon-label';",
       "docstring": "",
       "path": "src/wc/components/ButtonFilled/ButtonFilled.tsx"
     },
     "src/wc/components/ButtonFilled/ButtonFilled.tsx::ButtonFilledSize": {
-      "declaration": "export type ButtonFilledSize = 'lg' | 'md' | 'sm' | 'xs';",
+      "declaration": "export type ButtonSize = 'lg' | 'md' | 'sm' | 'xs';",
       "docstring": "",
       "path": "src/wc/components/ButtonFilled/ButtonFilled.tsx"
     },
@@ -25171,17 +23744,17 @@
       "path": "src/wc/components/ButtonFilled/ButtonFilled.tsx"
     },
     "src/wc/components/ButtonFilled/ButtonFilled.tsx::ButtonFilledPopup": {
-      "declaration": "export type ButtonFilledPopup = 'true' | 'menu' | 'listbox' | 'tree' | 'grid' | 'dialog';",
+      "declaration": "export type ButtonPopup = 'true' | 'menu' | 'listbox' | 'tree' | 'grid' | 'dialog';",
       "docstring": "",
       "path": "src/wc/components/ButtonFilled/ButtonFilled.tsx"
     },
     "src/wc/components/ButtonUnfilled/ButtonUnfilled.tsx::ButtonUnfilledVariant": {
-      "declaration": "export type ButtonUnfilledVariant = 'icon' | 'label' | 'icon-label';",
+      "declaration": "export type ButtonVariant = 'icon' | 'label' | 'icon-label';",
       "docstring": "",
       "path": "src/wc/components/ButtonUnfilled/ButtonUnfilled.tsx"
     },
     "src/wc/components/ButtonUnfilled/ButtonUnfilled.tsx::ButtonUnfilledSize": {
-      "declaration": "export type ButtonUnfilledSize = 'lg' | 'md' | 'sm' | 'xs';",
+      "declaration": "export type ButtonSize = 'lg' | 'md' | 'sm' | 'xs';",
       "docstring": "",
       "path": "src/wc/components/ButtonUnfilled/ButtonUnfilled.tsx"
     },
@@ -25196,29 +23769,19 @@
       "path": "src/wc/components/ButtonUnfilled/ButtonUnfilled.tsx"
     },
     "src/wc/components/ButtonUnfilled/ButtonUnfilled.tsx::ButtonUnfilledPopup": {
-      "declaration": "export type ButtonUnfilledPopup = 'true' | 'menu' | 'listbox' | 'tree' | 'grid' | 'dialog';",
+      "declaration": "export type ButtonPopup = 'true' | 'menu' | 'listbox' | 'tree' | 'grid' | 'dialog';",
       "docstring": "",
       "path": "src/wc/components/ButtonUnfilled/ButtonUnfilled.tsx"
     },
-    "src/wc/components/CardShellDataViz/CardShellDataViz.tsx::CardShellDataVizWidth": {
-      "declaration": "export type CardShellDataVizWidth = 'sm' | 'md' | 'lg';",
+    "src/wc/components/CardDataViz/CardDataViz.tsx::CardDataVizVariant": {
+      "declaration": "export type CardDataVizVariant = 'custom' | 'bar' | 'line' | 'donut';",
       "docstring": "",
-      "path": "src/wc/components/CardShellDataViz/CardShellDataViz.tsx"
+      "path": "src/wc/components/CardDataViz/CardDataViz.tsx"
     },
-    "src/wc/components/CardDataVizBar/CardDataVizBar.tsx::CardDataVizBarWidth": {
-      "declaration": "export type CardShellDataVizWidth = 'sm' | 'md' | 'lg';",
+    "src/wc/components/CardDataViz/CardDataViz.tsx::CardDataVizWidth": {
+      "declaration": "export type CardDataVizWidth = 'sm' | 'md' | 'lg';",
       "docstring": "",
-      "path": "src/wc/components/CardDataVizBar/CardDataVizBar.tsx"
-    },
-    "src/wc/components/CardDataVizDonut/CardDataVizDonut.tsx::CardDataVizDonutWidth": {
-      "declaration": "export type CardShellDataVizWidth = 'sm' | 'md' | 'lg';",
-      "docstring": "",
-      "path": "src/wc/components/CardDataVizDonut/CardDataVizDonut.tsx"
-    },
-    "src/wc/components/CardDataVizLine/CardDataVizLine.tsx::CardDataVizLineWidth": {
-      "declaration": "export type CardShellDataVizWidth = 'sm' | 'md' | 'lg';",
-      "docstring": "",
-      "path": "src/wc/components/CardDataVizLine/CardDataVizLine.tsx"
+      "path": "src/wc/components/CardDataViz/CardDataViz.tsx"
     },
     "src/wc/components/CardSetting/CardSetting.tsx::CardSettingWidth": {
       "declaration": "export type CardSettingWidth = 'sm' | 'md' | 'lg';",
@@ -25230,15 +23793,20 @@
       "docstring": "",
       "path": "src/wc/components/CardSetting/CardSetting.tsx"
     },
-    "src/wc/utils/chart-types.ts::ChartSeries": {
-      "declaration": "export interface ChartSeries {\n  name: string;\n  data: number[];\n  /** CSS color override; defaults to the next `--color-data-category-*` token. */\n  color?: string;\n}",
+    "src/wc/components/ChartBar/ChartBar.tsx::ChartBarVariant": {
+      "declaration": "export type ChartBarVariant = 'single' | 'stacked' | 'percentage';",
       "docstring": "",
+      "path": "src/wc/components/ChartBar/ChartBar.tsx"
+    },
+    "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.",
       "path": "src/wc/utils/chart-types.ts"
     },
-    "src/wc/components/ChartBarStacked/ChartBarStacked.tsx::ChartBarStackedVariant": {
-      "declaration": "export type ChartBarStackedVariant = 'stacked' | 'percentage';",
+    "src/wc/utils/chart-types.ts::ChartSeries": {
+      "declaration": "export interface ChartSeries {\n  name: string;\n  data: number[];\n  /** CSS color override; defaults to the next `--color-data-category-*` token. */\n  color?: string;\n}",
       "docstring": "",
-      "path": "src/wc/components/ChartBarStacked/ChartBarStacked.tsx"
+      "path": "src/wc/utils/chart-types.ts"
     },
     "src/wc/utils/chart-types.ts::ChartLegendItem": {
       "declaration": "export interface ChartLegendItem {\n  label: string;\n  value?: number;\n  /** CSS color override; defaults to the next `--color-data-category-*` token. */\n  color?: string;\n  /** When set, the row renders as a link (e.g. to a filtered list page for this segment). */\n  href?: string;\n}",
@@ -25336,7 +23904,7 @@
       "path": "src/wc/components/Menu/Menu.tsx"
     },
     "src/wc/components/Menu/menu-types.ts::MenuSection": {
-      "declaration": "export type MenuSection =\n  | MenuItemsSection\n  | MenuGradientPickerSection\n  | MenuSwatchPickerSection;",
+      "declaration": "export type MenuSection =\n  | MenuItemsSection\n  | MenuSwatchPickerSection;",
       "docstring": "",
       "path": "src/wc/components/Menu/menu-types.ts"
     },
@@ -25355,11 +23923,6 @@
       "docstring": "",
       "path": "src/wc/utils/index.ts"
     },
-    "src/wc/shell/shell-gradient-presets.ts::ShellGradientPreset": {
-      "declaration": "export type ShellGradientPreset = 'none' | 'cool' | 'neutral' | 'warm' | 'fresh';",
-      "docstring": "",
-      "path": "src/wc/shell/shell-gradient-presets.ts"
-    },
     "src/wc/components/MessageBubble/MessageBubble.tsx::MessageBubbleVariant": {
       "declaration": "export type MessageBubbleVariant = 'user' | 'received';",
       "docstring": "",
@@ -25410,6 +23973,11 @@
       "docstring": "",
       "path": "src/wc/components/Select/Select.tsx"
     },
+    "src/wc/components/Select/Select.tsx::SelectValue": {
+      "declaration": "export type SelectValue = string | string[];",
+      "docstring": "",
+      "path": "src/wc/components/Select/Select.tsx"
+    },
     "src/wc/components/Select/Select.tsx::SelectSize": {
       "declaration": "export type SelectSize = 'lg' | 'md' | 'sm' | 'xs';",
       "docstring": "",
@@ -25425,31 +23993,6 @@
       "docstring": "",
       "path": "src/wc/components/Select/Select.tsx"
     },
-    "src/wc/components/SelectMulti/SelectMulti.tsx::SelectMultiOption": {
-      "declaration": "{\n    [P in K]: T[P];\n}",
-      "docstring": "",
-      "path": "src/wc/components/SelectMulti/SelectMulti.tsx"
-    },
-    "src/wc/components/SelectMulti/SelectMulti.tsx::SelectMultiSection": {
-      "declaration": "export type SelectMultiSection = Omit<SelectSection, 'options'> & {\n  options: SelectMultiOption[];\n};",
-      "docstring": "",
-      "path": "src/wc/components/SelectMulti/SelectMulti.tsx"
-    },
-    "src/wc/components/SelectMulti/SelectMulti.tsx::SelectMultiSize": {
-      "declaration": "export type SelectSize = 'lg' | 'md' | 'sm' | 'xs';",
-      "docstring": "",
-      "path": "src/wc/components/SelectMulti/SelectMulti.tsx"
-    },
-    "src/wc/components/SelectMulti/SelectMulti.tsx::SelectMultiWidth": {
-      "declaration": "export type ControlWidth = 'hug' | 'fill';",
-      "docstring": "",
-      "path": "src/wc/components/SelectMulti/SelectMulti.tsx"
-    },
-    "src/wc/components/SelectMulti/SelectMulti.tsx::SelectMultiBackground": {
-      "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/SelectMulti/SelectMulti.tsx"
-    },
     "src/wc/components/Skeleton/Skeleton.tsx::SkeletonVariant": {
       "declaration": "export type SkeletonVariant = 'text' | 'icon' | 'control';",
       "docstring": "",
@@ -25670,11 +24213,6 @@
       "docstring": "One measure in the overview grid.",
       "path": "src/wc/components/CardOverview/card-overview-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.",
-      "path": "src/wc/utils/chart-types.ts"
-    },
     "src/wc/components/conversation-types.ts::ConversationItemState": {
       "declaration": "export type ConversationItemState = 'default' | 'busy' | 'error';",
       "docstring": "",
@@ -25761,12 +24299,12 @@
       "path": "src/wc/components/PanelTools/panel-tools-types.ts"
     },
     "src/wc/components/PanelTools/panel-tools-types.ts::PanelToolsToolId": {
-      "declaration": "export type PanelToolsToolId = 'search' | 'agents' | 'messages' | 'stacks' | 'activity' | 'help';",
+      "declaration": "string",
       "docstring": "",
       "path": "src/wc/components/PanelTools/panel-tools-types.ts"
     },
     "src/wc/components/PanelTools/panel-tools-types.ts::PanelToolsItem": {
-      "declaration": "export interface PanelToolsItem {\n  id: PanelToolsToolId;\n  /** Icon name for <ds-icon>. */\n  icon: string;\n  /** Whether this rail button is currently pressed/active. */\n  selected?: boolean;\n  /** Show a notification dot. */\n  dot?: boolean;\n  isInactive?: boolean;\n  ariaLabel?: string;\n}",
+      "declaration": "export interface PanelToolsItem {\n  id: PanelToolsToolId;\n  /** Icon name for <ds-icon>. */\n  icon: string;\n  /** Visible and accessible fallback label for custom tool ids. */\n  label?: string;\n  /** Explicit rail region; canonical Search/Help placement is the fallback. */\n  railPlacement?: 'header' | 'body' | 'footer';\n  /** Stable ordering within the selected rail region. */\n  order?: number;\n  /** Optional shortcut label displayed by the tooltip. */\n  shortcutKey?: string;\n  /** Mobile destination recipe; canonical ids retain their existing defaults. */\n  mobileDestination?: 'search' | 'agents' | 'inbox' | 'help';\n  /** Whether this rail button is currently pressed/active. */\n  selected?: boolean;\n  /** Show a notification dot. */\n  dot?: boolean;\n  isInactive?: boolean;\n  ariaLabel?: string;\n}",
       "docstring": "",
       "path": "src/wc/components/PanelTools/panel-tools-types.ts"
     },
@@ -25775,10 +24313,30 @@
       "docstring": "",
       "path": "src/wc/components/PanelTools/panel-tools-types.ts"
     },
-    "src/wc/components/ShellGradientSwatch/shell-gradient-swatch-types.ts::ShellGradientPreset": {
-      "declaration": "any",
+    "src/wc/components/ShellApp/shell-app-types.ts::ShellAppComposition": {
+      "declaration": "export type ShellAppComposition = 'managed' | 'slotted';",
       "docstring": "",
-      "path": "src/wc/components/ShellGradientSwatch/shell-gradient-swatch-types.ts"
+      "path": "src/wc/components/ShellApp/shell-app-types.ts"
+    },
+    "src/wc/components/ShellApp/shell-app-types.ts::ShellNavigationConfig": {
+      "declaration": "export interface ShellNavigationConfig {\n  /** Groups shown in the current desktop/tablet PanelNav context. */\n  groups?: PanelNavGroup[];\n  /** Complete Dashboard collection used by the mobile navigation sheet. */\n  dashboardGroups?: PanelNavGroup[];\n  /** Complete Settings collection used by the mobile navigation sheet. */\n  settingsGroups?: PanelNavGroup[];\n  /** Current application URL used for active-item matching. */\n  currentUrl?: string;\n  /** Optional explicit active destination when URL matching is unavailable. */\n  activeId?: string;\n  /** Current Dashboard or Settings browsing context. */\n  browseContext?: NavChromeStyle;\n  /** Managed shells default to event routing so the application router stays authoritative. */\n  routerMode?: PanelNavRouterMode;\n  /** Persisted desktop PanelNav collapse preference key. */\n  storageKey?: string;\n  userName?: string;\n  userInitial?: string;\n  accountMenuExpanded?: boolean;\n  dashboardLabel?: string;\n  settingsLabel?: string;\n  accountLabel?: string;\n  navigationLabel?: string;\n  dashboardNavigationLabel?: string;\n  settingsNavigationLabel?: string;\n}",
+      "docstring": "Router-owned application navigation supplied to managed ShellApp.\nShellApp renders the responsive chrome but never performs route changes.",
+      "path": "src/wc/components/ShellApp/shell-app-types.ts"
+    },
+    "src/wc/components/ShellApp/shell-app-types.ts::ShellPageChromeConfig": {
+      "declaration": "export interface ShellPageChromeConfig {\n  heading?: string;\n  /** Desktop/tablet route-navigation heading when it differs from the page h1. */\n  routeHeading?: string;\n  description?: string;\n  headingLevel?: 'h1' | 'h2';\n  tabs?: BarNavTab[];\n  value?: string;\n  basePath?: string;\n  currentUrl?: string;\n  sectionsAriaLabel?: string;\n  subsections?: BarNavTab[];\n  subvalue?: string;\n  subsectionsAriaLabel?: string;\n  showBack?: boolean;\n  backAriaLabel?: string;\n  backIcon?: string;\n  backLabel?: string;\n  breadcrumbs?: BreadcrumbItem[];\n  breadcrumbAriaLabel?: string;\n  primaryAction?: BarTitlePrimaryAction | null;\n  actions?: BarTitleActionItem[];\n  /** Icon actions rendered in the mobile header's trailing lane. */\n  mobileActions?: PanelToolsHeaderAction[];\n  actionsAriaLabel?: string;\n  tone?: MobileHeaderTone;\n  contentInset?: 'default' | 'none';\n}",
+      "docstring": "Route-owned page chrome. The same data drives desktop BarNav/BarTitle and\nthe intentionally different mobile MobileHeader presentation.",
+      "path": "src/wc/components/ShellApp/shell-app-types.ts"
+    },
+    "src/wc/components/ShellApp/shell-app-types.ts::ShellToolsConfig": {
+      "declaration": "export interface ShellToolsConfig {\n  items?: PanelToolsItem[];\n  headers?: PanelToolsHeaders;\n  storageKey?: string;\n  fullscreenHeaderMode?: 'shared' | 'split';\n  toolsLabel?: string;\n  toolShortcutsLabel?: string;\n  inboxLabel?: string;\n  inboxNavigationLabel?: string;\n  /** Temporarily conceal the mobile bar while a tool-owned keyboard interaction needs the space. */\n  mobileBarHidden?: boolean;\n}",
+      "docstring": "Product-owned global tools supplied to managed ShellApp. Tool view content\nremains mounted in the corresponding named `*-view` slots.",
+      "path": "src/wc/components/ShellApp/shell-app-types.ts"
+    },
+    "src/wc/shell/shell-gradient-presets.ts::ShellGradientPreset": {
+      "declaration": "export type ShellGradientPreset = 'none' | 'cool' | 'neutral' | 'warm' | 'fresh';",
+      "docstring": "",
+      "path": "src/wc/shell/shell-gradient-presets.ts"
     },
     "src/wc/components/ShellPage/shell-page-types.ts::ShellPageHeaderPresentation": {
       "declaration": "export type ShellPageHeaderPresentation = 'auto' | BarTitleVariant;",