@signaltree/core 3.1.0 → 4.0.1

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

@@ -0,0 +1,262 @@
+import type { SignalTree } from '../../../lib/types';
+/**
+ * Configuration options for intelligent batching behavior.
+ * Controls how updates are grouped and processed for optimal performance.
+ * Uses unconstrained recursive typing - no limitations on T
+ *
+ * @example
+ * ```typescript
+ * const config: BatchingConfig = {
+ *   enabled: true,
+ *   maxBatchSize: 50,
+ *   autoFlushDelay: 16, // 60fps
+ *   batchTimeoutMs: 100
+ * };
+ * ```
+ */
+interface BatchingConfig {
+    /** Whether batching is enabled (default: true) */
+    enabled?: boolean;
+    /** Maximum number of updates per batch (default: 100) */
+    maxBatchSize?: number;
+    /** Delay before auto-flushing batch in milliseconds (default: 16) */
+    autoFlushDelay?: number;
+    /** Maximum time to wait before forcing batch flush (default: 100) */
+    batchTimeoutMs?: number;
+}
+/**
+ * Enhanced SignalTree interface with intelligent batching capabilities.
+ * Provides high-performance batch update methods that group multiple state changes.
+ *
+ * @template T - The state object type extending StateObject
+ *
+ * @example
+ * ```typescript
+ * interface AppState {
+ *   users: User[];
+ *   ui: { loading: boolean; error: string | null };
+ *   stats: { total: number; active: number };
+ * }
+ *
+ * const tree: BatchingSignalTree<AppState> = create(initialState)
+ *   .with(withBatching());
+ *
+ * // Batch multiple related updates
+ * tree.batchUpdate((state) => ({
+ *   users: [...state.users, newUser],
+ *   ui: { ...state.ui, loading: false },
+ *   stats: {
+ *     total: state.users.length + 1,
+ *     active: state.users.filter(u => u.active).length + (newUser.active ? 1 : 0)
+ *   }
+ * }));
+ * Uses unconstrained recursive typing - no limitations on T
+ * ```
+ */
+interface BatchingSignalTree<T> extends SignalTree<T> {
+    /**
+     * Batches multiple state updates into a single change cycle for optimal performance.
+     * Groups related updates to prevent UI thrashing and improve rendering efficiency.
+     *
+     * @param updater - Function that receives current state and returns partial update
+     *
+     * @example
+     * ```typescript
+     * // Instead of multiple individual updates
+     * tree.update(() => ({ loading: true }));
+     * tree.update(() => ({ error: null }));
+     * tree.update(() => ({ users: [] }));
+     *
+     * // Use a single batched update
+     * tree.batchUpdate((state) => ({
+     *   loading: true,
+     *   error: null,
+     *   users: []
+     * }));
+     * ```
+     */
+    batchUpdate(updater: (current: T) => Partial<T>): void;
+}
+/**
+ * Enhances a SignalTree with intelligent batching capabilities for optimal performance.
+ * Automatically groups rapid state updates into efficient batch cycles to eliminate UI thrashing.
+ *
+ * @template T - The state object type extending StateObject
+ * @param config - Configuration options for batching behavior
+ * @returns Function that enhances a SignalTree with batching capabilities
+ *
+ * @example
+ * ```typescript
+ * // Basic batching with default settings
+ * const tree = create(initialState).with(withBatching());
+ *
+ * // High-performance batching for demanding applications
+ * const tree = create(initialState).with(withBatching({
+ *   maxBatchSize: 50,
+ *   autoFlushDelay: 8, // ~120fps
+ *   batchTimeoutMs: 50
+ * }));
+ *
+ * // Conservative batching for stable UIs
+ * const tree = create(initialState).with(withBatching({
+ *   maxBatchSize: 10,
+ *   autoFlushDelay: 100,
+ *   batchTimeoutMs: 200
+ * }));
+ *
+ * // Use batching methods
+ * tree.batchUpdate((state) => ({
+ *   users: [...state.users, newUser],
+ *   loading: false,
+ *   error: null
+ * }));
+ * Uses unconstrained recursive typing - no limitations on T
+ * ```
+ */
+export declare function withBatching<T>(config?: BatchingConfig): (tree: SignalTree<T>) => BatchingSignalTree<T>;
+/**
+ * Convenience function to enable batching with default settings.
+ * Equivalent to withBatching({ enabled: true }) but more concise for common usage.
+ *
+ * @template T - The state object type extending StateObject
+ * @returns Function that enhances a SignalTree with default batching settings
+ *
+ * @example
+ * ```typescript
+ * // Simple batching enablement
+ * const tree = create(initialState).with(enableBatching());
+ *
+ * // Equivalent to:
+ * const tree = create(initialState).with(withBatching({ enabled: true }));
+ * Uses unconstrained recursive typing - no limitations on T
+ * ```
+ */
+/**
+ * Creates high-performance batching configuration optimized for demanding applications.
+ * Uses aggressive batching settings for maximum performance in high-frequency update scenarios.
+ * Uses unconstrained recursive typing - no limitations on T
+ *
+ * @template T - The state object type extending StateObject
+ * @returns Function that enhances a SignalTree with high-performance batching
+ *
+ * @example
+ * ```typescript
+ * // For performance-critical applications
+ * const gameTree = create(gameState).with(withHighPerformanceBatching());
+ *
+ * // Perfect for:
+ * // - Real-time games
+ * // - High-frequency data updates
+ * // - Animation-heavy UIs
+ * // - Large dataset operations
+ *
+ * // Automatically includes:
+ * // - Large batch sizes (200 updates)
+ * // - Immediate processing (0ms timeout)
+ * // - Aggressive optimization
+ * Uses unconstrained recursive typing - no limitations on T
+ * ```
+ */
+export declare function withHighPerformanceBatching<T>(): (tree: SignalTree<T>) => BatchingSignalTree<T>;
+/**
+ * Manually flushes all pending batched updates immediately.
+ * Forces synchronous execution of queued updates, bypassing normal batching delays.
+ * Useful for testing scenarios or when immediate state consistency is required.
+ *
+ * @example
+ * ```typescript
+ * // Queue some updates
+ * tree.batchUpdate(() => ({ count: 1 }));
+ * tree.batchUpdate(() => ({ name: 'test' }));
+ *
+ * // In tests, ensure updates are applied immediately
+ * flushBatchedUpdates();
+ * expect(tree().count).toBe(1);
+ * expect(tree().name).toBe('test');
+ *
+ * // Before critical operations that need current state
+ * flushBatchedUpdates();
+ * const currentState = tree(); // Guaranteed to be up-to-date
+ *
+ * // In animation frames for precise timing
+ * requestAnimationFrame(() => {
+ *   flushBatchedUpdates(); // Ensure updates are applied before render
+ *   updateUI();
+ * });
+ * ```
+ */
+export declare function flushBatchedUpdates(): void;
+/**
+ * Checks if there are pending batched updates waiting to be processed.
+ * Useful for testing, debugging, or conditional logic based on update queue state.
+ *
+ * @returns True if updates are queued, false if queue is empty
+ *
+ * @example
+ * ```typescript
+ * // Check before critical operations
+ * tree.batchUpdate(() => ({ loading: true }));
+ *
+ * if (hasPendingUpdates()) {
+ *   console.log('Updates are queued for processing');
+ *   flushBatchedUpdates(); // Process them now if needed
+ * }
+ *
+ * // In testing
+ * tree.batchUpdate(() => ({ count: 1 }));
+ * expect(hasPendingUpdates()).toBe(true);
+ *
+ * flushBatchedUpdates();
+ * expect(hasPendingUpdates()).toBe(false);
+ *
+ * // Conditional behavior
+ * function performCriticalOperation() {
+ *   if (hasPendingUpdates()) {
+ *     flushBatchedUpdates(); // Ensure consistent state
+ *   }
+ *   // Proceed with operation
+ * }
+ * ```
+ */
+export declare function hasPendingUpdates(): boolean;
+/**
+ * Gets the current number of updates waiting in the batch queue.
+ * Useful for performance monitoring, debugging, and batch size optimization.
+ *
+ * @returns Number of queued updates
+ *
+ * @example
+ * ```typescript
+ * // Performance monitoring
+ * function monitorBatchPerformance() {
+ *   const queueSize = getBatchQueueSize();
+ *
+ *   if (queueSize > 50) {
+ *     console.warn(`Large batch queue detected: ${queueSize} updates`);
+ *   }
+ *
+ *   // Log metrics
+ *   console.log(`Current queue size: ${queueSize}`);
+ * }
+ *
+ * // Debug batching behavior
+ * tree.batchUpdate(() => ({ a: 1 }));
+ * tree.batchUpdate(() => ({ b: 2 }));
+ * tree.batchUpdate(() => ({ c: 3 }));
+ *
+ * console.log(`Queue size: ${getBatchQueueSize()}`); // 3
+ *
+ * flushBatchedUpdates();
+ * console.log(`Queue size after flush: ${getBatchQueueSize()}`); // 0
+ *
+ * // Optimize batch configuration
+ * const currentQueueSize = getBatchQueueSize();
+ * if (currentQueueSize > 100) {
+ *   // Consider reducing maxBatchSize or autoFlushDelay
+ *   console.log('Consider optimizing batch configuration');
+ * }
+ * ```
+ */
+export declare function getBatchQueueSize(): number;
+export {};
+//# sourceMappingURL=batching.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"batching.d.ts","sourceRoot":"","sources":["../../../../../../../../src/enhancers/batching/lib/batching.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD;;;;;;;;;;;;;;GAcG;AACH,UAAU,cAAc;IACtB,kDAAkD;IAClD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qEAAqE;IACrE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qEAAqE;IACrE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,UAAU,kBAAkB,CAAC,CAAC,CAAE,SAAQ,UAAU,CAAC,CAAC,CAAC;IACnD;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,WAAW,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;CACxD;AA4JD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAC5B,MAAM,GAAE,cAAmB,GAC1B,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,kBAAkB,CAAC,CAAC,CAAC,CAgFhD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,2BAA2B,CAAC,CAAC,oDAM5C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAc1C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C"}

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

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

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

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

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

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

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

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

package/dist/enhancers/memoization/types/packages/core/src/enhancers/computed/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/enhancers/memoization/types/packages/core/src/enhancers/computed/jest.config.d.ts.map

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

package/dist/enhancers/memoization/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/enhancers/memoization/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/enhancers/memoization/types/packages/core/src/enhancers/devtools/index.d.ts

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

package/dist/enhancers/memoization/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/enhancers/memoization/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/enhancers/memoization/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/enhancers/memoization/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/enhancers/memoization/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/enhancers/memoization/types/packages/core/src/enhancers/devtools/test-setup.d.ts

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

package/dist/enhancers/memoization/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/enhancers/memoization/types/packages/core/src/enhancers/entities/index.d.ts

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

package/dist/enhancers/memoization/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/enhancers/memoization/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/enhancers/memoization/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/enhancers/memoization/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/enhancers/memoization/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/enhancers/memoization/types/packages/core/src/enhancers/entities/test-setup.d.ts

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

package/dist/enhancers/memoization/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":""}