@ds-mo/ui 6.0.1 → 8.0.0

package/dist/docs/components.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2026-07-14T02:00:55",
+  "timestamp": "2026-07-15T20:57:52",
   "compiler": {
     "name": "@stencil/core",
     "version": "4.43.5",
@@ -23,8 +23,8 @@
             "references": {
               "ShellGradientPreset": {
                 "location": "import",
-                "path": "../../nav/shell-gradient-presets",
-                "id": "src/wc/nav/shell-gradient-presets.ts::ShellGradientPreset",
+                "path": "../../shell/shell-gradient-presets",
+                "id": "src/wc/shell/shell-gradient-presets.ts::ShellGradientPreset",
                 "referenceLocation": "ShellGradientPreset"
               }
             }
@@ -76,8 +76,8 @@
             "references": {
               "NavChromeStyle": {
                 "location": "import",
-                "path": "../../nav/nav-chrome",
-                "id": "src/wc/nav/nav-chrome.ts::NavChromeStyle",
+                "path": "../../shell/nav-chrome",
+                "id": "src/wc/shell/nav-chrome.ts::NavChromeStyle",
                 "referenceLocation": "NavChromeStyle"
               }
             }
@@ -259,7 +259,7 @@
           "mutable": false,
           "attr": "label",
           "reflectToAttr": false,
-          "docs": "Accessible label. Defaults to the count as a string.",
+          "docs": "Contextual supplemental text. Omit when the owner hides the badge from assistive technology.",
           "docsTags": [],
           "values": [
             {
@@ -285,7 +285,7 @@
           "mutable": false,
           "attr": "max",
           "reflectToAttr": false,
-          "docs": "Highest count shown before compacting to \"+\".",
+          "docs": "Highest count shown before compacting to \"{max}+\".",
           "docsTags": [
             {
               "name": "default",
@@ -305,10 +305,10 @@
         },
         {
           "name": "surface",
-          "type": "\"always-dark\" | \"bold\" | \"default\" | \"medium\" | \"navigation\" | \"primary\" | \"secondary\" | \"strong\"",
+          "type": "\"always-dark\" | \"bold\" | \"faint\" | \"inverted\" | \"media\" | \"medium\" | \"navigation\" | \"primary\" | \"secondary\" | \"strong\" | \"translucent\"",
           "complexType": {
             "original": "BadgeSurface",
-            "resolved": "\"always-dark\" | \"bold\" | \"default\" | \"medium\" | \"navigation\" | \"primary\" | \"secondary\" | \"strong\"",
+            "resolved": "\"always-dark\" | \"bold\" | \"faint\" | \"inverted\" | \"media\" | \"medium\" | \"navigation\" | \"primary\" | \"secondary\" | \"strong\" | \"translucent\"",
             "references": {
               "BadgeSurface": {
                 "location": "local",
@@ -320,14 +320,14 @@
           "mutable": false,
           "attr": "surface",
           "reflectToAttr": false,
-          "docs": "Surface context for the ring around dots.",
+          "docs": "Immediate backing surface matched by the ring around either variant.",
           "docsTags": [
             {
               "name": "default",
-              "text": "'default'"
+              "text": "'primary'"
             }
           ],
-          "default": "'default'",
+          "default": "'primary'",
           "values": [
             {
               "value": "always-dark",
@@ -338,7 +338,15 @@
               "type": "string"
             },
             {
-              "value": "default",
+              "value": "faint",
+              "type": "string"
+            },
+            {
+              "value": "inverted",
+              "type": "string"
+            },
+            {
+              "value": "media",
               "type": "string"
             },
             {
@@ -360,6 +368,10 @@
             {
               "value": "strong",
               "type": "string"
+            },
+            {
+              "value": "translucent",
+              "type": "string"
             }
           ],
           "optional": false,
@@ -416,11 +428,11 @@
       "parts": [],
       "states": [],
       "dependents": [
+        "ds-bar-nav",
         "ds-button-unfilled",
         "ds-menu",
         "ds-panel-nav",
-        "ds-tab-group",
-        "ds-tab-group-nav"
+        "ds-tab-group"
       ],
       "dependencies": [
         "ds-text"
@@ -429,6 +441,9 @@
         "ds-badge": [
           "ds-text"
         ],
+        "ds-bar-nav": [
+          "ds-badge"
+        ],
         "ds-button-unfilled": [
           "ds-badge"
         ],
@@ -440,9 +455,6 @@
         ],
         "ds-tab-group": [
           "ds-badge"
-        ],
-        "ds-tab-group-nav": [
-          "ds-badge"
         ]
       }
     },
@@ -878,8 +890,8 @@
             "references": {
               "NavChromeStyle": {
                 "location": "import",
-                "path": "../../nav/nav-chrome",
-                "id": "src/wc/nav/nav-chrome.ts::NavChromeStyle",
+                "path": "../../shell/nav-chrome",
+                "id": "src/wc/shell/nav-chrome.ts::NavChromeStyle",
                 "referenceLocation": "NavChromeStyle"
               }
             }
@@ -1028,26 +1040,23 @@
       "states": [],
       "dependents": [],
       "dependencies": [
-        "ds-tab-group-nav",
         "ds-text",
+        "ds-badge",
         "ds-button-unfilled",
         "ds-menu"
       ],
       "dependencyGraph": {
         "ds-bar-nav": [
-          "ds-tab-group-nav",
           "ds-text",
+          "ds-badge",
           "ds-button-unfilled",
           "ds-menu"
         ],
-        "ds-tab-group-nav": [
-          "ds-text",
-          "ds-badge"
-        ],
         "ds-badge": [
           "ds-text"
         ],
         "ds-button-unfilled": [
+          "ds-loader",
           "ds-icon",
           "ds-badge",
           "ds-text"
@@ -1082,7 +1091,7 @@
           "mutable": false,
           "attr": "aria-label",
           "reflectToAttr": false,
-          "docs": "",
+          "docs": "Accessible name override. Required for icon-only buttons.",
           "docsTags": [
             {
               "name": "default",
@@ -1277,6 +1286,35 @@
           "getter": false,
           "setter": false
         },
+        {
+          "name": "isLoading",
+          "type": "boolean",
+          "complexType": {
+            "original": "boolean",
+            "resolved": "boolean",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "is-loading",
+          "reflectToAttr": false,
+          "docs": "Shows an inline loader and prevents interaction without applying inactive opacity.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "false"
+            }
+          ],
+          "default": "false",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
         {
           "name": "label",
           "type": "string",
@@ -1527,11 +1565,13 @@
         "ds-card-setting"
       ],
       "dependencies": [
+        "ds-loader",
         "ds-icon",
         "ds-text"
       ],
       "dependencyGraph": {
         "ds-button-filled": [
+          "ds-loader",
           "ds-icon",
           "ds-text"
         ],
@@ -1588,7 +1628,7 @@
           "mutable": false,
           "attr": "aria-label",
           "reflectToAttr": false,
-          "docs": "",
+          "docs": "Accessible name override. Required for icon-only buttons.",
           "docsTags": [
             {
               "name": "default",
@@ -1611,10 +1651,10 @@
         },
         {
           "name": "background",
-          "type": "\"always-dark\" | \"navigation\" | undefined",
+          "type": "\"always-dark\" | \"bold\" | \"faint\" | \"inverted\" | \"media\" | \"medium\" | \"strong\" | \"translucent\" | undefined",
           "complexType": {
             "original": "ButtonUnfilledBackground | undefined",
-            "resolved": "\"always-dark\" | \"navigation\" | undefined",
+            "resolved": "\"always-dark\" | \"bold\" | \"faint\" | \"inverted\" | \"media\" | \"medium\" | \"strong\" | \"translucent\" | undefined",
             "references": {
               "ButtonUnfilledBackground": {
                 "location": "local",
@@ -1626,7 +1666,7 @@
           "mutable": false,
           "attr": "background",
           "reflectToAttr": false,
-          "docs": "Parent surface context for navigation and always-dark chrome.",
+          "docs": "Actual parent surface context. Omit on primary and secondary surfaces.",
           "docsTags": [],
           "values": [
             {
@@ -1634,44 +1674,19 @@
               "type": "string"
             },
             {
-              "value": "navigation",
+              "value": "bold",
               "type": "string"
             },
             {
-              "type": "undefined"
-            }
-          ],
-          "optional": false,
-          "required": false,
-          "getter": false,
-          "setter": false
-        },
-        {
-          "name": "backgroundContrast",
-          "type": "\"bold\" | \"default\" | \"medium\" | \"strong\" | undefined",
-          "complexType": {
-            "original": "ButtonUnfilledOnBackgroundContrast",
-            "resolved": "\"bold\" | \"default\" | \"medium\" | \"strong\" | undefined",
-            "references": {
-              "ButtonUnfilledOnBackgroundContrast": {
-                "location": "local",
-                "path": "/home/runner/work/compomo/compomo/src/wc/components/ButtonUnfilled/ButtonUnfilled.tsx",
-                "id": "src/wc/components/ButtonUnfilled/ButtonUnfilled.tsx::ButtonUnfilledOnBackgroundContrast"
-              }
-            }
-          },
-          "mutable": false,
-          "attr": "on-background-contrast",
-          "reflectToAttr": false,
-          "docs": "Foreground and interaction tokens when the button sits on a contrasting parent\nbackground (default, medium, bold, or strong).",
-          "docsTags": [],
-          "values": [
+              "value": "faint",
+              "type": "string"
+            },
             {
-              "value": "bold",
+              "value": "inverted",
               "type": "string"
             },
             {
-              "value": "default",
+              "value": "media",
               "type": "string"
             },
             {
@@ -1682,11 +1697,15 @@
               "value": "strong",
               "type": "string"
             },
+            {
+              "value": "translucent",
+              "type": "string"
+            },
             {
               "type": "undefined"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false,
           "getter": false,
           "setter": false
@@ -1940,6 +1959,35 @@
           "getter": false,
           "setter": false
         },
+        {
+          "name": "isLoading",
+          "type": "boolean",
+          "complexType": {
+            "original": "boolean",
+            "resolved": "boolean",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "is-loading",
+          "reflectToAttr": false,
+          "docs": "Shows an inline loader and prevents interaction without applying inactive opacity.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "false"
+            }
+          ],
+          "default": "false",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
         {
           "name": "label",
           "type": "string",
@@ -2234,12 +2282,14 @@
         "ds-panel-tools"
       ],
       "dependencies": [
+        "ds-loader",
         "ds-icon",
         "ds-badge",
         "ds-text"
       ],
       "dependencyGraph": {
         "ds-button-unfilled": [
+          "ds-loader",
           "ds-icon",
           "ds-badge",
           "ds-text"
@@ -2547,6 +2597,7 @@
           "ds-text"
         ],
         "ds-button-unfilled": [
+          "ds-loader",
           "ds-icon",
           "ds-badge",
           "ds-text"
@@ -2786,6 +2837,7 @@
           "ds-text"
         ],
         "ds-button-unfilled": [
+          "ds-loader",
           "ds-icon",
           "ds-badge",
           "ds-text"
@@ -2794,6 +2846,7 @@
           "ds-text"
         ],
         "ds-button-filled": [
+          "ds-loader",
           "ds-icon",
           "ds-text"
         ]
@@ -3953,55 +4006,6 @@
       "docsTags": [],
       "usage": {},
       "props": [
-        {
-          "name": "background",
-          "type": "\"always-dark\" | \"bold\" | \"faint\" | \"medium\" | \"strong\" | undefined",
-          "complexType": {
-            "original": "ChipBackground | undefined",
-            "resolved": "\"always-dark\" | \"bold\" | \"faint\" | \"medium\" | \"strong\" | undefined",
-            "references": {
-              "ChipBackground": {
-                "location": "local",
-                "path": "/home/runner/work/compomo/compomo/src/wc/components/Chip/Chip.tsx",
-                "id": "src/wc/components/Chip/Chip.tsx::ChipBackground"
-              }
-            }
-          },
-          "mutable": false,
-          "attr": "background",
-          "reflectToAttr": false,
-          "docs": "Surface context for interaction-fill tokens when the chip sits on a non-default surface.",
-          "docsTags": [],
-          "values": [
-            {
-              "value": "always-dark",
-              "type": "string"
-            },
-            {
-              "value": "bold",
-              "type": "string"
-            },
-            {
-              "value": "faint",
-              "type": "string"
-            },
-            {
-              "value": "medium",
-              "type": "string"
-            },
-            {
-              "value": "strong",
-              "type": "string"
-            },
-            {
-              "type": "undefined"
-            }
-          ],
-          "optional": false,
-          "required": false,
-          "getter": false,
-          "setter": false
-        },
         {
           "name": "isInactive",
           "type": "boolean",
@@ -4083,35 +4087,6 @@
           "getter": false,
           "setter": false
         },
-        {
-          "name": "removable",
-          "type": "boolean",
-          "complexType": {
-            "original": "boolean",
-            "resolved": "boolean",
-            "references": {}
-          },
-          "mutable": false,
-          "attr": "removable",
-          "reflectToAttr": false,
-          "docs": "When true (default), shows the trailing dismiss control.",
-          "docsTags": [
-            {
-              "name": "default",
-              "text": "true"
-            }
-          ],
-          "default": "true",
-          "values": [
-            {
-              "type": "boolean"
-            }
-          ],
-          "optional": false,
-          "required": false,
-          "getter": false,
-          "setter": false
-        },
         {
           "name": "removeLabel",
           "type": "string",
@@ -4305,6 +4280,71 @@
       "docsTags": [],
       "usage": {},
       "props": [
+        {
+          "name": "background",
+          "type": "\"always-dark\" | \"bold\" | \"faint\" | \"inverted\" | \"media\" | \"medium\" | \"navigation\" | \"strong\" | \"translucent\" | undefined",
+          "complexType": {
+            "original": "DividerBackground | undefined",
+            "resolved": "\"always-dark\" | \"bold\" | \"faint\" | \"inverted\" | \"media\" | \"medium\" | \"navigation\" | \"strong\" | \"translucent\" | undefined",
+            "references": {
+              "DividerBackground": {
+                "location": "local",
+                "path": "/home/runner/work/compomo/compomo/src/wc/components/Divider/Divider.tsx",
+                "id": "src/wc/components/Divider/Divider.tsx::DividerBackground"
+              }
+            }
+          },
+          "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",
+              "type": "string"
+            },
+            {
+              "value": "medium",
+              "type": "string"
+            },
+            {
+              "value": "navigation",
+              "type": "string"
+            },
+            {
+              "value": "strong",
+              "type": "string"
+            },
+            {
+              "value": "translucent",
+              "type": "string"
+            },
+            {
+              "type": "undefined"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
         {
           "name": "inset",
           "type": "\"none\" | \"space-000\" | \"space-012\" | \"space-025\" | \"space-050\" | \"space-075\" | \"space-100\" | \"space-125\" | \"space-150\" | \"space-175\" | \"space-200\" | \"space-250\" | \"space-300\" | \"space-400\" | \"space-600\" | \"space-800\" | string & {}",
@@ -4515,74 +4555,6 @@
           "required": false,
           "getter": false,
           "setter": false
-        },
-        {
-          "name": "surface",
-          "type": "\"always-dark\" | \"default\" | \"inverted\" | \"media\" | \"navigation\" | \"on-bold-background\" | \"on-medium-background\" | \"on-strong-background\" | \"on-translucent-background\"",
-          "complexType": {
-            "original": "DividerSurface",
-            "resolved": "\"always-dark\" | \"default\" | \"inverted\" | \"media\" | \"navigation\" | \"on-bold-background\" | \"on-medium-background\" | \"on-strong-background\" | \"on-translucent-background\"",
-            "references": {
-              "DividerSurface": {
-                "location": "local",
-                "path": "/home/runner/work/compomo/compomo/src/wc/components/Divider/Divider.tsx",
-                "id": "src/wc/components/Divider/Divider.tsx::DividerSurface"
-              }
-            }
-          },
-          "mutable": false,
-          "attr": "surface",
-          "reflectToAttr": false,
-          "docs": "Surface context so the divider uses the right TokoMo divider token.",
-          "docsTags": [
-            {
-              "name": "default",
-              "text": "'default'"
-            }
-          ],
-          "default": "'default'",
-          "values": [
-            {
-              "value": "always-dark",
-              "type": "string"
-            },
-            {
-              "value": "default",
-              "type": "string"
-            },
-            {
-              "value": "inverted",
-              "type": "string"
-            },
-            {
-              "value": "media",
-              "type": "string"
-            },
-            {
-              "value": "navigation",
-              "type": "string"
-            },
-            {
-              "value": "on-bold-background",
-              "type": "string"
-            },
-            {
-              "value": "on-medium-background",
-              "type": "string"
-            },
-            {
-              "value": "on-strong-background",
-              "type": "string"
-            },
-            {
-              "value": "on-translucent-background",
-              "type": "string"
-            }
-          ],
-          "optional": false,
-          "required": false,
-          "getter": false,
-          "setter": false
         }
       ],
       "methods": [],
@@ -4839,10 +4811,10 @@
       "props": [
         {
           "name": "color",
-          "type": "\"ai\" | \"bold-ai\" | \"bold-brand\" | \"bold-caution\" | \"bold-negative\" | \"bold-neutral\" | \"bold-positive\" | \"bold-warning\" | \"brand\" | \"caution\" | \"faint-ai\" | \"faint-brand\" | \"faint-caution\" | \"faint-negative\" | \"faint-neutral\" | \"faint-positive\" | \"faint-warning\" | \"guide\" | \"inherit\" | \"medium-ai\" | \"medium-brand\" | \"medium-caution\" | \"medium-negative\" | \"medium-neutral\" | \"medium-positive\" | \"medium-warning\" | \"negative\" | \"neutral\" | \"on-bold\" | \"on-strong\" | \"positive\" | \"primary\" | \"quaternary\" | \"secondary\" | \"strong-ai\" | \"strong-brand\" | \"strong-caution\" | \"strong-negative\" | \"strong-neutral\" | \"strong-positive\" | \"strong-warning\" | \"tertiary\" | \"warning\" | `var(--${string})` | undefined",
+          "type": "\"ai\" | \"bold-ai\" | \"bold-brand\" | \"bold-caution\" | \"bold-negative\" | \"bold-neutral\" | \"bold-positive\" | \"bold-warning\" | \"brand\" | \"caution\" | \"faint-ai\" | \"faint-brand\" | \"faint-caution\" | \"faint-negative\" | \"faint-neutral\" | \"faint-positive\" | \"faint-warning\" | \"guide\" | \"inherit\" | \"medium-ai\" | \"medium-brand\" | \"medium-caution\" | \"medium-negative\" | \"medium-neutral\" | \"medium-positive\" | \"medium-warning\" | \"negative\" | \"neutral\" | \"on-bold\" | \"on-strong\" | \"positive\" | \"primary\" | \"quaternary\" | \"secondary\" | \"strong-ai\" | \"strong-brand\" | \"strong-caution\" | \"strong-negative\" | \"strong-neutral\" | \"strong-positive\" | \"strong-warning\" | \"tertiary\" | \"warning\" | `var(--${string})`",
           "complexType": {
-            "original": "IconColor | undefined",
-            "resolved": "\"ai\" | \"bold-ai\" | \"bold-brand\" | \"bold-caution\" | \"bold-negative\" | \"bold-neutral\" | \"bold-positive\" | \"bold-warning\" | \"brand\" | \"caution\" | \"faint-ai\" | \"faint-brand\" | \"faint-caution\" | \"faint-negative\" | \"faint-neutral\" | \"faint-positive\" | \"faint-warning\" | \"guide\" | \"inherit\" | \"medium-ai\" | \"medium-brand\" | \"medium-caution\" | \"medium-negative\" | \"medium-neutral\" | \"medium-positive\" | \"medium-warning\" | \"negative\" | \"neutral\" | \"on-bold\" | \"on-strong\" | \"positive\" | \"primary\" | \"quaternary\" | \"secondary\" | \"strong-ai\" | \"strong-brand\" | \"strong-caution\" | \"strong-negative\" | \"strong-neutral\" | \"strong-positive\" | \"strong-warning\" | \"tertiary\" | \"warning\" | `var(--${string})` | undefined",
+            "original": "IconColor",
+            "resolved": "\"ai\" | \"bold-ai\" | \"bold-brand\" | \"bold-caution\" | \"bold-negative\" | \"bold-neutral\" | \"bold-positive\" | \"bold-warning\" | \"brand\" | \"caution\" | \"faint-ai\" | \"faint-brand\" | \"faint-caution\" | \"faint-negative\" | \"faint-neutral\" | \"faint-positive\" | \"faint-warning\" | \"guide\" | \"inherit\" | \"medium-ai\" | \"medium-brand\" | \"medium-caution\" | \"medium-negative\" | \"medium-neutral\" | \"medium-positive\" | \"medium-warning\" | \"negative\" | \"neutral\" | \"on-bold\" | \"on-strong\" | \"positive\" | \"primary\" | \"quaternary\" | \"secondary\" | \"strong-ai\" | \"strong-brand\" | \"strong-caution\" | \"strong-negative\" | \"strong-neutral\" | \"strong-positive\" | \"strong-warning\" | \"tertiary\" | \"warning\" | `var(--${string})`",
             "references": {
               "IconColor": {
                 "location": "local",
@@ -4855,7 +4827,13 @@
           "attr": "color",
           "reflectToAttr": false,
           "docs": "Semantic foreground color token, or a raw CSS var reference.",
-          "docsTags": [],
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "'inherit'"
+            }
+          ],
+          "default": "'inherit'",
           "values": [
             {
               "value": "ai",
@@ -5031,38 +5009,6 @@
             },
             {
               "type": "`var(--${string})`"
-            },
-            {
-              "type": "undefined"
-            }
-          ],
-          "optional": false,
-          "required": false,
-          "getter": false,
-          "setter": false
-        },
-        {
-          "name": "flag",
-          "type": "boolean",
-          "complexType": {
-            "original": "boolean",
-            "resolved": "boolean",
-            "references": {}
-          },
-          "mutable": false,
-          "attr": "flag",
-          "reflectToAttr": false,
-          "docs": "Set `true` to look up from the flag icon set instead of the system icon set.",
-          "docsTags": [
-            {
-              "name": "default",
-              "text": "false"
-            }
-          ],
-          "default": "false",
-          "values": [
-            {
-              "type": "boolean"
             }
           ],
           "optional": false,
@@ -5107,7 +5053,7 @@
           "mutable": false,
           "attr": "name",
           "reflectToAttr": false,
-          "docs": "Name of the system icon (e.g. `\"Gear\"`, `\"ArrowRight\"`) or flag (e.g. `\"US\"`)",
+          "docs": "Exact canonical IcoMo export name, including the `Flag` prefix for flags.",
           "docsTags": [
             {
               "name": "default",
@@ -5198,7 +5144,9 @@
         "ds-button-unfilled",
         "ds-chip",
         "ds-panel-nav",
-        "ds-select"
+        "ds-select",
+        "ds-tab-group",
+        "ds-tag"
       ],
       "dependencies": [],
       "dependencyGraph": {
@@ -5216,6 +5164,12 @@
         ],
         "ds-select": [
           "ds-icon"
+        ],
+        "ds-tab-group": [
+          "ds-icon"
+        ],
+        "ds-tag": [
+          "ds-icon"
         ]
       }
     },
@@ -5783,10 +5737,10 @@
       "props": [
         {
           "name": "color",
-          "type": "\"ai\" | \"bold-ai\" | \"bold-brand\" | \"bold-caution\" | \"bold-negative\" | \"bold-neutral\" | \"bold-positive\" | \"bold-warning\" | \"brand\" | \"caution\" | \"faint-ai\" | \"faint-brand\" | \"faint-caution\" | \"faint-negative\" | \"faint-neutral\" | \"faint-positive\" | \"faint-warning\" | \"guide\" | \"inherit\" | \"medium-ai\" | \"medium-brand\" | \"medium-caution\" | \"medium-negative\" | \"medium-neutral\" | \"medium-positive\" | \"medium-warning\" | \"negative\" | \"neutral\" | \"on-bold\" | \"on-strong\" | \"positive\" | \"primary\" | \"quaternary\" | \"secondary\" | \"strong-ai\" | \"strong-brand\" | \"strong-caution\" | \"strong-negative\" | \"strong-neutral\" | \"strong-positive\" | \"strong-warning\" | \"tertiary\" | \"warning\" | `var(--${string})` | undefined",
+          "type": "\"ai\" | \"bold-ai\" | \"bold-brand\" | \"bold-caution\" | \"bold-negative\" | \"bold-neutral\" | \"bold-positive\" | \"bold-warning\" | \"brand\" | \"caution\" | \"faint-ai\" | \"faint-brand\" | \"faint-caution\" | \"faint-negative\" | \"faint-neutral\" | \"faint-positive\" | \"faint-warning\" | \"guide\" | \"inherit\" | \"medium-ai\" | \"medium-brand\" | \"medium-caution\" | \"medium-negative\" | \"medium-neutral\" | \"medium-positive\" | \"medium-warning\" | \"negative\" | \"neutral\" | \"on-bold\" | \"on-strong\" | \"positive\" | \"primary\" | \"quaternary\" | \"secondary\" | \"strong-ai\" | \"strong-brand\" | \"strong-caution\" | \"strong-negative\" | \"strong-neutral\" | \"strong-positive\" | \"strong-warning\" | \"tertiary\" | \"warning\" | `var(--${string})`",
           "complexType": {
-            "original": "LoaderColor | undefined",
-            "resolved": "\"ai\" | \"bold-ai\" | \"bold-brand\" | \"bold-caution\" | \"bold-negative\" | \"bold-neutral\" | \"bold-positive\" | \"bold-warning\" | \"brand\" | \"caution\" | \"faint-ai\" | \"faint-brand\" | \"faint-caution\" | \"faint-negative\" | \"faint-neutral\" | \"faint-positive\" | \"faint-warning\" | \"guide\" | \"inherit\" | \"medium-ai\" | \"medium-brand\" | \"medium-caution\" | \"medium-negative\" | \"medium-neutral\" | \"medium-positive\" | \"medium-warning\" | \"negative\" | \"neutral\" | \"on-bold\" | \"on-strong\" | \"positive\" | \"primary\" | \"quaternary\" | \"secondary\" | \"strong-ai\" | \"strong-brand\" | \"strong-caution\" | \"strong-negative\" | \"strong-neutral\" | \"strong-positive\" | \"strong-warning\" | \"tertiary\" | \"warning\" | `var(--${string})` | undefined",
+            "original": "LoaderColor",
+            "resolved": "\"ai\" | \"bold-ai\" | \"bold-brand\" | \"bold-caution\" | \"bold-negative\" | \"bold-neutral\" | \"bold-positive\" | \"bold-warning\" | \"brand\" | \"caution\" | \"faint-ai\" | \"faint-brand\" | \"faint-caution\" | \"faint-negative\" | \"faint-neutral\" | \"faint-positive\" | \"faint-warning\" | \"guide\" | \"inherit\" | \"medium-ai\" | \"medium-brand\" | \"medium-caution\" | \"medium-negative\" | \"medium-neutral\" | \"medium-positive\" | \"medium-warning\" | \"negative\" | \"neutral\" | \"on-bold\" | \"on-strong\" | \"positive\" | \"primary\" | \"quaternary\" | \"secondary\" | \"strong-ai\" | \"strong-brand\" | \"strong-caution\" | \"strong-negative\" | \"strong-neutral\" | \"strong-positive\" | \"strong-warning\" | \"tertiary\" | \"warning\" | `var(--${string})`",
             "references": {
               "LoaderColor": {
                 "location": "local",
@@ -5799,7 +5753,13 @@
           "attr": "color",
           "reflectToAttr": false,
           "docs": "Semantic foreground color token, or a raw CSS var reference. Same tokens as `ds-icon`.",
-          "docsTags": [],
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "'inherit'"
+            }
+          ],
+          "default": "'inherit'",
           "values": [
             {
               "value": "ai",
@@ -5975,9 +5935,6 @@
             },
             {
               "type": "`var(--${string})`"
-            },
-            {
-              "type": "undefined"
             }
           ],
           "optional": false,
@@ -6079,9 +6036,19 @@
       "slots": [],
       "parts": [],
       "states": [],
-      "dependents": [],
+      "dependents": [
+        "ds-button-filled",
+        "ds-button-unfilled"
+      ],
       "dependencies": [],
-      "dependencyGraph": {}
+      "dependencyGraph": {
+        "ds-button-filled": [
+          "ds-loader"
+        ],
+        "ds-button-unfilled": [
+          "ds-loader"
+        ]
+      }
     },
     {
       "filePath": "src/wc/components/Menu/Menu.tsx",
@@ -6541,8 +6508,8 @@
             "references": {
               "ShellGradientPreset": {
                 "location": "import",
-                "path": "../../nav/shell-gradient-presets",
-                "id": "src/wc/nav/shell-gradient-presets.ts::ShellGradientPreset",
+                "path": "../../shell/shell-gradient-presets",
+                "id": "src/wc/shell/shell-gradient-presets.ts::ShellGradientPreset",
                 "referenceLocation": "ShellGradientPreset"
               }
             }
@@ -7360,8 +7327,8 @@
             "references": {
               "NavChromeStyle": {
                 "location": "import",
-                "path": "../../nav/nav-chrome",
-                "id": "src/wc/nav/nav-chrome.ts::NavChromeStyle",
+                "path": "../../shell/nav-chrome",
+                "id": "src/wc/shell/nav-chrome.ts::NavChromeStyle",
                 "referenceLocation": "NavChromeStyle"
               }
             }
@@ -7614,8 +7581,8 @@
             "references": {
               "ChromeTransitionDetail": {
                 "location": "import",
-                "path": "../../nav/chrome-transition",
-                "id": "src/wc/nav/chrome-transition.ts::ChromeTransitionDetail",
+                "path": "../../shell/chrome-transition",
+                "id": "src/wc/shell/chrome-transition.ts::ChromeTransitionDetail",
                 "referenceLocation": "ChromeTransitionDetail"
               }
             }
@@ -7635,8 +7602,8 @@
             "references": {
               "ChromeTransitionDetail": {
                 "location": "import",
-                "path": "../../nav/chrome-transition",
-                "id": "src/wc/nav/chrome-transition.ts::ChromeTransitionDetail",
+                "path": "../../shell/chrome-transition",
+                "id": "src/wc/shell/chrome-transition.ts::ChromeTransitionDetail",
                 "referenceLocation": "ChromeTransitionDetail"
               }
             }
@@ -7735,6 +7702,7 @@
           "ds-text"
         ],
         "ds-button-unfilled": [
+          "ds-loader",
           "ds-icon",
           "ds-badge",
           "ds-text"
@@ -7745,66 +7713,125 @@
       }
     },
     {
-      "filePath": "src/wc/components/PanelTools/PanelTools.tsx",
+      "filePath": "src/wc/components/PanelSubNav/PanelSubNav.tsx",
       "encapsulation": "scoped",
-      "tag": "ds-panel-tools",
+      "tag": "ds-panel-sub-nav",
       "docs": "",
       "docsTags": [],
       "usage": {},
       "props": [
         {
-          "name": "activeTool",
-          "type": "\"\" | \"activity\" | \"agents\" | \"help\" | \"messages\" | \"search\" | \"stacks\"",
+          "name": "ariaLabel",
+          "type": "null | string",
           "complexType": {
-            "original": "PanelToolsToolId | ''",
-            "resolved": "\"\" | \"activity\" | \"agents\" | \"help\" | \"messages\" | \"search\" | \"stacks\"",
-            "references": {
-              "PanelToolsToolId": {
-                "location": "import",
-                "path": "./panel-tools-types",
-                "id": "src/wc/components/PanelTools/panel-tools-types.ts::PanelToolsToolId",
-                "referenceLocation": "PanelToolsToolId"
-              }
-            }
+            "original": "string | null",
+            "resolved": "null | string",
+            "references": {}
           },
-          "mutable": true,
-          "attr": "active-tool",
-          "reflectToAttr": true,
-          "docs": "Active tool view — `search`, `agents`, `messages`, `stacks`, `activity`, or `help`.",
+          "mutable": false,
+          "attr": "aria-label",
+          "reflectToAttr": false,
+          "docs": "",
           "docsTags": [
             {
               "name": "default",
-              "text": "''"
+              "text": "null"
             }
           ],
-          "default": "''",
+          "default": "null",
           "values": [
             {
-              "type": "\"\""
+              "type": "null"
             },
             {
-              "value": "activity",
+              "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": "",
+          "docsTags": [],
+          "values": [
+            {
               "type": "string"
             },
             {
-              "value": "agents",
+              "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": "PanelSubNavBackground | undefined",
+            "resolved": "\"always-dark\" | \"bold\" | \"faint\" | \"inverted\" | \"media\" | \"medium\" | \"strong\" | \"translucent\" | undefined",
+            "references": {
+              "PanelSubNavBackground": {
+                "location": "local",
+                "path": "/home/runner/work/compomo/compomo/src/wc/components/PanelSubNav/PanelSubNav.tsx",
+                "id": "src/wc/components/PanelSubNav/PanelSubNav.tsx::PanelSubNavBackground"
+              }
+            }
+          },
+          "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": "help",
+              "value": "bold",
               "type": "string"
             },
             {
-              "value": "messages",
+              "value": "faint",
               "type": "string"
             },
             {
-              "value": "search",
+              "value": "inverted",
               "type": "string"
             },
             {
-              "value": "stacks",
+              "value": "media",
+              "type": "string"
+            },
+            {
+              "value": "medium",
+              "type": "string"
+            },
+            {
+              "value": "strong",
+              "type": "string"
+            },
+            {
+              "value": "translucent",
               "type": "string"
+            },
+            {
+              "type": "undefined"
             }
           ],
           "optional": false,
@@ -7814,22 +7841,22 @@
         },
         {
           "name": "items",
-          "type": "PanelToolsItem[]",
+          "type": "PanelSubNavItem[]",
           "complexType": {
-            "original": "PanelToolsItem[]",
-            "resolved": "PanelToolsItem[]",
+            "original": "PanelSubNavItem[]",
+            "resolved": "PanelSubNavItem[]",
             "references": {
-              "PanelToolsItem": {
+              "PanelSubNavItem": {
                 "location": "import",
-                "path": "./panel-tools-types",
-                "id": "src/wc/components/PanelTools/panel-tools-types.ts::PanelToolsItem",
-                "referenceLocation": "PanelToolsItem"
+                "path": "./panel-sub-nav-types",
+                "id": "src/wc/components/PanelSubNav/panel-sub-nav-types.ts::PanelSubNavItem",
+                "referenceLocation": "PanelSubNavItem"
               }
             }
           },
           "mutable": false,
           "reflectToAttr": false,
-          "docs": "Rail items rendered in the right column.\nSet via JS property: `el.items = [...]`. Replace the array reference to update.",
+          "docs": "Local panel tabs. Assign this array through the JavaScript property.\nReplace the array reference when items change.",
           "docsTags": [
             {
               "name": "default",
@@ -7839,7 +7866,7 @@
           "default": "[]",
           "values": [
             {
-              "type": "PanelToolsItem[]"
+              "type": "PanelSubNavItem[]"
             }
           ],
           "optional": false,
@@ -7848,17 +7875,17 @@
           "setter": false
         },
         {
-          "name": "itemsJson",
+          "name": "value",
           "type": "string",
           "complexType": {
             "original": "string",
             "resolved": "string",
             "references": {}
           },
-          "mutable": false,
-          "attr": "items-json",
+          "mutable": true,
+          "attr": "value",
           "reflectToAttr": false,
-          "docs": "JSON fallback for `items` — useful when framework bindings don't propagate arrays.",
+          "docs": "Required selected item id when enabled items exist. Keep synchronized with the visible panel.",
           "docsTags": [
             {
               "name": "default",
@@ -7875,29 +7902,200 @@
           "required": false,
           "getter": false,
           "setter": false
-        },
+        }
+      ],
+      "methods": [],
+      "events": [
         {
-          "name": "open",
-          "type": "boolean",
+          "event": "dsChange",
+          "detail": "string",
+          "bubbles": true,
           "complexType": {
-            "original": "boolean",
-            "resolved": "boolean",
+            "original": "string",
+            "resolved": "string",
             "references": {}
           },
-          "mutable": true,
-          "attr": "open",
-          "reflectToAttr": true,
-          "docs": "When false, only the icon rail is shown.",
-          "docsTags": [
-            {
-              "name": "default",
-              "text": "false"
-            }
-          ],
-          "default": "false",
-          "values": [
-            {
-              "type": "boolean"
+          "cancelable": true,
+          "composed": true,
+          "docs": "",
+          "docsTags": []
+        }
+      ],
+      "listeners": [
+        {
+          "event": "keydown",
+          "capture": false,
+          "passive": false
+        }
+      ],
+      "styles": [],
+      "slots": [],
+      "parts": [],
+      "states": [],
+      "dependents": [],
+      "dependencies": [
+        "ds-text"
+      ],
+      "dependencyGraph": {
+        "ds-panel-sub-nav": [
+          "ds-text"
+        ]
+      }
+    },
+    {
+      "filePath": "src/wc/components/PanelTools/PanelTools.tsx",
+      "encapsulation": "scoped",
+      "tag": "ds-panel-tools",
+      "docs": "",
+      "docsTags": [],
+      "usage": {},
+      "props": [
+        {
+          "name": "activeTool",
+          "type": "\"\" | \"activity\" | \"agents\" | \"help\" | \"messages\" | \"search\" | \"stacks\"",
+          "complexType": {
+            "original": "PanelToolsToolId | ''",
+            "resolved": "\"\" | \"activity\" | \"agents\" | \"help\" | \"messages\" | \"search\" | \"stacks\"",
+            "references": {
+              "PanelToolsToolId": {
+                "location": "import",
+                "path": "./panel-tools-types",
+                "id": "src/wc/components/PanelTools/panel-tools-types.ts::PanelToolsToolId",
+                "referenceLocation": "PanelToolsToolId"
+              }
+            }
+          },
+          "mutable": true,
+          "attr": "active-tool",
+          "reflectToAttr": true,
+          "docs": "Active tool view — `search`, `agents`, `messages`, `stacks`, `activity`, or `help`.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "''"
+            }
+          ],
+          "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"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "items",
+          "type": "PanelToolsItem[]",
+          "complexType": {
+            "original": "PanelToolsItem[]",
+            "resolved": "PanelToolsItem[]",
+            "references": {
+              "PanelToolsItem": {
+                "location": "import",
+                "path": "./panel-tools-types",
+                "id": "src/wc/components/PanelTools/panel-tools-types.ts::PanelToolsItem",
+                "referenceLocation": "PanelToolsItem"
+              }
+            }
+          },
+          "mutable": false,
+          "reflectToAttr": false,
+          "docs": "Rail items rendered in the right column.\nSet via JS property: `el.items = [...]`. Replace the array reference to update.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "[]"
+            }
+          ],
+          "default": "[]",
+          "values": [
+            {
+              "type": "PanelToolsItem[]"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "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",
+          "complexType": {
+            "original": "boolean",
+            "resolved": "boolean",
+            "references": {}
+          },
+          "mutable": true,
+          "attr": "open",
+          "reflectToAttr": true,
+          "docs": "When false, only the icon rail is shown.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "false"
+            }
+          ],
+          "default": "false",
+          "values": [
+            {
+              "type": "boolean"
             }
           ],
           "optional": false,
@@ -8068,8 +8266,8 @@
             "references": {
               "ChromeTransitionDetail": {
                 "location": "import",
-                "path": "../../nav/chrome-transition",
-                "id": "src/wc/nav/chrome-transition.ts::ChromeTransitionDetail",
+                "path": "../../shell/chrome-transition",
+                "id": "src/wc/shell/chrome-transition.ts::ChromeTransitionDetail",
                 "referenceLocation": "ChromeTransitionDetail"
               }
             }
@@ -8089,8 +8287,8 @@
             "references": {
               "ChromeTransitionDetail": {
                 "location": "import",
-                "path": "../../nav/chrome-transition",
-                "id": "src/wc/nav/chrome-transition.ts::ChromeTransitionDetail",
+                "path": "../../shell/chrome-transition",
+                "id": "src/wc/shell/chrome-transition.ts::ChromeTransitionDetail",
                 "referenceLocation": "ChromeTransitionDetail"
               }
             }
@@ -8143,6 +8341,7 @@
           "ds-text"
         ],
         "ds-button-unfilled": [
+          "ds-loader",
           "ds-icon",
           "ds-badge",
           "ds-text"
@@ -9331,6 +9530,71 @@
       "docsTags": [],
       "usage": {},
       "props": [
+        {
+          "name": "background",
+          "type": "\"always-dark\" | \"bold\" | \"faint\" | \"inverted\" | \"media\" | \"medium\" | \"navigation\" | \"strong\" | \"translucent\" | undefined",
+          "complexType": {
+            "original": "SkeletonBackground | undefined",
+            "resolved": "\"always-dark\" | \"bold\" | \"faint\" | \"inverted\" | \"media\" | \"medium\" | \"navigation\" | \"strong\" | \"translucent\" | undefined",
+            "references": {
+              "SkeletonBackground": {
+                "location": "local",
+                "path": "/home/runner/work/compomo/compomo/src/wc/components/Skeleton/Skeleton.tsx",
+                "id": "src/wc/components/Skeleton/Skeleton.tsx::SkeletonBackground"
+              }
+            }
+          },
+          "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",
+              "type": "string"
+            },
+            {
+              "value": "medium",
+              "type": "string"
+            },
+            {
+              "value": "navigation",
+              "type": "string"
+            },
+            {
+              "value": "strong",
+              "type": "string"
+            },
+            {
+              "value": "translucent",
+              "type": "string"
+            },
+            {
+              "type": "undefined"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
         {
           "name": "controlSize",
           "type": "\"md\" | \"sm\" | \"xs\"",
@@ -9496,96 +9760,28 @@
           "setter": false
         },
         {
-          "name": "surface",
-          "type": "\"always-dark\" | \"default\" | \"inverted\" | \"media\" | \"navigation\" | \"on-bold-background\" | \"on-medium-background\" | \"on-strong-background\" | \"on-translucent-background\"",
+          "name": "textVariant",
+          "type": "\"text-body-large\" | \"text-body-medium\" | \"text-body-small\" | \"text-caption\" | \"text-display-medium\" | \"text-display-small\" | \"text-title-large\" | \"text-title-medium\" | \"text-title-small\"",
           "complexType": {
-            "original": "SkeletonSurface",
-            "resolved": "\"always-dark\" | \"default\" | \"inverted\" | \"media\" | \"navigation\" | \"on-bold-background\" | \"on-medium-background\" | \"on-strong-background\" | \"on-translucent-background\"",
+            "original": "TextVariant",
+            "resolved": "\"text-body-large\" | \"text-body-medium\" | \"text-body-small\" | \"text-caption\" | \"text-display-medium\" | \"text-display-small\" | \"text-title-large\" | \"text-title-medium\" | \"text-title-small\"",
             "references": {
-              "SkeletonSurface": {
-                "location": "local",
-                "path": "/home/runner/work/compomo/compomo/src/wc/components/Skeleton/Skeleton.tsx",
-                "id": "src/wc/components/Skeleton/Skeleton.tsx::SkeletonSurface"
+              "TextVariant": {
+                "location": "import",
+                "path": "../Text/text-types",
+                "id": "src/wc/components/Text/text-types.ts::TextVariant",
+                "referenceLocation": "TextVariant"
               }
             }
           },
           "mutable": false,
-          "attr": "surface",
+          "attr": "text-variant",
           "reflectToAttr": false,
-          "docs": "Surface context used to select the matching foreground base and shimmer tokens.",
+          "docs": "Text metric recipe whose line-height defines the text canvas.",
           "docsTags": [
             {
               "name": "default",
-              "text": "'default'"
-            }
-          ],
-          "default": "'default'",
-          "values": [
-            {
-              "value": "always-dark",
-              "type": "string"
-            },
-            {
-              "value": "default",
-              "type": "string"
-            },
-            {
-              "value": "inverted",
-              "type": "string"
-            },
-            {
-              "value": "media",
-              "type": "string"
-            },
-            {
-              "value": "navigation",
-              "type": "string"
-            },
-            {
-              "value": "on-bold-background",
-              "type": "string"
-            },
-            {
-              "value": "on-medium-background",
-              "type": "string"
-            },
-            {
-              "value": "on-strong-background",
-              "type": "string"
-            },
-            {
-              "value": "on-translucent-background",
-              "type": "string"
-            }
-          ],
-          "optional": false,
-          "required": false,
-          "getter": false,
-          "setter": false
-        },
-        {
-          "name": "textVariant",
-          "type": "\"text-body-large\" | \"text-body-medium\" | \"text-body-small\" | \"text-caption\" | \"text-display-medium\" | \"text-display-small\" | \"text-title-large\" | \"text-title-medium\" | \"text-title-small\"",
-          "complexType": {
-            "original": "TextVariant",
-            "resolved": "\"text-body-large\" | \"text-body-medium\" | \"text-body-small\" | \"text-caption\" | \"text-display-medium\" | \"text-display-small\" | \"text-title-large\" | \"text-title-medium\" | \"text-title-small\"",
-            "references": {
-              "TextVariant": {
-                "location": "import",
-                "path": "../Text/text-types",
-                "id": "src/wc/components/Text/text-types.ts::TextVariant",
-                "referenceLocation": "TextVariant"
-              }
-            }
-          },
-          "mutable": false,
-          "attr": "text-variant",
-          "reflectToAttr": false,
-          "docs": "Text metric recipe whose line-height defines the text canvas.",
-          "docsTags": [
-            {
-              "name": "default",
-              "text": "'text-body-medium'"
+              "text": "'text-body-medium'"
             }
           ],
           "default": "'text-body-medium'",
@@ -10447,10 +10643,10 @@
         },
         {
           "name": "background",
-          "type": "\"always-dark\" | \"bold\" | \"faint\" | \"medium\" | \"strong\" | undefined",
+          "type": "\"always-dark\" | \"bold\" | \"faint\" | \"inverted\" | \"media\" | \"medium\" | \"strong\" | \"translucent\" | undefined",
           "complexType": {
             "original": "TabBackground | undefined",
-            "resolved": "\"always-dark\" | \"bold\" | \"faint\" | \"medium\" | \"strong\" | undefined",
+            "resolved": "\"always-dark\" | \"bold\" | \"faint\" | \"inverted\" | \"media\" | \"medium\" | \"strong\" | \"translucent\" | undefined",
             "references": {
               "TabBackground": {
                 "location": "local",
@@ -10478,368 +10674,27 @@
               "type": "string"
             },
             {
-              "value": "medium",
-              "type": "string"
-            },
-            {
-              "value": "strong",
-              "type": "string"
-            },
-            {
-              "type": "undefined"
-            }
-          ],
-          "optional": false,
-          "required": false,
-          "getter": false,
-          "setter": false
-        },
-        {
-          "name": "orientation",
-          "type": "\"horizontal\" | \"vertical\"",
-          "complexType": {
-            "original": "'horizontal' | 'vertical'",
-            "resolved": "\"horizontal\" | \"vertical\"",
-            "references": {}
-          },
-          "mutable": false,
-          "attr": "orientation",
-          "reflectToAttr": false,
-          "docs": "",
-          "docsTags": [
-            {
-              "name": "default",
-              "text": "'horizontal'"
-            }
-          ],
-          "default": "'horizontal'",
-          "values": [
-            {
-              "value": "horizontal",
-              "type": "string"
-            },
-            {
-              "value": "vertical",
-              "type": "string"
-            }
-          ],
-          "optional": false,
-          "required": false,
-          "getter": false,
-          "setter": false
-        },
-        {
-          "name": "tabs",
-          "type": "TabItem[]",
-          "complexType": {
-            "original": "TabItem[]",
-            "resolved": "TabItem[]",
-            "references": {
-              "TabItem": {
-                "location": "import",
-                "path": "./tab-item-utils",
-                "id": "src/wc/components/TabGroup/tab-item-utils.ts::TabItem",
-                "referenceLocation": "TabItem"
-              }
-            }
-          },
-          "mutable": false,
-          "reflectToAttr": false,
-          "docs": "",
-          "docsTags": [
-            {
-              "name": "default",
-              "text": "[]"
-            }
-          ],
-          "default": "[]",
-          "values": [
-            {
-              "type": "TabItem[]"
-            }
-          ],
-          "optional": false,
-          "required": false,
-          "getter": false,
-          "setter": false
-        },
-        {
-          "name": "value",
-          "type": "string",
-          "complexType": {
-            "original": "string",
-            "resolved": "string",
-            "references": {}
-          },
-          "mutable": true,
-          "attr": "value",
-          "reflectToAttr": false,
-          "docs": "",
-          "docsTags": [
-            {
-              "name": "default",
-              "text": "''"
-            }
-          ],
-          "default": "''",
-          "values": [
-            {
-              "type": "string"
-            }
-          ],
-          "optional": false,
-          "required": false,
-          "getter": false,
-          "setter": false
-        }
-      ],
-      "methods": [],
-      "events": [
-        {
-          "event": "dsChange",
-          "detail": "string",
-          "bubbles": true,
-          "complexType": {
-            "original": "string",
-            "resolved": "string",
-            "references": {}
-          },
-          "cancelable": true,
-          "composed": true,
-          "docs": "",
-          "docsTags": []
-        }
-      ],
-      "listeners": [
-        {
-          "event": "keydown",
-          "capture": false,
-          "passive": false
-        }
-      ],
-      "styles": [],
-      "slots": [],
-      "parts": [],
-      "states": [],
-      "dependents": [],
-      "dependencies": [
-        "ds-text",
-        "ds-badge"
-      ],
-      "dependencyGraph": {
-        "ds-tab-group": [
-          "ds-text",
-          "ds-badge"
-        ],
-        "ds-badge": [
-          "ds-text"
-        ]
-      }
-    },
-    {
-      "filePath": "src/wc/components/TabGroupNav/TabGroupNav.tsx",
-      "encapsulation": "scoped",
-      "tag": "ds-tab-group-nav",
-      "docs": "",
-      "docsTags": [],
-      "usage": {},
-      "props": [
-        {
-          "name": "ariaLabel",
-          "type": "null | string",
-          "complexType": {
-            "original": "string | null",
-            "resolved": "null | string",
-            "references": {}
-          },
-          "mutable": false,
-          "attr": "aria-label",
-          "reflectToAttr": false,
-          "docs": "",
-          "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": "",
-          "docsTags": [],
-          "values": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "undefined"
-            }
-          ],
-          "optional": false,
-          "required": false,
-          "getter": false,
-          "setter": false
-        },
-        {
-          "name": "background",
-          "type": "\"always-dark\" | \"bold\" | \"faint\" | \"medium\" | \"navigation\" | \"strong\" | undefined",
-          "complexType": {
-            "original": "TabGroupNavBackground | undefined",
-            "resolved": "\"always-dark\" | \"bold\" | \"faint\" | \"medium\" | \"navigation\" | \"strong\" | undefined",
-            "references": {
-              "TabGroupNavBackground": {
-                "location": "local",
-                "path": "/home/runner/work/compomo/compomo/src/wc/components/TabGroupNav/TabGroupNav.tsx",
-                "id": "src/wc/components/TabGroupNav/TabGroupNav.tsx::TabGroupNavBackground"
-              }
-            }
-          },
-          "mutable": false,
-          "attr": "background",
-          "reflectToAttr": false,
-          "docs": "",
-          "docsTags": [],
-          "values": [
-            {
-              "value": "always-dark",
-              "type": "string"
-            },
-            {
-              "value": "bold",
+              "value": "inverted",
               "type": "string"
             },
             {
-              "value": "faint",
+              "value": "media",
               "type": "string"
             },
             {
               "value": "medium",
               "type": "string"
             },
-            {
-              "value": "navigation",
-              "type": "string"
-            },
             {
               "value": "strong",
               "type": "string"
             },
             {
-              "type": "undefined"
-            }
-          ],
-          "optional": false,
-          "required": false,
-          "getter": false,
-          "setter": false
-        },
-        {
-          "name": "orientation",
-          "type": "\"horizontal\" | \"vertical\"",
-          "complexType": {
-            "original": "'horizontal' | 'vertical'",
-            "resolved": "\"horizontal\" | \"vertical\"",
-            "references": {}
-          },
-          "mutable": false,
-          "attr": "orientation",
-          "reflectToAttr": false,
-          "docs": "",
-          "docsTags": [
-            {
-              "name": "default",
-              "text": "'horizontal'"
-            }
-          ],
-          "default": "'horizontal'",
-          "values": [
-            {
-              "value": "horizontal",
+              "value": "translucent",
               "type": "string"
             },
             {
-              "value": "vertical",
-              "type": "string"
-            }
-          ],
-          "optional": false,
-          "required": false,
-          "getter": false,
-          "setter": false
-        },
-        {
-          "name": "rovingEnabled",
-          "type": "boolean",
-          "complexType": {
-            "original": "boolean",
-            "resolved": "boolean",
-            "references": {}
-          },
-          "mutable": false,
-          "attr": "roving-enabled",
-          "reflectToAttr": false,
-          "docs": "When `false`, every tab uses `tabindex=\"-1\"` (another chrome control owns the tab stop).",
-          "docsTags": [
-            {
-              "name": "default",
-              "text": "true"
-            }
-          ],
-          "default": "true",
-          "values": [
-            {
-              "type": "boolean"
-            }
-          ],
-          "optional": false,
-          "required": false,
-          "getter": false,
-          "setter": false
-        },
-        {
-          "name": "selectionFollowsFocus",
-          "type": "boolean",
-          "complexType": {
-            "original": "boolean",
-            "resolved": "boolean",
-            "references": {}
-          },
-          "mutable": false,
-          "attr": "selection-follows-focus",
-          "reflectToAttr": false,
-          "docs": "When `false`, arrow keys move focus only — Space/Enter (or click) commits selection.\nUsed by bar nav where each tab is a full page transition.",
-          "docsTags": [
-            {
-              "name": "default",
-              "text": "true"
-            }
-          ],
-          "default": "true",
-          "values": [
-            {
-              "type": "boolean"
+              "type": "undefined"
             }
           ],
           "optional": false,
@@ -10849,16 +10704,16 @@
         },
         {
           "name": "tabs",
-          "type": "TabItem[]",
+          "type": "TabGroupItem[]",
           "complexType": {
-            "original": "TabItem[]",
-            "resolved": "TabItem[]",
+            "original": "TabGroupItem[]",
+            "resolved": "TabGroupItem[]",
             "references": {
-              "TabItem": {
+              "TabGroupItem": {
                 "location": "import",
-                "path": "../TabGroup/tab-item-utils",
-                "id": "src/wc/components/TabGroup/tab-item-utils.ts::TabItem",
-                "referenceLocation": "TabItem"
+                "path": "./tab-item-utils",
+                "id": "src/wc/components/TabGroup/tab-item-utils.ts::TabGroupItem",
+                "referenceLocation": "TabGroupItem"
               }
             }
           },
@@ -10874,128 +10729,45 @@
           "default": "[]",
           "values": [
             {
-              "type": "TabItem[]"
-            }
-          ],
-          "optional": false,
-          "required": false,
-          "getter": false,
-          "setter": false
-        },
-        {
-          "name": "value",
-          "type": "string",
-          "complexType": {
-            "original": "string",
-            "resolved": "string",
-            "references": {}
-          },
-          "mutable": true,
-          "attr": "value",
-          "reflectToAttr": false,
-          "docs": "",
-          "docsTags": [
-            {
-              "name": "default",
-              "text": "''"
-            }
-          ],
-          "default": "''",
-          "values": [
-            {
-              "type": "string"
+              "type": "TabGroupItem[]"
             }
           ],
-          "optional": false,
-          "required": false,
-          "getter": false,
-          "setter": false
-        }
-      ],
-      "methods": [
-        {
-          "name": "focusFirstTab",
-          "returns": {
-            "type": "Promise<void>",
-            "docs": ""
-          },
-          "complexType": {
-            "signature": "() => Promise<void>",
-            "parameters": [],
-            "references": {
-              "Promise": {
-                "location": "global",
-                "id": "global::Promise"
-              }
-            },
-            "return": "Promise<void>"
-          },
-          "signature": "focusFirstTab() => Promise<void>",
-          "parameters": [],
-          "docs": "",
-          "docsTags": []
-        },
-        {
-          "name": "focusLastTab",
-          "returns": {
-            "type": "Promise<void>",
-            "docs": ""
-          },
-          "complexType": {
-            "signature": "() => Promise<void>",
-            "parameters": [],
-            "references": {
-              "Promise": {
-                "location": "global",
-                "id": "global::Promise"
-              }
-            },
-            "return": "Promise<void>"
-          },
-          "signature": "focusLastTab() => Promise<void>",
-          "parameters": [],
-          "docs": "",
-          "docsTags": []
-        },
-        {
-          "name": "focusTab",
-          "returns": {
-            "type": "Promise<void>",
-            "docs": ""
-          },
-          "complexType": {
-            "signature": "(id: string) => Promise<void>",
-            "parameters": [
-              {
-                "name": "id",
-                "type": "string",
-                "docs": ""
-              }
-            ],
-            "references": {
-              "Promise": {
-                "location": "global",
-                "id": "global::Promise"
-              },
-              "HTMLElement": {
-                "location": "global",
-                "id": "global::HTMLElement"
-              }
-            },
-            "return": "Promise<void>"
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "value",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
           },
-          "signature": "focusTab(id: string) => Promise<void>",
-          "parameters": [
+          "mutable": true,
+          "attr": "value",
+          "reflectToAttr": false,
+          "docs": "",
+          "docsTags": [
             {
-              "name": "id",
-              "type": "string",
-              "docs": ""
+              "name": "default",
+              "text": "''"
             }
           ],
-          "docs": "",
-          "docsTags": []
+          "default": "''",
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
         }
       ],
+      "methods": [],
       "events": [
         {
           "event": "dsChange",
@@ -11010,20 +10782,6 @@
           "composed": true,
           "docs": "",
           "docsTags": []
-        },
-        {
-          "event": "dsRovingExit",
-          "detail": "\"end\" | \"start\"",
-          "bubbles": true,
-          "complexType": {
-            "original": "'start' | 'end'",
-            "resolved": "\"end\" | \"start\"",
-            "references": {}
-          },
-          "cancelable": true,
-          "composed": true,
-          "docs": "Fired when arrow navigation reaches the first/last tab in manual selection mode.",
-          "docsTags": []
         }
       ],
       "listeners": [
@@ -11037,23 +10795,20 @@
       "slots": [],
       "parts": [],
       "states": [],
-      "dependents": [
-        "ds-bar-nav"
-      ],
+      "dependents": [],
       "dependencies": [
+        "ds-icon",
         "ds-text",
         "ds-badge"
       ],
       "dependencyGraph": {
-        "ds-tab-group-nav": [
+        "ds-tab-group": [
+          "ds-icon",
           "ds-text",
           "ds-badge"
         ],
         "ds-badge": [
           "ds-text"
-        ],
-        "ds-bar-nav": [
-          "ds-tab-group-nav"
         ]
       }
     },
@@ -11513,6 +11268,32 @@
       "docsTags": [],
       "usage": {},
       "props": [
+        {
+          "name": "ariaControls",
+          "type": "string | undefined",
+          "complexType": {
+            "original": "string | undefined",
+            "resolved": "string | undefined",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "aria-controls",
+          "reflectToAttr": false,
+          "docs": "ID of the menu controlled by an interactive Tag.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "undefined"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
         {
           "name": "contrast",
           "type": "\"bold\" | \"faint\" | \"medium\" | \"strong\"",
@@ -11561,6 +11342,64 @@
           "getter": false,
           "setter": false
         },
+        {
+          "name": "expanded",
+          "type": "boolean",
+          "complexType": {
+            "original": "boolean",
+            "resolved": "boolean",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "expanded",
+          "reflectToAttr": false,
+          "docs": "Controlled open state for the menu triggered by an interactive Tag.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "false"
+            }
+          ],
+          "default": "false",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "icon",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "icon",
+          "reflectToAttr": false,
+          "docs": "Canonical icon name rendered before the visible label.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "''"
+            }
+          ],
+          "default": "''",
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
         {
           "name": "intent",
           "type": "\"ai\" | \"brand\" | \"caution\" | \"negative\" | \"neutral\" | \"positive\" | \"warning\"",
@@ -11621,6 +11460,64 @@
           "getter": false,
           "setter": false
         },
+        {
+          "name": "interactive",
+          "type": "boolean",
+          "complexType": {
+            "original": "boolean",
+            "resolved": "boolean",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "interactive",
+          "reflectToAttr": false,
+          "docs": "Render a menu-trigger button with a fixed ChevronUpDown suffix.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "false"
+            }
+          ],
+          "default": "false",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "isInactive",
+          "type": "boolean",
+          "complexType": {
+            "original": "boolean",
+            "resolved": "boolean",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "is-inactive",
+          "reflectToAttr": false,
+          "docs": "Disable an interactive Tag and apply the shared inactive treatment.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "false"
+            }
+          ],
+          "default": "false",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
         {
           "name": "label",
           "type": "string",
@@ -11748,7 +11645,27 @@
         }
       ],
       "methods": [],
-      "events": [],
+      "events": [
+        {
+          "event": "dsClick",
+          "detail": "MouseEvent",
+          "bubbles": true,
+          "complexType": {
+            "original": "MouseEvent",
+            "resolved": "MouseEvent",
+            "references": {
+              "MouseEvent": {
+                "location": "global",
+                "id": "global::MouseEvent"
+              }
+            }
+          },
+          "cancelable": true,
+          "composed": true,
+          "docs": "Fired when the interactive Tag button is activated.",
+          "docsTags": []
+        }
+      ],
       "listeners": [],
       "styles": [],
       "slots": [],
@@ -11756,10 +11673,12 @@
       "states": [],
       "dependents": [],
       "dependencies": [
+        "ds-icon",
         "ds-text"
       ],
       "dependencyGraph": {
         "ds-tag": [
+          "ds-icon",
           "ds-text"
         ]
       }
@@ -11889,10 +11808,10 @@
         },
         {
           "name": "color",
-          "type": "\"ai\" | \"brand\" | \"caution\" | \"inherit\" | \"negative\" | \"on-bold\" | \"on-strong\" | \"positive\" | \"primary\" | \"secondary\" | \"tertiary\" | \"warning\" | `var(--${string})` | undefined",
+          "type": "\"ai\" | \"brand\" | \"caution\" | \"inherit\" | \"negative\" | \"on-bold\" | \"on-strong\" | \"positive\" | \"primary\" | \"secondary\" | \"tertiary\" | \"warning\" | `var(--${string})`",
           "complexType": {
-            "original": "TextColor | undefined",
-            "resolved": "\"ai\" | \"brand\" | \"caution\" | \"inherit\" | \"negative\" | \"on-bold\" | \"on-strong\" | \"positive\" | \"primary\" | \"secondary\" | \"tertiary\" | \"warning\" | `var(--${string})` | undefined",
+            "original": "TextColor",
+            "resolved": "\"ai\" | \"brand\" | \"caution\" | \"inherit\" | \"negative\" | \"on-bold\" | \"on-strong\" | \"positive\" | \"primary\" | \"secondary\" | \"tertiary\" | \"warning\" | `var(--${string})`",
             "references": {
               "TextColor": {
                 "location": "import",
@@ -11906,7 +11825,13 @@
           "attr": "color",
           "reflectToAttr": false,
           "docs": "",
-          "docsTags": [],
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "'inherit'"
+            }
+          ],
+          "default": "'inherit'",
           "values": [
             {
               "value": "ai",
@@ -11958,9 +11883,6 @@
             },
             {
               "type": "`var(--${string})`"
-            },
-            {
-              "type": "undefined"
             }
           ],
           "optional": false,
@@ -12137,10 +12059,10 @@
         },
         {
           "name": "lineTruncation",
-          "type": "\"none\" | 1 | 2 | 3 | 4 | 5",
+          "type": "\"1\" | \"2\" | \"3\" | \"4\" | \"5\" | \"none\" | 1 | 2 | 3 | 4 | 5",
           "complexType": {
             "original": "LineTruncation",
-            "resolved": "\"none\" | 1 | 2 | 3 | 4 | 5",
+            "resolved": "\"1\" | \"2\" | \"3\" | \"4\" | \"5\" | \"none\" | 1 | 2 | 3 | 4 | 5",
             "references": {
               "LineTruncation": {
                 "location": "import",
@@ -12162,6 +12084,26 @@
           ],
           "default": "'none'",
           "values": [
+            {
+              "value": "1",
+              "type": "string"
+            },
+            {
+              "value": "2",
+              "type": "string"
+            },
+            {
+              "value": "3",
+              "type": "string"
+            },
+            {
+              "value": "4",
+              "type": "string"
+            },
+            {
+              "value": "5",
+              "type": "string"
+            },
             {
               "value": "none",
               "type": "string"
@@ -12387,12 +12329,12 @@
         "ds-modal",
         "ds-pagination",
         "ds-panel-nav",
+        "ds-panel-sub-nav",
         "ds-panel-tools",
         "ds-radio-group",
         "ds-select",
         "ds-slider",
         "ds-tab-group",
-        "ds-tab-group-nav",
         "ds-table",
         "ds-tag",
         "ds-tooltip",
@@ -12448,6 +12390,9 @@
         "ds-panel-nav": [
           "ds-text"
         ],
+        "ds-panel-sub-nav": [
+          "ds-text"
+        ],
         "ds-panel-tools": [
           "ds-text"
         ],
@@ -12463,9 +12408,6 @@
         "ds-tab-group": [
           "ds-text"
         ],
-        "ds-tab-group-nav": [
-          "ds-text"
-        ],
         "ds-table": [
           "ds-text"
         ],
@@ -13020,7 +12962,7 @@
       "path": "src/wc/components/Badge/Badge.tsx"
     },
     "src/wc/components/Badge/Badge.tsx::BadgeSurface": {
-      "declaration": "export type BadgeSurface =\n  | 'default'\n  | 'primary'\n  | 'secondary'\n  | 'medium'\n  | 'bold'\n  | 'strong'\n  | 'navigation'\n  | 'always-dark';",
+      "declaration": "export type BadgeSurface =\n  | 'primary'\n  | 'secondary'\n  | 'faint'\n  | 'medium'\n  | 'bold'\n  | 'strong'\n  | 'translucent'\n  | 'inverted'\n  | 'media'\n  | 'navigation'\n  | 'always-dark';",
       "docstring": "",
       "path": "src/wc/components/Badge/Badge.tsx"
     },
@@ -13074,13 +13016,8 @@
       "docstring": "",
       "path": "src/wc/components/ButtonUnfilled/ButtonUnfilled.tsx"
     },
-    "src/wc/components/ButtonUnfilled/ButtonUnfilled.tsx::ButtonUnfilledOnBackgroundContrast": {
-      "declaration": "export type ButtonUnfilledOnBackgroundContrast = 'default' | 'medium' | 'bold' | 'strong';",
-      "docstring": "",
-      "path": "src/wc/components/ButtonUnfilled/ButtonUnfilled.tsx"
-    },
     "src/wc/components/ButtonUnfilled/ButtonUnfilled.tsx::ButtonUnfilledBackground": {
-      "declaration": "export type ButtonUnfilledBackground = 'always-dark' | 'navigation';",
+      "declaration": "export type ButtonUnfilledBackground =\n  | 'faint'\n  | 'medium'\n  | 'bold'\n  | 'strong'\n  | 'translucent'\n  | 'inverted'\n  | 'media'\n  | 'always-dark';",
       "docstring": "",
       "path": "src/wc/components/ButtonUnfilled/ButtonUnfilled.tsx"
     },
@@ -13124,18 +13061,13 @@
       "docstring": "",
       "path": "src/wc/components/Chip/Chip.tsx"
     },
-    "src/wc/components/Chip/Chip.tsx::ChipBackground": {
-      "declaration": "export type ChipBackground = 'faint' | 'medium' | 'bold' | 'strong' | 'always-dark';",
-      "docstring": "",
-      "path": "src/wc/components/Chip/Chip.tsx"
-    },
     "src/wc/components/Divider/Divider.tsx::DividerOrientation": {
       "declaration": "export type DividerOrientation = 'horizontal' | 'vertical';",
       "docstring": "",
       "path": "src/wc/components/Divider/Divider.tsx"
     },
-    "src/wc/components/Divider/Divider.tsx::DividerSurface": {
-      "declaration": "export type DividerSurface =\n  | 'default'\n  | 'on-bold-background'\n  | 'on-strong-background'\n  | 'on-medium-background'\n  | 'on-translucent-background'\n  | 'navigation'\n  | 'media'\n  | 'always-dark'\n  | 'inverted';",
+    "src/wc/components/Divider/Divider.tsx::DividerBackground": {
+      "declaration": "export type DividerBackground =\n  | 'faint'\n  | 'medium'\n  | 'bold'\n  | 'strong'\n  | 'translucent'\n  | 'inverted'\n  | 'media'\n  | 'navigation'\n  | 'always-dark';",
       "docstring": "",
       "path": "src/wc/components/Divider/Divider.tsx"
     },
@@ -13184,6 +13116,16 @@
       "docstring": "",
       "path": "src/wc/components/Modal/Modal.tsx"
     },
+    "src/wc/components/PanelSubNav/panel-sub-nav-types.ts::PanelSubNavItem": {
+      "declaration": "export interface PanelSubNavItem {\n  /** Unique tab id. Also used by the controlled panel's aria-labelledby. */\n  id: string;\n  label: string;\n  /** ID of the tabpanel controlled by this item. */\n  panelId: string;\n  /** Prevent selection and remove the item from keyboard navigation. */\n  isInactive?: boolean;\n}",
+      "docstring": "",
+      "path": "src/wc/components/PanelSubNav/panel-sub-nav-types.ts"
+    },
+    "src/wc/components/PanelSubNav/PanelSubNav.tsx::PanelSubNavBackground": {
+      "declaration": "export type PanelSubNavBackground =\n  | 'faint'\n  | 'medium'\n  | 'bold'\n  | 'strong'\n  | 'translucent'\n  | 'inverted'\n  | 'media'\n  | 'always-dark';",
+      "docstring": "",
+      "path": "src/wc/components/PanelSubNav/PanelSubNav.tsx"
+    },
     "src/wc/components/RadioGroup/RadioGroup.tsx::RadioOption": {
       "declaration": "export interface RadioOption {\n  label: string;\n  value: string;\n  isInactive?: boolean;\n}",
       "docstring": "",
@@ -13219,8 +13161,8 @@
       "docstring": "",
       "path": "src/wc/utils/control-text.ts"
     },
-    "src/wc/components/Skeleton/Skeleton.tsx::SkeletonSurface": {
-      "declaration": "export type SkeletonSurface =\n  | 'default'\n  | 'on-bold-background'\n  | 'on-strong-background'\n  | 'on-medium-background'\n  | 'on-translucent-background'\n  | 'navigation'\n  | 'media'\n  | 'always-dark'\n  | 'inverted';",
+    "src/wc/components/Skeleton/Skeleton.tsx::SkeletonBackground": {
+      "declaration": "export type SkeletonBackground =\n  | 'faint'\n  | 'medium'\n  | 'bold'\n  | 'strong'\n  | 'translucent'\n  | 'inverted'\n  | 'media'\n  | 'navigation'\n  | 'always-dark';",
       "docstring": "",
       "path": "src/wc/components/Skeleton/Skeleton.tsx"
     },
@@ -13229,21 +13171,16 @@
       "docstring": "",
       "path": "src/wc/components/Switch/Switch.tsx"
     },
-    "src/wc/components/TabGroup/tab-item-utils.ts::TabItem": {
-      "declaration": "export type TabItem = TabItemTab | TabItemDivider;",
+    "src/wc/components/TabGroup/tab-item-utils.ts::TabGroupItem": {
+      "declaration": "export type TabGroupItem =\n  | TabGroupItemLabel\n  | TabGroupItemIcon\n  | TabGroupItemIconLabel\n  | TabItemDivider;",
       "docstring": "",
       "path": "src/wc/components/TabGroup/tab-item-utils.ts"
     },
     "src/wc/components/TabGroup/TabGroup.tsx::TabBackground": {
-      "declaration": "export type TabBackground = 'faint' | 'medium' | 'bold' | 'strong' | 'always-dark';",
+      "declaration": "export type TabBackground =\n  | 'faint'\n  | 'medium'\n  | 'bold'\n  | 'strong'\n  | 'translucent'\n  | 'inverted'\n  | 'media'\n  | 'always-dark';",
       "docstring": "",
       "path": "src/wc/components/TabGroup/TabGroup.tsx"
     },
-    "src/wc/components/TabGroupNav/TabGroupNav.tsx::TabGroupNavBackground": {
-      "declaration": "export type TabGroupNavBackground = 'faint' | 'medium' | 'bold' | 'strong' | 'always-dark' | 'navigation';",
-      "docstring": "",
-      "path": "src/wc/components/TabGroupNav/TabGroupNav.tsx"
-    },
     "src/wc/components/Table/Table.tsx::TableColumn": {
       "declaration": "export interface TableColumn<T = unknown> {\n  id: string;\n  header: string;\n  accessorKey?: string;\n  accessor?: (row: T) => unknown;\n  sortable?: boolean;\n  align?: 'left' | 'right' | 'center';\n  width?: string | number;\n  minWidth?: string | number;\n  hide?: boolean;\n}",
       "docstring": "",
@@ -13285,7 +13222,7 @@
       "path": "src/wc/components/Text/text-types.ts"
     },
     "src/wc/components/Text/text-types.ts::LineTruncation": {
-      "declaration": "export type LineTruncation = 1 | 2 | 3 | 4 | 5 | 'none';",
+      "declaration": "export type LineTruncation = 1 | 2 | 3 | 4 | 5 | '1' | '2' | '3' | '4' | '5' | 'none';",
       "docstring": "",
       "path": "src/wc/components/Text/text-types.ts"
     },
@@ -13319,15 +13256,15 @@
       "docstring": "",
       "path": "src/wc/components/Tooltip/Tooltip.tsx"
     },
-    "src/wc/nav/nav-chrome.ts::NavChromeStyle": {
+    "src/wc/shell/nav-chrome.ts::NavChromeStyle": {
       "declaration": "export type NavChromeStyle = 'dashboard' | 'settings';",
       "docstring": "",
-      "path": "src/wc/nav/nav-chrome.ts"
+      "path": "src/wc/shell/nav-chrome.ts"
     },
-    "src/wc/nav/shell-gradient-presets.ts::ShellGradientPreset": {
+    "src/wc/shell/shell-gradient-presets.ts::ShellGradientPreset": {
       "declaration": "export type ShellGradientPreset = 'none' | 'cool' | 'neutral' | 'warm' | 'fresh';",
       "docstring": "",
-      "path": "src/wc/nav/shell-gradient-presets.ts"
+      "path": "src/wc/shell/shell-gradient-presets.ts"
     },
     "src/wc/components/BarNav/bar-nav-types.ts::BarNavTab": {
       "declaration": "export type TabItem = TabItemTab | TabItemDivider;",
@@ -13374,10 +13311,10 @@
       "docstring": "",
       "path": "src/wc/components/PanelNav/panel-nav-types.ts"
     },
-    "src/wc/nav/chrome-transition.ts::ChromeTransitionDetail": {
+    "src/wc/shell/chrome-transition.ts::ChromeTransitionDetail": {
       "declaration": "export interface ChromeTransitionDetail {\n  source: ChromeTransitionSource;\n  /** Panel-tools drawer motion direction; omitted for panel-nav. */\n  phase?: 'opening' | 'closing';\n}",
       "docstring": "",
-      "path": "src/wc/nav/chrome-transition.ts"
+      "path": "src/wc/shell/chrome-transition.ts"
     },
     "src/wc/components/PanelNav/panel-nav-types.ts::PanelNavUserActionDetail": {
       "declaration": "export interface PanelNavUserActionDetail {\n  anchor: HTMLElement;\n  /** Recommended `ds-menu` placement — spread onto external user menu instance. */\n  menuPlacement: MenuPlacement;\n}",