@deadragdoll/reactnu 0.1.75 → 0.1.76

package/dist/index.cjs

@@ -3124,28 +3124,93 @@ 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 {
+  }
+}
 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
     }
   };
 }
@@ -3671,6 +3736,17 @@ function NuWindowProvider({
   (0, import_react19.useEffect)(() => {
     onAppModalChange?.(hasAppModal);
   }, [hasAppModal, onAppModalChange]);
+  (0, import_react19.useEffect)(() => {
+    for (const windowEntry of windows) {
+      if (!windowEntry.windowStoreKey) {
+        continue;
+      }
+      writeStoredWindowSnapshot(
+        windowEntry.windowStoreKey,
+        resolveManagedWindowSnapshot(windowEntry, windowBoundsById)
+      );
+    }
+  }, [windowBoundsById, windows]);
   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) => {

package/dist/index.js

@@ -3072,28 +3072,93 @@ 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 {
+  }
+}
 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
     }
   };
 }
@@ -3619,6 +3684,17 @@ function NuWindowProvider({
   useEffect6(() => {
     onAppModalChange?.(hasAppModal);
   }, [hasAppModal, onAppModalChange]);
+  useEffect6(() => {
+    for (const windowEntry of windows) {
+      if (!windowEntry.windowStoreKey) {
+        continue;
+      }
+      writeStoredWindowSnapshot(
+        windowEntry.windowStoreKey,
+        resolveManagedWindowSnapshot(windowEntry, windowBoundsById)
+      );
+    }
+  }, [windowBoundsById, windows]);
   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) => {

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.76",
   "private": false,
   "description": "React components with a precise DOS-era utility interface.",
   "license": "MIT",