@treenity/core 1.0.48 → 3.0.1

package/dist/server/types-mount.js

@@ -0,0 +1,144 @@
+// Treenity Types Mount — Layer 4
+// Union of registry (code-defined types) + backing store (dynamic types)
+import { createNode, getContextsForType, getRegisteredTypes, resolve } from '#core';
+import { paginate } from '#tree';
+export function createTypesStore(backingStore, typesPath = '/sys/types') {
+    // block.hero → /types/block/hero
+    const toPath = (type) => `${typesPath}/${type.replace(/\./g, '/')}`;
+    // /types/block/hero → block.hero
+    const toType = (path) => path.slice(typesPath.length + 1).replace(/\//g, '.');
+    function isRegistryType(path) {
+        const typeName = toType(path);
+        return getContextsForType(typeName).length > 0;
+    }
+    function typeNode(typeName) {
+        const contexts = getContextsForType(typeName);
+        if (contexts.length === 0)
+            return undefined;
+        const components = {};
+        for (const ctx of contexts) {
+            // "schema" returns data object; other contexts (twa, react) are renderers — just mark presence
+            if (ctx === 'schema') {
+                const handler = resolve(typeName, ctx);
+                const schema = handler();
+                components[ctx] = { $type: ctx, ...schema };
+            }
+            else {
+                components[ctx] = { $type: ctx };
+            }
+        }
+        return createNode(toPath(typeName), 'type', undefined, components);
+    }
+    // Merge registry node with backing store node — registry wins for code-defined
+    // components, backing store adds dynamic components (view, actions from AI agent)
+    async function mergedTypeNode(typeName) {
+        const fromRegistry = typeNode(typeName);
+        if (!fromRegistry)
+            return undefined;
+        const fromStore = await backingStore.get(fromRegistry.$path);
+        if (!fromStore)
+            return fromRegistry;
+        // Backing store fields first, registry overwrites (code-defined always wins)
+        return { ...fromStore, ...fromRegistry };
+    }
+    return {
+        async get(path) {
+            const typeName = toType(path);
+            const merged = await mergedTypeNode(typeName);
+            if (merged)
+                return merged;
+            // Check if it's a category folder (e.g. /types/block)
+            const prefix = typeName + '.';
+            if (getRegisteredTypes('schema').some((t) => t.startsWith(prefix))) {
+                return createNode(path, 'dir');
+            }
+            return backingStore.get(path);
+        },
+        async getChildren(path, opts) {
+            const depth = opts?.depth ?? 1;
+            const prefix = path === typesPath ? '' : toType(path) + '.';
+            const types = getRegisteredTypes();
+            const byPath = new Map();
+            // Backing store — scan deep to discover category folders, synthesize intermediate dirs
+            const backingItems = (await backingStore.getChildren(path, { depth: Infinity })).items;
+            for (const n of backingItems) {
+                const rel = path === '/' ? n.$path.slice(1) : n.$path.slice(path.length + 1);
+                const parts = rel.split('/');
+                if (parts.length <= depth)
+                    byPath.set(n.$path, n);
+                // Synthesize dir nodes for intermediate paths (like registry does for categories)
+                for (let i = 0; i < parts.length - 1; i++) {
+                    if (i + 1 > depth)
+                        break;
+                    const dirPath = `${path}/${parts.slice(0, i + 1).join('/')}`;
+                    if (!byPath.has(dirPath))
+                        byPath.set(dirPath, createNode(dirPath, 'dir'));
+                }
+            }
+            // Registry types — merge with backing store data (dynamic views, actions)
+            const seenDirs = new Set();
+            for (const t of types) {
+                if (prefix && !t.startsWith(prefix))
+                    continue;
+                if (!prefix && !t.includes('.')) {
+                    const reg = typeNode(t);
+                    if (reg) {
+                        const stored = byPath.get(reg.$path);
+                        byPath.set(reg.$path, stored ? { ...stored, ...reg } : reg);
+                    }
+                    continue;
+                }
+                const rest = prefix ? t.slice(prefix.length) : t;
+                const parts = rest.split('.');
+                if (parts.length === 1) {
+                    // Direct child leaf type — merge with any backing store data
+                    const reg = typeNode(t);
+                    if (reg) {
+                        const stored = byPath.get(reg.$path);
+                        byPath.set(reg.$path, stored ? { ...stored, ...reg } : reg);
+                    }
+                }
+                else {
+                    // Category folder (always emit)
+                    const cat = parts[0];
+                    if (!seenDirs.has(cat)) {
+                        seenDirs.add(cat);
+                        const folderPath = `${path}/${cat}`;
+                        byPath.set(folderPath, createNode(folderPath, 'dir'));
+                    }
+                    // Deep types — emit when depth allows, merge with backing store
+                    if (depth > 1) {
+                        const reg = typeNode(t);
+                        if (reg) {
+                            const stored = byPath.get(reg.$path);
+                            byPath.set(reg.$path, stored ? { ...stored, ...reg } : reg);
+                        }
+                        // Intermediate dirs
+                        for (let i = 1; i < parts.length - 1; i++) {
+                            const dirKey = parts.slice(0, i + 1).join('.');
+                            if (!seenDirs.has(dirKey)) {
+                                seenDirs.add(dirKey);
+                                const dirPath = `${path}/${parts.slice(0, i + 1).join('/')}`;
+                                byPath.set(dirPath, createNode(dirPath, 'dir'));
+                            }
+                        }
+                    }
+                }
+            }
+            return paginate([...byPath.values()], opts);
+        },
+        async set(node) {
+            return backingStore.set(node);
+        },
+        async remove(path) {
+            // Never remove code-registered types
+            if (isRegistryType(path))
+                throw new Error(`Cannot remove registry type: ${toType(path)}`);
+            return backingStore.remove(path);
+        },
+        async patch(path, ops, ctx) {
+            return backingStore.patch(path, ops, ctx);
+        },
+    };
+}
+//# sourceMappingURL=types-mount.js.map

package/dist/server/types-mount.js.map

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

package/dist/server/validate.d.ts

@@ -0,0 +1,3 @@
+import type { Tree } from '#tree';
+export declare function withValidation(store: Tree): Tree;
+//# sourceMappingURL=validate.d.ts.map

package/dist/server/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/server/validate.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;AAElC,wBAAgB,cAAc,CAAC,KAAK,EAAE,IAAI,GAAG,IAAI,CAehD"}

package/dist/server/validate.js

@@ -0,0 +1,20 @@
+// Write-Barrier — validates node components against their schemas before store.set()
+// Rejects writes with malformed data. AI agents get "compilation errors" instead of garbage in DB.
+import { validateNode } from '#comp/validate';
+export function withValidation(store) {
+    return {
+        ...store,
+        async set(node) {
+            const errors = validateNode(node);
+            if (errors.length) {
+                const msg = errors.map(e => `${e.path}: ${e.message}`).join('; ');
+                throw new Error(`Validation: ${msg}`);
+            }
+            return store.set(node);
+        },
+        async patch(path, ops, ctx) {
+            return store.patch(path, ops, ctx);
+        },
+    };
+}
+//# sourceMappingURL=validate.js.map

package/dist/server/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/server/validate.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,mGAAmG;AAEnG,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C,MAAM,UAAU,cAAc,CAAC,KAAW;IACxC,OAAO;QACL,GAAG,KAAK;QACR,KAAK,CAAC,GAAG,CAAC,IAAI;YACZ,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YAClC,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;gBAClB,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAClE,MAAM,IAAI,KAAK,CAAC,eAAe,GAAG,EAAE,CAAC,CAAC;YACxC,CAAC;YACD,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;QACD,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG;YACxB,OAAO,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;QACrC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/server/volatile.d.ts

@@ -0,0 +1,11 @@
+import { type NodeData } from '#core';
+import { type Tree } from '#tree';
+declare module '#core/context' {
+    interface ContextHandlers {
+        volatile: () => boolean;
+    }
+}
+export declare function isVolatile(node: NodeData): boolean;
+export declare function extractPaths(result: unknown): string[];
+export declare function withVolatile(store: Tree): Tree;
+//# sourceMappingURL=volatile.d.ts.map

package/dist/server/volatile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"volatile.d.ts","sourceRoot":"","sources":["../../src/server/volatile.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,QAAQ,EAA6B,MAAM,OAAO,CAAC;AACjE,OAAO,EAAsC,KAAK,IAAI,EAAE,MAAM,OAAO,CAAC;AAEtE,OAAO,QAAQ,eAAe,CAAC;IAC7B,UAAU,eAAe;QACvB,QAAQ,EAAE,MAAM,OAAO,CAAC;KACzB;CACF;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAGlD;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,EAAE,CAStD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,IAAI,GAAG,IAAI,CAE9C"}

package/dist/server/volatile.js

@@ -0,0 +1,26 @@
+// Treenity Volatile Nodes — Layer 3
+// Nodes with $volatile go to memory, rest to backing store.
+// Cascade: $volatile on instance > register(type, 'volatile') > false
+import { resolve as resolveHandler } from '#core';
+import { createFilterTree, createMemoryTree } from '#tree';
+export function isVolatile(node) {
+    if ('$volatile' in node)
+        return !!node.$volatile;
+    return !!resolveHandler(node.$type, 'volatile');
+}
+export function extractPaths(result) {
+    if (!result || typeof result !== 'object')
+        return [];
+    const r = result;
+    if (Array.isArray(r.items))
+        return r.items
+            .filter((n) => typeof n?.$path === 'string')
+            .map((n) => n.$path);
+    if (typeof r.$path === 'string')
+        return [r.$path];
+    return [];
+}
+export function withVolatile(store) {
+    return createFilterTree(createMemoryTree(), store, isVolatile);
+}
+//# sourceMappingURL=volatile.js.map

package/dist/server/volatile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"volatile.js","sourceRoot":"","sources":["../../src/server/volatile.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,4DAA4D;AAC5D,sEAAsE;AAEtE,OAAO,EAAiB,OAAO,IAAI,cAAc,EAAE,MAAM,OAAO,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAa,MAAM,OAAO,CAAC;AAQtE,MAAM,UAAU,UAAU,CAAC,IAAc;IACvC,IAAI,WAAW,IAAI,IAAI;QAAE,OAAO,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC;IACjD,OAAO,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAe;IAC1C,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IACrD,MAAM,CAAC,GAAG,MAAiC,CAAC;IAC5C,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;QACxB,OAAQ,CAAC,CAAC,KAAmC;aAC1C,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,KAAK,KAAK,QAAQ,CAAC;aAC3C,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAe,CAAC,CAAC;IACnC,IAAI,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ;QAAE,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAClD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAW;IACtC,OAAO,gBAAgB,CAAC,gBAAgB,EAAE,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;AACjE,CAAC"}

package/dist/server/watch.d.ts

@@ -0,0 +1,23 @@
+import { type NodeEvent } from './sub';
+export type WatchPush = (event: NodeEvent) => void;
+export type WatchManagerOpts = {
+    gracePeriodMs?: number;
+    onUserRemoved?: (userId: string) => void;
+};
+export type WatchOpts = {
+    children?: boolean;
+    autoWatch?: boolean;
+};
+export type WatchManager = {
+    /** Attach push channel. Returns true if watches were preserved (reconnect within grace). */
+    connect(connId: string, userId: string, push: WatchPush): boolean;
+    disconnect(connId: string): void;
+    watch(userId: string, paths: string[], opts?: WatchOpts): void;
+    unwatch(userId: string, paths: string[], opts?: {
+        children?: boolean;
+    }): void;
+    notify(event: NodeEvent): void;
+    clientCount(): number;
+};
+export declare function createWatchManager(opts?: WatchManagerOpts): WatchManager;
+//# sourceMappingURL=watch.d.ts.map

package/dist/server/watch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../../src/server/watch.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,MAAM,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;AAEnD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CAC1C,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAEpE,MAAM,MAAM,YAAY,GAAG;IACzB,4FAA4F;IAC5F,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC;IAClE,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IAC/D,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IAC9E,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;IAC/B,WAAW,IAAI,MAAM,CAAC;CACvB,CAAC;AAoBF,wBAAgB,kBAAkB,CAAC,IAAI,CAAC,EAAE,gBAAgB,GAAG,YAAY,CA6JxE"}

package/dist/server/watch.js

@@ -0,0 +1,178 @@
+// Treenity WatchManager — Layer 5
+// Exact-path + prefix (children) watch/unwatch per user.
+// Supports multiple connections per user (multi-tab).
+// Grace period: on last disconnect, watches survive briefly for SSE auto-reconnect.
+const DEFAULT_GRACE_MS = 5_000;
+function addTo(map, key, uid) {
+    let set = map.get(key);
+    if (!set) {
+        set = new Set();
+        map.set(key, set);
+    }
+    set.add(uid);
+}
+function removeFrom(map, key, uid) {
+    const set = map.get(key);
+    if (!set)
+        return;
+    set.delete(uid);
+    if (set.size === 0)
+        map.delete(key);
+}
+export function createWatchManager(opts) {
+    const gracePeriodMs = opts?.gracePeriodMs ?? DEFAULT_GRACE_MS;
+    const pathToUsers = new Map();
+    const prefixToUsers = new Map();
+    const users = new Map();
+    const graceTimers = new Map();
+    function removeUser(userId) {
+        const user = users.get(userId);
+        if (!user)
+            return;
+        for (const p of user.paths)
+            removeFrom(pathToUsers, p, userId);
+        for (const p of user.prefixes.keys())
+            removeFrom(prefixToUsers, p, userId);
+        users.delete(userId);
+        opts?.onUserRemoved?.(userId);
+    }
+    function pushToUser(uid, event) {
+        const user = users.get(uid);
+        if (!user)
+            return;
+        for (const push of user.pushes.values())
+            push(event);
+    }
+    function ensureUser(userId) {
+        let user = users.get(userId);
+        if (!user) {
+            user = { pushes: new Map(), paths: new Set(), prefixes: new Map() };
+            users.set(userId, user);
+        }
+        return user;
+    }
+    return {
+        connect(connId, userId, push) {
+            // Cancel grace timer — user reconnected in time
+            const timer = graceTimers.get(userId);
+            if (timer) {
+                clearTimeout(timer);
+                graceTimers.delete(userId);
+            }
+            const preserved = users.has(userId);
+            const user = ensureUser(userId);
+            user.pushes.set(connId, push);
+            return preserved;
+        },
+        disconnect(connId) {
+            for (const [userId, user] of users) {
+                if (!user.pushes.has(connId))
+                    continue;
+                user.pushes.delete(connId);
+                if (user.pushes.size === 0) {
+                    // Start grace period — don't nuke watches yet
+                    const timer = setTimeout(() => {
+                        graceTimers.delete(userId);
+                        const u = users.get(userId);
+                        if (u && u.pushes.size === 0)
+                            removeUser(userId);
+                    }, gracePeriodMs);
+                    graceTimers.set(userId, timer);
+                }
+                return;
+            }
+        },
+        watch(userId, paths, watchOpts) {
+            const user = ensureUser(userId);
+            if (watchOpts?.children) {
+                for (const p of paths) {
+                    user.prefixes.set(p, watchOpts.autoWatch ?? false);
+                    addTo(prefixToUsers, p, userId);
+                }
+            }
+            else {
+                for (const p of paths) {
+                    user.paths.add(p);
+                    addTo(pathToUsers, p, userId);
+                }
+            }
+        },
+        unwatch(userId, paths, unwatchOpts) {
+            const user = users.get(userId);
+            if (!user)
+                return;
+            if (unwatchOpts?.children) {
+                for (const p of paths) {
+                    user.prefixes.delete(p);
+                    removeFrom(prefixToUsers, p, userId);
+                }
+            }
+            else {
+                for (const p of paths) {
+                    user.paths.delete(p);
+                    removeFrom(pathToUsers, p, userId);
+                }
+            }
+        },
+        notify(event) {
+            if (event.type === 'reconnect')
+                return;
+            const notified = new Set();
+            // Exact match
+            const exact = pathToUsers.get(event.path);
+            if (exact)
+                for (const uid of exact) {
+                    notified.add(uid);
+                    pushToUser(uid, event);
+                }
+            // Prefix match: direct parent only (mirrors getChildren depth=1)
+            const idx = event.path.lastIndexOf('/');
+            if (idx < 0)
+                return;
+            const parent = idx === 0 ? '/' : event.path.slice(0, idx);
+            const watchers = prefixToUsers.get(parent);
+            if (watchers)
+                for (const uid of watchers) {
+                    if (notified.has(uid))
+                        continue;
+                    notified.add(uid);
+                    const user = users.get(uid);
+                    if (!user)
+                        continue;
+                    pushToUser(uid, event);
+                    // autoWatch: subscribe to exact path for future updates
+                    if (user.prefixes.get(parent)) {
+                        user.paths.add(event.path);
+                        addTo(pathToUsers, event.path, uid);
+                    }
+                }
+            // Virtual Parent Match (CDC Matrix events)
+            const vps = [...('addVps' in event && event.addVps ? event.addVps : []), ...(event.rmVps || [])];
+            for (const vp of vps) {
+                const vpWatchers = prefixToUsers.get(vp);
+                if (vpWatchers) {
+                    for (const uid of vpWatchers) {
+                        if (notified.has(uid))
+                            continue;
+                        notified.add(uid);
+                        const user = users.get(uid);
+                        if (!user)
+                            continue;
+                        pushToUser(uid, event);
+                        if (user.prefixes.get(vp)) {
+                            user.paths.add(event.path);
+                            addTo(pathToUsers, event.path, uid);
+                        }
+                    }
+                }
+            }
+        },
+        clientCount() {
+            let count = 0;
+            for (const user of users.values())
+                count += user.pushes.size;
+            return count;
+        },
+    };
+}
+//# sourceMappingURL=watch.js.map

package/dist/server/watch.js.map

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

package/dist/tree/cache.d.ts

@@ -0,0 +1,3 @@
+import { type Tree } from './index';
+export declare function withCache(store: Tree): Tree;
+//# sourceMappingURL=cache.d.ts.map

package/dist/tree/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/tree/cache.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,IAAI,EAA2C,MAAM,SAAS,CAAC;AAG7E,wBAAgB,SAAS,CAAC,KAAK,EAAE,IAAI,GAAG,IAAI,CAyC3C"}

package/dist/tree/cache.js

@@ -0,0 +1,48 @@
+// Treenity Cache Tree — Layer 1
+// Write-populate tree cache wrapping any Tree.
+// Tree structure mirrors path hierarchy — O(depth) navigation, O(1) subtree drop.
+// Populate on read AND write. Inflight dedup prevents thundering herd.
+import { treeEnsure, treeNavigate } from './index';
+import { createInflight } from './inflight';
+export function withCache(store) {
+    const root = { children: new Map() };
+    const dedup = createInflight();
+    return {
+        async get(path, ctx) {
+            const cached = treeNavigate(root, path);
+            if (cached?.data !== undefined)
+                return cached.data;
+            return dedup(path, async () => {
+                const node = await store.get(path, ctx);
+                if (node)
+                    treeEnsure(root, node.$path).data = node;
+                return node;
+            });
+        },
+        async getChildren(path, opts, ctx) {
+            const result = await store.getChildren(path, opts, ctx);
+            for (const node of result.items)
+                treeEnsure(root, node.$path).data = node;
+            return result;
+        },
+        async set(node, ctx) {
+            await store.set(node, ctx);
+            // Write-populate: re-read to capture $rev bump, warm cache for subscribers
+            const fresh = await store.get(node.$path, ctx);
+            treeEnsure(root, node.$path).data = fresh;
+        },
+        async remove(path, ctx) {
+            const result = await store.remove(path, ctx);
+            const cached = treeNavigate(root, path);
+            if (cached)
+                cached.data = undefined;
+            return result;
+        },
+        async patch(path, ops, ctx) {
+            await store.patch(path, ops, ctx);
+            const fresh = await store.get(path, ctx);
+            treeEnsure(root, path).data = fresh;
+        },
+    };
+}
+//# sourceMappingURL=cache.js.map

package/dist/tree/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/tree/cache.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,+CAA+C;AAC/C,kFAAkF;AAClF,uEAAuE;AAGvE,OAAO,EAAa,UAAU,EAAE,YAAY,EAAiB,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,UAAU,SAAS,CAAC,KAAW;IACnC,MAAM,IAAI,GAAuB,EAAE,QAAQ,EAAE,IAAI,GAAG,EAAE,EAAE,CAAC;IACzD,MAAM,KAAK,GAAG,cAAc,EAAwB,CAAC;IAErD,OAAO;QACL,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG;YACjB,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YACxC,IAAI,MAAM,EAAE,IAAI,KAAK,SAAS;gBAAE,OAAO,MAAM,CAAC,IAAI,CAAC;YACnD,OAAO,KAAK,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE;gBAC5B,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;gBACxC,IAAI,IAAI;oBAAE,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC;gBACnD,OAAO,IAAI,CAAC;YACd,CAAC,CAAC,CAAC;QACL,CAAC;QAED,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG;YAC/B,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;YACxD,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK;gBAAE,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC;YAC1E,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG;YACjB,MAAM,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YAC3B,2EAA2E;YAC3E,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YAC/C,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC;QAC5C,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG;YACpB,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YAC7C,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YACxC,IAAI,MAAM;gBAAE,MAAM,CAAC,IAAI,GAAG,SAAS,CAAC;YACpC,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG;YACxB,MAAM,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;YAClC,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YACzC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC;QACtC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tree/fs.d.ts

@@ -0,0 +1,3 @@
+import type { Tree } from './index';
+export declare function createFsTree(rootDir: string): Promise<Tree>;
+//# sourceMappingURL=fs.d.ts.map

package/dist/tree/fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/tree/fs.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AASpC,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA6OjE"}