@cntyclub/ui-react 0.5.0 → 0.6.0

package/dist/index.d.ts

@@ -1277,10 +1277,18 @@ type SidebarContextProps = {
     toggleSidebar: () => void;
 };
 declare function useSidebar(): SidebarContextProps;
-declare function SidebarProvider({ defaultOpen, open: openProp, onOpenChange: setOpenProp, className, style, children, ...props }: React$1.ComponentProps<"div"> & {
+declare function SidebarProvider({ defaultOpen, open: openProp, onOpenChange: setOpenProp, persistKey, className, style, children, ...props }: React$1.ComponentProps<"div"> & {
     defaultOpen?: boolean;
     open?: boolean;
     onOpenChange?: (open: boolean) => void;
+    /**
+     * Remember the expanded/collapsed state in `localStorage` under this key and
+     * restore it on the next load (desktop rail only; the mobile sheet is always
+     * closed on load). Opt-in — omit to keep the sidebar un-persisted. Ignored in
+     * controlled mode (when `open` is provided). The restore runs before first
+     * paint, so there's no expand→collapse flash.
+     */
+    persistKey?: string;
 }): React$1.JSX.Element;
 declare function Sidebar({ side, variant, collapsible, className, children, ...props }: React$1.ComponentProps<"div"> & {
     side?: "left" | "right";

package/dist/index.js

@@ -7615,6 +7615,7 @@ function SidebarProvider({
   defaultOpen = true,
   open: openProp,
   onOpenChange: setOpenProp,
+  persistKey,
   className,
   style,
   children,
@@ -7641,11 +7642,24 @@ function SidebarProvider({
       }
       try {
         document.cookie = `${SIDEBAR_COOKIE_NAME}=${openState}; path=/; max-age=${SIDEBAR_COOKIE_MAX_AGE}`;
+        if (persistKey) {
+          window.localStorage.setItem(persistKey, openState ? "true" : "false");
+        }
       } catch {
       }
     },
-    [setOpenProp, open]
+    [setOpenProp, open, persistKey]
   );
+  useIsomorphicLayoutEffect(() => {
+    if (!persistKey || openProp !== void 0) return;
+    try {
+      const stored = window.localStorage.getItem(persistKey);
+      if (stored === "true" || stored === "false") {
+        _setOpen(stored === "true");
+      }
+    } catch {
+    }
+  }, [persistKey, openProp]);
   const toggleSidebar = React17.useCallback(() => {
     return isMobile ? setOpenMobile((open2) => !open2) : setOpen((open2) => !open2);
   }, [isMobile, setOpen]);