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

package/dist/schema/index.js

@@ -1,5 +1,6 @@
 export { useKernel } from './kernel.hook.js';
 export { useDomain, useDomains, useDynamicDomain } from './domain.hook.js';
+export { DomainProvider } from './domain.context.js';
 export { queryRefresh, useAction } from './action.hook.js';
 export { useMutation } from './mutation.hook.js';
 export { useDynamicObject, useObject } from './object.hook.js';

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

@@ -2,4 +2,3 @@ import type { DomainBinding } from '@astrale-os/shell';
 import { KernelSchema } from '@astrale-os/sdk/schema';
 /** The verified, exactly typed Kernel Domain binding. */
 export declare function useKernel(): DomainBinding<typeof KernelSchema>;
-//# sourceMappingURL=kernel.hook.d.ts.map

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

@@ -1,9 +1,9 @@
 import type { Mutation } from '@astrale-os/sdk/mutation';
+import type { Domain } from '@astrale-os/sdk/schema';
 import type { DomainAction } from './action.hook.js';
 export interface MutationOptions {
     readonly optimistic?: boolean;
     readonly onError?: (error: unknown) => void;
 }
 /** Execute one named SDK Mutation definition through GraphStore optimism/invalidation. */
-export declare function useMutation<Input, Output>(definition: Mutation<Input, Output>, options?: MutationOptions): DomainAction<[Input], Output>;
-//# sourceMappingURL=mutation.hook.d.ts.map
+export declare function useMutation<DomainValue extends Domain, Input, Output>(definition: Mutation<DomainValue, Input, Output>, options?: MutationOptions): DomainAction<[Input], Output>;

package/dist/schema/mutation.hook.js

@@ -2,9 +2,11 @@ import { executeMutation } from '@astrale-os/sdk/mutation';
 import { useCallback, useMemo, useRef } from 'react';
 import { useAction as useAsyncAction } from '../graph/action.js';
 import { useGraphStore } from '../graph/store.js';
+import { useExecutionDomain } from './domain.context.js';
 /** Execute one named SDK Mutation definition through GraphStore optimism/invalidation. */
 export function useMutation(definition, options = {}) {
     const store = useGraphStore();
+    const domain = useExecutionDomain();
     const definitionRef = useRef(definition);
     definitionRef.current = definition;
     const optionsRef = useRef(options);
@@ -12,16 +14,17 @@ export function useMutation(definition, options = {}) {
     const run = useCallback(async (input) => {
         try {
             return await executeMutation({
-                mutate: (ast) => store.mutate(ast, {
+                mutate: (ast, graphOptions) => store.mutate(ast, {
+                    ...graphOptions,
                     optimistic: optionsRef.current.optimistic ?? true,
                 }),
-            }, definitionRef.current, input);
+            }, domain, definitionRef.current, input);
         }
         catch (error) {
             optionsRef.current.onError?.(error);
             throw error;
         }
-    }, [store]);
+    }, [store, domain]);
     const action = useAsyncAction(run);
     return useMemo(() => project(action), [action]);
 }

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

@@ -10,4 +10,3 @@ export interface RichReadOptions {
 export declare function useObject<Class extends ResolvedClass<'node'>>(definition: Class, target: PathLike | null | undefined, options?: RichReadOptions): GraphResource<BoundNode<Class> | null>;
 /** Explicitly untyped point read for inspectors; it never impersonates `useObject`. */
 export declare function useDynamicObject(target: PathLike | null | undefined, options?: RichReadOptions): GraphResource<Node | null>;
-//# sourceMappingURL=object.hook.d.ts.map

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

@@ -53,4 +53,3 @@ export interface RelationOptions<Role extends EndpointRole, To> {
 /** Traverse one directed resolved Edge Class and bind the selected opposite Nodes. */
 export declare function useRelation<Relation extends ResolvedClass<'edge'>, Role extends EndpointRole, To extends ResolvedClass<'node'>, Source extends ResolvedClass<'node'>>(relation: Relation, source: BoundNode<Source> | null | undefined, options: RelationOptions<Role, To>): RelationResource<BoundNode<To>, EffectiveCardinality<Relation, Role, To>>;
 export {};
-//# sourceMappingURL=relation.hook.d.ts.map

package/dist/selection/index.d.ts

@@ -1,4 +1,3 @@
 export { SelectionScope } from './scope.context.js';
 export type { Selection, SelectionScopeProps } from './scope.context.js';
 export { useSelection } from './selection.hook.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/selection/live.d.ts

@@ -10,4 +10,3 @@ export interface ResolvedSelection {
 }
 /** Resolve selected identities through the authenticated GraphApi; no fake live subscription. */
 export declare function useResolvedNodes(orderedIds: readonly NodeId[]): ResolvedSelection;
-//# sourceMappingURL=live.d.ts.map

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

@@ -23,4 +23,3 @@ export interface SelectionScopeProps {
 }
 export declare const SelectionContext: import("react").Context<Selection | null>;
 export declare function SelectionScope(props: SelectionScopeProps): ReactElement;
-//# sourceMappingURL=scope.context.d.ts.map

package/dist/selection/selection.hook.d.ts

@@ -1,4 +1,3 @@
 import type { Selection } from './scope.context.js';
 /** The nearest selection scope. Throws outside a `<SelectionScope>`. */
 export declare function useSelection(): Selection;
-//# sourceMappingURL=selection.hook.d.ts.map

package/dist/session/boot/boot.d.ts

@@ -4,4 +4,3 @@ export declare function isShellConfig(config: ShellConfig | Shell): config is Sh
 /** Stable ownership key. Capability objects intentionally use reference identity. */
 export declare function configIdentity(config: ShellConfig | Shell): string;
 export declare function resolveSelf(shell: Shell): Promise<SelfNode | null>;
-//# sourceMappingURL=boot.d.ts.map

package/dist/session/boot/ownership.d.ts

@@ -15,4 +15,3 @@ export declare function cancelTeardown(shell: Shell): void;
 /** Defer a shell's dispose one macrotask, resetting the owning ref when it fires. */
 export declare function scheduleTeardown(shell: Shell, ref: BootRef): void;
 export declare function disposeShell(shell: Shell): void;
-//# sourceMappingURL=ownership.d.ts.map

package/dist/session/boot/status.d.ts

@@ -21,4 +21,3 @@ export type BootAction = {
 };
 export declare const INITIAL_BOOT: BootState;
 export declare function bootReducer(state: BootState, action: BootAction): BootState;
-//# sourceMappingURL=status.d.ts.map

package/dist/session/connection/connection.hook.d.ts

@@ -1,3 +1,2 @@
 import type { ConnectionValue } from './connection.store.js';
 export declare function useConnection(): ConnectionValue;
-//# sourceMappingURL=connection.hook.d.ts.map

package/dist/session/connection/connection.store.d.ts

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

package/dist/session/index.d.ts

@@ -6,4 +6,3 @@ export { useKernelInstance } from './kernel-instance.hook.js';
 export type { KernelInstance } from './kernel-instance.hook.js';
 export { useConnection } from './connection/connection.hook.js';
 export type { ConnectionStatus, ConnectionValue } from './connection/connection.store.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/session/kernel-client.hook.d.ts

@@ -6,4 +6,3 @@
 import type { KernelClient } from '@astrale-os/shell';
 /** `shell.kernel` — the raw bound kernel view, untouched (untyped floor). */
 export declare function useKernelClient(): KernelClient;
-//# sourceMappingURL=kernel-client.hook.d.ts.map

package/dist/session/kernel-instance.hook.d.ts

@@ -3,4 +3,3 @@ export interface KernelInstance {
     readonly url: string;
 }
 export declare function useKernelInstance(): KernelInstance;
-//# sourceMappingURL=kernel-instance.hook.d.ts.map

package/dist/session/provider.d.ts

@@ -14,4 +14,3 @@ export interface ShellProviderProps {
 }
 /** Own and initialize exactly one Shell for a React subtree. */
 export declare function ShellProvider(props: ShellProviderProps): ReactElement | null;
-//# sourceMappingURL=provider.d.ts.map

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

@@ -19,4 +19,3 @@ export interface ShellRuntime {
     readonly ownsStore: boolean;
 }
 export declare const ShellContext: import("react").Context<ShellRuntime | null>;
-//# sourceMappingURL=session.context.d.ts.map

package/dist/session/shell.hook.d.ts

@@ -1,4 +1,3 @@
 import type { Shell } from '@astrale-os/shell';
 /** The live shell for this subtree. Throws outside a `<ShellProvider>`. */
 export declare function useShell(): Shell;
-//# sourceMappingURL=shell.hook.d.ts.map

package/dist/window/adopt.d.ts

@@ -23,4 +23,3 @@ export interface AdoptStash {
 }
 /** The pending-adoption registry — one per stage hub. */
 export declare function createAdoptStash(): AdoptStash;
-//# sourceMappingURL=adopt.d.ts.map

package/dist/window/hooks/close-guard.hook.d.ts

@@ -3,4 +3,3 @@ export type CloseVerdict = 'ack' | 'refuse' | {
 };
 export type CloseGuard = () => CloseVerdict | Promise<CloseVerdict>;
 export declare function useCloseGuard(guard: CloseGuard): void;
-//# sourceMappingURL=close-guard.hook.d.ts.map

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

@@ -8,4 +8,3 @@ import type { GraphResource } from '../../graph/resource.js';
 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/views-for.hook.d.ts

@@ -6,4 +6,3 @@ export interface ViewsForResult extends ReadState {
     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/window.hook.d.ts

@@ -1,4 +1,3 @@
 import type { WindowView } from '../hub.js';
 /** One window's live phase + shell `Window` (null id / unknown id → no window). */
 export declare function useWindow(windowId: string | null): WindowView;
-//# sourceMappingURL=window.hook.d.ts.map

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

@@ -12,4 +12,3 @@ export interface WindowListEntry {
  * so the derived array is too (no render churn).
  */
 export declare function useWindowList(): readonly WindowListEntry[];
-//# sourceMappingURL=windows.hook.d.ts.map

package/dist/window/host.d.ts

@@ -28,4 +28,3 @@ export interface ViewHostProps {
     style?: CSSProperties;
 }
 export declare const ViewHost: import("react").ForwardRefExoticComponent<ViewHostProps & import("react").RefAttributes<ViewHostHandle>>;
-//# sourceMappingURL=host.d.ts.map

package/dist/window/hub.d.ts

@@ -40,4 +40,3 @@ export interface StageHub {
 }
 /** The windows hub for a shell — one per shell object, created on first touch. */
 export declare function getStageHub(shell: Shell): StageHub;
-//# sourceMappingURL=hub.d.ts.map

package/dist/window/index.d.ts

@@ -12,4 +12,3 @@ export { useCloseGuard } from './hooks/close-guard.hook.js';
 export type { CloseGuard, CloseVerdict } from './hooks/close-guard.hook.js';
 export type { WindowState } from './lifecycle/states.js';
 export type { ResolvedView } from '@astrale-os/shell';
-//# sourceMappingURL=index.d.ts.map

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

@@ -5,4 +5,3 @@ import type { ResolvedView } from '@astrale-os/shell';
  * iframe and credential can never be adopted under a different route.
  */
 export declare function viewMountKey(view: ResolvedView): string;
-//# sourceMappingURL=mount.d.ts.map

package/dist/window/lifecycle/states.d.ts

@@ -25,4 +25,3 @@ export type WindowState = {
     readonly windowId: string;
     readonly refusal?: string;
 };
-//# sourceMappingURL=states.d.ts.map

package/dist/window/placement.d.ts

@@ -30,4 +30,3 @@ export declare function createStageController(container: HTMLElement): StageCont
 /** Measure an anchor element's viewport box. */
 export declare function rectOf(el: HTMLElement): SlotRect;
 export declare function sameRect(a: SlotRect, b: SlotRect): boolean;
-//# sourceMappingURL=placement.d.ts.map

package/dist/window/stage.d.ts

@@ -1,3 +1,2 @@
 import type { ReactElement } from 'react';
 export declare function ViewStage(): ReactElement;
-//# sourceMappingURL=stage.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astrale-os/shell-react",
-  "version": "0.3.1",
+  "version": "0.3.2-beta.1",
   "description": "Astrale shell-react — the React face of the shell (provider, hooks, view components)",
   "license": "Apache-2.0",
   "repository": {
@@ -22,42 +22,40 @@
     }
   },
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
   },
   "dependencies": {
-    "jose": "^6.2.3",
-    "zod": "^4.3.6"
+    "@astrale-os/shell": ">=0.4.2-beta <1.0.0",
+    "jose": "^6.2.8",
+    "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@astrale-os/sdk": ">=0.5.0-beta.17 <1.0.0",
+    "@astrale-os/sdk": "0.5.0-beta.32",
     "@testing-library/dom": "^10.4.0",
     "@testing-library/react": "^16.3.0",
-    "@types/node": "^26.0.0",
+    "@types/node": "^26.2.0",
     "@types/react": "^19.2.0",
     "@types/react-dom": "^19.2.0",
-    "@typescript/native-preview": "latest",
-    "@vitejs/plugin-react": "^5.0.4",
+    "@vitejs/plugin-react": "6.0.5",
     "happy-dom": "^20.0.0",
     "react": "^19.2.0",
     "react-dom": "^19.2.0",
-    "typescript": "~6.0.1-rc",
-    "vite": "^7.3.6",
-    "vitest": "^3.2.4",
-    "@astrale-os/shell": "0.4.1"
+    "typescript": "7.0.2",
+    "vite": "8.2.1",
+    "vitest": "4.1.10"
   },
   "peerDependencies": {
-    "@astrale-os/sdk": ">=0.5.0-beta.17 <1.0.0",
-    "@astrale-os/shell": ">=0.3.8-beta.3 <1.0.0",
+    "@astrale-os/sdk": ">=0.5.0-beta.32 <1.0.0",
     "react": ">=18",
     "react-dom": ">=18"
   },
   "scripts": {
     "prebuild": "pnpm clean",
-    "build": "tsgo",
+    "build": "tsc",
     "clean": "rm -rf dist *.tsbuildinfo",
-    "typecheck": "tsgo --noEmit && tsgo --noEmit -p tsconfig.test.json",
+    "typecheck": "tsc --noEmit && tsc --noEmit -p tsconfig.test.json",
     "test": "vitest run",
-    "test:watch": "vitest",
-    "preinstall": "node -e \"try{require('./.check-workspace.cjs')}catch{}\""
+    "test:watch": "vitest"
   }
 }

package/src/graph/query-definition.hook.ts

@@ -1,12 +1,14 @@
 import type { QueryPageRequest } from '@astrale-os/sdk/client'
 import type { GraphStore, StoreQueryResponse, StoreSnapshot } from '@astrale-os/sdk/client/store'
 import type { QueryAST, QueryDefinition } from '@astrale-os/sdk/query'
+import type { Domain } from '@astrale-os/sdk/schema'
 
 import { executeQuery } from '@astrale-os/sdk/query'
 import { useCallback, useEffect, useMemo, useRef, useSyncExternalStore } from 'react'
 
 import type { GraphResource, GraphResourceState } from './resource.js'
 
+import { useExecutionDomain } from '../schema/domain.context.js'
 import { retainRefreshScheduler } from './resource.js'
 import { useGraphStore } from './store.js'
 
@@ -18,7 +20,10 @@ export interface QueryResourceOptions {
 
 interface TouchedShape {
   readonly ast: QueryAST
-  readonly options: { readonly page: QueryPageRequest }
+  readonly options: {
+    readonly page: QueryPageRequest
+    readonly expected?: Domain['closure']
+  }
 }
 
 interface DefinitionSnapshot<Output> {
@@ -27,7 +32,7 @@ interface DefinitionSnapshot<Output> {
   readonly error?: unknown
 }
 
-class DefinitionObserver<Input, Output> {
+class DefinitionObserver<DomainValue extends Domain, Input, Output> {
   private readonly listeners = new Set<() => void>()
   private subscriptions: readonly (() => void)[] = Object.freeze([])
   private touched: readonly TouchedShape[] = Object.freeze([])
@@ -39,7 +44,8 @@ class DefinitionObserver<Input, Output> {
 
   constructor(
     private readonly store: GraphStore,
-    private readonly definition: QueryDefinition<Input, Output>,
+    private readonly domain: DomainValue,
+    private readonly definition: QueryDefinition<DomainValue, Input, Output>,
     private readonly input: Input,
   ) {}
 
@@ -75,12 +81,12 @@ class DefinitionObserver<Input, Output> {
     })
     const execute = async <Ast extends QueryAST>(
       ast: Ast,
-      options: { readonly page: QueryPageRequest },
+      options: { readonly page: QueryPageRequest; readonly expected?: Domain['closure'] },
     ): Promise<StoreQueryResponse<Ast>> => {
       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
         this.touched = dedupeShapes(touched)
@@ -148,16 +154,17 @@ class DefinitionObserver<Input, Output> {
 }
 
 /** Execute one named SDK Query definition exclusively through the current GraphStore. */
-export function useQuery<Input, Output>(
-  definition: QueryDefinition<Input, Output> | null,
+export function useQuery<DomainValue extends Domain, Input, Output>(
+  definition: QueryDefinition<DomainValue, Input, Output> | null,
   input: Input,
   options: QueryResourceOptions = {},
 ): GraphResource<Output> {
   const store = useGraphStore()
+  const domain = useExecutionDomain<DomainValue>()
   const inputIdentity = stableIdentity(input)
   const observer = useMemo(
-    () => (definition === null ? null : new DefinitionObserver(store, definition, input)),
-    [store, definition, inputIdentity],
+    () => (definition === null ? null : new DefinitionObserver(store, domain, definition, input)),
+    [store, domain, definition, inputIdentity],
   )
   const idle = useMemo<DefinitionSnapshot<Output>>(() => Object.freeze({ state: 'idle' }), [])
   const subscribe = useCallback(
@@ -168,7 +175,8 @@ export function useQuery<Input, Output>(
   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
     return retainRefreshScheduler(
@@ -210,6 +218,17 @@ export function useQuery<Input, Output>(
   )
 }
 
+const definitionIdentities = new WeakMap<object, number>()
+let nextDefinitionIdentity = 1
+
+function definitionIdentity(definition: object): number {
+  const retained = definitionIdentities.get(definition)
+  if (retained !== undefined) return retained
+  const created = nextDefinitionIdentity++
+  definitionIdentities.set(definition, created)
+  return created
+}
+
 function dedupeShapes(input: readonly TouchedShape[]): readonly TouchedShape[] {
   const seen = new Set<string>()
   return Object.freeze(

package/src/index.ts

@@ -39,6 +39,7 @@ export type {
 
 // Rich exact Domain bindings.
 export {
+  DomainProvider,
   RelationUnavailableError,
   queryRefresh,
   useAction,
@@ -54,6 +55,7 @@ export {
 export type {
   ActionOptions,
   ActionRefresh,
+  DomainProviderProps,
   DomainAction,
   MutationOptions,
   QueryRefresh,

package/src/schema/action.hook.ts

@@ -1,7 +1,8 @@
 import type { BoundNodeFor } from '@astrale-os/sdk/client'
 import type { SessionRequestOptions } from '@astrale-os/sdk/client/session'
 import type { NodeId } from '@astrale-os/sdk/graph/node'
-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,
@@ -13,6 +14,7 @@ import type {
 
 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 type { Action as AsyncAction } from '../graph/action.js'
@@ -33,29 +35,30 @@ const QUERY_REFRESH = Symbol('shell-react.query-refresh')
 
 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
-}
+const queryRefreshIdentities = new WeakMap<object, string>()
+let nextQueryRefreshIdentity = 0
 
 /** Pair one exact named Query definition with its admitted input for targeted invalidation. */
-export function queryRefresh<Input, Query extends QueryAST>(
-  definition: RefreshableQuery<Input, Query>,
+export function queryRefresh<DomainValue extends Domain, Input, Output>(
+  definition: QueryDefinition<DomainValue, Input, Output>,
   input: Input,
 ): QueryRefresh {
+  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: Domain) => {
+      const realized = realizeQuery(definition, domain as DomainValue)
+      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 })
     },
   })
 }
@@ -120,7 +123,7 @@ export function useAction<C extends Callable>(
         if (refresh === 'all') 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 })
           })
         }
@@ -161,3 +164,11 @@ function isInstanceMethod(callable: Callable): callable is InstanceMethod {
 function receiverPath(receiver: Receiver): Path {
   return Path.id(receiver.id)
 }
+
+function queryRefreshIdentity(definition: object): string {
+  const current = queryRefreshIdentities.get(definition)
+  if (current !== undefined) return current
+  const created = `query-${++nextQueryRefreshIdentity}`
+  queryRefreshIdentities.set(definition, created)
+  return created
+}

package/src/schema/domain.context.tsx

@@ -0,0 +1,31 @@
+import type { Domain } from '@astrale-os/sdk/schema'
+import type { schema } from '@astrale-os/sdk/schema'
+import type { ReactElement, ReactNode } from 'react'
+
+import { createContext, useContext } from 'react'
+
+import { useDomain } from './domain.hook.js'
+
+const DomainContext = createContext<Domain | null>(null)
+DomainContext.displayName = 'AstraleDomainContext'
+
+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 function DomainProvider<const Schema extends schema.DomainSchema>(
+  props: DomainProviderProps<Schema>,
+): ReactElement {
+  const binding = useDomain(props.schema)
+  return <DomainContext.Provider value={binding.domain}>{props.children}</DomainContext.Provider>
+}
+
+export function useExecutionDomain<DomainValue extends Domain>(): DomainValue {
+  const domain = useContext(DomainContext)
+  if (domain === null) {
+    throw new Error('Projected Query and Mutation hooks require a surrounding DomainProvider.')
+  }
+  return domain as DomainValue
+}

package/src/schema/index.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'

package/src/schema/mutation.hook.ts

@@ -1,4 +1,5 @@
 import type { Mutation } from '@astrale-os/sdk/mutation'
+import type { Domain } from '@astrale-os/sdk/schema'
 
 import { executeMutation } from '@astrale-os/sdk/mutation'
 import { useCallback, useMemo, useRef } from 'react'
@@ -8,6 +9,7 @@ import type { DomainAction } from './action.hook.js'
 
 import { useAction as useAsyncAction } from '../graph/action.js'
 import { useGraphStore } from '../graph/store.js'
+import { useExecutionDomain } from './domain.context.js'
 
 export interface MutationOptions {
   readonly optimistic?: boolean
@@ -15,11 +17,12 @@ export interface MutationOptions {
 }
 
 /** Execute one named SDK Mutation definition through GraphStore optimism/invalidation. */
-export function useMutation<Input, Output>(
-  definition: Mutation<Input, Output>,
+export function useMutation<DomainValue extends Domain, Input, Output>(
+  definition: Mutation<DomainValue, Input, Output>,
   options: MutationOptions = {},
 ): DomainAction<[Input], Output> {
   const store = useGraphStore()
+  const domain = useExecutionDomain<DomainValue>()
   const definitionRef = useRef(definition)
   definitionRef.current = definition
   const optionsRef = useRef(options)
@@ -29,11 +32,13 @@ export function useMutation<Input, Output>(
       try {
         return await executeMutation(
           {
-            mutate: (ast) =>
+            mutate: (ast, graphOptions) =>
               store.mutate(ast, {
+                ...graphOptions,
                 optimistic: optionsRef.current.optimistic ?? true,
               }),
           },
+          domain,
           definitionRef.current,
           input,
         )
@@ -42,7 +47,7 @@ export function useMutation<Input, Output>(
         throw error
       }
     },
-    [store],
+    [store, domain],
   )
   const action = useAsyncAction(run)
   return useMemo(() => project(action), [action])

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

@@ -1 +0,0 @@
-{"version":3,"file":"app-host.d.ts","sourceRoot":"","sources":["../../../src/application/apps/app-host.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,wBAAwB,CAAA;AACjD,OAAO,KAAK,EAAE,GAAG,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAC5E,OAAO,KAAK,EAAE,aAAa,EAAgB,SAAS,EAAE,MAAM,OAAO,CAAA;AAInE,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAA;AAKnE,MAAM,MAAM,oBAAoB,GAC5B,WAAW,GACX;IAAE,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;CAAE,GAC7B;IAAE,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;CAAE,CAAA;AAEjC,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,GAAG,GAAG,GAAG,CAAC,MAAM,CAAA;IACrB,gDAAgD;IAChD,IAAI,CAAC,EAAE,YAAY,CAAA;IACnB,YAAY,CAAC,EAAE,gBAAgB,CAAA;IAC/B,OAAO,CAAC,EAAE,aAAa,CAAA;IACvB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,SAAS,CAAA;IACrD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,aAAa,CAAA;CACtB;AAED,uFAAuF;AACvF,eAAO,MAAM,OAAO,yGAoDnB,CAAA"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"app-logo.d.ts","sourceRoot":"","sources":["../../../src/application/apps/app-logo.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAInE,MAAM,WAAW,YAAY;IAC3B,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,qEAAqE;IACrE,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,aAAa,CAAA;IACrB,yEAAyE;IACzE,QAAQ,CAAC,EAAE,SAAS,CAAA;CACrB;AAED,wBAAgB,OAAO,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,YAAY,GAAG,YAAY,CAiB7F"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"apps.hook.d.ts","sourceRoot":"","sources":["../../../src/application/apps/apps.hook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAA;AAI5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAA;AAQpE,MAAM,WAAW,UAAW,SAAQ,SAAS;IAC3C,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,EAAE,CAAA;CAC9B;AAED,qFAAqF;AACrF,wBAAgB,OAAO,IAAI,UAAU,CAoBpC"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"open-app.hook.d.ts","sourceRoot":"","sources":["../../../src/application/apps/open-app.hook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,wBAAwB,CAAA;AACjD,OAAO,KAAK,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAE1D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AAInD,0DAA0D;AAC1D,wBAAgB,UAAU,IAAI,MAAM,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC,CAG5E"}