@deadragdoll/reactnu 0.1.75 → 0.1.77

package/dist/index.cjs

@@ -3124,28 +3124,94 @@ function getNumericStyleValue(value) {
   }
   return void 0;
 }
+function getWindowStorageKey(windowStoreKey) {
+  const normalizedKey = windowStoreKey?.trim();
+  return normalizedKey ? `reactnu.window.${normalizedKey}` : null;
+}
+function readStoredWindowSnapshot(windowStoreKey) {
+  const storageKey = getWindowStorageKey(windowStoreKey);
+  if (!storageKey || typeof window === "undefined") {
+    return void 0;
+  }
+  try {
+    const rawValue = window.localStorage.getItem(storageKey);
+    if (!rawValue) {
+      return void 0;
+    }
+    const parsedValue = JSON.parse(rawValue);
+    if (!parsedValue || typeof parsedValue !== "object") {
+      return void 0;
+    }
+    const storedValue = parsedValue;
+    const snapshot = {};
+    for (const property of ["height", "width"]) {
+      const value = storedValue[property];
+      if (typeof value === "number" && Number.isFinite(value) && value > 0) {
+        snapshot[property] = value;
+      }
+    }
+    for (const property of ["left", "top"]) {
+      const value = storedValue[property];
+      if (typeof value === "number" && Number.isFinite(value) && value >= 0) {
+        snapshot[property] = value;
+      }
+    }
+    for (const property of ["maximized", "minimized"]) {
+      const value = storedValue[property];
+      if (typeof value === "boolean") {
+        snapshot[property] = value;
+      }
+    }
+    return Object.keys(snapshot).length > 0 ? snapshot : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function writeStoredWindowSnapshot(windowStoreKey, snapshot) {
+  const storageKey = getWindowStorageKey(windowStoreKey);
+  if (!storageKey || typeof window === "undefined") {
+    return;
+  }
+  try {
+    window.localStorage.setItem(storageKey, JSON.stringify(snapshot));
+  } catch {
+  }
+}
+var WINDOW_STORE_WRITE_DEBOUNCE_MS = 250;
 function resolveSavedWindowStyle(definition, mode, ownerCenteredStyle, index) {
-  const snapshot = definition.onOpen?.();
-  const savedStyle = snapshot ? {
-    height: snapshot.height,
-    left: snapshot.left,
-    top: snapshot.top,
-    transform: snapshot.left !== void 0 || snapshot.top !== void 0 ? "none" : void 0,
-    width: snapshot.width
-  } : void 0;
+  const snapshot = definition.onOpen?.() ?? readStoredWindowSnapshot(definition.windowStoreKey);
+  const savedStyle = {};
+  if (snapshot) {
+    if (snapshot.height !== void 0) {
+      savedStyle.height = snapshot.height;
+    }
+    if (snapshot.left !== void 0) {
+      savedStyle.left = snapshot.left;
+    }
+    if (snapshot.top !== void 0) {
+      savedStyle.top = snapshot.top;
+    }
+    if (snapshot.width !== void 0) {
+      savedStyle.width = snapshot.width;
+    }
+    if (snapshot.left !== void 0 || snapshot.top !== void 0) {
+      savedStyle.transform = "none";
+    }
+  }
   return {
     maximized: snapshot?.maximized === true,
     minimized: snapshot?.minimized === true,
-    restoreStyle: snapshot?.maximized === true && savedStyle ? {
+    restoreStyle: snapshot?.maximized ? {
       ...getDefaultWindowStyle(mode, index),
       ...ownerCenteredStyle,
+      ...definition.style,
       ...savedStyle
     } : void 0,
     style: {
       ...getDefaultWindowStyle(mode, index),
       ...ownerCenteredStyle,
-      ...savedStyle,
-      ...definition.style
+      ...definition.style,
+      ...savedStyle
     }
   };
 }
@@ -3250,6 +3316,7 @@ function NuWindowProvider({
   const creationOrderRef = (0, import_react19.useRef)(0);
   const idRef = (0, import_react19.useRef)(0);
   const windowBoundsByIdRef = (0, import_react19.useRef)({});
+  const pendingWindowStoreWritesRef = (0, import_react19.useRef)(/* @__PURE__ */ new Map());
   const [windows, setWindows] = (0, import_react19.useState)([]);
   const [windowBoundsById, setWindowBoundsById] = (0, import_react19.useState)({});
   const appHostMenuContext = (0, import_react19.useContext)(AppHostMenuContext);
@@ -3671,6 +3738,53 @@ function NuWindowProvider({
   (0, import_react19.useEffect)(() => {
     onAppModalChange?.(hasAppModal);
   }, [hasAppModal, onAppModalChange]);
+  (0, import_react19.useEffect)(() => {
+    const pendingWindowStoreWrites = pendingWindowStoreWritesRef.current;
+    const windowStoreKeyById = new Map(
+      windows.map((windowEntry) => [windowEntry.id, windowEntry.windowStoreKey])
+    );
+    for (const [id, pending] of pendingWindowStoreWrites) {
+      if (windowStoreKeyById.get(id) === pending.windowStoreKey) {
+        continue;
+      }
+      clearTimeout(pending.timeoutId);
+      pendingWindowStoreWrites.delete(id);
+      writeStoredWindowSnapshot(pending.windowStoreKey, pending.snapshot);
+    }
+    for (const windowEntry of windows) {
+      if (!windowEntry.windowStoreKey) {
+        continue;
+      }
+      const existing = pendingWindowStoreWrites.get(windowEntry.id);
+      if (existing) {
+        clearTimeout(existing.timeoutId);
+      }
+      const windowStoreKey = windowEntry.windowStoreKey;
+      const snapshot = resolveManagedWindowSnapshot(
+        windowEntry,
+        windowBoundsById
+      );
+      const timeoutId = setTimeout(() => {
+        writeStoredWindowSnapshot(windowStoreKey, snapshot);
+        pendingWindowStoreWrites.delete(windowEntry.id);
+      }, WINDOW_STORE_WRITE_DEBOUNCE_MS);
+      pendingWindowStoreWrites.set(windowEntry.id, {
+        timeoutId,
+        windowStoreKey,
+        snapshot
+      });
+    }
+  }, [windowBoundsById, windows]);
+  (0, import_react19.useEffect)(() => {
+    const pendingWindowStoreWrites = pendingWindowStoreWritesRef.current;
+    return () => {
+      for (const entry of pendingWindowStoreWrites.values()) {
+        clearTimeout(entry.timeoutId);
+        writeStoredWindowSnapshot(entry.windowStoreKey, entry.snapshot);
+      }
+      pendingWindowStoreWrites.clear();
+    };
+  }, []);
   return /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(NuWindowContext.Provider, { value: contextValue, children: /* @__PURE__ */ (0, import_jsx_runtime29.jsxs)("div", { className: ["nu-window-host", className].filter(Boolean).join(" "), children: [
     children,
     /* @__PURE__ */ (0, import_jsx_runtime29.jsx)("div", { className: "nu-window-layer", children: renderWindows.map((windowEntry) => {
@@ -4970,7 +5084,7 @@ function NuIconGridItem({
     icon.contextMenuItems,
     icon
   );
-  const dragSource = useNuDragSource({
+  const { dragRef, isDragging } = useNuDragSource({
     disabled: icon.disabled,
     getItem: () => ({ data: icon, id: icon.id, type: "icon" }),
     onDropAccepted: (result) => {
@@ -5013,14 +5127,14 @@ function NuIconGridItem({
       {
         "aria-haspopup": contextMenuItems.length > 0 ? "menu" : void 0,
         className: "nu-icon-grid__icon",
-        "data-dragging": dragSource.isDragging || void 0,
+        "data-dragging": isDragging || void 0,
         "data-selected": manager.selectedIconId === icon.id || void 0,
         disabled: icon.disabled,
         onClick: handleClick,
         onContextMenu: handleContextMenu,
         onDoubleClick: icon.onDoubleClick,
         onKeyDown: handleKeyDown,
-        ref: dragSource.dragRef,
+        ref: (node) => dragRef(node),
         style: { left: icon.position.x, top: icon.position.y },
         type: "button",
         children: [

package/dist/index.js

@@ -3072,28 +3072,94 @@ function getNumericStyleValue(value) {
   }
   return void 0;
 }
+function getWindowStorageKey(windowStoreKey) {
+  const normalizedKey = windowStoreKey?.trim();
+  return normalizedKey ? `reactnu.window.${normalizedKey}` : null;
+}
+function readStoredWindowSnapshot(windowStoreKey) {
+  const storageKey = getWindowStorageKey(windowStoreKey);
+  if (!storageKey || typeof window === "undefined") {
+    return void 0;
+  }
+  try {
+    const rawValue = window.localStorage.getItem(storageKey);
+    if (!rawValue) {
+      return void 0;
+    }
+    const parsedValue = JSON.parse(rawValue);
+    if (!parsedValue || typeof parsedValue !== "object") {
+      return void 0;
+    }
+    const storedValue = parsedValue;
+    const snapshot = {};
+    for (const property of ["height", "width"]) {
+      const value = storedValue[property];
+      if (typeof value === "number" && Number.isFinite(value) && value > 0) {
+        snapshot[property] = value;
+      }
+    }
+    for (const property of ["left", "top"]) {
+      const value = storedValue[property];
+      if (typeof value === "number" && Number.isFinite(value) && value >= 0) {
+        snapshot[property] = value;
+      }
+    }
+    for (const property of ["maximized", "minimized"]) {
+      const value = storedValue[property];
+      if (typeof value === "boolean") {
+        snapshot[property] = value;
+      }
+    }
+    return Object.keys(snapshot).length > 0 ? snapshot : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function writeStoredWindowSnapshot(windowStoreKey, snapshot) {
+  const storageKey = getWindowStorageKey(windowStoreKey);
+  if (!storageKey || typeof window === "undefined") {
+    return;
+  }
+  try {
+    window.localStorage.setItem(storageKey, JSON.stringify(snapshot));
+  } catch {
+  }
+}
+var WINDOW_STORE_WRITE_DEBOUNCE_MS = 250;
 function resolveSavedWindowStyle(definition, mode, ownerCenteredStyle, index) {
-  const snapshot = definition.onOpen?.();
-  const savedStyle = snapshot ? {
-    height: snapshot.height,
-    left: snapshot.left,
-    top: snapshot.top,
-    transform: snapshot.left !== void 0 || snapshot.top !== void 0 ? "none" : void 0,
-    width: snapshot.width
-  } : void 0;
+  const snapshot = definition.onOpen?.() ?? readStoredWindowSnapshot(definition.windowStoreKey);
+  const savedStyle = {};
+  if (snapshot) {
+    if (snapshot.height !== void 0) {
+      savedStyle.height = snapshot.height;
+    }
+    if (snapshot.left !== void 0) {
+      savedStyle.left = snapshot.left;
+    }
+    if (snapshot.top !== void 0) {
+      savedStyle.top = snapshot.top;
+    }
+    if (snapshot.width !== void 0) {
+      savedStyle.width = snapshot.width;
+    }
+    if (snapshot.left !== void 0 || snapshot.top !== void 0) {
+      savedStyle.transform = "none";
+    }
+  }
   return {
     maximized: snapshot?.maximized === true,
     minimized: snapshot?.minimized === true,
-    restoreStyle: snapshot?.maximized === true && savedStyle ? {
+    restoreStyle: snapshot?.maximized ? {
       ...getDefaultWindowStyle(mode, index),
       ...ownerCenteredStyle,
+      ...definition.style,
       ...savedStyle
     } : void 0,
     style: {
       ...getDefaultWindowStyle(mode, index),
       ...ownerCenteredStyle,
-      ...savedStyle,
-      ...definition.style
+      ...definition.style,
+      ...savedStyle
     }
   };
 }
@@ -3198,6 +3264,7 @@ function NuWindowProvider({
   const creationOrderRef = useRef8(0);
   const idRef = useRef8(0);
   const windowBoundsByIdRef = useRef8({});
+  const pendingWindowStoreWritesRef = useRef8(/* @__PURE__ */ new Map());
   const [windows, setWindows] = useState10([]);
   const [windowBoundsById, setWindowBoundsById] = useState10({});
   const appHostMenuContext = useContext7(AppHostMenuContext);
@@ -3619,6 +3686,53 @@ function NuWindowProvider({
   useEffect6(() => {
     onAppModalChange?.(hasAppModal);
   }, [hasAppModal, onAppModalChange]);
+  useEffect6(() => {
+    const pendingWindowStoreWrites = pendingWindowStoreWritesRef.current;
+    const windowStoreKeyById = new Map(
+      windows.map((windowEntry) => [windowEntry.id, windowEntry.windowStoreKey])
+    );
+    for (const [id, pending] of pendingWindowStoreWrites) {
+      if (windowStoreKeyById.get(id) === pending.windowStoreKey) {
+        continue;
+      }
+      clearTimeout(pending.timeoutId);
+      pendingWindowStoreWrites.delete(id);
+      writeStoredWindowSnapshot(pending.windowStoreKey, pending.snapshot);
+    }
+    for (const windowEntry of windows) {
+      if (!windowEntry.windowStoreKey) {
+        continue;
+      }
+      const existing = pendingWindowStoreWrites.get(windowEntry.id);
+      if (existing) {
+        clearTimeout(existing.timeoutId);
+      }
+      const windowStoreKey = windowEntry.windowStoreKey;
+      const snapshot = resolveManagedWindowSnapshot(
+        windowEntry,
+        windowBoundsById
+      );
+      const timeoutId = setTimeout(() => {
+        writeStoredWindowSnapshot(windowStoreKey, snapshot);
+        pendingWindowStoreWrites.delete(windowEntry.id);
+      }, WINDOW_STORE_WRITE_DEBOUNCE_MS);
+      pendingWindowStoreWrites.set(windowEntry.id, {
+        timeoutId,
+        windowStoreKey,
+        snapshot
+      });
+    }
+  }, [windowBoundsById, windows]);
+  useEffect6(() => {
+    const pendingWindowStoreWrites = pendingWindowStoreWritesRef.current;
+    return () => {
+      for (const entry of pendingWindowStoreWrites.values()) {
+        clearTimeout(entry.timeoutId);
+        writeStoredWindowSnapshot(entry.windowStoreKey, entry.snapshot);
+      }
+      pendingWindowStoreWrites.clear();
+    };
+  }, []);
   return /* @__PURE__ */ jsx29(NuWindowContext.Provider, { value: contextValue, children: /* @__PURE__ */ jsxs17("div", { className: ["nu-window-host", className].filter(Boolean).join(" "), children: [
     children,
     /* @__PURE__ */ jsx29("div", { className: "nu-window-layer", children: renderWindows.map((windowEntry) => {
@@ -4935,7 +5049,7 @@ function NuIconGridItem({
     icon.contextMenuItems,
     icon
   );
-  const dragSource = useNuDragSource({
+  const { dragRef, isDragging } = useNuDragSource({
     disabled: icon.disabled,
     getItem: () => ({ data: icon, id: icon.id, type: "icon" }),
     onDropAccepted: (result) => {
@@ -4978,14 +5092,14 @@ function NuIconGridItem({
       {
         "aria-haspopup": contextMenuItems.length > 0 ? "menu" : void 0,
         className: "nu-icon-grid__icon",
-        "data-dragging": dragSource.isDragging || void 0,
+        "data-dragging": isDragging || void 0,
         "data-selected": manager.selectedIconId === icon.id || void 0,
         disabled: icon.disabled,
         onClick: handleClick,
         onContextMenu: handleContextMenu,
         onDoubleClick: icon.onDoubleClick,
         onKeyDown: handleKeyDown,
-        ref: dragSource.dragRef,
+        ref: (node) => dragRef(node),
         style: { left: icon.position.x, top: icon.position.y },
         type: "button",
         children: [

package/dist/windowing/windowing.types.d.ts

@@ -39,6 +39,11 @@ export type NuManagedWindowDefinition = {
     style?: CSSProperties;
     titleButtons?: WindowTitleButtonDefinition[];
     title: string;
+    /**
+     * Persists this managed window's geometry and minimized/maximized state in
+     * localStorage. The key is scoped to `reactnu.window.`.
+     */
+    windowStoreKey?: string;
 };
 export type NuManagedWindowControls = {
     bringToFront: () => void;

package/docs/ARCHITECTURE.md

@@ -126,6 +126,8 @@ The host owns:
 
 Managed windows can persist geometry with:
 
+- `windowStoreKey?: string` for automatic browser-local persistence under
+  `reactnu.window.<key>`
 - `onOpen?: () => NuManagedWindowSnapshot | void`
 - `onClose?: (snapshot) => boolean | void`
 

package/docs/NuWindowProvider.md

@@ -29,7 +29,26 @@ Use `useNuWindowManager()` to access:
 
 ## Managed Window Persistence
 
-`NuManagedWindowDefinition` also supports:
+Set `windowStoreKey` to persist a managed window's last position, size, and
+minimized/maximized state automatically. ReactNU stores the snapshot in
+`localStorage` as `reactnu.window.<key>`. Use a stable, unique key for each
+logical window; re-opening that window with the same key restores its saved
+geometry.
+
+```tsx
+windowManager.openWindow({
+  content: <Inspector />,
+  title: "Inspector",
+  windowStoreKey: "workspace.inspector"
+});
+```
+
+Browser storage is optional: malformed or unavailable storage is ignored.
+`onOpen` remains the explicit override for applications that restore state
+from their own storage, and `onClose` still receives the current snapshot.
+Clear `reactnu.window.workspace.inspector` to reset this example.
+
+For host-owned persistence, `NuManagedWindowDefinition` also supports:
 
 - `onOpen?: () => NuManagedWindowSnapshot | void`
 - `onClose?: (snapshot: NuManagedWindowSnapshot) => boolean | void`

package/docs/Window.md

@@ -56,6 +56,10 @@ to `useNuWindowManager().openWindow(...)`; it is resolved by
 `NuWindowProvider`, rather than by a standalone `Window` instance. See
 [NuWindowProvider](./NuWindowProvider.md#linked-activation).
 
+`windowStoreKey?: string` is also available on a managed window definition.
+It automatically restores and saves that window's geometry in browser storage;
+see [NuWindowProvider](./NuWindowProvider.md#managed-window-persistence).
+
 ## Notes
 
 - Drag and resize are implemented with pointer events and local DOM updates for smoother motion.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deadragdoll/reactnu",
-  "version": "0.1.75",
+  "version": "0.1.77",
   "private": false,
   "description": "React components with a precise DOS-era utility interface.",
   "license": "MIT",