@lerianstudio/sindarian-ui 2.0.0-beta.8 → 2.0.0-beta.9

package/dist/components/ui/sidebar/sidebar-item.js

@@ -7,14 +7,38 @@ const sidebar_item_button_1 = require("./sidebar-item-button");
 const sidebar_item_icon_button_1 = require("./sidebar-item-icon-button");
 const sidebar_provider_1 = require("./sidebar-provider");
 const sidebar_router_1 = require("./sidebar-router");
-const SidebarItem = ({ active, href, children: _children, ...props }) => {
+const SidebarItem = ({ active, href, children: _children, onClick, ...props }) => {
     const { usePathname } = (0, sidebar_router_1.useSidebarRouter)();
     const pathname = usePathname();
-    const { isCollapsed } = (0, sidebar_provider_1.useSidebar)();
+    const { isCollapsed, isDrawer, setOpenMobile } = (0, sidebar_provider_1.useSidebar)();
     const isActive = (href) => pathname === href;
+    /**
+     * ⛔ ACTIVATING A DESTINATION CLOSES THE DRAWER. It is the whole point of the
+     * drawer and it was the one interaction that left it open: Escape, the
+     * backdrop and the X all dismissed it, a navigation link did not.
+     *
+     * The overlay is modal, so `document.body` carries `pointer-events: none`
+     * while it is up, and a consumer's `SidebarItem` is a client-side `Link`
+     * under a provider that survives the route change — so the reader landed on
+     * the new page rendered INERT behind a drawer they had to dismiss a second
+     * time, on a phone.
+     *
+     * Here rather than in `SidebarRoot`, because this is the component that knows
+     * an activation happened; `SidebarBackButton` and every
+     * `SidebarItemCollapsibleContent` leaf render through it, so they are covered
+     * by construction. Guarded on `isDrawer` so an inline rail — where nothing is
+     * covering the page — behaves exactly as before, and the consumer's own
+     * handler still runs either way.
+     */
+    const handleClick = (event) => {
+        onClick?.(event);
+        if (isDrawer) {
+            setOpenMobile(false);
+        }
+    };
     if (isCollapsed) {
-        return ((0, jsx_runtime_1.jsx)(sidebar_item_icon_button_1.SidebarItemIconButton, { "data-slot": "sidebar-item", href: href, active: isActive(href) || active, ...props }));
+        return ((0, jsx_runtime_1.jsx)(sidebar_item_icon_button_1.SidebarItemIconButton, { "data-slot": "sidebar-item", href: href, active: isActive(href) || active, onClick: handleClick, ...props }));
     }
-    return ((0, jsx_runtime_1.jsx)(sidebar_item_button_1.SidebarItemButton, { "data-slot": "sidebar-item", href: href, active: isActive(href) || active, ...props }));
+    return ((0, jsx_runtime_1.jsx)(sidebar_item_button_1.SidebarItemButton, { "data-slot": "sidebar-item", href: href, active: isActive(href) || active, onClick: handleClick, ...props }));
 };
 exports.SidebarItem = SidebarItem;

package/dist/components/ui/sidebar/sidebar-provider.d.ts

@@ -1,12 +1,49 @@
 import React from 'react';
+/**
+ * The viewport below which the rail stops being a layout and becomes a drawer.
+ *
+ * 767px rather than 768px: this is the upper bound of `max-width`, so it is the
+ * complement of Tailwind's `md` breakpoint (`min-width: 768px`) and `md:hidden`
+ * on `SidebarTrigger` flips at exactly the same pixel the query does.
+ */
+export declare const SIDEBAR_MOBILE_QUERY = "(max-width: 767px)";
 export type SidebarContextProps = {
     isCollapsed: boolean;
+    /**
+     * True only inside a drawer that `SidebarRoot` is actually rendering, which
+     * needs `mobile="drawer"` as well as a narrow viewport. `SidebarRoot`
+     * re-provides the context for that subtree; nothing else sets it.
+     */
+    isDrawer: boolean;
+    /**
+     * True while the viewport is narrow enough for a drawer. Reported in BOTH
+     * modes, so a consumer still on `mobile="inline"` can build its own
+     * responsive behaviour from it.
+     */
+    isMobile: boolean;
+    /** Whether the mobile drawer is showing. Meaningless while `isMobile` is false. */
+    openMobile: boolean;
+    setOpenMobile: (open: boolean) => void;
+    /**
+     * Puts focus back on whatever opened the drawer. `SidebarRoot` calls it when
+     * the drawer closes; nothing else should need it.
+     */
+    restoreDrawerFocus: () => void;
+    /** The drawer's DOM id, so `SidebarTrigger` can point `aria-controls` at it. */
+    sidebarId: string;
     items: Record<string, boolean>;
     setItems: React.Dispatch<React.SetStateAction<Record<string, boolean>>>;
     getItemCollapsed: (key: string) => boolean;
     setItemCollapsed: (key: string, value: boolean) => void;
     toggleSidebar: () => void;
 };
+/**
+ * Exported so `SidebarRoot` can re-provide it for the drawer's subtree. That
+ * subtree is the only place `isCollapsed` and `isDrawer` differ from the
+ * provider's own values, and scoping the override to it is what keeps a
+ * consumer on `mobile="inline"` seeing exactly today's rail.
+ */
+export declare const SidebarContext: React.Context<SidebarContextProps | undefined>;
 export declare const useSidebar: () => SidebarContextProps;
 export declare const SidebarProvider: ({ children }: React.PropsWithChildren) => React.JSX.Element;
 //# sourceMappingURL=sidebar-provider.d.ts.map

package/dist/components/ui/sidebar/sidebar-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sidebar-provider.d.ts","sourceRoot":"","sources":["../../../../src/components/ui/sidebar/sidebar-provider.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB,MAAM,MAAM,mBAAmB,GAAG;IAChC,WAAW,EAAE,OAAO,CAAA;IACpB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC9B,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;IACvE,gBAAgB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAA;IAC1C,gBAAgB,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;IACvD,aAAa,EAAE,MAAM,IAAI,CAAA;CAC1B,CAAA;AAMD,eAAO,MAAM,UAAU,2BAMtB,CAAA;AAED,eAAO,MAAM,eAAe,GAAI,cAAc,KAAK,CAAC,iBAAiB,sBAqDpE,CAAA"}
+{"version":3,"file":"sidebar-provider.d.ts","sourceRoot":"","sources":["../../../../src/components/ui/sidebar/sidebar-provider.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,uBAAuB,CAAA;AAUxD,MAAM,MAAM,mBAAmB,GAAG;IAChC,WAAW,EAAE,OAAO,CAAA;IACpB;;;;OAIG;IACH,QAAQ,EAAE,OAAO,CAAA;IACjB;;;;OAIG;IACH,QAAQ,EAAE,OAAO,CAAA;IACjB,mFAAmF;IACnF,UAAU,EAAE,OAAO,CAAA;IACnB,aAAa,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IACtC;;;OAGG;IACH,kBAAkB,EAAE,MAAM,IAAI,CAAA;IAC9B,gFAAgF;IAChF,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC9B,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;IACvE,gBAAgB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAA;IAC1C,gBAAgB,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;IACvD,aAAa,EAAE,MAAM,IAAI,CAAA;CAC1B,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,cAAc,gDAEf,CAAA;AAEZ,eAAO,MAAM,UAAU,2BAMtB,CAAA;AAED,eAAO,MAAM,eAAe,GAAI,cAAc,KAAK,CAAC,iBAAiB,sBAkKpE,CAAA"}

package/dist/components/ui/sidebar/sidebar-provider.js

@@ -4,13 +4,34 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SidebarProvider = exports.useSidebar = void 0;
+exports.SidebarProvider = exports.useSidebar = exports.SidebarContext = exports.SIDEBAR_MOBILE_QUERY = void 0;
 const jsx_runtime_1 = require("react/jsx-runtime");
 const react_1 = __importDefault(require("react"));
 const storage_1 = require("../../../lib/storage");
-const SidebarContext = react_1.default.createContext(undefined);
+/**
+ * The viewport below which the rail stops being a layout and becomes a drawer.
+ *
+ * 767px rather than 768px: this is the upper bound of `max-width`, so it is the
+ * complement of Tailwind's `md` breakpoint (`min-width: 768px`) and `md:hidden`
+ * on `SidebarTrigger` flips at exactly the same pixel the query does.
+ */
+exports.SIDEBAR_MOBILE_QUERY = '(max-width: 767px)';
+/**
+ * Where focus goes when the rail has to receive it. The rail's own content is
+ * links and buttons, so this is deliberately the short list rather than the
+ * full tabbable grammar: a `[tabindex]` sweep would have to exclude `-1`, and
+ * nothing in a sidebar carries one.
+ */
+const FOCUSABLE = 'a[href], button:not([disabled])';
+/**
+ * Exported so `SidebarRoot` can re-provide it for the drawer's subtree. That
+ * subtree is the only place `isCollapsed` and `isDrawer` differ from the
+ * provider's own values, and scoping the override to it is what keeps a
+ * consumer on `mobile="inline"` seeing exactly today's rail.
+ */
+exports.SidebarContext = react_1.default.createContext(undefined);
 const useSidebar = () => {
-    const context = react_1.default.useContext(SidebarContext);
+    const context = react_1.default.useContext(exports.SidebarContext);
     if (!context) {
         throw new Error('useSidebar must be used within a SidebarProvider');
     }
@@ -21,6 +42,61 @@ const SidebarProvider = ({ children }) => {
     const [hydrated, setHydrated] = react_1.default.useState(false);
     const [collapsed, setCollapsed] = react_1.default.useState(false);
     const [items, _setItems] = react_1.default.useState({});
+    const [isMobile, setIsMobile] = react_1.default.useState(false);
+    const [openMobile, _setOpenMobile] = react_1.default.useState(false);
+    const sidebarId = react_1.default.useId();
+    /**
+     * ⛔ RADIX CANNOT RESTORE THIS FOCUS BY ITSELF. `DialogContent` preventDefaults
+     * the focus scope's own restore and focuses `triggerRef.current` instead —
+     * the ref a `SheetTrigger` would have filled. The drawer is opened from this
+     * state rather than from a trigger inside the dialog, so that ref is null and
+     * closing dropped focus onto `<body>`: a keyboard reader who opened the
+     * navigation and pressed Escape was returned to the top of the document.
+     *
+     * Captured here rather than in `SidebarTrigger` so that a consumer opening
+     * the drawer from its own control gets the same behaviour.
+     */
+    const opener = react_1.default.useRef(null);
+    const setOpenMobile = react_1.default.useCallback((open) => {
+        if (open && typeof document !== 'undefined') {
+            opener.current = document.activeElement;
+        }
+        _setOpenMobile(open);
+    }, []);
+    /**
+     * ⛔ THE VIEWPORT AT THE MOMENT FOCUS MOVES, NOT AT THE MOMENT IT OPENED.
+     *
+     * Radix calls `restoreDrawerFocus` from the focus scope's UNMOUNT handler,
+     * which is the last thing in the commit to touch focus — later than any
+     * effect in this provider, so the decision has to be made inside the handler
+     * rather than beside it. By then `isMobile` has already flipped.
+     */
+    const isMobileRef = react_1.default.useRef(false);
+    isMobileRef.current = isMobile;
+    const restoreDrawerFocus = react_1.default.useCallback(() => {
+        // `isConnected`: the control that opened the drawer may itself have been
+        // unmounted by whatever the reader did inside it.
+        //
+        // ⛔ AND NOT AT ALL WHEN THE VIEWPORT IS THE ONE THAT DISMISSED IT. A
+        // tablet rotated from portrait to landscape with the navigation open
+        // crosses 768px, so the drawer is replaced by the rail and the opener is
+        // `SidebarTrigger` — which the same breakpoint just hid with `md:hidden`.
+        // `.focus()` on a `display: none` element is a silent no-op, and Radix's
+        // own restore is already `preventDefault()`ed, so focus fell to `<body>`
+        // and the reader lost their place (SC 2.4.3). Measured in Chromium at
+        // 390 → 1280: `{"rails":1,"triggerDisplay":"none","focus":"BODY:"}`.
+        if (isMobileRef.current && opener.current?.isConnected) {
+            opener.current.focus();
+            return;
+        }
+        // The rail is what the drawer became, so that is where the reader goes.
+        // Below the breakpoint there is nothing here to find — a closed drawer
+        // leaves no navigation in the DOM — and focus stays where Radix left it.
+        document
+            .getElementById(sidebarId)
+            ?.querySelector(FOCUSABLE)
+            ?.focus();
+    }, [sidebarId]);
     const toggleSidebar = () => setCollapsed((collapsed) => !collapsed);
     const getItemCollapsed = (key) => {
         return items[key] || false;
@@ -34,6 +110,37 @@ const SidebarProvider = ({ children }) => {
         _setItems((0, storage_1.getStorageObject)('sidebar-items', {}));
         setHydrated(true);
     }, []);
+    /**
+     * ⚠️ FALSE UNTIL THE CLIENT SAYS OTHERWISE. There is no viewport on the
+     * server, so the first paint is always the rail and the drawer appears on
+     * hydration; starting from a guess would make the markup differ between the
+     * two renders. The `matchMedia` guard is the one `theme-provider.tsx` next
+     * door already carries: jsdom and some embedded runtimes ship without it, and
+     * a missing media API is a desktop, not a crash.
+     */
+    react_1.default.useEffect(() => {
+        if (typeof window.matchMedia !== 'function') {
+            return;
+        }
+        const media = window.matchMedia(exports.SIDEBAR_MOBILE_QUERY);
+        const sync = () => setIsMobile(media.matches);
+        sync();
+        media.addEventListener('change', sync);
+        return () => media.removeEventListener('change', sync);
+    }, []);
+    /**
+     * A drawer left open while the viewport grows back would keep an overlay and
+     * a focus trap over a layout that is already showing its rail, with nothing
+     * on screen to dismiss them.
+     *
+     * Where focus goes afterwards is `restoreDrawerFocus`'s decision, not this
+     * effect's: Radix's unmount handler runs later than anything here.
+     */
+    react_1.default.useEffect(() => {
+        if (!isMobile) {
+            _setOpenMobile(false);
+        }
+    }, [isMobile]);
     // Only persist to localStorage after hydration to avoid overwriting stored values
     react_1.default.useEffect(() => {
         if (!hydrated) {
@@ -47,8 +154,22 @@ const SidebarProvider = ({ children }) => {
         }
         localStorage.setItem('sidebar-items', JSON.stringify(items));
     }, [items, hydrated]);
-    return ((0, jsx_runtime_1.jsx)(SidebarContext.Provider, { value: {
+    return ((0, jsx_runtime_1.jsx)(exports.SidebarContext.Provider, { value: {
+            /**
+             * ⚠️ A NARROW VIEWPORT DOES NOT TOUCH THIS. It used to be forced false
+             * whenever `isMobile`, which silently changed the rail for every
+             * consumer — including the ones that never asked for a drawer.
+             * `SidebarRoot` overrides it for the drawer's own subtree instead, so
+             * the stored preference reaches an inline rail unchanged at every
+             * viewport.
+             */
             isCollapsed: collapsed,
+            isDrawer: false,
+            isMobile,
+            openMobile,
+            setOpenMobile,
+            restoreDrawerFocus,
+            sidebarId,
             items,
             setItems: _setItems,
             getItemCollapsed,

package/dist/components/ui/sidebar/sidebar-root.d.ts

@@ -1,3 +1,40 @@
 import React from 'react';
-export declare const SidebarRoot: ({ className, ...props }: React.ComponentProps<"nav">) => React.JSX.Element;
+export type SidebarRootProps = React.ComponentProps<'nav'> & {
+    /**
+     * What this rail becomes below 768px.
+     *
+     * - `'inline'` (default): nothing changes. The rail renders at every
+     *   viewport exactly as it always has, and the reader's collapsed preference
+     *   is untouched.
+     * - `'drawer'`: the inline rail is not rendered below the breakpoint and the
+     *   navigation moves into an overlay drawer that `SidebarTrigger` opens.
+     *
+     * ⛔ THE DEFAULT IS NOT A TASTE, IT IS A CONSUMER-SAFETY RULE. `SidebarTrigger`
+     * is the only way back into the drawer and it must render inside
+     * `SidebarProvider`. A consumer that has not placed one yet — which is every
+     * consumer at the moment this shipped — would get a phone with NO navigation
+     * rather than a rail that takes 63% of it, and that is strictly worse. Opt in
+     * once there is somewhere to put the trigger.
+     */
+    mobile?: 'inline' | 'drawer';
+    /**
+     * The drawer's accessible name. A dialog needs one, and it is read out when
+     * the drawer opens. Unused while `mobile` is `'inline'`.
+     */
+    mobileTitle?: string;
+};
+/**
+ * ⛔ BELOW 768px A RAIL IS NOT A LAYOUT — once a consumer opts in.
+ *
+ * The widths above are a fixed share of a flex row, so at 390px the expanded
+ * rail took 63% of the screen and left the page 146px, and the only affordance
+ * — `SidebarExpandButton` — shrinks it to 72px, which is still 18% and still
+ * permanently on screen. There was nothing that removed it.
+ *
+ * With `mobile="drawer"` the rail is replaced below the breakpoint by an
+ * overlay drawer. Escape, the backdrop click, the focus trap and returning
+ * focus to whatever opened it are Radix Dialog's, through the kit's own
+ * `Sheet`; none of that is re-implemented here.
+ */
+export declare const SidebarRoot: ({ className, id, mobile, mobileTitle, ...props }: SidebarRootProps) => React.JSX.Element;
 //# sourceMappingURL=sidebar-root.d.ts.map

package/dist/components/ui/sidebar/sidebar-root.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sidebar-root.d.ts","sourceRoot":"","sources":["../../../../src/components/ui/sidebar/sidebar-root.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAA;AAoBzB,eAAO,MAAM,WAAW,GAAI,yBAGzB,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,sBAW7B,CAAA"}
+{"version":3,"file":"sidebar-root.d.ts","sourceRoot":"","sources":["../../../../src/components/ui/sidebar/sidebar-root.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAA;AAqEzB,MAAM,MAAM,gBAAgB,GAAG,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,GAAG;IAC3D;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAA;IAC5B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,WAAW,GAAI,kDAMzB,gBAAgB,sBA0GlB,CAAA"}

package/dist/components/ui/sidebar/sidebar-root.js

@@ -6,19 +6,114 @@ const jsx_runtime_1 = require("react/jsx-runtime");
 const class_variance_authority_1 = require("class-variance-authority");
 const sidebar_provider_1 = require("./sidebar-provider");
 const utils_1 = require("../../../lib/utils");
+const sheet_1 = require("../sheet");
+/**
+ * ⛔ THE WIDTHS ARE TOKENS, NOT LITERALS.
+ *
+ * They were `w-[72px]` and `w-[244px]`, which a consumer could only override by
+ * winning a specificity argument with `cn`. `--sidebar-width` and
+ * `--sidebar-width-collapsed` are declared in `globals.css`, so the default
+ * still ships with the stylesheet, and a consumer re-points either one with
+ * `className="[--sidebar-width:280px]"` ON THE RAIL, which moves the rail and
+ * the mobile drawer together (see `liftWidthOverrides` below), or with a rule
+ * on `:root`/`html`.
+ *
+ * ⚠️ A DECLARATION ON A REACT-TREE ANCESTOR REACHES THE RAIL AND NOT THE
+ * DRAWER. Custom properties inherit down the DOM tree, and the drawer is
+ * portalled to `document.body`, so a layout wrapper is not an ancestor of it.
+ * `:root` is, which is why it is named above and a wrapper is not.
+ */
 const sidebarVariants = (0, class_variance_authority_1.cva)('group/sidebar shadow-sidebar relative flex flex-col transition-[width] duration-300 ease-in-out', {
     variants: {
         collapsed: {
-            true: 'w-[72px]',
-            false: 'w-[244px]'
+            true: 'w-[var(--sidebar-width-collapsed)]',
+            false: 'w-[var(--sidebar-width)]'
         }
     },
     defaultVariants: {
         collapsed: false
     }
 });
-const SidebarRoot = ({ className, ...props }) => {
-    const { isCollapsed } = (0, sidebar_provider_1.useSidebar)();
-    return ((0, jsx_runtime_1.jsx)("nav", { "data-slot": "sidebar-root", className: (0, utils_1.cn)(sidebarVariants({ collapsed: isCollapsed }), className), "data-collapsed": isCollapsed, ...props }));
+/**
+ * Tailwind arbitrary-property classes that re-point the sidebar geometry, e.g.
+ * `[--sidebar-width:320px]` or `[--sidebar-width-collapsed:88px]`.
+ *
+ * ⚠️ ANCHORED TO A CLASS BOUNDARY, WHICH IS THE WHOLE POINT OF THE LOOKBEHIND.
+ * Unanchored it also matched the tail of `md:[--sidebar-width:320px]` and
+ * lifted it with the prefix stripped — an override a consumer scoped to
+ * ≥768px, applied unconditionally to the drawer that only exists below it.
+ */
+const WIDTH_OVERRIDE = /(?<=^|\s)\[--sidebar-width(?:-collapsed)?:[^\]]+\]/g;
+/**
+ * ⛔ THE ONE PART OF THE CONSUMER'S className THAT HAS TO CROSS THE PORTAL.
+ *
+ * `SheetContent` mounts through `SheetPortal` into `document.body`, and custom
+ * properties inherit down the DOM tree rather than the React tree. So the
+ * documented override — a class on the rail — set `--sidebar-width` on an
+ * element the drawer is not a descendant of, and the whole className that DOES
+ * travel lands on the inner `<nav>`, which is BELOW the element that reads the
+ * variable. Measured in Chromium: rail 320px, drawer 244px. Following the
+ * instruction handed to product-console produced a 280px rail on desktop and a
+ * 244px drawer on a phone, silently.
+ *
+ * ⚠️ ONLY THE GEOMETRY TOKENS. The rest of a rail className is rail-shaped —
+ * `h-full`, and the `data-[collapsed=false]:min-w-70` all eight console
+ * sidebars pass — and putting that on the sheet would reinstate the
+ * 280px-inside-a-244px-sheet overflow from the other side.
+ */
+function liftWidthOverrides(className) {
+    return className?.match(WIDTH_OVERRIDE)?.join(' ');
+}
+/**
+ * ⛔ BELOW 768px A RAIL IS NOT A LAYOUT — once a consumer opts in.
+ *
+ * The widths above are a fixed share of a flex row, so at 390px the expanded
+ * rail took 63% of the screen and left the page 146px, and the only affordance
+ * — `SidebarExpandButton` — shrinks it to 72px, which is still 18% and still
+ * permanently on screen. There was nothing that removed it.
+ *
+ * With `mobile="drawer"` the rail is replaced below the breakpoint by an
+ * overlay drawer. Escape, the backdrop click, the focus trap and returning
+ * focus to whatever opened it are Radix Dialog's, through the kit's own
+ * `Sheet`; none of that is re-implemented here.
+ */
+const SidebarRoot = ({ className, id, mobile = 'inline', mobileTitle = 'Navigation', ...props }) => {
+    const context = (0, sidebar_provider_1.useSidebar)();
+    const { isCollapsed, isMobile, openMobile, setOpenMobile, restoreDrawerFocus, sidebarId } = context;
+    if (!isMobile || mobile === 'inline') {
+        return ((0, jsx_runtime_1.jsx)("nav", { "data-slot": "sidebar-root", className: (0, utils_1.cn)(sidebarVariants({ collapsed: isCollapsed }), className), "data-collapsed": isCollapsed, ...props, id: mobile === 'drawer' ? sidebarId : id }));
+    }
+    return ((0, jsx_runtime_1.jsx)(sidebar_provider_1.SidebarContext.Provider, { value: { ...context, isCollapsed: false, isDrawer: true }, children: (0, jsx_runtime_1.jsx)(sheet_1.Sheet, { open: openMobile, onOpenChange: setOpenMobile, children: (0, jsx_runtime_1.jsxs)(sheet_1.SheetContent, { side: "left", 
+                // The Sheet's own paddings are built for a form panel; a rail brings
+                // its own. `max-w-full` so a consumer widening `--sidebar-width` past
+                // the viewport still cannot push the drawer off screen. The lifted
+                // override goes LAST so it re-points the variable this element reads.
+                className: (0, utils_1.cn)('w-[var(--sidebar-width)] max-w-full gap-0 p-0', liftWidthOverrides(className)), "aria-describedby": undefined, 
+                // ⛔ RADIX'S OWN RESTORE GOES NOWHERE HERE. `DialogContent`
+                // preventDefaults the focus scope's restore and focuses the ref a
+                // `SheetTrigger` would have filled; this drawer is opened from provider
+                // state, so that ref is null and closing dropped focus onto `<body>`.
+                // Running first means `composeEventHandlers` skips Radix's half.
+                onCloseAutoFocus: (event) => {
+                    event.preventDefault();
+                    restoreDrawerFocus();
+                }, children: [(0, jsx_runtime_1.jsx)(sheet_1.SheetTitle, { className: "sr-only", children: mobileTitle }), (0, jsx_runtime_1.jsx)("nav", { "data-slot": "sidebar-root", "data-mobile": "true", 
+                        /* ⛔ NO `data-collapsed` HERE. The consumer className is forwarded
+                           verbatim, and all eight console sidebars pass
+                           `data-[collapsed=false]:min-w-70`; stamping the attribute armed
+                           it, giving the navigation a 280px min-width inside a 244px sheet.
+                           `min-width` resolves after `max-width`, so the sheet could not
+                           claw it back and the contents were 36px wider than the drawer.
+                           `data-mobile` already names this surface and a drawer is never
+                           collapsed, so the attribute had nothing left to say. */
+                        className: (0, utils_1.cn)(sidebarVariants({ collapsed: false }), 'h-full w-full shadow-none', className), ...props, 
+                        /* ⛔ AFTER THE SPREAD, AND NOT THE CALLER'S. This is the target of
+                           `SidebarTrigger`'s `aria-controls` and the handle the provider
+                           uses to put focus back into the navigation when the viewport
+                           grows. Spread first, a caller that set `id` replaced it and left
+                           a dangling `aria-controls` — which axe reports as a CRITICAL
+                           `aria-valid-attr-value` — and a focus restore that lands on
+                           `<body>`. Both silent. */
+                        id: sidebarId })] }) }) }));
 };
 exports.SidebarRoot = SidebarRoot;

package/dist/components/ui/sidebar/sidebar-trigger.d.ts

@@ -0,0 +1,18 @@
+import React from 'react';
+import { IconButton } from '../icon-button';
+export type SidebarTriggerProps = React.ComponentProps<typeof IconButton>;
+/**
+ * The control that opens the mobile drawer.
+ *
+ * `md:hidden` by default because above 768px the rail is already on screen and
+ * a second way to reach it is a second thing to explain; a consumer that wants
+ * it everywhere passes its own display class.
+ *
+ * ⚠️ `aria-controls` IS SET ONLY WHILE THE DRAWER EXISTS. Radix unmounts the
+ * dialog content when closed, and a reference to an element that is not in the
+ * DOM is what axe-core reports as a CRITICAL `aria-valid-attr-value` — the same
+ * defect the Autocomplete panel was repaired for (console-sdk#150). A toggle
+ * with `aria-expanded="false"` and no `aria-controls` is complete on its own.
+ */
+export declare const SidebarTrigger: ({ className, onClick, "aria-label": ariaLabel, ...props }: SidebarTriggerProps) => React.JSX.Element;
+//# sourceMappingURL=sidebar-trigger.d.ts.map

package/dist/components/ui/sidebar/sidebar-trigger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidebar-trigger.d.ts","sourceRoot":"","sources":["../../../../src/components/ui/sidebar/sidebar-trigger.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAG3C,MAAM,MAAM,mBAAmB,GAAG,KAAK,CAAC,cAAc,CAAC,OAAO,UAAU,CAAC,CAAA;AAEzE;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,cAAc,GAAI,2DAK5B,mBAAmB,sBAqBrB,CAAA"}

package/dist/components/ui/sidebar/sidebar-trigger.js

@@ -0,0 +1,30 @@
+'use client';
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SidebarTrigger = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const lucide_react_1 = require("lucide-react");
+const utils_1 = require("../../../lib/utils");
+const icon_button_1 = require("../icon-button");
+const sidebar_provider_1 = require("./sidebar-provider");
+/**
+ * The control that opens the mobile drawer.
+ *
+ * `md:hidden` by default because above 768px the rail is already on screen and
+ * a second way to reach it is a second thing to explain; a consumer that wants
+ * it everywhere passes its own display class.
+ *
+ * ⚠️ `aria-controls` IS SET ONLY WHILE THE DRAWER EXISTS. Radix unmounts the
+ * dialog content when closed, and a reference to an element that is not in the
+ * DOM is what axe-core reports as a CRITICAL `aria-valid-attr-value` — the same
+ * defect the Autocomplete panel was repaired for (console-sdk#150). A toggle
+ * with `aria-expanded="false"` and no `aria-controls` is complete on its own.
+ */
+const SidebarTrigger = ({ className, onClick, 'aria-label': ariaLabel = 'Open navigation', ...props }) => {
+    const { openMobile, setOpenMobile, sidebarId } = (0, sidebar_provider_1.useSidebar)();
+    return ((0, jsx_runtime_1.jsx)(icon_button_1.IconButton, { type: "button", variant: "outline", "data-slot": "sidebar-trigger", "aria-label": ariaLabel, "aria-expanded": openMobile, "aria-controls": openMobile ? sidebarId : undefined, className: (0, utils_1.cn)('md:hidden', className), onClick: (event) => {
+            onClick?.(event);
+            setOpenMobile(!openMobile);
+        }, ...props, children: (0, jsx_runtime_1.jsx)(lucide_react_1.Menu, { "aria-hidden": true }) }));
+};
+exports.SidebarTrigger = SidebarTrigger;

package/dist/esm/components/breadcrumb/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/breadcrumb/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAUzB,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAED,KAAK,eAAe,GAAG;IACrB,KAAK,EAAE,cAAc,EAAE,CAAA;CACxB,CAAA;AAED,eAAO,MAAM,UAAU,GAAI,WAAW,eAAe,sBAoBpD,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/breadcrumb/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAUzB,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAED,KAAK,eAAe,GAAG;IACrB,KAAK,EAAE,cAAc,EAAE,CAAA;CACxB,CAAA;AAED,eAAO,MAAM,UAAU,GAAI,WAAW,eAAe,sBAmDpD,CAAA"}

package/dist/esm/components/breadcrumb/index.js

@@ -2,5 +2,29 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import React from 'react';
 import { Breadcrumb as BaseBreadcrumb, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator } from '../../components/ui/breadcrumb/index.js';
 export const Breadcrumb = ({ paths }) => {
-    return (_jsx(BaseBreadcrumb, { children: _jsx(BreadcrumbList, { children: paths.map((path, index) => (_jsxs(React.Fragment, { children: [_jsx(BreadcrumbItem, { children: path.href ? (_jsx(BreadcrumbLink, { href: path.href, children: path.name })) : (_jsx(BreadcrumbPage, { children: path.name })) }), _jsx(BreadcrumbSeparator, {})] }, index))) }) }));
+    const last = paths.length - 1;
+    return (_jsx(BaseBreadcrumb, { children: _jsx(BreadcrumbList, { children: paths.map((path, index) => {
+                /**
+                 * ⛔ THE LAST CRUMB IS THE PAGE, whatever the caller passed.
+                 *
+                 * The page marker used to be a side effect of the caller omitting
+                 * `href`, and nothing in `getBreadcrumbPaths` makes the last entry
+                 * omit one. A trail whose final entry carried an href therefore had
+                 * no `aria-current="page"` anywhere — a screen reader could not tell
+                 * which of three links was the page being read — and the crumb was a
+                 * live link back to the page the reader is already on.
+                 *
+                 * ⚠️ AND AN HREF-LESS ANCESTOR IS NOT A SWITCHED-OFF LINK. It used
+                 * to reach `BreadcrumbPage` too, which hard-codes `role="link"
+                 * aria-disabled="true"` — the right shape for the page you are ON,
+                 * a destination that exists and simply is not navigable from here.
+                 * An ancestor with no href is a grouping label: there is no page
+                 * behind it, so "Settings, link, dimmed" told the reader a
+                 * destination was unavailable to them rather than that it was never
+                 * a destination, and inflated the link count of the trail. It is
+                 * plain text now, and only the last crumb is the page.
+                 */
+                const isLast = index === last;
+                return (_jsxs(React.Fragment, { children: [_jsx(BreadcrumbItem, { children: path.href && !isLast ? (_jsx(BreadcrumbLink, { href: path.href, children: path.name })) : isLast ? (_jsx(BreadcrumbPage, { children: path.name })) : (_jsx("span", { className: "breadcrumb-page", children: path.name })) }), !isLast && _jsx(BreadcrumbSeparator, {})] }, index));
+            }) }) }));
 };

package/dist/esm/components/card/account-card/index.js

@@ -23,7 +23,7 @@ export function AccountBalanceCardHeader({ className, ...props }) {
     return (_jsx("div", { "data-slot": "account-balance-card-header", className: cn('flex flex-col', className), ...props }));
 }
 export function AccountBalanceCardTitle({ className, ...props }) {
-    return (_jsx("p", { "data-slot": "account-balance-card-title", className: cn('text-shadcn-600 text-lg font-bold', className), ...props }));
+    return (_jsx("p", { "data-slot": "account-balance-card-title", className: cn('text-foreground text-lg font-bold', className), ...props }));
 }
 export function AccountBalanceCardDeleteButton({ className, ...props }) {
     return (_jsx(IconButton, { variant: "outline", size: "small", rounded: true, "data-slot": "account-balance-card-delete-button", className: cn('absolute top-3 right-3', className), ...props, children: _jsx(Trash, { className: "text-muted-foreground h-4 w-4" }) }));
@@ -35,19 +35,19 @@ export function AccountBalanceCardLoading({ className, ...props }) {
     return (_jsx(Skeleton, { "data-slot": "account-balance-card-loading", className: cn('bg-muted mt-3 h-3 w-full rounded-md', className), ...props }));
 }
 export function AccountBalanceCardEmpty({ className, ...props }) {
-    return (_jsx("p", { "data-slot": "account-balance-card-empty", className: cn('text-shadcn-500 mt-3 text-center text-sm font-normal', className), ...props }));
+    return (_jsx("p", { "data-slot": "account-balance-card-empty", className: cn('text-muted-foreground mt-3 text-center text-sm font-normal', className), ...props }));
 }
 export function AccountBalanceCardInfo({ className, assetCode, value, children: _children, ref, ...props }) {
-    return (_jsxs("div", { ref: ref, "data-slot": "account-balance-card-info", className: cn('text-shadcn-500 mt-3 flex flex-row items-center justify-between text-sm font-normal', className), ...props, children: [_jsx("p", { children: assetCode }), _jsx("p", { children: value })] }));
+    return (_jsxs("div", { ref: ref, "data-slot": "account-balance-card-info", className: cn('text-muted-foreground mt-3 flex flex-row items-center justify-between text-sm font-normal', className), ...props, children: [_jsx("p", { children: assetCode }), _jsx("p", { children: value })] }));
 }
 export function AccountBalanceCardUpdateButton({ className: _className, loading, timestamp, loadingLabel = 'Updating...', updatedInLabel = 'Updated in', updatedLabel = 'Updated', onRefresh, children: _children, ref, ...props }) {
     const _time = useTime({ interval: 1000 * 60 });
     const updated = React.useMemo(() => {
         return !dayjs(timestamp).isBefore(dayjs().subtract(1, 'minute'));
     }, [_time, timestamp]);
-    return (_jsxs("div", { className: "mb-3 flex flex-row items-center justify-end gap-2", children: [_jsxs("p", { className: "text-shadcn-500 text-xs font-medium", children: [loading && loadingLabel, !loading && !updated && updatedInLabel, !loading && updated && updatedLabel] }), !loading && updated && (_jsx(CheckCircle2, { className: "text-system-success-h1a h-4 w-4" })), (!updated || loading) && (_jsx(Button, { ref: ref, variant: "link", "data-slot": "account-balance-card-update-button", className: "h-3 p-0", onClick: onRefresh, disabled: loading, ...props, children: _jsx(RefreshCw, { className: cn('size-4', { 'motion-safe:animate-spin': loading }) }) }))] }));
+    return (_jsxs("div", { className: "mb-3 flex flex-row items-center justify-end gap-2", children: [_jsxs("p", { className: "text-muted-foreground text-xs font-medium", children: [loading && loadingLabel, !loading && !updated && updatedInLabel, !loading && updated && updatedLabel] }), !loading && updated && (_jsx(CheckCircle2, { className: "text-system-success-h1a h-4 w-4" })), (!updated || loading) && (_jsx(Button, { ref: ref, variant: "link", "data-slot": "account-balance-card-update-button", className: "h-3 p-0", onClick: onRefresh, disabled: loading, ...props, children: _jsx(RefreshCw, { className: cn('size-4', { 'motion-safe:animate-spin': loading }) }) }))] }));
 }
 export function AccountBalanceCardTrigger({ className, openLabel, closeLabel, children: _children, ...props }) {
     const { open } = React.useContext(AccountBalanceCardContext);
-    return (_jsx(CollapsibleTrigger, { asChild: true, children: _jsx(Button, { variant: "link", "data-slot": "account-balance-card-trigger", className: cn('text-shadcn-600/40 h-4 p-0 text-xs', className), ...props, children: !open ? openLabel : closeLabel }) }));
+    return (_jsx(CollapsibleTrigger, { asChild: true, children: _jsx(Button, { variant: "link", "data-slot": "account-balance-card-trigger", className: cn('text-muted-foreground h-4 p-0 text-xs', className), ...props, children: !open ? openLabel : closeLabel }) }));
 }

package/dist/esm/components/card/basic-card/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/card/basic-card/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB,wBAAgB,SAAS,CAAC,EACxB,SAAS,EACT,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,qBAO7B;AAED,wBAAgB,cAAc,CAAC,EAC7B,SAAS,EACT,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,qBAO5B;AAED,wBAAgB,gBAAgB,CAAC,EAC/B,SAAS,EACT,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,qBAO7B;AAED,wBAAgB,eAAe,CAAC,EAC9B,SAAS,EACT,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,qBAE7B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/card/basic-card/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB,wBAAgB,SAAS,CAAC,EACxB,SAAS,EACT,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,qBAO7B;AAED,wBAAgB,cAAc,CAAC,EAC7B,SAAS,EACT,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,qBAO5B;AAED,wBAAgB,gBAAgB,CAAC,EAC/B,SAAS,EACT,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,qBAU7B;AAED,wBAAgB,eAAe,CAAC,EAC9B,SAAS,EACT,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,qBAE7B"}

package/dist/esm/components/card/basic-card/index.js

@@ -4,10 +4,10 @@ export function BasicCard({ className, ...props }) {
     return (_jsx("div", { className: cn('bg-card flex flex-col rounded-lg p-6', className), ...props }));
 }
 export function BasicCardTitle({ className, ...props }) {
-    return (_jsx("h2", { className: cn('text-shadcn-600 mb-4 text-sm font-medium', className), ...props }));
+    return (_jsx("h2", { className: cn('text-foreground mb-4 text-sm font-medium', className), ...props }));
 }
 export function BasicCardContent({ className, ...props }) {
-    return (_jsx("div", { className: cn('text-shadcn-500 mb-6 text-sm font-medium', className), ...props }));
+    return (_jsx("div", { className: cn('text-muted-foreground mb-6 text-sm font-medium', className), ...props }));
 }
 export function BasicCardAction({ className, ...props }) {
     return _jsx("div", { className: cn('flex flex-col', className), ...props });

package/dist/esm/components/card/entity-card/index.js

@@ -45,7 +45,7 @@ export function EntityCardDescription({ className, ...props }) {
     return (_jsx("p", { "data-slot": "entity-card-description", className: cn('text-muted-foreground text-xs font-medium', className), ...props }));
 }
 export function EntityCardList({ className, ...props }) {
-    return (_jsx("ul", { "data-slot": "entity-card-list", className: cn('text-shadcn-500 mx-2 list-inside list-disc space-y-1 text-xs font-medium', className), ...props }));
+    return (_jsx("ul", { "data-slot": "entity-card-list", className: cn('text-muted-foreground mx-2 list-inside list-disc space-y-1 text-xs font-medium', className), ...props }));
 }
 export function EntityCardFooter({ className, children, ...props }) {
     return (_jsxs("div", { "data-slot": "entity-card-footer", className: cn('text-muted-foreground flex flex-col gap-2 text-xs font-medium', className), ...props, children: [_jsx(Separator, {}), _jsx("div", { className: "[&>svg]:text-muted-foreground flex flex-row items-center gap-2 [&>svg]:size-4 [&>svg]:stroke-[1.5]", children: children })] }));

package/dist/esm/components/entity-box/index.d.ts

@@ -1,8 +1,24 @@
 import React from 'react';
 import { CollapsibleContentProps, CollapsibleProps, CollapsibleTriggerProps } from '@radix-ui/react-collapsible';
 declare function EntityBox({ className, children, ...props }: React.ComponentProps<'div'>): React.JSX.Element;
-declare function EntityBoxCollapsible({ className, ...props }: CollapsibleProps): React.JSX.Element;
-declare function EntityBoxCollapsibleTrigger(props: CollapsibleTriggerProps): React.JSX.Element;
+declare function EntityBoxCollapsible({ className, open, defaultOpen, onOpenChange, ...props }: CollapsibleProps): React.JSX.Element;
+export type EntityBoxCollapsibleTriggerProps = CollapsibleTriggerProps & {
+    /** Accessible name while the box is closed. */
+    expandLabel?: string;
+    /** Accessible name while the box is open. */
+    collapseLabel?: string;
+};
+/**
+ * ⛔ THIS TRIGGER HAS NO TEXT NODE. It is a `Settings2` glyph inside a Button,
+ * so without an `aria-label` a screen reader announced "button" and nothing
+ * else (SC 4.1.2) — and this is the control that opens the filter panel on
+ * every console list page.
+ *
+ * The name describes the ACTION and Radix's `aria-expanded` carries the state,
+ * so the two halves do not repeat each other. English defaults because no
+ * consumer passes a label today; a translated console overrides both.
+ */
+declare function EntityBoxCollapsibleTrigger({ expandLabel, collapseLabel, 'aria-label': ariaLabel, ...props }: EntityBoxCollapsibleTriggerProps): React.JSX.Element;
 declare function EntityBoxCollapsibleContent({ children, ...props }: CollapsibleContentProps): React.JSX.Element;
 export interface EntityBoxHeaderProps extends React.ComponentProps<'div'> {
     title: string;