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

package/dist/schema/bind-read.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"bind-read.d.ts","sourceRoot":"","sources":["../../src/schema/bind-read.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,UAAU,EAAe,MAAM,iCAAiC,CAAA;AAC7F,OAAO,KAAK,EACV,UAAU,EAEV,UAAU,EACX,MAAM,iCAAiC,CAAA;AACxC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAA;AACnD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAA;AAEpD,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,KAAK,EACV,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,SAAS,EACf,MAAM,2BAA2B,CAAA;AAalC,OAAO,KAAK,EAAa,WAAW,EAAE,MAAM,kCAAkC,CAAA;AAC9E,OAAO,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAiBtE,wFAAwF;AACxF,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,SAAS,CAAC,CAAC,CAAC,EACnE,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,EAC3B,IAAI,EAAE,CAAC,EACP,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,SAAS,GAC5B,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAclC;AASD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,SAAS,CAAC,CAAC,CAAC,EACpE,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,EAC3B,IAAI,EAAE,CAAC,EACP,KAAK,EAAE,SAAS,IAAI,EAAE,EACtB,YAAY,UAAQ,GACnB,SAAS,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAuBtC;AAQD,uFAAuF;AACvF,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,EAChD,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,EAC3B,KAAK,EAAE,SAAS,IAAI,EAAE,GACrB,SAAS,YAAY,CAAC,CAAC,CAAC,EAAE,CAiB5B;AAQD,sFAAsF;AACtF,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG;IAAE,MAAM,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAA;CAAE,CAAA;AAkBxE;;;;GAIG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,UAAU,GAAG,IAAI,GAAG,SAAS,EACpC,IAAI,CAAC,EAAE,YAAY,GAClB,UAAU,GAAG,IAAI,CA6BnB;AAID,wBAAgB,OAAO,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,SAAS,CAAC,CAAC,CAAC,EAC9D,MAAM,EAAE,CAAC,EACT,IAAI,EAAE,CAAC,EACP,GAAG,EAAE,YAAY,GAAG,IAAI,GAAG,SAAS,EACpC,IAAI,CAAC,EAAE,WAAW,GACjB,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,CAYvB;AAED,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,SAAS,CAAC,CAAC,CAAC,EAClE,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,EAC1C,IAAI,EAAE,WAAW,GAAG;IAClB,IAAI,EAAE,CAAC,CAAA;IACP,KAAK,CAAC,EAAE,UAAU,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAA;CAC5B,GACA,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAkC3B;AAwBD,uFAAuF;AACvF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CASlD"}

package/dist/schema/bind-read.js

@@ -1,205 +0,0 @@
-import { BindTypeMismatchError, normalizeRef, } from '@astrale-os/kernel-client';
-import { shapeInputToAST, stableStringify, stripCursors } from '@astrale-os/kernel-client/store';
-import { compileDomain } from '@astrale-os/kernel-core/domain';
-/**
- * Binder-over-memory composition (API §6, §1.7) — consumed by the `graph/query/`
- * overloads. Binds wire `Node`s from the shared memory to stable `BoundNode`s
- * (an unchanged wire node re-binds to the SAME instance), and composes those
- * binders with a `useSyncExternalStore` read substrate (`useShape`) into the typed
- * `useNode`/`useChildren` reads. A typed read and its untyped twin ride the SAME
- * memory shape, so they are one cache entry, one liveness, one overlay.
- */
-import { useCallback, useMemo, useRef, useSyncExternalStore } from 'react';
-import { useSessionKernel } from '../auth/session-kernel.js';
-import { idleReadState, isIdleInput } from '../graph/memory/read/idle.js';
-import { useMemory } from '../graph/memory/scope.js';
-import { bindingFor } from './binding.js';
-import { schemaOf, tagSchema } from './tag.js';
-/** Bind one wire node as `type`; stable while the wire node, binding, and type hold. */
-export function useBoundNode(binding, type, wire) {
-    const ref = useRef(null);
-    const node = wire ?? null;
-    let entry = ref.current;
-    if (entry === null || entry.wire !== node || entry.binding !== binding || entry.type !== type) {
-        entry = {
-            wire: node,
-            binding,
-            type,
-            bound: node === null ? null : binding.bind(type, node),
-        };
-        ref.current = entry;
-    }
-    return entry.bound;
-}
-/**
- * Bind many wire nodes as `type`; per-node identity + a stable array on no
- * change. `skipMismatch` drops nodes whose class is not `type` (a mixed-class
- * child set) instead of throwing.
- */
-export function useBoundNodes(binding, type, wires, skipMismatch = false) {
-    const ref = useRef(null);
-    if (ref.current === null || ref.current.binding !== binding || ref.current.type !== type) {
-        ref.current = { binding, type, perNode: new WeakMap(), last: [] };
-    }
-    const cache = ref.current;
-    const next = [];
-    for (const w of wires) {
-        let b = cache.perNode.get(w);
-        if (b === undefined) {
-            try {
-                b = binding.bind(type, w);
-            }
-            catch (error) {
-                if (skipMismatch && error instanceof BindTypeMismatchError)
-                    continue;
-                throw error;
-            }
-            cache.perNode.set(w, b);
-        }
-        next.push(b);
-    }
-    if (sameArray(cache.last, next))
-        return cache.last;
-    cache.last = next;
-    return next;
-}
-/** Bind many wire nodes classlessly (traversal endpoints); per-node + stable array. */
-export function useBoundEndpoints(binding, wires) {
-    const ref = useRef(null);
-    if (ref.current === null || ref.current.binding !== binding) {
-        ref.current = { binding, perNode: new WeakMap(), last: [] };
-    }
-    const cache = ref.current;
-    const next = wires.map((w) => {
-        let b = cache.perNode.get(w);
-        if (b === undefined) {
-            b = binding.bindAny(w);
-            cache.perNode.set(w, b);
-        }
-        return b;
-    });
-    if (sameArray(cache.last, next))
-        return cache.last;
-    cache.last = next;
-    return next;
-}
-function sameArray(a, b) {
-    return a.length === b.length && a.every((x, i) => x === b[i]);
-}
-/** Store-facing options — render-time concerns (`suspend`/`keepPrevious`) stay here. */
-function toStoreOptions(opts) {
-    if (opts === undefined)
-        return undefined;
-    const out = {};
-    if (opts.live !== undefined)
-        out.live = opts.live;
-    if (opts.window !== undefined)
-        out.window = opts.window;
-    if (opts.with !== undefined)
-        out.with = opts.with;
-    return out;
-}
-/** A stable string identity for a (shape, options) pair — the subscription key. */
-function keyOf(shape, opts) {
-    const ast = stripCursors(shapeInputToAST(shape));
-    return `${stableStringify(ast)}|${opts?.live === false ? '0' : '1'}|${opts?.window ?? ''}|${opts?.with ?? ''}`;
-}
-/**
- * Subscribe to a memory shape. `null` shape → idle (`null`, no I/O). A cold
- * shape suspends unless `suspend: false`. The returned `LiveResult` is the
- * unified read envelope — callers project `node`/`children`/`nodes`.
- */
-export function useShape(shape, opts) {
-    const memory = useMemory();
-    const storeOpts = toStoreOptions(opts);
-    const key = isIdleInput(shape) ? null : keyOf(shape, opts);
-    const subscribe = useCallback((onChange) => {
-        if (isIdleInput(shape))
-            return () => { };
-        return memory.subscribe(shape, onChange, storeOpts);
-    }, 
-    // The shape's canonical identity is `key`; the captured `shape` is equivalent.
-    // eslint-disable-next-line react-hooks/exhaustive-deps
-    [memory, key]);
-    const getSnapshot = useCallback(() => (isIdleInput(shape) ? null : memory.getSnapshot(shape, storeOpts)), 
-    // eslint-disable-next-line react-hooks/exhaustive-deps
-    [memory, key]);
-    const snapshot = useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
-    if (!isIdleInput(shape) && opts?.suspend !== false && memory.peek(shape, storeOpts) === null) {
-        // Cold FAILURE (§1.4): a rejected fetch with no data throws to the boundary;
-        // re-throwing the promise would re-arm a fetch each retry (infinite loop).
-        if (snapshot !== null && snapshot.error !== undefined)
-            throw snapshot.error;
-        throw memory.promise(shape, storeOpts);
-    }
-    return snapshot;
-}
-// ── typed reads (schema-first useNode, BoundNode-first useChildren) ──────────────
-export function useNode(schema, type, ref, opts) {
-    const binding = bindingFor(useSessionKernel(), schema, useMemory());
-    const shape = isIdleInput(ref) ? null : normalizeRef(ref);
-    const snap = useShape(shape, opts);
-    const wire = snap?.node ?? null;
-    const bound = useBoundNode(binding, type, wire);
-    if (bound !== null)
-        tagSchema(bound, schema);
-    const live = snap === null ? idleReadState() : readStateOf(snap);
-    return useMemo(() => ({ ...live, node: bound }), [bound, live.pending, live.error, live.live, live.seq]);
-}
-export function useChildren(parent, opts) {
-    const kernel = useSessionKernel();
-    const memory = useMemory();
-    const schema = isIdleInput(parent) ? null : requireSchema(parent);
-    const binding = schema === null ? null : bindingFor(kernel, schema, memory);
-    const parentRef = isIdleInput(parent) ? null : `@${parent.id}`;
-    const classRef = schema === null ? undefined : classRefFor(schema, opts.type);
-    const shape = parentRef === null
-        ? null
-        : (q) => q.from(parentRef).children({
-            ...(classRef !== undefined ? { classes: [classRef] } : {}),
-            ...(opts.order !== undefined ? { order: opts.order } : {}),
-            ...(opts.limit !== undefined ? { limit: opts.limit } : {}),
-        });
-    const snap = useShape(shape, opts);
-    const wires = snap?.children ?? EMPTY;
-    const bound = useBoundNodes((binding ?? UNBOUND), opts.type, binding === null ? EMPTY : wires, true);
-    if (schema !== null)
-        for (const b of bound)
-            tagSchema(b, schema);
-    const live = snap === null ? idleReadState() : readStateOf(snap);
-    const more = snap?.more ?? IDLE_MORE;
-    return useMemo(() => ({ ...live, more, children: bound }), [bound, more, live.pending, live.error, live.live, live.seq]);
-}
-// ── helpers ──────────────────────────────────────────────────────────────────
-const EMPTY = Object.freeze([]);
-const IDLE_MORE = { has: false, load: () => Promise.resolve(), pending: false };
-const UNBOUND = {};
-function readStateOf(snap) {
-    return {
-        pending: snap.pending,
-        error: snap.error,
-        live: snap.live,
-        seq: snap.seq,
-        refetch: snap.refetch,
-    };
-}
-/** Recover the schema a BoundNode was bound under; a clear error if it is untagged. */
-export function requireSchema(node) {
-    const schema = schemaOf(node);
-    if (schema === undefined) {
-        throw new Error('useChildren: the parent was not produced by a shell-react typed binding — ' +
-            'obtain it from useNode / useDomain(schema).bind() so its schema is known.');
-    }
-    return schema;
-}
-const compiledCache = new WeakMap();
-/** The descent class ref for a type name (class or interface), or undefined. */
-function classRefFor(schema, type) {
-    let compiled = compiledCache.get(schema);
-    if (compiled === undefined) {
-        compiled = compileDomain(schema);
-        compiledCache.set(schema, compiled);
-    }
-    const accessor = compiled.$;
-    return accessor.c(type)?.path?.class?.raw ?? accessor.i(type)?.path?.class?.raw;
-}

package/dist/schema/binding.d.ts

@@ -1,21 +0,0 @@
-/**
- * bindingFor(kernel, schema) — memoized `withSchema` handles (API §6). The
- * `withSchema` handle is a *binding*, never a "view". Memoizes
- * `createSchemaBoundView` per (session, schema) so a binding — and the BoundNodes
- * it mints — keep referential identity across renders. Each binding is wrapped so
- * every BoundNode it hands back is schema-tagged (the traversal hooks read it
- * back) and its raw node recorded (the write capability's index).
- */
-import type { FnMap, NodeRefInput, SchemaBoundView } from '@astrale-os/kernel-client';
-import type { GraphMemory } from '@astrale-os/kernel-client/store';
-import type { Schema } from '@astrale-os/kernel-dsl';
-import type { SessionView } from '../auth/act-as.context.js';
-/**
- * Resolve (and memoize) the tagged schema-bound handle for `schema` on `kernel`.
- * `kernel` is the EFFECTIVE dispatch kernel (root or `<ActAs>` — §4); the cache is
- * keyed on it, so an acted-as subtree gets its own memoized bindings for free.
- * `memory` is the SAME scoped memory the read hooks use (1:1 with `kernel`).
- */
-export declare function bindingFor<S extends Schema>(kernel: SessionView, schema: S, memory: GraphMemory): SchemaBoundView<S, FnMap>;
-export type { NodeRefInput };
-//# sourceMappingURL=binding.d.ts.map

package/dist/schema/binding.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"binding.d.ts","sourceRoot":"","sources":["../../src/schema/binding.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AACrF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAA;AAElE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAA;AAIpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AAQ5D;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,EACzC,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,CAAC,EACT,MAAM,EAAE,WAAW,GAClB,eAAe,CAAC,CAAC,EAAE,KAAK,CAAC,CAa3B;AAmGD,YAAY,EAAE,YAAY,EAAE,CAAA"}

package/dist/schema/binding.js

@@ -1,99 +0,0 @@
-import { createSchemaBoundView } from '@astrale-os/kernel-client';
-import { tagSchema } from './tag.js';
-import { recordNode, writableFor } from './write.js';
-/** One tagged binding per (kernel, schema) — shared across the whole tree. */
-const bindingCache = new WeakMap();
-/**
- * Resolve (and memoize) the tagged schema-bound handle for `schema` on `kernel`.
- * `kernel` is the EFFECTIVE dispatch kernel (root or `<ActAs>` — §4); the cache is
- * keyed on it, so an acted-as subtree gets its own memoized bindings for free.
- * `memory` is the SAME scoped memory the read hooks use (1:1 with `kernel`).
- */
-export function bindingFor(kernel, schema, memory) {
-    let bySchema = bindingCache.get(kernel);
-    if (bySchema === undefined) {
-        bySchema = new WeakMap();
-        bindingCache.set(kernel, bySchema);
-    }
-    const cached = bySchema.get(schema);
-    if (cached !== undefined)
-        return cached;
-    const { writable, nodeIndex } = writableFor(kernel, memory);
-    const binding = tagBinding(createSchemaBoundView(writable, schema), schema, nodeIndex);
-    bySchema.set(schema, binding);
-    return binding;
-}
-/**
- * Wrap a binding so `bind`/`bindAny`/`as` outputs carry a schema tag, and every
- * bound wire node is recorded with its class and path (the write cap's index); the
- * class handles and every other member pass straight through.
- */
-function tagBinding(binding, schema, nodeIndex) {
-    let taggedClasses;
-    const handler = {
-        get: (target, prop, receiver) => {
-            const value = Reflect.get(target, prop, receiver);
-            if (prop === 'node' || prop === 'create') {
-                return async (...args) => tagBoundResult(await value(...args), schema, nodeIndex);
-            }
-            if (prop === 'bind') {
-                return (type, node, opts) => {
-                    recordNode(nodeIndex, node);
-                    return tagSchema(value(type, node, opts), schema);
-                };
-            }
-            if (prop === 'bindAny') {
-                return (node) => {
-                    recordNode(nodeIndex, node);
-                    return tagSchema(value(node), schema);
-                };
-            }
-            if (prop === 'classes') {
-                taggedClasses ??= tagClassHandles(value, schema, nodeIndex);
-                return taggedClasses;
-            }
-            if (prop === 'as') {
-                const as = value;
-                return (credential) => tagBinding(as(credential), schema, nodeIndex);
-            }
-            if (prop === 'withSchema') {
-                return (next) => tagBinding(value(next), next, nodeIndex);
-            }
-            return value;
-        },
-    };
-    return new Proxy(binding, handler);
-}
-function tagClassHandles(classes, schema, nodeIndex) {
-    const handles = new Map();
-    return new Proxy(classes, {
-        get(target, prop, receiver) {
-            const cached = handles.get(prop);
-            if (cached !== undefined)
-                return cached;
-            const handle = Reflect.get(target, prop, receiver);
-            if (typeof handle !== 'function')
-                return handle;
-            const tagged = new Proxy(handle, {
-                get(handleTarget, member, handleReceiver) {
-                    const value = Reflect.get(handleTarget, member, handleReceiver);
-                    if (member !== 'get')
-                        return value;
-                    return async (...args) => tagBoundResult(await value(...args), schema, nodeIndex);
-                },
-            });
-            handles.set(prop, tagged);
-            return tagged;
-        },
-    });
-}
-function tagBoundResult(result, schema, nodeIndex) {
-    const nodes = Array.isArray(result) ? result : [result];
-    for (const node of nodes) {
-        if (node !== null && typeof node === 'object') {
-            recordNode(nodeIndex, node);
-            tagSchema(node, schema);
-        }
-    }
-    return result;
-}

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

@@ -1,9 +0,0 @@
-import type { Schema } from '@astrale-os/kernel-dsl';
-import type { Action } from '../graph/action.js';
-import type { FunctionNames, FunctionParams, FunctionResult } from './types.js';
-export interface FunctionOptions {
-    /** Extra failure channel; the action still rejects and records `.error`. */
-    onError?: (error: unknown) => void;
-}
-export declare function useFunction<S extends Schema, F extends FunctionNames<S>>(schema: S, fn: F, opts?: FunctionOptions): Action<[FunctionParams<S, F>], FunctionResult<S, F>>;
-//# sourceMappingURL=function.hook.d.ts.map

package/dist/schema/function.hook.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"function.hook.d.ts","sourceRoot":"","sources":["../../src/schema/function.hook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAA;AAWpD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAK/E,MAAM,WAAW,eAAe;IAC9B,4EAA4E;IAC5E,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;CACnC;AAoBD,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,aAAa,CAAC,CAAC,CAAC,EACtE,MAAM,EAAE,CAAC,EACT,EAAE,EAAE,CAAC,EACL,IAAI,CAAC,EAAE,eAAe,GACrB,MAAM,CAAC,CAAC,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAuBtD"}

package/dist/schema/function.hook.js

@@ -1,40 +0,0 @@
-import { compileDomain } from '@astrale-os/kernel-core/domain';
-/**
- * `useFunction` (API §6) — `useMethod`'s sibling for a domain's top-level
- * standalone functions (the `functions` map of `defineSchema`). Dispatched by the
- * compiled FunctionPath from the compiled-domain accessor, never string-built.
- * Dispatch is correct but not compile-time typed (see the note in schema/types.ts).
- */
-import { useCallback, useMemo, useRef } from 'react';
-import { useAction } from '../graph/action.js';
-import { useDomain } from './domain.hook.js';
-const compiledCache = new WeakMap();
-/** The dispatch path for a standalone function, from the compiled accessor. */
-function functionPathOf(schema, name) {
-    let compiled = compiledCache.get(schema);
-    if (compiled === undefined) {
-        compiled = compileDomain(schema);
-        compiledCache.set(schema, compiled);
-    }
-    const entry = compiled.$.f(name);
-    if (entry === undefined) {
-        throw new Error(`Unknown function '${name}' in schema '${schema.domain}'`);
-    }
-    return entry.path.domain.raw;
-}
-export function useFunction(schema, fn, opts) {
-    const binding = useDomain(schema);
-    const path = useMemo(() => functionPathOf(schema, String(fn)), [schema, fn]);
-    const onErrorRef = useRef(opts?.onError);
-    onErrorRef.current = opts?.onError;
-    const call = useCallback(async (params) => {
-        try {
-            return (await binding.raw.call(path, params));
-        }
-        catch (error) {
-            onErrorRef.current?.(error);
-            throw error;
-        }
-    }, [binding, path]);
-    return useAction(call);
-}

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

@@ -1,14 +0,0 @@
-import type { NodeRefInput, TypeNames } from '@astrale-os/kernel-client';
-import type { Schema } from '@astrale-os/kernel-dsl';
-import type { AutoMethodAction, BoundMethodAction, MethodNames } from './types.js';
-export interface MethodOptions {
-    /** Bind the action to this node — dispatch as `action(params)`. */
-    on?: NodeRefInput;
-    /** Extra failure channel; the action still rejects and records `.error`. */
-    onError?: (error: unknown) => void;
-}
-export declare function useMethod<S extends Schema, T extends TypeNames<S>, M extends MethodNames<S, T>>(schema: S, type: T, method: M, opts: MethodOptions & {
-    on: NodeRefInput;
-}): BoundMethodAction<S, T, M>;
-export declare function useMethod<S extends Schema, T extends TypeNames<S>, M extends MethodNames<S, T>>(schema: S, type: T, method: M, opts?: MethodOptions): AutoMethodAction<S, T, M>;
-//# sourceMappingURL=method.hook.d.ts.map

package/dist/schema/method.hook.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"method.hook.d.ts","sourceRoot":"","sources":["../../src/schema/method.hook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AACxE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAA;AAcpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAKlF,MAAM,WAAW,aAAa;IAC5B,mEAAmE;IACnE,EAAE,CAAC,EAAE,YAAY,CAAA;IACjB,4EAA4E;IAC5E,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;CACnC;AAID,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,SAAS,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,EAC7F,MAAM,EAAE,CAAC,EACT,IAAI,EAAE,CAAC,EACP,MAAM,EAAE,CAAC,EACT,IAAI,EAAE,aAAa,GAAG;IAAE,EAAE,EAAE,YAAY,CAAA;CAAE,GACzC,iBAAiB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;AAC7B,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,SAAS,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,EAC7F,MAAM,EAAE,CAAC,EACT,IAAI,EAAE,CAAC,EACP,MAAM,EAAE,CAAC,EACT,IAAI,CAAC,EAAE,aAAa,GACnB,gBAAgB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA"}

package/dist/schema/method.hook.js

@@ -1,49 +0,0 @@
-import { resolveAllMethods } from '@astrale-os/kernel-dsl';
-/**
- * `useMethod` (API §6) — typed method dispatch with call state. Three forms,
- * selected by the method's static-ness and whether `on` is given:
- *   static            → action(params)
- *   instance + on     → action(params)   (bound to that node)
- *   instance, no on   → action(ref, params)
- * Params/result come from the method's Zod contracts.
- */
-import { useCallback, useMemo, useRef } from 'react';
-import { useAction } from '../graph/action.js';
-import { useDomain } from './domain.hook.js';
-export function useMethod(schema, type, method, opts) {
-    const binding = useDomain(schema);
-    const on = opts?.on;
-    const isStatic = useMemo(() => detectStatic(schema, type, String(method)), [schema, type, method]);
-    const onErrorRef = useRef(opts?.onError);
-    onErrorRef.current = opts?.onError;
-    const call = useCallback(async (...args) => {
-        const name = String(method);
-        try {
-            if (on !== undefined)
-                return await instance(binding, type, on, name, args[0]);
-            if (isStatic)
-                return await staticCall(binding, type, name, args[0]);
-            return await instance(binding, type, args[0], name, args[1]);
-        }
-        catch (error) {
-            onErrorRef.current?.(error);
-            throw error;
-        }
-    }, [binding, type, method, on, isStatic]);
-    return useAction(call);
-}
-function staticCall(binding, type, method, params) {
-    return binding.classes[type][method](params);
-}
-function instance(binding, type, ref, method, params) {
-    return binding.classes[type](ref)[method](params);
-}
-/** Read the method's `static` flag from the schema (own + inherited). */
-function detectStatic(schema, type, method) {
-    const def = schema.classes[type] ??
-        schema.interfaces[type];
-    if (def === undefined)
-        return false;
-    const methods = resolveAllMethods(def);
-    return methods[method]?.config.static === true;
-}

package/dist/schema/tag.d.ts

@@ -1,11 +0,0 @@
-/**
- * Schema-tagging of raw nodes (API §6, the bindAny bridge). A module-level tag
- * records the schema each BoundNode was bound under, so the traversal hooks can
- * recover it from the node alone (`useChildren`/`useOut`/`useIn` re-bind endpoints).
- */
-import type { Schema } from '@astrale-os/kernel-dsl';
-/** Record the schema a BoundNode was bound under; returns the node unchanged. */
-export declare function tagSchema<N>(node: N, schema: Schema): N;
-/** The schema a BoundNode was bound under, if it came from a shell-react binding. */
-export declare function schemaOf(node: object): Schema | undefined;
-//# sourceMappingURL=tag.d.ts.map

package/dist/schema/tag.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"tag.d.ts","sourceRoot":"","sources":["../../src/schema/tag.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAA;AAIpD,iFAAiF;AACjF,wBAAgB,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,CAAC,CAGvD;AAED,qFAAqF;AACrF,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEzD"}

package/dist/schema/tag.js

@@ -1,11 +0,0 @@
-const schemaOfNode = new WeakMap();
-/** Record the schema a BoundNode was bound under; returns the node unchanged. */
-export function tagSchema(node, schema) {
-    if (node !== null && typeof node === 'object')
-        schemaOfNode.set(node, schema);
-    return node;
-}
-/** The schema a BoundNode was bound under, if it came from a shell-react binding. */
-export function schemaOf(node) {
-    return schemaOfNode.get(node);
-}

package/dist/schema/types.d.ts

@@ -1,73 +0,0 @@
-/**
- * Type-level surface for the schema module (API §6): the read envelopes
- * (`TypedNodeResult`/`TypedChildrenResult`/`EndpointResult`) and the method /
- * function contract projections. Param inference mirrors the client's proxy
- * types (Zod optionality preserved), re-derived here because it is not exported.
- */
-import type { AnyBoundNode, BoundNode, DefOf, EdgeNames, EndpointsOf, NodeRefInput, TypeNames } from '@astrale-os/kernel-client';
-import type { z } from '@astrale-os/kernel-core';
-import type { AllMethods, ExtractMethodNames, ExtractMethodParams, ExtractMethodReturnValue, Schema } from '@astrale-os/kernel-dsl';
-import type { Action } from '../graph/action.js';
-import type { ReadState, Windowed } from '../graph/memory/read/envelope.js';
-export interface TypedNodeResult<S extends Schema, T extends TypeNames<S>> extends ReadState {
-    readonly node: BoundNode<DefOf<S, T>, S> | null;
-}
-export interface TypedChildrenResult<S extends Schema, T extends TypeNames<S>> extends ReadState, Windowed {
-    readonly children: readonly BoundNode<DefOf<S, T>, S>[];
-}
-/** Cardinality decides the envelope key: single|null for `1`/`0..1`, array otherwise. */
-export type EndpointResult<S extends Schema, E extends EdgeNames<S>, Side extends 'from' | 'to'> = EndpointsOf<S, E, Side> extends readonly unknown[] ? ReadState & {
-    readonly nodes: EndpointsOf<S, E, Side>;
-} : ReadState & {
-    readonly node: EndpointsOf<S, E, Side>;
-};
-/** Untyped traversal fallback — mirrors the raw `neighbors` shorthand. */
-export interface UntypedEndpointResult<S extends Schema> extends ReadState, Windowed {
-    readonly nodes: readonly AnyBoundNode<S>[];
-}
-/** Dispatchable method names on `type` (own + inherited). */
-export type MethodNames<S extends Schema, T extends TypeNames<S>> = ExtractMethodNames<DefOf<S, T>>;
-type OptionalKeys<P> = {
-    [K in keyof P]: P[K] extends z.ZodOptional<any> | z.ZodDefault<any> ? K : never;
-}[keyof P];
-type RequiredKeys<P> = Exclude<keyof P, OptionalKeys<P>>;
-type InferParams<P> = {
-    [K in RequiredKeys<P>]: P[K] extends z.ZodType<infer T> ? T : never;
-} & {
-    [K in OptionalKeys<P>]?: P[K] extends z.ZodType<infer T> ? T : never;
-};
-type Simplify<T> = {
-    [K in keyof T]: T[K];
-};
-/** Runtime params object for method `M` on `type`. */
-export type MethodParams<S extends Schema, T extends TypeNames<S>, M extends MethodNames<S, T>> = Simplify<InferParams<ExtractMethodParams<DefOf<S, T>, M & string>>>;
-/** Resolved return value of method `M` on `type`. */
-export type MethodResult<S extends Schema, T extends TypeNames<S>, M extends MethodNames<S, T>> = ExtractMethodReturnValue<DefOf<S, T>, M & string>;
-/** True when method `M` on `type` is static. */
-export type MethodIsStatic<S extends Schema, T extends TypeNames<S>, M extends MethodNames<S, T>> = M extends keyof AllMethods<DefOf<S, T>> ? AllMethods<DefOf<S, T>>[M] extends {
-    config: {
-        static: true;
-    };
-} ? true : false : false;
-/** Action for a `on`-bound or static method: `action(params)`. */
-export type BoundMethodAction<S extends Schema, T extends TypeNames<S>, M extends MethodNames<S, T>> = Action<[MethodParams<S, T, M>], MethodResult<S, T, M>>;
-/** Action for an unbound instance method: `action(ref, params)`. */
-export type TargetedMethodAction<S extends Schema, T extends TypeNames<S>, M extends MethodNames<S, T>> = Action<[ref: NodeRefInput, params: MethodParams<S, T, M>], MethodResult<S, T, M>>;
-/** Static → `action(params)`; instance → `action(ref, params)` (no `on`). */
-export type AutoMethodAction<S extends Schema, T extends TypeNames<S>, M extends MethodNames<S, T>> = MethodIsStatic<S, T, M> extends true ? BoundMethodAction<S, T, M> : TargetedMethodAction<S, T, M>;
-/** Standalone top-level function names of the schema (widens to `string` today — see above). */
-export type FunctionNames<S extends Schema> = keyof S['functions'] & string;
-/** Input value of standalone function `F` (`unknown` for a widened `FuncDef` — see above). */
-export type FunctionParams<S extends Schema, F extends FunctionNames<S>> = S['functions'][F] extends {
-    config: {
-        input: infer I;
-    };
-} ? I extends z.ZodType ? z.infer<I> : never : never;
-/** Output value of standalone function `F` (`unknown` for a widened `FuncDef` — see above). */
-export type FunctionResult<S extends Schema, F extends FunctionNames<S>> = S['functions'][F] extends {
-    config: {
-        output: infer O;
-    };
-} ? O extends z.ZodType ? z.infer<O> : never : never;
-export {};
-//# sourceMappingURL=types.d.ts.map

package/dist/schema/types.d.ts.map

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

package/dist/schema/types.js

@@ -1 +0,0 @@
-export {};

package/dist/schema/write.d.ts

@@ -1,16 +0,0 @@
-import type { GraphMemory } from '@astrale-os/kernel-client/store';
-import type { Node } from '@astrale-os/kernel-core';
-import type { SessionView } from '../auth/act-as.context.js';
-/**
- * One memory-backed writable kernel per (effective) session view, plus the
- * bind-time `id → tree-path` index it consults. Shared across every schema binding
- * over the same session so a node bound under any schema resolves for a write.
- */
-export interface WritableKernel {
-    readonly writable: SessionView;
-    readonly nodeIndex: Map<string, Node>;
-}
-export declare function writableFor(kernel: SessionView, memory: GraphMemory): WritableKernel;
-/** Record a bound node's raw value so the write cap retains its class and tree path. */
-export declare function recordNode(nodeIndex: Map<string, Node>, node: unknown): void;
-//# sourceMappingURL=write.d.ts.map

package/dist/schema/write.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../src/schema/write.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAA;AAClE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAA;AAEnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AAE5D;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAA;IAC9B,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;CACtC;AAGD,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,GAAG,cAAc,CAQpF;AAqDD,wFAAwF;AACxF,wBAAgB,UAAU,CAAC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAO5E"}