@signaltree/core 6.0.7 → 6.0.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@signaltree/core",
-  "version": "6.0.7",
+  "version": "6.0.9",
   "description": "Lightweight, type-safe signal-based state management for Angular. Core package providing hierarchical signal trees, basic entity management, and async actions.",
   "type": "module",
   "sideEffects": false,

package/dist/constants.js

@@ -1,6 +0,0 @@
-const SHARED_DEFAULTS = Object.freeze({
-  PATH_CACHE_SIZE: 1000
-});
-const DEFAULT_PATH_CACHE_SIZE = SHARED_DEFAULTS.PATH_CACHE_SIZE;
-
-export { DEFAULT_PATH_CACHE_SIZE, SHARED_DEFAULTS };

package/dist/deep-equal.js

@@ -1,41 +0,0 @@
-function deepEqual(a, b) {
-  if (a === b) return true;
-  if (a == null || b == null) return a === b;
-  const typeA = typeof a;
-  const typeB = typeof b;
-  if (typeA !== typeB) return false;
-  if (typeA !== 'object') return false;
-  if (a instanceof Date && b instanceof Date) {
-    return a.getTime() === b.getTime();
-  }
-  if (a instanceof RegExp && b instanceof RegExp) {
-    return a.source === b.source && a.flags === b.flags;
-  }
-  if (a instanceof Map && b instanceof Map) {
-    if (a.size !== b.size) return false;
-    for (const [key, value] of a) {
-      if (!b.has(key) || !deepEqual(value, b.get(key))) return false;
-    }
-    return true;
-  }
-  if (a instanceof Set && b instanceof Set) {
-    if (a.size !== b.size) return false;
-    for (const value of a) {
-      if (!b.has(value)) return false;
-    }
-    return true;
-  }
-  if (Array.isArray(a)) {
-    if (!Array.isArray(b) || a.length !== b.length) return false;
-    return a.every((item, index) => deepEqual(item, b[index]));
-  }
-  if (Array.isArray(b)) return false;
-  const objA = a;
-  const objB = b;
-  const keysA = Object.keys(objA);
-  const keysB = Object.keys(objB);
-  if (keysA.length !== keysB.length) return false;
-  return keysA.every(key => key in objB && deepEqual(objA[key], objB[key]));
-}
-
-export { deepEqual };

package/dist/enhancers/batching/batching.js

@@ -1,189 +0,0 @@
-import { applyState, isNodeAccessor } from '../../lib/utils.js';
-
-let updateQueue = [];
-let isUpdating = false;
-let flushTimeoutId;
-let currentBatchingConfig = {};
-function addToQueue(update, config = currentBatchingConfig) {
-  const maxSize = config.maxBatchSize ?? 100;
-  if (update.path) {
-    updateQueue = updateQueue.filter(existing => existing.path !== update.path);
-  }
-  updateQueue.push(update);
-  if (updateQueue.length > maxSize) {
-    flushUpdates();
-    return true;
-  }
-  scheduleFlush(config);
-  return false;
-}
-function scheduleFlush(config) {
-  if (flushTimeoutId !== undefined) {
-    clearTimeout(flushTimeoutId);
-  }
-  const delay = config.autoFlushDelay ?? config.debounceMs ?? 16;
-  flushTimeoutId = setTimeout(() => {
-    flushUpdates();
-  }, delay);
-}
-function flushUpdates() {
-  if (isUpdating) return;
-  let queue;
-  do {
-    if (updateQueue.length === 0) return;
-    isUpdating = true;
-    queue = updateQueue;
-    updateQueue = [];
-    if (flushTimeoutId !== undefined) {
-      clearTimeout(flushTimeoutId);
-      flushTimeoutId = undefined;
-    }
-    queue.sort((a, b) => (b.depth ?? 0) - (a.depth ?? 0));
-    try {
-      queue.forEach(({
-        fn
-      }) => fn());
-    } finally {
-      isUpdating = false;
-    }
-  } while (updateQueue.length > 0);
-}
-function batchUpdates(fn, path) {
-  const startTime = performance.now();
-  const depth = 0;
-  const update = {
-    fn,
-    startTime,
-    depth,
-    path
-  };
-  const wasFlushed = addToQueue(update, currentBatchingConfig);
-  if (!wasFlushed) {
-    const isTimedOut = currentBatchingConfig.batchTimeoutMs && updateQueue.length > 0 && startTime - updateQueue[0].startTime >= currentBatchingConfig.batchTimeoutMs;
-    if (isTimedOut) {
-      flushUpdates();
-    } else if (!isUpdating && updateQueue.length > 0) {
-      queueMicrotask(() => {
-        flushUpdates();
-      });
-    }
-  }
-}
-function batchingWithConfig(config = {}) {
-  const enabled = config.enabled ?? true;
-  if (enabled) {
-    currentBatchingConfig = {
-      ...currentBatchingConfig,
-      ...config
-    };
-  }
-  const enhancer = tree => {
-    if (!enabled) {
-      const enhanced = tree;
-      enhanced.batch = updater => {
-        try {
-          tree.batchUpdate(updater);
-        } catch {
-          try {
-            updater(enhanced.state);
-          } catch {}
-        }
-      };
-      enhanced.batchUpdate = updater => {
-        try {
-          const current = tree();
-          const updates = updater(current);
-          applyState(enhanced.state, updates);
-        } catch (err) {
-          try {
-            tree.batchUpdate(updater);
-          } catch {}
-        }
-      };
-      return enhanced;
-    }
-    const originalTreeCall = tree.bind(tree);
-    const enhancedTree = function (...args) {
-      if (args.length === 0) {
-        return originalTreeCall();
-      } else {
-        batchUpdates(() => {
-          if (args.length === 1) {
-            const arg = args[0];
-            if (typeof arg === 'function') {
-              originalTreeCall(arg);
-            } else {
-              originalTreeCall(arg);
-            }
-          }
-        });
-      }
-    };
-    Object.setPrototypeOf(enhancedTree, Object.getPrototypeOf(tree));
-    Object.assign(enhancedTree, tree);
-    if ('state' in tree) {
-      Object.defineProperty(enhancedTree, 'state', {
-        value: tree.state,
-        enumerable: false,
-        configurable: true
-      });
-    }
-    if ('$' in tree) {
-      Object.defineProperty(enhancedTree, '$', {
-        value: tree.$,
-        enumerable: false,
-        configurable: true
-      });
-    }
-    enhancedTree.batchUpdate = updater => {
-      batchUpdates(() => {
-        const current = originalTreeCall();
-        const updates = updater(current);
-        Object.entries(updates).forEach(([key, value]) => {
-          const property = enhancedTree.state[key];
-          if (property && 'set' in property) {
-            property.set(value);
-          } else if (isNodeAccessor(property)) {
-            property(value);
-          }
-        });
-      });
-    };
-    return enhancedTree;
-  };
-  return enhancer;
-}
-function batching(config = {}) {
-  return batchingWithConfig(config);
-}
-function highPerformanceBatching() {
-  return batchingWithConfig({
-    enabled: true,
-    maxBatchSize: 200,
-    debounceMs: 0
-  });
-}
-function flushBatchedUpdates() {
-  if (updateQueue.length > 0) {
-    const queue = updateQueue.slice();
-    updateQueue = [];
-    isUpdating = false;
-    queue.sort((a, b) => (b.depth ?? 0) - (a.depth ?? 0));
-    queue.forEach(({
-      fn
-    }) => {
-      fn();
-    });
-  }
-}
-function hasPendingUpdates() {
-  return updateQueue.length > 0;
-}
-function getBatchQueueSize() {
-  return updateQueue.length;
-}
-Object.assign((config = {}) => batchingWithConfig(config), {
-  highPerformance: highPerformanceBatching
-});
-
-export { batching, batchingWithConfig, flushBatchedUpdates, getBatchQueueSize, hasPendingUpdates, highPerformanceBatching };

package/dist/enhancers/devtools/devtools.js

@@ -1,306 +0,0 @@
-import { signal } from '@angular/core';
-
-function createActivityTracker() {
-  const modules = new Map();
-  return {
-    trackMethodCall: (module, method, duration) => {
-      const existing = modules.get(module);
-      if (existing) {
-        existing.lastActivity = new Date();
-        existing.operationCount++;
-        existing.averageExecutionTime = (existing.averageExecutionTime * (existing.operationCount - 1) + duration) / existing.operationCount;
-      } else {
-        modules.set(module, {
-          name: module,
-          methods: [method],
-          addedAt: new Date(),
-          lastActivity: new Date(),
-          operationCount: 1,
-          averageExecutionTime: duration,
-          errorCount: 0
-        });
-      }
-    },
-    trackError: (module, error, context) => {
-      const existing = modules.get(module);
-      if (existing) {
-        existing.errorCount++;
-      }
-      console.error(`❌ [${module}] Error${context ? ` in ${context}` : ''}:`, error);
-    },
-    getModuleActivity: module => modules.get(module),
-    getAllModules: () => Array.from(modules.values())
-  };
-}
-function createCompositionLogger() {
-  const logs = [];
-  const addLog = (module, type, data) => {
-    logs.push({
-      timestamp: new Date(),
-      module,
-      type,
-      data
-    });
-    if (logs.length > 1000) {
-      logs.splice(0, logs.length - 1000);
-    }
-  };
-  return {
-    logComposition: (modules, action) => {
-      addLog('core', 'composition', {
-        modules,
-        action
-      });
-      console.log(`🔗 Composition ${action}:`, modules.join(' → '));
-    },
-    logMethodExecution: (module, method, args, result) => {
-      addLog(module, 'method', {
-        method,
-        args,
-        result
-      });
-      console.debug(`🔧 [${module}] ${method}`, {
-        args,
-        result
-      });
-    },
-    logStateChange: (module, path, oldValue, newValue) => {
-      addLog(module, 'state', {
-        path,
-        oldValue,
-        newValue
-      });
-      console.debug(`📝 [${module}] State change at ${path}:`, {
-        from: oldValue,
-        to: newValue
-      });
-    },
-    logPerformanceWarning: (module, operation, duration, threshold) => {
-      addLog(module, 'performance', {
-        operation,
-        duration,
-        threshold
-      });
-      console.warn(`⚠️ [${module}] Slow ${operation}: ${duration.toFixed(2)}ms (threshold: ${threshold}ms)`);
-    },
-    exportLogs: () => [...logs]
-  };
-}
-function createNoopLogger() {
-  return {
-    logComposition: () => {},
-    logMethodExecution: () => {},
-    logStateChange: () => {},
-    logPerformanceWarning: () => {},
-    exportLogs: () => []
-  };
-}
-function createModularMetrics() {
-  const metricsSignal = signal({
-    totalUpdates: 0,
-    moduleUpdates: {},
-    modulePerformance: {},
-    compositionChain: [],
-    signalGrowth: {},
-    memoryDelta: {},
-    moduleCacheStats: {}
-  });
-  return {
-    signal: metricsSignal.asReadonly(),
-    updateMetrics: updates => {
-      metricsSignal.update(current => ({
-        ...current,
-        ...updates
-      }));
-    },
-    trackModuleUpdate: (module, duration) => {
-      metricsSignal.update(current => ({
-        ...current,
-        totalUpdates: current.totalUpdates + 1,
-        moduleUpdates: {
-          ...current.moduleUpdates,
-          [module]: (current.moduleUpdates[module] || 0) + 1
-        },
-        modulePerformance: {
-          ...current.modulePerformance,
-          [module]: duration
-        }
-      }));
-    }
-  };
-}
-function devTools(config = {}) {
-  const {
-    enabled = true,
-    treeName = 'SignalTree',
-    name,
-    enableBrowserDevTools = true,
-    enableLogging = true,
-    performanceThreshold = 16
-  } = config;
-  const displayName = name ?? treeName;
-  return tree => {
-    if (!enabled) {
-      const noopMethods = {
-        connectDevTools() {},
-        disconnectDevTools() {}
-      };
-      return Object.assign(tree, noopMethods);
-    }
-    const activityTracker = createActivityTracker();
-    const logger = enableLogging ? createCompositionLogger() : createNoopLogger();
-    const metrics = createModularMetrics();
-    const compositionHistory = [];
-    const activeProfiles = new Map();
-    let browserDevTools = null;
-    const initBrowserDevTools = () => {
-      if (!enableBrowserDevTools || typeof window === 'undefined' || !('__REDUX_DEVTOOLS_EXTENSION__' in window)) {
-        return;
-      }
-      try {
-        const devToolsExt = window['__REDUX_DEVTOOLS_EXTENSION__'];
-        const connection = devToolsExt.connect({
-          name: displayName,
-          features: {
-            dispatch: true,
-            jump: true,
-            skip: true
-          }
-        });
-        browserDevTools = {
-          send: connection.send
-        };
-        browserDevTools.send('@@INIT', tree());
-        console.log(`🔗 Connected to Redux DevTools as "${displayName}"`);
-      } catch (e) {
-        console.warn('[SignalTree] Failed to connect to Redux DevTools:', e);
-      }
-    };
-    const originalTreeCall = tree.bind(tree);
-    const enhancedTree = function (...args) {
-      if (args.length === 0) {
-        return originalTreeCall();
-      }
-      const startTime = performance.now();
-      let result;
-      if (args.length === 1) {
-        const arg = args[0];
-        if (typeof arg === 'function') {
-          result = originalTreeCall(arg);
-        } else {
-          result = originalTreeCall(arg);
-        }
-      }
-      const duration = performance.now() - startTime;
-      const newState = originalTreeCall();
-      metrics.trackModuleUpdate('core', duration);
-      if (duration > performanceThreshold) {
-        logger.logPerformanceWarning('core', 'update', duration, performanceThreshold);
-      }
-      if (browserDevTools) {
-        browserDevTools.send('UPDATE', newState);
-      }
-      return result;
-    };
-    Object.setPrototypeOf(enhancedTree, Object.getPrototypeOf(tree));
-    Object.assign(enhancedTree, tree);
-    if ('state' in tree) {
-      Object.defineProperty(enhancedTree, 'state', {
-        value: tree.state,
-        enumerable: false,
-        configurable: true
-      });
-    }
-    if ('$' in tree) {
-      Object.defineProperty(enhancedTree, '$', {
-        value: tree.$,
-        enumerable: false,
-        configurable: true
-      });
-    }
-    const devToolsInterface = {
-      activityTracker,
-      logger,
-      metrics: metrics.signal,
-      trackComposition: modules => {
-        compositionHistory.push({
-          timestamp: new Date(),
-          chain: [...modules]
-        });
-        metrics.updateMetrics({
-          compositionChain: modules
-        });
-        logger.logComposition(modules, 'with');
-      },
-      startModuleProfiling: module => {
-        const profileId = `${module}_${Date.now()}`;
-        activeProfiles.set(profileId, {
-          module,
-          operation: 'profile',
-          startTime: performance.now()
-        });
-        return profileId;
-      },
-      endModuleProfiling: profileId => {
-        const profile = activeProfiles.get(profileId);
-        if (profile) {
-          const duration = performance.now() - profile.startTime;
-          activityTracker.trackMethodCall(profile.module, profile.operation, duration);
-          activeProfiles.delete(profileId);
-        }
-      },
-      connectDevTools: name => {
-        if (browserDevTools) {
-          browserDevTools.send('@@INIT', originalTreeCall());
-          console.log(`🔗 Connected to Redux DevTools as "${name}"`);
-        }
-      },
-      exportDebugSession: () => ({
-        metrics: metrics.signal(),
-        modules: activityTracker.getAllModules(),
-        logs: logger.exportLogs(),
-        compositionHistory: [...compositionHistory]
-      })
-    };
-    const methods = {
-      connectDevTools() {
-        initBrowserDevTools();
-      },
-      disconnectDevTools() {
-        browserDevTools = null;
-      }
-    };
-    enhancedTree['__devTools'] = devToolsInterface;
-    return Object.assign(enhancedTree, methods);
-  };
-}
-function enableDevTools(treeName = 'SignalTree') {
-  return devTools({
-    treeName,
-    enabled: true
-  });
-}
-function fullDevTools(treeName = 'SignalTree') {
-  return devTools({
-    treeName,
-    enabled: true,
-    enableBrowserDevTools: true,
-    enableLogging: true,
-    performanceThreshold: 10
-  });
-}
-function productionDevTools() {
-  return devTools({
-    enabled: true,
-    enableBrowserDevTools: false,
-    enableLogging: false,
-    performanceThreshold: 50
-  });
-}
-Object.assign(devTools, {
-  production: productionDevTools,
-  full: fullDevTools,
-  enable: enableDevTools
-});
-
-export { devTools, enableDevTools, fullDevTools, productionDevTools };

package/dist/enhancers/effects/effects.js

@@ -1,66 +0,0 @@
-import { effect, untracked } from '@angular/core';
-
-function effects(config = {}) {
-  const {
-    enabled = true
-  } = config;
-  return tree => {
-    const cleanupFns = [];
-    const methods = {
-      effect(effectFn) {
-        if (!enabled) {
-          return () => {};
-        }
-        let innerCleanup;
-        const effectRef = effect(() => {
-          const state = tree();
-          if (innerCleanup) {
-            untracked(() => innerCleanup());
-          }
-          innerCleanup = untracked(() => effectFn(state));
-        });
-        const cleanup = () => {
-          if (innerCleanup) {
-            innerCleanup();
-          }
-          effectRef.destroy();
-        };
-        cleanupFns.push(cleanup);
-        return cleanup;
-      },
-      subscribe(fn) {
-        if (!enabled) {
-          return () => {};
-        }
-        const effectRef = effect(() => {
-          const state = tree();
-          untracked(() => fn(state));
-        });
-        const cleanup = () => {
-          effectRef.destroy();
-        };
-        cleanupFns.push(cleanup);
-        return cleanup;
-      }
-    };
-    const originalDestroy = tree.destroy?.bind(tree);
-    tree.destroy = () => {
-      cleanupFns.forEach(fn => fn());
-      cleanupFns.length = 0;
-      if (originalDestroy) {
-        originalDestroy();
-      }
-    };
-    return Object.assign(tree, methods);
-  };
-}
-function enableEffects() {
-  return effects({
-    enabled: true
-  });
-}
-Object.assign((config = {}) => effects(config), {
-  enable: enableEffects
-});
-
-export { effects, enableEffects };

package/dist/enhancers/entities/entities.js

@@ -1,51 +0,0 @@
-import { createEntitySignal } from '../../lib/entity-signal.js';
-import { getPathNotifier } from '../../lib/path-notifier.js';
-
-function isEntityMapMarker(value) {
-  return Boolean(value && typeof value === 'object' && value['__isEntityMap'] === true);
-}
-function entities(config = {}) {
-  const {
-    enabled = true
-  } = config;
-  return tree => {
-    if (!enabled) {
-      tree.__entitiesEnabled = true;
-      return tree;
-    }
-    const notifier = getPathNotifier();
-    function materialize(node, path = []) {
-      if (!node || typeof node !== 'object') return;
-      for (const [k, v] of Object.entries(node)) {
-        if (isEntityMapMarker(v)) {
-          const cfg = v.__entityMapConfig ?? {};
-          const sig = createEntitySignal(cfg, notifier, path.concat(k).join('.'));
-          try {
-            node[k] = sig;
-          } catch {}
-          try {
-            tree[k] = sig;
-          } catch {}
-        } else if (typeof v === 'object' && v !== null && !Array.isArray(v)) {
-          materialize(v, path.concat(k));
-        }
-      }
-    }
-    materialize(tree.state);
-    materialize(tree.$);
-    tree.__entitiesEnabled = true;
-    return tree;
-  };
-}
-function enableEntities() {
-  return entities();
-}
-function highPerformanceEntities() {
-  return entities();
-}
-Object.assign(entities, {
-  highPerformance: highPerformanceEntities,
-  enable: enableEntities
-});
-
-export { enableEntities, entities, highPerformanceEntities };