@signaltree/core 3.0.2 → 4.0.1

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

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

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

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

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

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

package/dist/enhancers/serialization/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/enhancers/serialization/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/enhancers/serialization/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/enhancers/serialization/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/enhancers/serialization/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/enhancers/serialization/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

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

@@ -0,0 +1 @@
+{"version":3,"file":"async-helpers.d.ts","sourceRoot":"","sources":["../../../../../../../../src/enhancers/middleware/lib/async-helpers.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,OAAO,EAC7C,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,IAEnB,MAAM,UAAU,CAAC,CAAC,CAAC,sBAiFlC;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC;;;;;EAyBxD"}

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

@@ -0,0 +1,43 @@
+import type { Middleware, SignalTree } from '../../../lib/types';
+/**
+ * Sets up middleware for a SignalTree with an array of middleware functions.
+ * Replaces any existing middleware configuration.
+ *
+ * @param tree - The SignalTree to enhance with middleware
+ * @param middlewares - Array of middleware functions to apply
+ * @returns The enhanced SignalTree
+ */
+export declare function withMiddleware<T>(middlewares?: Middleware<T>[]): (tree: SignalTree<T>) => SignalTree<T>;
+/**
+ * Creates a logging middleware that tracks all state changes.
+ *
+ * @param treeName - Name to display in console logs
+ * @returns Configured logging middleware
+ */
+export declare function createLoggingMiddleware<T>(treeName: string): Middleware<T>;
+/**
+ * Creates a performance monitoring middleware.
+ *
+ * @returns Configured performance middleware
+ */
+export declare function createPerformanceMiddleware<T>(): Middleware<T>;
+/**
+ * Creates a validation middleware that validates state after updates.
+ *
+ * @param validator - Function that validates state and returns error message or null
+ * @returns Configured validation middleware
+ */
+export declare function createValidationMiddleware<T>(validator: (state: T) => string | null): Middleware<T>;
+/**
+ * Creates a persistence middleware that auto-saves state changes.
+ *
+ * @param config - Configuration for persistence behavior
+ * @returns Configured persistence middleware
+ */
+export declare function createPersistenceMiddleware<T>(config: {
+    key: string;
+    storage?: Storage;
+    debounceMs?: number;
+    actions?: string[];
+}): Middleware<T>;
+//# sourceMappingURL=middleware.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../../../../../../../src/enhancers/middleware/lib/middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAKjE;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC9B,WAAW,GAAE,UAAU,CAAC,CAAC,CAAC,EAAO,GAChC,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,UAAU,CAAC,CAAC,CAAC,CAgLxC;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,CAiB1E;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,CAAC,KAAK,UAAU,CAAC,CAAC,CAAC,CAW9D;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,CAAC,EAC1C,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,GAAG,IAAI,GACrC,UAAU,CAAC,CAAC,CAAC,CAUf;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,CAAC,EAAE,MAAM,EAAE;IACrD,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB,GAAG,UAAU,CAAC,CAAC,CAAC,CAgChB"}

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

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

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

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

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

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

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

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

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

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

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

@@ -0,0 +1,69 @@
+import type { TreeConfig } from '../../../lib/types';
+export type TreePreset = 'basic' | 'performance' | 'development' | 'production';
+/**
+ * Pre-configured SignalTree configurations for common use cases.
+ *
+ * - **basic**: Minimal configuration with no advanced features
+ * - **performance**: Optimized for speed with batching and memoization
+ * - **development**: Full debugging features including time-travel and devtools
+ * - **production**: Optimized for production with performance features only
+ */
+export declare const TREE_PRESETS: Record<TreePreset, Partial<TreeConfig>>;
+/**
+ * Helper function to create a tree configuration from a preset.
+ * Can be used to start with a preset and then customize specific options.
+ *
+ * @param preset - The preset name to use as a base
+ * @param overrides - Optional overrides to apply on top of the preset
+ * @returns Complete tree configuration
+ *
+ * @example
+ * ```typescript
+ * // Use development preset with custom tree name
+ * const config = createPresetConfig('development', { treeName: 'MyApp' });
+ *
+ * // Use performance preset but enable debug mode
+ * const debugPerf = createPresetConfig('performance', { debugMode: true });
+ * ```
+ */
+export declare function createPresetConfig(preset: TreePreset, overrides?: Partial<TreeConfig>): TreeConfig;
+/**
+ * Validates that a preset configuration is valid.
+ * Useful for development-time checks.
+ *
+ * @param preset - The preset to validate
+ * @returns True if valid, throws error if invalid
+ */
+export declare function validatePreset(preset: TreePreset): boolean;
+/**
+ * Gets the list of available preset names.
+ *
+ * @returns Array of preset names
+ */
+export declare function getAvailablePresets(): TreePreset[];
+/**
+ * Creates a custom preset by combining multiple existing presets.
+ * Later presets in the array take precedence over earlier ones.
+ *
+ * @param presets - Array of presets to combine
+ * @param overrides - Optional final overrides
+ * @returns Combined configuration
+ *
+ * @example
+ * ```typescript
+ * // Combine basic preset with some performance features
+ * const config = combinePresets(['basic', 'performance'], { enableDevTools: true });
+ * ```
+ */
+export declare function combinePresets(presets: TreePreset[], overrides?: Partial<TreeConfig>): TreeConfig;
+/**
+ * Convenience helper for creating a development-ready SignalTree.
+ * Composes dev-only enhancers (devtools, time-travel, async) into a single
+ * enhancer function that can be applied to a tree. This keeps packages
+ * independent while offering a one-line dev onboarding.
+ */
+export declare function createDevTree(overrides?: Partial<TreeConfig>): {
+    readonly config: TreeConfig;
+    readonly enhancer: (tree: unknown) => unknown;
+};
+//# sourceMappingURL=presets.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../../../../../../../../src/enhancers/presets/lib/presets.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,aAAa,GAAG,aAAa,GAAG,YAAY,CAAC;AAEhF;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,UAAU,CAAC,CAsChE,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,UAAU,EAClB,SAAS,GAAE,OAAO,CAAC,UAAU,CAAM,GAClC,UAAU,CAMZ;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAS1D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,UAAU,EAAE,CAElD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,UAAU,EAAE,EACrB,SAAS,GAAE,OAAO,CAAC,UAAU,CAAM,GAClC,UAAU,CASZ;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,SAAS,GAAE,OAAO,CAAC,UAAU,CAAM;;;EAoDhE"}

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

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

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

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

package/dist/enhancers/serialization/types/packages/core/src/enhancers/serialization/constants.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Type markers for special object serialization
+ * Using compact symbols to minimize serialized size
+ */
+export declare const TYPE_MARKERS: {
+    readonly DATE: "§d";
+    readonly REGEXP: "§r";
+    readonly MAP: "§m";
+    readonly SET: "§s";
+    readonly UNDEFINED: "§u";
+    readonly NAN: "§n";
+    readonly INFINITY: "§i";
+    readonly NEG_INFINITY: "§-i";
+    readonly BIGINT: "§b";
+    readonly SYMBOL: "§y";
+    readonly FUNCTION: "§f";
+    readonly CIRCULAR: "§c";
+};
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../../../../src/enhancers/serialization/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;CAaf,CAAC"}

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

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

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

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

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

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