@signaltree/core 3.0.2 → 4.0.1

package/dist/types/packages/core/src/enhancers/computed/lib/computed.d.ts

@@ -0,0 +1,68 @@
+import { Signal } from '@angular/core';
+import type { TreeNode, SignalTree } from '../../../lib/types';
+/**
+ * Configuration for the computed enhancer
+ */
+export interface ComputedConfig {
+    /** Whether to enable lazy evaluation */
+    lazy?: boolean;
+    /** Whether to memoize computed values */
+    memoize?: boolean;
+}
+/**
+ * Computed signal type for derived state
+ */
+export type ComputedSignal<T> = Signal<T>;
+/**
+ * Extended SignalTree with computed signal capabilities
+ */
+export interface ComputedSignalTree<T extends Record<string, unknown>> extends SignalTree<T> {
+    /**
+     * Create a computed signal from the current tree state
+     * @param computeFn Function that computes the derived value
+     * @returns A computed signal that updates when dependencies change
+     */
+    computed<U>(computeFn: (tree: TreeNode<T>) => U): ComputedSignal<U>;
+}
+/**
+ * Computed enhancer factory function
+ * @param config Configuration options for computed signals
+ * @returns Enhancer that adds computed signal functionality
+ *
+ * @example
+ * ```typescript
+ * import { signalTree } from '@signaltree/core';
+ * import { computed } from '@signaltree/core/enhancers/computed';
+ *
+ * const state = signalTree(
+ *   { count: 0, multiplier: 2 },
+ *   { enhancers: [computed()] }
+ * );
+ *
+ * // Create a computed signal
+ * const doubled = state.computed(tree => tree.count() * tree.multiplier());
+ *
+ * console.log(doubled()); // 0
+ * state.count.set(5);
+ * console.log(doubled()); // 10
+ * ```
+ */
+export declare function computedEnhancer(config?: ComputedConfig): import("../../../lib/types").EnhancerWithMeta<SignalTree<Record<string, unknown>>, ComputedSignalTree<Record<string, unknown>>>;
+/**
+ * Utility function to create a computed signal from multiple dependencies
+ * @param dependencies Array of signals to depend on
+ * @param computeFn Function that computes the result
+ * @returns Computed signal
+ *
+ * @example
+ * ```typescript
+ * import { signal } from '@angular/core';
+ * import { createComputed } from '@signaltree/core/enhancers/computed';
+ *
+ * const a = signal(1);
+ * const b = signal(2);
+ * const sum = createComputed([a, b], () => a() + b());
+ * ```
+ */
+export declare function createComputed<T>(dependencies: readonly Signal<unknown>[], computeFn: () => T): ComputedSignal<T>;
+//# sourceMappingURL=computed.d.ts.map

package/dist/types/packages/core/src/enhancers/computed/lib/computed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"computed.d.ts","sourceRoot":"","sources":["../../../../../../../../src/enhancers/computed/lib/computed.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,MAAM,EAAE,MAAM,eAAe,CAAC;AAIjD,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,wCAAwC;IACxC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,yCAAyC;IACzC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC;AAE1C;;GAEG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CACnE,SAAQ,UAAU,CAAC,CAAC,CAAC;IACrB;;;;OAIG;IACH,QAAQ,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;CACrE;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,GAAE,cAAmB,mIAuB3D;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC9B,YAAY,EAAE,SAAS,MAAM,CAAC,OAAO,CAAC,EAAE,EACxC,SAAS,EAAE,MAAM,CAAC,GACjB,cAAc,CAAC,CAAC,CAAC,CAEnB"}

package/dist/types/packages/core/src/enhancers/devtools/index.d.ts

@@ -0,0 +1,2 @@
+export * from './lib/devtools';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/packages/core/src/enhancers/devtools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../src/enhancers/devtools/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC"}

package/dist/types/packages/core/src/enhancers/devtools/jest.config.d.ts

@@ -0,0 +1,16 @@
+declare const _default: {
+    displayName: string;
+    preset: string;
+    setupFilesAfterEnv: string[];
+    coverageDirectory: string;
+    transform: {
+        '^.+\\.(ts|mjs|js|html)$': (string | {
+            tsconfig: string;
+            stringifyContentPathRegex: string;
+        })[];
+    };
+    transformIgnorePatterns: string[];
+    snapshotSerializers: string[];
+};
+export default _default;
+//# sourceMappingURL=jest.config.d.ts.map

package/dist/types/packages/core/src/enhancers/devtools/jest.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jest.config.d.ts","sourceRoot":"","sources":["../../../../../../../src/enhancers/devtools/jest.config.ts"],"names":[],"mappings":";;;;;;;;;;;;;;AAAA,wBAoBE"}

package/dist/types/packages/core/src/enhancers/devtools/lib/devtools.d.ts

@@ -0,0 +1,129 @@
+import { Signal } from '@angular/core';
+import type { SignalTree } from '../../../lib/types';
+/**
+ * Module metadata for tracking in the composition chain
+ */
+export interface ModuleMetadata {
+    name: string;
+    methods: string[];
+    addedAt: Date;
+    lastActivity: Date;
+    operationCount: number;
+    averageExecutionTime: number;
+    errorCount: number;
+}
+/**
+ * Performance metrics optimized for modular composition
+ */
+export interface ModularPerformanceMetrics {
+    /** Total state updates across all modules */
+    totalUpdates: number;
+    /** Updates per module in the composition chain */
+    moduleUpdates: Record<string, number>;
+    /** Average execution time per module */
+    modulePerformance: Record<string, number>;
+    /** Current composition chain order */
+    compositionChain: string[];
+    /** Signal count after each module enhancement */
+    signalGrowth: Record<string, number>;
+    /** Memory impact per module */
+    memoryDelta: Record<string, number>;
+    /** Cache efficiency per module */
+    moduleCacheStats: Record<string, {
+        hits: number;
+        misses: number;
+    }>;
+}
+/**
+ * Module activity tracker for debugging
+ */
+export interface ModuleActivityTracker {
+    /** Track when a module method is called */
+    trackMethodCall: (module: string, method: string, duration: number) => void;
+    /** Track module errors */
+    trackError: (module: string, error: Error, context?: string) => void;
+    /** Get activity summary for a module */
+    getModuleActivity: (module: string) => ModuleMetadata | undefined;
+    /** Get all tracked modules */
+    getAllModules: () => ModuleMetadata[];
+}
+/**
+ * Composition-aware DevTools logger
+ */
+export interface CompositionLogger {
+    /** Log module composition events */
+    logComposition: (modules: string[], action: 'with' | 'enhance') => void;
+    /** Log method execution with module context */
+    logMethodExecution: (module: string, method: string, args: unknown[], result: unknown) => void;
+    /** Log state changes with composition context */
+    logStateChange: (module: string, path: string, oldValue: unknown, newValue: unknown) => void;
+    /** Log performance warnings for specific modules */
+    logPerformanceWarning: (module: string, operation: string, duration: number, threshold: number) => void;
+    /** Export logs for analysis */
+    exportLogs: () => Array<{
+        timestamp: Date;
+        module: string;
+        type: 'composition' | 'method' | 'state' | 'performance';
+        data: unknown;
+    }>;
+}
+/**
+ * DevTools interface specifically for modular SignalTree
+ */
+export interface ModularDevToolsInterface<T = unknown> {
+    /** Activity tracker for all modules */
+    activityTracker: ModuleActivityTracker;
+    /** Composition-aware logger */
+    logger: CompositionLogger;
+    /** Real-time performance metrics */
+    metrics: Signal<ModularPerformanceMetrics>;
+    /** Track module composition */
+    trackComposition: (modules: string[]) => void;
+    /** Start profiling a specific module */
+    startModuleProfiling: (module: string) => string;
+    /** End module profiling */
+    endModuleProfiling: (profileId: string) => void;
+    /** Connect to browser DevTools */
+    connectDevTools: (treeName: string) => void;
+    /** Export complete debug session */
+    exportDebugSession: () => {
+        metrics: ModularPerformanceMetrics;
+        modules: ModuleMetadata[];
+        logs: Array<unknown>;
+        compositionHistory: Array<{
+            timestamp: Date;
+            chain: string[];
+        }>;
+    };
+}
+/**
+ * Enhances a SignalTree with modular composition-aware DevTools
+ */
+export declare function withDevTools<T>(config?: {
+    enabled?: boolean;
+    treeName?: string;
+    enableBrowserDevTools?: boolean;
+    enableLogging?: boolean;
+    performanceThreshold?: number;
+}): (tree: SignalTree<T>) => SignalTree<T> & {
+    __devTools: ModularDevToolsInterface<T>;
+};
+/**
+ * Simple devtools for development
+ */
+export declare function enableDevTools<T>(treeName?: string): (tree: SignalTree<T>) => SignalTree<T> & {
+    __devTools: ModularDevToolsInterface<T>;
+};
+/**
+ * Full-featured devtools for intensive debugging
+ */
+export declare function withFullDevTools<T>(treeName?: string): (tree: SignalTree<T>) => SignalTree<T> & {
+    __devTools: ModularDevToolsInterface<T>;
+};
+/**
+ * Lightweight devtools for production
+ */
+export declare function withProductionDevTools<T>(): (tree: SignalTree<T>) => SignalTree<T> & {
+    __devTools: ModularDevToolsInterface<T>;
+};
+//# sourceMappingURL=devtools.d.ts.map

package/dist/types/packages/core/src/enhancers/devtools/lib/devtools.d.ts.map

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

package/dist/types/packages/core/src/enhancers/devtools/test-setup.d.ts

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

package/dist/types/packages/core/src/enhancers/devtools/test-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-setup.d.ts","sourceRoot":"","sources":["../../../../../../../src/enhancers/devtools/test-setup.ts"],"names":[],"mappings":""}

package/dist/types/packages/core/src/enhancers/entities/index.d.ts

@@ -0,0 +1,2 @@
+export * from './lib/entities';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/packages/core/src/enhancers/entities/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../src/enhancers/entities/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC"}

package/dist/types/packages/core/src/enhancers/entities/jest.config.d.ts

@@ -0,0 +1,16 @@
+declare const _default: {
+    displayName: string;
+    preset: string;
+    setupFilesAfterEnv: string[];
+    coverageDirectory: string;
+    transform: {
+        '^.+\\.(ts|mjs|js|html)$': (string | {
+            tsconfig: string;
+            stringifyContentPathRegex: string;
+        })[];
+    };
+    transformIgnorePatterns: string[];
+    snapshotSerializers: string[];
+};
+export default _default;
+//# sourceMappingURL=jest.config.d.ts.map

package/dist/types/packages/core/src/enhancers/entities/jest.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jest.config.d.ts","sourceRoot":"","sources":["../../../../../../../src/enhancers/entities/jest.config.ts"],"names":[],"mappings":";;;;;;;;;;;;;;AAAA,wBAoBE"}

package/dist/types/packages/core/src/enhancers/entities/lib/entities.d.ts

@@ -0,0 +1,39 @@
+import type { SignalTree, EntityHelpers } from '../../../lib/types';
+/**
+ * Entity configuration options
+ */
+interface EntityConfig {
+    enabled?: boolean;
+    trackChanges?: boolean;
+    validateIds?: boolean;
+}
+/**
+ * Enhances a SignalTree with entity management capabilities
+ * Works with SignalTree's TreeNode type structure
+ *
+ * The key insight: The state is already deeply signalified, so array properties
+ * like `users: User[]` become `users: WritableSignal<User[]>` in tree.state
+ */
+export declare function withEntities(config?: EntityConfig): <T>(tree: SignalTree<T>) => SignalTree<T> & {
+    entities<E extends {
+        id: string | number;
+    }>(entityKey: keyof T): EntityHelpers<E>;
+};
+/**
+ * Convenience function to enable entities with default config
+ */
+export declare function enableEntities(): <T>(tree: SignalTree<T>) => SignalTree<T> & {
+    entities<E extends {
+        id: string | number;
+    }>(entityKey: keyof T): EntityHelpers<E>;
+};
+/**
+ * High-performance entity management configuration
+ */
+export declare function withHighPerformanceEntities(): <T>(tree: SignalTree<T>) => SignalTree<T> & {
+    entities<E extends {
+        id: string | number;
+    }>(entityKey: keyof T): EntityHelpers<E>;
+};
+export {};
+//# sourceMappingURL=entities.d.ts.map

package/dist/types/packages/core/src/enhancers/entities/lib/entities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entities.d.ts","sourceRoot":"","sources":["../../../../../../../../src/enhancers/entities/lib/entities.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACpE;;GAEG;AACH,UAAU,YAAY;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAmJD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,MAAM,GAAE,YAAiB,IAGhB,CAAC,EAAE,MAAM,UAAU,CAAC,CAAC,CAAC,KAAG,UAAU,CAAC,CAAC,CAAC,GAAG;IAC3E,QAAQ,CAAC,CAAC,SAAS;QAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,EACxC,SAAS,EAAE,MAAM,CAAC,GACjB,aAAa,CAAC,CAAC,CAAC,CAAC;CACrB,CAuBF;AAED;;GAEG;AACH,wBAAgB,cAAc,KAhCQ,CAAC,QAAQ,UAAU,CAAC,CAAC,CAAC,KAAG,UAAU,CAAC,CAAC,CAAC,GAAG;IAC3E,QAAQ,CAAC,CAAC,SAAS;QAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,EACxC,SAAS,EAAE,MAAM,CAAC,GACjB,aAAa,CAAC,CAAC,CAAC,CAAC;CACrB,CA8BF;AAED;;GAEG;AACH,wBAAgB,2BAA2B,KAvCL,CAAC,QAAQ,UAAU,CAAC,CAAC,CAAC,KAAG,UAAU,CAAC,CAAC,CAAC,GAAG;IAC3E,QAAQ,CAAC,CAAC,SAAS;QAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,EACxC,SAAS,EAAE,MAAM,CAAC,GACjB,aAAa,CAAC,CAAC,CAAC,CAAC;CACrB,CAyCF"}

package/dist/types/packages/core/src/enhancers/entities/test-setup.d.ts

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

package/dist/types/packages/core/src/enhancers/entities/test-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-setup.d.ts","sourceRoot":"","sources":["../../../../../../../src/enhancers/entities/test-setup.ts"],"names":[],"mappings":""}

package/dist/types/packages/core/src/enhancers/index.d.ts

@@ -0,0 +1,38 @@
+/**
+ * SignalTree Enhancer System
+ * Handles enhancer composition and dependency resolution
+ */
+import type { EnhancerMeta, EnhancerWithMeta } from '../lib/types';
+/**
+ * Helper to create an enhancer with metadata attached
+ *
+ * @param meta - Metadata describing the enhancer
+ * @param enhancerFn - The enhancer function
+ * @returns Enhancer function with metadata attached
+ *
+ * @example
+ * ```typescript
+ * const myEnhancer = createEnhancer(
+ *   {
+ *     name: 'myEnhancer',
+ *     provides: ['feature1'],
+ *     requires: ['feature2']
+ *   },
+ *   (tree) => {
+ *     // Enhance the tree
+ *     return { ...tree, feature1: true };
+ *   }
+ * );
+ * ```
+ */
+export declare function createEnhancer<I = unknown, O = unknown>(meta: EnhancerMeta, enhancerFn: (input: I) => O): EnhancerWithMeta<I, O>;
+/**
+ * Resolve enhancer order using topological sort based on dependencies
+ *
+ * @param enhancers - Array of enhancers to order
+ * @param availableCapabilities - Set of already available capabilities
+ * @param debugMode - Whether to log debug information
+ * @returns Ordered array of enhancers
+ */
+export declare function resolveEnhancerOrder(enhancers: EnhancerWithMeta<unknown, unknown>[], availableCapabilities?: Set<string>, debugMode?: boolean): EnhancerWithMeta<unknown, unknown>[];
+//# sourceMappingURL=index.d.ts.map

package/dist/types/packages/core/src/enhancers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/enhancers/index.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACnE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,cAAc,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,EACrD,IAAI,EAAE,YAAY,EAClB,UAAU,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAC1B,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,CAcxB;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,EAC/C,qBAAqB,GAAE,GAAG,CAAC,MAAM,CAAqB,EACtD,SAAS,UAAQ,GAChB,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CA4EtC"}

package/dist/types/packages/core/src/enhancers/memoization/index.d.ts

@@ -0,0 +1,2 @@
+export * from './lib/memoization';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/packages/core/src/enhancers/memoization/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../src/enhancers/memoization/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC"}

package/dist/types/packages/core/src/enhancers/memoization/jest.config.d.ts

@@ -0,0 +1,16 @@
+declare const _default: {
+    displayName: string;
+    preset: string;
+    setupFilesAfterEnv: string[];
+    coverageDirectory: string;
+    transform: {
+        '^.+\\.(ts|mjs|js|html)$': (string | {
+            tsconfig: string;
+            stringifyContentPathRegex: string;
+        })[];
+    };
+    transformIgnorePatterns: string[];
+    snapshotSerializers: string[];
+};
+export default _default;
+//# sourceMappingURL=jest.config.d.ts.map

package/dist/types/packages/core/src/enhancers/memoization/jest.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jest.config.d.ts","sourceRoot":"","sources":["../../../../../../../src/enhancers/memoization/jest.config.ts"],"names":[],"mappings":";;;;;;;;;;;;;;AAAA,wBAoBE"}

package/dist/types/packages/core/src/enhancers/memoization/lib/memoization.d.ts

@@ -0,0 +1,190 @@
+import type { SignalTree } from '../../../lib/types';
+/**
+ * Extended SignalTree interface with memoization capabilities
+ * Uses the same unconstrained recursive typing approach as core
+ */
+export interface MemoizedSignalTree<T> extends SignalTree<T> {
+    memoizedUpdate: (updater: (current: T) => Partial<T>, cacheKey?: string) => void;
+    clearMemoCache: (key?: string) => void;
+    getCacheStats: () => {
+        size: number;
+        hitRate: number;
+        totalHits: number;
+        totalMisses: number;
+        keys: string[];
+    };
+}
+/**
+ * Cleanup the cache interval on app shutdown
+ */
+export declare function cleanupMemoizationCache(): void;
+/**
+ * Memoization configuration options
+ */
+export interface MemoizationConfig {
+    enabled?: boolean;
+    maxCacheSize?: number;
+    ttl?: number;
+    equality?: 'deep' | 'shallow' | 'reference';
+    enableLRU?: boolean;
+}
+/**
+ * Memoization function that caches expensive computations with enhanced cache management
+ */
+export declare function memoize<TArgs extends unknown[], TReturn>(fn: (...args: TArgs) => TReturn, keyFn?: (...args: TArgs) => string, config?: MemoizationConfig): (...args: TArgs) => TReturn;
+/**
+ * High-performance memoization function optimized for speed
+ * Uses shallow equality and minimal cache management overhead
+ */
+export declare function memoizeShallow<TArgs extends unknown[], TReturn>(fn: (...args: TArgs) => TReturn, keyFn?: (...args: TArgs) => string): (...args: TArgs) => TReturn;
+/**
+ * Lightweight memoization function with reference equality only
+ * Maximum performance for scenarios where exact reference matches are sufficient
+ */
+export declare function memoizeReference<TArgs extends unknown[], TReturn>(fn: (...args: TArgs) => TReturn, keyFn?: (...args: TArgs) => string): (...args: TArgs) => TReturn;
+/**
+ * Preset memoization configurations optimized for common use cases
+ * These presets are the same ones used in SignalTree's benchmarks
+ */
+export declare const MEMOIZATION_PRESETS: {
+    /**
+     * Optimized for selectors and frequently-accessed computed values
+     * - Fast reference-only equality checks (~0.3μs)
+     * - Small cache (10 entries) for minimal overhead
+     * - No LRU management (eliminates bookkeeping cost)
+     * - Best for: Selectors, derived values, stable references
+     */
+    readonly selector: {
+        readonly equality: "reference";
+        readonly maxCacheSize: 10;
+        readonly enableLRU: false;
+        readonly ttl: undefined;
+    };
+    /**
+     * Balanced configuration for general computed values
+     * - Shallow equality checks (~5-15μs) for object comparisons
+     * - Medium cache (100 entries) for reasonable coverage
+     * - No LRU (good performance/memory balance)
+     * - Best for: General computations, objects with primitives
+     */
+    readonly computed: {
+        readonly equality: "shallow";
+        readonly maxCacheSize: 100;
+        readonly enableLRU: false;
+        readonly ttl: undefined;
+    };
+    /**
+     * Thorough configuration for complex nested state
+     * - Deep equality checks (~50-200μs) for nested objects
+     * - Large cache (1000 entries) for complex scenarios
+     * - LRU enabled for intelligent cache management
+     * - 5-minute TTL to prevent stale data
+     * - Best for: Complex nested objects, thorough comparisons needed
+     */
+    readonly deepState: {
+        readonly equality: "deep";
+        readonly maxCacheSize: 1000;
+        readonly enableLRU: true;
+        readonly ttl: number;
+    };
+    /**
+     * Minimal overhead for high-frequency operations
+     * - Reference-only equality (fastest possible)
+     * - Tiny cache (5 entries) for minimal memory
+     * - No bells and whistles
+     * - Best for: Hot paths, microseconds matter, immutable data
+     */
+    readonly highFrequency: {
+        readonly equality: "reference";
+        readonly maxCacheSize: 5;
+        readonly enableLRU: false;
+        readonly ttl: undefined;
+    };
+};
+/**
+ * Convenience function: Memoization optimized for selectors
+ * Uses reference equality and small cache for maximum performance
+ *
+ * @example
+ * ```typescript
+ * const tree = signalTree(state).with(withSelectorMemoization());
+ * const activeUsers = computed(() =>
+ *   tree.state.users().filter(u => u.active)
+ * );
+ * ```
+ */
+export declare function withSelectorMemoization<T>(): (tree: SignalTree<T>) => MemoizedSignalTree<T>;
+/**
+ * Convenience function: Memoization optimized for computed values
+ * Uses shallow equality for balanced performance
+ *
+ * @example
+ * ```typescript
+ * const tree = signalTree(state).with(withComputedMemoization());
+ * const metrics = computed(() =>
+ *   calculateExpensiveMetrics(tree.state.data())
+ * );
+ * ```
+ */
+export declare function withComputedMemoization<T>(): (tree: SignalTree<T>) => MemoizedSignalTree<T>;
+/**
+ * Convenience function: Memoization for complex nested state
+ * Uses deep equality and LRU management
+ *
+ * @example
+ * ```typescript
+ * const tree = signalTree(state).with(withDeepStateMemoization());
+ * // Handles complex nested object comparisons
+ * ```
+ */
+export declare function withDeepStateMemoization<T>(): (tree: SignalTree<T>) => MemoizedSignalTree<T>;
+/**
+ * Convenience function: Minimal memoization for hot paths
+ * Maximum performance with minimal overhead
+ *
+ * @example
+ * ```typescript
+ * const tree = signalTree(state).with(withHighFrequencyMemoization());
+ * // For operations called thousands of times per second
+ * ```
+ */
+export declare function withHighFrequencyMemoization<T>(): (tree: SignalTree<T>) => MemoizedSignalTree<T>;
+/**
+ * Enhances a SignalTree with memoization capabilities
+ * Uses unconstrained recursive typing - no limitations on T
+ */
+export declare function withMemoization<T>(config?: MemoizationConfig): (tree: SignalTree<T>) => MemoizedSignalTree<T>;
+/**
+ * Convenience function to enable memoization with default settings
+ * Uses unconstrained recursive typing - no limitations on T
+ */
+export declare function enableMemoization<T>(): (tree: SignalTree<T>) => MemoizedSignalTree<T>;
+/**
+ * High-performance memoization with aggressive caching
+ * Uses unconstrained recursive typing - no limitations on T
+ */
+export declare function withHighPerformanceMemoization<T>(): (tree: SignalTree<T>) => MemoizedSignalTree<T>;
+/**
+ * Lightweight memoization optimized for performance-critical scenarios
+ * Disables expensive cache management features for maximum speed
+ */
+export declare function withLightweightMemoization<T>(): (tree: SignalTree<T>) => MemoizedSignalTree<T>;
+/**
+ * Shallow equality memoization for objects with primitive values
+ * Good balance between performance and correctness
+ */
+export declare function withShallowMemoization<T>(): (tree: SignalTree<T>) => MemoizedSignalTree<T>;
+/**
+ * Clear all memoization caches
+ */
+export declare function clearAllCaches(): void;
+/**
+ * Get global cache statistics
+ */
+export declare function getGlobalCacheStats(): {
+    treeCount: number;
+    totalSize: number;
+    totalHits: number;
+    averageCacheSize: number;
+};
+//# sourceMappingURL=memoization.d.ts.map

package/dist/types/packages/core/src/enhancers/memoization/lib/memoization.d.ts.map

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

package/dist/types/packages/core/src/enhancers/memoization/test-setup.d.ts

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

package/dist/types/packages/core/src/enhancers/memoization/test-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-setup.d.ts","sourceRoot":"","sources":["../../../../../../../src/enhancers/memoization/test-setup.ts"],"names":[],"mappings":""}

package/dist/types/packages/core/src/enhancers/middleware/index.d.ts

@@ -0,0 +1,3 @@
+export * from './lib/middleware';
+export * from './lib/async-helpers';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/packages/core/src/enhancers/middleware/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../src/enhancers/middleware/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC"}

package/dist/types/packages/core/src/enhancers/middleware/jest.config.d.ts

@@ -0,0 +1,16 @@
+declare const _default: {
+    displayName: string;
+    preset: string;
+    setupFilesAfterEnv: string[];
+    coverageDirectory: string;
+    transform: {
+        '^.+\\.(ts|mjs|js|html)$': (string | {
+            tsconfig: string;
+            stringifyContentPathRegex: string;
+        })[];
+    };
+    transformIgnorePatterns: string[];
+    snapshotSerializers: string[];
+};
+export default _default;
+//# sourceMappingURL=jest.config.d.ts.map

package/dist/types/packages/core/src/enhancers/middleware/jest.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jest.config.d.ts","sourceRoot":"","sources":["../../../../../../../src/enhancers/middleware/jest.config.ts"],"names":[],"mappings":";;;;;;;;;;;;;;AAAA,wBAoBE"}

package/dist/types/packages/core/src/enhancers/middleware/lib/async-helpers.d.ts

@@ -0,0 +1,16 @@
+import type { SignalTree } from '../../../lib/types';
+/**
+ * Create an async operation that updates the tree via its batchUpdate method
+ * and sets simple name-scoped keys for pending/result/error.
+ */
+export declare function createAsyncOperation<T, TResult>(name: string, operation: () => Promise<TResult>): (tree: SignalTree<T>) => Promise<TResult>;
+/**
+ * Standalone status tracking for async operations using Angular signals.
+ */
+export declare function trackAsync<T>(operation: () => Promise<T>): {
+    pending: import("@angular/core").Signal<boolean>;
+    error: import("@angular/core").Signal<Error | null>;
+    result: import("@angular/core").Signal<T | null>;
+    execute: () => Promise<T>;
+};
+//# sourceMappingURL=async-helpers.d.ts.map