@vibesdotdev/vessel 0.0.0-stage → 1.0.0-rc.2

package/dist/shell/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/shell/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/shell/types.ts"],"names":[],"mappings":""}

package/dist/shell/window-manager.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Pure Vessel desktop window manager.
+ *
+ * Framework-neutral open/close/focus/z-order/minimize/maximize/move/resize for hosts.
+ * Geometry defaults come from vessel/app descriptors; this module never imports Svelte.
+ */
+import { type VesselAppDescriptor, type VesselRouteState, type VesselRuntimePlaceId } from '../schemas.ts';
+export interface VesselWindowRect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export interface VesselWindowState {
+    instanceId: string;
+    appId: string;
+    title: string;
+    /** Exact runtime place pinned when this window was created. */
+    runtimePlaceId?: VesselRuntimePlaceId;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    minWidth: number;
+    minHeight: number;
+    zIndex: number;
+    focused: boolean;
+    minimized: boolean;
+    /** Maximization is live shell presentation; restoreRect preserves the floating geometry. */
+    maximized?: boolean;
+    restoreRect?: VesselWindowRect;
+    routeParams: VesselRouteState;
+}
+export interface VesselWindowManagerState {
+    windows: readonly VesselWindowState[];
+    focusedInstanceId: string | null;
+    nextZIndex: number;
+    nextInstanceSeq: number;
+}
+export interface OpenWindowOptions {
+    /** Force a new instance even if the app already has a window. Default false → focus existing. */
+    forceNew?: boolean;
+    /**
+     * Explicit host-resolved runtime place for this new window. When supplied,
+     * only an existing window pinned to the same place is eligible for reuse.
+     */
+    runtimePlaceId?: VesselRuntimePlaceId;
+    rect?: Partial<VesselWindowRect>;
+    /** Reference-only owner navigation state for this surface instance. */
+    routeParams?: VesselRouteState;
+    /** Replace existing route params instead of merging when re-opening an app. */
+    replaceRouteParams?: boolean;
+}
+export declare function createWindowManagerState(): VesselWindowManagerState;
+export declare function openWindow(state: VesselWindowManagerState, app: VesselAppDescriptor, options?: OpenWindowOptions): VesselWindowManagerState;
+export declare function updateWindowRouteParams(state: VesselWindowManagerState, instanceId: string, routeParams: VesselRouteState, options?: {
+    replace?: boolean;
+}): VesselWindowManagerState;
+export declare function closeWindow(state: VesselWindowManagerState, instanceId: string): VesselWindowManagerState;
+export declare function focusWindow(state: VesselWindowManagerState, instanceId: string): VesselWindowManagerState;
+export declare function minimizeWindow(state: VesselWindowManagerState, instanceId: string): VesselWindowManagerState;
+/**
+ * Fill the available shell canvas while retaining the exact floating rectangle.
+ * Calling this again updates the canvas bounds without replacing the restore point.
+ */
+export declare function maximizeWindow(state: VesselWindowManagerState, instanceId: string, bounds: {
+    width: number;
+    height: number;
+}): VesselWindowManagerState;
+/** Restore a maximized window to the floating rectangle captured at maximize time. */
+export declare function restoreWindow(state: VesselWindowManagerState, instanceId: string): VesselWindowManagerState;
+export declare function moveWindow(state: VesselWindowManagerState, instanceId: string, x: number, y: number): VesselWindowManagerState;
+export declare function resizeWindow(state: VesselWindowManagerState, instanceId: string, width: number, height: number): VesselWindowManagerState;
+export declare function orderedWindows(state: VesselWindowManagerState, options?: {
+    includeMinimized?: boolean;
+}): VesselWindowState[];
+export declare function findWindowsForApp(state: VesselWindowManagerState, appId: string): VesselWindowState[];
+export declare function clampWindowToBounds(win: VesselWindowState, bounds: {
+    width: number;
+    height: number;
+}): VesselWindowState;
+//# sourceMappingURL=window-manager.d.ts.map

package/dist/shell/window-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"window-manager.d.ts","sourceRoot":"","sources":["../../src/shell/window-manager.ts"],"names":[],"mappings":"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"}

package/dist/shell/window-manager.js

@@ -0,0 +1,285 @@
+/**
+ * Pure Vessel desktop window manager.
+ *
+ * Framework-neutral open/close/focus/z-order/minimize/maximize/move/resize for hosts.
+ * Geometry defaults come from vessel/app descriptors; this module never imports Svelte.
+ */
+import { vesselRuntimePlaceIdSchema } from "../schemas.js";
+import { cascadeOrigin, VESSEL_DEFAULT_GRID } from "./layout-grid.js";
+function clamp(n, min, max) {
+    return Math.min(max, Math.max(min, n));
+}
+export function createWindowManagerState() {
+    return {
+        windows: [],
+        focusedInstanceId: null,
+        nextZIndex: 1,
+        nextInstanceSeq: 1
+    };
+}
+function withFocus(windows, instanceId) {
+    return windows.map((win) => ({
+        ...win,
+        focused: instanceId !== null && win.instanceId === instanceId,
+        minimized: instanceId !== null && win.instanceId === instanceId ? false : win.minimized
+    }));
+}
+export function openWindow(state, app, options = {}) {
+    const runtimePlaceId = options.runtimePlaceId === undefined
+        ? undefined
+        : vesselRuntimePlaceIdSchema.parse(options.runtimePlaceId);
+    if (!options.forceNew) {
+        const existing = [...state.windows]
+            .filter((win) => win.appId === app.id &&
+            !win.minimized &&
+            (runtimePlaceId === undefined || win.runtimePlaceId === runtimePlaceId))
+            .sort((a, b) => Number(b.focused) - Number(a.focused) || b.zIndex - a.zIndex)[0];
+        if (existing) {
+            const next = options.routeParams
+                ? updateWindowRouteParams(state, existing.instanceId, options.routeParams, {
+                    replace: options.replaceRouteParams
+                })
+                : state;
+            return focusWindow(next, existing.instanceId);
+        }
+        const minimized = [...state.windows]
+            .filter((win) => win.appId === app.id &&
+            win.minimized &&
+            (runtimePlaceId === undefined || win.runtimePlaceId === runtimePlaceId))
+            .sort((a, b) => b.zIndex - a.zIndex)[0];
+        if (minimized) {
+            const next = options.routeParams
+                ? updateWindowRouteParams(state, minimized.instanceId, options.routeParams, {
+                    replace: options.replaceRouteParams
+                })
+                : state;
+            return focusWindow(next, minimized.instanceId);
+        }
+    }
+    const defaults = app.defaultWindow;
+    const width = Math.max(options.rect?.width ?? defaults.width, defaults.minWidth);
+    const height = Math.max(options.rect?.height ?? defaults.height, defaults.minHeight);
+    // Cascade from the topmost open window so stacks stay readable regardless of
+    // per-app defaultWindow bases. Explicit rect.x / rect.y still win.
+    const open = state.windows.filter((w) => !w.minimized);
+    let x;
+    let y;
+    if (options.rect?.x != null && options.rect?.y != null) {
+        x = options.rect.x;
+        y = options.rect.y;
+    }
+    else if (open.length === 0) {
+        x = defaults.x;
+        y = defaults.y;
+    }
+    else {
+        const top = open.reduce((a, b) => (a.zIndex >= b.zIndex ? a : b));
+        const cascaded = cascadeOrigin(1, { x: top.x, y: top.y }, VESSEL_DEFAULT_GRID.cascadeStep);
+        x = cascaded.x;
+        y = cascaded.y;
+    }
+    const instanceId = `${app.id}#${state.nextInstanceSeq}`;
+    const zIndex = state.nextZIndex;
+    // Seed from the app's own surface state; explicit route params still win.
+    const initialState = app.launch.type === 'vessel-surface' ? app.launch.initialState : undefined;
+    const next = {
+        instanceId,
+        appId: app.id,
+        title: app.name,
+        runtimePlaceId,
+        x,
+        y,
+        width,
+        height,
+        minWidth: defaults.minWidth,
+        minHeight: defaults.minHeight,
+        zIndex,
+        focused: true,
+        minimized: false,
+        maximized: false,
+        routeParams: { ...initialState, ...options.routeParams }
+    };
+    const windows = withFocus([...state.windows, next], instanceId);
+    return {
+        windows,
+        focusedInstanceId: instanceId,
+        nextZIndex: zIndex + 1,
+        nextInstanceSeq: state.nextInstanceSeq + 1
+    };
+}
+export function updateWindowRouteParams(state, instanceId, routeParams, options = {}) {
+    const target = state.windows.find((win) => win.instanceId === instanceId);
+    if (!target)
+        return state;
+    return {
+        ...state,
+        windows: state.windows.map((win) => win.instanceId === instanceId
+            ? {
+                ...win,
+                routeParams: options.replace
+                    ? { ...routeParams }
+                    : { ...win.routeParams, ...routeParams }
+            }
+            : win)
+    };
+}
+export function closeWindow(state, instanceId) {
+    const remaining = state.windows.filter((win) => win.instanceId !== instanceId);
+    if (remaining.length === state.windows.length)
+        return state;
+    const wasFocused = state.focusedInstanceId === instanceId;
+    if (!wasFocused) {
+        return { ...state, windows: remaining };
+    }
+    const top = [...remaining].sort((a, b) => b.zIndex - a.zIndex)[0] ?? null;
+    const focusedInstanceId = top?.instanceId ?? null;
+    return {
+        ...state,
+        windows: withFocus(remaining, focusedInstanceId),
+        focusedInstanceId
+    };
+}
+export function focusWindow(state, instanceId) {
+    const target = state.windows.find((win) => win.instanceId === instanceId);
+    if (!target)
+        return state;
+    const zIndex = state.nextZIndex;
+    const windows = state.windows.map((win) => {
+        if (win.instanceId !== instanceId) {
+            return { ...win, focused: false };
+        }
+        return {
+            ...win,
+            focused: true,
+            minimized: false,
+            zIndex
+        };
+    });
+    return {
+        ...state,
+        windows,
+        focusedInstanceId: instanceId,
+        nextZIndex: zIndex + 1
+    };
+}
+export function minimizeWindow(state, instanceId) {
+    const target = state.windows.find((win) => win.instanceId === instanceId);
+    if (!target || target.minimized)
+        return state;
+    const windows = state.windows.map((win) => win.instanceId === instanceId ? { ...win, minimized: true, focused: false } : win);
+    const wasFocused = state.focusedInstanceId === instanceId;
+    if (!wasFocused) {
+        return { ...state, windows };
+    }
+    const top = [...windows].filter((win) => !win.minimized).sort((a, b) => b.zIndex - a.zIndex)[0] ?? null;
+    return {
+        ...state,
+        windows: withFocus(windows, top?.instanceId ?? null),
+        focusedInstanceId: top?.instanceId ?? null
+    };
+}
+/**
+ * Fill the available shell canvas while retaining the exact floating rectangle.
+ * Calling this again updates the canvas bounds without replacing the restore point.
+ */
+export function maximizeWindow(state, instanceId, bounds) {
+    const width = Math.round(bounds.width);
+    const height = Math.round(bounds.height);
+    if (width < 1 || height < 1)
+        return state;
+    const target = state.windows.find((win) => win.instanceId === instanceId);
+    if (!target)
+        return state;
+    if (target.maximized &&
+        target.x === 0 &&
+        target.y === 0 &&
+        target.width === width &&
+        target.height === height) {
+        return state;
+    }
+    return {
+        ...state,
+        windows: state.windows.map((win) => {
+            if (win.instanceId !== instanceId)
+                return win;
+            return {
+                ...win,
+                x: 0,
+                y: 0,
+                width,
+                height,
+                maximized: true,
+                restoreRect: win.maximized
+                    ? win.restoreRect
+                    : { x: win.x, y: win.y, width: win.width, height: win.height }
+            };
+        })
+    };
+}
+/** Restore a maximized window to the floating rectangle captured at maximize time. */
+export function restoreWindow(state, instanceId) {
+    const target = state.windows.find((win) => win.instanceId === instanceId);
+    if (!target?.maximized || !target.restoreRect)
+        return state;
+    const restoreRect = target.restoreRect;
+    return {
+        ...state,
+        windows: state.windows.map((win) => win.instanceId === instanceId
+            ? { ...win, ...restoreRect, maximized: false, restoreRect: undefined }
+            : win)
+    };
+}
+export function moveWindow(state, instanceId, x, y) {
+    const target = state.windows.find((win) => win.instanceId === instanceId);
+    if (!target || target.maximized)
+        return state;
+    return {
+        ...state,
+        windows: state.windows.map((win) => win.instanceId === instanceId
+            ? { ...win, x: Math.max(0, Math.round(x)), y: Math.max(0, Math.round(y)) }
+            : win)
+    };
+}
+export function resizeWindow(state, instanceId, width, height) {
+    const target = state.windows.find((win) => win.instanceId === instanceId);
+    if (!target || target.maximized)
+        return state;
+    return {
+        ...state,
+        windows: state.windows.map((win) => {
+            if (win.instanceId !== instanceId)
+                return win;
+            return {
+                ...win,
+                width: Math.max(win.minWidth, Math.round(width)),
+                height: Math.max(win.minHeight, Math.round(height))
+            };
+        })
+    };
+}
+export function orderedWindows(state, options = {}) {
+    const list = options.includeMinimized
+        ? state.windows
+        : state.windows.filter((win) => !win.minimized);
+    return [...list].sort((a, b) => a.zIndex - b.zIndex);
+}
+export function findWindowsForApp(state, appId) {
+    return state.windows.filter((win) => win.appId === appId);
+}
+export function clampWindowToBounds(win, bounds) {
+    if (win.maximized) {
+        return {
+            ...win,
+            x: 0,
+            y: 0,
+            width: Math.max(1, Math.round(bounds.width)),
+            height: Math.max(1, Math.round(bounds.height))
+        };
+    }
+    const width = clamp(win.width, win.minWidth, Math.max(win.minWidth, bounds.width));
+    const height = clamp(win.height, win.minHeight, Math.max(win.minHeight, bounds.height));
+    const x = clamp(win.x, 0, Math.max(0, bounds.width - 80));
+    const y = clamp(win.y, 0, Math.max(0, bounds.height - 48));
+    return { ...win, x, y, width, height };
+}
+//# sourceMappingURL=window-manager.js.map

package/dist/shell/window-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"window-manager.js","sourceRoot":"","sources":["../../src/shell/window-manager.ts"],"names":[],"mappings":"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"}

package/dist/shell/workspace-memory.d.ts

@@ -0,0 +1,42 @@
+/** Current health of the device-local workspace-memory projection. */
+export type VesselWorkspaceMemoryStatus = 'checking' | 'empty' | 'saving' | 'saved' | 'error';
+export interface VesselWorkspaceMemoryState {
+    status: VesselWorkspaceMemoryStatus;
+    /** Last confirmed persisted revision time, retained even if a later write fails. */
+    lastSavedAt: string | null;
+    /** Current write/load failure; never converts stale success into green status. */
+    error: string | null;
+    /** Latest in-flight write token. Zero means no write is pending. */
+    activeRequestId: number;
+}
+export type VesselWorkspaceMemoryEvent = {
+    type: 'load-started';
+} | {
+    type: 'loaded';
+    savedAt: string | null;
+} | {
+    type: 'load-failed';
+    error: string;
+} | {
+    type: 'save-started';
+    requestId: number;
+} | {
+    type: 'save-succeeded';
+    requestId: number;
+    savedAt: string;
+} | {
+    type: 'save-failed';
+    requestId: number;
+    error: string;
+} | {
+    type: 'cleared';
+    requestId: number;
+};
+export declare function createVesselWorkspaceMemoryState(): VesselWorkspaceMemoryState;
+/**
+ * Pure state machine for workspace-memory health. Return history and current
+ * persistence health are deliberately separate facts; stale writes are ignored.
+ */
+export declare function reduceVesselWorkspaceMemory(state: VesselWorkspaceMemoryState, event: VesselWorkspaceMemoryEvent): VesselWorkspaceMemoryState;
+export declare function vesselWorkspaceMemoryStatusLabel(status: VesselWorkspaceMemoryStatus): string;
+//# sourceMappingURL=workspace-memory.d.ts.map

package/dist/shell/workspace-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-memory.d.ts","sourceRoot":"","sources":["../../src/shell/workspace-memory.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,MAAM,MAAM,2BAA2B,GAAG,UAAU,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAC;AAE9F,MAAM,WAAW,0BAA0B;IAC1C,MAAM,EAAE,2BAA2B,CAAC;IACpC,oFAAoF;IACpF,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,kFAAkF;IAClF,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,oEAAoE;IACpE,eAAe,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,0BAA0B,GACnC;IAAE,IAAI,EAAE,cAAc,CAAA;CAAE,GACxB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC9D;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACzD;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1C,wBAAgB,gCAAgC,IAAI,0BAA0B,CAO7E;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAC1C,KAAK,EAAE,0BAA0B,EACjC,KAAK,EAAE,0BAA0B,GAC/B,0BAA0B,CAoC5B;AAED,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,2BAA2B,GAAG,MAAM,CAM5F"}

package/dist/shell/workspace-memory.js

@@ -0,0 +1,65 @@
+export function createVesselWorkspaceMemoryState() {
+    return {
+        status: 'checking',
+        lastSavedAt: null,
+        error: null,
+        activeRequestId: 0
+    };
+}
+/**
+ * Pure state machine for workspace-memory health. Return history and current
+ * persistence health are deliberately separate facts; stale writes are ignored.
+ */
+export function reduceVesselWorkspaceMemory(state, event) {
+    if (event.type === 'load-started') {
+        return state.status === 'saving'
+            ? state
+            : { ...state, status: 'checking', error: null, activeRequestId: 0 };
+    }
+    if (event.type === 'loaded') {
+        if (state.status === 'saving')
+            return state;
+        return {
+            status: event.savedAt ? 'saved' : 'empty',
+            lastSavedAt: event.savedAt,
+            error: null,
+            activeRequestId: 0
+        };
+    }
+    if (event.type === 'load-failed') {
+        if (state.status === 'saving')
+            return state;
+        return { ...state, status: 'error', error: event.error, activeRequestId: 0 };
+    }
+    if (event.type === 'save-started') {
+        if (event.requestId < state.activeRequestId)
+            return state;
+        return { ...state, status: 'saving', error: null, activeRequestId: event.requestId };
+    }
+    if (event.requestId !== state.activeRequestId)
+        return state;
+    if (event.type === 'save-succeeded') {
+        return {
+            status: 'saved',
+            lastSavedAt: event.savedAt,
+            error: null,
+            activeRequestId: 0
+        };
+    }
+    if (event.type === 'save-failed') {
+        return { ...state, status: 'error', error: event.error, activeRequestId: 0 };
+    }
+    return { status: 'empty', lastSavedAt: null, error: null, activeRequestId: 0 };
+}
+export function vesselWorkspaceMemoryStatusLabel(status) {
+    if (status === 'checking')
+        return 'Checking this device…';
+    if (status === 'empty')
+        return 'No saved workspace';
+    if (status === 'saving')
+        return 'Saving…';
+    if (status === 'error')
+        return 'Workspace memory needs attention';
+    return 'Saved on this device';
+}
+//# sourceMappingURL=workspace-memory.js.map

package/dist/shell/workspace-memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-memory.js","sourceRoot":"","sources":["../../src/shell/workspace-memory.ts"],"names":[],"mappings":"AAsBA,MAAM,UAAU,gCAAgC;IAC/C,OAAO;QACN,MAAM,EAAE,UAAU;QAClB,WAAW,EAAE,IAAI;QACjB,KAAK,EAAE,IAAI;QACX,eAAe,EAAE,CAAC;KAClB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CAC1C,KAAiC,EACjC,KAAiC;IAEjC,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;QACnC,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ;YAC/B,CAAC,CAAC,KAAK;YACP,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,EAAE,CAAC;IACtE,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC5C,OAAO;YACN,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO;YACzC,WAAW,EAAE,KAAK,CAAC,OAAO;YAC1B,KAAK,EAAE,IAAI;YACX,eAAe,EAAE,CAAC;SAClB,CAAC;IACH,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;QAClC,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC5C,OAAO,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,eAAe,EAAE,CAAC,EAAE,CAAC;IAC9E,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;QACnC,IAAI,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC,eAAe;YAAE,OAAO,KAAK,CAAC;QAC1D,OAAO,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC;IACtF,CAAC;IACD,IAAI,KAAK,CAAC,SAAS,KAAK,KAAK,CAAC,eAAe;QAAE,OAAO,KAAK,CAAC;IAC5D,IAAI,KAAK,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;QACrC,OAAO;YACN,MAAM,EAAE,OAAO;YACf,WAAW,EAAE,KAAK,CAAC,OAAO;YAC1B,KAAK,EAAE,IAAI;YACX,eAAe,EAAE,CAAC;SAClB,CAAC;IACH,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;QAClC,OAAO,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,eAAe,EAAE,CAAC,EAAE,CAAC;IAC9E,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,EAAE,CAAC;AAChF,CAAC;AAED,MAAM,UAAU,gCAAgC,CAAC,MAAmC;IACnF,IAAI,MAAM,KAAK,UAAU;QAAE,OAAO,uBAAuB,CAAC;IAC1D,IAAI,MAAM,KAAK,OAAO;QAAE,OAAO,oBAAoB,CAAC;IACpD,IAAI,MAAM,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAC1C,IAAI,MAAM,KAAK,OAAO;QAAE,OAAO,kCAAkC,CAAC;IAClE,OAAO,sBAAsB,CAAC;AAC/B,CAAC"}

package/dist/shell/workspace-state.d.ts

@@ -0,0 +1,47 @@
+import { type VesselAppDescriptor, type VesselWorkspaceAnchor, type VesselWorkspaceChronologicalCue, type VesselWorkspaceFocus, type VesselWorkspaceReceipt, type VesselWorkspaceState } from '../schemas.ts';
+import { type VesselWindowManagerState } from './window-manager.ts';
+export interface CaptureVesselWorkspaceStateInput {
+    workspaceId: string;
+    manager: VesselWindowManagerState;
+    apps: readonly VesselAppDescriptor[];
+    previous?: VesselWorkspaceState | null;
+    savedAt: string;
+    chronologicalCue?: VesselWorkspaceChronologicalCue;
+    /** New owner receipts to append to the bounded structural history. */
+    receipts?: readonly VesselWorkspaceReceipt[];
+    /**
+     * Previously stored anchors whose owner surface is unavailable in this
+     * runtime. Retaining them prevents a partial restore from erasing intent.
+     */
+    retainedUnavailableAnchors?: readonly RetainedUnavailableVesselWorkspaceAnchor[];
+    /** Preserve an unavailable focused anchor until the user chooses a new focus. */
+    retainedUnavailableFocus?: VesselWorkspaceFocus;
+}
+export interface RetainedUnavailableVesselWorkspaceAnchor {
+    anchor: VesselWorkspaceAnchor;
+    /** Position in the stored ordered anchor list. */
+    index: number;
+}
+export interface RestoreVesselWorkspaceStateResult {
+    manager: VesselWindowManagerState;
+    droppedSurfaceIds: string[];
+    /** Exact missing anchors, suitable for retention in the next capture. */
+    unavailableAnchors: RetainedUnavailableVesselWorkspaceAnchor[];
+    unavailableLastFocus?: VesselWorkspaceFocus;
+    restoredAnchorCount: number;
+}
+export interface RestoreVesselWorkspaceStateOptions {
+    /** Host/runtime preflight for this exact anchor and its route-selected providers. */
+    isAnchorAvailable?: (anchor: VesselWorkspaceAnchor, index: number) => boolean;
+}
+/**
+ * Capture only windows backed by stable `vessel/surface` identities. Import
+ * paths, package names, app ids, and runtime instance ids never enter storage.
+ */
+export declare function captureVesselWorkspaceState(input: CaptureVesselWorkspaceStateInput): VesselWorkspaceState;
+/**
+ * Restore against the app descriptors available now. Missing providers are
+ * reported and omitted; every surviving instance receives fresh ids and z-order.
+ */
+export declare function restoreVesselWorkspaceState(stored: VesselWorkspaceState, apps: readonly VesselAppDescriptor[], options?: RestoreVesselWorkspaceStateOptions): RestoreVesselWorkspaceStateResult;
+//# sourceMappingURL=workspace-state.d.ts.map

package/dist/shell/workspace-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-state.d.ts","sourceRoot":"","sources":["../../src/shell/workspace-state.ts"],"names":[],"mappings":"AACA,OAAO,EAKN,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,+BAA+B,EACpC,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,MAAM,eAAe,CAAC;AACvB,OAAO,EAMN,KAAK,wBAAwB,EAC7B,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,gCAAgC;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,wBAAwB,CAAC;IAClC,IAAI,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACrC,QAAQ,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,+BAA+B,CAAC;IACnD,sEAAsE;IACtE,QAAQ,CAAC,EAAE,SAAS,sBAAsB,EAAE,CAAC;IAC7C;;;OAGG;IACH,0BAA0B,CAAC,EAAE,SAAS,wCAAwC,EAAE,CAAC;IACjF,iFAAiF;IACjF,wBAAwB,CAAC,EAAE,oBAAoB,CAAC;CAChD;AAED,MAAM,WAAW,wCAAwC;IACxD,MAAM,EAAE,qBAAqB,CAAC;IAC9B,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,iCAAiC;IACjD,OAAO,EAAE,wBAAwB,CAAC;IAClC,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,yEAAyE;IACzE,kBAAkB,EAAE,wCAAwC,EAAE,CAAC;IAC/D,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAC5C,mBAAmB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,kCAAkC;IAClD,qFAAqF;IACrF,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;CAC9E;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAC1C,KAAK,EAAE,gCAAgC,GACrC,oBAAoB,CA0EtB;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAC1C,MAAM,EAAE,oBAAoB,EAC5B,IAAI,EAAE,SAAS,mBAAmB,EAAE,EACpC,OAAO,GAAE,kCAAuC,GAC9C,iCAAiC,CAgEnC"}