@oicl/openbridge-webcomponents 2.0.0-next.59 → 2.0.0-next.60

package/custom-elements.json

@@ -50551,6 +50551,74 @@
               "default": "false",
               "attribute": "hasIcon"
             },
+            {
+              "kind": "field",
+              "name": "treeMode",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Set by `obc-navigation-menu` in its Tree variant — renders the group as a tree row.",
+              "attribute": "treeMode"
+            },
+            {
+              "kind": "field",
+              "name": "treeBranches",
+              "type": {
+                "text": "TreeBranchType[]"
+              },
+              "default": "[]",
+              "description": "Indentation columns for tree mode, assigned by `obc-navigation-menu`.",
+              "attribute": "treeBranches"
+            },
+            {
+              "kind": "field",
+              "name": "terminalType",
+              "type": {
+                "text": "string"
+              },
+              "description": "Terminal type for the group header in the Tree variant — one of `regular`\n(default), `aggregated-header`, or `group-header`. No effect in flat variants.",
+              "attribute": "terminalType"
+            },
+            {
+              "kind": "field",
+              "name": "hasAlertBadge",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether a trailing alert counter badge is shown on the header (Tree variant only).",
+              "attribute": "hasAlertBadge"
+            },
+            {
+              "kind": "field",
+              "name": "alertCount",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "description": "The number shown in the header's alert badge when `hasAlertBadge` is true (Tree variant only).",
+              "attribute": "alertCount"
+            },
+            {
+              "kind": "field",
+              "name": "alertType",
+              "type": {
+                "text": "string"
+              },
+              "description": "The severity/type of the header's alert badge — one of the `obc-badge` types (Tree variant only).",
+              "attribute": "alertType"
+            },
+            {
+              "kind": "field",
+              "name": "defaultOpen",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether the group starts expanded. Useful for trees that open by default.",
+              "attribute": "defaultOpen"
+            },
             {
               "kind": "field",
               "name": "openContainer",
@@ -50568,6 +50636,16 @@
               },
               "privacy": "private"
             },
+            {
+              "kind": "field",
+              "name": "expanded",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "public",
+              "description": "Whether the group is currently open (its children are disclosed).",
+              "readonly": true
+            },
             {
               "kind": "method",
               "name": "onClickGroup",
@@ -50662,6 +50740,67 @@
               },
               "default": "false",
               "fieldName": "hasIcon"
+            },
+            {
+              "name": "treeMode",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Set by `obc-navigation-menu` in its Tree variant — renders the group as a tree row.",
+              "fieldName": "treeMode"
+            },
+            {
+              "name": "treeBranches",
+              "type": {
+                "text": "TreeBranchType[]"
+              },
+              "default": "[]",
+              "description": "Indentation columns for tree mode, assigned by `obc-navigation-menu`.",
+              "fieldName": "treeBranches"
+            },
+            {
+              "name": "terminalType",
+              "type": {
+                "text": "string"
+              },
+              "description": "Terminal type for the group header in the Tree variant — one of `regular`\n(default), `aggregated-header`, or `group-header`. No effect in flat variants.",
+              "fieldName": "terminalType"
+            },
+            {
+              "name": "hasAlertBadge",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether a trailing alert counter badge is shown on the header (Tree variant only).",
+              "fieldName": "hasAlertBadge"
+            },
+            {
+              "name": "alertCount",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "description": "The number shown in the header's alert badge when `hasAlertBadge` is true (Tree variant only).",
+              "fieldName": "alertCount"
+            },
+            {
+              "name": "alertType",
+              "type": {
+                "text": "string"
+              },
+              "description": "The severity/type of the header's alert badge — one of the `obc-badge` types (Tree variant only).",
+              "fieldName": "alertType"
+            },
+            {
+              "name": "defaultOpen",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether the group starts expanded. Useful for trees that open by default.",
+              "fieldName": "defaultOpen"
             }
           ],
           "superclass": {
@@ -50785,6 +50924,64 @@
               "default": "false",
               "attribute": "hasTrailingIcon"
             },
+            {
+              "kind": "field",
+              "name": "treeMode",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Set by `obc-navigation-menu` in its Tree variant — renders the row as a tree item.",
+              "attribute": "treeMode"
+            },
+            {
+              "kind": "field",
+              "name": "treeBranches",
+              "type": {
+                "text": "TreeBranchType[]"
+              },
+              "default": "[]",
+              "description": "Indentation columns for tree mode, assigned by `obc-navigation-menu`.",
+              "attribute": "treeBranches"
+            },
+            {
+              "kind": "field",
+              "name": "terminalType",
+              "type": {
+                "text": "string"
+              },
+              "description": "Terminal type for the row in the Tree variant — one of `regular` (default),\n`aggregated-header`, or `group-header`. Has no effect in the flat variants.",
+              "attribute": "terminalType"
+            },
+            {
+              "kind": "field",
+              "name": "hasAlertBadge",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether a trailing alert counter badge is shown (Tree variant only).",
+              "attribute": "hasAlertBadge"
+            },
+            {
+              "kind": "field",
+              "name": "alertCount",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "description": "The number shown in the alert badge when `hasAlertBadge` is true (Tree variant only).",
+              "attribute": "alertCount"
+            },
+            {
+              "kind": "field",
+              "name": "alertType",
+              "type": {
+                "text": "string"
+              },
+              "description": "The severity/type of the alert badge — one of the `obc-badge` types (Tree variant only).",
+              "attribute": "alertType"
+            },
             {
               "kind": "field",
               "name": "anchorElement",
@@ -50793,6 +50990,14 @@
               },
               "privacy": "private"
             },
+            {
+              "kind": "field",
+              "name": "treeItemElement",
+              "type": {
+                "text": "HTMLElement | undefined"
+              },
+              "privacy": "private"
+            },
             {
               "kind": "method",
               "name": "onClick",
@@ -50923,6 +51128,58 @@
               },
               "default": "false",
               "fieldName": "hasTrailingIcon"
+            },
+            {
+              "name": "treeMode",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Set by `obc-navigation-menu` in its Tree variant — renders the row as a tree item.",
+              "fieldName": "treeMode"
+            },
+            {
+              "name": "treeBranches",
+              "type": {
+                "text": "TreeBranchType[]"
+              },
+              "default": "[]",
+              "description": "Indentation columns for tree mode, assigned by `obc-navigation-menu`.",
+              "fieldName": "treeBranches"
+            },
+            {
+              "name": "terminalType",
+              "type": {
+                "text": "string"
+              },
+              "description": "Terminal type for the row in the Tree variant — one of `regular` (default),\n`aggregated-header`, or `group-header`. Has no effect in the flat variants.",
+              "fieldName": "terminalType"
+            },
+            {
+              "name": "hasAlertBadge",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether a trailing alert counter badge is shown (Tree variant only).",
+              "fieldName": "hasAlertBadge"
+            },
+            {
+              "name": "alertCount",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "description": "The number shown in the alert badge when `hasAlertBadge` is true (Tree variant only).",
+              "fieldName": "alertCount"
+            },
+            {
+              "name": "alertType",
+              "type": {
+                "text": "string"
+              },
+              "description": "The severity/type of the alert badge — one of the `obc-badge` types (Tree variant only).",
+              "fieldName": "alertType"
             }
           ],
           "superclass": {
@@ -50958,7 +51215,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "`<obc-navigation-menu>` – A flexible, slot-based navigation menu component for organizing primary and secondary navigation items.\n\nThis component provides a vertical navigation structure supporting groups, flyouts, and footer sections. It adapts to various layouts and device sizes via its `variant` and `smallScreen` properties. Items and groups are provided via slots, allowing for icons, labels, and nested navigation hierarchies.\n\nAppears as a sidebar or persistent navigation panel, supporting both icon-only and full-label modes. Designed for use as the main navigation in applications, dashboards, or any interface requiring structured navigation.\n\n## Features\n\n- **Variants:**\n  - **Full:** Displays both icons and labels for all navigation items (default).\n  - **IconOnly:** Shows only icons for a compact appearance. *Should only be used when no navigation items have sub-items or flyouts.*\n  - **IconOnlyLarge:** Icon-only mode that supports flyouts/submenus. Use when navigation contains groups or nested items.\n  - **Compact:** Reduces padding and overall width for a space-saving layout.\n- **Responsive Layout:**\n  - `smallScreen` property adapts the footer and logo layout for smaller viewports.\n- **Slot-based Content:**\n  - `main` slot for primary navigation items and groups.\n  - `footer` slot for secondary actions or links.\n  - `logo` slot for branding or logo placement (position adapts based on variant and screen size).\n- **Nested Navigation:**\n  - Supports nested groups and flyouts via `<obc-navigation-item-group>`.\n- **Automatic Variant Propagation:**\n  - Child items and groups automatically receive the correct variant for consistent appearance.\n- **Dynamic Content Handling:**\n  - Reacts to dynamic addition/removal of items and groups, updating layout and variants as needed.\n- **Interaction:**\n  - Clicking a navigation item closes all open groups/flyouts for streamlined navigation.\n\n## Usage Guidelines\n\nUse `<obc-navigation-menu>` as the main navigation container in your application layout. Place navigation items and groups in the `main` slot for primary navigation, and use the `footer` slot for secondary actions (such as settings or help). The `logo` slot is intended for branding and is positioned according to the selected variant and screen size.\n\n- Use the `Full` variant for standard navigation with both icons and labels.\n- Use `IconOnly` only when there are no nested groups or flyouts; otherwise, use `IconOnlyLarge` for icon-only navigation with flyout support.\n- The `Compact` variant is suitable for layouts with limited space or when a minimal navigation appearance is desired.\n- Set `smallScreen` to `true` to optimize the layout for smaller devices or responsive breakpoints.\n\n**TODO(designer):** Provide additional guidance on when to use each variant and recommended slot content for best usability.\n\n## Slots\n\n| Slot Name | Renders When... | Purpose |\n|-----------|----------------|---------|\n| main      | Always         | Primary navigation items and groups. |\n| footer    | Always         | Secondary navigation items (e.g., settings, help). |\n| logo      | Always         | Branding/logo area (position varies by variant and screen size). |\n\nPlace `<obc-navigation-item>`, `<obc-navigation-item-group>`, or other suitable elements in these slots. For icons, use `<obi-placeholder>`, `<obi-applications>`, or other OpenBridge icon components in the `icon` slot of each navigation item.\n\n## Properties\n\n- `variant` (`ObcNavigationMenuVariant`): Controls the visual style and layout of the menu. Default is `Full`.\n- `smallScreen` (`boolean`): When `true`, adapts the layout for small screens (e.g., moves logo into the footer area).\n\n## Best Practices and Constraints\n\n- Only use the `IconOnly` variant when there are no navigation items with sub-items or flyouts. Use `IconOnlyLarge` if your navigation includes groups or nested items.\n- Place only navigation-related components in the `main` and `footer` slots for clarity and accessibility.\n- For best accessibility, ensure each navigation item has a clear label and, if using icons, a suitable `aria-label` or accessible name.\n- Avoid placing interactive elements other than navigation items/groups in the `main` or `footer` slots.\n\n## Example\n\n```html\n<obc-navigation-menu variant=\"full\">\n  <obc-navigation-item-group slot=\"main\" label=\"Apps\">\n    <obi-applications slot=\"icon\"></obi-applications>\n    <obc-navigation-item label=\"Sub item 1\" hasIcon href=\"#\">\n      <obi-placeholder slot=\"icon\"></obi-placeholder>\n    </obc-navigation-item>\n  </obc-navigation-item-group>\n  <obc-navigation-item slot=\"footer\" label=\"Settings\" hasIcon href=\"#\">\n    <obi-settings-iec slot=\"icon\"></obi-settings-iec>\n  </obc-navigation-item>\n  <obc-vendor-button imageSrc=\"/companylogo-day.png\" alt=\"logo\" slot=\"logo\"></obc-vendor-button>\n</obc-navigation-menu>\n```\n\nIn this example, the menu displays a group with sub-items in the main navigation, several footer actions, and a logo.",
+          "description": "`<obc-navigation-menu>` – A flexible, slot-based navigation menu component for organizing primary and secondary navigation items.\n\nThis component provides a vertical navigation structure supporting groups, flyouts, and footer sections. It adapts to various layouts and device sizes via its `variant` and `smallScreen` properties. Items and groups are provided via slots, allowing for icons, labels, and nested navigation hierarchies.\n\nAppears as a sidebar or persistent navigation panel, supporting both icon-only and full-label modes. Designed for use as the main navigation in applications, dashboards, or any interface requiring structured navigation.\n\n## Features\n\n- **Variants:**\n  - **Full:** Displays both icons and labels for all navigation items (default).\n  - **IconOnly:** Shows only icons for a compact appearance. *Should only be used when no navigation items have sub-items or flyouts.*\n  - **IconOnlyLarge:** Icon-only mode that supports flyouts/submenus. Use when navigation contains groups or nested items.\n  - **Compact:** Reduces padding and overall width for a space-saving layout.\n  - **Tree:** Renders the same `obc-navigation-item` / `obc-navigation-item-group`\n    markup as a hierarchical tree. Groups expand inline (instead of as flyouts),\n    rows are indented by depth, multiple branches can stay open at once, and the\n    tree-row presentation (alert badge, terminal marker) is available via the\n    items' `hasAlertBadge`/`alertCount`/`alertType`/`terminalType` properties.\n- **Responsive Layout:**\n  - `smallScreen` property adapts the footer and logo layout for smaller viewports.\n- **Slot-based Content:**\n  - `main` slot for primary navigation items and groups.\n  - `footer` slot for secondary actions or links.\n  - `logo` slot for branding or logo placement (position adapts based on variant and screen size).\n- **Nested Navigation:**\n  - Supports nested groups and flyouts via `<obc-navigation-item-group>`.\n- **Automatic Variant Propagation:**\n  - Child items and groups automatically receive the correct variant for consistent appearance.\n- **Dynamic Content Handling:**\n  - Reacts to dynamic addition/removal of items and groups, updating layout and variants as needed.\n- **Interaction:**\n  - Clicking a navigation item closes all open groups/flyouts for streamlined navigation.\n\n## Usage Guidelines\n\nUse `<obc-navigation-menu>` as the main navigation container in your application layout. Place navigation items and groups in the `main` slot for primary navigation, and use the `footer` slot for secondary actions (such as settings or help). The `logo` slot is intended for branding and is positioned according to the selected variant and screen size.\n\n- Use the `Full` variant for standard navigation with both icons and labels.\n- Use `IconOnly` only when there are no nested groups or flyouts; otherwise, use `IconOnlyLarge` for icon-only navigation with flyout support.\n- The `Compact` variant is suitable for layouts with limited space or when a minimal navigation appearance is desired.\n- Use the `Tree` variant for hierarchical navigation (file trees, nested\n  sections). The existing item/group markup is reused unchanged — only the\n  `variant` changes. Footer and logo slots remain flat. Mark a group with\n  `defaultOpen` to have it start expanded.\n- Set `smallScreen` to `true` to optimize the layout for smaller devices or responsive breakpoints.\n\n**TODO(designer):** Provide additional guidance on when to use each variant and recommended slot content for best usability.\n\n## Slots\n\n| Slot Name | Renders When... | Purpose |\n|-----------|----------------|---------|\n| main      | Always         | Primary navigation items and groups. |\n| footer    | Always         | Secondary navigation items (e.g., settings, help). |\n| logo      | Always         | Branding/logo area (position varies by variant and screen size). |\n\nPlace `<obc-navigation-item>`, `<obc-navigation-item-group>`, or other suitable elements in these slots. For icons, use `<obi-placeholder>`, `<obi-applications>`, or other OpenBridge icon components in the `icon` slot of each navigation item.\n\n## Properties\n\n- `variant` (`ObcNavigationMenuVariant`): Controls the visual style and layout of the menu. Default is `Full`.\n- `smallScreen` (`boolean`): When `true`, adapts the layout for small screens (e.g., moves logo into the footer area).\n\n## Best Practices and Constraints\n\n- Only use the `IconOnly` variant when there are no navigation items with sub-items or flyouts. Use `IconOnlyLarge` if your navigation includes groups or nested items.\n- Place only navigation-related components in the `main` and `footer` slots for clarity and accessibility.\n- For best accessibility, ensure each navigation item has a clear label and, if using icons, a suitable `aria-label` or accessible name.\n- Avoid placing interactive elements other than navigation items/groups in the `main` or `footer` slots.\n\n## Example\n\n```html\n<obc-navigation-menu variant=\"full\">\n  <obc-navigation-item-group slot=\"main\" label=\"Apps\">\n    <obi-applications slot=\"icon\"></obi-applications>\n    <obc-navigation-item label=\"Sub item 1\" hasIcon href=\"#\">\n      <obi-placeholder slot=\"icon\"></obi-placeholder>\n    </obc-navigation-item>\n  </obc-navigation-item-group>\n  <obc-navigation-item slot=\"footer\" label=\"Settings\" hasIcon href=\"#\">\n    <obi-settings-iec slot=\"icon\"></obi-settings-iec>\n  </obc-navigation-item>\n  <obc-vendor-button imageSrc=\"/companylogo-day.png\" alt=\"logo\" slot=\"logo\"></obc-vendor-button>\n</obc-navigation-menu>\n```\n\nIn this example, the menu displays a group with sub-items in the main navigation, several footer actions, and a logo.",
           "name": "ObcNavigationMenu",
           "slots": [
             {
@@ -50981,7 +51238,7 @@
               "type": {
                 "text": "ObcNavigationMenuVariant"
               },
-              "description": "Controls the visual style and layout of the navigation menu.\n\n- `full`: Standard menu with icons and labels (default).\n- `icon-only`: Compact, icon-only menu (use only when no flyouts/groups are present).\n- `icon-only-large`: Icon-only menu supporting flyouts/groups.\n- `compact`: Minimal, space-saving menu.",
+              "description": "Controls the visual style and layout of the navigation menu.\n\n- `full`: Standard menu with icons and labels (default).\n- `icon-only`: Compact, icon-only menu (use only when no flyouts/groups are present).\n- `icon-only-large`: Icon-only menu supporting flyouts/groups.\n- `compact`: Minimal, space-saving menu.\n- `tree`: Hierarchical tree — groups expand inline and rows are indented by depth.",
               "attribute": "variant"
             },
             {
@@ -51021,6 +51278,68 @@
               "privacy": "private",
               "default": "false"
             },
+            {
+              "kind": "field",
+              "name": "treeNavigator",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new TreeRovingNavigator<NavTreeRow>(this, { getRows: () => this.treeRootRows(), childRows: (row) => this.treeChildRows(row), isGroup: (row) => isNavGroup(row), // Read the group's own synchronous open state, not the shadow header's // attribute (which lags a render tick behind a keyboard expand/collapse). isExpanded: (row) => isNavGroup(row) && row.expanded, setExpanded: (row, expanded) => { if (!isNavGroup(row)) return; if (expanded) row.open(); else row.close(); }, innerItem: (row) => this.treeInnerItem(row), } satisfies TreeRovingAdapter<NavTreeRow>)",
+              "description": "Roving-tabindex + arrow-key navigation for the Tree variant, sharing the\nnavigator that drives `obc-tree-navigation`. Engaged only while\n`variant === Tree` (see `onTreeKeydown`)."
+            },
+            {
+              "kind": "method",
+              "name": "treeRootRows",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "NavTreeRow[]"
+                }
+              },
+              "description": "Top-level tree rows of the main slot (mirrors `assignTreeBranches`'s filter)."
+            },
+            {
+              "kind": "method",
+              "name": "treeChildRows",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "NavTreeRow[]"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "row",
+                  "type": {
+                    "text": "NavTreeRow"
+                  }
+                }
+              ],
+              "description": "Direct tree-row children of a row, in document order."
+            },
+            {
+              "kind": "method",
+              "name": "treeInnerItem",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "ObcTreeNavigationItem | null"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "row",
+                  "type": {
+                    "text": "NavTreeRow"
+                  }
+                }
+              ],
+              "description": "The inline `obc-tree-navigation-item` a tree-mode row renders in its shadow root."
+            },
+            {
+              "kind": "field",
+              "name": "onTreeKeydown",
+              "privacy": "private"
+            },
             {
               "kind": "method",
               "name": "findAllElements",
@@ -51155,13 +51474,13 @@
             },
             {
               "kind": "method",
-              "name": "setupItems",
-              "privacy": "private"
-            },
-            {
-              "kind": "method",
-              "name": "setHugToGroups",
+              "name": "assignTreeBranches",
               "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
               "parameters": [
                 {
                   "name": "el",
@@ -51170,29 +51489,71 @@
                   }
                 },
                 {
-                  "name": "hug",
+                  "name": "depth",
                   "type": {
-                    "text": "boolean"
+                    "text": "number"
                   }
                 }
               ]
-            }
-          ],
-          "attributes": [
-            {
-              "name": "variant",
-              "type": {
-                "text": "ObcNavigationMenuVariant"
-              },
-              "description": "Controls the visual style and layout of the navigation menu.\n\n- `full`: Standard menu with icons and labels (default).\n- `icon-only`: Compact, icon-only menu (use only when no flyouts/groups are present).\n- `icon-only-large`: Icon-only menu supporting flyouts/groups.\n- `compact`: Minimal, space-saving menu.",
-              "fieldName": "variant"
             },
             {
-              "name": "flyoutVariant",
-              "type": {
-                "text": "ObcNavigationMenuFlyoutVariant"
-              },
-              "description": "Visual variant of the flyout.\nOne of `Full` (default) or `Compact`.",
+              "kind": "method",
+              "name": "clearTreeMode",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "el",
+                  "type": {
+                    "text": "Element"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "setupItems",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "setHugToGroups",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "el",
+                  "type": {
+                    "text": "Element"
+                  }
+                },
+                {
+                  "name": "hug",
+                  "type": {
+                    "text": "boolean"
+                  }
+                }
+              ]
+            }
+          ],
+          "attributes": [
+            {
+              "name": "variant",
+              "type": {
+                "text": "ObcNavigationMenuVariant"
+              },
+              "description": "Controls the visual style and layout of the navigation menu.\n\n- `full`: Standard menu with icons and labels (default).\n- `icon-only`: Compact, icon-only menu (use only when no flyouts/groups are present).\n- `icon-only-large`: Icon-only menu supporting flyouts/groups.\n- `compact`: Minimal, space-saving menu.\n- `tree`: Hierarchical tree — groups expand inline and rows are indented by depth.",
+              "fieldName": "variant"
+            },
+            {
+              "name": "flyoutVariant",
+              "type": {
+                "text": "ObcNavigationMenuFlyoutVariant"
+              },
+              "description": "Visual variant of the flyout.\nOne of `Full` (default) or `Compact`.",
               "fieldName": "flyoutVariant"
             },
             {
@@ -66375,6 +66736,824 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/tree-navigation-group/tree-navigation-group.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "`<obc-tree-navigation-group>` – An expandable parent row in a tree-navigation\nstructure: a header row with an expand/collapse chevron, plus a slot for the\nchild rows it discloses.\n\nA group renders an `<obc-tree-navigation-item>` header (carrying its own label,\nicon, terminal type, and alert badge) followed by its slotted children. When\nplaced inside `<obc-tree-navigation>`, the container computes and assigns the\n`branches` guide lines for every row automatically from each row's position —\na group does not need its depth configured by hand.\n\nThe group manages only its own open/closed state and forwards header presentation\nto its internal header item. It does not draw guide lines itself; that is the\ncontainer's responsibility (see `<obc-tree-navigation>`).\n\n## Features\n- **Disclosure:** A chevron in the header toggles the slotted children. The open\n  state is held in `expanded` and reflected so the container and CSS can react.\n- **Header presentation:** `label`, the `icon` slot, `terminalType`, and the\n  alert badge (`hasAlertBadge`, `alertCount`, `alertType`) are forwarded to the\n  header row.\n- **Selection:** `checked` marks the group's header as the current item.\n- **Automatic guides:** Inside `<obc-tree-navigation>`, the header's `branches`\n  are assigned by the container; nested groups continue the guide columns down.\n\n## Usage Guidelines\n- Nest `<obc-tree-navigation-item>` (leaves) and further `<obc-tree-navigation-group>`\n  elements as children to build the hierarchy.\n- Always place groups and items inside an `<obc-tree-navigation>` container so the\n  guide lines are computed; using a group standalone draws a header with no guides.\n- Provide a header icon via the `icon` slot (forwarded to the header row).\n\n## Slots\n\n| Slot Name | Renders When...          | Purpose                                                      |\n|-----------|--------------------------|--------------------------------------------------------------|\n| icon      | `hasIcon` is true        | Leading icon for the group header row.                       |\n| (default) | Always                   | Child rows (`obc-tree-navigation-item` / `-group`).          |",
+          "name": "ObcTreeNavigationGroup",
+          "slots": [
+            {
+              "description": "Leading icon for the group header (shown when `hasIcon` is true).",
+              "name": "icon"
+            },
+            {
+              "description": "Child rows disclosed when the group is expanded.",
+              "name": ""
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "label",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Group'",
+              "description": "The text label displayed for the group header row.",
+              "attribute": "label"
+            },
+            {
+              "kind": "field",
+              "name": "branches",
+              "type": {
+                "text": "TreeBranchType[]"
+              },
+              "default": "[]",
+              "description": "Guide line to draw for each ancestor level of the header row. Normally set by\nthe parent `<obc-tree-navigation>` container from the group's position; only\nset it manually when using a group outside the container.",
+              "attribute": "branches"
+            },
+            {
+              "kind": "field",
+              "name": "expanded",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether the group is expanded, disclosing its children. Rotates the chevron.",
+              "attribute": "expanded",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "checked",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether the group header is the current selection.",
+              "attribute": "checked",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Disables the group header, removing it from the tab order and dimming it.",
+              "attribute": "disabled",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "hasIcon",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "true",
+              "description": "Whether the group header shows a leading icon (provided via the `icon` slot)."
+            },
+            {
+              "kind": "field",
+              "name": "terminalType",
+              "type": {
+                "text": "string"
+              },
+              "description": "Terminal type for the header row, controlling the alert-header marker shown in\nthe terminal. One of `regular` (default), `aggregated-header`, or `group-header`.",
+              "attribute": "terminalType"
+            },
+            {
+              "kind": "field",
+              "name": "hasAlertBadge",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether a trailing alert counter badge is shown on the header row.",
+              "attribute": "hasAlertBadge"
+            },
+            {
+              "kind": "field",
+              "name": "alertCount",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "description": "The number shown in the header's alert badge when `hasAlertBadge` is true.",
+              "attribute": "alertCount"
+            },
+            {
+              "kind": "field",
+              "name": "alertType",
+              "type": {
+                "text": "string"
+              },
+              "description": "The severity/type of the header's alert badge. One of the `obc-badge` types (default `alarm`).",
+              "attribute": "alertType"
+            },
+            {
+              "kind": "field",
+              "name": "href",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "The URL to navigate to when the header is activated. If set, the header row\nrenders as a link; otherwise it acts as a button.",
+              "attribute": "href"
+            },
+            {
+              "kind": "field",
+              "name": "headerItem",
+              "type": {
+                "text": "ObcTreeNavigationItem | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "onHeaderToggle",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "CustomEvent<boolean>"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "close",
+              "description": "Closes the group (and, recursively, any nested groups inside it)."
+            },
+            {
+              "kind": "method",
+              "name": "focus",
+              "privacy": "public",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "options",
+                  "optional": true,
+                  "type": {
+                    "text": "FocusOptions"
+                  }
+                }
+              ]
+            }
+          ],
+          "events": [
+            {
+              "name": "expand-toggle",
+              "type": {
+                "text": "CustomEvent"
+              },
+              "description": "{CustomEvent<boolean>} Fired when the header is activated; detail is the next `expanded` value."
+            }
+          ],
+          "attributes": [
+            {
+              "name": "label",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Group'",
+              "description": "The text label displayed for the group header row.",
+              "fieldName": "label"
+            },
+            {
+              "name": "branches",
+              "type": {
+                "text": "TreeBranchType[]"
+              },
+              "default": "[]",
+              "description": "Guide line to draw for each ancestor level of the header row. Normally set by\nthe parent `<obc-tree-navigation>` container from the group's position; only\nset it manually when using a group outside the container.",
+              "fieldName": "branches"
+            },
+            {
+              "name": "expanded",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether the group is expanded, disclosing its children. Rotates the chevron.",
+              "fieldName": "expanded"
+            },
+            {
+              "name": "checked",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether the group header is the current selection.",
+              "fieldName": "checked"
+            },
+            {
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Disables the group header, removing it from the tab order and dimming it.",
+              "fieldName": "disabled"
+            },
+            {
+              "name": "terminalType",
+              "type": {
+                "text": "string"
+              },
+              "description": "Terminal type for the header row, controlling the alert-header marker shown in\nthe terminal. One of `regular` (default), `aggregated-header`, or `group-header`.",
+              "fieldName": "terminalType"
+            },
+            {
+              "name": "hasAlertBadge",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether a trailing alert counter badge is shown on the header row.",
+              "fieldName": "hasAlertBadge"
+            },
+            {
+              "name": "alertCount",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "description": "The number shown in the header's alert badge when `hasAlertBadge` is true.",
+              "fieldName": "alertCount"
+            },
+            {
+              "name": "alertType",
+              "type": {
+                "text": "string"
+              },
+              "description": "The severity/type of the header's alert badge. One of the `obc-badge` types (default `alarm`).",
+              "fieldName": "alertType"
+            },
+            {
+              "name": "href",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "The URL to navigate to when the header is activated. If set, the header row\nrenders as a link; otherwise it acts as a button.",
+              "fieldName": "href"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "obc-tree-navigation-group",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "ObcTreeNavigationGroup",
+          "declaration": {
+            "name": "ObcTreeNavigationGroup",
+            "module": "src/components/tree-navigation-group/tree-navigation-group.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "obc-tree-navigation-group",
+          "declaration": {
+            "name": "ObcTreeNavigationGroup",
+            "module": "src/components/tree-navigation-group/tree-navigation-group.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/tree-navigation-item/tree-navigation-item.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "`<obc-tree-navigation-item>` – A single row in a tree- or file-explorer-style\nnavigation list, with indentation guide lines, an optional expand/collapse\nchevron, a leading icon, a label, and an optional alert badge.\n\nEach row represents one node in a hierarchy. Depth is expressed through the\n`branches` array: one entry per ancestor level, each describing the guide line\nto draw for that level. The expand chevron lets a node disclose its children,\nemitting `expand-toggle` so a parent can manage the open/closed state.\n\n## Features\n- **Indentation guides:** Render one 32px guide column per `branches` entry —\n  pass-through vertical lines for ancestors that continue, and an elbow\n  (`intersection`) connecting the row to its parent.\n- **Expand/collapse:** Set `expandable` to show a chevron that rotates when\n  `expanded`. The chevron is a visual indicator only — activating the row\n  fires `expand-toggle` with the next state; manage `expanded` in response.\n  When `expanded`, a vertical guide descends from the chevron to connect to\n  the revealed child rows below.\n- **Terminal type:** `terminalType` adds an alert-header marker in the terminal\n  (`aggregatedHeader` or `groupHeader`), indicating the node heads a set of\n  aggregated or grouped alerts.\n- **Leading icon:** Provide an icon via the `icon` slot (shown when\n  `hasLeadingIcon`).\n- **Alert badge:** A trailing counter badge (e.g. an alarm count), toggled with\n  `hasAlertBadge` and configured via `alertCount` and `alertType`.\n- **Checked state:** `checked` highlights the current selection using the\n  amplified elevation style. A checked row is the current item and is not\n  re-selectable — it shows no hover/pressed feedback and fires no `click` or\n  navigation. An expandable checked row still toggles (fires `expand-toggle`),\n  so a group that is the current selection can be opened and closed. It stays\n  keyboard-focusable.\n- **Link or button:** Set `href` to render the row as a link; otherwise it acts\n  as a button.\n\n## Usage Guidelines\n- Use for hierarchical navigation such as file trees, layer panels, or nested\n  menus. For flat navigation lists, use `obc-navigation-item` instead.\n- Build `branches` from the row's ancestry: `intersection` for the level that\n  owns this row, `straight` for ancestors with siblings still to come, and\n  `blank` for ancestors whose subtrees have ended. When placed inside\n  `obc-tree-navigation`, the container computes `branches` automatically.\n- Keep one row `checked` at a time within a tree to mark the current location.\n- Leaf nodes should leave `expandable` as `false` so no chevron is shown.\n\n## Slots\n\n| Slot Name      | Renders When...                 | Purpose                                                                 |\n|----------------|---------------------------------|-------------------------------------------------------------------------|\n| icon           | `hasLeadingIcon` is true        | Leading icon for the row, e.g. `<obi-placeholder slot=\"icon\">`.         |",
+          "name": "ObcTreeNavigationItem",
+          "slots": [
+            {
+              "description": "Leading icon slot (shown when `hasLeadingIcon` is true).",
+              "name": "icon"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "label",
+              "type": {
+                "text": "string"
+              },
+              "default": "'List item'",
+              "description": "The text label displayed for the row.",
+              "attribute": "label"
+            },
+            {
+              "kind": "field",
+              "name": "branches",
+              "type": {
+                "text": "TreeBranchType[]"
+              },
+              "default": "[]",
+              "description": "Guide line for each ancestor level, outermost first; one 32px column per\nentry. Computed by `obc-tree-navigation` — rarely set by hand.",
+              "attribute": "branches"
+            },
+            {
+              "kind": "field",
+              "name": "expandable",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether the row shows an expand/collapse chevron. Leave false for leaf nodes.",
+              "attribute": "expandable"
+            },
+            {
+              "kind": "field",
+              "name": "expanded",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether the node is expanded. Rotates the chevron and sets `aria-expanded`.",
+              "attribute": "expanded",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "checked",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether the row is the current selection. Applies the amplified style and\nmakes the row inert to re-selection (no hover/pressed feedback, no `click`\nor navigation); it remains keyboard-focusable. An expandable checked row\nstill fires `expand-toggle` so a selected group can open and close.",
+              "attribute": "checked",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Disables the row, removing it from the tab order and dimming its appearance.",
+              "attribute": "disabled",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "focusable",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "true",
+              "description": "Whether the row is in the tab order. A tree container manages this as a\nroving tabindex (one row focusable at a time); standalone rows stay tabbable."
+            },
+            {
+              "kind": "field",
+              "name": "hasLeadingIcon",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "true",
+              "description": "Whether the row shows a leading icon (provided via the `icon` slot)."
+            },
+            {
+              "kind": "field",
+              "name": "terminalType",
+              "type": {
+                "text": "string"
+              },
+              "description": "Terminal type, controlling the alert-header marker shown in the terminal.\nOne of `regular` (default), `aggregated-header`, or `group-header`.",
+              "attribute": "terminalType"
+            },
+            {
+              "kind": "field",
+              "name": "hasAlertBadge",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether a trailing alert counter badge is shown.",
+              "attribute": "hasAlertBadge"
+            },
+            {
+              "kind": "field",
+              "name": "alertCount",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "description": "The number shown in the alert badge when `hasAlertBadge` is true.",
+              "attribute": "alertCount"
+            },
+            {
+              "kind": "field",
+              "name": "alertType",
+              "type": {
+                "text": "string"
+              },
+              "description": "The severity/type of the alert badge. One of the `obc-badge` types (default `alarm`).",
+              "attribute": "alertType"
+            },
+            {
+              "kind": "field",
+              "name": "href",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "The URL to navigate to when the row is activated. If set, the row renders as\na link; otherwise it acts as a button.",
+              "attribute": "href"
+            },
+            {
+              "kind": "field",
+              "name": "wrapperElement",
+              "type": {
+                "text": "HTMLElement | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "focus",
+              "privacy": "public",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "options",
+                  "optional": true,
+                  "type": {
+                    "text": "FocusOptions"
+                  }
+                }
+              ],
+              "description": "Focuses the row's interactive wrapper (the host itself is not focusable)."
+            },
+            {
+              "kind": "field",
+              "name": "isRoot",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "description": "A root-level row has no ancestor columns, so it draws no connector lines.",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "isBlankAncestry",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "description": "All ancestor columns are blank spacers — the row is indented but draws no\nguide lines, so the terminal connector and dropdown are suppressed too.",
+              "readonly": true
+            },
+            {
+              "kind": "method",
+              "name": "activate",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "handleKeydown",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "KeyboardEvent"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "renderBranch",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "type",
+                  "type": {
+                    "text": "TreeBranchType"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "renderTerminalHeader",
+              "privacy": "private"
+            }
+          ],
+          "events": [
+            {
+              "name": "expand-toggle",
+              "type": {
+                "text": "CustomEvent"
+              },
+              "description": "{CustomEvent<boolean>} Fired when an expandable row is activated; detail is the next `expanded` value."
+            },
+            {
+              "name": "click",
+              "type": {
+                "text": "CustomEvent"
+              },
+              "description": "{CustomEvent<void>} Fired when the row is activated."
+            }
+          ],
+          "attributes": [
+            {
+              "name": "label",
+              "type": {
+                "text": "string"
+              },
+              "default": "'List item'",
+              "description": "The text label displayed for the row.",
+              "fieldName": "label"
+            },
+            {
+              "name": "branches",
+              "type": {
+                "text": "TreeBranchType[]"
+              },
+              "default": "[]",
+              "description": "Guide line for each ancestor level, outermost first; one 32px column per\nentry. Computed by `obc-tree-navigation` — rarely set by hand.",
+              "fieldName": "branches"
+            },
+            {
+              "name": "expandable",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether the row shows an expand/collapse chevron. Leave false for leaf nodes.",
+              "fieldName": "expandable"
+            },
+            {
+              "name": "expanded",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether the node is expanded. Rotates the chevron and sets `aria-expanded`.",
+              "fieldName": "expanded"
+            },
+            {
+              "name": "checked",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether the row is the current selection. Applies the amplified style and\nmakes the row inert to re-selection (no hover/pressed feedback, no `click`\nor navigation); it remains keyboard-focusable. An expandable checked row\nstill fires `expand-toggle` so a selected group can open and close.",
+              "fieldName": "checked"
+            },
+            {
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Disables the row, removing it from the tab order and dimming its appearance.",
+              "fieldName": "disabled"
+            },
+            {
+              "name": "terminalType",
+              "type": {
+                "text": "string"
+              },
+              "description": "Terminal type, controlling the alert-header marker shown in the terminal.\nOne of `regular` (default), `aggregated-header`, or `group-header`.",
+              "fieldName": "terminalType"
+            },
+            {
+              "name": "hasAlertBadge",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether a trailing alert counter badge is shown.",
+              "fieldName": "hasAlertBadge"
+            },
+            {
+              "name": "alertCount",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "description": "The number shown in the alert badge when `hasAlertBadge` is true.",
+              "fieldName": "alertCount"
+            },
+            {
+              "name": "alertType",
+              "type": {
+                "text": "string"
+              },
+              "description": "The severity/type of the alert badge. One of the `obc-badge` types (default `alarm`).",
+              "fieldName": "alertType"
+            },
+            {
+              "name": "href",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "The URL to navigate to when the row is activated. If set, the row renders as\na link; otherwise it acts as a button.",
+              "fieldName": "href"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "obc-tree-navigation-item",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "ObcTreeNavigationItem",
+          "declaration": {
+            "name": "ObcTreeNavigationItem",
+            "module": "src/components/tree-navigation-item/tree-navigation-item.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "obc-tree-navigation-item",
+          "declaration": {
+            "name": "ObcTreeNavigationItem",
+            "module": "src/components/tree-navigation-item/tree-navigation-item.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/tree-navigation/tree-navigation.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "`<obc-tree-navigation>` – The container for a tree- or file-explorer-style\nnavigation list. Holds nested `<obc-tree-navigation-group>` and\n`<obc-tree-navigation-item>` rows and computes each row's indentation guide\nlines automatically from its position in the hierarchy.\n\nConsumers write the tree as plain nested markup; the container assigns every\nrow's `branches` array so the guide lines (pass-through verticals, elbows, and\nthe last-child corner) connect correctly — there is no need to compute depth or\nbranch types by hand. It re-derives the guides whenever rows are added, removed,\nor groups expand and collapse.\n\n## Features\n- **Automatic guide lines:** Each row receives a `branches` array derived from\n  its depth and whether each ancestor still has siblings below it. Last children\n  get a corner (`└`); rows with siblings below get an intersection (`├`); and\n  ancestor columns become a pass-through (`│`) or blank as appropriate.\n- **Live updates:** Reacts to slotted content changes and to group expand state,\n  recomputing the guides so they always match the visible structure.\n- **Composable:** Works with any nesting depth of groups and items.\n\n## Usage Guidelines\n- Use as the root of a hierarchical navigation list. For flat navigation, use\n  `obc-navigation-menu` instead.\n- Place `<obc-tree-navigation-group>` for expandable parents and\n  `<obc-tree-navigation-item>` for leaves; nest groups to any depth.\n- Do not set each row's `branches` manually — the container manages them.\n\n## Slots\n\n| Slot Name | Renders When... | Purpose                                            |\n|-----------|-----------------|----------------------------------------------------|\n| (default) | Always          | Top-level rows (`obc-tree-navigation-group`/`-item`). |",
+          "name": "ObcTreeNavigation",
+          "slots": [
+            {
+              "description": "Top-level tree rows (groups and items).",
+              "name": ""
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "mutationObserver",
+              "type": {
+                "text": "MutationObserver | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "innerItem",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "ObcTreeNavigationItem | null"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "row",
+                  "type": {
+                    "text": "TreeRow"
+                  }
+                }
+              ],
+              "description": "The focusable header item for a row: a leaf is itself; a group's is its shadow header."
+            },
+            {
+              "kind": "field",
+              "name": "navigator",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new TreeRovingNavigator<TreeRow>(this, { getRows: () => this.childRows(this), childRows: (row) => this.childRows(row), isGroup: (row) => isGroup(row), isExpanded: (row) => isGroup(row) && row.hasAttribute('expanded'), setExpanded: (row, expanded) => { if (isGroup(row)) row.expanded = expanded; }, innerItem: (row) => this.innerItem(row), isDisabled: (row) => this.innerItem(row)?.hasAttribute('disabled') ?? false, } satisfies TreeRovingAdapter<TreeRow>)"
+            },
+            {
+              "kind": "field",
+              "name": "onKeydown",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "onExpandToggle",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "childRows",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "TreeRow[]"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "el",
+                  "type": {
+                    "text": "Element"
+                  }
+                }
+              ],
+              "description": "Direct tree-row children of an element, in document order."
+            },
+            {
+              "kind": "method",
+              "name": "assignBranches",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "rows",
+                  "type": {
+                    "text": "TreeRow[]"
+                  },
+                  "description": "sibling rows at this level, in order"
+                },
+                {
+                  "name": "ancestorHasNextSibling",
+                  "type": {
+                    "text": "boolean[]"
+                  },
+                  "description": "one flag per ancestor *below the root*: true\nif that ancestor has a sibling still below it (so its column is a\npass-through), false if its subtree has ended (a blank column)"
+                },
+                {
+                  "name": "depth",
+                  "type": {
+                    "text": "number"
+                  },
+                  "description": "nesting depth; 0 for top-level rows (which draw no columns)"
+                }
+              ],
+              "description": "Walk the row tree and assign each row's `branches`. Mirrors the guide-line\nmodel: a row gets one column per ancestor (pass-through `straight` if that\nancestor still has siblings below, else `blank`) followed by its own elbow\n(`corner` if it is the last child, else `intersection`). Top-level rows draw\nno columns at all."
+            },
+            {
+              "kind": "method",
+              "name": "updateBranches",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "obc-tree-navigation",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "ObcTreeNavigation",
+          "declaration": {
+            "name": "ObcTreeNavigation",
+            "module": "src/components/tree-navigation/tree-navigation.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "obc-tree-navigation",
+          "declaration": {
+            "name": "ObcTreeNavigation",
+            "module": "src/components/tree-navigation/tree-navigation.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/components/user-button/user-button.ts",