@aquera/nile-elements 2.0.10 → 2.0.12

package/vscode-html-custom-data.json

@@ -73,7 +73,7 @@
     },
     {
       "name": "nile-app-shell-nav-toggle",
-      "description": "Attributes:\n\n  * `with-rule` {`boolean`} - Draws the vertical rule the shell's own bar puts after the toggle.\n\n  * `shell` {`string | undefined`} - The shell to drive. Defaults to the nearest `nile-app-shell` ancestor, or\nthe element with this id.\n\nProperties:\n\n  * `withRule` {`boolean`} - Draws the vertical rule the shell's own bar puts after the toggle.\n\n  * `shell` {`string | undefined`} - The shell to drive. Defaults to the nearest `nile-app-shell` ancestor, or\nthe element with this id.\n\n  * `_rail` {`boolean`} - \n\n  * `_locked` {`boolean`} - \n\n  * `_observed` - \n\n  * `appShell` - The shell this toggle drives, if it found one.\n\n  * `_onShellToggle` - \n\n  * `_onClick` - \n\n  * `BUBBLES` {`boolean`} - \n\n  * `COMPOSED` {`boolean`} - \n\n  * `CANCELABLE` {`boolean`} - ",
+      "description": "Attributes:\n\n  * `with-rule` {`boolean`} - Draws the vertical rule the shell's own bar puts after the toggle.\n\n  * `shell` {`string | undefined`} - The shell to drive. Defaults to the nearest `nile-app-shell` ancestor, or the element with this id.\n\nProperties:\n\n  * `withRule` {`boolean`} - Draws the vertical rule the shell's own bar puts after the toggle.\n\n  * `shell` {`string | undefined`} - The shell to drive. Defaults to the nearest `nile-app-shell` ancestor, or the element with this id.\n\n  * `_rail` {`boolean`} - \n\n  * `_locked` {`boolean`} - \n\n  * `_observed` - \n\n  * `appShell` - The shell this toggle drives, if it found one.\n\n  * `_onShellToggle` - \n\n  * `_onClick` - \n\n  * `BUBBLES` {`boolean`} - \n\n  * `COMPOSED` {`boolean`} - \n\n  * `CANCELABLE` {`boolean`} - ",
       "attributes": [
         {
           "name": "with-rule",
@@ -82,14 +82,14 @@
         },
         {
           "name": "shell",
-          "description": "`shell` {`string | undefined`} - The shell to drive. Defaults to the nearest `nile-app-shell` ancestor, or\nthe element with this id.\n\nProperty: shell",
+          "description": "`shell` {`string | undefined`} - The shell to drive. Defaults to the nearest `nile-app-shell` ancestor, or the element with this id.\n\nProperty: shell",
           "values": []
         }
       ]
     },
     {
       "name": "nile-app-shell-panel",
-      "description": "Events:\n\n  * `nile-close` {} - Emitted when the close button is pressed, after the shell\nhas been told to close. Cancelable is not honoured; listen to it to react,\nand use `no-close` to own the control yourself.\n\nSlots:\n\n  * ` ` {} - The panel body. Scrolls.\n\n  * `header` {} - Replaces the default heading (mark plus label).\n\n  * `actions` {} - Controls added before the close button.\n\n  * `footer` {} - A composer, docked below the scroll region.\n\nAttributes:\n\n  * `label` {`string`} - The heading, and the accessible name of the region.\n\n  * `no-header` {`boolean`} - Drops the header bar entirely.\n\n  * `no-close` {`boolean`} - Drops the close button — for a panel the page closes its own way.\n\n  * `no-padding` {`boolean`} - Removes the body's padding, for a full-bleed transcript.\n\n  * `shell` {`string | undefined`} - Id of the shell to follow. Defaults to the nearest ancestor.\n\n  * `mode` {`NileAppShellPanelMode`} - Mirrors the shell's panel mode. Set by the shell; treat it as read-only and\nstyle against it (`nile-app-shell-panel[mode='overlay']`).\n\nProperties:\n\n  * `shellLink` - \n\n  * `label` {`string`} - The heading, and the accessible name of the region.\n\n  * `noHeader` {`boolean`} - Drops the header bar entirely.\n\n  * `noClose` {`boolean`} - Drops the close button — for a panel the page closes its own way.\n\n  * `noPadding` {`boolean`} - Removes the body's padding, for a full-bleed transcript.\n\n  * `shell` {`string | undefined`} - Id of the shell to follow. Defaults to the nearest ancestor.\n\n  * `mode` {`NileAppShellPanelMode`} - Mirrors the shell's panel mode. Set by the shell; treat it as read-only and\nstyle against it (`nile-app-shell-panel[mode='overlay']`).\n\n  * `_hasFooter` {`boolean`} - \n\n  * `BUBBLES` {`boolean`} - \n\n  * `COMPOSED` {`boolean`} - \n\n  * `CANCELABLE` {`boolean`} - ",
+      "description": "Events:\n\n  * `nile-close` {} - Emitted when the close button is pressed, after the shell has been told to close.\n\n  * `nile-back` {} - Emitted when the back control is pressed; the page swaps its own content back.\n\n  * `nile-panel-back` {} - Emitted right after `nile-back` for the same press, matching the shell's built-in panel chrome, so a page listening on the shell keeps working when it slots this component. Listen for one of the two, not both, or one press is handled twice.\n\nSlots:\n\n  * ` ` {} - The panel body. Scrolls.\n\n  * `header` {} - Replaces the default heading (mark plus label); the back control renders before it.\n\n  * `actions` {} - Controls added before the close button; size and clear their `base` part from page CSS to match the header's bare glyphs.\n\n  * `footer` {} - A composer, docked below the scroll region.\n\nAttributes:\n\n  * `label` {`string`} - The heading, and the accessible name of the region.\n\n  * `no-header` {`boolean`} - Drops the header bar entirely.\n\n  * `back` {`boolean`} - Shows a back control at the start of the header for a sub-view; the panel keeps no view stack and only emits `nile-back`.\n\n  * `backLabel` {`string`} - Accessible name of the back control.\n\n  * `no-close` {`boolean`} - Drops the close button — for a panel the page closes its own way.\n\n  * `no-padding` {`boolean`} - Removes the body's padding, for a full-bleed transcript.\n\n  * `shell` {`string | undefined`} - Id of the shell to follow. Defaults to the nearest ancestor.\n\n  * `mode` {`NileAppShellPanelMode`} - Mirrors the shell's panel mode. Set by the shell; treat it as read-only and style against it (`nile-app-shell-panel[mode='overlay']`).\n\nProperties:\n\n  * `shellLink` - \n\n  * `label` {`string`} - The heading, and the accessible name of the region.\n\n  * `noHeader` {`boolean`} - Drops the header bar entirely.\n\n  * `back` {`boolean`} - Shows a back control at the start of the header for a sub-view; the panel keeps no view stack and only emits `nile-back`.\n\n  * `backLabel` {`string`} - Accessible name of the back control.\n\n  * `noClose` {`boolean`} - Drops the close button — for a panel the page closes its own way.\n\n  * `noPadding` {`boolean`} - Removes the body's padding, for a full-bleed transcript.\n\n  * `shell` {`string | undefined`} - Id of the shell to follow. Defaults to the nearest ancestor.\n\n  * `mode` {`NileAppShellPanelMode`} - Mirrors the shell's panel mode. Set by the shell; treat it as read-only and style against it (`nile-app-shell-panel[mode='overlay']`).\n\n  * `_hasFooter` {`boolean`} - \n\n  * `BUBBLES` {`boolean`} - \n\n  * `COMPOSED` {`boolean`} - \n\n  * `CANCELABLE` {`boolean`} - ",
       "attributes": [
         {
           "name": "label",
@@ -100,6 +100,15 @@
           "description": "`no-header` {`boolean`} - Drops the header bar entirely.\n\nProperty: noHeader\n\nDefault: false",
           "valueSet": "v"
         },
+        {
+          "name": "back",
+          "description": "`back` {`boolean`} - Shows a back control at the start of the header for a sub-view; the panel keeps no view stack and only emits `nile-back`.\n\nProperty: back\n\nDefault: false",
+          "valueSet": "v"
+        },
+        {
+          "name": "backLabel",
+          "description": "`backLabel` {`string`} - Accessible name of the back control.\n\nProperty: backLabel\n\nDefault: Back"
+        },
         {
           "name": "no-close",
           "description": "`no-close` {`boolean`} - Drops the close button — for a panel the page closes its own way.\n\nProperty: noClose\n\nDefault: false",
@@ -117,7 +126,7 @@
         },
         {
           "name": "mode",
-          "description": "`mode` {`NileAppShellPanelMode`} - Mirrors the shell's panel mode. Set by the shell; treat it as read-only and\nstyle against it (`nile-app-shell-panel[mode='overlay']`).\n\nProperty: mode\n\nDefault: docked",
+          "description": "`mode` {`NileAppShellPanelMode`} - Mirrors the shell's panel mode. Set by the shell; treat it as read-only and style against it (`nile-app-shell-panel[mode='overlay']`).\n\nProperty: mode\n\nDefault: docked",
           "values": [
             {
               "name": "docked"
@@ -129,17 +138,25 @@
         },
         {
           "name": "onnile-close",
-          "description": "`nile-close` {} - Emitted when the close button is pressed, after the shell\nhas been told to close. Cancelable is not honoured; listen to it to react,\nand use `no-close` to own the control yourself."
+          "description": "`nile-close` {} - Emitted when the close button is pressed, after the shell has been told to close."
+        },
+        {
+          "name": "onnile-back",
+          "description": "`nile-back` {} - Emitted when the back control is pressed; the page swaps its own content back."
+        },
+        {
+          "name": "onnile-panel-back",
+          "description": "`nile-panel-back` {} - Emitted right after `nile-back` for the same press, matching the shell's built-in panel chrome, so a page listening on the shell keeps working when it slots this component. Listen for one of the two, not both, or one press is handled twice."
         }
       ]
     },
     {
       "name": "nile-app-shell-side-nav",
-      "description": "Slots:\n\n  * ` ` {} - The nav body. Scrolls.\n\n  * `header` {} - Pinned above the scroll region — a wordmark or product switcher.\n\n  * `footer` {} - Pinned below it — an account row or help link.\n\nAttributes:\n\n  * `collapsed` {`boolean`} - Mirrors the shell's effective rail state — the user's preference, or a rail\nforced by the shell's width. Set by the shell; treat it as read-only and\nstyle against it (`nile-app-shell-side-nav[collapsed] .label`).\n\n  * `shell` {`string | undefined`} - Id of the shell to follow. Defaults to the nearest ancestor.\n\nProperties:\n\n  * `shellLink` - \n\n  * `collapsed` {`boolean`} - Mirrors the shell's effective rail state — the user's preference, or a rail\nforced by the shell's width. Set by the shell; treat it as read-only and\nstyle against it (`nile-app-shell-side-nav[collapsed] .label`).\n\n  * `shell` {`string | undefined`} - Id of the shell to follow. Defaults to the nearest ancestor.\n\n  * `BUBBLES` {`boolean`} - \n\n  * `COMPOSED` {`boolean`} - \n\n  * `CANCELABLE` {`boolean`} - ",
+      "description": "Slots:\n\n  * ` ` {} - The nav body. Scrolls.\n\n  * `header` {} - Pinned above the scroll region — a wordmark or product switcher.\n\n  * `footer` {} - Pinned below it — an account row or help link.\n\nAttributes:\n\n  * `collapsed` {`boolean`} - Mirrors the shell's effective rail state. Set by the shell; treat it as read-only and style against it (`nile-app-shell-side-nav[collapsed] .label`).\n\n  * `shell` {`string | undefined`} - Id of the shell to follow. Defaults to the nearest ancestor.\n\nProperties:\n\n  * `shellLink` - \n\n  * `collapsed` {`boolean`} - Mirrors the shell's effective rail state. Set by the shell; treat it as read-only and style against it (`nile-app-shell-side-nav[collapsed] .label`).\n\n  * `shell` {`string | undefined`} - Id of the shell to follow. Defaults to the nearest ancestor.\n\n  * `BUBBLES` {`boolean`} - \n\n  * `COMPOSED` {`boolean`} - \n\n  * `CANCELABLE` {`boolean`} - ",
       "attributes": [
         {
           "name": "collapsed",
-          "description": "`collapsed` {`boolean`} - Mirrors the shell's effective rail state — the user's preference, or a rail\nforced by the shell's width. Set by the shell; treat it as read-only and\nstyle against it (`nile-app-shell-side-nav[collapsed] .label`).\n\nProperty: collapsed\n\nDefault: false",
+          "description": "`collapsed` {`boolean`} - Mirrors the shell's effective rail state. Set by the shell; treat it as read-only and style against it (`nile-app-shell-side-nav[collapsed] .label`).\n\nProperty: collapsed\n\nDefault: false",
           "valueSet": "v"
         },
         {
@@ -151,11 +168,11 @@
     },
     {
       "name": "nile-app-shell",
-      "description": "Events:\n\n  * `nile-nav-toggle` {} - Emitted after the nav's collapsed state or its\nforced-rail lock changes. `detail: { collapsed, locked }`.\n\n  * `nile-panel-toggle` {} - Emitted after the panel opens or closes.\n`detail: { open, mode }`.\n\n  * `nile-panel-mode-change` {} - Emitted when the panel flips between docked\nand overlay. `detail: { mode }`.\n\nSlots:\n\n  * ` ` {} - The page body, inside the content container.\n\n  * `banner` {} - A full-width strip above every other region.\n\n  * `top-bar` {} - The page-title bar. Mounted inside the container by default,\nor spanning the shell when `top-bar-placement=\"shell\"`. The nav toggle is\nrendered before whatever is slotted here.\n\n  * `top-bar-actions` {} - Controls pinned to the end of the top bar.\n\n  * `tabs` {} - A hoisted second-level tab strip, flush under the top bar and\noutside `<main>`'s scroller, so it never scrolls away. The region carries\nthe strip's height, padding and rule, so slot a `<nile-tab-group>` or the\ntab controls themselves.\n\n  * `side-nav` {} - The navigation track. Works best with `<nile-side-bar>`.\n\n  * `aside` {} - A secondary column between the content container and the panel.\n\n  * `panel` {} - The AI panel's body. When nothing is slotted here the panel is\nunmounted and `openPanel()` is a no-op.\n\n  * `panel-header` {} - Replaces the default panel heading (mark plus title).\n\n  * `panel-actions` {} - Controls added before the panel's close button.\n\n  * `panel-footer` {} - A bar docked below the panel's scroll region, for a\ncomposer.\n\nAttributes:\n\n  * `nav-collapsed` {`boolean`} - The user's nav preference. The nav can still render as a rail while this is\nfalse — see `navLocked`.\n\n  * `panel-open` {`boolean`} - Whether the AI panel is open.\n\n  * `no-panel` {`boolean`} - Unmounts the AI panel for this route even when the `panel` slot is filled.\n`openPanel()` becomes a no-op.\n\n  * `panel-label` {`string`} - The default panel heading. Ignored when `panel-header` is slotted.\n\n  * `no-nav-toggle` {`boolean`} - Hides the built-in nav toggle. Mount `nile-app-shell-nav-toggle` yourself.\n\n  * `no-panel-shortcut` {`boolean`} - Drops the Cmd/Ctrl+J and Escape panel shortcuts.\n\n  * `no-skip-link` {`boolean`} - Hides the skip-to-content link.\n\n  * `skip-link-label` {`string`} - Label for the skip-to-content link.\n\n  * `top-bar-placement` {`NileAppShellTopBarPlacement`} - Where the top bar is mounted: inside the container, or spanning the shell.\n\n  * `content-align` {`NileAppShellContentAlign`} - `centered` caps the page body at `--nile-app-shell-centered-width`.\n\n  * `content-container` {`boolean`} - Makes the slotted page root a size query container, so page CSS can size\nagainst the content container instead of the viewport. Query it unnamed —\n`@container (min-width: 720px)` — because a container name declared inside\nthe shell's shadow tree is not visible to page CSS. Opt-in, because it\nalso applies layout containment to that element.\n\n  * `flat` {`boolean`} - Drops the container's card chrome for a full-bleed page.\n\n  * `no-padding` {`boolean`} - Removes the container's inner padding.\n\n  * `ask-label` {`string`} - The label on the built-in Ask button.\n\nThe button is the shell's, not the app's: it is the one control that has\nto know whether a panel is mounted for this route and how to open it, and\nslotted content can see neither. Everything else in the bar — the\nbreadcrumb, the page actions, the tab strip — is slotted markup.\n\n  * `no-ask` {`boolean`} - Drops the built-in Ask button, for a bar that renders its own.\n\n  * `full-height` {`boolean`} - Sizes the shell to the viewport instead of its parent.\n\n  * `overlay-breakpoint` {`number`} - Below this shell width the panel overlays the content instead of pushing\nit, and the nav is forced to a rail.\n\nZero — the default — means never: the panel is furniture that squeezes the\npage, at every width. It earns its room from the nav rail first and from\nits own width next (see `--nile-app-shell-panel-min-width`), so it does\nnot have to cover the page to fit. Set a width here to opt back into an\noverlay drawer below it.\n\n  * `docked-rail-breakpoint` {`number`} - Below this shell width an open docked panel forces the nav to a rail.\nA floor, not the whole rule: the nav also rails as soon as the expanded\ntrack is what stops the row from fitting. This is the first thing the\npanel takes room from, so it can push rather than cover.\n\n  * `persist-key` {`string | undefined`} - Persists the nav preference and the docked panel state under this key.\nOverlay panel state is never persisted — a reload opens closed.\n\nProperties:\n\n  * `navCollapsed` {`boolean`} - The user's nav preference. The nav can still render as a rail while this is\nfalse — see `navLocked`.\n\n  * `panelOpen` {`boolean`} - Whether the AI panel is open.\n\n  * `noPanel` {`boolean`} - Unmounts the AI panel for this route even when the `panel` slot is filled.\n`openPanel()` becomes a no-op.\n\n  * `panelLabel` {`string`} - The default panel heading. Ignored when `panel-header` is slotted.\n\n  * `noNavToggle` {`boolean`} - Hides the built-in nav toggle. Mount `nile-app-shell-nav-toggle` yourself.\n\n  * `noPanelShortcut` {`boolean`} - Drops the Cmd/Ctrl+J and Escape panel shortcuts.\n\n  * `noSkipLink` {`boolean`} - Hides the skip-to-content link.\n\n  * `skipLinkLabel` {`string`} - Label for the skip-to-content link.\n\n  * `topBarPlacement` {`NileAppShellTopBarPlacement`} - Where the top bar is mounted: inside the container, or spanning the shell.\n\n  * `contentAlign` {`NileAppShellContentAlign`} - `centered` caps the page body at `--nile-app-shell-centered-width`.\n\n  * `contentContainer` {`boolean`} - Makes the slotted page root a size query container, so page CSS can size\nagainst the content container instead of the viewport. Query it unnamed —\n`@container (min-width: 720px)` — because a container name declared inside\nthe shell's shadow tree is not visible to page CSS. Opt-in, because it\nalso applies layout containment to that element.\n\n  * `flat` {`boolean`} - Drops the container's card chrome for a full-bleed page.\n\n  * `noPadding` {`boolean`} - Removes the container's inner padding.\n\n  * `askLabel` {`string`} - The label on the built-in Ask button.\n\nThe button is the shell's, not the app's: it is the one control that has\nto know whether a panel is mounted for this route and how to open it, and\nslotted content can see neither. Everything else in the bar — the\nbreadcrumb, the page actions, the tab strip — is slotted markup.\n\n  * `noAsk` {`boolean`} - Drops the built-in Ask button, for a bar that renders its own.\n\n  * `fullHeight` {`boolean`} - Sizes the shell to the viewport instead of its parent.\n\n  * `overlayBreakpoint` {`number`} - Below this shell width the panel overlays the content instead of pushing\nit, and the nav is forced to a rail.\n\nZero — the default — means never: the panel is furniture that squeezes the\npage, at every width. It earns its room from the nav rail first and from\nits own width next (see `--nile-app-shell-panel-min-width`), so it does\nnot have to cover the page to fit. Set a width here to opt back into an\noverlay drawer below it.\n\n  * `dockedRailBreakpoint` {`number`} - Below this shell width an open docked panel forces the nav to a rail.\nA floor, not the whole rule: the nav also rails as soon as the expanded\ntrack is what stops the row from fitting. This is the first thing the\npanel takes room from, so it can push rather than cover.\n\n  * `persistKey` {`string | undefined`} - Persists the nav preference and the docked panel state under this key.\nOverlay panel state is never persisted — a reload opens closed.\n\n  * `_panelMode` {`NileAppShellPanelMode`} - The panel's current mode. Derived from the shell's width.\n\n  * `_navLocked` {`boolean`} - Whether the nav is held at a rail by the shell's width.\n\n  * `_hasBanner` {`boolean`} - \n\n  * `_hasSideNav` {`boolean`} - \n\n  * `_hasTopBar` {`boolean`} - \n\n  * `_hasTopBarActions` {`boolean`} - \n\n  * `_hasTabs` {`boolean`} - \n\n  * `_hasPanel` {`boolean`} - \n\n  * `_hasPanelFooter` {`boolean`} - \n\n  * `_panelOwnsChrome` {`boolean`} - True when a `nile-app-shell-panel` is slotted. That component owns the\npanel's heading, actions, close button and footer, so the shell renders a\nbare region and keeps only the geometry and the open state — the same\nhand-off as `no-nav-toggle` plus `nile-app-shell-nav-toggle`.\n\n  * `_hasAside` {`boolean`} - \n\n  * `_main` {`HTMLElement | undefined`} - \n\n  * `_width` {`number`} - \n\n  * `_resizeObserver` - \n\n  * `_restoredPanelOpen` {`boolean | null`} - \n\n  * `panelMode` {`NileAppShellPanelMode`} - The panel's current mode: `docked` or `overlay`.\n\n  * `navLocked` {`boolean`} - Whether the shell is holding the nav at a rail. The toggle is disabled.\n\n  * `panelAvailable` {`boolean`} - Whether a panel is mounted for this route.\n\n  * `askVisible` {`boolean`} - Whether the built-in Ask button is rendered.\n\n  * `rail` {`boolean`} - Whether the nav renders as a rail right now, preference or lock.\n\n  * `_onSideNavToggle` - A slotted sidebar's own expand button is the same toggle.\n\n  * `_onKeyDown` - \n\n  * `BUBBLES` {`boolean`} - \n\n  * `COMPOSED` {`boolean`} - \n\n  * `CANCELABLE` {`boolean`} - ",
+      "description": "Events:\n\n  * `nile-nav-toggle` {} - Emitted after the nav's collapsed state or forced-rail lock changes. `detail: { collapsed, locked }`.\n\n  * `nile-panel-toggle` {} - Emitted after the panel opens or closes. `detail: { open, mode }`.\n\n  * `nile-panel-mode-change` {} - Emitted when the panel flips between docked and overlay. `detail: { mode }`.\n\n  * `nile-click` {} - Emitted when the header's back control is pressed, or `goBackHeader()` is called. `detail: { value: 'back' }`. Emitted on the shell itself, so check `event.target === shell` as well as the value: a `nile-click` from page content bubbles through the shell too.\n\n  * `nile-panel-back` {} - Emitted when the panel's back control is pressed, whether the shell's built-in panel chrome or a slotted `nile-app-shell-panel` draws it.\n\nSlots:\n\n  * ` ` {} - The page body, inside the content container.\n\n  * `banner` {} - A full-width strip above every other region.\n\n  * `top-bar` {} - The page-title bar, mounted inside the container by default or spanning the shell when `top-bar-placement=\"shell\"`.\n\n  * `top-bar-actions` {} - Controls pinned to the end of the top bar.\n\n  * `tabs` {} - A hoisted second-level tab strip, flush under the top bar and outside `<main>`'s scroller.\n\n  * `app-icon` {} - The mark shown before the page title whenever this slot has content, clipped to the shell's box.\n\n  * `side-nav` {} - The navigation track. Works best with `<nile-side-bar>`.\n\n  * `aside` {} - A secondary column between the content container and the panel.\n\n  * `panel` {} - The AI panel's body. When empty the panel is unmounted and `openPanel()` is a no-op.\n\n  * `panel-header` {} - Replaces the default panel heading (mark plus title).\n\n  * `panel-actions` {} - Controls added before the panel's close button.\n\n  * `panel-footer` {} - A bar docked below the panel's scroll region, for a composer.\n\nAttributes:\n\n  * `nav-collapsed` {`boolean`} - The user's nav preference. The nav can still render as a rail while this is false — see `navLocked`.\n\n  * `panel-open` {`boolean`} - Whether the AI panel is open.\n\n  * `no-panel` {`boolean`} - Unmounts the AI panel for this route even when the `panel` slot is filled; `openPanel()` becomes a no-op.\n\n  * `panel-label` {`string`} - The default panel heading. Ignored when `panel-header` is slotted.\n\n  * `pageTitle` {`string | undefined`} - The page title, rendered as the top bar's own heading (`role=\"heading\"`, level from `headingLevel`) before anything slotted into `top-bar`; leave unset and no title block renders.\n\n  * `headingLevel` {`number`} - The `aria-level` of the `pageTitle` heading, 1–6, so the title can fit the page's own heading outline; e.g. 2 when the page body or banner already has its h1. Out-of-range values clamp to 1–6 and non-numbers fall back to 1.\n\n  * `description` {`string | undefined`} - A second line under the page title; a modifier on `pageTitle` that renders nothing with no title, and takes the bar to 76px.\n\n  * `badge` {`string | undefined`} - A pill after the page title; a modifier on `pageTitle` like `description`, so with no title there is no badge.\n\n  * `headerBack` {`boolean`} - Shows the back arrow before the page title; pressing it emits `nile-click` with `{ value: 'back' }`. Independent of the `app-icon` slot.\n\n  * `headerBackLabel` {`string`} - Accessible name of the header back control. Never rendered as visible text.\n\n  * `no-nav-toggle` {`boolean`} - Hides the built-in nav toggle. Mount `nile-app-shell-nav-toggle` yourself.\n\n  * `no-panel-shortcut` {`boolean`} - Drops the Cmd/Ctrl+J and Escape panel shortcuts.\n\n  * `no-skip-link` {`boolean`} - Hides the skip-to-content link.\n\n  * `skip-link-label` {`string`} - Label for the skip-to-content link.\n\n  * `top-bar-placement` {`NileAppShellTopBarPlacement`} - Where the top bar is mounted: inside the container, or spanning the shell.\n\n  * `content-align` {`NileAppShellContentAlign`} - `centered` caps the page body at `--nile-app-shell-centered-width`.\n\n  * `content-container` {`boolean`} - Makes the slotted page root a size query container, so page CSS can size against the content container instead of the viewport.\n\n  * `flat` {`boolean`} - Drops the container's card chrome for a full-bleed page.\n\n  * `no-padding` {`boolean`} - Removes the container's inner padding.\n\n  * `ask-label` {`string`} - The label on the built-in Ask button.\n\n  * `no-ask` {`boolean`} - Drops the built-in Ask button, for a bar that renders its own.\n\n  * `panelBack` {`boolean`} - Shows a back control at the start of the panel header for a panel sub-view; emits `nile-panel-back`.\n\n  * `panelBackLabel` {`string`} - Accessible name of the panel's back control.\n\n  * `noTabs` {`boolean`} - Hides the tab strip for this route even when the `tabs` slot is filled.\n\n  * `full-height` {`boolean`} - Sizes the shell to the viewport instead of its parent.\n\n  * `overlay-breakpoint` {`number`} - Below this shell width the panel overlays the content instead of pushing it, and the nav is forced to a rail; zero (default) means never.\n\n  * `docked-rail-breakpoint` {`number`} - Below this shell width an open docked panel forces the nav to a rail.\n\n  * `persist-key` {`string | undefined`} - Persists the nav preference and docked panel state under this key. Overlay panel state is never persisted.\n\nProperties:\n\n  * `navCollapsed` {`boolean`} - The user's nav preference. The nav can still render as a rail while this is false — see `navLocked`.\n\n  * `panelOpen` {`boolean`} - Whether the AI panel is open.\n\n  * `noPanel` {`boolean`} - Unmounts the AI panel for this route even when the `panel` slot is filled; `openPanel()` becomes a no-op.\n\n  * `panelLabel` {`string`} - The default panel heading. Ignored when `panel-header` is slotted.\n\n  * `pageTitle` {`string | undefined`} - The page title, rendered as the top bar's own heading (`role=\"heading\"`, level from `headingLevel`) before anything slotted into `top-bar`; leave unset and no title block renders.\n\n  * `headingLevel` {`number`} - The `aria-level` of the `pageTitle` heading, 1–6, so the title can fit the page's own heading outline; e.g. 2 when the page body or banner already has its h1. Out-of-range values clamp to 1–6 and non-numbers fall back to 1.\n\n  * `description` {`string | undefined`} - A second line under the page title; a modifier on `pageTitle` that renders nothing with no title, and takes the bar to 76px.\n\n  * `badge` {`string | undefined`} - A pill after the page title; a modifier on `pageTitle` like `description`, so with no title there is no badge.\n\n  * `headerBack` {`boolean`} - Shows the back arrow before the page title; pressing it emits `nile-click` with `{ value: 'back' }`. Independent of the `app-icon` slot.\n\n  * `headerBackLabel` {`string`} - Accessible name of the header back control. Never rendered as visible text.\n\n  * `noNavToggle` {`boolean`} - Hides the built-in nav toggle. Mount `nile-app-shell-nav-toggle` yourself.\n\n  * `noPanelShortcut` {`boolean`} - Drops the Cmd/Ctrl+J and Escape panel shortcuts.\n\n  * `noSkipLink` {`boolean`} - Hides the skip-to-content link.\n\n  * `skipLinkLabel` {`string`} - Label for the skip-to-content link.\n\n  * `topBarPlacement` {`NileAppShellTopBarPlacement`} - Where the top bar is mounted: inside the container, or spanning the shell.\n\n  * `contentAlign` {`NileAppShellContentAlign`} - `centered` caps the page body at `--nile-app-shell-centered-width`.\n\n  * `contentContainer` {`boolean`} - Makes the slotted page root a size query container, so page CSS can size against the content container instead of the viewport.\n\n  * `flat` {`boolean`} - Drops the container's card chrome for a full-bleed page.\n\n  * `noPadding` {`boolean`} - Removes the container's inner padding.\n\n  * `askLabel` {`string`} - The label on the built-in Ask button.\n\n  * `noAsk` {`boolean`} - Drops the built-in Ask button, for a bar that renders its own.\n\n  * `panelBack` {`boolean`} - Shows a back control at the start of the panel header for a panel sub-view; emits `nile-panel-back`.\n\n  * `panelBackLabel` {`string`} - Accessible name of the panel's back control.\n\n  * `noTabs` {`boolean`} - Hides the tab strip for this route even when the `tabs` slot is filled.\n\n  * `fullHeight` {`boolean`} - Sizes the shell to the viewport instead of its parent.\n\n  * `overlayBreakpoint` {`number`} - Below this shell width the panel overlays the content instead of pushing it, and the nav is forced to a rail; zero (default) means never.\n\n  * `dockedRailBreakpoint` {`number`} - Below this shell width an open docked panel forces the nav to a rail.\n\n  * `persistKey` {`string | undefined`} - Persists the nav preference and docked panel state under this key. Overlay panel state is never persisted.\n\n  * `_panelMode` {`NileAppShellPanelMode`} - The panel's current mode. Derived from the shell's width.\n\n  * `_navLocked` {`boolean`} - Whether the nav is held at a rail by the shell's width.\n\n  * `_hasBanner` {`boolean`} - \n\n  * `_hasSideNav` {`boolean`} - \n\n  * `_hasTopBar` {`boolean`} - \n\n  * `_hasTopBarActions` {`boolean`} - \n\n  * `_hasTabs` {`boolean`} - \n\n  * `_hasAppIcon` {`boolean`} - \n\n  * `_hasPanel` {`boolean`} - \n\n  * `_hasPanelFooter` {`boolean`} - \n\n  * `_panelOwnsChrome` {`boolean`} - True when a `nile-app-shell-panel` is slotted, owning the panel's own chrome so the shell renders a bare region.\n\n  * `_hasAside` {`boolean`} - \n\n  * `_main` {`HTMLElement | undefined`} - \n\n  * `_width` {`number`} - \n\n  * `_resizeObserver` - \n\n  * `_restoredPanelOpen` {`boolean | null`} - \n\n  * `panelMode` {`NileAppShellPanelMode`} - The panel's current mode: `docked` or `overlay`.\n\n  * `navLocked` {`boolean`} - Whether the shell is holding the nav at a rail. The toggle is disabled.\n\n  * `panelAvailable` {`boolean`} - Whether a panel is mounted for this route.\n\n  * `tabsVisible` {`boolean`} - Whether the tab strip is rendered: something slotted, and not switched off.\n\n  * `askVisible` {`boolean`} - Whether the built-in Ask button is rendered.\n\n  * `rail` {`boolean`} - Whether the nav renders as a rail right now, preference or lock.\n\n  * `_onSideNavToggle` - A slotted sidebar's own expand button is the same toggle.\n\n  * `_onKeyDown` - \n\n  * `_hasTitleBlock` {`boolean`} - Whether the header has a title block of its own to draw: a title, the back arrow or a slotted app icon mounts it.\n\n  * `_headingLevel` {`number`} - `headingLevel` as a safe `aria-level`: a whole number clamped to 1–6, and 1 for anything non-numeric.\n\n  * `BUBBLES` {`boolean`} - \n\n  * `COMPOSED` {`boolean`} - \n\n  * `CANCELABLE` {`boolean`} - ",
       "attributes": [
         {
           "name": "nav-collapsed",
-          "description": "`nav-collapsed` {`boolean`} - The user's nav preference. The nav can still render as a rail while this is\nfalse — see `navLocked`.\n\nProperty: navCollapsed\n\nDefault: false",
+          "description": "`nav-collapsed` {`boolean`} - The user's nav preference. The nav can still render as a rail while this is false — see `navLocked`.\n\nProperty: navCollapsed\n\nDefault: false",
           "valueSet": "v"
         },
         {
@@ -165,13 +182,41 @@
         },
         {
           "name": "no-panel",
-          "description": "`no-panel` {`boolean`} - Unmounts the AI panel for this route even when the `panel` slot is filled.\n`openPanel()` becomes a no-op.\n\nProperty: noPanel\n\nDefault: false",
+          "description": "`no-panel` {`boolean`} - Unmounts the AI panel for this route even when the `panel` slot is filled; `openPanel()` becomes a no-op.\n\nProperty: noPanel\n\nDefault: false",
           "valueSet": "v"
         },
         {
           "name": "panel-label",
           "description": "`panel-label` {`string`} - The default panel heading. Ignored when `panel-header` is slotted.\n\nProperty: panelLabel\n\nDefault: Ask Aquera"
         },
+        {
+          "name": "pageTitle",
+          "description": "`pageTitle` {`string | undefined`} - The page title, rendered as the top bar's own heading (`role=\"heading\"`, level from `headingLevel`) before anything slotted into `top-bar`; leave unset and no title block renders.\n\nProperty: pageTitle",
+          "values": []
+        },
+        {
+          "name": "headingLevel",
+          "description": "`headingLevel` {`number`} - The `aria-level` of the `pageTitle` heading, 1–6, so the title can fit the page's own heading outline; e.g. 2 when the page body or banner already has its h1. Out-of-range values clamp to 1–6 and non-numbers fall back to 1.\n\nProperty: headingLevel\n\nDefault: 1"
+        },
+        {
+          "name": "description",
+          "description": "`description` {`string | undefined`} - A second line under the page title; a modifier on `pageTitle` that renders nothing with no title, and takes the bar to 76px.\n\nProperty: description",
+          "values": []
+        },
+        {
+          "name": "badge",
+          "description": "`badge` {`string | undefined`} - A pill after the page title; a modifier on `pageTitle` like `description`, so with no title there is no badge.\n\nProperty: badge",
+          "values": []
+        },
+        {
+          "name": "headerBack",
+          "description": "`headerBack` {`boolean`} - Shows the back arrow before the page title; pressing it emits `nile-click` with `{ value: 'back' }`. Independent of the `app-icon` slot.\n\nProperty: headerBack\n\nDefault: false",
+          "valueSet": "v"
+        },
+        {
+          "name": "headerBackLabel",
+          "description": "`headerBackLabel` {`string`} - Accessible name of the header back control. Never rendered as visible text.\n\nProperty: headerBackLabel\n\nDefault: Back"
+        },
         {
           "name": "no-nav-toggle",
           "description": "`no-nav-toggle` {`boolean`} - Hides the built-in nav toggle. Mount `nile-app-shell-nav-toggle` yourself.\n\nProperty: noNavToggle\n\nDefault: false",
@@ -217,7 +262,7 @@
         },
         {
           "name": "content-container",
-          "description": "`content-container` {`boolean`} - Makes the slotted page root a size query container, so page CSS can size\nagainst the content container instead of the viewport. Query it unnamed —\n`@container (min-width: 720px)` — because a container name declared inside\nthe shell's shadow tree is not visible to page CSS. Opt-in, because it\nalso applies layout containment to that element.\n\nProperty: contentContainer\n\nDefault: false",
+          "description": "`content-container` {`boolean`} - Makes the slotted page root a size query container, so page CSS can size against the content container instead of the viewport.\n\nProperty: contentContainer\n\nDefault: false",
           "valueSet": "v"
         },
         {
@@ -232,13 +277,27 @@
         },
         {
           "name": "ask-label",
-          "description": "`ask-label` {`string`} - The label on the built-in Ask button.\n\nThe button is the shell's, not the app's: it is the one control that has\nto know whether a panel is mounted for this route and how to open it, and\nslotted content can see neither. Everything else in the bar — the\nbreadcrumb, the page actions, the tab strip — is slotted markup.\n\nProperty: askLabel\n\nDefault: Ask"
+          "description": "`ask-label` {`string`} - The label on the built-in Ask button.\n\nProperty: askLabel\n\nDefault: Ask"
         },
         {
           "name": "no-ask",
           "description": "`no-ask` {`boolean`} - Drops the built-in Ask button, for a bar that renders its own.\n\nProperty: noAsk\n\nDefault: false",
           "valueSet": "v"
         },
+        {
+          "name": "panelBack",
+          "description": "`panelBack` {`boolean`} - Shows a back control at the start of the panel header for a panel sub-view; emits `nile-panel-back`.\n\nProperty: panelBack\n\nDefault: false",
+          "valueSet": "v"
+        },
+        {
+          "name": "panelBackLabel",
+          "description": "`panelBackLabel` {`string`} - Accessible name of the panel's back control.\n\nProperty: panelBackLabel\n\nDefault: Back"
+        },
+        {
+          "name": "noTabs",
+          "description": "`noTabs` {`boolean`} - Hides the tab strip for this route even when the `tabs` slot is filled.\n\nProperty: noTabs\n\nDefault: false",
+          "valueSet": "v"
+        },
         {
           "name": "full-height",
           "description": "`full-height` {`boolean`} - Sizes the shell to the viewport instead of its parent.\n\nProperty: fullHeight\n\nDefault: false",
@@ -246,28 +305,36 @@
         },
         {
           "name": "overlay-breakpoint",
-          "description": "`overlay-breakpoint` {`number`} - Below this shell width the panel overlays the content instead of pushing\nit, and the nav is forced to a rail.\n\nZero — the default — means never: the panel is furniture that squeezes the\npage, at every width. It earns its room from the nav rail first and from\nits own width next (see `--nile-app-shell-panel-min-width`), so it does\nnot have to cover the page to fit. Set a width here to opt back into an\noverlay drawer below it.\n\nProperty: overlayBreakpoint\n\nDefault: 0"
+          "description": "`overlay-breakpoint` {`number`} - Below this shell width the panel overlays the content instead of pushing it, and the nav is forced to a rail; zero (default) means never.\n\nProperty: overlayBreakpoint\n\nDefault: 0"
         },
         {
           "name": "docked-rail-breakpoint",
-          "description": "`docked-rail-breakpoint` {`number`} - Below this shell width an open docked panel forces the nav to a rail.\nA floor, not the whole rule: the nav also rails as soon as the expanded\ntrack is what stops the row from fitting. This is the first thing the\npanel takes room from, so it can push rather than cover.\n\nProperty: dockedRailBreakpoint\n\nDefault: 1440"
+          "description": "`docked-rail-breakpoint` {`number`} - Below this shell width an open docked panel forces the nav to a rail.\n\nProperty: dockedRailBreakpoint\n\nDefault: 1440"
         },
         {
           "name": "persist-key",
-          "description": "`persist-key` {`string | undefined`} - Persists the nav preference and the docked panel state under this key.\nOverlay panel state is never persisted — a reload opens closed.\n\nProperty: persistKey",
+          "description": "`persist-key` {`string | undefined`} - Persists the nav preference and docked panel state under this key. Overlay panel state is never persisted.\n\nProperty: persistKey",
           "values": []
         },
         {
           "name": "onnile-nav-toggle",
-          "description": "`nile-nav-toggle` {} - Emitted after the nav's collapsed state or its\nforced-rail lock changes. `detail: { collapsed, locked }`."
+          "description": "`nile-nav-toggle` {} - Emitted after the nav's collapsed state or forced-rail lock changes. `detail: { collapsed, locked }`."
         },
         {
           "name": "onnile-panel-toggle",
-          "description": "`nile-panel-toggle` {} - Emitted after the panel opens or closes.\n`detail: { open, mode }`."
+          "description": "`nile-panel-toggle` {} - Emitted after the panel opens or closes. `detail: { open, mode }`."
         },
         {
           "name": "onnile-panel-mode-change",
-          "description": "`nile-panel-mode-change` {} - Emitted when the panel flips between docked\nand overlay. `detail: { mode }`."
+          "description": "`nile-panel-mode-change` {} - Emitted when the panel flips between docked and overlay. `detail: { mode }`."
+        },
+        {
+          "name": "onnile-click",
+          "description": "`nile-click` {} - Emitted when the header's back control is pressed, or `goBackHeader()` is called. `detail: { value: 'back' }`. Emitted on the shell itself, so check `event.target === shell` as well as the value: a `nile-click` from page content bubbles through the shell too."
+        },
+        {
+          "name": "onnile-panel-back",
+          "description": "`nile-panel-back` {} - Emitted when the panel's back control is pressed, whether the shell's built-in panel chrome or a slotted `nile-app-shell-panel` draws it."
         }
       ]
     },