@signaltree/core 8.0.2 → 9.0.1

package/dist/lib/signal-tree.js

@@ -9,6 +9,7 @@ import { SignalMemoryManager } from './memory/memory-manager.js';
 import { getPathNotifier } from './path-notifier.js';
 import { SecurityValidator } from './security/security-validator.js';
 import { createLazySignalTree, unwrap } from './utils.js';
+import { ENHANCER_META } from './types.js';
 import { deepEqual } from '../shared/lib/deep-equal.js';
 import { isBuiltInObject } from '../shared/lib/is-built-in-object.js';
 
@@ -228,6 +229,9 @@ function create(initialState, config) {
     }
   };
   tree[NODE_ACCESSOR_SYMBOL] = true;
+  const cleanupFns = [];
+  const destroyedSig = signal(false);
+  const appliedEnhancers = new Set();
   Object.defineProperty(tree, 'state', {
     value: signalState,
     enumerable: false,
@@ -243,6 +247,20 @@ function create(initialState, config) {
       if (typeof enhancer !== 'function') {
         throw new Error('Enhancer must be a function');
       }
+      const meta = enhancer[ENHANCER_META] ?? enhancer.metadata;
+      if (meta?.name) {
+        if (appliedEnhancers.has(meta.name)) {
+          throw new Error(`Enhancer "${meta.name}" has already been applied to this tree. ` + `Each enhancer can only be applied once.`);
+        }
+        if (meta.requires) {
+          for (const dep of meta.requires) {
+            if (!appliedEnhancers.has(dep)) {
+              throw new Error(`Enhancer "${meta.name}" requires "${dep}" to be applied first.`);
+            }
+          }
+        }
+        appliedEnhancers.add(meta.name);
+      }
       return enhancer(tree);
     },
     enumerable: false,
@@ -259,6 +277,14 @@ function create(initialState, config) {
   });
   Object.defineProperty(tree, 'destroy', {
     value: function () {
+      if (destroyedSig()) return;
+      destroyedSig.set(true);
+      for (const fn of cleanupFns) {
+        try {
+          fn();
+        } catch {}
+      }
+      cleanupFns.length = 0;
       if (memoryManager) {
         memoryManager.dispose();
       }
@@ -270,6 +296,22 @@ function create(initialState, config) {
     writable: true,
     configurable: true
   });
+  Object.defineProperty(tree, 'destroyed', {
+    value: destroyedSig.asReadonly(),
+    enumerable: false,
+    writable: false,
+    configurable: true
+  });
+  Object.defineProperty(tree, 'registerCleanup', {
+    value: function (fn) {
+      if (typeof fn === 'function') {
+        cleanupFns.push(fn);
+      }
+    },
+    enumerable: false,
+    writable: false,
+    configurable: true
+  });
   Object.defineProperty(tree, 'clearCache', {
     value: () => {},
     enumerable: false,
@@ -353,7 +395,7 @@ function createBuilder(baseTree) {
       const enhanced = baseTree.with(enhancer);
       const newBuilder = createBuilder(enhanced);
       for (const key of Object.keys(enhanced)) {
-        if (key !== '$' && key !== 'state' && key !== 'with' && key !== 'bind' && key !== 'destroy' && key !== 'derived') {
+        if (key !== '$' && key !== 'state' && key !== 'with' && key !== 'bind' && key !== 'destroy' && key !== 'destroyed' && key !== 'registerCleanup' && key !== 'derived') {
           try {
             newBuilder[key] = enhanced[key];
           } catch {}
@@ -395,6 +437,22 @@ function createBuilder(baseTree) {
       configurable: true
     });
   }
+  if (baseTree.destroyed) {
+    Object.defineProperty(builder, 'destroyed', {
+      value: baseTree.destroyed,
+      enumerable: false,
+      writable: false,
+      configurable: true
+    });
+  }
+  if (typeof baseTree.registerCleanup === 'function') {
+    Object.defineProperty(builder, 'registerCleanup', {
+      value: baseTree.registerCleanup.bind(baseTree),
+      enumerable: false,
+      writable: false,
+      configurable: true
+    });
+  }
   Object.defineProperty(builder, 'derived', {
     value: function (factory) {
       if (isFinalized) {

package/dist/security.js

@@ -0,0 +1 @@
+export { SecurityPresets, SecurityValidator } from './lib/security/security-validator.js';

package/dist/storage.js

@@ -0,0 +1 @@
+export { createIndexedDBAdapter, createStorageAdapter } from './enhancers/serialization/serialization.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@signaltree/core",
-  "version": "8.0.2",
+  "version": "9.0.1",
   "description": "Reactive JSON for Angular. JSON branches, reactive leaves. No actions. No reducers. No selectors.",
   "license": "MIT",
   "type": "module",
@@ -14,6 +14,21 @@
       "import": "./dist/index.js",
       "default": "./dist/index.js"
     },
+    "./security": {
+      "types": "./src/security.d.ts",
+      "import": "./dist/security.js",
+      "default": "./dist/security.js"
+    },
+    "./edit-session": {
+      "types": "./src/edit-session.d.ts",
+      "import": "./dist/edit-session.js",
+      "default": "./dist/edit-session.js"
+    },
+    "./storage": {
+      "types": "./src/storage.d.ts",
+      "import": "./dist/storage.js",
+      "default": "./dist/storage.js"
+    },
     "./package.json": "./package.json"
   },
   "peerDependencies": {

package/src/edit-session.d.ts

@@ -0,0 +1 @@
+export { createEditSession, type EditSession, type UndoRedoHistory, } from './lib/edit-session';

package/src/enhancers/types.d.ts

@@ -1 +1 @@
-export { BatchingMethods, BatchingConfig, MemoizationMethods, MemoizationConfig, TimeTravelMethods, TimeTravelConfig, EffectsMethods, DevToolsMethods, DevToolsConfig, EntitiesEnabled, Enhancer, EnhancerWithMeta, EnhancerMeta, } from '../lib/types';
+export { BatchingMethods, BatchingConfig, TimeTravelMethods, TimeTravelConfig, EffectsMethods, DevToolsMethods, DevToolsConfig, EntitiesEnabled, Enhancer, EnhancerWithMeta, EnhancerMeta, } from '../lib/types';

package/src/enhancers/typing/helpers-types.d.ts

@@ -1,2 +1,2 @@
-export type Equals<A, B> = (<T>() => T extends A ? 1 : 2) extends <T>() => T extends B ? 1 : 2 ? true : false;
+export type Equals<A, B> = (<T>() => T extends A ? 1 : 2) extends (<T>() => T extends B ? 1 : 2) ? true : false;
 export type Assert<T extends true> = T;

package/src/index.d.ts

@@ -1,5 +1,5 @@
 export { signalTree } from './lib/signal-tree';
-export type { ISignalTree, SignalTree, SignalTreeBase, FullSignalTree, ProdSignalTree, TreeNode, CallableWritableSignal, AccessibleNode, NodeAccessor, Primitive, NotFn, TreeConfig, TreePreset, Enhancer, EnhancerMeta, EnhancerWithMeta, EntitySignal, EntityMapMarker, EntityConfig, MutationOptions, AddOptions, AddManyOptions, TimeTravelEntry, TimeTravelMethods, } from './lib/types';
+export type { ISignalTree, SignalTree, SignalTreeBase, TreeNode, CallableWritableSignal, AccessibleNode, NodeAccessor, Primitive, NotFn, TreeConfig, Enhancer, EnhancerMeta, EnhancerWithMeta, EntitySignal, EntityMapMarker, EntityConfig, MutationOptions, AddOptions, AddManyOptions, TimeTravelEntry, TimeTravelMethods, EnhancerCleanup, } from './lib/types';
 export { entityMap } from './lib/types';
 export type { ProcessDerived, DeepMergeTree, DerivedFactory, WithDerived, } from './lib/internals/derived-types';
 export { derivedFrom, externalDerived } from './lib/internals/derived-types';
@@ -9,19 +9,13 @@ export { status, isStatusMarker, LoadingState, type StatusMarker, type StatusSig
 export { stored, isStoredMarker, createStorageKeys, clearStoragePrefix, type StoredMarker, type StoredSignal, type StoredOptions, } from './lib/markers/stored';
 export { form, isFormMarker, createFormSignal, validators, FORM_MARKER, type FormMarker, type FormSignal, type FormConfig, type FormFields, type FormWizard, type WizardConfig, type WizardStepConfig, type Validator, type AsyncValidator, } from './lib/markers/form';
 export { registerMarkerProcessor } from './lib/internals/materialize-markers';
-export { equal, deepEqual, isNodeAccessor, isAnySignal, toWritableSignal, parsePath, composeEnhancers, isBuiltInObject, createLazySignalTree, } from './lib/utils';
-export { createEditSession, type EditSession, type UndoRedoHistory, } from './lib/edit-session';
+export { equal, deepEqual, isNodeAccessor, isAnySignal, toWritableSignal, parsePath, composeEnhancers, isBuiltInObject, } from './lib/utils';
 export { getPathNotifier } from './lib/path-notifier';
-export { SecurityValidator, SecurityPresets, type SecurityEvent, type SecurityEventType, type SecurityValidatorConfig, } from './lib/security/security-validator';
 export { createEnhancer, resolveEnhancerOrder } from './enhancers/index';
 export { ENHANCER_META } from './lib/types';
-export { batching, batchingWithConfig, highPerformanceBatching, flushBatchedUpdates, hasPendingUpdates, getBatchQueueSize, } from './enhancers/batching/batching';
+export { batching } from './enhancers/batching/batching';
 export type { BatchingConfig, BatchingMethods } from './lib/types';
-export { memoization, selectorMemoization, computedMemoization, deepStateMemoization, highFrequencyMemoization, highPerformanceMemoization, lightweightMemoization, shallowMemoization, memoize, memoizeShallow, memoizeReference, clearAllCaches, getGlobalCacheStats, } from './enhancers/memoization/memoization';
-export { timeTravel, enableTimeTravel, } from './enhancers/time-travel/time-travel';
-export { entities, enableEntities, highPerformanceEntities, } from './enhancers/entities/entities';
-export { serialization, enableSerialization, persistence, createStorageAdapter, createIndexedDBAdapter, applySerialization, applyPersistence, } from './enhancers/serialization/serialization';
-export { devTools, enableDevTools, fullDevTools, productionDevTools, } from './enhancers/devtools/devtools';
-export { createAsyncOperation, trackAsync } from './lib/async-helpers';
-export { TREE_PRESETS, createPresetConfig, validatePreset, getAvailablePresets, combinePresets, createDevTree, } from './enhancers/presets/lib/presets';
-export { SIGNAL_TREE_CONSTANTS, SIGNAL_TREE_MESSAGES } from './lib/constants';
+export { timeTravel } from './enhancers/time-travel/time-travel';
+export { serialization, persistence, } from './enhancers/serialization/serialization';
+export { devTools } from './enhancers/devtools/devtools';
+export { SIGNAL_TREE_CONSTANTS, SIGNAL_TREE_MESSAGES, isDev } from './lib/constants';

package/src/lib/types.d.ts

@@ -14,13 +14,6 @@ export interface TimeTravelConfig {
         [key: string]: string | undefined;
     };
 }
-export interface MemoizationConfig {
-    enabled?: boolean;
-    maxCacheSize?: number;
-    ttl?: number;
-    enableLRU?: boolean;
-    equality?: 'deep' | 'shallow' | 'reference';
-}
 export type Primitive = string | number | boolean | null | undefined | bigint | symbol;
 export type NotFn<T> = T extends (...args: unknown[]) => unknown ? never : T;
 declare module '@angular/core' {
@@ -43,7 +36,10 @@ export interface ISignalTree<T> extends NodeAccessor<T> {
     with<TAdded>(enhancer: (tree: ISignalTree<T>) => ISignalTree<T> & TAdded): this & TAdded;
     bind(thisArg?: unknown): NodeAccessor<T>;
     destroy(): void;
+    readonly destroyed: Signal<boolean>;
+    registerCleanup(fn: EnhancerCleanup): void;
 }
+export type EnhancerCleanup = () => void;
 export interface EffectsMethods<T> {
     effect(fn: (state: T) => void | (() => void)): () => void;
     subscribe(fn: (state: T) => void): () => void;
@@ -58,20 +54,6 @@ export interface BatchingMethods<T = unknown> {
     hasPendingNotifications(): boolean;
     flushNotifications(): void;
 }
-export interface MemoizationMethods<T> {
-    memoize<R>(fn: (state: T) => R, cacheKey?: string): Signal<R>;
-    memoizedUpdate?: (updater: (current: T) => Partial<T>, cacheKey?: string) => void;
-    clearMemoCache(key?: string): void;
-    clearCache?: (key?: string) => void;
-    getCacheStats(): CacheStats;
-}
-export type CacheStats = {
-    size: number;
-    hitRate: number;
-    totalHits: number;
-    totalMisses: number;
-    keys: string[];
-};
 export interface TimeTravelMethods<T = unknown> {
     undo(): void;
     redo(): void;
@@ -122,10 +104,8 @@ export interface TimeTravelEntry<T> {
     state: T;
     payload?: unknown;
 }
-export type TreePreset = 'basic' | 'performance' | 'development' | 'production';
 export interface TreeConfig {
     batchUpdates?: boolean;
-    useMemoization?: boolean;
     enableTimeTravel?: boolean;
     useLazySignals?: boolean;
     useShallowComparison?: boolean;
@@ -307,9 +287,6 @@ export interface EnhancerMeta {
     provides?: string[];
     description?: string;
 }
-export type FullSignalTree<T> = ISignalTree<T> & EffectsMethods<T> & BatchingMethods<T> & MemoizationMethods<T> & TimeTravelMethods<T> & DevToolsMethods & EntitiesEnabled & OptimizedUpdateMethods<T>;
-export type ProdSignalTree<T> = ISignalTree<T> & EffectsMethods<T> & BatchingMethods<T> & MemoizationMethods<T> & EntitiesEnabled & OptimizedUpdateMethods<T>;
-export type MinimalSignalTree<T> = ISignalTree<T> & EffectsMethods<T>;
 export type SignalTree<T> = ISignalTree<T> & TreeNode<T>;
 export type SignalTreeBase<T> = ISignalTree<T> & TreeNode<T>;
 export declare function isSignalTree<T>(value: unknown): value is ISignalTree<T>;

package/src/security.d.ts

@@ -0,0 +1 @@
+export { SecurityValidator, SecurityPresets, type SecurityEvent, type SecurityEventType, type SecurityValidatorConfig, } from './lib/security/security-validator';

package/src/storage.d.ts

@@ -0,0 +1,2 @@
+export { createStorageAdapter, createIndexedDBAdapter, } from './enhancers/serialization/serialization';
+export type { StorageAdapter } from './enhancers/serialization/serialization';

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,7 +0,0 @@
-function entities(config = {}) {
-  throw new Error('entities() has been removed. Remove `.with(entities())` from your code; v7+ auto-processes EntityMap markers.');
-}
-const enableEntities = entities;
-const highPerformanceEntities = entities;
-
-export { enableEntities, entities, highPerformanceEntities };