@owdproject/nuxt 4.0.0-alpha.3 → 4.0.0-alpha.4

package/dist/kit/authoring.d.ts

@@ -51,21 +51,13 @@ export declare function setDesktopExtensionConfig(nuxt: Nuxt, configKey: string,
  * User values from desktop.config win over `partial` (defu: partial fills undefined only).
  */
 export declare function mergeDesktopExtensionConfig(nuxt: Nuxt, configKey: string, partial: Record<string, unknown>): void;
-/**
- * Reads the declarative extension contract (`kind`, `framework`, `adapter`, …) from a
- * package's Nuxt module `meta`. Build-time only — no runtime imports. Used to keep the
- * collection contract framework-agnostic across desktop distributions.
- */
-export declare function readExtensionMeta(modulePath: string): Promise<Partial<DesktopExtensionMeta>>;
-/**
- * Validates an extension contract and returns a normalized copy. Throws on an unknown
- * kind/framework so misconfigured extensions fail at build time instead of at runtime.
- */
+/** Reads build-time extension metadata using Nuxt module resolution and getMeta(). */
+export declare function readExtensionMeta(modulePath: string, nuxt?: Nuxt): Promise<Partial<DesktopExtensionMeta>>;
+/** Validates the declared contract; this alone does not check the host integration. */
 export declare function assertDesktopExtensionMeta(meta: Partial<DesktopExtensionMeta>, packageName?: string): DesktopExtensionMeta;
 /**
- * Installs a desktop theme, module, or app package.
- * When the package exposes `meta.configKey`, passes `desktop[configKey]` to `installModule`
- * so Nuxt merges desktop.config with module defaults.
+ * Installs a desktop theme, module, or app after checking explicit extension metadata.
+ * Ordinary Nuxt modules and older name/configKey-only descriptors remain supported.
  */
 export declare function installDesktopPackage(nuxt: Nuxt, modulePath: string, desktop?: Record<string, unknown>): Promise<void>;
 type DesktopModuleMeta = {

package/dist/kit/authoring.js

@@ -3,7 +3,7 @@ import { join } from "node:path";
 import {
   defineNuxtModule,
   installModule,
-  resolvePath
+  loadNuxtModuleInstance
 } from "@nuxt/kit";
 import { defu } from "defu";
 export function defineDesktopConfig(config) {
@@ -45,6 +45,11 @@ export function assertValidDesktopUserConfig(config, configFile = "desktop.confi
     );
   }
   const c = config;
+  if (c.id != null && (typeof c.id !== "string" || !/^[a-zA-Z0-9][a-zA-Z0-9._-]{0,63}$/.test(c.id))) {
+    throw new Error(
+      `[@owdproject/nuxt] ${configFile}: \`id\` must be a stable identifier of 1\u201364 ASCII letters, digits, dots, underscores or hyphens, starting with a letter or digit (e.g. 'atproto-os').`
+    );
+  }
   if (c.theme != null && typeof c.theme !== "string") {
     throw new Error(
       `[@owdproject/nuxt] ${configFile}: \`theme\` must be a string (npm package name or local path of the theme module).`
@@ -139,33 +144,27 @@ export function mergeDesktopExtensionConfig(nuxt, configKey, partial) {
   const base = existing && typeof existing === "object" && !Array.isArray(existing) ? existing : {};
   desktop[configKey] = defu(partial, base);
 }
-async function readConfigKey(mod) {
-  if (!mod) return void 0;
-  let meta = mod.meta ?? mod.default?.meta;
-  if (!meta) {
-    const getMeta = mod.getMeta ?? mod.default?.getMeta;
-    if (typeof getMeta === "function") {
-      try {
-        meta = await getMeta();
-      } catch (e) {
-        console.warn("[@owdproject/nuxt] failed to call getMeta():", e);
-      }
-    }
+const EXTENSION_META_KEYS = [
+  "kind",
+  "framework",
+  "packageName",
+  "configKey",
+  "entry",
+  "adapter",
+  "requires"
+];
+async function loadModuleMeta(modulePath, nuxt) {
+  const { nuxtModule, buildTimeModuleMeta } = await loadNuxtModuleInstance(modulePath, nuxt);
+  const descriptor = nuxtModule;
+  const declared = typeof descriptor.getMeta === "function" ? await descriptor.getMeta() : descriptor.meta;
+  if (declared !== void 0 && (!declared || typeof declared !== "object" || Array.isArray(declared))) {
+    throw new Error(`[@owdproject/nuxt] ${modulePath}: module metadata must be an object.`);
   }
-  const key = meta?.configKey;
-  return typeof key === "string" && key.length > 0 ? key : void 0;
+  return { ...buildTimeModuleMeta, ...declared };
 }
-export async function readExtensionMeta(modulePath) {
-  const meta = (await loadModuleDescriptor(modulePath))?.meta ?? {};
-  return {
-    kind: meta.kind,
-    framework: meta.framework,
-    packageName: meta.packageName,
-    configKey: meta.configKey,
-    entry: meta.entry,
-    adapter: meta.adapter,
-    requires: meta.requires
-  };
+export async function readExtensionMeta(modulePath, nuxt) {
+  const meta = await loadModuleMeta(modulePath, nuxt);
+  return Object.fromEntries(EXTENSION_META_KEYS.map((key) => [key, meta[key]]));
 }
 export function assertDesktopExtensionMeta(meta, packageName = "unknown") {
   if (!meta.kind || !KIND_SEGMENTS.includes(meta.kind)) {
@@ -178,28 +177,45 @@ export function assertDesktopExtensionMeta(meta, packageName = "unknown") {
       `[@owdproject/nuxt] ${packageName}: extension meta.framework must be one of ${FRAMEWORK_SEGMENTS.join(", ")}.`
     );
   }
-  return meta;
+  for (const key of ["packageName", "configKey", "entry", "adapter"]) {
+    if (meta[key] !== void 0 && (typeof meta[key] !== "string" || !meta[key].trim())) {
+      throw new Error(`[@owdproject/nuxt] ${packageName}: extension meta.${key} must be a non-empty string.`);
+    }
+  }
+  if (meta.requires !== void 0 && (!Array.isArray(meta.requires) || !meta.requires.every(
+    (requirement) => typeof requirement === "string" && requirement.trim().length > 0
+  ))) {
+    throw new Error(`[@owdproject/nuxt] ${packageName}: extension meta.requires must be an array of non-empty module/kit names.`);
+  }
+  return { ...meta };
 }
-async function loadModuleDescriptor(modulePath) {
-  try {
-    const resolvedPath = await resolvePath(modulePath);
-    const imported = await import(resolvedPath);
-    return imported.default ?? imported;
-  } catch (e) {
-    console.warn(`[@owdproject/nuxt] loadModuleDescriptor failed for "${modulePath}":`, e);
-    return void 0;
+function assertDesktopExtensionHost(meta, modulePath, nuxt) {
+  if (meta.framework !== "nuxt") {
+    throw new Error(`[@owdproject/nuxt] ${modulePath}: framework "${meta.framework}" is incompatible with the Nuxt host.`);
+  }
+  if (meta.adapter !== void 0 && meta.adapter !== "@owdproject/nuxt") {
+    throw new Error(`[@owdproject/nuxt] ${modulePath}: adapter "${meta.adapter}" is incompatible with @owdproject/nuxt.`);
+  }
+  for (const requirement of meta.requires ?? []) {
+    const installed = nuxt.options._installedModules?.some(({ meta: meta2, entryPath }) => {
+      if (meta2.disabled) return false;
+      return [meta2.name, meta2.packageName, meta2.rawPath, entryPath].includes(requirement);
+    });
+    if (!installed) {
+      throw new Error(`[@owdproject/nuxt] ${modulePath}: required kit/module "${requirement}" is not active. Install it through the theme or host before this extension.`);
+    }
   }
 }
 export async function installDesktopPackage(nuxt, modulePath, desktop) {
-  const descriptor = await loadModuleDescriptor(modulePath);
-  const configKey = await readConfigKey(descriptor);
-  if (configKey && desktop) {
-    const slice = desktop[configKey];
-    const inline = slice && typeof slice === "object" && !Array.isArray(slice) ? slice : {};
-    await installModule(modulePath, inline);
-    return;
+  const meta = await loadModuleMeta(modulePath, nuxt);
+  if (EXTENSION_META_KEYS.some((key) => key !== "configKey" && key in meta)) {
+    const extension = assertDesktopExtensionMeta(meta, modulePath);
+    assertDesktopExtensionHost(extension, modulePath, nuxt);
   }
-  await installModule(modulePath);
+  const configKey = typeof meta.configKey === "string" && meta.configKey.length > 0 ? meta.configKey : void 0;
+  const slice = configKey && desktop ? desktop[configKey] : void 0;
+  const inline = slice && typeof slice === "object" && !Array.isArray(slice) ? slice : void 0;
+  await installModule(modulePath, configKey && desktop ? inline ?? {} : void 0, nuxt);
 }
 export function defineDesktopModule(definition) {
   const configKey = definition.meta.configKey;

package/dist/module.d.mts

@@ -78,6 +78,12 @@ interface DesktopConfig {
     apps?: string[];
     modules?: string[];
     coreVersion?: string;
+    /**
+     * Stable identity of this desktop distribution (e.g. `'atproto-os'`).
+     * Namespaces the persisted profile (AT Protocol record rkeys and local
+     * IndexedDB keys) so two different OWD products never share state.
+     */
+    id?: string;
     /** Directories a desktop distribution collects extensions from (see {@link DesktopExtensionDirs}). */
     collect?: DesktopExtensionDirs;
     [key: string]: any;

package/dist/module.json

@@ -4,7 +4,7 @@
   "compatibility": {
     "nuxt": ">=3.0.0 || >=4.0.0"
   },
-  "version": "4.0.0-alpha.3",
+  "version": "4.0.0-alpha.4",
   "builder": {
     "@nuxt/module-builder": "1.0.3",
     "unbuild": "3.6.1"

package/dist/module.mjs

@@ -8,7 +8,7 @@ import { createDesktop, WindowManager, DesktopPointerSession, windowMachine, Ifr
 export * from '@owdproject/core';
 import { createActor } from 'xstate';
 
-const version = "4.0.0-alpha.3";
+const version = "4.0.0-alpha.4";
 const pkg = {
 	version: version};
 

package/dist/runtime/components/window/DesktopCoreWindow.vue

@@ -71,7 +71,42 @@ onMounted(() => {
   if (windowRef.value) {
     dragHandleRef.value = windowRef.value.querySelector(".desktop-window-nav__draggable");
   }
+  clampIntoWorkarea();
 });
+function clampIntoWorkarea() {
+  const area = desktopWorkspaceStore.workarea;
+  if (!area || area.width <= 0 || area.height <= 0) return;
+  const state = windowController?.state;
+  if (!state || state.maximized) return;
+  const size = state.size ?? {};
+  const rect = windowRef.value?.getBoundingClientRect();
+  const width2 = typeof size.width === "number" ? size.width : rect?.width;
+  const height2 = typeof size.height === "number" ? size.height : rect?.height;
+  if (!width2 || !height2 || !Number.isFinite(width2) || !Number.isFinite(height2)) return;
+  const nextWidth = Math.min(width2, area.width);
+  const nextHeight = Math.min(height2, area.height);
+  const pos = state.position ?? {};
+  const maxX = area.x + area.width - nextWidth;
+  const maxY = area.y + area.height - nextHeight;
+  const nextX = Math.min(Math.max(pos.x ?? area.x, area.x), maxX);
+  const nextY = Math.min(Math.max(pos.y ?? area.y, area.y), maxY);
+  if (nextWidth !== width2 || nextHeight !== height2) {
+    windowController.actions.setSize({ width: nextWidth, height: nextHeight });
+  }
+  if (nextX !== pos.x || nextY !== pos.y) {
+    windowController.actions.setPosition({ x: nextX, y: nextY });
+  }
+}
+watch(
+  () => [
+    desktopWorkspaceStore.workarea.x,
+    desktopWorkspaceStore.workarea.y,
+    desktopWorkspaceStore.workarea.width,
+    desktopWorkspaceStore.workarea.height
+  ],
+  () => clampIntoWorkarea(),
+  { immediate: true }
+);
 const { x, y } = useDraggable(windowRef, {
   handle: dragHandleRef,
   initialValue: {

package/dist/runtime/composables/useDesktop.d.ts

@@ -102,7 +102,7 @@ export declare function useDesktop(): {
         addWorkspace: (id?: string) => string;
         removeWorkspace: (workspaceId: string) => boolean;
         resolveWorkspaceFallback: (removedId: string) => string | null;
-    }, "active" | "list" | "overview" | "workarea">, Pick<{
+    }, "list" | "active" | "overview" | "workarea">, Pick<{
         list: import("vue").Ref<string[], string[]>;
         active: import("vue").Ref<string, string>;
         overview: import("vue").Ref<boolean, boolean>;

package/dist/runtime/internal/controllers/ApplicationController.d.ts

@@ -4,7 +4,7 @@ import { useApplicationWindowsStore } from '../../stores/storeApplicationWindows
 export declare class ApplicationController implements IApplicationController {
     readonly id: string;
     readonly config: ApplicationConfig;
-    readonly windows: Map<string, IWindowController>;
+    readonly windows: import("vue").ShallowReactive<Map<string, IWindowController>>;
     readonly openWindowCount: import("vue").ShallowRef<number, number>;
     storeWindows: ReturnType<typeof useApplicationWindowsStore> | undefined;
     storeMeta: any;
@@ -25,6 +25,13 @@ export declare class ApplicationController implements IApplicationController {
     get isInitializing(): boolean;
     get isReady(): boolean;
     initApplication(): Promise<void>;
+    /**
+     * Reopen the windows persisted in this application's window store. Returns
+     * `true` when at least one window was restored. No-op without a persistence
+     * adapter (the window store is then always empty at boot).
+     */
+    restoreApplication(): Promise<boolean>;
+    private restoreWindows;
     focusWindow(targetWin: IWindowController): void;
     openWindow(model: string, storedState?: WindowStoredState, meta?: Record<string, any>): IWindowController | undefined;
     closeWindow(windowId: string): void;

package/dist/runtime/internal/controllers/ApplicationController.js

@@ -1,4 +1,4 @@
-import { markRaw, reactive, shallowRef } from "vue";
+import { markRaw, reactive, shallowRef, shallowReactive } from "vue";
 import { createActor } from "xstate";
 import { nanoid } from "nanoid";
 import {
@@ -30,7 +30,7 @@ function formatAppSnapshotValue(value) {
 export class ApplicationController {
   id;
   config;
-  windows = /* @__PURE__ */ new Map();
+  windows = shallowReactive(/* @__PURE__ */ new Map());
   openWindowCount = shallowRef(0);
   storeWindows;
   storeMeta;
@@ -156,6 +156,15 @@ export class ApplicationController {
           this.config.provides.entry
         );
       }
+      const storeWindows = this.storeWindows;
+      if (storeWindows?.$persistedState) {
+        await storeWindows.$persistedState.isReady();
+      }
+      const storeMeta = this.storeMeta;
+      if (storeMeta?.$persistedState) {
+        await storeMeta.$persistedState.isReady();
+      }
+      await this.restoreApplication();
       this.appActor.send({ type: "INITIALIZED" });
       await this.config.onReady?.(this);
     } catch (err) {
@@ -163,6 +172,33 @@ export class ApplicationController {
       console.error(`[@owdproject/nuxt] Failed to init app "${this.id}":`, err);
     }
   }
+  /**
+   * Reopen the windows persisted in this application's window store. Returns
+   * `true` when at least one window was restored. No-op without a persistence
+   * adapter (the window store is then always empty at boot).
+   */
+  async restoreApplication() {
+    if (typeof this.config.onRestore === "function") {
+      await this.config.onRestore(this);
+    }
+    const windows = this.storeWindows?.windows;
+    if (!windows || Object.keys(windows).length === 0) {
+      return false;
+    }
+    this.restoreWindows();
+    return true;
+  }
+  restoreWindows() {
+    const windows = this.storeWindows?.windows;
+    if (!windows) return;
+    for (const windowId of Object.keys(windows)) {
+      if (this.windows.has(windowId)) continue;
+      const storedState = windows[windowId];
+      if (storedState?.model) {
+        this.openWindow(storedState.model, storedState);
+      }
+    }
+  }
   focusWindow(targetWin) {
     const desktopStore = useDesktopStore();
     let previousFocused;

package/dist/runtime/stores/storeApplicationMeta.js

@@ -7,13 +7,23 @@ export function applicationMetaStoreId(appId) {
 export function useApplicationMetaStore(appId, customSetup) {
   let storeFactory = metaStoreRegistry.get(appId);
   if (!storeFactory) {
-    storeFactory = defineStore(applicationMetaStoreId(appId), () => {
-      if (customSetup) {
-        return customSetup();
+    storeFactory = defineStore(
+      applicationMetaStoreId(appId),
+      () => {
+        if (customSetup) {
+          return customSetup();
+        }
+        const data = reactive({});
+        return { data };
+      },
+      {
+        // Inert unless an optional persistence module registers the adapter.
+        // @ts-expect-error pinia-plugin-persistedstate-2 store option
+        persistedState: {
+          persist: true
+        }
       }
-      const data = reactive({});
-      return { data };
-    });
+    );
     metaStoreRegistry.set(appId, storeFactory);
   }
   return storeFactory;

package/dist/runtime/stores/storeApplicationWindows.js

@@ -7,26 +7,36 @@ export function applicationWindowsStoreId(appId) {
 export function useApplicationWindowsStore(appId) {
   let storeFactory = windowsStoreRegistry.get(appId);
   if (!storeFactory) {
-    storeFactory = defineStore(applicationWindowsStoreId(appId), () => {
-      const windows = reactive({});
-      function setWindowState(windowId, stored) {
-        windows[windowId] = stored;
-      }
-      function removeWindowState(windowId) {
-        delete windows[windowId];
-      }
-      function clearWindows() {
-        for (const key of Object.keys(windows)) {
-          delete windows[key];
+    storeFactory = defineStore(
+      applicationWindowsStoreId(appId),
+      () => {
+        const windows = reactive({});
+        function setWindowState(windowId, stored) {
+          windows[windowId] = stored;
+        }
+        function removeWindowState(windowId) {
+          delete windows[windowId];
+        }
+        function clearWindows() {
+          for (const key of Object.keys(windows)) {
+            delete windows[key];
+          }
+        }
+        return {
+          windows,
+          setWindowState,
+          removeWindowState,
+          clearWindows
+        };
+      },
+      {
+        // Inert unless an optional persistence module registers the adapter.
+        // @ts-expect-error pinia-plugin-persistedstate-2 store option
+        persistedState: {
+          persist: true
         }
       }
-      return {
-        windows,
-        setWindowState,
-        removeWindowState,
-        clearWindows
-      };
-    });
+    );
     windowsStoreRegistry.set(appId, storeFactory);
   }
   return storeFactory();

package/dist/runtime/stores/storeDesktop.js

@@ -1,16 +1,29 @@
 import { reactive } from "vue";
 import { defineStore } from "pinia";
-export const useDesktopStore = defineStore("desktop", () => {
-  const state = reactive({
-    defaultApps: {},
-    positionZ: 100
-  });
-  function incrementPositionZ() {
-    state.positionZ += 1;
-    return state.positionZ;
+export const useDesktopStore = defineStore(
+  "desktop",
+  () => {
+    const state = reactive({
+      defaultApps: {},
+      positionZ: 100
+    });
+    function incrementPositionZ() {
+      state.positionZ += 1;
+      return state.positionZ;
+    }
+    return {
+      state,
+      incrementPositionZ
+    };
+  },
+  {
+    // Inert unless an optional persistence module (@owdproject/nuxt-module-pinia-persistence
+    // or @owdproject/nuxt-module-atproto-persistence) registers the adapter.
+    // @ts-expect-error pinia-plugin-persistedstate-2 store option
+    persistedState: {
+      persist: true,
+      // `defaultApps` is rebuilt from config on boot; persist only the z-index seed.
+      includePaths: ["state.positionZ"]
+    }
   }
-  return {
-    state,
-    incrementPositionZ
-  };
-});
+);

package/dist/runtime/stores/storeDesktopWorkspace.js

@@ -8,84 +8,96 @@ export const EMPTY_DESKTOP_WORKAREA = {
   width: 0,
   height: 0
 };
-export const useDesktopWorkspaceStore = defineStore("desktop/workspace", () => {
-  const list = ref([
-    "workspace-1",
-    "workspace-2",
-    "workspace-3",
-    "workspace-4"
-  ]);
-  const active = ref("workspace-1");
-  const overview = ref(false);
-  const workarea = ref({ ...EMPTY_DESKTOP_WORKAREA });
-  const workspaceActiveIndex = computed(
-    () => list.value.indexOf(active.value)
-  );
-  function setWorkspace(workspaceId) {
-    if (!list.value.includes(workspaceId)) return false;
-    const previous = active.value;
-    if (previous === workspaceId) return true;
-    const { callHook } = useDesktopHooks();
-    const switchCtx = {
-      from: previous,
-      to: workspaceId,
-      cancel: false
-    };
-    void callHook("workspace:before-switch", switchCtx);
-    if (switchCtx.cancel) return false;
-    active.value = switchCtx.to;
-    void callHook("workspace:switched", { from: previous, to: switchCtx.to });
-    useDesktopIPC().emit(
-      "workspace:switched",
-      { from: previous, to: switchCtx.to },
-      { source: "workspace-store", severity: "info" }
+export const useDesktopWorkspaceStore = defineStore(
+  "desktop/workspace",
+  () => {
+    const list = ref([
+      "workspace-1",
+      "workspace-2",
+      "workspace-3",
+      "workspace-4"
+    ]);
+    const active = ref("workspace-1");
+    const overview = ref(false);
+    const workarea = ref({ ...EMPTY_DESKTOP_WORKAREA });
+    const workspaceActiveIndex = computed(
+      () => list.value.indexOf(active.value)
     );
-    return true;
-  }
-  function setOverview(value) {
-    overview.value = value;
-  }
-  function toggleOverview() {
-    overview.value = !overview.value;
-  }
-  function setWorkarea(rect) {
-    workarea.value = { ...rect };
-  }
-  function addWorkspace(id) {
-    const nextId = id || `workspace-${list.value.length + 1}`;
-    if (!list.value.includes(nextId)) {
-      list.value.push(nextId);
+    function setWorkspace(workspaceId) {
+      if (!list.value.includes(workspaceId)) return false;
+      const previous = active.value;
+      if (previous === workspaceId) return true;
+      const { callHook } = useDesktopHooks();
+      const switchCtx = {
+        from: previous,
+        to: workspaceId,
+        cancel: false
+      };
+      void callHook("workspace:before-switch", switchCtx);
+      if (switchCtx.cancel) return false;
+      active.value = switchCtx.to;
+      void callHook("workspace:switched", { from: previous, to: switchCtx.to });
+      useDesktopIPC().emit(
+        "workspace:switched",
+        { from: previous, to: switchCtx.to },
+        { source: "workspace-store", severity: "info" }
+      );
+      return true;
     }
-    return nextId;
-  }
-  function resolveWorkspaceFallback(removedId) {
-    const remaining = list.value.filter((id) => id !== removedId);
-    if (remaining.length === 0) return null;
-    return remaining[remaining.length - 1] ?? remaining[0] ?? null;
-  }
-  function removeWorkspace(workspaceId) {
-    if (list.value.length <= 1) return false;
-    const idx = list.value.indexOf(workspaceId);
-    if (idx < 0) return false;
-    const fallback = resolveWorkspaceFallback(workspaceId);
-    list.value.splice(idx, 1);
-    if (active.value === workspaceId && fallback) {
-      active.value = fallback;
+    function setOverview(value) {
+      overview.value = value;
+    }
+    function toggleOverview() {
+      overview.value = !overview.value;
+    }
+    function setWorkarea(rect) {
+      workarea.value = { ...rect };
+    }
+    function addWorkspace(id) {
+      const nextId = id || `workspace-${list.value.length + 1}`;
+      if (!list.value.includes(nextId)) {
+        list.value.push(nextId);
+      }
+      return nextId;
+    }
+    function resolveWorkspaceFallback(removedId) {
+      const remaining = list.value.filter((id) => id !== removedId);
+      if (remaining.length === 0) return null;
+      return remaining[remaining.length - 1] ?? remaining[0] ?? null;
+    }
+    function removeWorkspace(workspaceId) {
+      if (list.value.length <= 1) return false;
+      const idx = list.value.indexOf(workspaceId);
+      if (idx < 0) return false;
+      const fallback = resolveWorkspaceFallback(workspaceId);
+      list.value.splice(idx, 1);
+      if (active.value === workspaceId && fallback) {
+        active.value = fallback;
+      }
+      return true;
+    }
+    return {
+      list,
+      active,
+      overview,
+      workarea,
+      workspaceActiveIndex,
+      setWorkspace,
+      setOverview,
+      toggleOverview,
+      setWorkarea,
+      addWorkspace,
+      removeWorkspace,
+      resolveWorkspaceFallback
+    };
+  },
+  {
+    // Inert unless an optional persistence module registers the adapter.
+    // @ts-expect-error pinia-plugin-persistedstate-2 store option
+    persistedState: {
+      persist: true,
+      // `overview` and `workarea` are runtime-only.
+      includePaths: ["list", "active"]
     }
-    return true;
   }
-  return {
-    list,
-    active,
-    overview,
-    workarea,
-    workspaceActiveIndex,
-    setWorkspace,
-    setOverview,
-    toggleOverview,
-    setWorkarea,
-    addWorkspace,
-    removeWorkspace,
-    resolveWorkspaceFallback
-  };
-});
+);

package/dist/runtime/stores/storeNotification.js

@@ -50,6 +50,13 @@ export const useDesktopNotificationStore = defineStore(
       markAsRead,
       markAllAsRead
     };
+  },
+  {
+    // Inert unless an optional persistence module registers the adapter.
+    // @ts-expect-error pinia-plugin-persistedstate-2 store option
+    persistedState: {
+      persist: true
+    }
   }
 );
 export const useNotificationStore = useDesktopNotificationStore;

package/dist/types/index.d.ts

@@ -76,6 +76,12 @@ export interface DesktopConfig {
     apps?: string[];
     modules?: string[];
     coreVersion?: string;
+    /**
+     * Stable identity of this desktop distribution (e.g. `'atproto-os'`).
+     * Namespaces the persisted profile (AT Protocol record rkeys and local
+     * IndexedDB keys) so two different OWD products never share state.
+     */
+    id?: string;
     /** Directories a desktop distribution collects extensions from (see {@link DesktopExtensionDirs}). */
     collect?: DesktopExtensionDirs;
     [key: string]: any;
@@ -115,7 +121,7 @@ export interface DesktopExtensionMeta {
     entry?: string;
     /** Framework adapter required at runtime, e.g. `@owdproject/nuxt`. */
     adapter?: string;
-    /** Kits/modules the extension expects the active theme or desktop to provide. */
+    /** Exact identities of kits/modules already installed by the active Nuxt host; no version ranges. */
     requires?: string[];
 }
 export interface IWindowController extends IDesktopWindowController {
@@ -138,6 +144,8 @@ export interface IApplicationController {
     readonly isInitializing: boolean;
     readonly isReady: boolean;
     initApplication(): Promise<void>;
+    /** Restore saved windows without duplicating already-open controllers. */
+    restoreApplication(): Promise<boolean>;
     openWindow(model: string, storedState?: import('@owdproject/core').WindowStoredState, meta?: Record<string, any>): IWindowController | undefined;
     getFirstWindowByModel(model: string): IWindowController | undefined;
     closeWindow(windowId: string): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owdproject/nuxt",
-  "version": "4.0.0-alpha.3",
+  "version": "4.0.0-alpha.4",
   "description": "Official Nuxt & Vue desktop engine for OpenWebDesktop",
   "homepage": "https://github.com/owdproject/nuxt#readme",
   "repository": {
@@ -112,7 +112,8 @@
   },
   "scripts": {
     "build": "nuxt-module-build build && node ./scripts/post-build-pkg-nuxt.mjs",
-    "prepack": "nuxt-module-build build && node ./scripts/post-build-pkg-nuxt.mjs"
+    "prepack": "nuxt-module-build build && node ./scripts/post-build-pkg-nuxt.mjs",
+    "test:persistence": "vitest run test/config.test.ts test/persistence-windows.test.ts"
   },
   "dependencies": {
     "@nuxt/fonts": "^1.2.0",
@@ -143,5 +144,10 @@
     "nuxt": {
       "optional": true
     }
+  },
+  "devDependencies": {
+    "vitest": "^4.1.12",
+    "pinia-plugin-persistedstate-2": "^2.0.30",
+    "vue": "^3.5.44"
   }
 }