@astrale-os/shell-react 0.2.6 → 0.2.8

package/dist/application/apps/domains.hook.d.ts

@@ -0,0 +1,7 @@
+import type { DomainSearchResult } from '@astrale-os/shell';
+import type { ReadState } from '../../graph/memory/read/envelope.js';
+export interface DomainsResult extends ReadState {
+    readonly domains: readonly DomainSearchResult[];
+}
+export declare function useDomains(): DomainsResult;
+//# sourceMappingURL=domains.hook.d.ts.map

package/dist/application/apps/domains.hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domains.hook.d.ts","sourceRoot":"","sources":["../../../src/application/apps/domains.hook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAI3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAA;AAQpE,MAAM,WAAW,aAAc,SAAQ,SAAS;IAC9C,QAAQ,CAAC,OAAO,EAAE,SAAS,kBAAkB,EAAE,CAAA;CAChD;AAED,wBAAgB,UAAU,IAAI,aAAa,CAoB1C"}

package/dist/application/apps/domains.hook.js

@@ -0,0 +1,18 @@
+import { useMemo } from 'react';
+import { useAsyncResource } from '../../graph/async.js';
+import { useShell } from '../../session/shell.hook.js';
+import { isOsPlaneAvailable } from '../user/user.store.js';
+const NO_DOMAINS = [];
+export function useDomains() {
+    const shell = useShell();
+    const available = isOsPlaneAvailable(shell);
+    const result = useAsyncResource(available ? () => shell.apps.searchDomains() : null, NO_DOMAINS, [shell, available]);
+    return useMemo(() => ({
+        domains: result.data,
+        pending: result.pending,
+        error: result.error,
+        live: false,
+        seq: 0,
+        refetch: result.refetch,
+    }), [result]);
+}

package/dist/application/index.d.ts

@@ -7,6 +7,8 @@ export { useSpace } from './spaces/space.hook.js';
 export type { SpaceResult } from './spaces/space.hook.js';
 export { useApps } from './apps/apps.hook.js';
 export type { AppsResult } from './apps/apps.hook.js';
+export { useDomains } from './apps/domains.hook.js';
+export type { DomainsResult } from './apps/domains.hook.js';
 export { useOpenApp } from './apps/open-app.hook.js';
 export { AppHost } from './apps/app-host.js';
 export type { AppHostFallbackState, AppHostProps } from './apps/app-host.js';
@@ -14,5 +16,5 @@ export { AppLogo } from './apps/app-logo.js';
 export type { AppLogoProps } from './apps/app-logo.js';
 export { useRoles } from './roles.hook.js';
 export type { RolesResult } from './roles.hook.js';
-export type { ApplicationNode, AppSession, RoleNode, SpaceNode, UserNode } from '@astrale-os/shell';
+export type { ApplicationNode, AppSession, DomainSearchResult, RoleNode, SpaceNode, UserNode, } from '@astrale-os/shell';
 //# sourceMappingURL=index.d.ts.map

package/dist/application/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/application/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AACnD,YAAY,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAA;AAChE,YAAY,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAA;AACxE,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AACjD,YAAY,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAC7C,YAAY,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AAC5C,YAAY,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAC5E,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AAC5C,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAC1C,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAGlD,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/application/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AACnD,YAAY,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAA;AAChE,YAAY,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAA;AACxE,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AACjD,YAAY,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAC7C,YAAY,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AACnD,YAAY,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AAC5C,YAAY,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAC5E,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AAC5C,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAC1C,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAGlD,YAAY,EACV,eAAe,EACf,UAAU,EACV,kBAAkB,EAClB,QAAQ,EACR,SAAS,EACT,QAAQ,GACT,MAAM,mBAAmB,CAAA"}

package/dist/application/index.js

@@ -1,11 +1,13 @@
 // application — API §12.2. The OS-plane hooks over the shell package's
 // `shell.user/spaces/apps` namespaces + the window module: useUser, useSpaces,
-// useCurrentSpace, useSpace, useApps, useRoles, useOpenApp, AppHost, AppLogo.
+// useCurrentSpace, useSpace, useApps, useDomains, useRoles, useOpenApp,
+// AppHost, AppLogo.
 export { useUser } from './user/user.hook.js';
 export { useSpaces } from './spaces/spaces.hook.js';
 export { useCurrentSpace } from './spaces/current-space.hook.js';
 export { useSpace } from './spaces/space.hook.js';
 export { useApps } from './apps/apps.hook.js';
+export { useDomains } from './apps/domains.hook.js';
 export { useOpenApp } from './apps/open-app.hook.js';
 export { AppHost } from './apps/app-host.js';
 export { AppLogo } from './apps/app-logo.js';

package/dist/application/user/user.store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"user.store.d.ts","sourceRoot":"","sources":["../../../src/application/user/user.store.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAExD,MAAM,MAAM,SAAS,GACjB;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,GAC7C;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAA;CAAE,GACvC;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE;AACxC,qFAAqF;GACnF;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAA;AAE7C,eAAO,MAAM,SAAS,2BAAkC,CAAA;AAKxD,sEAAsE;AACtE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAExD;AAcD;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAkB3D;AAED,wFAAwF;AACxF,wBAAgB,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,CAoBhD"}
+{"version":3,"file":"user.store.d.ts","sourceRoot":"","sources":["../../../src/application/user/user.store.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAExD,MAAM,MAAM,SAAS,GACjB;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,GAC7C;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAA;CAAE,GACvC;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE;AACxC,qFAAqF;GACnF;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAA;AAE7C,eAAO,MAAM,SAAS,2BAAkC,CAAA;AAKxD,sEAAsE;AACtE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAExD;AAeD;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAkB3D;AAED,wFAAwF;AACxF,wBAAgB,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,CAoBhD"}

package/dist/application/user/user.store.js

@@ -7,7 +7,8 @@ export function isOsPlaneAvailable(shell) {
 }
 function osPlaneError(cause) {
     const detail = cause instanceof Error ? cause.message : String(cause);
-    return new Error(`The OS plane is unavailable (useUser/useSpaces/useApps): shell.user.me() could not resolve ` +
+    return new Error(`The OS plane is unavailable (useUser/useSpaces/useApps/useDomains): ` +
+        `shell.user.me() could not resolve ` +
         `— the workspace/shell domain may not be installed for this identity. (${detail})`);
 }
 /**

package/dist/index.d.ts

@@ -28,9 +28,9 @@ export { useCloseGuard, useTargetNode, useViewsFor, useWindow, useWindowList, us
 export type { CloseGuard, CloseVerdict, ViewDescriptor, ViewHostProps, ViewSource, ViewHostHandle, ViewsForResult, WindowListEntry, WindowState, WindowView, } from './window/index.js';
 export { useEmitIntent, useIntent, useSendIntent } from './intents/index.js';
 export type { EmitIntent, IntentCtx, IntentPayload, IntentReply, SendIntent, } from './intents/index.js';
-export { AppHost, AppLogo, useApps, useCurrentSpace, useOpenApp, useRoles, useSpace, useSpaces, useUser, } from './application/index.js';
-export type { AppHostFallbackState, AppHostProps, AppLogoProps, AppsResult, CurrentSpaceResult, RolesResult, SpaceResult, SpacesResult, } from './application/index.js';
-export type { ApplicationNode, AppSession, RoleNode, SpaceNode, UserNode } from '@astrale-os/shell';
+export { AppHost, AppLogo, useApps, useCurrentSpace, useOpenApp, useRoles, useDomains, useSpace, useSpaces, useUser, } from './application/index.js';
+export type { AppHostFallbackState, AppHostProps, AppLogoProps, AppsResult, CurrentSpaceResult, RolesResult, DomainsResult, SpaceResult, SpacesResult, } from './application/index.js';
+export type { ApplicationNode, AppSession, DomainSearchResult, RoleNode, SpaceNode, UserNode, } from '@astrale-os/shell';
 export type { Action, ReadState, ReadOptions, Windowed } from './graph/index.js';
 export * from './graph/guards.error.js';
 export { DESCRIPTION_KEY, NAME_KEY, STATUS_KEY, descriptionOf, nameOf, normalizeRef, statusOf, } from '@astrale-os/kernel-client';

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -27,7 +27,7 @@ export { useCloseGuard, useTargetNode, useViewsFor, useWindow, useWindowList, us
 // ─── intents (§11) ───────────────────────────────────────────────────────────
 export { useEmitIntent, useIntent, useSendIntent } from './intents/index.js';
 // ─── application — the OS plane (§12) ────────────────────────────────────────
-export { AppHost, AppLogo, useApps, useCurrentSpace, useOpenApp, useRoles, useSpace, useSpaces, useUser, } from './application/index.js';
+export { AppHost, AppLogo, useApps, useCurrentSpace, useOpenApp, useRoles, useDomains, useSpace, useSpaces, useUser, } from './application/index.js';
 // ─── error taxonomy (§1.4) — guards + classes, re-exported from kernel-client ─
 export * from './graph/guards.error.js';
 // ─── re-exported kernel-client types (one import surface, §0 preamble) ───────

package/dist/intents/send-intent.hook.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"send-intent.hook.d.ts","sourceRoot":"","sources":["../../src/intents/send-intent.hook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAWtE,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAM/D,0DAA0D;AAC1D,MAAM,WAAW,UAAU;IACzB,CAAC,CAAC,SAAS,MAAM,cAAc,EAC7B,IAAI,EAAE,CAAC,EACP,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC;IACzB,oFAAoF;IACpF,IAAI,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAA;KAAE,GAChC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAA;CAClC;AAED,wBAAgB,aAAa,IAAI,UAAU,CAiE1C"}
+{"version":3,"file":"send-intent.hook.d.ts","sourceRoot":"","sources":["../../src/intents/send-intent.hook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAWtE,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAM/D,0DAA0D;AAC1D,MAAM,WAAW,UAAU;IACzB,CAAC,CAAC,SAAS,MAAM,cAAc,EAC7B,IAAI,EAAE,CAAC,EACP,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC;IACzB,oFAAoF;IACpF,IAAI,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAA;KAAE,GAChC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAA;CAClC;AAED,wBAAgB,aAAa,IAAI,UAAU,CAiF1C"}

package/dist/intents/send-intent.hook.js

@@ -29,7 +29,7 @@ export function useSendIntent() {
         const correlationId = crypto.randomUUID();
         const message = intentMessage(name, payload, correlationId);
         const pending = pendingRef.current;
-        return new Promise((resolve) => {
+        return new Promise((resolve, reject) => {
             let done = false;
             let offReply = NOOP;
             let offClose = NOOP;
@@ -43,12 +43,25 @@ export function useSendIntent() {
                 pending.delete(onUnmount);
                 resolve(value);
             }
+            function fail(error) {
+                if (done)
+                    return;
+                done = true;
+                offReply();
+                offClose();
+                pending.delete(onUnmount);
+                reject(error);
+            }
             const onReply = (m) => {
                 if (m.envelope.name !== INTENT_REPLY)
                     return;
                 const reply = m.envelope.payload;
                 if (reply.correlationId !== correlationId)
                     return;
+                if (reply.error) {
+                    fail(new Error(reply.error.message));
+                    return;
+                }
                 settle(reply.result);
             };
             pending.add(onUnmount);

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;AAiBD,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,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"}

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

@@ -1,4 +1,3 @@
-import { K } from '@astrale-os/kernel-core';
 /**
  * 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
@@ -7,14 +6,12 @@ import { K } from '@astrale-os/kernel-core';
  */
 import { useMemo } from 'react';
 import { useAsyncResource } from '../../graph/async.js';
-import { useKernelClient } from '../../session/kernel-client.hook.js';
-/** The `View.resolve` wire address — the qualified static-method slug from the schema. */
-const VIEW_RESOLVE_METHOD = K.View.resolve.path.method.raw;
+import { useShell } from '../../session/shell.hook.js';
 const NO_VIEWS = Object.freeze([]);
 export function useViewsFor(node) {
-    const kernel = useKernelClient();
+    const shell = useShell();
     const target = resolvePath(node);
-    const res = useAsyncResource(target === null ? null : () => resolveViews(kernel, target), NO_VIEWS, [kernel, target]);
+    const res = useAsyncResource(target === null ? null : () => resolveViews(shell, target), NO_VIEWS, [shell, target]);
     return useMemo(() => ({
         views: res.data,
         pending: res.pending,
@@ -25,9 +22,9 @@ export function useViewsFor(node) {
     }), [res.data, res.pending, res.error, res.refetch]);
 }
 /** Dispatch `View.resolve` and project its rows to mountable `ViewDescriptor`s. */
-async function resolveViews(kernel, node) {
-    const rows = (await kernel.call(VIEW_RESOLVE_METHOD, { node }));
-    if (rows === null || rows === undefined || rows.length === 0)
+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 }));
 }

package/dist/window/lifecycle/mount.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mount.d.ts","sourceRoot":"","sources":["../../../src/window/lifecycle/mount.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAC7D;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AAE5D,+EAA+E;AAC/E,MAAM,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;AAExE,kFAAkF;AAClF,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,cAAc,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAA;AAEpG,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,SAAS,EAAE,OAAO,GAAG,MAAM,CAAA;IACpC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B;AA6CD,4EAA4E;AAC5E,wBAAsB,aAAa,CACjC,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC,cAAc,CAAC,CAgBzB;AAED,uEAAuE;AACvE,wBAAgB,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAOpD;AAED,wEAAwE;AACxE,wBAAgB,OAAO,CAAC,GAAG,EAAE,YAAY,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAKzE;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAGlE;AAED,mFAAmF;AACnF,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAMlF"}
+{"version":3,"file":"mount.d.ts","sourceRoot":"","sources":["../../../src/window/lifecycle/mount.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAC7D;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AAE5D,+EAA+E;AAC/E,MAAM,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;AAExE,kFAAkF;AAClF,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,cAAc,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAA;AAEpG,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,SAAS,EAAE,OAAO,GAAG,MAAM,CAAA;IACpC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B;AA2ED,4EAA4E;AAC5E,wBAAsB,aAAa,CACjC,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC,cAAc,CAAC,CAgBzB;AAED,uEAAuE;AACvE,wBAAgB,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAOpD;AAED,wEAAwE;AACxE,wBAAgB,OAAO,CAAC,GAAG,EAAE,YAAY,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAKzE;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAGlE;AAED,mFAAmF;AACnF,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAMlF"}

package/dist/window/lifecycle/mount.js

@@ -24,7 +24,7 @@ async function resolveViewRef(kernel, ref, handshakeHint) {
     if (node === null)
         throw new Error(`ViewHost: view not found (${toPath(ref)})`);
     const props = node.props ?? {};
-    const url = props.url;
+    const url = viewUrl(props);
     if (typeof url !== 'string' || url.length === 0) {
         throw new Error('ViewHost: resolved view has no url');
     }
@@ -32,6 +32,37 @@ async function resolveViewRef(kernel, ref, handshakeHint) {
     const id = node.id ?? slugOfUrl(url);
     return { url, handshake, functionId: id };
 }
+/** Resolve both the legacy flat url and the canonical Function binding. */
+function viewUrl(props) {
+    if (typeof props.url === 'string' && props.url.length > 0)
+        return props.url;
+    const direct = remoteUrlOf(props.binding);
+    if (direct !== undefined)
+        return direct;
+    // Raw graph props can be keyed by the property's canonical graph key rather
+    // than its local slug. The binding value remains self-describing.
+    for (const value of Object.values(props)) {
+        const remoteUrl = remoteUrlOf(value);
+        if (remoteUrl !== undefined)
+            return remoteUrl;
+    }
+    return undefined;
+}
+function remoteUrlOf(value) {
+    let binding = value;
+    if (typeof binding === 'string') {
+        try {
+            binding = JSON.parse(binding);
+        }
+        catch {
+            return undefined;
+        }
+    }
+    if (binding === null || typeof binding !== 'object')
+        return undefined;
+    const remoteUrl = binding.remoteUrl;
+    return typeof remoteUrl === 'string' && remoteUrl.length > 0 ? remoteUrl : undefined;
+}
 function normalizeHandshake(value) {
     return value === 'none' ? 'none' : 'shell';
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astrale-os/shell-react",
-  "version": "0.2.6",
+  "version": "0.2.8",
   "description": "Astrale shell-react — the React face of the shell (provider, hooks, view components)",
   "license": "Apache-2.0",
   "repository": {
@@ -44,7 +44,7 @@
     "react-dom": "^19.2.0",
     "typescript": "~6.0.1-rc",
     "vitest": "^3.2.4",
-    "@astrale-os/shell": "0.3.4"
+    "@astrale-os/shell": "0.3.6"
   },
   "peerDependencies": {
     "@astrale-os/shell": ">=0.2.0 <1.0.0",

package/src/application/apps/domains.hook.ts

@@ -0,0 +1,37 @@
+import type { DomainSearchResult } from '@astrale-os/shell'
+
+import { useMemo } from 'react'
+
+import type { ReadState } from '../../graph/memory/read/envelope.js'
+
+import { useAsyncResource } from '../../graph/async.js'
+import { useShell } from '../../session/shell.hook.js'
+import { isOsPlaneAvailable } from '../user/user.store.js'
+
+const NO_DOMAINS: readonly DomainSearchResult[] = []
+
+export interface DomainsResult extends ReadState {
+  readonly domains: readonly DomainSearchResult[]
+}
+
+export function useDomains(): DomainsResult {
+  const shell = useShell()
+  const available = isOsPlaneAvailable(shell)
+  const result = useAsyncResource<readonly DomainSearchResult[]>(
+    available ? () => shell.apps.searchDomains() : null,
+    NO_DOMAINS,
+    [shell, available],
+  )
+
+  return useMemo(
+    () => ({
+      domains: result.data,
+      pending: result.pending,
+      error: result.error,
+      live: false,
+      seq: 0,
+      refetch: result.refetch,
+    }),
+    [result],
+  )
+}

package/src/application/index.ts

@@ -1,6 +1,7 @@
 // application — API §12.2. The OS-plane hooks over the shell package's
 // `shell.user/spaces/apps` namespaces + the window module: useUser, useSpaces,
-// useCurrentSpace, useSpace, useApps, useRoles, useOpenApp, AppHost, AppLogo.
+// useCurrentSpace, useSpace, useApps, useDomains, useRoles, useOpenApp,
+// AppHost, AppLogo.
 export { useUser } from './user/user.hook.js'
 export { useSpaces } from './spaces/spaces.hook.js'
 export type { SpacesResult } from './spaces/spaces.hook.js'
@@ -10,6 +11,8 @@ export { useSpace } from './spaces/space.hook.js'
 export type { SpaceResult } from './spaces/space.hook.js'
 export { useApps } from './apps/apps.hook.js'
 export type { AppsResult } from './apps/apps.hook.js'
+export { useDomains } from './apps/domains.hook.js'
+export type { DomainsResult } from './apps/domains.hook.js'
 export { useOpenApp } from './apps/open-app.hook.js'
 export { AppHost } from './apps/app-host.js'
 export type { AppHostFallbackState, AppHostProps } from './apps/app-host.js'
@@ -19,4 +22,11 @@ export { useRoles } from './roles.hook.js'
 export type { RolesResult } from './roles.hook.js'
 
 // The OS node/session types (from the shell package, single import surface).
-export type { ApplicationNode, AppSession, RoleNode, SpaceNode, UserNode } from '@astrale-os/shell'
+export type {
+  ApplicationNode,
+  AppSession,
+  DomainSearchResult,
+  RoleNode,
+  SpaceNode,
+  UserNode,
+} from '@astrale-os/shell'

package/src/application/user/user.store.ts

@@ -31,7 +31,8 @@ interface UserSurface {
 function osPlaneError(cause: unknown): Error {
   const detail = cause instanceof Error ? cause.message : String(cause)
   return new Error(
-    `The OS plane is unavailable (useUser/useSpaces/useApps): shell.user.me() could not resolve ` +
+    `The OS plane is unavailable (useUser/useSpaces/useApps/useDomains): ` +
+      `shell.user.me() could not resolve ` +
       `— the workspace/shell domain may not be installed for this identity. (${detail})`,
   )
 }

package/src/index.ts

@@ -134,6 +134,7 @@ export {
   useCurrentSpace,
   useOpenApp,
   useRoles,
+  useDomains,
   useSpace,
   useSpaces,
   useUser,
@@ -145,11 +146,19 @@ export type {
   AppsResult,
   CurrentSpaceResult,
   RolesResult,
+  DomainsResult,
   SpaceResult,
   SpacesResult,
 } from './application/index.js'
 // OS node/session types (from the shell package, single import surface).
-export type { ApplicationNode, AppSession, RoleNode, SpaceNode, UserNode } from '@astrale-os/shell'
+export type {
+  ApplicationNode,
+  AppSession,
+  DomainSearchResult,
+  RoleNode,
+  SpaceNode,
+  UserNode,
+} from '@astrale-os/shell'
 
 // ─── shared envelopes (§1) ───────────────────────────────────────────────────
 export type { Action, ReadState, ReadOptions, Windowed } from './graph/index.js'

package/src/intents/send-intent.hook.ts

@@ -51,7 +51,7 @@ export function useSendIntent(): SendIntent {
       const message = intentMessage(name, payload, correlationId)
       const pending = pendingRef.current
 
-      return new Promise<IntentReply<K> | void>((resolve) => {
+      return new Promise<IntentReply<K> | void>((resolve, reject) => {
         let done = false
         let offReply = NOOP
         let offClose = NOOP
@@ -64,10 +64,26 @@ export function useSendIntent(): SendIntent {
           pending.delete(onUnmount)
           resolve(value)
         }
+        function fail(error: Error): void {
+          if (done) return
+          done = true
+          offReply()
+          offClose()
+          pending.delete(onUnmount)
+          reject(error)
+        }
         const onReply = (m: IntentMessage): void => {
           if (m.envelope.name !== INTENT_REPLY) return
-          const reply = m.envelope.payload as { correlationId: string; result: unknown }
+          const reply = m.envelope.payload as {
+            correlationId: string
+            result?: unknown
+            error?: { message: string }
+          }
           if (reply.correlationId !== correlationId) return
+          if (reply.error) {
+            fail(new Error(reply.error.message))
+            return
+          }
           settle(reply.result as IntentReply<K>)
         }
 

package/src/window/hooks/views-for.hook.ts

@@ -1,6 +1,6 @@
 import type { PathLike } from '@astrale-os/kernel-client/graph'
+import type { Shell } from '@astrale-os/shell'
 
-import { K } from '@astrale-os/kernel-core'
 /**
  * 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
@@ -13,35 +13,22 @@ import type { ReadState } from '../../graph/memory/read/envelope.js'
 import type { Node, ViewDescriptor } from '../lifecycle/mount.js'
 
 import { useAsyncResource } from '../../graph/async.js'
-import { useKernelClient } from '../../session/kernel-client.hook.js'
+import { useShell } from '../../session/shell.hook.js'
 
 export interface ViewsForResult extends ReadState {
   readonly views: readonly ViewDescriptor[]
 }
 
-/** The `View.resolve` wire address — the qualified static-method slug from the schema. */
-const VIEW_RESOLVE_METHOD = K.View.resolve.path.method.raw
-
-/** The kernel `View.resolve` row shape (id/path/url/name?/handshake?/origin). */
-interface ViewOut {
-  readonly id: string
-  readonly path: string
-  readonly url: string
-  readonly name?: string
-  readonly handshake?: 'shell' | 'none'
-  readonly origin: 'self' | 'class'
-}
-
 const NO_VIEWS: readonly ViewDescriptor[] = Object.freeze([])
 
 export function useViewsFor(node: Node | PathLike | null | undefined): ViewsForResult {
-  const kernel = useKernelClient()
+  const shell = useShell()
   const target = resolvePath(node)
 
   const res = useAsyncResource<readonly ViewDescriptor[]>(
-    target === null ? null : () => resolveViews(kernel, target),
+    target === null ? null : () => resolveViews(shell, target),
     NO_VIEWS,
-    [kernel, target],
+    [shell, target],
   )
 
   return useMemo<ViewsForResult>(
@@ -58,12 +45,9 @@ export function useViewsFor(node: Node | PathLike | null | undefined): ViewsForR
 }
 
 /** Dispatch `View.resolve` and project its rows to mountable `ViewDescriptor`s. */
-async function resolveViews(
-  kernel: { call(method: string, params: unknown): Promise<unknown> },
-  node: string,
-): Promise<readonly ViewDescriptor[]> {
-  const rows = (await kernel.call(VIEW_RESOLVE_METHOD, { node })) as ViewOut[] | null | undefined
-  if (rows === null || rows === undefined || rows.length === 0) return NO_VIEWS
+async function resolveViews(shell: Shell, node: string): Promise<readonly ViewDescriptor[]> {
+  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 }))
 }
 

package/src/window/lifecycle/mount.ts

@@ -62,7 +62,7 @@ async function resolveViewRef(
   const node = await kernel.get(toPath(ref))
   if (node === null) throw new Error(`ViewHost: view not found (${toPath(ref)})`)
   const props = (node as { id?: string; props?: Record<string, unknown> }).props ?? {}
-  const url = props.url
+  const url = viewUrl(props)
   if (typeof url !== 'string' || url.length === 0) {
     throw new Error('ViewHost: resolved view has no url')
   }
@@ -71,6 +71,36 @@ async function resolveViewRef(
   return { url, handshake, functionId: id }
 }
 
+/** Resolve both the legacy flat url and the canonical Function binding. */
+function viewUrl(props: Record<string, unknown>): string | undefined {
+  if (typeof props.url === 'string' && props.url.length > 0) return props.url
+
+  const direct = remoteUrlOf(props.binding)
+  if (direct !== undefined) return direct
+
+  // Raw graph props can be keyed by the property's canonical graph key rather
+  // than its local slug. The binding value remains self-describing.
+  for (const value of Object.values(props)) {
+    const remoteUrl = remoteUrlOf(value)
+    if (remoteUrl !== undefined) return remoteUrl
+  }
+  return undefined
+}
+
+function remoteUrlOf(value: unknown): string | undefined {
+  let binding = value
+  if (typeof binding === 'string') {
+    try {
+      binding = JSON.parse(binding)
+    } catch {
+      return undefined
+    }
+  }
+  if (binding === null || typeof binding !== 'object') return undefined
+  const remoteUrl = (binding as { remoteUrl?: unknown }).remoteUrl
+  return typeof remoteUrl === 'string' && remoteUrl.length > 0 ? remoteUrl : undefined
+}
+
 function normalizeHandshake(value: unknown): 'shell' | 'none' {
   return value === 'none' ? 'none' : 'shell'
 }