@jini-ai/admin 0.1.0

package/dist/react/components/Sidebar.d.ts

@@ -0,0 +1,128 @@
+import { type FocusEvent, type MouseEvent, type ReactNode } from 'react';
+import type { AdminNavGroup, AdminNavItem } from '../../core/manifest/rules.js';
+/** Handlers that make any element participate in rail-mode tooltips. Spread onto a host's own
+ *  control: `<button {...railTooltipProps('Log out')}>`. */
+export interface RailTooltipHandlers {
+    onMouseEnter: (e: MouseEvent<HTMLElement>) => void;
+    onMouseLeave: () => void;
+    onFocus: (e: FocusEvent<HTMLElement>) => void;
+    onBlur: () => void;
+}
+export interface SidebarContextValue {
+    /** Whether the desktop rail is collapsed to icons. */
+    collapsed: boolean;
+    toggleRail: () => void;
+    /** Mobile drawer state, owned by the host. */
+    open: boolean;
+    /** Where the admin is mounted, applied to every item's route path. */
+    base: string;
+    /** The active panel id, matched against `AdminNavItem.id`. */
+    activeId: string;
+    /** Tooltip handlers for a host-supplied control. No-ops while the rail is expanded. */
+    railTooltipProps: (label: string) => RailTooltipHandlers;
+}
+/**
+ * Reads the enclosing `<Sidebar>`'s state. Throws outside one — see the file header on why this
+ * check is a runtime error rather than a type error.
+ */
+export declare function useSidebar(): SidebarContextValue;
+export interface SidebarProps {
+    /** The active panel's id — matched against `AdminNavItem.id` by `Sidebar.Nav`. */
+    activeId: string;
+    /** Where the admin is mounted. Defaults to `/core`'s `DEFAULT_ADMIN_BASE`. */
+    base?: string;
+    /** Mobile drawer state, owned by the host (it also renders the backdrop). Inert at desktop
+     *  widths, and deliberately distinct from the desktop rail collapse — see the file header. */
+    open?: boolean;
+    /** `localStorage` key for the desktop rail preference. A host with a pre-existing key should
+     *  supply it rather than strand every operator's saved preference behind this package's
+     *  default. */
+    railStorageKey?: string;
+    /**
+     * Rail state for an operator who has **no stored preference yet**. A host whose admin is
+     * icon-first by design passes `true`; every existing host omits it and keeps the expanded
+     * default. Never overrides a real stored choice — once the operator has toggled the rail even
+     * once, their preference wins on every later load.
+     *
+     * @default false
+     */
+    railDefaultCollapsed?: boolean;
+    /** Accessible name for the `<nav>` landmark. @default "Admin" */
+    label?: string;
+    /** Extra class names appended to `.cms-nav`. */
+    className?: string;
+    /** DOM id, for a host's `aria-controls` on its mobile toggle. @default "admin-sidebar" */
+    id?: string;
+    children?: ReactNode;
+}
+declare function SidebarRoot(props: SidebarProps): import("react").JSX.Element;
+export interface SidebarMobileHeaderProps {
+    onClose: () => void;
+    /** @default "Navigation" */
+    title?: ReactNode;
+    /** Accessible name for the close control. @default "Close navigation" */
+    closeLabel?: string;
+}
+/**
+ * The off-canvas drawer's own header row, hidden by the host stylesheet at desktop widths.
+ *
+ * Owns the open-transition focus move: when the drawer opens, focus lands on this close control
+ * rather than staying on the topbar toggle behind it, so a keyboard or screen-reader user is
+ * actually inside the drawer they just opened.
+ */
+declare function SidebarMobileHeader(props: SidebarMobileHeaderProps): import("react").JSX.Element;
+export interface SidebarNavProps {
+    /** From `/core`'s `buildNav(resolvePanels(panels, context))`. */
+    groups: readonly AdminNavGroup[];
+    /** Label on a `soon` item's badge. @default "Soon" */
+    soonLabel?: ReactNode;
+    /** Replaces the default row rendering entirely. `active` is precomputed from the root's
+     *  `activeId`; `href` already has the base applied. Use for a host that needs a framework
+     *  `<Link>` instead of an `<a>`. */
+    renderItem?: (item: AdminNavItem, ctx: {
+        active: boolean;
+        href: string;
+        collapsed: boolean;
+    }) => ReactNode;
+    /**
+     * Labels of groups whose heading toggles the section open/closed, persisted per
+     * `useNavSections`. Defaults to none, so a host that does not opt in renders exactly as before —
+     * this is additive, and an accordion appearing unannounced in an existing product would be a
+     * regression dressed as a feature.
+     *
+     * Matched against `AdminNavGroup.label` because that is the only stable identifier a group has
+     * (`buildNav` assigns no id), which also makes it the persistence key — see `useNavSections`.
+     */
+    collapsibleGroups?: readonly string[];
+}
+declare function SidebarNav(props: SidebarNavProps): import("react").JSX.Element;
+export interface SidebarFooterProps {
+    children?: ReactNode;
+    className?: string;
+}
+/** The bottom region. Carries no content of its own — the host decides what belongs there. */
+declare function SidebarFooter(props: SidebarFooterProps): import("react").JSX.Element;
+export interface SidebarRailToggleProps {
+    /** @default "Expand sidebar" */
+    expandLabel?: string;
+    /** @default "Collapse sidebar" */
+    collapseLabel?: string;
+}
+/**
+ * Desktop rail collapse control. A real accessible name plus `aria-expanded` — not a bare icon
+ * button. Typically hidden by the host stylesheet inside the mobile drawer, which has its own close
+ * control and no rail concept.
+ */
+declare function SidebarRailToggle(props: SidebarRailToggleProps): import("react").JSX.Element;
+/**
+ * Grouped admin sidebar. See the file header for why this is a compound component and what the
+ * context costs.
+ */
+export declare const Sidebar: typeof SidebarRoot & {
+    MobileHeader: typeof SidebarMobileHeader;
+    Nav: typeof SidebarNav;
+    Footer: typeof SidebarFooter;
+    RailToggle: typeof SidebarRailToggle;
+};
+export {};
+//# sourceMappingURL=Sidebar.d.ts.map

package/dist/react/components/Sidebar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Sidebar.d.ts","sourceRoot":"","sources":["../../../src/react/components/Sidebar.tsx"],"names":[],"mappings":"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"}

package/dist/react/components/Sidebar.js

@@ -0,0 +1,168 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { Fragment, createContext, useContext, useEffect, useMemo, useRef, useState, } from 'react';
+import { createPortal } from 'react-dom';
+import { DEFAULT_ADMIN_BASE, adminHref } from '../../core/routing/rules.js';
+import { useNavSections } from '../hooks/use-nav-sections.js';
+import { useSidebarRail } from '../hooks/use-sidebar-rail.js';
+const SidebarContext = createContext(null);
+/**
+ * Reads the enclosing `<Sidebar>`'s state. Throws outside one — see the file header on why this
+ * check is a runtime error rather than a type error.
+ */
+export function useSidebar() {
+    const value = useContext(SidebarContext);
+    if (!value) {
+        throw new Error('useSidebar (and Sidebar.Nav / Sidebar.Footer / Sidebar.RailToggle / Sidebar.MobileHeader) ' +
+            'must be rendered inside a <Sidebar>. The rail-collapse state they read is published by ' +
+            'the Sidebar root.');
+    }
+    return value;
+}
+function Icon(props) {
+    return (_jsx("svg", { viewBox: "0 0 18 18", fill: "none", stroke: "currentColor", strokeWidth: 1.5, dangerouslySetInnerHTML: { __html: props.markup } }));
+}
+/**
+ * Rail-mode tooltip, portaled to `document.body`.
+ *
+ * Not a CSS-only `position: absolute` child of the hovered item (the first approach tried here) —
+ * `.cms-nav` needs `overflow-y: auto` for its own scrollbar, and the CSS overflow spec computes an
+ * omitted or even an explicitly-`visible` `overflow-x` to `auto` the instant the other axis isn't
+ * `visible` (verified live: setting `overflow-x: visible` alongside `overflow-y: auto` still read
+ * back as `overflow-x: auto` via `getComputedStyle`). That silently clips anything positioned to
+ * escape the rail's edge — `opacity`/`visibility` both read correctly in a probe, but nothing
+ * painted. A portal sidesteps the ancestor entirely: a DOM sibling of the app root, not a
+ * descendant of the clipping element, positioned with `position: fixed` from the hovered element's
+ * own `getBoundingClientRect()`.
+ */
+function RailTooltip(props) {
+    if (!props.target)
+        return null;
+    return createPortal(_jsx("div", { className: "cms-tooltip-portal", style: { top: props.target.top, left: props.target.left }, role: "presentation", children: props.target.label }), document.body);
+}
+function SidebarRoot(props) {
+    const rail = useSidebarRail(props.railStorageKey, props.railDefaultCollapsed);
+    const [tooltip, setTooltip] = useState(null);
+    const open = props.open ?? false;
+    const base = props.base ?? DEFAULT_ADMIN_BASE;
+    // Rail state can change (toggled, or the viewport crossing the breakpoint) while a tooltip is
+    // showing; drop it rather than let a stale one float over content that no longer corresponds to
+    // a collapsed rail.
+    useEffect(() => {
+        setTooltip(null);
+    }, [rail.collapsed]);
+    const value = useMemo(() => {
+        function show(e, label) {
+            if (!rail.collapsed)
+                return;
+            const r = e.currentTarget.getBoundingClientRect();
+            setTooltip({ label, top: r.top + r.height / 2, left: r.right + 10 });
+        }
+        function hide() {
+            setTooltip(null);
+        }
+        return {
+            collapsed: rail.collapsed,
+            toggleRail: rail.toggle,
+            open,
+            base,
+            activeId: props.activeId,
+            railTooltipProps: (label) => ({
+                onMouseEnter: (e) => show(e, label),
+                onMouseLeave: hide,
+                onFocus: (e) => show(e, label),
+                onBlur: hide,
+            }),
+        };
+    }, [rail.collapsed, rail.toggle, open, base, props.activeId]);
+    const className = [
+        'cms-nav scroll',
+        open ? 'is-open' : null,
+        rail.collapsed ? 'is-rail' : null,
+        props.className,
+    ]
+        .filter(Boolean)
+        .join(' ');
+    return (_jsx(SidebarContext.Provider, { value: value, children: _jsxs("nav", { className: className, "aria-label": props.label ?? 'Admin', id: props.id ?? 'admin-sidebar', children: [props.children, _jsx(RailTooltip, { target: tooltip })] }) }));
+}
+/**
+ * The off-canvas drawer's own header row, hidden by the host stylesheet at desktop widths.
+ *
+ * Owns the open-transition focus move: when the drawer opens, focus lands on this close control
+ * rather than staying on the topbar toggle behind it, so a keyboard or screen-reader user is
+ * actually inside the drawer they just opened.
+ */
+function SidebarMobileHeader(props) {
+    const { open } = useSidebar();
+    const closeButtonRef = useRef(null);
+    useEffect(() => {
+        if (open)
+            closeButtonRef.current?.focus();
+    }, [open]);
+    return (_jsxs("div", { className: "cms-nav-mobile-head", children: [_jsx("span", { children: props.title ?? 'Navigation' }), _jsx("button", { ref: closeButtonRef, type: "button", className: "cms-nav-close", onClick: props.onClose, "aria-label": props.closeLabel ?? 'Close navigation', children: _jsx("svg", { viewBox: "0 0 18 18", fill: "none", stroke: "currentColor", strokeWidth: 1.5, children: _jsx("path", { d: "M5 5 13 13M13 5 5 13", strokeLinecap: "round" }) }) })] }));
+}
+function SidebarNav(props) {
+    const { activeId, base, collapsed, railTooltipProps } = useSidebar();
+    const sections = useNavSections();
+    return (_jsx(_Fragment, { children: props.groups.map((group, gi) => {
+            /**
+             * Rail mode force-expands every section, deliberately. Collapsed to a rail the group
+             * heading is a 1px divider with no visible label (see `.cms-nav.is-rail .cms-group`), so a
+             * closed section there would be items missing from the nav with nothing on screen to
+             * indicate a control exists, let alone where. The stored preference is untouched and
+             * returns intact when the rail expands — this only overrides what is rendered.
+             */
+            const collapsible = Boolean(group.label) && !collapsed && (props.collapsibleGroups ?? []).includes(group.label);
+            const open = !collapsible || sections.isOpen(group.label);
+            const panelId = `cms-section-${(group.label ?? `top-${gi}`).toLowerCase().replace(/[^a-z0-9]+/g, '-')}`;
+            return (_jsxs("div", { className: "cms-section", children: [group.label && collapsible ? (
+                    // A real `<button>`, not a click-handled `<div>`: keyboard focus, Enter/Space
+                    // activation, and the button role all come free, and `aria-expanded` only carries its
+                    // meaning on an element that is actually a control.
+                    _jsxs("button", { type: "button", className: `cms-group cms-group-toggle${open ? '' : ' is-closed'}`, "aria-expanded": open, "aria-controls": panelId, onClick: () => sections.toggle(group.label), children: [_jsx("span", { children: group.label }), _jsx("svg", { className: "cms-group-chevron", viewBox: "0 0 18 18", fill: "none", "aria-hidden": "true", children: _jsx("path", { d: "M5 7l4 4 4-4", stroke: "currentColor", strokeWidth: "1.75", strokeLinecap: "round", strokeLinejoin: "round" }) })] })) : group.label ? (_jsx("div", { className: "cms-group", children: group.label })) : null, _jsx("div", { className: "cms-section-items", id: panelId, hidden: !open, children: group.items.map((item) => {
+                            const active = item.id === activeId;
+                            const href = adminHref(item.href, base);
+                            if (props.renderItem) {
+                                return _jsx(Fragment, { children: props.renderItem(item, { active, href, collapsed }) }, item.id);
+                            }
+                            if (item.soon && !item.soonPreviewable) {
+                                return (_jsxs("div", { className: "cms-item is-soon", "aria-disabled": "true", children: [_jsx(Icon, { markup: item.icon ?? '' }), _jsx("span", { children: item.label }), _jsx("span", { className: "soon", children: props.soonLabel ?? 'Soon' })] }, item.id));
+                            }
+                            if (item.soon) {
+                                // `soonPreviewable`: same real `<a>` as a shipped row (active state, aria-current,
+                                // rail tooltip, cmd-click/copy-link all work identically) with the `soon` badge kept
+                                // alongside the label — the announcement stays honest, but the row is no longer inert.
+                                return (_jsxs("a", { className: `cms-item is-soon${active ? ' active' : ''}`, href: href, "aria-current": active ? 'page' : undefined, ...railTooltipProps(item.label), children: [_jsx(Icon, { markup: item.icon ?? '' }), _jsx("span", { children: item.label }), _jsx("span", { className: "soon", children: props.soonLabel ?? 'Soon' })] }, item.id));
+                            }
+                            return (_jsxs("a", { className: `cms-item${active ? ' active' : ''}`, 
+                                // `AdminNavItem.href` is a route path; the base is applied here so the panel
+                                // manifest never has to know it. A real URL, so cmd-click and "copy link address"
+                                // behave normally.
+                                href: href, "aria-current": active ? 'page' : undefined, ...railTooltipProps(item.label), children: [_jsx(Icon, { markup: item.icon ?? '' }), _jsx("span", { children: item.label })] }, item.id));
+                        }) })] }, group.label ?? `top-${gi}`));
+        }) }));
+}
+/** The bottom region. Carries no content of its own — the host decides what belongs there. */
+function SidebarFooter(props) {
+    return _jsx("div", { className: ['cms-foot', props.className].filter(Boolean).join(' '), children: props.children });
+}
+/**
+ * Desktop rail collapse control. A real accessible name plus `aria-expanded` — not a bare icon
+ * button. Typically hidden by the host stylesheet inside the mobile drawer, which has its own close
+ * control and no rail concept.
+ */
+function SidebarRailToggle(props) {
+    const { collapsed, toggleRail } = useSidebar();
+    const label = collapsed ? (props.expandLabel ?? 'Expand sidebar') : (props.collapseLabel ?? 'Collapse sidebar');
+    return (_jsx("div", { className: "cms-rail-toggle-row", children: _jsx("button", { type: "button", className: "cms-rail-toggle", onClick: toggleRail, "aria-expanded": !collapsed, "aria-label": label, title: label, children: _jsx("svg", { viewBox: "0 0 18 18", fill: "none", stroke: "currentColor", strokeWidth: 1.5, "aria-hidden": "true", children: _jsx("path", { d: "M6.5 4.5 3.5 9l3 4.5M11.5 4.5 14.5 9l-3 4.5" }) }) }) }));
+}
+/**
+ * Grouped admin sidebar. See the file header for why this is a compound component and what the
+ * context costs.
+ */
+export const Sidebar = Object.assign(SidebarRoot, {
+    MobileHeader: SidebarMobileHeader,
+    Nav: SidebarNav,
+    Footer: SidebarFooter,
+    RailToggle: SidebarRailToggle,
+});
+//# sourceMappingURL=Sidebar.js.map

package/dist/react/components/Sidebar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Sidebar.js","sourceRoot":"","sources":["../../../src/react/components/Sidebar.tsx"],"names":[],"mappings":"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"}

package/dist/react/hooks/use-nav-sections.d.ts

@@ -0,0 +1,50 @@
+/**
+ * @file Per-section open/closed state for the sidebar's grouped nav (persisted).
+ *
+ * Sibling of `use-sidebar-rail.ts` and deliberately modelled on it — same defensive `localStorage`
+ * access, same "absent is not false" rule, same cross-tab sync. Read that file's header first; this
+ * one only records where the two differ.
+ *
+ * ## Why one key holding a map, rather than one key per section
+ *
+ * The unit a user thinks in is "how my sidebar is arranged", not "the Content section specifically".
+ * A single JSON map is written and read atomically, so a tab that toggles two sections in quick
+ * succession can never leave storage half-updated, and the cross-tab listener below fires once with
+ * the whole picture instead of once per section with no ordering guarantee between them. It also
+ * means adding a collapsible section later costs no new key and no migration.
+ *
+ * The cost is that a corrupt or hand-edited value loses every section's state at once rather than
+ * one. That is the right trade here: the fallback is "everything open", which is exactly the
+ * pre-accordion behavior and therefore never leaves the user unable to reach a nav item.
+ *
+ * ## Why the default is open
+ *
+ * A section whose state has never been stored renders open, matching how the nav behaved before it
+ * was collapsible. A closed-by-default accordion would hide working navigation from an operator who
+ * never asked for it and has no memory of a section existing — the one failure mode that turns a
+ * convenience into a support ticket.
+ */
+/** Storage key used when the host does not supply one. Namespaced to this package for the same
+ *  reason {@link DEFAULT_SIDEBAR_RAIL_STORAGE_KEY} is — two products embedding the admin under one
+ *  origin must not silently share a layout preference. */
+export declare const DEFAULT_NAV_SECTIONS_STORAGE_KEY = "jini-admin-nav-sections";
+/** `{ [groupLabel]: isOpen }`. A label absent from the map has no stored preference and defaults to
+ *  open — see this file's header. */
+export type NavSectionState = Readonly<Record<string, boolean>>;
+export interface NavSections {
+    /** `true` when the section should render its items. Any label with no stored preference is open. */
+    isOpen: (groupLabel: string) => boolean;
+    toggle: (groupLabel: string) => void;
+}
+/**
+ * @param storageKey `localStorage` key to persist under. Defaults to
+ * {@link DEFAULT_NAV_SECTIONS_STORAGE_KEY}. Read on first render only — same contract as
+ * `useSidebarRail`'s, for the same reason (no host changes this mid-session).
+ *
+ * @complexity O(1) per `isOpen` (one object lookup) and O(s) per `toggle` in the number of stored
+ * sections, from the single JSON serialization. `s` is the count of collapsible nav sections — a
+ * handful, fixed by the host's panel manifest, never user-variable.
+ * @overallScore 100
+ */
+export declare function useNavSections(storageKey?: string): NavSections;
+//# sourceMappingURL=use-nav-sections.d.ts.map

package/dist/react/hooks/use-nav-sections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-nav-sections.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/use-nav-sections.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH;;0DAE0D;AAC1D,eAAO,MAAM,gCAAgC,4BAA4B,CAAC;AAE1E;qCACqC;AACrC,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAyChE,MAAM,WAAW,WAAW;IAC1B,oGAAoG;IACpG,MAAM,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC;IACxC,MAAM,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;CACtC;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,UAAU,GAAE,MAAyC,GAAG,WAAW,CAiCjG"}

package/dist/react/hooks/use-nav-sections.js

@@ -0,0 +1,112 @@
+import { useCallback, useEffect, useState } from 'react';
+/**
+ * @file Per-section open/closed state for the sidebar's grouped nav (persisted).
+ *
+ * Sibling of `use-sidebar-rail.ts` and deliberately modelled on it — same defensive `localStorage`
+ * access, same "absent is not false" rule, same cross-tab sync. Read that file's header first; this
+ * one only records where the two differ.
+ *
+ * ## Why one key holding a map, rather than one key per section
+ *
+ * The unit a user thinks in is "how my sidebar is arranged", not "the Content section specifically".
+ * A single JSON map is written and read atomically, so a tab that toggles two sections in quick
+ * succession can never leave storage half-updated, and the cross-tab listener below fires once with
+ * the whole picture instead of once per section with no ordering guarantee between them. It also
+ * means adding a collapsible section later costs no new key and no migration.
+ *
+ * The cost is that a corrupt or hand-edited value loses every section's state at once rather than
+ * one. That is the right trade here: the fallback is "everything open", which is exactly the
+ * pre-accordion behavior and therefore never leaves the user unable to reach a nav item.
+ *
+ * ## Why the default is open
+ *
+ * A section whose state has never been stored renders open, matching how the nav behaved before it
+ * was collapsible. A closed-by-default accordion would hide working navigation from an operator who
+ * never asked for it and has no memory of a section existing — the one failure mode that turns a
+ * convenience into a support ticket.
+ */
+/** Storage key used when the host does not supply one. Namespaced to this package for the same
+ *  reason {@link DEFAULT_SIDEBAR_RAIL_STORAGE_KEY} is — two products embedding the admin under one
+ *  origin must not silently share a layout preference. */
+export const DEFAULT_NAV_SECTIONS_STORAGE_KEY = 'jini-admin-nav-sections';
+/**
+ * Reads the persisted map once, defensively. `localStorage` can throw in a locked-down embed
+ * (hardened browser configs, historically Safari private mode), the key may be absent on first run,
+ * and the value may be unparseable or the wrong shape if it was hand-edited or written by an older
+ * version.
+ *
+ * Every one of those resolves to an empty map — "no stored preference for anything" — rather than a
+ * thrown error, because the consequence of guessing wrong here is a nav that renders with all
+ * sections open, which is the safe direction. A malformed value is deliberately not repaired or
+ * re-written; the next real toggle overwrites it wholesale.
+ *
+ * Non-boolean entries are dropped individually rather than rejecting the whole map, so one bad key
+ * cannot discard a user's other sections.
+ */
+function readPersisted(storageKey) {
+    try {
+        const raw = localStorage.getItem(storageKey);
+        if (raw === null)
+            return {};
+        const parsed = JSON.parse(raw);
+        if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed))
+            return {};
+        const clean = {};
+        for (const [label, value] of Object.entries(parsed)) {
+            if (typeof value === 'boolean')
+                clean[label] = value;
+        }
+        return clean;
+    }
+    catch {
+        return {};
+    }
+}
+function writePersisted(storageKey, state) {
+    try {
+        localStorage.setItem(storageKey, JSON.stringify(state));
+    }
+    catch {
+        // Best-effort, exactly as in `use-sidebar-rail.ts`: a user who cannot persist still gets a
+        // working accordion for this tab, and failing loudly would break the nav over a preference.
+    }
+}
+/**
+ * @param storageKey `localStorage` key to persist under. Defaults to
+ * {@link DEFAULT_NAV_SECTIONS_STORAGE_KEY}. Read on first render only — same contract as
+ * `useSidebarRail`'s, for the same reason (no host changes this mid-session).
+ *
+ * @complexity O(1) per `isOpen` (one object lookup) and O(s) per `toggle` in the number of stored
+ * sections, from the single JSON serialization. `s` is the count of collapsible nav sections — a
+ * handful, fixed by the host's panel manifest, never user-variable.
+ * @overallScore 100
+ */
+export function useNavSections(storageKey = DEFAULT_NAV_SECTIONS_STORAGE_KEY) {
+    const [state, setState] = useState(() => readPersisted(storageKey));
+    const isOpen = useCallback((groupLabel) => state[groupLabel] ?? true, [state]);
+    const toggle = useCallback((groupLabel) => {
+        setState((current) => {
+            // `?? true` here and in `isOpen` must agree: toggling a section that has never been stored
+            // has to close it (it is currently rendered open), not open an already-open section — which
+            // is what a bare `!current[label]` would do on the `undefined` first press.
+            const next = { ...current, [groupLabel]: !(current[groupLabel] ?? true) };
+            writePersisted(storageKey, next);
+            return next;
+        });
+    }, [storageKey]);
+    /** Cross-tab sync — two admin tabs should agree on the layout rather than diverging the moment
+     *  either one collapses a section. Mirrors `useSidebarRail`'s listener, including treating a
+     *  removed key (`newValue === null`, another tab clearing storage) as "no stored preference"
+     *  rather than as "everything closed". */
+    useEffect(() => {
+        function onStorage(event) {
+            if (event.key !== storageKey)
+                return;
+            setState(event.newValue === null ? {} : readPersisted(storageKey));
+        }
+        window.addEventListener('storage', onStorage);
+        return () => window.removeEventListener('storage', onStorage);
+    }, [storageKey]);
+    return { isOpen, toggle };
+}
+//# sourceMappingURL=use-nav-sections.js.map

package/dist/react/hooks/use-nav-sections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-nav-sections.js","sourceRoot":"","sources":["../../../src/react/hooks/use-nav-sections.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH;;0DAE0D;AAC1D,MAAM,CAAC,MAAM,gCAAgC,GAAG,yBAAyB,CAAC;AAM1E;;;;;;;;;;;;;GAaG;AACH,SAAS,aAAa,CAAC,UAAkB;IACvC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAC7C,IAAI,GAAG,KAAK,IAAI;YAAE,OAAO,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACxC,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;YAAE,OAAO,EAAE,CAAC;QACtF,MAAM,KAAK,GAA4B,EAAE,CAAC;QAC1C,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAiC,CAAC,EAAE,CAAC;YAC/E,IAAI,OAAO,KAAK,KAAK,SAAS;gBAAE,KAAK,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC;QACvD,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,UAAkB,EAAE,KAAsB;IAChE,IAAI,CAAC;QACH,YAAY,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IAC1D,CAAC;IAAC,MAAM,CAAC;QACP,2FAA2F;QAC3F,4FAA4F;IAC9F,CAAC;AACH,CAAC;AAQD;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc,CAAC,aAAqB,gCAAgC;IAClF,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAkB,GAAG,EAAE,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC;IAErF,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,UAAkB,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IAEvF,MAAM,MAAM,GAAG,WAAW,CACxB,CAAC,UAAkB,EAAE,EAAE;QACrB,QAAQ,CAAC,CAAC,OAAO,EAAE,EAAE;YACnB,2FAA2F;YAC3F,4FAA4F;YAC5F,4EAA4E;YAC5E,MAAM,IAAI,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC;YAC1E,cAAc,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;YACjC,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;IACL,CAAC,EACD,CAAC,UAAU,CAAC,CACb,CAAC;IAEF;;;8CAG0C;IAC1C,SAAS,CAAC,GAAG,EAAE;QACb,SAAS,SAAS,CAAC,KAAmB;YACpC,IAAI,KAAK,CAAC,GAAG,KAAK,UAAU;gBAAE,OAAO;YACrC,QAAQ,CAAC,KAAK,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC;QACrE,CAAC;QACD,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAC9C,OAAO,GAAG,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAChE,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;IAEjB,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AAC5B,CAAC"}

package/dist/react/hooks/use-sidebar-rail.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @file Desktop sidebar rail-collapse preference (persisted).
+ *
+ * Deliberately its own hook rather than a `useState` inline in `Sidebar.tsx` — the persistence and
+ * the cross-tab sync below are both real behavior worth naming and testing on their own.
+ *
+ * This is the DESKTOP collapse: a user preference, both states fully usable, persisted so it
+ * survives navigation and reload. It is a different mechanism from the mobile off-canvas drawer
+ * (`Sidebar`'s `open`/`onClose` props, which the host owns): that one is session-only overlay state
+ * that *should* reset on every navigation, where resetting this preference on navigation would be
+ * the bug the original design called out — a collapse that resets on every page change is worse
+ * than no collapse. Driving both off one boolean would make each navigation either fight the user's
+ * rail choice or leave the phone drawer stuck open; they are two pieces of state on purpose.
+ */
+/** Storage key used when the host does not supply one. Namespaced to this package so two products
+ *  embedding the admin under one origin do not silently share a preference.
+ *
+ *  A host migrating from its own pre-existing key should pass that key to `useSidebarRail` rather
+ *  than accept this default — switching keys reads as "every operator's collapsed rail sprang back
+ *  open", which is indistinguishable from a regression. */
+export declare const DEFAULT_SIDEBAR_RAIL_STORAGE_KEY = "jini-admin-sidebar-rail-collapsed";
+export interface SidebarRail {
+    collapsed: boolean;
+    toggle: () => void;
+}
+/**
+ * @param storageKey `localStorage` key to persist under. Defaults to
+ * {@link DEFAULT_SIDEBAR_RAIL_STORAGE_KEY}. Read on first render only — changing it on a mounted
+ * hook re-points the *writes* and the cross-tab listener, but does not re-read the new key's value,
+ * since a key that changes mid-session is not a case any host has.
+ *
+ * @param defaultCollapsed State for a visitor with **no stored preference**. Defaults to `false`
+ * (expanded), which is what every existing host gets by not passing it. A stored preference always
+ * takes precedence — see {@link readPersisted} for why absent and `'0'` must stay distinguishable.
+ *
+ * @complexity O(1) — one state read/write per toggle, no derived computation.
+ */
+export declare function useSidebarRail(storageKey?: string, defaultCollapsed?: boolean): SidebarRail;
+//# sourceMappingURL=use-sidebar-rail.d.ts.map

package/dist/react/hooks/use-sidebar-rail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-sidebar-rail.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/use-sidebar-rail.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AAEH;;;;;2DAK2D;AAC3D,eAAO,MAAM,gCAAgC,sCAAsC,CAAC;AAiCpF,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAC5B,UAAU,GAAE,MAAyC,EACrD,gBAAgB,UAAQ,GACvB,WAAW,CA2Bb"}

package/dist/react/hooks/use-sidebar-rail.js

@@ -0,0 +1,93 @@
+import { useCallback, useEffect, useState } from 'react';
+/**
+ * @file Desktop sidebar rail-collapse preference (persisted).
+ *
+ * Deliberately its own hook rather than a `useState` inline in `Sidebar.tsx` — the persistence and
+ * the cross-tab sync below are both real behavior worth naming and testing on their own.
+ *
+ * This is the DESKTOP collapse: a user preference, both states fully usable, persisted so it
+ * survives navigation and reload. It is a different mechanism from the mobile off-canvas drawer
+ * (`Sidebar`'s `open`/`onClose` props, which the host owns): that one is session-only overlay state
+ * that *should* reset on every navigation, where resetting this preference on navigation would be
+ * the bug the original design called out — a collapse that resets on every page change is worse
+ * than no collapse. Driving both off one boolean would make each navigation either fight the user's
+ * rail choice or leave the phone drawer stuck open; they are two pieces of state on purpose.
+ */
+/** Storage key used when the host does not supply one. Namespaced to this package so two products
+ *  embedding the admin under one origin do not silently share a preference.
+ *
+ *  A host migrating from its own pre-existing key should pass that key to `useSidebarRail` rather
+ *  than accept this default — switching keys reads as "every operator's collapsed rail sprang back
+ *  open", which is indistinguishable from a regression. */
+export const DEFAULT_SIDEBAR_RAIL_STORAGE_KEY = 'jini-admin-sidebar-rail-collapsed';
+/**
+ * Reads the persisted value once, defensively — `localStorage` can throw in a locked-down
+ * embed/iframe context (Safari private mode historically, some hardened browser configs), and a
+ * first-run visitor has no key at all.
+ *
+ * Returns `undefined` for "no stored preference" rather than collapsing it into `false`. That
+ * distinction is load-bearing once a host can default to collapsed (`defaultCollapsed` below): if
+ * absent and `'0'` both read as `false`, they behave identically under an expanded default but
+ * diverge sharply under a collapsed one — an operator who deliberately expanded the rail would find
+ * it collapsed again on every reload, because their explicit `'0'` would be indistinguishable from
+ * never having chosen. A stored value always wins over the default; only its absence defers.
+ */
+function readPersisted(storageKey) {
+    try {
+        const raw = localStorage.getItem(storageKey);
+        if (raw === null)
+            return undefined;
+        return raw === '1';
+    }
+    catch {
+        return undefined;
+    }
+}
+function writePersisted(storageKey, collapsed) {
+    try {
+        localStorage.setItem(storageKey, collapsed ? '1' : '0');
+    }
+    catch {
+        // Best-effort — a user who cannot persist the preference still gets a working toggle for the
+        // current tab; failing loudly here would break the rail over a non-essential preference write.
+    }
+}
+/**
+ * @param storageKey `localStorage` key to persist under. Defaults to
+ * {@link DEFAULT_SIDEBAR_RAIL_STORAGE_KEY}. Read on first render only — changing it on a mounted
+ * hook re-points the *writes* and the cross-tab listener, but does not re-read the new key's value,
+ * since a key that changes mid-session is not a case any host has.
+ *
+ * @param defaultCollapsed State for a visitor with **no stored preference**. Defaults to `false`
+ * (expanded), which is what every existing host gets by not passing it. A stored preference always
+ * takes precedence — see {@link readPersisted} for why absent and `'0'` must stay distinguishable.
+ *
+ * @complexity O(1) — one state read/write per toggle, no derived computation.
+ */
+export function useSidebarRail(storageKey = DEFAULT_SIDEBAR_RAIL_STORAGE_KEY, defaultCollapsed = false) {
+    const [collapsed, setCollapsed] = useState(() => readPersisted(storageKey) ?? defaultCollapsed);
+    const toggle = useCallback(() => {
+        setCollapsed((current) => {
+            const next = !current;
+            writePersisted(storageKey, next);
+            return next;
+        });
+    }, [storageKey]);
+    /** Cross-tab sync: two admin tabs open side by side should agree on the rail state rather than
+     *  silently diverging the moment either one is toggled. */
+    useEffect(() => {
+        function onStorage(event) {
+            if (event.key !== storageKey)
+                return;
+            // `newValue` is null when the key is REMOVED (another tab clearing storage), which is the
+            // same "no stored preference" state `readPersisted` defers on — so fall back to the host's
+            // default rather than hard-coding expanded, or a clear in one tab would silently override a
+            // collapsed-by-default host in every other one.
+            setCollapsed(event.newValue === null ? defaultCollapsed : event.newValue === '1');
+        }
+        window.addEventListener('storage', onStorage);
+        return () => window.removeEventListener('storage', onStorage);
+    }, [storageKey, defaultCollapsed]);
+    return { collapsed, toggle };
+}
+//# sourceMappingURL=use-sidebar-rail.js.map

package/dist/react/hooks/use-sidebar-rail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-sidebar-rail.js","sourceRoot":"","sources":["../../../src/react/hooks/use-sidebar-rail.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEzD;;;;;;;;;;;;;GAaG;AAEH;;;;;2DAK2D;AAC3D,MAAM,CAAC,MAAM,gCAAgC,GAAG,mCAAmC,CAAC;AAEpF;;;;;;;;;;;GAWG;AACH,SAAS,aAAa,CAAC,UAAkB;IACvC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAC7C,IAAI,GAAG,KAAK,IAAI;YAAE,OAAO,SAAS,CAAC;QACnC,OAAO,GAAG,KAAK,GAAG,CAAC;IACrB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,UAAkB,EAAE,SAAkB;IAC5D,IAAI,CAAC;QACH,YAAY,CAAC,OAAO,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAC1D,CAAC;IAAC,MAAM,CAAC;QACP,6FAA6F;QAC7F,+FAA+F;IACjG,CAAC;AACH,CAAC;AAOD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,cAAc,CAC5B,aAAqB,gCAAgC,EACrD,gBAAgB,GAAG,KAAK;IAExB,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAU,GAAG,EAAE,CAAC,aAAa,CAAC,UAAU,CAAC,IAAI,gBAAgB,CAAC,CAAC;IAEzG,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,EAAE;QAC9B,YAAY,CAAC,CAAC,OAAO,EAAE,EAAE;YACvB,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC;YACtB,cAAc,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;YACjC,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;IACL,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;IAEjB;+DAC2D;IAC3D,SAAS,CAAC,GAAG,EAAE;QACb,SAAS,SAAS,CAAC,KAAmB;YACpC,IAAI,KAAK,CAAC,GAAG,KAAK,UAAU;gBAAE,OAAO;YACrC,0FAA0F;YAC1F,2FAA2F;YAC3F,4FAA4F;YAC5F,gDAAgD;YAChD,YAAY,CAAC,KAAK,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,KAAK,GAAG,CAAC,CAAC;QACpF,CAAC;QACD,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAC9C,OAAO,GAAG,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAChE,CAAC,EAAE,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC,CAAC;IAEnC,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;AAC/B,CAAC"}