@nubisco/ui 3.2.0 → 3.4.0

package/dist/components/Shell.d.ts

@@ -1,9 +1,25 @@
 type TInspectorSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl'
 type TSidebarVariant = 'compact' | 'verbose'
+type TShellTopbar = 'auto' | 'always' | 'never'
+type TShellCollapseAt = 'md' | 'lg' | 'none'
 
 interface IShellProps {
   /**
    * Whether the inspector column is visible.
+   *
+   * Controlled or uncontrolled, on the same rule as `sidebarOpen` and
+   * `inspectorWidth`: pass it (as `v-model:inspector-visible`) and the
+   * application owns the state, leave it out and the shell owns it. Either way
+   * `update:inspectorVisible` is emitted when the shell closes the inspector
+   * itself, which happens on Escape and on the sheet's dismiss button below
+   * `collapseAt`.
+   *
+   * The shell will always be able to close its own sheet: a shell given
+   * `:inspector-visible="true"` with nothing listening for the update still
+   * hides the overlay locally rather than leaving the user trapped behind it.
+   * That override is scoped to the overlay and clears itself as soon as the
+   * application sets the prop true again or the frame stops collapsing, so the
+   * desktop column is untouched by it.
    * @default false
    */
   inspectorVisible?: boolean
@@ -24,19 +40,32 @@ interface IShellProps {
    */
   inspectorSize?: TInspectorSize
   /**
-   * Allow the user to resize the inspector by dragging its left edge, clamped
-   * between the `inspectorSize` width (the floor) and 50% of the viewport.
+   * Allow the user to resize the inspector by dragging its left edge (or by
+   * focusing the handle and using the arrow keys), clamped between 288px (the
+   * floor) and 50% of the current viewport. The upper clamp is re-evaluated
+   * when the window resizes, so a width persisted on a wide monitor cannot
+   * squeeze the body on a narrow one.
    * Double-clicking the handle resets to the `inspectorSize` default. Pair with
-   * `v-model:inspector-width` to persist the chosen width.
+   * `v-model:inspector-width` to persist the chosen width; without it the shell
+   * keeps the width itself, so `resizable` alone is a working control rather
+   * than a handle that moves nothing.
    * @default false
    */
   resizable?: boolean
   /**
    * The user-chosen inspector width in pixels when `resizable` is on, as a
-   * v-model (`v-model:inspector-width`). `null` (the default / reset state)
-   * means "use the `inspectorSize` width". The component emits
-   * `update:inspectorWidth` on drag and on double-click reset; the consumer
-   * owns persistence.
+   * v-model (`v-model:inspector-width`). `null` means "use the `inspectorSize`
+   * width", which is what a reset emits.
+   *
+   * Controlled or uncontrolled, decided once at setup by whether the prop was
+   * passed at all:
+   *
+   * - passed (including as `null`): the application owns the width and the
+   *   shell renders exactly what it is given. `update:inspectorWidth` is
+   *   emitted on drag, on the arrow keys and on reset.
+   * - omitted: the shell owns the width internally. The handle still works and
+   *   still emits, so an application can listen without binding, but nothing
+   *   has to be stored for the drag to do anything.
    */
   inspectorWidth?: number | null
   /**
@@ -55,6 +84,107 @@ interface IShellProps {
    * @default 'compact'
    */
   sidebarVariant?: TSidebarVariant
+  /**
+   * When the topbar strip is rendered.
+   *
+   * - 'auto': rendered only when `topbar-left` or `topbar-right` has content,
+   *   or a view has claimed one of them with `useShellSlot()`. An application
+   *   that passes neither gets no empty 50px bar and no border line to hide
+   *   from the outside.
+   * - 'always': rendered unconditionally. This is what the shell did before
+   *   the check existed; set it if a layout depends on the bar's height being
+   *   reserved even while it is empty.
+   * - 'never': never rendered, whatever the slots say. For a full-bleed route
+   *   inside an application whose shell is declared once, further up.
+   *
+   * @default 'auto'
+   */
+  topbar?: TShellTopbar
+  /**
+   * Render the "skip to content" link as the shell's first focusable element.
+   *
+   * The shell is the only component that knows where the main region is, so it
+   * is the only one that can wire a skip link without the application inventing
+   * an id. It is visually hidden until focused, so the first Tab on any page
+   * offers it and nothing else changes.
+   *
+   * Set to `false` only if the application already ships its own.
+   * @default true
+   */
+  skipToContent?: boolean
+  /**
+   * Label for the skip link. Override for a localised application.
+   * @default 'Skip to content'
+   */
+  skipToContentLabel?: string
+  /**
+   * The `id` put on the `<main>` element, and the skip link's target. Set it
+   * when something outside the shell needs to address the main region by a
+   * known id (a router scroll behaviour, an `aria-controls`). Defaults to a
+   * per-instance stable id, so two shells on one page do not collide.
+   */
+  mainId?: string
+  /**
+   * Accessible name for the sidebar `<nav>` landmark. Two navigation landmarks
+   * on a page (the rail plus in-page nav) are indistinguishable in a landmark
+   * list without one.
+   * @default 'Primary'
+   */
+  sidebarLabel?: string
+  /**
+   * Accessible name for the inspector `<aside>` landmark.
+   * @default 'Inspector'
+   */
+  inspectorLabel?: string
+  /**
+   * The viewport width below which the frame stops being three columns.
+   *
+   * A 240px verbose rail plus a 288px inspector leaves nothing for the page on
+   * a phone, and the frame is `height: 100dvh; overflow: hidden`, so there is
+   * no scroll to escape into. Below this width the sidebar becomes an overlay
+   * drawer behind a toggle button and the inspector becomes a full-screen
+   * sheet over the content row, topbar included, carrying its own dismiss
+   * button. The same thing happens at 200% browser zoom on a
+   * laptop, because zoom shrinks the viewport in CSS pixels, which is the
+   * WCAG 1.4.10 reflow case.
+   *
+   * - 'md': collapse below 672px. The default.
+   * - 'lg': collapse below 1056px. For products whose rail is verbose and
+   *   whose inspector is usually open.
+   * - 'none': never collapse. The pre-3.3 layout, for a frame that is only
+   *   ever shown on a desktop (an installed desktop build, a control room).
+   *
+   * @default 'md'
+   */
+  collapseAt?: TShellCollapseAt
+  /**
+   * Whether the navigation drawer is open at collapsed widths. Optional: pass
+   * it (as `v-model:sidebar-open`) to drive the drawer from the application,
+   * leave it out and the shell owns the state itself. Ignored above
+   * `collapseAt`, where the sidebar is a permanent column.
+   */
+  sidebarOpen?: boolean
+  /**
+   * Accessible name for the button that opens the navigation drawer. The
+   * button carries `aria-expanded`, so the label should name the thing, not
+   * the action: "Navigation", not "Open navigation".
+   * @default 'Navigation'
+   */
+  navToggleLabel?: string
+  /**
+   * Accessible name for the button that closes the inspector sheet below
+   * `collapseAt`. The button is rendered only in that overlay state, where the
+   * sheet covers the topbar and therefore any close control the product put
+   * there.
+   * @default 'Close inspector'
+   */
+  inspectorCloseLabel?: string
 }
 
-export { IShellProps, TInspectorSize, TSidebarVariant }
+export {
+  IShellProps,
+  TInspectorSize,
+  TSidebarVariant,
+  TShellTopbar,
+  TShellCollapseAt,
+}

package/dist/components/Shell.vue.d.ts

@@ -1,4 +1,6 @@
-import { IShellProps } from './Shell.d';
+import { IShellProps, TInspectorSize } from './Shell.d';
+declare function setDrawerOpen(open: boolean): void;
+declare function setInspectorVisible(visible: boolean): void;
 declare var __VLS_1: {}, __VLS_3: {}, __VLS_5: {}, __VLS_7: {}, __VLS_9: {}, __VLS_11: {}, __VLS_13: {}, __VLS_15: {}, __VLS_17: {}, __VLS_19: {}, __VLS_27: {}, __VLS_29: {}, __VLS_31: {};
 type __VLS_Slots = {} & {
     'outer-menu'?: (props: typeof __VLS_1) => any;
@@ -27,17 +29,42 @@ type __VLS_Slots = {} & {
 } & {
     inspector?: (props: typeof __VLS_31) => any;
 };
-declare const __VLS_base: import("vue").DefineComponent<IShellProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+declare const __VLS_base: import("vue").DefineComponent<IShellProps, {
+    /** The `<main>` element, so a parent can scroll or measure the page ground. */
+    mainEl: import("vue").Ref<HTMLElement | null, HTMLElement | null>;
+    /** The sidebar `<nav>`, or null when no sidebar slot has content. */
+    sidebarEl: import("vue").Ref<HTMLElement | null, HTMLElement | null>;
+    /** The inspector `<aside>`. Always present; it animates from zero width. */
+    inspectorEl: import("vue").Ref<HTMLElement | null, HTMLElement | null>;
+    /** Move focus to the main region, exactly as the skip link does. */
+    focusMain: () => void | undefined;
+    /** Open or close the navigation drawer. No-op above `collapseAt`. */
+    setSidebarOpen: typeof setDrawerOpen;
+    /** Show or hide the inspector, and emit `update:inspectorVisible`. */
+    setInspectorVisible: typeof setInspectorVisible;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:inspectorWidth": (width: number | null) => any;
+    "update:sidebarOpen": (open: boolean) => any;
+    "update:inspectorVisible": (visible: boolean) => any;
 }, string, import("vue").PublicProps, Readonly<IShellProps> & Readonly<{
     "onUpdate:inspectorWidth"?: ((width: number | null) => any) | undefined;
+    "onUpdate:sidebarOpen"?: ((open: boolean) => any) | undefined;
+    "onUpdate:inspectorVisible"?: ((visible: boolean) => any) | undefined;
 }>, {
     inspectorVisible: boolean;
     inspectorExpanded: boolean;
-    inspectorSize: import("./Shell.d").TInspectorSize;
+    inspectorSize: TInspectorSize;
     resizable: boolean;
     mainPadding: boolean;
     sidebarVariant: import("./Shell.d").TSidebarVariant;
+    topbar: import("./Shell.d").TShellTopbar;
+    skipToContent: boolean;
+    skipToContentLabel: string;
+    sidebarLabel: string;
+    inspectorLabel: string;
+    collapseAt: import("./Shell.d").TShellCollapseAt;
+    navToggleLabel: string;
+    inspectorCloseLabel: string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;

package/dist/components/Shell.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Shell.vue.d.ts","sourceRoot":"","sources":["../../src/components/Shell.vue"],"names":[],"mappings":"AAklBA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AA2WvC,QAAA,IAAI,OAAO,IAAU,EAAE,OAAO,IAAU,EAAE,OAAO,IAAU,EAAE,OAAO,IAAU,EAAE,OAAO,IAAU,EAAE,QAAQ,IAAW,EAAE,QAAQ,IAAW,EAAE,QAAQ,IAAW,EAAE,QAAQ,IAAW,EAAE,QAAQ,IAAW,EAAE,QAAQ,IAAW,EAAE,QAAQ,IAAW,EAAE,QAAQ,IAAY,CAAE;AAC5Q,KAAK,WAAW,GAAG,EAAE,GACnB;IAAE,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,OAAO,KAAK,GAAG,CAAA;CAAE,GACjD;IAAE,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,OAAO,KAAK,GAAG,CAAA;CAAE,GACnD;IAAE,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,OAAO,KAAK,GAAG,CAAA;CAAE,GAClD;IAAE,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,OAAO,KAAK,GAAG,CAAA;CAAE,GACrD;IAAE,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,OAAO,KAAK,GAAG,CAAA;CAAE,GACjD;IAAE,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,QAAQ,KAAK,GAAG,CAAA;CAAE,GAClD;IAAE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,QAAQ,KAAK,GAAG,CAAA;CAAE,GAC7C;IAAE,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,QAAQ,KAAK,GAAG,CAAA;CAAE,GACnD;IAAE,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,QAAQ,KAAK,GAAG,CAAA;CAAE,GACpD;IAAE,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,QAAQ,KAAK,GAAG,CAAA;CAAE,GAC9C;IAAE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,QAAQ,KAAK,GAAG,CAAA;CAAE,GAC7C;IAAE,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,QAAQ,KAAK,GAAG,CAAA;CAAE,GAC5C;IAAE,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,QAAQ,KAAK,GAAG,CAAA;CAAE,CAAC;AAOlD,QAAA,MAAM,UAAU;;;;;;;;;;;6EAId,CAAC;AACH,QAAA,MAAM,YAAY,EAAS,eAAe,CAAC,OAAO,UAAU,EAAE,WAAW,CAAC,CAAC;wBACtD,OAAO,YAAY;AAAxC,wBAAyC;AAWzC,KAAK,eAAe,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IAChC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KACV,CAAA;CACD,CAAC"}
+{"version":3,"file":"Shell.vue.d.ts","sourceRoot":"","sources":["../../src/components/Shell.vue"],"names":[],"mappings":"AAoqDA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAuSvD,iBAAS,aAAa,CAAC,IAAI,EAAE,OAAO,QAGnC;AA2FD,iBAAS,mBAAmB,CAAC,OAAO,EAAE,OAAO,QAQ5C;AA0yBD,QAAA,IAAI,OAAO,IAAU,EAAE,OAAO,IAAU,EAAE,OAAO,IAAU,EAAE,OAAO,IAAU,EAAE,OAAO,IAAU,EAAE,QAAQ,IAAW,EAAE,QAAQ,IAAW,EAAE,QAAQ,IAAW,EAAE,QAAQ,IAAW,EAAE,QAAQ,IAAW,EAAE,QAAQ,IAAW,EAAE,QAAQ,IAAW,EAAE,QAAQ,IAAY,CAAE;AAC5Q,KAAK,WAAW,GAAG,EAAE,GACnB;IAAE,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,OAAO,KAAK,GAAG,CAAA;CAAE,GACjD;IAAE,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,OAAO,KAAK,GAAG,CAAA;CAAE,GACnD;IAAE,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,OAAO,KAAK,GAAG,CAAA;CAAE,GAClD;IAAE,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,OAAO,KAAK,GAAG,CAAA;CAAE,GACrD;IAAE,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,OAAO,KAAK,GAAG,CAAA;CAAE,GACjD;IAAE,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,QAAQ,KAAK,GAAG,CAAA;CAAE,GAClD;IAAE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,QAAQ,KAAK,GAAG,CAAA;CAAE,GAC7C;IAAE,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,QAAQ,KAAK,GAAG,CAAA;CAAE,GACnD;IAAE,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,QAAQ,KAAK,GAAG,CAAA;CAAE,GACpD;IAAE,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,QAAQ,KAAK,GAAG,CAAA;CAAE,GAC9C;IAAE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,QAAQ,KAAK,GAAG,CAAA;CAAE,GAC7C;IAAE,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,QAAQ,KAAK,GAAG,CAAA;CAAE,GAC5C;IAAE,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,QAAQ,KAAK,GAAG,CAAA;CAAE,CAAC;AAWlD,QAAA,MAAM,UAAU;IArcd,+EAA+E;;IAE/E,qEAAqE;;IAErE,4EAA4E;;IAE5E,oEAAoE;;IAEpE,qEAAqE;;IAErE,sEAAsE;;;;;;;;;;;;;;;;;;;;;;;;;6EAgctE,CAAC;AACH,QAAA,MAAM,YAAY,EAAS,eAAe,CAAC,OAAO,UAAU,EAAE,WAAW,CAAC,CAAC;wBACtD,OAAO,YAAY;AAAxC,wBAAyC;AAWzC,KAAK,eAAe,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IAChC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KACV,CAAA;CACD,CAAC"}

package/dist/components/ShellPanel.d.ts

@@ -30,4 +30,20 @@ export interface IShellPanelProps {
    * @default false
    */
   fluid?: boolean
+  /**
+   * Claim the parent's height and scroll internally. Same name and same
+   * semantics as `fill` on NbDataTable: the panel becomes a flex item that
+   * takes the space left in a bounded flex column, its header stays pinned,
+   * and the content region gets the scrollbar.
+   *
+   * Like the table, it claims a height rather than creating one: an ancestor
+   * has to bound it (a flex column with `min-height: 0`, which NbShell's
+   * `bottom` region and inspector column already are).
+   *
+   * Wins over `fluid` when both are set, and has no effect on a `collapsed`
+   * panel, which is header-only by definition.
+   *
+   * @default false
+   */
+  fill?: boolean
 }

package/dist/components/ShellPanel.vue.d.ts

@@ -18,6 +18,7 @@ declare const __VLS_base: import("vue").DefineComponent<IShellPanelProps, {
     "onUpdate:size"?: ((size: TShellPanelSize) => any) | undefined;
 }>, {
     size: TShellPanelSize;
+    fill: boolean;
     title: string;
     fluid: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;

package/dist/components/ShellPanel.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ShellPanel.vue.d.ts","sourceRoot":"","sources":["../../src/components/ShellPanel.vue"],"names":[],"mappings":"AAkSA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAwBvE,iBAAS,OAAO,CAAC,IAAI,EAAE,eAAe,QAErC;AAwLD,QAAA,IAAI,OAAO,IAAU,EAAE,OAAO,IAAU,EAAE,OAAO,IAAU,EAAE,OAAO,IAAW,CAAE;AACjF,KAAK,WAAW,GAAG,EAAE,GACnB;IAAE,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,OAAO,KAAK,GAAG,CAAA;CAAE,GAC1C;IAAE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,OAAO,KAAK,GAAG,CAAA;CAAE,GAC5C;IAAE,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,OAAO,KAAK,GAAG,CAAA;CAAE,GAC7C;IAAE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,OAAO,KAAK,GAAG,CAAA;CAAE,CAAC;AAK/C,QAAA,MAAM,UAAU;;;;;;;;;;6EAKd,CAAC;AACH,QAAA,MAAM,YAAY,EAAS,eAAe,CAAC,OAAO,UAAU,EAAE,WAAW,CAAC,CAAC;wBACtD,OAAO,YAAY;AAAxC,wBAAyC;AAWzC,KAAK,eAAe,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IAChC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KACV,CAAA;CACD,CAAC"}
+{"version":3,"file":"ShellPanel.vue.d.ts","sourceRoot":"","sources":["../../src/components/ShellPanel.vue"],"names":[],"mappings":"AAwWA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAyBvE,iBAAS,OAAO,CAAC,IAAI,EAAE,eAAe,QAErC;AAkND,QAAA,IAAI,OAAO,IAAU,EAAE,OAAO,IAAU,EAAE,OAAO,IAAU,EAAE,OAAO,IAAW,CAAE;AACjF,KAAK,WAAW,GAAG,EAAE,GACnB;IAAE,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,OAAO,KAAK,GAAG,CAAA;CAAE,GAC1C;IAAE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,OAAO,KAAK,GAAG,CAAA;CAAE,GAC5C;IAAE,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,OAAO,KAAK,GAAG,CAAA;CAAE,GAC7C;IAAE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,OAAO,KAAK,GAAG,CAAA;CAAE,CAAC;AAK/C,QAAA,MAAM,UAAU;;;;;;;;;;;6EAKd,CAAC;AACH,QAAA,MAAM,YAAY,EAAS,eAAe,CAAC,OAAO,UAAU,EAAE,WAAW,CAAC,CAAC;wBACtD,OAAO,YAAY;AAAxC,wBAAyC;AAWzC,KAAK,eAAe,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IAChC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KACV,CAAA;CACD,CAAC"}

package/dist/components/SidebarLink.d.ts

@@ -8,7 +8,20 @@ interface ISidebarLinkProps {
   to?: string | Record<string, unknown>
   /** External href — renders as a plain `<a>`. Used when `to` is not set. */
   href?: string
-  /** Tooltip text shown to the right of the sidebar on hover. */
+  /**
+   * Tooltip text shown to the right of the sidebar on hover.
+   *
+   * @deprecated Use the `v-nb-tooltip` directive instead. This prop renders a
+   * CSS-only `::after` chip that is hover-only (a keyboard user tabbing the
+   * sidebar gets nothing), gives the link no accessible name, cannot flip or
+   * clamp against the viewport, and is fixed to the right of the anchor, so it
+   * is clipped by any sidebar that is not the shell's own. It works only on
+   * this one component, which is why three apps rebuilt the affordance by hand
+   * for their topbars. `v-nb-tooltip="{ body: 'Settings' }"` replaces it and
+   * additionally names the link for assistive technology. The prop still works
+   * and is not scheduled for removal, but new code should not use it.
+   * See /ui/directives/tooltip.
+   */
   tooltip?: string
   /** Marks the link as the currently active route. */
   active?: boolean

package/dist/components/Skeleton.d.ts

@@ -0,0 +1,87 @@
+import { IDefaultProps } from '../types/Props.d'
+
+enum ESkeletonVariant {
+  /** One or more body text lines, sized from a type set. */
+  Text = 'text',
+  /** A single line sized from a heading type set. */
+  Heading = 'heading',
+  /** A rectangle: cards, images, charts, map panes, table cells. */
+  Block = 'block',
+  /** A circle: avatars and round icon buttons. */
+  Circle = 'circle',
+}
+
+/**
+ * Type sets the text and heading variants can borrow their metrics from.
+ * These are the same names the `--nb-type-*` custom properties are generated
+ * from, so a skeleton line is exactly as tall as the text that replaces it.
+ *
+ * The code sets are here because monospaced blocks are the worst offenders for
+ * layout shift: a JSON viewer placeholder measured with body metrics is a
+ * different height from the code that lands in it. `display-01` and
+ * `display-02` are left out on purpose, since marketing hero type does not
+ * arrive asynchronously.
+ */
+type TSkeletonTypeSet =
+  | 'label-sm'
+  | 'label-md'
+  | 'label-lg'
+  | 'body-sm'
+  | 'body-md'
+  | 'body-lg'
+  | 'code-sm'
+  | 'code-md'
+  | 'code-lg'
+  | 'heading-01'
+  | 'heading-02'
+  | 'heading-03'
+  | 'heading-04'
+  | 'heading-05'
+  | 'heading-06'
+
+interface ISkeletonProps extends IDefaultProps {
+  /** Shape family. */
+  variant?: `${ESkeletonVariant}`
+  /** Type set the line height is derived from. Text and heading variants only. */
+  type?: TSkeletonTypeSet
+  /** Number of text lines. Text variant only. */
+  lines?: number
+  /**
+   * Width of the last line when there is more than one, so a paragraph does
+   * not read as a solid rectangle. Any CSS length or percentage.
+   */
+  lastLineWidth?: string
+  /** Width of the placeholder. A number is treated as pixels. */
+  width?: string | number
+  /**
+   * Height of the placeholder. Block and circle variants only: text sizes
+   * itself from `type`. A number is treated as pixels.
+   */
+  height?: string | number
+  /** Corner radius step. Ignored by the circle variant. */
+  radius?: 'none' | 'xs' | 'sm' | 'md' | 'lg' | 'pill'
+  /** Turns the shimmer off. Static placeholders still read as loading. */
+  animated?: boolean
+  /**
+   * Accessible announcement. Set it on ONE skeleton per loading region and
+   * leave the rest silent, otherwise a table of forty placeholders announces
+   * itself forty times.
+   */
+  label?: string
+  /**
+   * Announced once, politely, when the skeleton unmounts ("Comments loaded").
+   * The swap from placeholder to content is silent otherwise: the live region
+   * that said "loading" is removed at the same moment the content arrives, so
+   * nothing is left to speak. Set it on the same single skeleton that carries
+   * `label`.
+   *
+   * It is announced on any unmount, because a component cannot read a prop
+   * changed by the same render that removed it. Where the load can fail, call
+   * `suppressLoadingAnnouncement()` in the catch (or drive the request through
+   * `useInlineLoading`, which does it for you) so a failure is not reported as
+   * an arrival.
+   */
+  completeLabel?: string
+}
+
+export { ESkeletonVariant, ISkeletonProps, TSkeletonTypeSet }

package/dist/components/Skeleton.vue.d.ts

@@ -0,0 +1,17 @@
+import { ESkeletonVariant, ISkeletonProps, TSkeletonTypeSet } from './Skeleton.d';
+declare const __VLS_export: import("vue").DefineComponent<ISkeletonProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<ISkeletonProps> & Readonly<{}>, {
+    label: string;
+    type: TSkeletonTypeSet;
+    height: string | number;
+    width: string | number;
+    id: string;
+    variant: `${ESkeletonVariant}`;
+    lines: number;
+    completeLabel: string;
+    lastLineWidth: string;
+    radius: "none" | "xs" | "sm" | "md" | "lg" | "pill";
+    animated: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;
+//# sourceMappingURL=Skeleton.vue.d.ts.map

package/dist/components/Skeleton.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Skeleton.vue.d.ts","sourceRoot":"","sources":["../../src/components/Skeleton.vue"],"names":[],"mappings":"AAwYA,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EACjB,MAAM,cAAc,CAAA;AAqPrB,QAAA,MAAM,YAAY;;;;;;;;;;;;6EAGhB,CAAC;wBACkB,OAAO,YAAY;AAAxC,wBAAyC"}

package/dist/components/Spinner.d.ts

@@ -0,0 +1,80 @@
+import { IDefaultProps } from '../types/Props.d'
+
+/**
+ * Diameter is derived from the field height scale: a spinner is always half
+ * the height of the field or button of the same size, so `size="md"` lines up
+ * optically inside an `md` control without any per-call-site nudging.
+ */
+enum ESpinnerSize {
+  ExtraSmall = 'xs',
+  Small = 'sm',
+  Medium = 'md',
+  Large = 'lg',
+}
+
+enum ESpinnerOverlay {
+  /** Inline: the spinner sits in normal flow and takes only its own box. */
+  None = 'none',
+  /**
+   * Covers the nearest positioned ancestor, and blocks it: everything that was
+   * inside that ancestor when the spinner appeared is marked `inert` and the
+   * ancestor is marked `aria-busy` until it leaves. That ancestor must be
+   * positioned.
+   */
+  Container = 'container',
+  /**
+   * Covers the viewport and blocks the application as it stood when it
+   * appeared. Anything opened afterwards (a dialog raised by the work itself)
+   * paints above it and stays usable.
+   */
+  Page = 'page',
+}
+
+enum ESpinnerTone {
+  /** Brand primary. The default for standalone spinners. */
+  Primary = 'primary',
+  /** Inherits `color` from the parent, for spinners inside buttons or rows. */
+  Inherit = 'inherit',
+}
+
+interface ISpinnerProps extends IDefaultProps {
+  /** Diameter step, mapped to half the matching field height. */
+  size?: `${ESpinnerSize}`
+  /**
+   * Accessible name announced by the live region. Say what is loading
+   * ("Loading invoices"), not that something is loading.
+   */
+  label?: string
+  /** Renders `label` as visible text beside the ring as well as announcing it. */
+  showLabel?: boolean
+  /** Where the spinner is placed: inline, over its container, or over the page. */
+  overlay?: `${ESpinnerOverlay}`
+  /** Ring colour source. */
+  tone?: `${ESpinnerTone}`
+  /**
+   * Milliseconds to wait before appearing. A spinner that flashes for 80ms is
+   * noise, so give fast operations a delay of 300 or so and they resolve
+   * before anything is drawn.
+   */
+  delay?: number
+  /**
+   * Announced once, politely, when the spinner unmounts because the work
+   * finished ("Invoices loaded"). A spinner that simply disappears tells a
+   * screen reader user nothing, so pair this with `label` on any load the user
+   * is waiting on rather than watching. Skipped when the spinner never became
+   * visible (a `delay` that outlived the request) and when `decorative`.
+   */
+  completeLabel?: string
+  /**
+   * Drops the role, the live region and the label. Use it only when an
+   * ancestor already announces the loading state (NbInlineLoading does this,
+   * and a button that swaps its own label for a spinner should too), so the
+   * same message is not announced twice.
+   *
+   * Ignored by `overlay="page"`: a full-viewport scrim is the element holding
+   * focus and nothing else is left to name it.
+   */
+  decorative?: boolean
+}
+
+export { ESpinnerSize, ESpinnerOverlay, ESpinnerTone, ISpinnerProps }

package/dist/components/Spinner.overlay.d.ts

@@ -0,0 +1,56 @@
+/**
+ * True for the overlay that arrived first, which is the only one allowed to
+ * paint the scrim. Reactive: if the bottom overlay leaves while a second is
+ * still up, the survivor takes over the paint rather than blocking invisibly.
+ */
+export declare function isBasePageOverlay(key: symbol): boolean;
+/** The overlay currently on top of the stack, for tests and debugging. */
+export declare function topPageOverlay(): HTMLElement | null;
+/**
+ * Marks a host that a blocking overlay must never inert.
+ *
+ * `inert` is deliberately blunt: it removes a subtree from hit testing, from
+ * the tab order AND from the accessibility tree. That is exactly right for the
+ * application, and exactly wrong for a node whose only job is to be read out.
+ * A toast raised while the page is blocked ("Session expired", "Import
+ * finished") is the message the blocked user most needs, and it paints above
+ * the scrim by token (`--nb-zindex-toast` is `--nb-zindex-modal` plus 50). If
+ * the region that speaks it is inert, the message is painted and silent, which
+ * is precisely the paint-and-focus disagreement this module claims to make
+ * impossible.
+ *
+ * So: put `data-nb-overlay-exempt` on any host that exists to announce rather
+ * than to be operated. In the library that is `NbToaster`'s announcer and its
+ * stack, plus the shared loading announcer. In an application it is any live
+ * region you own and mount at the top of the document. Nothing else should
+ * carry it: a form that opts itself out of blocking is a form the user can
+ * submit while the page says it cannot be used.
+ */
+export declare const NB_OVERLAY_EXEMPT_ATTR = "data-nb-overlay-exempt";
+/**
+ * Marks an element as exempt and returns a function that puts it back.
+ *
+ * For application-owned live regions. Call it once, when the region is
+ * mounted; the attribute is read at claim time, so an overlay that is already
+ * up does not pick it up retroactively.
+ */
+export declare function markOverlayExempt(element: HTMLElement): () => void;
+export declare function claimPageOverlay(key: symbol, element: HTMLElement): void;
+export declare function releasePageOverlay(key: symbol): void;
+/**
+ * Blocks one region rather than the page, for `overlay="container"`.
+ *
+ * A scrim over a panel stops the mouse and nothing else: the controls under it
+ * keep their place in the tab order, so a keyboard user tabs straight into a
+ * form that is visibly unavailable and submits it. The same snapshot rule
+ * applies here, scoped to the covered container: everything in it at the
+ * moment the spinner appeared is inert until the spinner leaves, the container
+ * is marked `aria-busy` so assistive tech reads it as being rebuilt, and both
+ * attributes are put back exactly as they were found.
+ *
+ * Returns the release function. Calling it twice is a no-op.
+ */
+export declare function containRegion(container: HTMLElement, exclude: HTMLElement): () => void;
+/** Test helper: drops all state and puts every borrowed attribute back. */
+export declare function resetPageOverlays(): void;
+//# sourceMappingURL=Spinner.overlay.d.ts.map

package/dist/components/Spinner.overlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Spinner.overlay.d.ts","sourceRoot":"","sources":["../../src/components/Spinner.overlay.ts"],"names":[],"mappings":"AAuEA;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED,0EAA0E;AAC1E,wBAAgB,cAAc,IAAI,WAAW,GAAG,IAAI,CAInD;AAID;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,sBAAsB,2BAA2B,CAAA;AA8B9D;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,IAAI,CAMlE;AAqID,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI,CA6BxE;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAgBpD;AAID;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,WAAW,EACtB,OAAO,EAAE,WAAW,GACnB,MAAM,IAAI,CAoBZ;AA6BD,2EAA2E;AAC3E,wBAAgB,iBAAiB,IAAI,IAAI,CAUxC"}

package/dist/components/Spinner.vue.d.ts

@@ -0,0 +1,25 @@
+import { ESpinnerOverlay, ESpinnerSize, ESpinnerTone, ISpinnerProps } from './Spinner.d';
+declare var __VLS_7: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_7) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<ISpinnerProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<ISpinnerProps> & Readonly<{}>, {
+    size: `${ESpinnerSize}`;
+    label: string;
+    id: string;
+    overlay: `${ESpinnerOverlay}`;
+    tone: `${ESpinnerTone}`;
+    showLabel: boolean;
+    delay: number;
+    completeLabel: string;
+    decorative: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};
+//# sourceMappingURL=Spinner.vue.d.ts.map

package/dist/components/Spinner.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Spinner.vue.d.ts","sourceRoot":"","sources":["../../src/components/Spinner.vue"],"names":[],"mappings":"AAifA,OAAO,EACL,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,aAAa,EACd,MAAM,aAAa,CAAA;AAsVpB,QAAA,IAAI,OAAO,IAAW,CAAE;AACxB,KAAK,WAAW,GAAG,EAAE,GACnB;IAAE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,OAAO,KAAK,GAAG,CAAA;CAAE,CAAC;AAO/C,QAAA,MAAM,UAAU;;;;;;;;;;6EAGd,CAAC;AACH,QAAA,MAAM,YAAY,EAAS,eAAe,CAAC,OAAO,UAAU,EAAE,WAAW,CAAC,CAAC;wBACtD,OAAO,YAAY;AAAxC,wBAAyC;AAWzC,KAAK,eAAe,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IAChC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KACV,CAAA;CACD,CAAC"}

package/dist/components/Stepper.context.d.ts

@@ -0,0 +1,48 @@
+import type { ComputedRef, InjectionKey, Ref } from 'vue';
+import type { EStepStatus, IStepperLabels } from './Stepper.d';
+/**
+ * One step's entry in the parent's registry.
+ *
+ * `el` is a getter rather than an element because a step registers during
+ * `setup()`, before its `<li>` exists. The parent calls it once the DOM is
+ * there, which is how the registry can be re-sorted into document order.
+ */
+export interface IStepperEntry {
+    uid: string;
+    disabled: ComputedRef<boolean>;
+    el: () => HTMLElement | null;
+}
+/**
+ * What an `NbStepperStep` needs from the `NbStepper` around it.
+ *
+ * Lives in a `.ts` rather than the `.d.ts` beside it because `Symbol()` is a
+ * runtime value, matching `Accordion.context.ts`.
+ */
+export interface IStepperContext {
+    /** Index of the current step. */
+    current: Readonly<Ref<number>>;
+    /** Furthest index reached, which is the boundary `navigable` opens up. */
+    furthest: Readonly<Ref<number>>;
+    orientation: Readonly<Ref<string>>;
+    size: Readonly<Ref<string>>;
+    navigable: Readonly<Ref<boolean>>;
+    labels: ComputedRef<Required<IStepperLabels>>;
+    /**
+     * Registered step ids in **document order**, which is the single source of
+     * every step's number and derived status. Mount order is not document order
+     * once a step is added, removed or moved after the first render.
+     */
+    order: Readonly<Ref<string[]>>;
+    /** Index of the one step that holds `tabindex="0"`, or -1 when none does. */
+    tabbable: ComputedRef<number>;
+    /** Add a step and get back its remover. */
+    register: (entry: IStepperEntry) => () => void;
+    /** Whether a step at `index` may be clicked back to. */
+    clickable: (index: number, disabled: boolean) => boolean;
+    /** Move to a step. Ignored unless `clickable` agrees. */
+    select: (index: number, disabled: boolean) => void;
+}
+/** Status resolution shared by the step and its tests. */
+export type TStepStatus = `${EStepStatus}`;
+export declare const NB_STEPPER_CONTEXT: InjectionKey<IStepperContext>;
+//# sourceMappingURL=Stepper.context.d.ts.map

package/dist/components/Stepper.context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Stepper.context.d.ts","sourceRoot":"","sources":["../../src/components/Stepper.context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,KAAK,CAAA;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAE9D;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,WAAW,CAAC,OAAO,CAAC,CAAA;IAC9B,EAAE,EAAE,MAAM,WAAW,GAAG,IAAI,CAAA;CAC7B;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,iCAAiC;IACjC,OAAO,EAAE,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;IAC9B,0EAA0E;IAC1E,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;IAC/B,WAAW,EAAE,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;IAClC,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;IAC3B,SAAS,EAAE,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAA;IACjC,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAA;IAC7C;;;;OAIG;IACH,KAAK,EAAE,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAA;IAC9B,6EAA6E;IAC7E,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IAC7B,2CAA2C;IAC3C,QAAQ,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,MAAM,IAAI,CAAA;IAC9C,wDAAwD;IACxD,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,KAAK,OAAO,CAAA;IACxD,yDAAyD;IACzD,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAA;CACnD;AAED,0DAA0D;AAC1D,MAAM,MAAM,WAAW,GAAG,GAAG,WAAW,EAAE,CAAA;AAE1C,eAAO,MAAM,kBAAkB,EAAE,YAAY,CAAC,eAAe,CAC/B,CAAA"}