@forgeax/app-shell 0.40.0 → 0.41.0

package/dist/react.d.ts

@@ -10,6 +10,27 @@ declare function isSlotDebugEnabled(search?: string): boolean;
 /** Dev-time visualization derived only from live `data-fx-slot` markers. */
 declare function SlotDebugOverlay(): ReactElement;
 
+interface PersistentSizeStorage {
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+}
+interface PersistentSizeStoreOptions {
+    storageKey: string;
+    defaultSize: number;
+    minSize: number;
+    maxSize: number;
+    storage?: PersistentSizeStorage | null;
+}
+type PersistentSizeUpdate = number | ((previous: number) => number);
+interface PersistentSizeStore {
+    getSnapshot(): number;
+    subscribe(listener: () => void): () => void;
+    setSize(next: PersistentSizeUpdate): void;
+    reload(): void;
+}
+/** Product-neutral persistent numeric state for resizable shell regions. */
+declare function createPersistentSizeStore(options: PersistentSizeStoreOptions): PersistentSizeStore;
+declare function usePersistentSizeStore(store: PersistentSizeStore): number;
 declare function useLocalSize(key: string, initial: number, min: number, max: number): readonly [number, (next: number | ((previous: number) => number)) => void];
 interface ResizeHandleProps {
     orientation: 'col' | 'row';
@@ -181,4 +202,4 @@ interface ShellSlotProps extends HTMLAttributes<HTMLElement> {
 /** Structural shell marker that preserves the caller's semantic element. */
 declare function ShellSlot({ as, name, ...props }: ShellSlotProps): ReactElement;
 
-export { type AnchoredResizeDirection, AnchoredResizeHandle, type AnchoredResizeHandleProps, type AnchoredResizeSession, DetachedPanelBoundary, type DetachedPanelBoundaryProps, DetachedSurfaceFrame, type DetachedSurfaceFrameProps, DetachedSurfaceStatus, type DetachedSurfaceStatusProps, type DetachedSurfaceStatusTone, type DockLayoutControlBinding, type DockLayoutControlBindingOptions, DockLayoutMenu, type DockLayoutMenuPanel, type DockLayoutMenuProps, FloatingMenu, type FloatingMenuAnchor, type FloatingMenuPoint, type FloatingMenuProps, type PanelContentPadding, type PanelContentPolicy, type PanelContentScroll, type PanelContentTone, PanelEmptyState, type PanelEmptyStateProps, PanelSurface, type PanelSurfaceProps, ResizeHandle, type ResizeHandleProps, ShellSlot, type ShellSlotElement, type ShellSlotProps, SlotDebugOverlay, SurfacePlaceholder, type SurfacePlaceholderProps, SurfaceRegion, type SurfaceRegionProps, applyAnchoredResizeDelta, beginAnchoredResize, hashSlotHue, isSlotDebugEnabled, useDockLayoutControlBinding, useLocalSize };
+export { type AnchoredResizeDirection, AnchoredResizeHandle, type AnchoredResizeHandleProps, type AnchoredResizeSession, DetachedPanelBoundary, type DetachedPanelBoundaryProps, DetachedSurfaceFrame, type DetachedSurfaceFrameProps, DetachedSurfaceStatus, type DetachedSurfaceStatusProps, type DetachedSurfaceStatusTone, type DockLayoutControlBinding, type DockLayoutControlBindingOptions, DockLayoutMenu, type DockLayoutMenuPanel, type DockLayoutMenuProps, FloatingMenu, type FloatingMenuAnchor, type FloatingMenuPoint, type FloatingMenuProps, type PanelContentPadding, type PanelContentPolicy, type PanelContentScroll, type PanelContentTone, PanelEmptyState, type PanelEmptyStateProps, PanelSurface, type PanelSurfaceProps, type PersistentSizeStorage, type PersistentSizeStore, type PersistentSizeStoreOptions, type PersistentSizeUpdate, ResizeHandle, type ResizeHandleProps, ShellSlot, type ShellSlotElement, type ShellSlotProps, SlotDebugOverlay, SurfacePlaceholder, type SurfacePlaceholderProps, SurfaceRegion, type SurfaceRegionProps, applyAnchoredResizeDelta, beginAnchoredResize, createPersistentSizeStore, hashSlotHue, isSlotDebugEnabled, useDockLayoutControlBinding, useLocalSize, usePersistentSizeStore };

package/dist/react.js

@@ -595,8 +595,74 @@ function SlotDebugOverlay() {
 }
 
 // src/resize.tsx
-import { useEffect as useEffect2, useRef, useState as useState2 } from "react";
+import { useEffect as useEffect2, useRef, useState as useState2, useSyncExternalStore } from "react";
 import { jsx as jsx2 } from "react/jsx-runtime";
+function browserPersistentSizeStorage() {
+  if (typeof window === "undefined") return null;
+  try {
+    return window.localStorage;
+  } catch {
+    return null;
+  }
+}
+function createPersistentSizeStore(options) {
+  const minSize = Math.min(options.minSize, options.maxSize);
+  const maxSize = Math.max(options.minSize, options.maxSize);
+  const normalize = (value2, fallback) => {
+    if (!Number.isFinite(value2)) return fallback;
+    return Math.min(maxSize, Math.max(minSize, Math.round(value2)));
+  };
+  const defaultSize = normalize(options.defaultSize, minSize);
+  const storage = options.storage === void 0 ? browserPersistentSizeStorage() : options.storage;
+  const read = () => {
+    try {
+      const raw = storage?.getItem(options.storageKey);
+      if (!raw) return defaultSize;
+      const parsed = Number.parseInt(raw, 10);
+      return normalize(parsed, defaultSize);
+    } catch {
+      return defaultSize;
+    }
+  };
+  let value = read();
+  const listeners = /* @__PURE__ */ new Set();
+  const commit = (next) => {
+    if (Object.is(value, next)) return;
+    value = next;
+    for (const listener of [...listeners]) {
+      try {
+        listener();
+      } catch {
+      }
+    }
+  };
+  return {
+    getSnapshot: () => value,
+    subscribe: (listener) => {
+      listeners.add(listener);
+      let active = true;
+      return () => {
+        if (!active) return;
+        active = false;
+        listeners.delete(listener);
+      };
+    },
+    setSize: (next) => {
+      const candidate = typeof next === "function" ? next(value) : next;
+      const normalized = normalize(candidate, value);
+      if (Object.is(value, normalized)) return;
+      try {
+        storage?.setItem(options.storageKey, String(normalized));
+      } catch {
+      }
+      commit(normalized);
+    },
+    reload: () => commit(read())
+  };
+}
+function usePersistentSizeStore(store) {
+  return useSyncExternalStore(store.subscribe, store.getSnapshot, store.getSnapshot);
+}
 function useLocalSize(key, initial, min, max) {
   const clamp = (value2) => Math.min(max, Math.max(min, value2));
   const [value, setValueRaw] = useState2(() => {
@@ -944,7 +1010,7 @@ var SurfaceRegion = forwardRef(
 );
 
 // src/dock-layout-control.ts
-import { useEffect as useEffect3, useMemo, useSyncExternalStore } from "react";
+import { useEffect as useEffect3, useMemo, useSyncExternalStore as useSyncExternalStore2 } from "react";
 function useDockLayoutControlBinding({
   state,
   onToggle,
@@ -952,7 +1018,7 @@ function useDockLayoutControlBinding({
   closePanel,
   reopenPanel
 }) {
-  const snapshot = useSyncExternalStore(
+  const snapshot = useSyncExternalStore2(
     state.subscribe,
     state.getSnapshot,
     state.getSnapshot
@@ -1167,10 +1233,12 @@ export {
   SurfaceRegion,
   applyAnchoredResizeDelta,
   beginAnchoredResize,
+  createPersistentSizeStore,
   hashSlotHue,
   isSlotDebugEnabled,
   useDockLayoutControlBinding,
-  useLocalSize
+  useLocalSize,
+  usePersistentSizeStore
 };
 /*! Bundled license information:
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forgeax/app-shell",
-  "version": "0.40.0",
+  "version": "0.41.0",
   "description": "Generic Dock, Panel, Window, and Slot composition primitives",
   "license": "Apache-2.0",
   "type": "module",