@treenity/react 3.0.0

package/dist/bind/computed.js

@@ -0,0 +1,61 @@
+// Computed store — separate reactive layer for $ref+$map resolved values
+// Dual: valtio proxies for field-level React reactivity (useSnapshot),
+// plus synchronous manual subs for bind engine and non-React consumers.
+// Never persisted to IDB or server. No Meteor trap.
+import { proxy, snapshot } from 'valtio/vanilla';
+const proxies = new Map();
+const subs = new Map();
+function ensure(path) {
+    let p = proxies.get(path);
+    if (!p) {
+        p = proxy({});
+        proxies.set(path, p);
+    }
+    return p;
+}
+function fire(path) {
+    const s = subs.get(path);
+    if (s)
+        for (const cb of s)
+            cb();
+}
+export function getComputed(path) {
+    const p = proxies.get(path);
+    if (!p)
+        return undefined;
+    return snapshot(p);
+}
+/** Get the raw valtio proxy — for useSnapshot in hooks */
+export function getComputedProxy(path) {
+    return proxies.get(path);
+}
+export function setComputed(path, field, value) {
+    const p = ensure(path);
+    if (Object.is(p[field], value))
+        return; // no-op if unchanged
+    p[field] = value;
+    fire(path); // synchronous for non-React consumers
+}
+export function clearComputed(path) {
+    const p = proxies.get(path);
+    if (p) {
+        for (const k of Object.keys(p))
+            delete p[k];
+        proxies.delete(path);
+    }
+    fire(path);
+}
+export function subscribeComputed(path, cb) {
+    if (!subs.has(path))
+        subs.set(path, new Set());
+    subs.get(path).add(cb);
+    return () => {
+        const s = subs.get(path);
+        if (s) {
+            s.delete(cb);
+            if (!s.size)
+                subs.delete(path);
+        }
+    };
+}
+//# sourceMappingURL=computed.js.map

package/dist/bind/computed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"computed.js","sourceRoot":"","sources":["../../src/bind/computed.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,uEAAuE;AACvE,wEAAwE;AACxE,oDAAoD;AAEpD,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAIjD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAmC,CAAC;AAC3D,MAAM,IAAI,GAAG,IAAI,GAAG,EAAoB,CAAC;AAEzC,SAAS,MAAM,CAAC,IAAY;IAC1B,IAAI,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC1B,IAAI,CAAC,CAAC,EAAE,CAAC;QACP,CAAC,GAAG,KAAK,CAA0B,EAAE,CAAC,CAAC;QACvC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACvB,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,IAAI,CAAC,IAAY;IACxB,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACzB,IAAI,CAAC;QAAE,KAAK,MAAM,EAAE,IAAI,CAAC;YAAE,EAAE,EAAE,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC5B,IAAI,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IACzB,OAAO,QAAQ,CAAC,CAAC,CAA4B,CAAC;AAChD,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,KAAa,EAAE,KAAc;IACrE,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,OAAO,CAAC,qBAAqB;IAC7D,CAAC,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC;IACjB,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,sCAAsC;AACpD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC5B,IAAI,CAAC,EAAE,CAAC;QACN,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;YAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5C,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACvB,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,CAAC;AACb,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,EAAO;IACrD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;IAC/C,IAAI,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACxB,OAAO,GAAG,EAAE;QACV,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACzB,IAAI,CAAC,EAAE,CAAC;YACN,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACb,IAAI,CAAC,CAAC,CAAC,IAAI;gBAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACjC,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/bind/engine.d.ts

@@ -0,0 +1,3 @@
+/** Start the binding engine. Returns cleanup function. */
+export declare function startBindEngine(): () => void;
+//# sourceMappingURL=engine.d.ts.map

package/dist/bind/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/bind/engine.ts"],"names":[],"mappings":"AA4JA,0DAA0D;AAC1D,wBAAgB,eAAe,IAAI,MAAM,IAAI,CAwC5C"}

package/dist/bind/engine.js

@@ -0,0 +1,184 @@
+// Binding engine — scans cache for $ref+$map fields, subscribes to sources,
+// evaluates on change, writes to computed store.
+// Supports $ref: "." (self) and @/path.field ref args in $map expressions.
+import * as cache from '#cache';
+import { trpc } from '#trpc';
+import { isRef } from '@treenity/core/core';
+import { clearComputed, getComputed, setComputed } from './computed';
+import { evaluateRef, extractArgPaths, hasOnce, isCollectionRef } from './eval';
+// Active bindings: targetPath → field → { ref, unsub }
+const active = new Map();
+// Collection paths with active SSE watches
+const watchedCollections = new Set();
+// Single-node paths already fetched
+const fetchedNodes = new Set();
+const ctx = {
+    getNode: (p) => cache.get(p),
+    getChildren: (p) => cache.getChildren(p),
+};
+/** Fetch collection children from server into cache */
+function fetchChildren(path) {
+    trpc.getChildren
+        .query({ path, watch: true, watchNew: true })
+        .then((r) => cache.putMany(r.items, path));
+}
+/** Ensure source data is in cache by fetching from server */
+function ensureInCache(path, collection) {
+    if (collection) {
+        if (!watchedCollections.has(path)) {
+            watchedCollections.add(path);
+            fetchChildren(path);
+        }
+    }
+    else {
+        if (fetchedNodes.has(path))
+            return;
+        fetchedNodes.add(path);
+        trpc.get.query({ path }).then((n) => {
+            if (n)
+                cache.put(n);
+        });
+    }
+}
+function evaluate(targetPath, field, ref) {
+    // Resolve $ref: "." → actual target path before eval
+    const resolved = ref.$ref === '.' ? { ...ref, $ref: targetPath } : ref;
+    try {
+        const value = evaluateRef(resolved, ctx);
+        setComputed(targetPath, field, value);
+    }
+    catch (e) {
+        console.warn(`[bind] eval error ${targetPath}.${field}:`, e);
+    }
+}
+function registerBinding(targetPath, field, ref) {
+    const once = hasOnce(ref);
+    const unsubs = [];
+    const cb = () => evaluate(targetPath, field, ref);
+    const mainPath = ref.$ref === '.' ? targetPath : ref.$ref;
+    const collection = isCollectionRef(ref);
+    if (mainPath !== targetPath) {
+        ensureInCache(mainPath, collection);
+    }
+    // `once` — evaluate once, no reactive subscription
+    if (!once) {
+        unsubs.push(collection
+            ? cache.subscribeChildren(mainPath, cb)
+            : cache.subscribePath(mainPath, cb));
+        for (const argPath of extractArgPaths(ref)) {
+            unsubs.push(cache.subscribePath(argPath, cb));
+            ensureInCache(argPath, false);
+        }
+    }
+    if (!active.has(targetPath))
+        active.set(targetPath, new Map());
+    active.get(targetPath).set(field, { ref, unsub: () => unsubs.forEach(u => u()) });
+    evaluate(targetPath, field, ref);
+}
+function unregisterAll(targetPath) {
+    const bindings = active.get(targetPath);
+    if (!bindings)
+        return;
+    for (const { unsub } of bindings.values())
+        unsub();
+    active.delete(targetPath);
+    clearComputed(targetPath);
+}
+/** Scan a single node for $ref+$map fields, register/update bindings */
+function scanNode(node) {
+    const path = node.$path;
+    const newRefs = new Map();
+    // Scan node-level fields
+    for (const [key, value] of Object.entries(node)) {
+        if (key.startsWith('$'))
+            continue;
+        if (isRef(value) && value.$map) {
+            newRefs.set(key, value);
+        }
+        // Scan sub-component fields
+        if (typeof value === 'object' && value !== null && '$type' in value) {
+            for (const [subKey, subVal] of Object.entries(value)) {
+                if (subKey.startsWith('$'))
+                    continue;
+                if (isRef(subVal) && subVal.$map) {
+                    newRefs.set(`${key}.${subKey}`, subVal);
+                }
+            }
+        }
+    }
+    const existing = active.get(path);
+    // No bindings before or after — nothing to do
+    if (!existing && newRefs.size === 0)
+        return;
+    // Remove stale bindings
+    if (existing) {
+        for (const [field, { unsub }] of existing) {
+            if (!newRefs.has(field)) {
+                unsub();
+                existing.delete(field);
+            }
+        }
+        if (existing.size === 0 && newRefs.size === 0) {
+            active.delete(path);
+            clearComputed(path);
+            return;
+        }
+    }
+    // Register new/updated bindings
+    for (const [field, ref] of newRefs) {
+        const prev = existing?.get(field);
+        // Skip if same expression
+        if (prev && prev.ref.$ref === ref.$ref && prev.ref.$map === ref.$map)
+            continue;
+        // Unregister old
+        if (prev)
+            prev.unsub();
+        registerBinding(path, field, ref);
+    }
+}
+function handleRemove(path) {
+    unregisterAll(path);
+}
+/** Start the binding engine. Returns cleanup function. */
+export function startBindEngine() {
+    // 1. Scan all existing nodes in cache
+    for (const [, node] of cache.raw()) {
+        scanNode(node);
+    }
+    // 2. Reactive: scan each node as it arrives/changes — instant, no polling
+    const unsubPut = cache.onNodePut((path) => {
+        const node = cache.get(path);
+        if (node)
+            scanNode(node);
+    });
+    // 3. Detect removed nodes — clean up stale bindings
+    const unsubGlobal = cache.subscribeGlobal(() => {
+        for (const path of active.keys()) {
+            if (!cache.get(path))
+                handleRemove(path);
+        }
+    });
+    // Dev debug — inspect binding engine state from console
+    if (typeof window !== 'undefined') {
+        window.__bind = {
+            active: () => Object.fromEntries([...active].map(([k, v]) => [k, [...v.keys()]])),
+            watched: () => [...watchedCollections],
+            fetched: () => [...fetchedNodes],
+            computed: () => {
+                const result = {};
+                for (const p of active.keys())
+                    result[p] = getComputed(p);
+                return result;
+            },
+        };
+    }
+    return () => {
+        unsubPut();
+        unsubGlobal();
+        for (const path of [...active.keys()])
+            unregisterAll(path);
+        watchedCollections.clear();
+        fetchedNodes.clear();
+    };
+}
+//# sourceMappingURL=engine.js.map

package/dist/bind/engine.js.map

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

package/dist/bind/eval.d.ts

@@ -0,0 +1,13 @@
+import type { NodeData, Ref } from '@treenity/core/core';
+export type BindCtx = {
+    getNode: (path: string) => NodeData | undefined;
+    getChildren: (path: string) => NodeData[];
+};
+export declare function evaluateRef(ref: Ref, ctx: BindCtx): unknown;
+/** Check if first pipe in $map is a collection pipe (needs children subscription) */
+export declare function isCollectionRef(ref: Ref): boolean;
+/** Check if $map contains `once` pipe — disables reactive subscription */
+export declare function hasOnce(ref: Ref): boolean;
+/** Extract all external #/path refs from a $map expression (for subscriptions) */
+export declare function extractArgPaths(ref: Ref): string[];
+//# sourceMappingURL=eval.d.ts.map

package/dist/bind/eval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eval.d.ts","sourceRoot":"","sources":["../../src/bind/eval.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAIzD,MAAM,MAAM,OAAO,GAAG;IACpB,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,QAAQ,GAAG,SAAS,CAAC;IAChD,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,QAAQ,EAAE,CAAC;CAC3C,CAAC;AA6BF,wBAAgB,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAmC3D;AAED,qFAAqF;AACrF,wBAAgB,eAAe,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAKjD;AAED,0EAA0E;AAC1E,wBAAgB,OAAO,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAIzC;AAED,kFAAkF;AAClF,wBAAgB,eAAe,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,EAAE,CAclD"}

package/dist/bind/eval.js

@@ -0,0 +1,97 @@
+// $ref + $map evaluator
+// Resolves source from $ref, applies $map pipeline
+// #field (self) and #/path.field (external) args resolved from context
+import { isRefArg, parseMapExpr } from './parse';
+import { getPipe } from './pipes';
+// Collection pipe names — when first step is one of these, resolve source as children
+const COLLECTION_PIPES = new Set(['last', 'first', 'count', 'avg', 'max', 'min', 'sum', 'map']);
+// Parsed expression cache
+const exprCache = new Map();
+function getCachedExpr(map) {
+    let expr = exprCache.get(map);
+    if (!expr) {
+        expr = parseMapExpr(map);
+        exprCache.set(map, expr);
+    }
+    return expr;
+}
+/** Resolve a pipe argument — ref args looked up from context, scalars pass through */
+function resolveArg(arg, ctx, refPath) {
+    if (!isRefArg(arg))
+        return arg;
+    const path = arg.$ref === '.' ? refPath : arg.$ref;
+    let val = ctx.getNode(path);
+    for (const f of arg.fields) {
+        if (val == null || typeof val !== 'object')
+            return undefined;
+        val = val[f];
+    }
+    return val;
+}
+export function evaluateRef(ref, ctx) {
+    // Plain ref without $map — resolve to node
+    if (!ref.$map) {
+        return ctx.getNode(ref.$ref);
+    }
+    const expr = getCachedExpr(ref.$map);
+    const firstStep = expr.steps[0];
+    // Determine source: children (if first pipe is collection) or single node
+    let value;
+    if (firstStep?.type === 'pipe' && COLLECTION_PIPES.has(firstStep.name)) {
+        value = ctx.getChildren(ref.$ref);
+    }
+    else {
+        value = ctx.getNode(ref.$ref);
+    }
+    // Apply pipeline left-to-right
+    for (const step of expr.steps) {
+        if (value === undefined || value === null)
+            return undefined;
+        if (step.type === 'field') {
+            value = value[step.name];
+        }
+        else {
+            const fn = getPipe(step.name);
+            if (!fn) {
+                console.warn(`[bind] unknown pipe: ${step.name}`);
+                return undefined;
+            }
+            const resolved = step.args.map(a => resolveArg(a, ctx, ref.$ref));
+            value = fn(value, ...resolved);
+        }
+    }
+    return value;
+}
+/** Check if first pipe in $map is a collection pipe (needs children subscription) */
+export function isCollectionRef(ref) {
+    if (!ref.$map)
+        return false;
+    const expr = getCachedExpr(ref.$map);
+    const first = expr.steps[0];
+    return first?.type === 'pipe' && COLLECTION_PIPES.has(first.name);
+}
+/** Check if $map contains `once` pipe — disables reactive subscription */
+export function hasOnce(ref) {
+    if (!ref.$map)
+        return false;
+    const expr = getCachedExpr(ref.$map);
+    return expr.steps.some(s => s.type === 'pipe' && s.name === 'once');
+}
+/** Extract all external #/path refs from a $map expression (for subscriptions) */
+export function extractArgPaths(ref) {
+    if (!ref.$map)
+        return [];
+    const expr = getCachedExpr(ref.$map);
+    const paths = [];
+    for (const step of expr.steps) {
+        if (step.type === 'pipe') {
+            for (const arg of step.args) {
+                if (isRefArg(arg) && arg.$ref !== '.') {
+                    paths.push(arg.$ref);
+                }
+            }
+        }
+    }
+    return paths;
+}
+//# sourceMappingURL=eval.js.map

package/dist/bind/eval.js.map

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

package/dist/bind/hook.d.ts

@@ -0,0 +1,8 @@
+import { type NodeData } from '@treenity/core/core';
+/** Reactive access to computed binding values for a node */
+export declare function useComputed(path: string): Record<string, unknown>;
+/** Node with computed bindings merged — raw + computed overlay */
+export declare function useResolvedNode(path: string): [NodeData | undefined, (next: NodeData) => Promise<void>];
+/** Evaluate a $ref+$map expression reactively — no node needed */
+export declare function useEvalRef(path: string, map: string): unknown;
+//# sourceMappingURL=hook.d.ts.map

package/dist/bind/hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook.d.ts","sourceRoot":"","sources":["../../src/bind/hook.ts"],"names":[],"mappings":"AAIA,OAAO,EAAS,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAS3D,4DAA4D;AAC5D,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAUjE;AAED,kEAAkE;AAClE,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,QAAQ,GAAG,SAAS,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,CAkDvG;AAOD,kEAAkE;AAClE,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CA0B7D"}

package/dist/bind/hook.js

@@ -0,0 +1,99 @@
+// React hooks for computed bindings
+import * as cache from '#cache';
+import { set, usePath } from '#hooks';
+import { isRef } from '@treenity/core/core';
+import { useCallback, useMemo, useSyncExternalStore } from 'react';
+import { useSnapshot } from 'valtio';
+import { proxy } from 'valtio/vanilla';
+import { getComputed, getComputedProxy, subscribeComputed } from './computed';
+import { evaluateRef, extractArgPaths, isCollectionRef } from './eval';
+const EMPTY_PROXY = proxy({});
+/** Reactive access to computed binding values for a node */
+export function useComputed(path) {
+    // Structural: detect proxy creation (first computed value for this path)
+    useSyncExternalStore(useCallback((cb) => subscribeComputed(path, cb), [path]), useCallback(() => getComputed(path), [path]));
+    // Field-level: re-render only when accessed computed fields change
+    const p = getComputedProxy(path);
+    return useSnapshot(p ?? EMPTY_PROXY);
+}
+/** Node with computed bindings merged — raw + computed overlay */
+export function useResolvedNode(path) {
+    const node = usePath(path);
+    const computed = useComputed(path);
+    if (!node)
+        return [undefined, set];
+    // Check if node has any $ref+$map bindings that need resolving
+    const hasComputed = Object.keys(computed).length > 0;
+    const hasBindings = Object.values(node).some(v => isRef(v) && v.$map);
+    if (!hasComputed && !hasBindings)
+        return [node, set];
+    const merged = { ...node };
+    // Apply computed values
+    for (const [key, value] of Object.entries(computed)) {
+        // Support dotted keys for sub-component fields (e.g. "mesh.width")
+        if (key.includes('.')) {
+            const [comp, field] = key.split('.');
+            if (merged[comp] && typeof merged[comp] === 'object') {
+                merged[comp] = { ...merged[comp], [field]: value };
+            }
+        }
+        else {
+            merged[key] = value;
+        }
+    }
+    // Strip unresolved $ref+$map bindings — computed not ready yet, use 0 default
+    // Without this, raw ref objects leak to consumers (e.g. Three.js rotation={[0, {$ref:...}, 0]} → NaN)
+    for (const key of Object.keys(merged)) {
+        if (key.startsWith('$'))
+            continue;
+        const v = merged[key];
+        if (isRef(v) && v.$map) {
+            merged[key] = 0;
+        }
+        // Sub-component fields
+        if (v && typeof v === 'object' && !isRef(v) && '$type' in v) {
+            let changed = false;
+            const comp = { ...v };
+            for (const sk of Object.keys(comp)) {
+                if (sk.startsWith('$'))
+                    continue;
+                if (isRef(comp[sk]) && comp[sk].$map) {
+                    comp[sk] = 0;
+                    changed = true;
+                }
+            }
+            if (changed)
+                merged[key] = comp;
+        }
+    }
+    return [merged, set];
+}
+const evalCtx = {
+    getNode: (p) => cache.get(p),
+    getChildren: (p) => cache.getChildren(p),
+};
+/** Evaluate a $ref+$map expression reactively — no node needed */
+export function useEvalRef(path, map) {
+    const ref = useMemo(() => ({ $ref: path, $map: map }), [path, map]);
+    // Subscribe to all relevant paths: main source + @/path args
+    const subscribe = useCallback((cb) => {
+        const unsubs = [];
+        unsubs.push(isCollectionRef(ref)
+            ? cache.subscribeChildren(path, cb)
+            : cache.subscribePath(path, cb));
+        for (const argPath of extractArgPaths(ref)) {
+            unsubs.push(cache.subscribePath(argPath, cb));
+        }
+        return () => unsubs.forEach(u => u());
+    }, [ref, path]);
+    const getSnapshot = useCallback(() => {
+        try {
+            return evaluateRef(ref, evalCtx);
+        }
+        catch {
+            return undefined;
+        }
+    }, [ref]);
+    return useSyncExternalStore(subscribe, getSnapshot);
+}
+//# sourceMappingURL=hook.js.map

package/dist/bind/hook.js.map

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

package/dist/bind/parse.d.ts

@@ -0,0 +1,19 @@
+export type RefArg = {
+    $ref: string;
+    fields: string[];
+};
+export type PipeArg = number | string | RefArg;
+export type MapExpr = {
+    steps: PipeStep[];
+};
+export type PipeStep = {
+    type: 'pipe';
+    name: string;
+    args: PipeArg[];
+} | {
+    type: 'field';
+    name: string;
+};
+export declare function isRefArg(arg: PipeArg): arg is RefArg;
+export declare function parseMapExpr(expr: string): MapExpr;
+//# sourceMappingURL=parse.d.ts.map

package/dist/bind/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/bind/parse.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AACxD,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAE/C,MAAM,MAAM,OAAO,GAAG;IAAE,KAAK,EAAE,QAAQ,EAAE,CAAA;CAAE,CAAC;AAE5C,MAAM,MAAM,QAAQ,GAChB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,EAAE,CAAA;CAAE,GAC/C;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpC,wBAAgB,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,MAAM,CAEpD;AA0ED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CASlD"}

package/dist/bind/parse.js

@@ -0,0 +1,86 @@
+// $map expression parser
+// Syntax: selector.field | pipe1(args) | pipe2(args)
+// Source path lives in $ref, not here — parser handles $map content only
+//
+// Access modes:
+//   .field         = drill into current pipe value
+//   #field         = lookup from source node ($ref path) — like URI fragment
+//   #/path.field   = lookup from external node — absolute path after #
+export function isRefArg(arg) {
+    return typeof arg === 'object' && arg !== null && '$ref' in arg;
+}
+const PIPE_RE = /^([a-zA-Z_]\w*)\(([^)]*)\)(.*)$/;
+function parseArg(s) {
+    const t = s.trim();
+    // # = node ref: #field (self), #/path.field (external)
+    if (t.startsWith('#')) {
+        const rest = t.slice(1);
+        if (rest.startsWith('/')) {
+            // External: #/path.field
+            const dotIdx = rest.indexOf('.');
+            if (dotIdx === -1)
+                return { $ref: rest, fields: [] };
+            return { $ref: rest.slice(0, dotIdx), fields: rest.slice(dotIdx + 1).split('.') };
+        }
+        // Self: #field or #comp.field
+        return { $ref: '.', fields: rest.length ? rest.split('.') : [] };
+    }
+    const n = Number(t);
+    return Number.isFinite(n) ? n : t;
+}
+function parseSegment(raw) {
+    const s = raw.trim();
+    if (!s)
+        return [];
+    // #field — self-ref field access (like URI fragment)
+    if (s.startsWith('#') && !s.startsWith('#/')) {
+        const rest = s.slice(1);
+        return rest.split('.').map(name => ({ type: 'field', name }));
+    }
+    // Pure field chain: .foo.bar — drill into pipe value
+    if (s.startsWith('.')) {
+        return parseFieldChain(s);
+    }
+    // pipe(args) optionally followed by .field chain
+    const m = PIPE_RE.exec(s);
+    if (m) {
+        const steps = [{
+                type: 'pipe',
+                name: m[1],
+                args: m[2] ? m[2].split(',').map(parseArg) : [],
+            }];
+        if (m[3])
+            steps.push(...parseFieldChain(m[3]));
+        return steps;
+    }
+    // Bare name (round, abs): pipe with no args, optionally followed by .field
+    const bare = /^([a-zA-Z_]\w*)(.*)$/.exec(s);
+    if (bare) {
+        const steps = [{ type: 'pipe', name: bare[1], args: [] }];
+        if (bare[2])
+            steps.push(...parseFieldChain(bare[2]));
+        return steps;
+    }
+    return [];
+}
+function parseFieldChain(s) {
+    const steps = [];
+    let rest = s;
+    while (rest) {
+        const m = /^\.([a-zA-Z_$]\w*)(.*)$/.exec(rest);
+        if (!m)
+            break;
+        steps.push({ type: 'field', name: m[1] });
+        rest = m[2];
+    }
+    return steps;
+}
+export function parseMapExpr(expr) {
+    const parts = expr.split('|').map(s => s.trim());
+    const steps = [];
+    for (const part of parts) {
+        steps.push(...parseSegment(part));
+    }
+    return { steps };
+}
+//# sourceMappingURL=parse.js.map

package/dist/bind/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../src/bind/parse.ts"],"names":[],"mappings":"AAAA,yBAAyB;AACzB,qDAAqD;AACrD,yEAAyE;AACzE,EAAE;AACF,gBAAgB;AAChB,mDAAmD;AACnD,6EAA6E;AAC7E,uEAAuE;AAWvE,MAAM,UAAU,QAAQ,CAAC,GAAY;IACnC,OAAO,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,MAAM,IAAI,GAAG,CAAC;AAClE,CAAC;AAED,MAAM,OAAO,GAAG,iCAAiC,CAAC;AAElD,SAAS,QAAQ,CAAC,CAAS;IACzB,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAEnB,uDAAuD;IACvD,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACxB,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACzB,yBAAyB;YACzB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACjC,IAAI,MAAM,KAAK,CAAC,CAAC;gBAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;YACrD,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACpF,CAAC;QACD,8BAA8B;QAC9B,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IACnE,CAAC;IAED,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IACpB,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACpC,CAAC;AAED,SAAS,YAAY,CAAC,GAAW;IAC/B,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IACrB,IAAI,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IAElB,qDAAqD;IACrD,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACxB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,OAAgB,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACzE,CAAC;IAED,qDAAqD;IACrD,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACtB,OAAO,eAAe,CAAC,CAAC,CAAC,CAAC;IAC5B,CAAC;IAED,iDAAiD;IACjD,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC1B,IAAI,CAAC,EAAE,CAAC;QACN,MAAM,KAAK,GAAe,CAAC;gBACzB,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;gBACV,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE;aAChD,CAAC,CAAC;QACH,IAAI,CAAC,CAAC,CAAC,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,2EAA2E;IAC3E,MAAM,IAAI,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC5C,IAAI,IAAI,EAAE,CAAC;QACT,MAAM,KAAK,GAAe,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QACtE,IAAI,IAAI,CAAC,CAAC,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACrD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,eAAe,CAAC,CAAS;IAChC,MAAM,KAAK,GAAe,EAAE,CAAC;IAC7B,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,CAAC,GAAG,yBAAyB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/C,IAAI,CAAC,CAAC;YAAE,MAAM;QACd,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC1C,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACd,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACjD,MAAM,KAAK,GAAe,EAAE,CAAC;IAE7B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;IACpC,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,CAAC;AACnB,CAAC"}

package/dist/bind/pipes.d.ts

@@ -0,0 +1,4 @@
+export type PipeFn = (input: unknown, ...args: unknown[]) => unknown;
+export declare function registerPipe(name: string, fn: PipeFn): void;
+export declare function getPipe(name: string): PipeFn | undefined;
+//# sourceMappingURL=pipes.d.ts.map

package/dist/bind/pipes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipes.d.ts","sourceRoot":"","sources":["../../src/bind/pipes.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,MAAM,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;AAIrE,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAE3D;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAExD"}