@treenity/core 1.0.48 → 3.0.1

package/dist/tree/mimefs.js

@@ -0,0 +1,124 @@
+// Treenity RawFS Tree — Layer 1
+// Bidirectional store that maps real filesystem files to typed nodes.
+// Files become nodes with $type from mime type. Directories become $type "dir".
+// "decode" context: file → node (read). "encode" context: node → file (write).
+import { resolve as ctxResolve } from '#core/registry';
+import { mkdir, readdir, rmdir, stat, unlink } from 'node:fs/promises';
+import { dirname, extname, join, resolve } from 'node:path';
+import { paginate } from './index';
+import './json-codec'; // register JSON decode handler
+import { defaultPatch } from './patch';
+const MIME = {
+    '.jpg': 'image/jpeg', '.jpeg': 'image/jpeg', '.png': 'image/png',
+    '.gif': 'image/gif', '.webp': 'image/webp', '.svg': 'image/svg+xml',
+    '.ico': 'image/x-icon', '.bmp': 'image/bmp',
+    '.mp4': 'video/mp4', '.webm': 'video/webm', '.mov': 'video/quicktime',
+    '.mp3': 'audio/mpeg', '.wav': 'audio/wav', '.ogg': 'audio/ogg', '.flac': 'audio/flac',
+    '.pdf': 'application/pdf', '.zip': 'application/zip', '.gz': 'application/gzip',
+    '.json': 'application/json', '.xml': 'application/xml', '.yaml': 'application/yaml',
+    '.yml': 'application/yaml',
+    '.csv': 'text/csv', '.txt': 'text/plain', '.md': 'text/markdown',
+    '.html': 'text/html', '.css': 'text/css',
+    '.js': 'text/javascript', '.ts': 'text/typescript', '.tsx': 'text/typescript',
+    '.py': 'text/x-python', '.sh': 'text/x-shellscript',
+    '.env': 'application/x-env',
+};
+function getMime(filename) {
+    return MIME[extname(filename).toLowerCase()] ?? 'application/octet-stream';
+}
+export async function createRawFsStore(rootDir) {
+    rootDir = resolve(rootDir);
+    function toFilePath(path) {
+        const full = resolve(join(rootDir, path));
+        if (!full.startsWith(rootDir))
+            throw new Error(`Path traversal blocked`);
+        return full;
+    }
+    async function fileToNode(filePath, nodePath) {
+        const st = await stat(filePath);
+        if (st.isDirectory()) {
+            return { $path: nodePath, $type: 'dir' };
+        }
+        const mime = getMime(filePath);
+        const decode = ctxResolve(mime, 'decode');
+        if (decode)
+            return decode(filePath, nodePath);
+        return {
+            $path: nodePath,
+            $type: mime,
+            meta: { size: st.size, modified: st.mtime.toISOString(), created: st.birthtime.toISOString() },
+        };
+    }
+    const tree = {
+        async get(path) {
+            const file = toFilePath(path);
+            try {
+                return await fileToNode(file, path);
+            }
+            catch (e) {
+                if (e.code === 'ENOENT')
+                    return undefined;
+                throw e;
+            }
+        },
+        async getChildren(parent, opts) {
+            const dir = toFilePath(parent);
+            const depth = opts?.depth ?? 1;
+            const results = [];
+            async function walk(dirPath, parentNodePath, currentDepth) {
+                if (currentDepth > depth)
+                    return;
+                let entries;
+                try {
+                    entries = await readdir(dirPath, { withFileTypes: true });
+                }
+                catch {
+                    return;
+                }
+                for (const e of entries) {
+                    if (e.name.startsWith('.'))
+                        continue; // skip hidden files
+                    const filePath = join(dirPath, e.name);
+                    const nodePath = parentNodePath === '/' ? `/${e.name}` : `${parentNodePath}/${e.name}`;
+                    results.push(await fileToNode(filePath, nodePath));
+                    if (e.isDirectory() && currentDepth < depth) {
+                        await walk(filePath, nodePath, currentDepth + 1);
+                    }
+                }
+            }
+            await walk(dir, parent, 1);
+            return paginate(results, opts);
+        },
+        async set(node) {
+            const filePath = toFilePath(node.$path);
+            const encode = ctxResolve(node.$type, 'encode');
+            if (!encode)
+                throw new Error(`No encode registered for type "${node.$type}"`);
+            await mkdir(dirname(filePath), { recursive: true });
+            await encode(node, filePath);
+        },
+        async remove(path) {
+            const filePath = toFilePath(path);
+            try {
+                const st = await stat(filePath);
+                if (st.isDirectory()) {
+                    await rmdir(filePath);
+                }
+                else {
+                    await unlink(filePath);
+                }
+                return true;
+            }
+            catch (e) {
+                if (e.code === 'ENOENT')
+                    return false;
+                throw e;
+            }
+        },
+        async patch(path, ops, ctx) {
+            return defaultPatch(tree.get, tree.set, path, ops, ctx);
+        },
+    };
+    return tree;
+}
+//# sourceMappingURL=mimefs.js.map

package/dist/tree/mimefs.js.map

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

package/dist/tree/mongo.d.ts

@@ -0,0 +1,5 @@
+import { type Tree } from './index';
+export declare function createMongoTree(uri: string, dbName?: string, collectionName?: string): Promise<Tree & {
+    close(): Promise<void>;
+}>;
+//# sourceMappingURL=mongo.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mongo.d.ts","sourceRoot":"","sources":["../../src/tree/mongo.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,SAAS,CAAC;AA8BpC,wBAAsB,eAAe,CACnC,GAAG,EAAE,MAAM,EACX,MAAM,SAAa,EACnB,cAAc,SAAU,GACvB,OAAO,CAAC,IAAI,GAAG;IAAE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAAC,CAiF5C"}

package/dist/tree/mongo.js

@@ -0,0 +1,110 @@
+// Treenity Mongo Tree — Layer 1
+// Drop-in replacement for MemoryStore.
+import { toStorageKeys, fromStorageKeys } from '#core';
+import { MongoClient } from 'mongodb';
+import { defaultPatch } from './patch';
+const toStorage = (node) => toStorageKeys(node);
+const fromStorage = (doc) => fromStorageKeys(doc);
+// Shared MongoClient pool — one client per URI, reused across mounts
+const clientPool = new Map();
+function getSharedClient(uri) {
+    let entry = clientPool.get(uri);
+    if (!entry) {
+        const client = new MongoClient(uri);
+        const ready = client.connect();
+        entry = { client, refCount: 0, ready };
+        clientPool.set(uri, entry);
+    }
+    entry.refCount++;
+    const release = async () => {
+        const e = clientPool.get(uri);
+        if (!e)
+            return;
+        e.refCount--;
+        if (e.refCount <= 0) {
+            clientPool.delete(uri);
+            await e.client.close();
+        }
+    };
+    return { client: entry.client, ready: entry.ready, release };
+}
+export async function createMongoTree(uri, dbName = 'treenity', collectionName = 'nodes') {
+    const { client, ready, release } = getSharedClient(uri);
+    await ready;
+    const db = client.db(dbName);
+    const col = db.collection(collectionName);
+    await col.createIndex({ _path: 1 }, { unique: true });
+    function buildPattern(parent, depth) {
+        const esc = escapeRegex(parent);
+        const seg = '[^/]+';
+        if (depth === 1)
+            return parent === '/' ? /^\/[^/]+$/ : new RegExp(`^${esc}/${seg}$`);
+        if (depth === Infinity)
+            return parent === '/' ? /^\/.*$/ : new RegExp(`^${esc}/.+`);
+        return parent === '/'
+            ? new RegExp(`^(/${seg}){1,${depth}}$`)
+            : new RegExp(`^${esc}(/${seg}){1,${depth}}$`);
+    }
+    async function paginatedFind(filter, opts) {
+        const total = await col.countDocuments(filter);
+        const cursor = col.find(filter).sort({ _path: 1 });
+        if (opts?.offset)
+            cursor.skip(opts.offset);
+        if (opts?.limit)
+            cursor.limit(opts.limit);
+        const docs = await cursor.toArray();
+        return { items: docs.map((doc) => fromStorage(doc)), total };
+    }
+    const tree = {
+        async get(path, ctx) {
+            const doc = await col.findOne({ _path: path });
+            if (!doc)
+                return undefined;
+            return fromStorage(doc);
+        },
+        async getChildren(parent, opts, ctx) {
+            const depth = opts?.depth ?? 1;
+            const pathQuery = { _path: buildPattern(parent, depth) };
+            const filter = opts?.query ? { $and: [pathQuery, opts.query] } : pathQuery;
+            return paginatedFind(filter, opts);
+        },
+        async set(node, ctx) {
+            const doc = toStorage(node);
+            const prevRev = doc._rev;
+            doc._rev = (prevRev ?? 0) + 1;
+            if (prevRev === undefined) {
+                try {
+                    await col.insertOne(doc);
+                }
+                catch (e) {
+                    if (e.code === 11000)
+                        throw new Error(`OptimisticConcurrencyError: node ${node.$path} already exists`);
+                    throw e;
+                }
+            }
+            else {
+                const result = await col.replaceOne({ _path: doc._path, _rev: prevRev }, doc);
+                if (result.matchedCount === 0) {
+                    throw new Error(`OptimisticConcurrencyError: node ${node.$path} modified by another transaction`);
+                }
+            }
+            node.$rev = doc._rev;
+        },
+        async remove(path) {
+            const result = await col.deleteOne({ _path: path });
+            return result.deletedCount > 0;
+        },
+        // TODO: native Mongo $set — for now, fallback via get+apply+set
+        async patch(path, ops, ctx) {
+            return defaultPatch(tree.get, tree.set, path, ops, ctx);
+        },
+        async close() {
+            await release();
+        },
+    };
+    return tree;
+}
+function escapeRegex(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+//# sourceMappingURL=mongo.js.map

package/dist/tree/mongo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongo.js","sourceRoot":"","sources":["../../src/tree/mongo.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,uCAAuC;AAEvC,OAAO,EAAiB,aAAa,EAAE,eAAe,EAAE,MAAM,OAAO,CAAC;AACtE,OAAO,EAA4B,WAAW,EAAE,MAAM,SAAS,CAAC;AAEhE,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,MAAM,SAAS,GAAG,CAAC,IAAc,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;AAC1D,MAAM,WAAW,GAAG,CAAC,GAA4B,EAAE,EAAE,CAAC,eAAe,CAAC,GAAG,CAAa,CAAC;AAEvF,qEAAqE;AACrE,MAAM,UAAU,GAAG,IAAI,GAAG,EAAkF,CAAC;AAE7G,SAAS,eAAe,CAAC,GAAW;IAClC,IAAI,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAChC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,GAAG,CAAC,CAAC;QACpC,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;QAC/B,KAAK,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC;QACvC,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC7B,CAAC;IACD,KAAK,CAAC,QAAQ,EAAE,CAAC;IACjB,MAAM,OAAO,GAAG,KAAK,IAAI,EAAE;QACzB,MAAM,CAAC,GAAG,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,CAAC,CAAC;YAAE,OAAO;QACf,CAAC,CAAC,QAAQ,EAAE,CAAC;QACb,IAAI,CAAC,CAAC,QAAQ,IAAI,CAAC,EAAE,CAAC;YACpB,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACvB,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACzB,CAAC;IACH,CAAC,CAAC;IACF,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC;AAC/D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,GAAW,EACX,MAAM,GAAG,UAAU,EACnB,cAAc,GAAG,OAAO;IAExB,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;IACxD,MAAM,KAAK,CAAC;IACZ,MAAM,EAAE,GAAO,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;IACjC,MAAM,GAAG,GAAe,EAAE,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;IAEtD,MAAM,GAAG,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAEtD,SAAS,YAAY,CAAC,MAAc,EAAE,KAAa;QACjD,MAAM,GAAG,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;QAChC,MAAM,GAAG,GAAG,OAAO,CAAC;QACpB,IAAI,KAAK,KAAK,CAAC;YAAE,OAAO,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,IAAI,GAAG,IAAI,GAAG,GAAG,CAAC,CAAC;QACrF,IAAI,KAAK,KAAK,QAAQ;YAAE,OAAO,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC;QACpF,OAAO,MAAM,KAAK,GAAG;YACnB,CAAC,CAAC,IAAI,MAAM,CAAC,MAAM,GAAG,OAAO,KAAK,IAAI,CAAC;YACvC,CAAC,CAAC,IAAI,MAAM,CAAC,IAAI,GAAG,KAAK,GAAG,OAAO,KAAK,IAAI,CAAC,CAAC;IAClD,CAAC;IAED,KAAK,UAAU,aAAa,CAC1B,MAA+B,EAC/B,IAA0C;QAE1C,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QAC/C,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;QACnD,IAAI,IAAI,EAAE,MAAM;YAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC3C,IAAI,IAAI,EAAE,KAAK;YAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1C,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;QACpC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,WAAW,CAAC,GAA8B,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;IAC1F,CAAC;IAED,MAAM,IAAI,GAAsC;QAC9C,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG;YACjB,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YAC/C,IAAI,CAAC,GAAG;gBAAE,OAAO,SAAS,CAAC;YAC3B,OAAO,WAAW,CAAC,GAA8B,CAAC,CAAC;QACrD,CAAC;QAED,KAAK,CAAC,WAAW,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG;YACjC,MAAM,KAAK,GAAG,IAAI,EAAE,KAAK,IAAI,CAAC,CAAC;YAC/B,MAAM,SAAS,GAAG,EAAE,KAAK,EAAE,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC;YACzD,MAAM,MAAM,GAAG,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;YAC3E,OAAO,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACrC,CAAC;QAED,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG;YACjB,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;YAC5B,MAAM,OAAO,GAAG,GAAG,CAAC,IAA0B,CAAC;YAC/C,GAAG,CAAC,IAAI,GAAG,CAAC,OAAO,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;YAE9B,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;gBACzB,IAAI,CAAC;oBACH,MAAM,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;gBAC3B,CAAC;gBAAC,OAAM,CAAM,EAAE,CAAC;oBACf,IAAI,CAAC,CAAC,IAAI,KAAK,KAAK;wBAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,IAAI,CAAC,KAAK,iBAAiB,CAAC,CAAC;oBACvG,MAAM,CAAC,CAAC;gBACV,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACL,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,GAAG,CAAC,CAAC;gBAC9E,IAAI,MAAM,CAAC,YAAY,KAAK,CAAC,EAAE,CAAC;oBAC9B,MAAM,IAAI,KAAK,CAAC,oCAAoC,IAAI,CAAC,KAAK,kCAAkC,CAAC,CAAC;gBACpG,CAAC;YACJ,CAAC;YACD,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,IAAc,CAAC;QACjC,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,IAAI;YACf,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YACpD,OAAO,MAAM,CAAC,YAAY,GAAG,CAAC,CAAC;QACjC,CAAC;QAED,gEAAgE;QAChE,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG;YACxB,OAAO,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;QAC1D,CAAC;QAED,KAAK,CAAC,KAAK;YACT,MAAM,OAAO,EAAE,CAAC;QAClB,CAAC;KACF,CAAC;IAEF,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,WAAW,CAAC,CAAS;IAC5B,OAAO,CAAC,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AAClD,CAAC"}

package/dist/tree/patch.d.ts

@@ -0,0 +1,30 @@
+import type { NodeData } from '#core';
+export type PatchOp = readonly ['t', string, unknown] | readonly ['r', string, unknown] | readonly ['a', string, unknown] | readonly ['d', string];
+export type Rfc6902Op = {
+    op: 'test';
+    path: string;
+    value: unknown;
+} | {
+    op: 'replace';
+    path: string;
+    value: unknown;
+} | {
+    op: 'add';
+    path: string;
+    value: unknown;
+} | {
+    op: 'remove';
+    path: string;
+};
+export declare class PatchTestError extends Error {
+    field: string;
+    expected: unknown;
+    actual: unknown;
+    code: "TEST_FAILED";
+    constructor(field: string, expected: unknown, actual: unknown);
+}
+export declare function applyOps(target: Record<string, unknown>, ops: readonly PatchOp[]): void;
+export declare function toRfc6902(ops: readonly PatchOp[]): Rfc6902Op[];
+export declare function fromRfc6902(ops: readonly Rfc6902Op[]): PatchOp[];
+export declare function defaultPatch(get: (path: string, ctx?: unknown) => Promise<NodeData | undefined>, set: (node: NodeData, ctx?: unknown) => Promise<void>, path: string, ops: readonly PatchOp[], ctx?: unknown): Promise<void>;
+//# sourceMappingURL=patch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"patch.d.ts","sourceRoot":"","sources":["../../src/tree/patch.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAItC,MAAM,MAAM,OAAO,GACf,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,GAC/B,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,GAC/B,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,GAC/B,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;AAE1B,MAAM,MAAM,SAAS,GACjB;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAC5C;IAAE,EAAE,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAC/C;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAC3C;IAAE,EAAE,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAElC,qBAAa,cAAe,SAAQ,KAAK;IAEpB,KAAK,EAAE,MAAM;IAAS,QAAQ,EAAE,OAAO;IAAS,MAAM,EAAE,OAAO;IADlF,IAAI,EAAG,aAAa,CAAU;gBACX,KAAK,EAAE,MAAM,EAAS,QAAQ,EAAE,OAAO,EAAS,MAAM,EAAE,OAAO;CAGnF;AAID,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,SAAS,OAAO,EAAE,GAAG,IAAI,CA0BvF;AAuCD,wBAAgB,SAAS,CAAC,GAAG,EAAE,SAAS,OAAO,EAAE,GAAG,SAAS,EAAE,CAU9D;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,SAAS,SAAS,EAAE,GAAG,OAAO,EAAE,CAUhE;AAID,wBAAsB,YAAY,CAChC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,EACnE,GAAG,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,EACrD,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,SAAS,OAAO,EAAE,EACvB,GAAG,CAAC,EAAE,OAAO,GACZ,OAAO,CAAC,IAAI,CAAC,CAMf"}

package/dist/tree/patch.js

@@ -0,0 +1,112 @@
+// Treenity Patch — Layer 1
+// Compact [op, path, value?] tuples with dot-notation paths.
+// Maps 1:1 to RFC 6902 JSON Patch.
+export class PatchTestError extends Error {
+    field;
+    expected;
+    actual;
+    code = 'TEST_FAILED';
+    constructor(field, expected, actual) {
+        super(`Patch test failed: ${field}`);
+        this.field = field;
+        this.expected = expected;
+        this.actual = actual;
+    }
+}
+// ── Apply ops to object in-place ──
+export function applyOps(target, ops) {
+    for (const op of ops) {
+        switch (op[0]) {
+            case 't': {
+                const actual = getByPath(target, op[1]);
+                if (actual !== op[2])
+                    throw new PatchTestError(op[1], op[2], actual);
+                break;
+            }
+            case 'r':
+                setByPath(target, op[1], op[2]);
+                break;
+            case 'a':
+                if (op[1].endsWith('.-')) {
+                    const arrPath = op[1].slice(0, -2);
+                    const arr = getByPath(target, arrPath);
+                    if (!Array.isArray(arr))
+                        throw new Error(`add: ${arrPath} is not an array`);
+                    arr.push(op[2]);
+                }
+                else {
+                    setByPath(target, op[1], op[2]);
+                }
+                break;
+            case 'd':
+                deleteByPath(target, op[1]);
+                break;
+        }
+    }
+}
+// ── Path helpers (dot notation) ──
+function getByPath(obj, path) {
+    const parts = path.split('.');
+    let cur = obj;
+    for (const p of parts) {
+        if (cur == null || typeof cur !== 'object')
+            return undefined;
+        cur = cur[p];
+    }
+    return cur;
+}
+function setByPath(obj, path, value) {
+    const parts = path.split('.');
+    let cur = obj;
+    for (let i = 0; i < parts.length - 1; i++) {
+        if (cur[parts[i]] == null || typeof cur[parts[i]] !== 'object')
+            cur[parts[i]] = {};
+        cur = cur[parts[i]];
+    }
+    cur[parts[parts.length - 1]] = value;
+}
+function deleteByPath(obj, path) {
+    const parts = path.split('.');
+    let cur = obj;
+    for (let i = 0; i < parts.length - 1; i++) {
+        if (cur[parts[i]] == null)
+            return;
+        cur = cur[parts[i]];
+    }
+    delete cur[parts[parts.length - 1]];
+}
+// ── RFC 6902 conversion ──
+function dotToSlash(p) { return '/' + p.replace(/\./g, '/'); }
+function slashToDot(p) { return p.slice(1).replace(/\//g, '.'); }
+export function toRfc6902(ops) {
+    return ops.map(op => {
+        const path = dotToSlash(op[1]);
+        switch (op[0]) {
+            case 't': return { op: 'test', path, value: op[2] };
+            case 'r': return { op: 'replace', path, value: op[2] };
+            case 'a': return { op: 'add', path, value: op[2] };
+            case 'd': return { op: 'remove', path };
+        }
+    });
+}
+export function fromRfc6902(ops) {
+    return ops.map(op => {
+        const path = slashToDot(op.path);
+        switch (op.op) {
+            case 'test': return ['t', path, op.value];
+            case 'replace': return ['r', path, op.value];
+            case 'add': return ['a', path, op.value];
+            case 'remove': return ['d', path];
+        }
+    });
+}
+// ── Default patch: get → apply → set (fallback for adapters without native patch) ──
+export async function defaultPatch(get, set, path, ops, ctx) {
+    const node = await get(path, ctx);
+    if (!node)
+        throw new Error(`Node not found: ${path}`);
+    const copy = structuredClone(node);
+    applyOps(copy, ops);
+    await set(copy, ctx);
+}
+//# sourceMappingURL=patch.js.map

package/dist/tree/patch.js.map

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

package/dist/tree/query.d.ts

@@ -0,0 +1,12 @@
+import { type NodeData } from '#core';
+import { type Tree } from './index';
+export type QueryConfig = {
+    source: string;
+    match: Record<string, unknown>;
+};
+export declare function mapSiftQuery(q: unknown): unknown;
+export declare function mapNodeForSift(node: NodeData): Record<string, unknown>;
+export declare function createSiftTest(match: Record<string, unknown>): (node: Record<string, unknown>) => boolean;
+export declare function matchesFilter(node: NodeData, match: Record<string, unknown>): boolean;
+export declare function createQueryTree(config: QueryConfig, parentStore: Tree): Tree;
+//# sourceMappingURL=query.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/tree/query.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,QAAQ,EAAiB,MAAM,OAAO,CAAC;AAErD,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,SAAS,CAAC;AAEpC,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,CAAC;AAEF,wBAAgB,YAAY,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAgBhD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEtE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAEzG;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAErF;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,IAAI,GAAG,IAAI,CA0B5E"}

package/dist/tree/query.js

@@ -0,0 +1,61 @@
+// Treenity Query Tree — Layer 1
+// Virtual filtered view over a parent store's children.
+// Used by t.mount.query to create virtual folders (e.g., /orders/incoming shows orders where status.value === 'incoming').
+import { toStorageKeys } from '#core';
+import sift from 'sift';
+export function mapSiftQuery(q) {
+    if (Array.isArray(q))
+        return q.map(mapSiftQuery);
+    if (q && typeof q === 'object' && q.constructor === Object) {
+        const out = {};
+        for (const [k, v] of Object.entries(q)) {
+            let newKey = k;
+            if (k === '$type')
+                newKey = '_type';
+            else if (k === '$path')
+                newKey = '_path';
+            else if (k === '$acl')
+                newKey = '_acl';
+            else if (k === '$owner')
+                newKey = '_owner';
+            else if (k === '$rev')
+                newKey = '_rev';
+            out[newKey] = mapSiftQuery(v);
+        }
+        return out;
+    }
+    return q;
+}
+export function mapNodeForSift(node) {
+    return toStorageKeys(node);
+}
+export function createSiftTest(match) {
+    return sift(mapSiftQuery(match));
+}
+export function matchesFilter(node, match) {
+    return sift(mapSiftQuery(match))(mapNodeForSift(node));
+}
+export function createQueryTree(config, parentStore) {
+    return {
+        async get(path, ctx) {
+            return parentStore.get(path, ctx);
+        },
+        async getChildren(_path, opts, ctx) {
+            // Pass ctx properly to ensure auth/context flows through the query mount
+            const mappedQuery = mapSiftQuery(config.match);
+            const mergedQuery = opts?.query ? { $and: [opts.query, mappedQuery] } : mappedQuery;
+            const res = await parentStore.getChildren(config.source, { ...opts, depth: 1, query: mergedQuery }, ctx);
+            return { ...res, queryMount: { source: config.source, match: config.match } };
+        },
+        async set(node, ctx) {
+            return parentStore.set(node, ctx);
+        },
+        async remove(path, ctx) {
+            return parentStore.remove(path, ctx);
+        },
+        async patch(path, ops, ctx) {
+            return parentStore.patch(path, ops, ctx);
+        },
+    };
+}
+//# sourceMappingURL=query.js.map

package/dist/tree/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../src/tree/query.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,wDAAwD;AACxD,2HAA2H;AAE3H,OAAO,EAAiB,aAAa,EAAE,MAAM,OAAO,CAAC;AACrD,OAAO,IAAI,MAAM,MAAM,CAAC;AAQxB,MAAM,UAAU,YAAY,CAAC,CAAU;IACrC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IACjD,IAAI,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,WAAW,KAAK,MAAM,EAAE,CAAC;QAC3D,MAAM,GAAG,GAA4B,EAAE,CAAC;QACxC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;YACvC,IAAI,MAAM,GAAG,CAAC,CAAC;YACf,IAAI,CAAC,KAAK,OAAO;gBAAE,MAAM,GAAG,OAAO,CAAC;iBAC/B,IAAI,CAAC,KAAK,OAAO;gBAAE,MAAM,GAAG,OAAO,CAAC;iBACpC,IAAI,CAAC,KAAK,MAAM;gBAAE,MAAM,GAAG,MAAM,CAAC;iBAClC,IAAI,CAAC,KAAK,QAAQ;gBAAE,MAAM,GAAG,QAAQ,CAAC;iBACtC,IAAI,CAAC,KAAK,MAAM;gBAAE,MAAM,GAAG,MAAM,CAAC;YACvC,GAAG,CAAC,MAAM,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;QAChC,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAc;IAC3C,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAA8B;IAC3D,OAAO,IAAI,CAAC,YAAY,CAAC,KAAK,CAA4B,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAc,EAAE,KAA8B;IAC1E,OAAO,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAAmB,EAAE,WAAiB;IACpE,OAAO;QACL,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG;YACjB,OAAO,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACpC,CAAC;QAED,KAAK,CAAC,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG;YAChC,yEAAyE;YACzE,MAAM,WAAW,GAAG,YAAY,CAAC,MAAM,CAAC,KAAK,CAA4B,CAAC;YAC1E,MAAM,WAAW,GAAG,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC;YACpF,MAAM,GAAG,GAAG,MAAM,WAAW,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,GAAG,CAAC,CAAC;YACzG,OAAO,EAAE,GAAG,GAAG,EAAE,UAAU,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC;QAChF,CAAC;QAED,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG;YACjB,OAAO,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACpC,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG;YACpB,OAAO,WAAW,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACvC,CAAC;QAED,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG;YACxB,OAAO,WAAW,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;QAC3C,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tree/repath.d.ts

@@ -0,0 +1,3 @@
+import type { Tree } from './index';
+export declare function createRepathTree(inner: Tree, localBase: string, remoteBase?: string): Tree;
+//# sourceMappingURL=repath.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"repath.d.ts","sourceRoot":"","sources":["../../src/tree/repath.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAQ,IAAI,EAAE,MAAM,SAAS,CAAC;AAE1C,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,GAAE,MAAY,GAAG,IAAI,CA2C/F"}

package/dist/tree/repath.js

@@ -0,0 +1,38 @@
+// Path-rewriting Tree combinator — mounts a remote tree at a local prefix.
+// Like Linux mount: remote /strategies/x ↔ local /app/live/strategies/x
+//
+// localBase:  where the tree is mounted in our namespace (e.g. '/app/live')
+// remoteBase: root of the remote tree to use (e.g. '/', or '/data' for a subtree)
+export function createRepathTree(inner, localBase, remoteBase = '/') {
+    // Normalize: strip trailing slashes, handle root
+    const lb = localBase === '/' ? '' : localBase;
+    const rb = remoteBase === '/' ? '' : remoteBase;
+    function toRemote(localPath) {
+        const rest = localPath.slice(lb.length);
+        return rb + rest || '/';
+    }
+    function toLocal(remotePath) {
+        const rest = remotePath.slice(rb.length);
+        return lb + rest || '/';
+    }
+    function remapNode(node) {
+        return { ...node, $path: toLocal(node.$path) };
+    }
+    function remapPage(page) {
+        return { ...page, items: page.items.map(remapNode) };
+    }
+    return {
+        get: async (path, ctx) => {
+            const node = await inner.get(toRemote(path), ctx);
+            return node ? remapNode(node) : undefined;
+        },
+        getChildren: async (path, opts, ctx) => {
+            const page = await inner.getChildren(toRemote(path), opts, ctx);
+            return remapPage(page);
+        },
+        set: (node, ctx) => inner.set({ ...node, $path: toRemote(node.$path) }, ctx),
+        remove: (path, ctx) => inner.remove(toRemote(path), ctx),
+        patch: (path, ops, ctx) => inner.patch(toRemote(path), ops, ctx),
+    };
+}
+//# sourceMappingURL=repath.js.map

package/dist/tree/repath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repath.js","sourceRoot":"","sources":["../../src/tree/repath.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,wEAAwE;AACxE,EAAE;AACF,4EAA4E;AAC5E,kFAAkF;AAKlF,MAAM,UAAU,gBAAgB,CAAC,KAAW,EAAE,SAAiB,EAAE,aAAqB,GAAG;IACvF,iDAAiD;IACjD,MAAM,EAAE,GAAG,SAAS,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAC9C,MAAM,EAAE,GAAG,UAAU,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC;IAEhD,SAAS,QAAQ,CAAC,SAAiB;QACjC,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;QACxC,OAAO,EAAE,GAAG,IAAI,IAAI,GAAG,CAAC;IAC1B,CAAC;IAED,SAAS,OAAO,CAAC,UAAkB;QACjC,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;QACzC,OAAO,EAAE,GAAG,IAAI,IAAI,GAAG,CAAC;IAC1B,CAAC;IAED,SAAS,SAAS,CAAC,IAAc;QAC/B,OAAO,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;IACjD,CAAC;IAED,SAAS,SAAS,CAAC,IAAoB;QACrC,OAAO,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;IACvD,CAAC;IAED,OAAO;QACL,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;YACvB,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;YAClD,OAAO,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC5C,CAAC;QAED,WAAW,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;YACrC,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;YAChE,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;QAED,GAAG,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,CACjB,KAAK,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,GAAG,CAAC;QAE1D,MAAM,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,CACpB,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC;QAEnC,KAAK,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,CACxB,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC;KACxC,CAAC;AACJ,CAAC"}

package/dist/tree-chain.d.ts

@@ -0,0 +1,19 @@
+import { type Class, type Raw, type TypeClass } from '#comp';
+import { type NodeData } from '#core';
+import type { Tree } from '#tree';
+import type { Chain } from './chain';
+type TreeChainAPI = {
+    <T>(cls: TypeClass<T>): Chain<T>;
+    readonly $path: string;
+    $get<T>(cls: Class<T>, key?: string): Chain<T>;
+    $field(key: string): Chain<any>;
+    $children(query?: Record<string, unknown>): Promise<NodeData[]>;
+    $set<T>(cls: Class<T>, data?: Partial<Raw<T>>): Promise<void>;
+    then<R1 = NodeData, R2 = never>(onfulfilled?: ((value: NodeData) => R1 | PromiseLike<R1>) | null, onrejected?: ((reason: any) => R2 | PromiseLike<R2>) | null): Promise<R1 | R2>;
+};
+export type TreeChain = TreeChainAPI & {
+    [k: string]: TreeChain;
+};
+export declare function treeChain(tree: Tree, basePath?: string): TreeChain;
+export {};
+//# sourceMappingURL=tree-chain.d.ts.map

package/dist/tree-chain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-chain.d.ts","sourceRoot":"","sources":["../src/tree-chain.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,KAAK,EAAE,KAAK,GAAG,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAC7D,OAAO,EAAoC,KAAK,QAAQ,EAA0B,MAAM,OAAO,CAAC;AAChG,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;AAClC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAUrC,KAAK,YAAY,GAAG;IAClB,CAAC,CAAC,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;IAC9C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAA;IAC/B,SAAS,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAA;IAC/D,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC7D,IAAI,CAAC,EAAE,GAAG,QAAQ,EAAE,EAAE,GAAG,KAAK,EAC5B,WAAW,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,QAAQ,KAAK,EAAE,GAAG,WAAW,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,EAChE,UAAU,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,GAAG,KAAK,EAAE,GAAG,WAAW,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,GAC1D,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC,CAAA;CACpB,CAAA;AAED,MAAM,MAAM,SAAS,GAAG,YAAY,GAAG;IAAE,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAA;AAkHjE,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAKlE"}