@treenity/core 1.0.47 → 3.0.0

package/dist/mod/examples/ticker/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/mod/examples/ticker/types.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAErC,8DAA8D;AAC9D,MAAM,OAAO,YAAY;IACvB,MAAM,GAAG,KAAK,CAAC;IACf,WAAW,GAAG,EAAE,CAAC;IAEjB,sDAAsD;IACtD,SAAS,CAAC,IAA6C;QACrD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;IACtC,CAAC;CACF;AACD,YAAY,CAAC,eAAe,EAAE,YAAY,CAAC,CAAC;AAE5C,0DAA0D;AAC1D,MAAM,OAAO,WAAW;IACtB,KAAK,GAAG,CAAC,CAAC;IACV,EAAE,GAAG,CAAC,CAAC;CACR;AACD,YAAY,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC"}

package/dist/mod/examples/ticker/view.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=view.d.ts.map

package/dist/mod/examples/ticker/view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view.d.ts","sourceRoot":"","sources":["../../../../src/mod/examples/ticker/view.tsx"],"names":[],"mappings":""}

package/dist/mod/examples/ticker/view.js

@@ -0,0 +1,10 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { register } from '#core';
+import { useCurrentNode } from '@treenity/react/context';
+import { useChildren } from '@treenity/react/hooks';
+register('ticker', 'react', () => {
+    const node = useCurrentNode();
+    const prices = useChildren(node.$path, { limit: 20, watchNew: true });
+    return (_jsxs("div", { className: "space-y-1 p-2", children: [_jsx("h3", { className: "font-bold", children: node.$path }), prices.map(p => (_jsxs("div", { className: "text-sm font-mono", children: ["$", p.price?.toFixed(2), " \u2014 ", new Date(p.ts).toLocaleTimeString()] }, p.$path)))] }));
+});
+//# sourceMappingURL=view.js.map

package/dist/mod/examples/ticker/view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"view.js","sourceRoot":"","sources":["../../../../src/mod/examples/ticker/view.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE;IAC/B,MAAM,IAAI,GAAG,cAAc,EAAE,CAAC;IAC9B,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAEtE,OAAO,CACL,eAAK,SAAS,EAAC,eAAe,aAC5B,aAAI,SAAS,EAAC,WAAW,YAAE,IAAI,CAAC,KAAK,GAAM,EAC1C,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CACf,eAAmB,SAAS,EAAC,mBAAmB,kBAC3C,CAAS,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,cAAK,IAAI,IAAI,CAAE,CAAS,CAAC,EAAE,CAAC,CAAC,kBAAkB,EAAE,KADvE,CAAC,CAAC,KAAK,CAEX,CACP,CAAC,IACE,CACP,CAAC;AACJ,CAAC,CAAC,CAAC"}

package/dist/mod/index.d.ts

@@ -0,0 +1,11 @@
+export { defineMod } from './types';
+export type { TreenityMod, ModManifest, ModState, LoadedMod } from './types';
+export { discoverMods } from './discover';
+export { sortByDependencies, loadMods, loadLocalMods, getLoadedMods, getMod, isModLoaded, clearModRegistry } from './loader';
+export type { LoadTarget, LoadResult } from './loader';
+export { OptimisticBuffer } from './optimistic';
+export type { PendingMutation } from './optimistic';
+export { registerPrefab, getPrefab, getModPrefabs, getRegisteredMods, getSeedPrefabs, clearPrefabs } from './prefab';
+export type { PrefabSetup, PrefabMeta, PrefabEntry } from './prefab';
+export { getTypesForMod, inferModFromType, clearTracking } from './tracking';
+//# sourceMappingURL=index.d.ts.map

package/dist/mod/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mod/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,QAAQ,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC7H,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,aAAa,EAAE,iBAAiB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACrH,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/mod/index.js

@@ -0,0 +1,8 @@
+// Treenity Module System — public API
+export { defineMod } from './types';
+export { discoverMods } from './discover';
+export { sortByDependencies, loadMods, loadLocalMods, getLoadedMods, getMod, isModLoaded, clearModRegistry } from './loader';
+export { OptimisticBuffer } from './optimistic';
+export { registerPrefab, getPrefab, getModPrefabs, getRegisteredMods, getSeedPrefabs, clearPrefabs } from './prefab';
+export { getTypesForMod, inferModFromType, clearTracking } from './tracking';
+//# sourceMappingURL=index.js.map

package/dist/mod/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mod/index.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAEtC,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,QAAQ,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE7H,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,aAAa,EAAE,iBAAiB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAErH,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/mod/loader.d.ts

@@ -0,0 +1,18 @@
+import type { Tree } from '#tree';
+import type { LoadedMod, ModManifest } from './types';
+export declare function sortByDependencies(mods: ModManifest[]): ModManifest[];
+export declare function getLoadedMods(): LoadedMod[];
+export declare function getMod(name: string): LoadedMod | undefined;
+export declare function isModLoaded(name: string): boolean;
+export declare function clearModRegistry(): void;
+export type LoadTarget = 'server' | 'client';
+export interface LoadResult {
+    loaded: string[];
+    failed: {
+        name: string;
+        error: Error;
+    }[];
+}
+export declare function loadMods(manifests: ModManifest[], target: LoadTarget, store?: Tree): Promise<LoadResult>;
+export declare function loadLocalMods(modsDir: string, target: LoadTarget): Promise<LoadResult>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/mod/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/mod/loader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;AAIlC,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAe,MAAM,SAAS,CAAC;AAInE,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE,CAuCrE;AAMD,wBAAgB,aAAa,IAAI,SAAS,EAAE,CAE3C;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAE1D;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AAID,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE7C,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,EAAE,CAAC;CAC1C;AAED,wBAAsB,QAAQ,CAC5B,SAAS,EAAE,WAAW,EAAE,EACxB,MAAM,EAAE,UAAU,EAClB,KAAK,CAAC,EAAE,IAAI,GACX,OAAO,CAAC,UAAU,CAAC,CAiDrB;AAID,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAoC5F"}

package/dist/mod/loader.js

@@ -0,0 +1,154 @@
+// Treenity Module Loader — dependency sort, load, seed
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
+import { readdir, stat } from 'node:fs/promises';
+import { join } from 'node:path';
+import { setCurrentMod } from './tracking';
+// ── Dependency sorting (Kahn's algorithm) ──
+export function sortByDependencies(mods) {
+    const byName = new Map(mods.map(m => [m.name, m]));
+    const inDegree = new Map();
+    const adj = new Map();
+    for (const m of mods) {
+        if (!inDegree.has(m.name))
+            inDegree.set(m.name, 0);
+        if (!adj.has(m.name))
+            adj.set(m.name, []);
+        for (const dep of m.dependencies ?? []) {
+            if (!byName.has(dep))
+                throw new Error(`Mod "${m.name}" depends on unknown mod "${dep}"`);
+            if (!adj.has(dep))
+                adj.set(dep, []);
+            adj.get(dep).push(m.name);
+            inDegree.set(m.name, (inDegree.get(m.name) ?? 0) + 1);
+        }
+    }
+    const queue = [];
+    for (const [name, deg] of inDegree) {
+        if (deg === 0)
+            queue.push(name);
+    }
+    const sorted = [];
+    while (queue.length > 0) {
+        const name = queue.shift();
+        sorted.push(byName.get(name));
+        for (const next of adj.get(name) ?? []) {
+            const deg = inDegree.get(next) - 1;
+            inDegree.set(next, deg);
+            if (deg === 0)
+                queue.push(next);
+        }
+    }
+    if (sorted.length !== mods.length) {
+        const stuck = mods.filter(m => !sorted.includes(m)).map(m => m.name);
+        throw new Error(`Circular dependency among mods: ${stuck.join(', ')}`);
+    }
+    return sorted;
+}
+// ── Registry of loaded mods ──
+const loaded = new Map();
+export function getLoadedMods() {
+    return [...loaded.values()];
+}
+export function getMod(name) {
+    return loaded.get(name);
+}
+export function isModLoaded(name) {
+    return loaded.get(name)?.state === 'loaded';
+}
+export function clearModRegistry() {
+    loaded.clear();
+}
+export async function loadMods(manifests, target, store) {
+    const sorted = sortByDependencies(manifests);
+    const result = { loaded: [], failed: [] };
+    for (const manifest of sorted) {
+        const entry = { name: manifest.name, manifest, state: 'loading' };
+        loaded.set(manifest.name, entry);
+        try {
+            for (const dep of manifest.dependencies ?? []) {
+                if (!isModLoaded(dep))
+                    throw new Error(`Dependency "${dep}" not loaded`);
+            }
+            const entryPath = target === 'server' ? manifest.server : manifest.client;
+            let mod;
+            if (entryPath && manifest.packagePath) {
+                const fullPath = join(manifest.packagePath, entryPath);
+                setCurrentMod(manifest.name);
+                const exported = await import(__rewriteRelativeImportExtension(fullPath));
+                setCurrentMod(null);
+                mod = exported.default;
+            }
+            if (mod?.onLoad)
+                await mod.onLoad();
+            // Seed (server-only, needs store)
+            if (target === 'server' && store) {
+                if (mod?.seed) {
+                    await mod.seed(store);
+                }
+                else if (manifest.seed && manifest.packagePath) {
+                    const seedMod = await import(__rewriteRelativeImportExtension(join(manifest.packagePath, manifest.seed)));
+                    await seedMod.default(store);
+                }
+            }
+            entry.mod = mod;
+            entry.state = 'loaded';
+            entry.loadedAt = Date.now();
+            result.loaded.push(manifest.name);
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            entry.state = 'failed';
+            entry.error = error;
+            result.failed.push({ name: manifest.name, error });
+        }
+    }
+    return result;
+}
+// ── Local mod loader (side-effect imports from src/mods/) ──
+export async function loadLocalMods(modsDir, target) {
+    const result = { loaded: [], failed: [] };
+    const entryFile = target === 'server' ? 'server.ts' : 'client.ts';
+    let entries;
+    try {
+        entries = await readdir(modsDir, { withFileTypes: true });
+    }
+    catch {
+        return result;
+    }
+    for (const entry of entries) {
+        if (!entry.isDirectory() || entry.name.startsWith('.'))
+            continue;
+        const filePath = join(modsDir, entry.name, entryFile);
+        try {
+            await stat(filePath);
+        }
+        catch {
+            continue;
+        }
+        const modEntry = { name: entry.name, state: 'loading' };
+        loaded.set(entry.name, modEntry);
+        try {
+            setCurrentMod(entry.name);
+            await import(__rewriteRelativeImportExtension(filePath));
+            setCurrentMod(null);
+            modEntry.state = 'loaded';
+            modEntry.loadedAt = Date.now();
+            result.loaded.push(entry.name);
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            modEntry.state = 'failed';
+            modEntry.error = error;
+            result.failed.push({ name: entry.name, error });
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=loader.js.map

package/dist/mod/loader.js.map

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

package/dist/mod/optimistic.d.ts

@@ -0,0 +1,34 @@
+import { type NodeData } from '#core';
+export interface PendingMutation {
+    id: string;
+    path: string;
+    compType: string;
+    action: string;
+    predicted: NodeData;
+    baseline: NodeData;
+    method: (target: any, data: unknown) => void;
+    data: unknown;
+    createdAt: number;
+}
+export declare class OptimisticBuffer {
+    private pending;
+    private idCounter;
+    apply(node: NodeData, compType: string, action: string, method: (target: any, data: unknown) => void, data: unknown): {
+        predicted: NodeData;
+        mutationId: string;
+    };
+    confirm(path: string, serverNode: NodeData): {
+        node: NodeData;
+        rolledBack: boolean;
+    };
+    private rebase;
+    confirmById(mutationId: string): boolean;
+    rollback(path: string): NodeData | undefined;
+    rollbackById(mutationId: string): NodeData | undefined;
+    getOptimistic(path: string): NodeData | undefined;
+    hasPending(path: string): boolean;
+    getPendingCount(path?: string): number;
+    expire(maxAge: number): string[];
+    clear(): void;
+}
+//# sourceMappingURL=optimistic.d.ts.map

package/dist/mod/optimistic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"optimistic.d.ts","sourceRoot":"","sources":["../../src/mod/optimistic.ts"],"names":[],"mappings":"AAIA,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEpD,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,QAAQ,CAAC;IACpB,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IAC7C,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,OAAO,CAAwC;IACvD,OAAO,CAAC,SAAS,CAAK;IAGtB,KAAK,CACH,IAAI,EAAE,QAAQ,EACd,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,KAAK,IAAI,EAC5C,IAAI,EAAE,OAAO,GACZ;QAAE,SAAS,EAAE,QAAQ,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE;IA+B9C,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,GAAG;QAAE,IAAI,EAAE,QAAQ,CAAC;QAAC,UAAU,EAAE,OAAO,CAAA;KAAE;IA4BpF,OAAO,CAAC,MAAM;IA+Bd,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAaxC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAS5C,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IActD,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAMjD,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAKjC,eAAe,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM;IAQtC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE;IAiBhC,KAAK,IAAI,IAAI;CAGd"}

package/dist/mod/optimistic.js

@@ -0,0 +1,176 @@
+// Treenity Optimistic Updates — predict locally, reconcile with server
+// Component class methods are the shared kernel: same code runs on client (optimistic)
+// and server (authoritative). Server patches confirm or override.
+import { getComponent } from '#core';
+export class OptimisticBuffer {
+    pending = new Map();
+    idCounter = 0;
+    // Apply an action optimistically: clone node, run method, store prediction
+    apply(node, compType, action, method, data) {
+        const baseline = structuredClone(node);
+        const draft = structuredClone(node);
+        // Find the component (or node itself) matching compType
+        const target = getComponent(draft, compType);
+        if (!target)
+            throw new Error(`Component "${compType}" not found on node ${node.$path}`);
+        method(target, data);
+        const id = `opt_${++this.idCounter}_${Date.now()}`;
+        const mutation = {
+            id,
+            path: node.$path,
+            compType,
+            action,
+            predicted: draft,
+            baseline,
+            method,
+            data,
+            createdAt: Date.now(),
+        };
+        if (!this.pending.has(node.$path))
+            this.pending.set(node.$path, []);
+        this.pending.get(node.$path).push(mutation);
+        return { predicted: draft, mutationId: id };
+    }
+    // Server confirmed a new state. Reconcile with pending mutations.
+    // Returns the node to use and whether any rollback happened.
+    confirm(path, serverNode) {
+        const mutations = this.pending.get(path);
+        if (!mutations || mutations.length === 0) {
+            return { node: serverNode, rolledBack: false };
+        }
+        // Find the first pending mutation that this server update might confirm
+        const first = mutations[0];
+        // Compare server result with our prediction
+        if (nodesMatch(serverNode, first.predicted)) {
+            // Prediction was correct — drop this mutation
+            mutations.shift();
+            if (mutations.length === 0)
+                this.pending.delete(path);
+            // If more pending mutations, rebase them on the confirmed state
+            if (mutations.length > 0) {
+                return { node: this.rebase(path, serverNode), rolledBack: false };
+            }
+            return { node: serverNode, rolledBack: false };
+        }
+        // Prediction was wrong — server wins, drop ALL pending for this path
+        this.pending.delete(path);
+        return { node: serverNode, rolledBack: true };
+    }
+    // Rebase remaining mutations on top of a new base state
+    rebase(path, base) {
+        const mutations = this.pending.get(path);
+        if (!mutations || mutations.length === 0)
+            return base;
+        // Replay each pending mutation on top of the new base
+        let current = base;
+        const surviving = [];
+        for (const m of mutations) {
+            try {
+                const draft = structuredClone(current);
+                const target = getComponent(draft, m.compType);
+                if (!target)
+                    continue;
+                m.method(target, m.data);
+                m.baseline = current;
+                m.predicted = draft;
+                current = draft;
+                surviving.push(m);
+            }
+            catch {
+                // Mutation no longer valid on new base — drop it
+            }
+        }
+        if (surviving.length === 0)
+            this.pending.delete(path);
+        else
+            this.pending.set(path, surviving);
+        return current;
+    }
+    // Confirm a specific mutation by ID
+    confirmById(mutationId) {
+        for (const [path, mutations] of this.pending) {
+            const idx = mutations.findIndex(m => m.id === mutationId);
+            if (idx !== -1) {
+                mutations.splice(idx, 1);
+                if (mutations.length === 0)
+                    this.pending.delete(path);
+                return true;
+            }
+        }
+        return false;
+    }
+    // Rollback all pending mutations for a path
+    rollback(path) {
+        const mutations = this.pending.get(path);
+        if (!mutations || mutations.length === 0)
+            return undefined;
+        const baseline = mutations[0].baseline;
+        this.pending.delete(path);
+        return baseline;
+    }
+    // Rollback a specific mutation by ID, return baseline
+    rollbackById(mutationId) {
+        for (const [path, mutations] of this.pending) {
+            const idx = mutations.findIndex(m => m.id === mutationId);
+            if (idx !== -1) {
+                const baseline = mutations[idx].baseline;
+                mutations.splice(idx, 1);
+                if (mutations.length === 0)
+                    this.pending.delete(path);
+                return baseline;
+            }
+        }
+        return undefined;
+    }
+    // Get the optimistic view: base node with all pending mutations applied
+    getOptimistic(path) {
+        const mutations = this.pending.get(path);
+        if (!mutations || mutations.length === 0)
+            return undefined;
+        return mutations[mutations.length - 1].predicted;
+    }
+    hasPending(path) {
+        const m = this.pending.get(path);
+        return !!m && m.length > 0;
+    }
+    getPendingCount(path) {
+        if (path)
+            return this.pending.get(path)?.length ?? 0;
+        let total = 0;
+        for (const m of this.pending.values())
+            total += m.length;
+        return total;
+    }
+    // Expire mutations older than maxAge ms
+    expire(maxAge) {
+        const now = Date.now();
+        const expired = [];
+        for (const [path, mutations] of this.pending) {
+            const before = mutations.length;
+            const remaining = mutations.filter(m => now - m.createdAt < maxAge);
+            if (remaining.length < before) {
+                expired.push(...mutations.filter(m => now - m.createdAt >= maxAge).map(m => m.id));
+            }
+            if (remaining.length === 0)
+                this.pending.delete(path);
+            else
+                this.pending.set(path, remaining);
+        }
+        return expired;
+    }
+    clear() {
+        this.pending.clear();
+    }
+}
+// ── Helpers ──
+// Deep equality check for node data (ignoring $rev which server increments)
+function nodesMatch(a, b) {
+    const aClean = withoutRev(a);
+    const bClean = withoutRev(b);
+    return JSON.stringify(aClean) === JSON.stringify(bClean);
+}
+function withoutRev(node) {
+    const { $rev, ...rest } = node;
+    return rest;
+}
+//# sourceMappingURL=optimistic.js.map

package/dist/mod/optimistic.js.map

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

package/dist/mod/prefab.d.ts

@@ -0,0 +1,18 @@
+import { type NodeData } from '#core';
+export type PrefabSetup = (nodes: NodeData[], params?: unknown) => NodeData[] | Promise<NodeData[]>;
+export type PrefabMeta = {
+    tier?: 'core';
+};
+export type PrefabEntry = {
+    nodes: NodeData[];
+    setup?: PrefabSetup;
+    meta?: PrefabMeta;
+};
+export declare function registerPrefab(mod: string, name: string, nodes: NodeData[], setup?: PrefabSetup, meta?: PrefabMeta): void;
+export declare function getPrefab(mod: string, name: string): PrefabEntry | undefined;
+export declare function getModPrefabs(mod: string): [string, PrefabEntry][];
+export declare function getRegisteredMods(): string[];
+/** All seed prefabs: [mod, PrefabEntry][] */
+export declare function getSeedPrefabs(): [string, PrefabEntry][];
+export declare function clearPrefabs(): void;
+//# sourceMappingURL=prefab.d.ts.map

package/dist/mod/prefab.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefab.d.ts","sourceRoot":"","sources":["../../src/mod/prefab.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEtC,MAAM,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,MAAM,CAAC,EAAE,OAAO,KAAK,QAAQ,EAAE,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;AAEpG,MAAM,MAAM,UAAU,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3C,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB,CAAC;AAKF,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,QAAQ,EAAE,EACjB,KAAK,CAAC,EAAE,WAAW,EACnB,IAAI,CAAC,EAAE,UAAU,GAChB,IAAI,CAIN;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAE5E;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,CAMlE;AAED,wBAAgB,iBAAiB,IAAI,MAAM,EAAE,CAI5C;AAED,6CAA6C;AAC7C,wBAAgB,cAAc,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,CAMxD;AAGD,wBAAgB,YAAY,IAAI,IAAI,CAEnC"}

package/dist/mod/prefab.js

@@ -0,0 +1,42 @@
+// Treenity Prefab Registry — in-memory store for module prefab declarations
+// Modules call registerPrefab() during import; mods-mount exposes data as virtual tree.
+// Prefabs named 'seed' are auto-deployed at startup by deploySeedPrefabs().
+// Key: "mod/name"
+const prefabs = new Map();
+export function registerPrefab(mod, name, nodes, setup, meta) {
+    const key = `${mod}/${name}`;
+    if (prefabs.has(key))
+        return; // sealed, like registry
+    prefabs.set(key, { nodes, setup, meta });
+}
+export function getPrefab(mod, name) {
+    return prefabs.get(`${mod}/${name}`);
+}
+export function getModPrefabs(mod) {
+    const result = [];
+    for (const [k, v] of prefabs) {
+        if (k.startsWith(mod + '/'))
+            result.push([k.slice(mod.length + 1), v]);
+    }
+    return result;
+}
+export function getRegisteredMods() {
+    const mods = new Set();
+    for (const k of prefabs.keys())
+        mods.add(k.split('/')[0]);
+    return [...mods];
+}
+/** All seed prefabs: [mod, PrefabEntry][] */
+export function getSeedPrefabs() {
+    const result = [];
+    for (const [k, v] of prefabs) {
+        if (k.endsWith('/seed'))
+            result.push([k.split('/')[0], v]);
+    }
+    return result;
+}
+// For tests
+export function clearPrefabs() {
+    prefabs.clear();
+}
+//# sourceMappingURL=prefab.js.map

package/dist/mod/prefab.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefab.js","sourceRoot":"","sources":["../../src/mod/prefab.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,wFAAwF;AACxF,4EAA4E;AAc5E,kBAAkB;AAClB,MAAM,OAAO,GAAG,IAAI,GAAG,EAAuB,CAAC;AAE/C,MAAM,UAAU,cAAc,CAC5B,GAAW,EACX,IAAY,EACZ,KAAiB,EACjB,KAAmB,EACnB,IAAiB;IAEjB,MAAM,GAAG,GAAG,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IAC7B,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO,CAAC,wBAAwB;IACtD,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,GAAW,EAAE,IAAY;IACjD,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,GAAG,GAAG,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACzE,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,IAAI,EAAE;QAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1D,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;AACnB,CAAC;AAED,6CAA6C;AAC7C,MAAM,UAAU,cAAc;IAC5B,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,YAAY;AACZ,MAAM,UAAU,YAAY;IAC1B,OAAO,CAAC,KAAK,EAAE,CAAC;AAClB,CAAC"}

package/dist/mod/tracking.d.ts

@@ -0,0 +1,8 @@
+export declare function setCurrentMod(name: string | null): void;
+export declare function getCurrentMod(): string | null;
+export declare function trackType(typeName: string): void;
+export declare function getTypesForMod(modName: string): string[];
+/** Infer mod name from type name: tracked → exact; else first segment + alias lookup */
+export declare function inferModFromType(typeName: string): string;
+export declare function clearTracking(): void;
+//# sourceMappingURL=tracking.d.ts.map

package/dist/mod/tracking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracking.d.ts","sourceRoot":"","sources":["../../src/mod/tracking.ts"],"names":[],"mappings":"AAeA,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAEvD;AAED,wBAAgB,aAAa,IAAI,MAAM,GAAG,IAAI,CAE7C;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAIhD;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAMxD;AAED,wFAAwF;AACxF,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMzD;AAGD,wBAAgB,aAAa,IAAI,IAAI,CAGpC"}

package/dist/mod/tracking.js

@@ -0,0 +1,44 @@
+// Type→Mod tracking — runtime map of which mod registered which types
+// setCurrentMod() wraps import() in loader; trackType() called from registerType.
+// Convention fallback: first segment of type name = mod name (cafe.contact → cafe).
+let currentMod = null;
+// type → mod name
+const typeToMod = new Map();
+// Aliases for types whose first segment ≠ mod dir name
+const MOD_ALIASES = {
+    order: 'orders',
+    pult: 'pult',
+};
+export function setCurrentMod(name) {
+    currentMod = name;
+}
+export function getCurrentMod() {
+    return currentMod;
+}
+export function trackType(typeName) {
+    if (currentMod) {
+        typeToMod.set(typeName, currentMod);
+    }
+}
+export function getTypesForMod(modName) {
+    const types = [];
+    for (const [type, mod] of typeToMod) {
+        if (mod === modName)
+            types.push(type);
+    }
+    return types;
+}
+/** Infer mod name from type name: tracked → exact; else first segment + alias lookup */
+export function inferModFromType(typeName) {
+    const tracked = typeToMod.get(typeName);
+    if (tracked)
+        return tracked;
+    const first = typeName.split('.')[0];
+    return MOD_ALIASES[first] ?? first;
+}
+// For tests
+export function clearTracking() {
+    typeToMod.clear();
+    currentMod = null;
+}
+//# sourceMappingURL=tracking.js.map

package/dist/mod/tracking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracking.js","sourceRoot":"","sources":["../../src/mod/tracking.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,kFAAkF;AAClF,oFAAoF;AAEpF,IAAI,UAAU,GAAkB,IAAI,CAAC;AAErC,kBAAkB;AAClB,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;AAE5C,uDAAuD;AACvD,MAAM,WAAW,GAA2B;IAC1C,KAAK,EAAE,QAAQ;IACf,IAAI,EAAE,MAAM;CACb,CAAC;AAEF,MAAM,UAAU,aAAa,CAAC,IAAmB;IAC/C,UAAU,GAAG,IAAI,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,QAAgB;IACxC,IAAI,UAAU,EAAE,CAAC;QACf,SAAS,CAAC,GAAG,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IACtC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,SAAS,EAAE,CAAC;QACpC,IAAI,GAAG,KAAK,OAAO;YAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACxC,IAAI,OAAO;QAAE,OAAO,OAAO,CAAC;IAE5B,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACrC,OAAO,WAAW,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC;AACrC,CAAC;AAED,YAAY;AACZ,MAAM,UAAU,aAAa;IAC3B,SAAS,CAAC,KAAK,EAAE,CAAC;IAClB,UAAU,GAAG,IAAI,CAAC;AACpB,CAAC"}

package/dist/mod/types.d.ts

@@ -0,0 +1,31 @@
+import type { Tree } from '#tree';
+export interface TreenityMod {
+    name: string;
+    dependencies?: string[];
+    server?: () => Promise<unknown>;
+    client?: () => Promise<unknown>;
+    seed?: (store: Tree) => Promise<void>;
+    onLoad?: () => void | Promise<void>;
+    onUnload?: () => void | Promise<void>;
+}
+export interface ModManifest {
+    name: string;
+    version: string;
+    types?: string[];
+    dependencies?: string[];
+    server?: string;
+    client?: string;
+    seed?: string;
+    packagePath?: string;
+}
+export type ModState = 'discovered' | 'loading' | 'loaded' | 'failed' | 'disabled';
+export interface LoadedMod {
+    manifest?: ModManifest;
+    mod?: TreenityMod;
+    name: string;
+    state: ModState;
+    error?: Error;
+    loadedAt?: number;
+}
+export declare function defineMod(mod: TreenityMod): TreenityMod;
+//# sourceMappingURL=types.d.ts.map