@astrale-os/shell-react 0.3.1 → 0.3.2-beta.1

package/dist/application/apps/app-host.d.ts

@@ -20,4 +20,3 @@ export interface AppHostProps {
 }
 /** Resolve and mount an installed Domain through the ordinary Shell View lifecycle. */
 export declare const AppHost: import("react").ForwardRefExoticComponent<AppHostProps & import("react").RefAttributes<ViewHostHandle>>;
-//# sourceMappingURL=app-host.d.ts.map

package/dist/application/apps/app-logo.d.ts

@@ -16,4 +16,3 @@ export interface AppLogoProps {
     fallback?: ReactNode;
 }
 export declare function AppLogo({ logo, alt, className, style, fallback }: AppLogoProps): ReactElement;
-//# sourceMappingURL=app-logo.d.ts.map

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

@@ -5,4 +5,3 @@ export interface AppsResult extends ReadState {
 }
 /** Read the installed Domain applications available to the current Shell session. */
 export declare function useApps(): AppsResult;
-//# sourceMappingURL=apps.hook.d.ts.map

package/dist/application/apps/open-app.hook.d.ts

@@ -3,4 +3,3 @@ import type { App, ResolvedView } from '@astrale-os/shell';
 import type { Action } from '../../graph/action.js';
 /** Resolve one installed Domain's ordinary entry View. */
 export declare function useOpenApp(): Action<[App | Key.Origin], ResolvedView | null>;
-//# sourceMappingURL=open-app.hook.d.ts.map

package/dist/application/index.d.ts

@@ -13,4 +13,3 @@ export type { AppHostFallbackState, AppHostProps } from './apps/app-host.js';
 export { AppLogo } from './apps/app-logo.js';
 export type { AppLogoProps } from './apps/app-logo.js';
 export type { App, NodeTarget, ResolvedView, SpaceNode, UserNode } from '@astrale-os/shell';
-//# sourceMappingURL=index.d.ts.map

package/dist/application/spaces/current-space.hook.d.ts

@@ -4,4 +4,3 @@ export interface CurrentSpaceResult extends ReadState {
     readonly space: SpaceNode | null;
 }
 export declare function useCurrentSpace(): CurrentSpaceResult;
-//# sourceMappingURL=current-space.hook.d.ts.map

package/dist/application/spaces/current-space.store.d.ts

@@ -29,4 +29,3 @@ export interface CurrentSpaceStore {
 }
 /** The one current-space store for a Shell (created on first touch). */
 export declare function currentSpaceStore(shell: Shell): CurrentSpaceStore;
-//# sourceMappingURL=current-space.store.d.ts.map

package/dist/application/spaces/space.hook.d.ts

@@ -2,4 +2,3 @@ import type { NodeTarget } from '@astrale-os/shell';
 import type { CurrentSpaceResult } from './current-space.hook.js';
 export type SpaceResult = CurrentSpaceResult;
 export declare function useSpace(ref: NodeTarget | null | undefined): SpaceResult;
-//# sourceMappingURL=space.hook.d.ts.map

package/dist/application/spaces/spaces.hook.d.ts

@@ -10,4 +10,3 @@ export interface SpacesResult extends ReadState {
     readonly switch: Action<[NodeTarget], void>;
 }
 export declare function useSpaces(): SpacesResult;
-//# sourceMappingURL=spaces.hook.d.ts.map

package/dist/application/user/user.hook.d.ts

@@ -7,4 +7,3 @@
  */
 import type { UserNode } from '@astrale-os/shell';
 export declare function useUser(): UserNode;
-//# sourceMappingURL=user.hook.d.ts.map

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

@@ -32,4 +32,3 @@ export declare function isOsPlaneAvailable(shell: Shell): boolean;
 export declare function primeUser(shell: Shell): Promise<void>;
 /** Kick off `me()` lazily (a shell that was never primed) and cache a suspense cell. */
 export declare function loadUser(shell: Shell): UserEntry;
-//# sourceMappingURL=user.store.d.ts.map

package/dist/auth/act-as.context.d.ts

@@ -20,4 +20,3 @@ export interface ActAsProps {
 }
 /** Bind a subtree to an explicitly supplied authenticated Kernel capability. */
 export declare function ActAs({ client, fallback, children }: ActAsProps): ReactElement | null;
-//# sourceMappingURL=act-as.context.d.ts.map

package/dist/auth/auth.hook.d.ts

@@ -1,4 +1,3 @@
 import type { AuthApi } from '@astrale-os/sdk/auth';
 /** The exact Client Auth capability for the effective subtree principal. */
 export declare function useAuth(): AuthApi;
-//# sourceMappingURL=auth.hook.d.ts.map

package/dist/auth/can.hook.d.ts

@@ -9,4 +9,3 @@ export type PolicyObject = NodeId | {
  * invoked callable remains the authorization enforcement point.
  */
 export declare function useCan(policy: PathLike | PolicyRef | null | undefined, object: PolicyObject | null | undefined): boolean | undefined;
-//# sourceMappingURL=can.hook.d.ts.map

package/dist/auth/index.d.ts

@@ -4,4 +4,3 @@ export { useAuth } from './auth.hook.js';
 export { useCan } from './can.hook.js';
 export type { PolicyObject } from './can.hook.js';
 export { useSelf } from './self.hook.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/auth/self.hook.d.ts

@@ -1,3 +1,2 @@
 import type { Identity } from '@astrale-os/sdk/auth';
 export declare function useSelf(): Identity;
-//# sourceMappingURL=self.hook.d.ts.map

package/dist/auth/session-kernel.d.ts

@@ -1,3 +1,2 @@
 import type { KernelClient } from '@astrale-os/shell';
 export declare function useSessionKernel(): KernelClient;
-//# sourceMappingURL=session-kernel.d.ts.map

package/dist/components/astrale.d.ts

@@ -11,4 +11,3 @@ export interface AstraleProps {
 }
 /** Complete Astrale runtime root without taking ownership of application routing. */
 export declare function Astrale(props: AstraleProps): ReactElement;
-//# sourceMappingURL=astrale.d.ts.map

package/dist/components/boundaries.d.ts

@@ -44,4 +44,3 @@ export declare function CredentialBoundary(props: {
     readonly children: ReactNode;
     readonly fallback?: (credential: CredentialSnapshot) => ReactNode;
 }): ReactElement;
-//# sourceMappingURL=boundaries.d.ts.map

package/dist/components/can.d.ts

@@ -8,4 +8,3 @@ export declare function Can(props: {
     readonly children: ReactNode;
     readonly fallback?: ReactNode;
 }): ReactElement;
-//# sourceMappingURL=can.d.ts.map

package/dist/components/index.d.ts

@@ -3,4 +3,3 @@ export { ConnectionBoundary, CredentialBoundary, defaultViewError, defaultViewLo
 export type { ViewErrorBoundaryProps } from './boundaries.js';
 export { Astrale } from './astrale.js';
 export type { AstraleProps } from './astrale.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/graph/action.d.ts

@@ -19,4 +19,3 @@ export interface Action<A extends unknown[], R> {
  * fields are re-stamped each render, so reads stay current across settlements.
  */
 export declare function useAction<A extends unknown[], R>(fn: (...args: A) => Promise<R>): Action<A, R>;
-//# sourceMappingURL=action.d.ts.map

package/dist/graph/async.d.ts

@@ -8,4 +8,3 @@ export interface AsyncResource<T> extends ReadState {
  * retained through a pending refetch or a failure (§1.1).
  */
 export declare function useAsyncResource<T>(load: (() => Promise<T>) | null, empty: T, deps: readonly unknown[]): AsyncResource<T>;
-//# sourceMappingURL=async.d.ts.map

package/dist/graph/call/call.hook.d.ts

@@ -8,4 +8,3 @@ export interface CallOptions extends SessionRequestOptions {
 export type CallResult = Value;
 export declare function useCall(call: Call | null, options?: CallOptions): Action<[], CallResult>;
 export declare function useCall<A extends unknown[]>(author: ((...args: A) => Call) | null, options?: CallOptions): Action<A, CallResult>;
-//# sourceMappingURL=call.hook.d.ts.map

package/dist/graph/call/stream.hook.d.ts

@@ -17,4 +17,3 @@ export interface StreamHandle<A extends unknown[] = unknown[], T = StreamItem> {
     cancel(): void;
 }
 export declare function useStream<A extends unknown[] = []>(author: CallAuthor<A> | null, options?: StreamOptions): StreamHandle<A, StreamItem>;
-//# sourceMappingURL=stream.hook.d.ts.map

package/dist/graph/graph.context.d.ts

@@ -2,4 +2,3 @@ import type { GraphStore } from '@astrale-os/sdk/client/store';
 /** Optional exact Client GraphStore supplied by an injected Shell adapter. */
 export declare const GraphContext: import("react").Context<GraphStore | null>;
 export type { GraphStore };
-//# sourceMappingURL=graph.context.d.ts.map

package/dist/graph/guards.error.d.ts

@@ -5,4 +5,3 @@ import { ClientError } from '@astrale-os/sdk/client';
 import { NodeUnavailableError } from '@astrale-os/sdk/client';
 export declare function isClientError(error: unknown): error is ClientError;
 export declare function isNodeUnavailableError(error: unknown): error is NodeUnavailableError;
-//# sourceMappingURL=guards.error.d.ts.map

package/dist/graph/index.d.ts

@@ -9,4 +9,3 @@ export type { CallAuthor, KernelStream, StreamHandle, StreamItem, StreamOptions,
 export type { Action } from './action.js';
 export type { GraphStore } from './graph.context.js';
 export { ClientError, NodeUnavailableError, ProtocolError, ResponseError, StaleRouteError, TransportError, isClientError, isNodeUnavailableError, } from './guards.error.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/graph/memory/read/envelope.d.ts

@@ -36,4 +36,3 @@ export declare class UnsupportedFeatureError extends Error {
 }
 export declare function idleReadState(): ReadState;
 export declare function unsupportedReadState(feature: string): ReadState;
-//# sourceMappingURL=envelope.d.ts.map

package/dist/graph/memory/read/idle.d.ts

@@ -1,4 +1,3 @@
 import type { ReadState } from './envelope.js';
 export declare function isIdleInput(value: unknown): value is null | undefined;
 export declare function idleReadState(): ReadState;
-//# sourceMappingURL=idle.d.ts.map

package/dist/graph/query-definition.hook.d.ts

@@ -1,4 +1,5 @@
 import type { QueryDefinition } from '@astrale-os/sdk/query';
+import type { Domain } from '@astrale-os/sdk/schema';
 import type { GraphResource } from './resource.js';
 export interface QueryResourceOptions {
     readonly keepPrevious?: boolean;
@@ -6,5 +7,4 @@ export interface QueryResourceOptions {
     readonly refreshWhen?: 'always' | 'visible';
 }
 /** Execute one named SDK Query definition exclusively through the current GraphStore. */
-export declare function useQuery<Input, Output>(definition: QueryDefinition<Input, Output> | null, input: Input, options?: QueryResourceOptions): GraphResource<Output>;
-//# sourceMappingURL=query-definition.hook.d.ts.map
+export declare function useQuery<DomainValue extends Domain, Input, Output>(definition: QueryDefinition<DomainValue, Input, Output> | null, input: Input, options?: QueryResourceOptions): GraphResource<Output>;

package/dist/graph/query-definition.hook.js

@@ -1,9 +1,11 @@
 import { executeQuery } from '@astrale-os/sdk/query';
 import { useCallback, useEffect, useMemo, useRef, useSyncExternalStore } from 'react';
+import { useExecutionDomain } from '../schema/domain.context.js';
 import { retainRefreshScheduler } from './resource.js';
 import { useGraphStore } from './store.js';
 class DefinitionObserver {
     store;
+    domain;
     definition;
     input;
     listeners = new Set();
@@ -14,8 +16,9 @@ class DefinitionObserver {
     pending = null;
     started = false;
     rerunQueued = false;
-    constructor(store, definition, input) {
+    constructor(store, domain, definition, input) {
         this.store = store;
+        this.domain = domain;
         this.definition = definition;
         this.input = input;
     }
@@ -50,7 +53,7 @@ class DefinitionObserver {
             touched.push(Object.freeze({ ast, options }));
             return this.store.read(ast, { ...options, freshness });
         };
-        const running = executeQuery({ query: execute }, this.definition, this.input)
+        const running = executeQuery({ query: execute }, this.domain, this.definition, this.input)
             .then((data) => {
             if (!this.started || generation !== this.generation)
                 return;
@@ -114,14 +117,15 @@ class DefinitionObserver {
 /** Execute one named SDK Query definition exclusively through the current GraphStore. */
 export function useQuery(definition, input, options = {}) {
     const store = useGraphStore();
+    const domain = useExecutionDomain();
     const inputIdentity = stableIdentity(input);
-    const observer = useMemo(() => (definition === null ? null : new DefinitionObserver(store, definition, input)), [store, definition, inputIdentity]);
+    const observer = useMemo(() => (definition === null ? null : new DefinitionObserver(store, domain, definition, input)), [store, domain, definition, inputIdentity]);
     const idle = useMemo(() => Object.freeze({ state: 'idle' }), []);
     const subscribe = useCallback((listener) => observer?.subscribe(listener) ?? (() => { }), [observer]);
     const snapshot = useCallback(() => observer?.getSnapshot() ?? idle, [observer, idle]);
     const current = useSyncExternalStore(subscribe, snapshot, snapshot);
     useEffect(() => observer?.start(), [observer]);
-    const identity = definition === null ? 'idle' : `${definition.id}\u0000${inputIdentity}`;
+    const identity = definition === null ? 'idle' : `${definitionIdentity(definition)}\u0000${inputIdentity}`;
     useEffect(() => {
         if (observer === null || options.refreshInterval === undefined)
             return;
@@ -148,6 +152,16 @@ export function useQuery(definition, input, options = {}) {
         more: Object.freeze({ has: false, pending: false, load: () => Promise.resolve() }),
     }), [current, previous, observer]);
 }
+const definitionIdentities = new WeakMap();
+let nextDefinitionIdentity = 1;
+function definitionIdentity(definition) {
+    const retained = definitionIdentities.get(definition);
+    if (retained !== undefined)
+        return retained;
+    const created = nextDefinitionIdentity++;
+    definitionIdentities.set(definition, created);
+    return created;
+}
 function dedupeShapes(input) {
     const seen = new Set();
     return Object.freeze(input.filter(({ ast, options }) => {

package/dist/graph/resource.d.ts

@@ -31,4 +31,3 @@ export interface StoreResourceOptions<Output> {
 /** Adapt exact Store pages into a tear-free React resource without a parallel entity cache. */
 export declare function useStoreResource<Query extends QueryAST, Output>(query: Query | null, pageSize: number, project: (response: StoreQueryResponse<Query>) => Output, options?: StoreResourceOptions<Output>): GraphResource<Output>;
 export declare function retainRefreshScheduler(store: GraphStore, identity: string, refresh: () => Promise<void>, interval: number, when: 'always' | 'visible'): () => void;
-//# sourceMappingURL=resource.d.ts.map

package/dist/graph/store.d.ts

@@ -22,4 +22,3 @@ export declare function retainStore(entry: StoreEntry): () => void;
 /** The exact caller/schema-scoped GraphStore for the current View subtree. */
 export declare function useGraphStore(): GraphStoreValue;
 export {};
-//# sourceMappingURL=store.d.ts.map

package/dist/host/actions.hook.d.ts

@@ -31,4 +31,3 @@ export interface RequestAccessApi {
     readonly supported: boolean;
 }
 export declare function useRequestAccess(): RequestAccessApi;
-//# sourceMappingURL=actions.hook.d.ts.map

package/dist/host/components.d.ts

@@ -12,4 +12,3 @@ export declare function NestedView(props: {
 export declare function RequestAccess(props: {
     readonly children: (request: RequestAccessApi) => ReactNode;
 }): ReactElement;
-//# sourceMappingURL=components.d.ts.map

package/dist/host/index.d.ts

@@ -2,4 +2,3 @@ export { useExternalOpen, useHostCapabilities, useHostDialog, useNotify, useOpen
 export type { ExternalOpenApi, HostDialogApi, NotifyApi, OpenViewApi, RequestAccessApi, } from './actions.hook.js';
 export { HostDialog, NestedView, Notify, RequestAccess } from './components.js';
 export { HostCapabilityUnavailableError } from './actions.hook.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts

@@ -5,8 +5,8 @@ export { ActAs, useAuth, useCan, useSelf } from './auth/index.js';
 export type { ActAsProps, PolicyObject } from './auth/index.js';
 export { ClientError, NodeUnavailableError, ProtocolError, ResponseError, StaleRouteError, TransportError, isClientError, isNodeUnavailableError, useCall, useGraphStore, useQuery, useStream, } from './graph/index.js';
 export type { CallOptions, GraphResource, GraphResourceState, GraphStore, QueryResourceOptions, StreamHandle, StreamOptions, } from './graph/index.js';
-export { RelationUnavailableError, queryRefresh, useAction, useDomain, useDomains, useDynamicDomain, useDynamicObject, useKernel, useMutation, useObject, useRelation, } from './schema/index.js';
-export type { ActionOptions, ActionRefresh, DomainAction, MutationOptions, QueryRefresh, RelationOptions, RelationResource, RelationUnavailable, RichReadOptions, } from './schema/index.js';
+export { DomainProvider, RelationUnavailableError, queryRefresh, useAction, useDomain, useDomains, useDynamicDomain, useDynamicObject, useKernel, useMutation, useObject, useRelation, } from './schema/index.js';
+export type { ActionOptions, ActionRefresh, DomainProviderProps, DomainAction, MutationOptions, QueryRefresh, RelationOptions, RelationResource, RelationUnavailable, RichReadOptions, } from './schema/index.js';
 export { Link, NavigationScope, NavScope, NodeLink, pathParam, ViewLink, defineNavigation, enumParam, location, memoryAdapter, urlAdapter, useAncestors, useLocation, useNavigate, useNavigation, useNavScope, } from './navigation/index.js';
 export type { LinkProps, LocationDefinition, MissingPolicy, NavAdapter, NavLocation, NavScopeHandle, NavScopeProps, NavSnapshot, NavTarget, NavigationDefinition, NavigationParam, NavigationParams, NavigationRoutes, NavigationTarget, NodeLinkProps, Navigate, SerializedLocation, ViewLinkProps, } from './navigation/index.js';
 export { SelectionScope, useSelection } from './selection/index.js';
@@ -29,4 +29,3 @@ export type { PathLike } from '@astrale-os/sdk/graph/path';
 export type { AuthApi, Identity, PolicyDecisionInput } from '@astrale-os/sdk/auth';
 export type { DomainBinding } from '@astrale-os/shell';
 export type { App, CloseResult, CredentialSnapshot, HostCapabilities, IntentRegistry, KernelClient, MountCredential, NodeTarget, Shell, ShellConfig, SpaceNode, UserNode, ViewLocation, ViewPresentation, ViewPresentationRequest, Window, } from '@astrale-os/shell';
-//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -5,7 +5,7 @@ export { ActAs, useAuth, useCan, useSelf } from './auth/index.js';
 // One Store path and named SDK definitions. Raw Query/Mutation builders are intentionally absent.
 export { ClientError, NodeUnavailableError, ProtocolError, ResponseError, StaleRouteError, TransportError, isClientError, isNodeUnavailableError, useCall, useGraphStore, useQuery, useStream, } from './graph/index.js';
 // Rich exact Domain bindings.
-export { RelationUnavailableError, queryRefresh, useAction, useDomain, useDomains, useDynamicDomain, useDynamicObject, useKernel, useMutation, useObject, useRelation, } from './schema/index.js';
+export { DomainProvider, RelationUnavailableError, queryRefresh, useAction, useDomain, useDomains, useDynamicDomain, useDynamicObject, useKernel, useMutation, useObject, useRelation, } from './schema/index.js';
 // Typed navigation and selection.
 export { Link, NavigationScope, NavScope, NodeLink, pathParam, ViewLink, defineNavigation, enumParam, location, memoryAdapter, urlAdapter, useAncestors, useLocation, useNavigate, useNavigation, useNavScope, } from './navigation/index.js';
 export { SelectionScope, useSelection } from './selection/index.js';

package/dist/intents/emit-intent.hook.d.ts

@@ -14,4 +14,3 @@ export interface EmitIntent {
  * without retaining a pending request.
  */
 export declare function useEmitIntent(): EmitIntent;
-//# sourceMappingURL=emit-intent.hook.d.ts.map

package/dist/intents/envelope.d.ts

@@ -18,4 +18,3 @@ export declare const NOOP: () => void;
  * relation that the generic union type cannot express.
  */
 export declare function intentMessage(name: string, payload: unknown, correlationId?: string): IntentMessage;
-//# sourceMappingURL=envelope.d.ts.map

package/dist/intents/index.d.ts

@@ -5,4 +5,3 @@ export type { EmitIntent } from './emit-intent.hook.js';
 export { useSendIntent } from './send-intent.hook.js';
 export type { SendIntent } from './send-intent.hook.js';
 export type { IntentPayload, IntentReply } from './envelope.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/intents/listen-intent.hook.d.ts

@@ -13,4 +13,3 @@ export interface IntentCtx<K extends keyof IntentRegistry> {
  * answers a correlated request once.
  */
 export declare function useIntent<K extends keyof IntentRegistry>(name: K, handler: (payload: IntentPayload<K>, ctx: IntentCtx<K>) => void | Promise<void>): void;
-//# sourceMappingURL=listen-intent.hook.d.ts.map

package/dist/intents/reply.d.ts

@@ -6,4 +6,3 @@
 import type { Shell } from '@astrale-os/shell';
 /** Deliver a reply to whichever channel the request arrived on. Best-effort. */
 export declare function sendReply(shell: Shell, sender: string, correlationId: string, result: unknown): void;
-//# sourceMappingURL=reply.d.ts.map

package/dist/intents/resolve-intent-target.d.ts

@@ -9,4 +9,3 @@ export type IntentTarget = {
     readonly reason: string;
 };
 export declare function resolveIntentTarget(shell: Shell, to: string | undefined): IntentTarget;
-//# sourceMappingURL=resolve-intent-target.d.ts.map

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

@@ -7,4 +7,3 @@ export interface SendIntent {
     }): Promise<IntentReply<K>>;
 }
 export declare function useSendIntent(): SendIntent;
-//# sourceMappingURL=send-intent.hook.d.ts.map

package/dist/navigation/adapters/adapter.d.ts

@@ -17,4 +17,3 @@ export interface NavAdapter {
     subscribe(onExternalChange: () => void): () => void;
     href?(loc: SerializedLocation): string;
 }
-//# sourceMappingURL=adapter.d.ts.map

package/dist/navigation/adapters/memory.adapter.d.ts

@@ -6,4 +6,3 @@ import type { SerializedLocation } from '../history.js';
 import type { NavAdapter } from './adapter.js';
 /** In-memory adapter — the default scope backing (per-pane state, no URL). */
 export declare function memoryAdapter(initial?: SerializedLocation): NavAdapter;
-//# sourceMappingURL=memory.adapter.d.ts.map

package/dist/navigation/adapters/url.adapter.d.ts

@@ -3,4 +3,3 @@ import type { NavAdapter } from './adapter.js';
 export declare function urlAdapter(opts?: {
     param?: string;
 }): NavAdapter;
-//# sourceMappingURL=url.adapter.d.ts.map

package/dist/navigation/codec.d.ts

@@ -57,4 +57,3 @@ export declare function useNavigation<Routes extends NavigationRoutes>(navigatio
 }>;
 export type NavigationTarget<Definition> = Definition extends NavigationDefinition<infer Routes> ? RouteTarget<Routes> : never;
 export {};
-//# sourceMappingURL=codec.d.ts.map

package/dist/navigation/history.d.ts

@@ -62,4 +62,3 @@ export declare function seedEntries(fromAdapter: SerializedLocation | null, rest
     entries: SerializedLocation[];
     cursor: number;
 };
-//# sourceMappingURL=history.d.ts.map

package/dist/navigation/hooks/ancestors.hook.d.ts

@@ -8,4 +8,3 @@ import type { ReadState } from '../../graph/memory/read/envelope.js';
 export declare function useAncestors(_node?: Node | PathLike): ReadState & {
     readonly chain: readonly Node[];
 };
-//# sourceMappingURL=ancestors.hook.d.ts.map

package/dist/navigation/hooks/location.hook.d.ts

@@ -1,4 +1,3 @@
 import type { NavLocation } from '../location.js';
 /** The nearest scope's live location. Throws outside any {@link NavScope}. */
 export declare function useLocation(): NavLocation;
-//# sourceMappingURL=location.hook.d.ts.map

package/dist/navigation/hooks/navigate.hook.d.ts

@@ -9,4 +9,3 @@ export declare function useNavigate(): Navigate;
  * only when navigation availability changes.
  */
 export declare function useNavigateHandle(ctx: NavCtx): Navigate;
-//# sourceMappingURL=navigate.hook.d.ts.map

package/dist/navigation/hooks/scope.hook.d.ts

@@ -9,4 +9,3 @@ export interface NavScopeHandle {
 }
 /** The nearest scope, for chrome/persistence (API §8.2). Throws outside a scope. */
 export declare function useNavScope(): NavScopeHandle;
-//# sourceMappingURL=scope.hook.d.ts.map

package/dist/navigation/index.d.ts

@@ -15,4 +15,3 @@ export type { NavAdapter } from './adapters/adapter.js';
 export type { NavLocation } from './location.js';
 export type { NavSnapshot, SerializedLocation } from './history.js';
 export type { NavTarget } from './snapshot.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/navigation/link.d.ts

@@ -20,4 +20,3 @@ export type NodeLinkProps = Omit<LinkProps, 'to'> & {
 };
 /** Canonical node-only link; use ViewLink when a View/params contract exists. */
 export declare function NodeLink(props: NodeLinkProps): ReactElement;
-//# sourceMappingURL=link.d.ts.map

package/dist/navigation/location.d.ts

@@ -18,4 +18,3 @@ export interface NavLocation {
 export declare const IDLE_LOCATION: NavLocation;
 export declare function buildLocation(entry: SerializedLocation | null, result: PointResult | null): NavLocation;
 export type { Node, NodeId };
-//# sourceMappingURL=location.d.ts.map

package/dist/navigation/scope.context.d.ts

@@ -52,4 +52,3 @@ export interface NavScopeProps {
 }
 export declare function NavScope(props: NavScopeProps): ReactElement;
 export {};
-//# sourceMappingURL=scope.context.d.ts.map

package/dist/navigation/snapshot.d.ts

@@ -14,4 +14,3 @@ export type NavTarget = PathLike | Node | {
 export declare function serializeTarget(target: NavTarget): SerializedLocation;
 /** Drop restored entries that no longer resolve under the authenticated Graph capability. */
 export declare function revalidateAndPrune(history: NavHistory, store: GraphStore, shell: Shell): Promise<boolean>;
-//# sourceMappingURL=snapshot.d.ts.map

package/dist/navigation/view-key.d.ts

@@ -1,3 +1,2 @@
 import type { Key } from '@astrale-os/sdk/schema';
 export declare function viewKey(input: string): Key.View;
-//# sourceMappingURL=view-key.d.ts.map

package/dist/schema/action.hook.d.ts

@@ -1,6 +1,7 @@
 import type { BoundNodeFor } from '@astrale-os/sdk/client';
 import type { SessionRequestOptions } from '@astrale-os/sdk/client/session';
-import type { QueryAST } from '@astrale-os/sdk/query';
+import type { QueryAST, QueryDefinition } from '@astrale-os/sdk/query';
+import type { Domain } from '@astrale-os/sdk/schema';
 import type { CallableInputOf, CallableResultOf, MethodOwnerKeyOf, MethodInheritance, ResolvedFunction, ResolvedMethod } from '@astrale-os/sdk/schema';
 type ExecutableInheritance = Exclude<MethodInheritance, 'abstract'>;
 type InstanceMethod = ResolvedMethod<unknown, unknown, false, ExecutableInheritance>;
@@ -10,23 +11,15 @@ type MethodReceiver<C extends InstanceMethod> = BoundNodeFor<MethodOwnerKeyOf<C>
 declare const QUERY_REFRESH: unique symbol;
 export interface QueryRefresh {
     readonly id: string;
-    readonly [QUERY_REFRESH]: () => {
+    readonly [QUERY_REFRESH]: (domain: Domain) => {
         readonly ast: QueryAST;
         readonly page: Readonly<{
             readonly size: number;
         }>;
     };
 }
-type RefreshableQuery<Input, Query extends QueryAST> = {
-    readonly id: string;
-    readonly page: Readonly<{
-        readonly size: number;
-    }>;
-    prepare?(input: Input): Input;
-    build(input: Input): Query;
-};
 /** Pair one exact named Query definition with its admitted input for targeted invalidation. */
-export declare function queryRefresh<Input, Query extends QueryAST>(definition: RefreshableQuery<Input, Query>, input: Input): QueryRefresh;
+export declare function queryRefresh<DomainValue extends Domain, Input, Output>(definition: QueryDefinition<DomainValue, Input, Output>, input: Input): QueryRefresh;
 export type ActionRefresh = 'all' | 'none' | {
     readonly queries: readonly QueryRefresh[];
 };
@@ -45,4 +38,3 @@ export interface DomainAction<Args extends unknown[], Result> {
 /** Invoke one schema-declared Function or Method and invalidate Store by explicit policy. */
 export declare function useAction<C extends Callable>(callable: C, options?: ActionOptions): DomainAction<ActionArgs<C>, CallableResultOf<C>>;
 export {};
-//# sourceMappingURL=action.hook.d.ts.map

package/dist/schema/action.hook.js

@@ -1,18 +1,26 @@
 import { reference } from '@astrale-os/sdk/client/session';
 import { Path } from '@astrale-os/sdk/graph/path';
+import { realizeQuery } from '@astrale-os/sdk/query';
 import { useCallback, useMemo, useRef } from 'react';
 import { useSessionKernel } from '../auth/session-kernel.js';
 import { useAction as useAsyncAction } from '../graph/action.js';
 import { useGraphStore } from '../graph/store.js';
 import { bindingFor } from './domain.hook.js';
 const QUERY_REFRESH = Symbol('shell-react.query-refresh');
+const queryRefreshIdentities = new WeakMap();
+let nextQueryRefreshIdentity = 0;
 /** Pair one exact named Query definition with its admitted input for targeted invalidation. */
 export function queryRefresh(definition, input) {
+    const id = queryRefreshIdentity(definition);
     return Object.freeze({
-        id: definition.id,
-        [QUERY_REFRESH]: () => {
-            const prepared = definition.prepare?.(input) ?? input;
-            return Object.freeze({ ast: definition.build(prepared), page: definition.page });
+        id,
+        [QUERY_REFRESH]: (domain) => {
+            const realized = realizeQuery(definition, domain);
+            if (realized.kind !== 'single') {
+                throw new TypeError('Targeted refresh requires a single Query recipe.');
+            }
+            const prepared = realized.prepare?.(input) ?? input;
+            return Object.freeze({ ast: realized.build(prepared), page: realized.page });
         },
     });
 }
@@ -40,7 +48,7 @@ export function useAction(callable, options = {}) {
                 store.invalidate();
             else if (refresh !== 'none') {
                 refresh.queries.forEach((query) => {
-                    const target = query[QUERY_REFRESH]();
+                    const target = query[QUERY_REFRESH](bindingRef.current.domain);
                     store.invalidate(target.ast, { page: target.page });
                 });
             }
@@ -75,3 +83,11 @@ function isInstanceMethod(callable) {
 function receiverPath(receiver) {
     return Path.id(receiver.id);
 }
+function queryRefreshIdentity(definition) {
+    const current = queryRefreshIdentities.get(definition);
+    if (current !== undefined)
+        return current;
+    const created = `query-${++nextQueryRefreshIdentity}`;
+    queryRefreshIdentities.set(definition, created);
+    return created;
+}

package/dist/schema/domain.context.d.ts

@@ -0,0 +1,10 @@
+import type { Domain } from '@astrale-os/sdk/schema';
+import type { schema } from '@astrale-os/sdk/schema';
+import type { ReactElement, ReactNode } from 'react';
+export interface DomainProviderProps<Schema extends schema.DomainSchema> {
+    readonly schema: Schema;
+    readonly children: ReactNode;
+}
+/** Resolve one exact installed Domain for every projected recipe in the React subtree. */
+export declare function DomainProvider<const Schema extends schema.DomainSchema>(props: DomainProviderProps<Schema>): ReactElement;
+export declare function useExecutionDomain<DomainValue extends Domain>(): DomainValue;

package/dist/schema/domain.context.js

@@ -0,0 +1,17 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext } from 'react';
+import { useDomain } from './domain.hook.js';
+const DomainContext = createContext(null);
+DomainContext.displayName = 'AstraleDomainContext';
+/** Resolve one exact installed Domain for every projected recipe in the React subtree. */
+export function DomainProvider(props) {
+    const binding = useDomain(props.schema);
+    return _jsx(DomainContext.Provider, { value: binding.domain, children: props.children });
+}
+export function useExecutionDomain() {
+    const domain = useContext(DomainContext);
+    if (domain === null) {
+        throw new Error('Projected Query and Mutation hooks require a surrounding DomainProvider.');
+    }
+    return domain;
+}

package/dist/schema/domain.hook.d.ts

@@ -12,4 +12,3 @@ export declare function useDomains<const Schemas extends Readonly<Record<string,
     readonly [Name in keyof Schemas]: DomainBinding<Schemas[Name]>;
 };
 export declare function bindingFor(value: object): DomainBinding;
-//# sourceMappingURL=domain.hook.d.ts.map

package/dist/schema/index.d.ts

@@ -1,5 +1,7 @@
 export { useKernel } from './kernel.hook.js';
 export { useDomain, useDomains, useDynamicDomain } from './domain.hook.js';
+export { DomainProvider } from './domain.context.js';
+export type { DomainProviderProps } from './domain.context.js';
 export { queryRefresh, useAction } from './action.hook.js';
 export type { ActionOptions, ActionRefresh, DomainAction, QueryRefresh } from './action.hook.js';
 export { useMutation } from './mutation.hook.js';
@@ -8,4 +10,3 @@ export { useDynamicObject, useObject } from './object.hook.js';
 export type { RichReadOptions } from './object.hook.js';
 export { RelationUnavailableError, useRelation } from './relation.hook.js';
 export type { RelationOptions, RelationResource, RelationUnavailable } from './relation.hook.js';
-//# sourceMappingURL=index.d.ts.map