@astrale-os/shell-react 0.2.9 → 0.2.10-beta.3

package/dist/session/provider.js

@@ -1,38 +1,15 @@
 import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
 import { createShell } from '@astrale-os/shell';
-/**
- * ShellProvider — the composition root (API §2, SPEC §5): owns the shell boot
- * state machine (a config OR a prebuilt Shell; `createShell → init → whoami →
- * ready`), seats `ShellContext` and `GraphContext`, and registers its boot-retry
- * into the per-shell connection store. One live shell per mounted provider,
- * StrictMode/HMR-safe (deferred teardown), keyed on config identity. Children
- * render only at `ready`, so useShell/useSelf are synchronous below.
- */
-import { useCallback, useEffect, useMemo, useReducer, useRef, useState } from 'react';
+import { useCallback, useEffect, useReducer, useRef, useState } from 'react';
 import { primeUser } from '../application/user/user.store.js';
 import { GraphContext } from '../graph/graph.context.js';
-import { baseMemoryFor, setMemoryErrorSink } from '../graph/memory/base.js';
+import { resolveGraphStoreScope, retainStore, storeFor } from '../graph/store.js';
 import { configIdentity, isShellConfig, resolveSelf } from './boot/boot.js';
 import { cancelTeardown, disposeShell, scheduleTeardown } from './boot/ownership.js';
 import { bootReducer, INITIAL_BOOT } from './boot/status.js';
 import { connectionStore } from './connection/connection.store.js';
 import { ShellContext } from './session.context.js';
-/**
- * Map a memory event to the documented `ShellError` union (API §2). `refresh`
- * (warm-read revalidation failure) and `mutation` (rolled-back write) are the
- * two the channel promises; `divergence`/`invariant` are Tier-0/dev tripwires
- * outside the union and are not bridged here.
- */
-function toShellError(event) {
-    switch (event.kind) {
-        case 'refresh':
-            return { kind: 'refresh', shape: event.shape, error: event.error };
-        case 'mutation':
-            return { kind: 'mutation', mutationId: event.mutationId, error: event.error };
-        default:
-            return null;
-    }
-}
+/** Own and initialize exactly one Shell for a React subtree. */
 export function ShellProvider(props) {
     const { config, fallback, errorFallback, onError, children } = props;
     const [state, dispatch] = useReducer(bootReducer, INITIAL_BOOT);
@@ -47,13 +24,13 @@ export function ShellProvider(props) {
         const generation = (ref.generation += 1);
         dispatch({ type: 'connecting' });
         let shell;
-        const current = configRef.current;
         try {
+            const current = configRef.current;
             shell = isShellConfig(current) ? createShell(current) : current;
         }
-        catch (err) {
-            dispatch({ type: 'error', error: err });
-            onErrorRef.current?.({ kind: 'connection', error: err });
+        catch (error) {
+            dispatch({ type: 'error', error });
+            onErrorRef.current?.({ kind: 'connection', error });
             return;
         }
         ref.shell = shell;
@@ -65,35 +42,33 @@ export function ShellProvider(props) {
                 const self = await resolveSelf(shell);
                 if (generation !== ref.generation)
                     return;
-                // Pre-resolve the OS-plane user binding (API §2/§12.2) — NON-FATAL: a
-                // missing OS plane marks it unavailable without failing boot (whoami above
-                // stays the fatal gate). Seeds the user store so `useUser` is synchronous.
                 await primeUser(shell);
                 if (generation !== ref.generation)
                     return;
-                dispatch({ type: 'ready', runtime: { shell, self } });
+                const storeScope = await resolveGraphStoreScope(shell, self);
+                if (generation !== ref.generation)
+                    return;
+                const graph = storeFor(shell, storeScope);
+                dispatch({
+                    type: 'ready',
+                    runtime: { shell, self, storeScope, store: graph.store, ownsStore: graph.owned },
+                });
             }
-            catch (err) {
+            catch (error) {
                 if (generation !== ref.generation)
                     return;
-                dispatch({ type: 'error', error: err });
-                onErrorRef.current?.({ kind: 'connection', error: err });
+                dispatch({ type: 'error', error });
+                onErrorRef.current?.({ kind: 'connection', error });
             }
         })();
     }, []);
     useEffect(() => {
         const ref = bootRef.current;
-        // The shell this provider will run with once the effect settles: a prebuilt
-        // Shell is the config object itself; a config-built one is whatever this
-        // instance already booted (adopted on a StrictMode/HMR re-setup). Cancel any
-        // pending deferred teardown for it before deciding — this also cancels a
-        // teardown another provider scheduled for the SAME prebuilt Shell.
         const current = configRef.current;
         const adopting = isShellConfig(current) ? ref.shell : current;
         if (adopting !== null)
             cancelTeardown(adopting);
         if (ref.key !== configKey) {
-            // First boot, config change, or a retry that cleared the key: reboot fresh.
             if (ref.shell !== null) {
                 cancelTeardown(ref.shell);
                 disposeShell(ref.shell);
@@ -102,11 +77,7 @@ export function ShellProvider(props) {
             ref.shell = null;
             startBoot(ref);
         }
-        // Same key already booting/booted → adopt (StrictMode's second setup).
         return () => {
-            // Defer teardown one macrotask; a synchronous re-setup (StrictMode/HMR or a
-            // different provider adopting the same prebuilt Shell) cancels it first and
-            // keeps the same live shell.
             if (ref.shell !== null)
                 scheduleTeardown(ref.shell, ref);
             else
@@ -122,44 +93,27 @@ export function ShellProvider(props) {
         }
         ref.key = null;
         dispatch({ type: 'connecting' });
-        setAttempt((a) => a + 1);
+        setAttempt((value) => value + 1);
     }, []);
-    // The base (default-scope) memory for the booted Shell — the SAME instance
-    // the graph/schema/nav hooks read through `graph/memory/scope.ts`. Seated in
-    // `GraphContext` so selection's liveness has a source; null until ready.
     const shell = state.runtime?.shell ?? null;
-    const memory = useMemo(() => (shell === null ? null : baseMemoryFor(shell)), [shell]);
-    // Bridge the memory's event channel onto the provider `onError` (API §2/§8):
-    // warm-refresh failures and rolled-back mutations surface here rather than being
-    // swallowed. Registered while the booted shell is live; cleared on teardown.
     useEffect(() => {
-        if (shell === null)
-            return;
-        setMemoryErrorSink(shell, (event) => {
-            const mapped = toShellError(event);
-            if (mapped !== null)
-                onErrorRef.current?.(mapped);
-        });
-        return () => setMemoryErrorSink(shell, null);
-    }, [shell]);
-    // Register this provider's boot-retry into the shell's connection store (rule 3),
-    // so `useConnection().retry` re-runs boot. Status/seq stay a stub ('ready'/0)
-    // until the transport-status + result-`seq` feed lands, with no surface change.
+        if (shell !== null)
+            connectionStore(shell).setRetry(retry);
+    }, [shell, retry]);
+    const store = state.runtime?.store ?? null;
+    const storeScope = state.runtime?.storeScope ?? null;
     useEffect(() => {
-        if (shell === null)
+        if (shell === null || store === null || storeScope === null)
             return;
-        connectionStore(shell).setRetry(retry);
-    }, [shell, retry]);
+        return retainStore(storeFor(shell, storeScope));
+    }, [shell, store, storeScope]);
     if (state.status === 'error') {
-        // Wrapped in a fragment so the component's declared return type stays
-        // `ReactElement | null` — valid JSX under @types/react 18 AND 19 (the react
-        // peer range is >=18), even though `errorFallback`/`fallback` yield ReactNode.
         if (errorFallback !== undefined)
             return _jsx(_Fragment, { children: errorFallback(state.error, retry) });
         throw state.error;
     }
     if (state.status !== 'ready' || state.runtime === null) {
-        return fallback !== undefined ? _jsx(_Fragment, { children: fallback }) : null;
+        return fallback === undefined ? null : _jsx(_Fragment, { children: fallback });
     }
-    return (_jsx(ShellContext.Provider, { value: state.runtime, children: _jsx(GraphContext.Provider, { value: memory, children: children }) }));
+    return (_jsx(ShellContext.Provider, { value: state.runtime, children: _jsx(GraphContext.Provider, { value: state.runtime.store, children: children }) }));
 }

package/dist/session/session.context.d.ts

@@ -1,4 +1,6 @@
+import type { GraphStore } from '@astrale-os/kernel-client/store';
 import type { KernelClient, Shell } from '@astrale-os/shell';
+import type { GraphStoreScope } from '../graph/store.js';
 /**
  * whoami's node type, derived from the auth surface so shell-react needs no
  * direct `@astrale-os/kernel-core` dependency (`Node` is not yet re-exported by
@@ -13,6 +15,9 @@ export interface ShellRuntime {
      * bound kernel exposes no auth surface (a bare prebuilt Shell in tests).
      */
     readonly self: SelfNode | null;
+    readonly storeScope: GraphStoreScope;
+    readonly store: GraphStore;
+    readonly ownsStore: boolean;
 }
 export declare const ShellContext: import("react").Context<ShellRuntime | null>;
 //# sourceMappingURL=session.context.d.ts.map

package/dist/session/session.context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session.context.d.ts","sourceRoot":"","sources":["../../src/session/session.context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AAS5D;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAA;AAE1E,gFAAgF;AAChF,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;IACrB;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAA;CAC/B;AACD,eAAO,MAAM,YAAY,8CAA2C,CAAA"}
+{"version":3,"file":"session.context.d.ts","sourceRoot":"","sources":["../../src/session/session.context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAA;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AAS5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAExD;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAA;AAE1E,gFAAgF;AAChF,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;IACrB;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAA;IAC9B,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAA;IACpC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;IAC1B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;CAC5B;AACD,eAAO,MAAM,YAAY,8CAA2C,CAAA"}

package/dist/window/adopt.d.ts

@@ -12,7 +12,6 @@ export interface AdoptRecord {
     readonly window: Window;
     readonly slot: StageSlot;
     readonly state: WindowState;
-    readonly targetId: string | undefined;
     /** Close the window, release its slot, drop it from the registry (fired if unadopted). */
     dispose(): void;
 }

package/dist/window/adopt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adopt.d.ts","sourceRoot":"","sources":["../../src/window/adopt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAE/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE/C,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;IACxB,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAA;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;IACrC,0FAA0F;IAC1F,OAAO,IAAI,IAAI,CAAA;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,yFAAyF;IACzF,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CAAA;IAC7C,yFAAyF;IACzF,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAAA;CACtC;AAED,yDAAyD;AACzD,wBAAgB,gBAAgB,IAAI,UAAU,CA2B7C"}
+{"version":3,"file":"adopt.d.ts","sourceRoot":"","sources":["../../src/window/adopt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAE/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE/C,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;IACxB,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAA;IAC3B,0FAA0F;IAC1F,OAAO,IAAI,IAAI,CAAA;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,yFAAyF;IACzF,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CAAA;IAC7C,yFAAyF;IACzF,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAAA;CACtC;AAED,yDAAyD;AACzD,wBAAgB,gBAAgB,IAAI,UAAU,CA2B7C"}

package/dist/window/hooks/target-node.hook.d.ts

@@ -1,7 +1,11 @@
-import type { ReadState } from '../../graph/memory/read/envelope.js';
-import type { Node } from '../lifecycle/mount.js';
-export interface NodeResult extends ReadState {
-    readonly node: Node | null;
-}
-export declare function useTargetNode(): NodeResult;
+import type { Node } from '@astrale-os/sdk/graph/node';
+import { Path } from '@astrale-os/sdk/graph/path';
+import type { GraphResource } from '../../graph/resource.js';
+/**
+ * Read the canonical target admitted by the parent handshake and subsequent
+ * parent-owned hot swaps without remounting this View document.
+ */
+export declare function useTargetNode(): GraphResource<Node | null>;
+/** Reactive canonical target Path; null represents an explicit parent clear. */
+export declare function useTargetPath(): Path | null;
 //# sourceMappingURL=target-node.hook.d.ts.map

package/dist/window/hooks/target-node.hook.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"target-node.hook.d.ts","sourceRoot":"","sources":["../../../src/window/hooks/target-node.hook.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAA;AACpE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAA;AAKjD,MAAM,WAAW,UAAW,SAAQ,SAAS;IAC3C,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAA;CAC3B;AAeD,wBAAgB,aAAa,IAAI,UAAU,CAe1C"}
+{"version":3,"file":"target-node.hook.d.ts","sourceRoot":"","sources":["../../../src/window/hooks/target-node.hook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAA;AAEtD,OAAO,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAA;AAGjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AAK5D;;;GAGG;AACH,wBAAgB,aAAa,IAAI,aAAa,CAAC,IAAI,GAAG,IAAI,CAAC,CAE1D;AAED,gFAAgF;AAChF,wBAAgB,aAAa,IAAI,IAAI,GAAG,IAAI,CAS3C"}

package/dist/window/hooks/target-node.hook.js

@@ -1,77 +1,19 @@
+import { Path } from '@astrale-os/sdk/graph/path';
+import { useCallback, useMemo, useSyncExternalStore } from 'react';
+import { useDynamicObject } from '../../schema/object.hook.js';
+import { useShell } from '../../session/shell.hook.js';
 /**
- * useTargetNode (API §10) — inside a sandboxed view, the node it was opened on.
- * The id starts from `shell.targetNodeId` (handshake) and a host `setTarget`
- * intent retargets it; the id resolves to a live `Node` through the shell kernel.
- *
- * Honest subset (flagged): the read is a one-shot `kernel.get` re-run on id
- * change, not a memory watch, so `live` is false. Once composed with `useNode(id)`
- * it becomes real stale-while-revalidate liveness with no consumer change.
+ * Read the canonical target admitted by the parent handshake and subsequent
+ * parent-owned hot swaps without remounting this View document.
  */
-import { useCallback, useEffect, useRef, useState } from 'react';
-import { idleReadState } from '../../graph/memory/read/idle.js';
-import { useShell } from '../../session/shell.hook.js';
-/** Address a bare node id by graph id (`@<id>`); pass paths/anchors through. */
-function toRef(id) {
-    return id.startsWith('/') || id.startsWith('@') ? id : `@${id}`;
-}
-const IDLE_READ = { node: null, pending: false, error: undefined };
 export function useTargetNode() {
-    const shell = useShell();
-    const [id, setId] = useState(() => shell.targetNodeId ?? null);
-    useEffect(() => {
-        const parent = shell.parent;
-        if (parent === null)
-            return;
-        return parent.on('intent', (message) => {
-            if (message.envelope.name !== 'setTarget')
-                return;
-            const nodeId = message.envelope.payload.nodeId;
-            if (typeof nodeId === 'string')
-                setId(nodeId);
-        });
-    }, [shell]);
-    return useNodeRead(shell.kernel, id);
+    return useDynamicObject(useTargetPath());
 }
-/** One-shot get + refetch, in the read envelope. The graph-module seam. */
-function useNodeRead(kernel, id) {
-    const [snap, setSnap] = useState(IDLE_READ);
-    const aliveRef = useRef(true);
-    useEffect(() => {
-        aliveRef.current = true;
-        return () => {
-            aliveRef.current = false;
-        };
-    }, []);
-    const load = useCallback(async () => {
-        if (id === null) {
-            if (aliveRef.current)
-                setSnap(IDLE_READ);
-            return;
-        }
-        if (aliveRef.current)
-            setSnap((s) => ({ node: s.node, pending: true, error: undefined }));
-        try {
-            const node = await kernel.get(toRef(id));
-            if (aliveRef.current)
-                setSnap({ node: node ?? null, pending: false, error: undefined });
-        }
-        catch (error) {
-            if (aliveRef.current)
-                setSnap((s) => ({ node: s.node, pending: false, error }));
-        }
-    }, [kernel, id]);
-    useEffect(() => {
-        void load();
-    }, [load]);
-    if (id === null) {
-        return { ...idleReadState(), node: null };
-    }
-    return {
-        node: snap.node,
-        pending: snap.pending,
-        error: snap.error,
-        live: false,
-        seq: 0,
-        refetch: load,
-    };
+/** Reactive canonical target Path; null represents an explicit parent clear. */
+export function useTargetPath() {
+    const shell = useShell();
+    const subscribe = useCallback((listener) => shell.onTargetChange(() => listener()), [shell]);
+    const snapshot = useCallback(() => shell.targetNodeId, [shell]);
+    const target = useSyncExternalStore(subscribe, snapshot, snapshot);
+    return useMemo(() => (target === undefined ? null : Path.parse(target)), [target]);
 }

package/dist/window/hooks/views-for.hook.d.ts

@@ -1,8 +1,9 @@
-import type { PathLike } from '@astrale-os/kernel-client/graph';
+import type { Node } from '@astrale-os/sdk/graph/node';
+import type { PathLike } from '@astrale-os/sdk/graph/path';
+import type { ResolvedView } from '@astrale-os/shell';
 import type { ReadState } from '../../graph/memory/read/envelope.js';
-import type { Node, ViewDescriptor } from '../lifecycle/mount.js';
 export interface ViewsForResult extends ReadState {
-    readonly views: readonly ViewDescriptor[];
+    readonly views: readonly ResolvedView[];
 }
 export declare function useViewsFor(node: Node | PathLike | null | undefined): ViewsForResult;
 //# sourceMappingURL=views-for.hook.d.ts.map

package/dist/window/hooks/views-for.hook.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"views-for.hook.d.ts","sourceRoot":"","sources":["../../../src/window/hooks/views-for.hook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAA;AAW/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAA;AACpE,OAAO,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAKjE,MAAM,WAAW,cAAe,SAAQ,SAAS;IAC/C,QAAQ,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,CAAA;CAC1C;AAID,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,QAAQ,GAAG,IAAI,GAAG,SAAS,GAAG,cAAc,CAqBpF"}
+{"version":3,"file":"views-for.hook.d.ts","sourceRoot":"","sources":["../../../src/window/hooks/views-for.hook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAA;AACtD,OAAO,KAAK,EAAY,QAAQ,EAAE,MAAM,4BAA4B,CAAA;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAWrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAA;AAKpE,MAAM,WAAW,cAAe,SAAQ,SAAS;IAC/C,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAA;CACxC;AAID,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,QAAQ,GAAG,IAAI,GAAG,SAAS,GAAG,cAAc,CAqBpF"}

package/dist/window/hooks/views-for.hook.js

@@ -1,3 +1,4 @@
+import { Path } from '@astrale-os/sdk/graph/path';
 /**
  * useViewsFor (API §10) — "what Views can render this node", as mountable
  * `ViewDescriptor`s for the open-with menu. Backed one-shot (`live:false`) by the
@@ -11,7 +12,7 @@ const NO_VIEWS = Object.freeze([]);
 export function useViewsFor(node) {
     const shell = useShell();
     const target = resolvePath(node);
-    const res = useAsyncResource(target === null ? null : () => resolveViews(shell, target), NO_VIEWS, [shell, target]);
+    const res = useAsyncResource(target === null ? null : () => shell.views.resolve(target), NO_VIEWS, [shell, target]);
     return useMemo(() => ({
         views: res.data,
         pending: res.pending,
@@ -21,28 +22,11 @@ export function useViewsFor(node) {
         refetch: res.refetch,
     }), [res.data, res.pending, res.error, res.refetch]);
 }
-/** Dispatch `View.resolve` and project its rows to mountable `ViewDescriptor`s. */
-async function resolveViews(shell, node) {
-    const rows = await shell.views.resolve(node);
-    if (rows.length === 0)
-        return NO_VIEWS;
-    return rows.map((r) => ({ id: r.id, path: r.path, url: r.url, handshake: r.handshake }));
-}
-/** A path/`@id` the kernel read surface accepts, or `null` for an idle subject. */
+/** One canonical target, or `null` for an idle subject. */
 function resolvePath(node) {
     if (node === null || node === undefined)
         return null;
-    if (typeof node === 'string') {
-        if (node.length === 0)
-            return null;
-        return node.startsWith('/') || node.startsWith('@') ? node : `@${node}`;
-    }
-    const obj = node;
-    if (typeof obj.path?.raw === 'string')
-        return obj.path.raw;
-    if (typeof obj.id === 'string')
-        return `@${obj.id}`;
-    if (typeof obj.raw === 'string')
-        return obj.raw;
-    return null;
+    if ('id' in node)
+        return Path.id(node.id).raw;
+    return Path.from(node).raw;
 }

package/dist/window/hooks/windows.hook.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"windows.hook.d.ts","sourceRoot":"","sources":["../../../src/window/hooks/windows.hook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAc/C,mFAAmF;AACnF,wBAAgB,UAAU,IAAI,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAQxD;AAED,uCAAuC;AACvC,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,SAAS,eAAe,EAAE,CAG1D"}
+{"version":3,"file":"windows.hook.d.ts","sourceRoot":"","sources":["../../../src/window/hooks/windows.hook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAa/C,mFAAmF;AACnF,wBAAgB,UAAU,IAAI,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAQxD;AAED,uCAAuC;AACvC,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,SAAS,eAAe,EAAE,CAG1D"}

package/dist/window/hooks/windows.hook.js

@@ -1,9 +1,8 @@
 /**
  * useWindows / useWindowList (API §10) — reactive views over the windows a
- * `ViewHost`/`AppHost` mounts through the per-shell hub. The shell exposes no
- * window-change feed, so the hub registry (fed by the hosts) is the reactive
- * source; windows mounted imperatively via `shell.mount` outside React are not
- * tracked here — flagged in the module report as a shell foundation gap.
+ * `ViewHost`/`AppHost` or the framework-neutral Shell mounts. The hub mirrors
+ * Shell's immutable window-change feed, so credential, location, lifecycle,
+ * and imperative mounts remain reactive through one snapshot authority.
  */
 import { useMemo, useSyncExternalStore } from 'react';
 import { useShell } from '../../session/shell.hook.js';

package/dist/window/host.d.ts

@@ -1,7 +1,5 @@
-import type { NodeRefInput } from '@astrale-os/kernel-client';
-import type { CloseResult, IntentRegistry, MountCredential, SandboxProfile } from '@astrale-os/shell';
+import type { CloseResult, HostCapabilities, MountCredential, ResolvedView, SandboxProfile } from '@astrale-os/shell';
 import type { CSSProperties, ReactNode } from 'react';
-import type { ResolvedSource, ViewSource } from './lifecycle/mount.js';
 import type { WindowState } from './lifecycle/states.js';
 /** Imperative handle on a mounted `ViewHost` (API §10). */
 export interface ViewHostHandle {
@@ -14,20 +12,20 @@ export interface ViewHostHandle {
     refresh(): void;
 }
 /** Static iframe sandbox flags, an explicit opt-out, or a policy over the resolved mount. */
-export type SandboxPolicy = SandboxProfile | null | ((source: ResolvedSource) => SandboxProfile | null);
-export type ViewHostProps = ViewSource & {
-    /** Node this view opens on — delivered as `targetNodeId`; a change retargets. */
-    node?: NodeRefInput;
-    capabilities?: {
-        intents: readonly (keyof IntentRegistry)[];
-    };
+export type SandboxPolicy = SandboxProfile | null | ((view: ResolvedView) => SandboxProfile | null);
+export interface ViewHostProps {
+    /** One canonical target paired with one untouched View route. */
+    view: ResolvedView;
+    capabilities?: HostCapabilities;
     sandbox?: SandboxPolicy;
     credential?: MountCredential;
+    handshakeTimeoutMs?: number;
+    delegationTtlSeconds?: number;
     /** Rendered inside the anchor while the frame is not `ready`. */
     fallback?: (state: WindowState) => ReactNode;
     onStateChange?: (state: WindowState) => void;
     className?: string;
     style?: CSSProperties;
-};
+}
 export declare const ViewHost: import("react").ForwardRefExoticComponent<ViewHostProps & import("react").RefAttributes<ViewHostHandle>>;
 //# sourceMappingURL=host.d.ts.map

package/dist/window/host.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../../src/window/host.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAC7D,OAAO,KAAK,EACV,WAAW,EACX,cAAc,EACd,eAAe,EAEf,cAAc,EAEf,MAAM,mBAAmB,CAAA;AAC1B,OAAO,KAAK,EAAE,aAAa,EAAgB,SAAS,EAAE,MAAM,OAAO,CAAA;AAqBnE,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAcxD,2DAA2D;AAC3D,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,KAAK,CAAC,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAAA;IAC3E,gCAAgC;IAChC,OAAO,IAAI,IAAI,CAAA;CAChB;AAED,6FAA6F;AAC7F,MAAM,MAAM,aAAa,GACrB,cAAc,GACd,IAAI,GACJ,CAAC,CAAC,MAAM,EAAE,cAAc,KAAK,cAAc,GAAG,IAAI,CAAC,CAAA;AAEvD,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG;IACvC,iFAAiF;IACjF,IAAI,CAAC,EAAE,YAAY,CAAA;IACnB,YAAY,CAAC,EAAE;QAAE,OAAO,EAAE,SAAS,CAAC,MAAM,cAAc,CAAC,EAAE,CAAA;KAAE,CAAA;IAC7D,OAAO,CAAC,EAAE,aAAa,CAAA;IACvB,UAAU,CAAC,EAAE,eAAe,CAAA;IAC5B,iEAAiE;IACjE,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,SAAS,CAAA;IAC5C,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAA;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,aAAa,CAAA;CACtB,CAAA;AAYD,eAAO,MAAM,QAAQ,0GA4RpB,CAAA"}
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../../src/window/host.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,gBAAgB,EAChB,eAAe,EAEf,YAAY,EACZ,cAAc,EAEf,MAAM,mBAAmB,CAAA;AAC1B,OAAO,KAAK,EAAE,aAAa,EAAgB,SAAS,EAAE,MAAM,OAAO,CAAA;AAsBnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAQxD,2DAA2D;AAC3D,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,KAAK,CAAC,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAAA;IAC3E,gCAAgC;IAChC,OAAO,IAAI,IAAI,CAAA;CAChB;AAED,6FAA6F;AAC7F,MAAM,MAAM,aAAa,GAAG,cAAc,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,YAAY,KAAK,cAAc,GAAG,IAAI,CAAC,CAAA;AAEnG,MAAM,WAAW,aAAa;IAC5B,iEAAiE;IACjE,IAAI,EAAE,YAAY,CAAA;IAClB,YAAY,CAAC,EAAE,gBAAgB,CAAA;IAC/B,OAAO,CAAC,EAAE,aAAa,CAAA;IACvB,UAAU,CAAC,EAAE,eAAe,CAAA;IAC5B,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,iEAAiE;IACjE,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,SAAS,CAAA;IAC5C,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAA;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,aAAa,CAAA;CACtB;AAWD,eAAO,MAAM,QAAQ,0GA+PpB,CAAA"}