@signaltree/enterprise 4.0.15 → 4.1.0

package/dist/index.d.ts

@@ -0,0 +1 @@
+export * from "./src/index";

package/dist/index.js

@@ -0,0 +1,6 @@
+export { ChangeType, DiffEngine } from './lib/diff-engine.js';
+export { PathIndex } from './lib/path-index.js';
+export { OptimizedUpdateEngine } from './lib/update-engine.js';
+export { withEnterprise } from './lib/enterprise-enhancer.js';
+export { postTask } from './lib/scheduler.js';
+export { createMockPool } from './lib/thread-pools.js';

package/dist/lib/diff-engine.js

@@ -0,0 +1,155 @@
+var ChangeType;
+(function (ChangeType) {
+  ChangeType["ADD"] = "add";
+  ChangeType["UPDATE"] = "update";
+  ChangeType["DELETE"] = "delete";
+  ChangeType["REPLACE"] = "replace";
+})(ChangeType || (ChangeType = {}));
+class DiffEngine {
+  constructor() {
+    this.defaultOptions = {
+      maxDepth: 100,
+      detectDeletions: false,
+      ignoreArrayOrder: false,
+      equalityFn: (a, b) => a === b,
+      keyValidator: undefined
+    };
+  }
+  diff(current, updates, options = {}) {
+    const opts = Object.assign(Object.assign({}, this.defaultOptions), options);
+    const changes = [];
+    const visited = new WeakSet();
+    this.traverse(current, updates, [], changes, visited, opts, 0);
+    return {
+      changes,
+      hasChanges: changes.length > 0
+    };
+  }
+  traverse(curr, upd, path, changes, visited, opts, depth) {
+    if (depth > opts.maxDepth) {
+      return;
+    }
+    if (typeof upd !== 'object' || upd === null) {
+      if (!opts.equalityFn(curr, upd)) {
+        changes.push({
+          type: curr === undefined ? ChangeType.ADD : ChangeType.UPDATE,
+          path: [...path],
+          value: upd,
+          oldValue: curr
+        });
+      }
+      return;
+    }
+    if (visited.has(upd)) {
+      return;
+    }
+    visited.add(upd);
+    if (Array.isArray(upd)) {
+      this.diffArrays(curr, upd, path, changes, visited, opts, depth);
+      return;
+    }
+    if (!curr || typeof curr !== 'object' || Array.isArray(curr)) {
+      changes.push({
+        type: ChangeType.REPLACE,
+        path: [...path],
+        value: upd,
+        oldValue: curr
+      });
+      return;
+    }
+    const currObj = curr;
+    const updObj = upd;
+    for (const key in updObj) {
+      if (Object.prototype.hasOwnProperty.call(updObj, key)) {
+        if (opts.keyValidator && !opts.keyValidator(key)) {
+          continue;
+        }
+        this.traverse(currObj[key], updObj[key], [...path, key], changes, visited, opts, depth + 1);
+      }
+    }
+    if (opts.detectDeletions) {
+      for (const key in currObj) {
+        if (Object.prototype.hasOwnProperty.call(currObj, key) && !(key in updObj)) {
+          changes.push({
+            type: ChangeType.DELETE,
+            path: [...path, key],
+            oldValue: currObj[key]
+          });
+        }
+      }
+    }
+  }
+  diffArrays(curr, upd, path, changes, visited, opts, depth) {
+    if (!Array.isArray(curr)) {
+      changes.push({
+        type: ChangeType.REPLACE,
+        path: [...path],
+        value: upd,
+        oldValue: curr
+      });
+      return;
+    }
+    if (opts.ignoreArrayOrder) {
+      this.diffArraysUnordered(curr, upd, path, changes, opts);
+    } else {
+      this.diffArraysOrdered(curr, upd, path, changes, visited, opts, depth);
+    }
+  }
+  diffArraysOrdered(curr, upd, path, changes, visited, opts, depth) {
+    const maxLength = Math.max(curr.length, upd.length);
+    for (let i = 0; i < maxLength; i++) {
+      if (i >= upd.length) {
+        if (opts.detectDeletions) {
+          changes.push({
+            type: ChangeType.DELETE,
+            path: [...path, i],
+            oldValue: curr[i]
+          });
+        }
+      } else if (i >= curr.length) {
+        changes.push({
+          type: ChangeType.ADD,
+          path: [...path, i],
+          value: upd[i]
+        });
+      } else {
+        this.traverse(curr[i], upd[i], [...path, i], changes, visited, opts, depth + 1);
+      }
+    }
+  }
+  diffArraysUnordered(curr, upd, path, changes, opts) {
+    const currSet = new Set(curr.map(v => this.stringify(v)));
+    const updSet = new Set(upd.map(v => this.stringify(v)));
+    upd.forEach((value, index) => {
+      const str = this.stringify(value);
+      if (!currSet.has(str)) {
+        changes.push({
+          type: ChangeType.ADD,
+          path: [...path, index],
+          value
+        });
+      }
+    });
+    if (opts.detectDeletions) {
+      curr.forEach((value, index) => {
+        const str = this.stringify(value);
+        if (!updSet.has(str)) {
+          changes.push({
+            type: ChangeType.DELETE,
+            path: [...path, index],
+            oldValue: value
+          });
+        }
+      });
+    }
+  }
+  stringify(value) {
+    try {
+      return JSON.stringify(value);
+    } catch (_a) {
+      return String(value);
+    }
+  }
+}
+
+export { ChangeType, DiffEngine };

package/dist/lib/enterprise-enhancer.js

@@ -0,0 +1,28 @@
+import { PathIndex } from './path-index.js';
+import { OptimizedUpdateEngine } from './update-engine.js';
+
+function withEnterprise() {
+  return tree => {
+    let pathIndex = null;
+    let updateEngine = null;
+    const signalTree = tree;
+    const enhancedTree = tree;
+    enhancedTree.updateOptimized = (updates, options) => {
+      if (!updateEngine) {
+        pathIndex = new PathIndex();
+        pathIndex.buildFromTree(signalTree.state);
+        updateEngine = new OptimizedUpdateEngine(signalTree.state);
+      }
+      const result = updateEngine.update(signalTree.state, updates, options);
+      if (result.changed && result.stats && pathIndex) {
+        pathIndex.clear();
+        pathIndex.buildFromTree(signalTree.state);
+      }
+      return result;
+    };
+    enhancedTree.getPathIndex = () => pathIndex;
+    return enhancedTree;
+  };
+}
+
+export { withEnterprise };

package/dist/lib/path-index.js

@@ -0,0 +1,159 @@
+import { isSignal } from '@angular/core';
+
+class TrieNode {
+  constructor() {
+    this.value = null;
+    this.children = new Map();
+  }
+}
+class PathIndex {
+  constructor() {
+    this.root = new TrieNode();
+    this.pathCache = new Map();
+    this.stats = {
+      hits: 0,
+      misses: 0,
+      sets: 0,
+      cleanups: 0
+    };
+  }
+  set(path, signal) {
+    const pathStr = this.pathToString(path);
+    const ref = new WeakRef(signal);
+    let node = this.root;
+    for (const segment of path) {
+      const key = String(segment);
+      if (!node.children.has(key)) {
+        node.children.set(key, new TrieNode());
+      }
+      const nextNode = node.children.get(key);
+      if (!nextNode) {
+        throw new Error(`Failed to get node for key: ${key}`);
+      }
+      node = nextNode;
+    }
+    node.value = ref;
+    this.pathCache.set(pathStr, ref);
+    this.stats.sets++;
+  }
+  get(path) {
+    const pathStr = this.pathToString(path);
+    const cached = this.pathCache.get(pathStr);
+    if (cached) {
+      const value = cached.deref();
+      if (value) {
+        this.stats.hits++;
+        return value;
+      }
+      this.pathCache.delete(pathStr);
+      this.stats.cleanups++;
+    }
+    let node = this.root;
+    for (const segment of path) {
+      const key = String(segment);
+      node = node.children.get(key);
+      if (!node) {
+        this.stats.misses++;
+        return null;
+      }
+    }
+    if (node.value) {
+      const value = node.value.deref();
+      if (value) {
+        this.pathCache.set(pathStr, node.value);
+        this.stats.hits++;
+        return value;
+      }
+      node.value = null;
+      this.stats.cleanups++;
+    }
+    this.stats.misses++;
+    return null;
+  }
+  has(path) {
+    return this.get(path) !== null;
+  }
+  getByPrefix(prefix) {
+    const results = new Map();
+    let node = this.root;
+    for (const segment of prefix) {
+      const key = String(segment);
+      node = node.children.get(key);
+      if (!node) {
+        return results;
+      }
+    }
+    this.collectDescendants(node, [], results);
+    return results;
+  }
+  delete(path) {
+    const pathStr = this.pathToString(path);
+    this.pathCache.delete(pathStr);
+    let node = this.root;
+    const nodes = [node];
+    for (const segment of path) {
+      const key = String(segment);
+      node = node.children.get(key);
+      if (!node) {
+        return false;
+      }
+      nodes.push(node);
+    }
+    const hadValue = node.value !== null;
+    node.value = null;
+    for (let i = nodes.length - 1; i > 0; i--) {
+      const current = nodes[i];
+      if (current.value === null && current.children.size === 0) {
+        const parent = nodes[i - 1];
+        const segment = path[i - 1];
+        parent.children.delete(String(segment));
+      } else {
+        break;
+      }
+    }
+    return hadValue;
+  }
+  clear() {
+    this.root = new TrieNode();
+    this.pathCache.clear();
+  }
+  getStats() {
+    const total = this.stats.hits + this.stats.misses;
+    const hitRate = total > 0 ? this.stats.hits / total : 0;
+    return Object.assign(Object.assign({}, this.stats), {
+      hitRate,
+      cacheSize: this.pathCache.size
+    });
+  }
+  buildFromTree(tree, path = []) {
+    if (!tree) {
+      return;
+    }
+    if (isSignal(tree)) {
+      this.set(path, tree);
+      return;
+    }
+    if (typeof tree !== 'object') {
+      return;
+    }
+    for (const [key, value] of Object.entries(tree)) {
+      this.buildFromTree(value, [...path, key]);
+    }
+  }
+  pathToString(path) {
+    return path.join('.');
+  }
+  collectDescendants(node, currentPath, results) {
+    if (node.value) {
+      const value = node.value.deref();
+      if (value) {
+        results.set(this.pathToString(currentPath), value);
+      }
+    }
+    for (const [key, child] of node.children) {
+      this.collectDescendants(child, [...currentPath, key], results);
+    }
+  }
+}
+
+export { PathIndex };

package/dist/lib/scheduler.js

@@ -0,0 +1,22 @@
+import { __awaiter } from 'tslib';
+
+const q = [];
+function postTask(t) {
+  q.push(t);
+  if (q.length === 1) flush();
+}
+function flush() {
+  return __awaiter(this, void 0, void 0, function* () {
+    while (q.length) {
+      const t = q.shift();
+      try {
+        t();
+      } catch (e) {
+        console.error('[EnterpriseScheduler]', e);
+      }
+      yield Promise.resolve();
+    }
+  });
+}
+
+export { postTask };

package/dist/lib/thread-pools.js

@@ -0,0 +1,13 @@
+import { __awaiter } from 'tslib';
+
+function createMockPool() {
+  return {
+    run(fn, ...args) {
+      return __awaiter(this, void 0, void 0, function* () {
+        return fn(...args);
+      });
+    }
+  };
+}
+
+export { createMockPool };

package/dist/lib/update-engine.js

@@ -0,0 +1,186 @@
+import { isSignal } from '@angular/core';
+import { DiffEngine, ChangeType } from './diff-engine.js';
+import { PathIndex } from './path-index.js';
+
+class OptimizedUpdateEngine {
+  constructor(tree) {
+    this.pathIndex = new PathIndex();
+    this.diffEngine = new DiffEngine();
+    this.pathIndex.buildFromTree(tree);
+  }
+  update(tree, updates, options = {}) {
+    const startTime = performance.now();
+    const diffOptions = {};
+    if (options.maxDepth !== undefined) diffOptions.maxDepth = options.maxDepth;
+    if (options.ignoreArrayOrder !== undefined) diffOptions.ignoreArrayOrder = options.ignoreArrayOrder;
+    if (options.equalityFn !== undefined) diffOptions.equalityFn = options.equalityFn;
+    const diff = this.diffEngine.diff(tree, updates, diffOptions);
+    if (diff.changes.length === 0) {
+      return {
+        changed: false,
+        duration: performance.now() - startTime,
+        changedPaths: []
+      };
+    }
+    const patches = this.createPatches(diff.changes);
+    const sortedPatches = this.sortPatches(patches);
+    const result = options.batch ? this.batchApplyPatches(tree, sortedPatches, options.batchSize) : this.applyPatches(tree, sortedPatches);
+    const duration = performance.now() - startTime;
+    return {
+      changed: true,
+      duration,
+      changedPaths: result.appliedPaths,
+      stats: {
+        totalPaths: diff.changes.length,
+        optimizedPaths: patches.length,
+        batchedUpdates: result.batchCount
+      }
+    };
+  }
+  rebuildIndex(tree) {
+    this.pathIndex.clear();
+    this.pathIndex.buildFromTree(tree);
+  }
+  getIndexStats() {
+    return this.pathIndex.getStats();
+  }
+  createPatches(changes) {
+    const patches = [];
+    const processedPaths = new Set();
+    for (const change of changes) {
+      const pathStr = change.path.join('.');
+      let skipPath = false;
+      for (const processed of processedPaths) {
+        if (pathStr.startsWith(processed + '.')) {
+          skipPath = true;
+          break;
+        }
+      }
+      if (skipPath) {
+        continue;
+      }
+      const patch = this.createPatch(change);
+      patches.push(patch);
+      processedPaths.add(pathStr);
+      if (change.type === ChangeType.REPLACE && typeof change.value === 'object') {
+        processedPaths.add(pathStr);
+      }
+    }
+    return patches;
+  }
+  createPatch(change) {
+    return {
+      type: change.type,
+      path: change.path,
+      value: change.value,
+      oldValue: change.oldValue,
+      priority: this.calculatePriority(change),
+      signal: this.pathIndex.get(change.path)
+    };
+  }
+  calculatePriority(change) {
+    let priority = 0;
+    priority += (10 - change.path.length) * 10;
+    if (change.path.some(p => typeof p === 'number')) {
+      priority -= 20;
+    }
+    if (change.type === ChangeType.REPLACE) {
+      priority += 30;
+    }
+    return priority;
+  }
+  sortPatches(patches) {
+    return patches.sort((a, b) => {
+      if (a.priority !== b.priority) {
+        return b.priority - a.priority;
+      }
+      return a.path.length - b.path.length;
+    });
+  }
+  applyPatches(tree, patches) {
+    const appliedPaths = [];
+    let updateCount = 0;
+    for (const patch of patches) {
+      if (this.applyPatch(patch, tree)) {
+        appliedPaths.push(patch.path.join('.'));
+        updateCount++;
+      }
+    }
+    return {
+      appliedPaths,
+      updateCount,
+      batchCount: 1
+    };
+  }
+  batchApplyPatches(tree, patches, batchSize = 50) {
+    const batches = [];
+    for (let i = 0; i < patches.length; i += batchSize) {
+      batches.push(patches.slice(i, i + batchSize));
+    }
+    const appliedPaths = [];
+    let updateCount = 0;
+    for (const currentBatch of batches) {
+      for (const patch of currentBatch) {
+        if (this.applyPatch(patch, tree)) {
+          appliedPaths.push(patch.path.join('.'));
+          updateCount++;
+        }
+      }
+    }
+    return {
+      appliedPaths,
+      updateCount,
+      batchCount: batches.length
+    };
+  }
+  applyPatch(patch, tree) {
+    try {
+      if (patch.signal && isSignal(patch.signal) && 'set' in patch.signal) {
+        const currentValue = patch.signal();
+        if (this.isEqual(currentValue, patch.value)) {
+          return false;
+        }
+        patch.signal.set(patch.value);
+        if (patch.type === ChangeType.ADD && patch.value !== undefined) {
+          this.pathIndex.set(patch.path, patch.signal);
+        }
+        return true;
+      }
+      let current = tree;
+      for (let i = 0; i < patch.path.length - 1; i++) {
+        const key = patch.path[i];
+        current = current[key];
+        if (!current || typeof current !== 'object') {
+          return false;
+        }
+      }
+      const lastKey = patch.path[patch.path.length - 1];
+      if (this.isEqual(current[lastKey], patch.value)) {
+        return false;
+      }
+      current[lastKey] = patch.value;
+      return true;
+    } catch (error) {
+      console.error(`Failed to apply patch at ${patch.path.join('.')}:`, error);
+      return false;
+    }
+  }
+  isEqual(a, b) {
+    if (a === b) {
+      return true;
+    }
+    if (typeof a !== typeof b) {
+      return false;
+    }
+    if (typeof a !== 'object' || a === null || b === null) {
+      return false;
+    }
+    try {
+      return JSON.stringify(a) === JSON.stringify(b);
+    } catch (_a) {
+      return false;
+    }
+  }
+}
+
+export { OptimizedUpdateEngine };

package/package.json

@@ -1,17 +1,47 @@
 {
   "name": "@signaltree/enterprise",
-  "version": "4.0.15",
+  "version": "4.1.0",
   "description": "Enterprise-grade optimizations for SignalTree. Provides diff-based updates, bulk operation optimization, and advanced change tracking for large-scale applications.",
   "type": "module",
   "sideEffects": false,
-  "main": "./src/index.js",
-  "module": "./src/index.js",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
   "types": "./src/index.d.ts",
   "exports": {
     ".": {
-      "import": "./src/index.js",
-      "require": "./src/index.js",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js",
       "types": "./src/index.d.ts"
+    },
+    "./diff-engine": {
+      "import": "./dist/lib/diff-engine.js",
+      "default": "./dist/lib/diff-engine.js",
+      "types": "./src/lib/diff-engine.d.ts"
+    },
+    "./path-index": {
+      "import": "./dist/lib/path-index.js",
+      "default": "./dist/lib/path-index.js",
+      "types": "./src/lib/path-index.d.ts"
+    },
+    "./update-engine": {
+      "import": "./dist/lib/update-engine.js",
+      "default": "./dist/lib/update-engine.js",
+      "types": "./src/lib/update-engine.d.ts"
+    },
+    "./enterprise-enhancer": {
+      "import": "./dist/lib/enterprise-enhancer.js",
+      "default": "./dist/lib/enterprise-enhancer.js",
+      "types": "./src/lib/enterprise-enhancer.d.ts"
+    },
+    "./scheduler": {
+      "import": "./dist/lib/scheduler.js",
+      "default": "./dist/lib/scheduler.js",
+      "types": "./src/lib/scheduler.d.ts"
+    },
+    "./thread-pools": {
+      "import": "./dist/lib/thread-pools.js",
+      "default": "./dist/lib/thread-pools.js",
+      "types": "./src/lib/thread-pools.d.ts"
     }
   },
   "keywords": [
@@ -38,17 +68,19 @@
   },
   "peerDependencies": {
     "@angular/core": "^20.3.0",
-    "@signaltree/core": "^4.0.0"
-  },
-  "dependencies": {
-    "tslib": "^2.3.0"
+    "@signaltree/core": "^4.1.0",
+    "tslib": "^2.0.0"
   },
   "devDependencies": {
     "@signaltree/core": "workspace:*"
   },
+  "publishConfig": {
+    "access": "public"
+  },
   "files": [
+    "dist",
     "src",
     "README.md",
     "package.json"
   ]
-}
+}