@signaltree/core 3.0.2 → 4.0.1

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

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

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

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

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

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

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

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

@@ -0,0 +1,186 @@
+import type { SignalTree } from '../../../lib/types';
+import type { EnhancerWithMeta } from '../../../lib/types';
+/**
+ * Serialization configuration options
+ */
+export interface SerializationConfig {
+    /**
+     * Whether to include metadata (timestamps, version, etc.)
+     * @default true
+     */
+    includeMetadata?: boolean;
+    /**
+     * Custom replacer function for JSON.stringify
+     */
+    replacer?: (key: string, value: unknown) => unknown;
+    /**
+     * Custom reviver function for JSON.parse
+     */
+    reviver?: (key: string, value: unknown) => unknown;
+    /**
+     * Whether to preserve special types (Date, RegExp, etc.)
+     * @default true
+     */
+    preserveTypes?: boolean;
+    /**
+     * Maximum depth to serialize (prevents infinite recursion)
+     * @default 50
+     */
+    maxDepth?: number;
+    /**
+     * Whether to handle circular references
+     * @default true
+     */
+    handleCircular?: boolean;
+}
+/**
+ * Serialized state wrapper with metadata
+ */
+export interface SerializedState<T = unknown> {
+    /**
+     * The actual serialized state data
+     */
+    data: T;
+    /**
+     * Metadata about the serialization
+     */
+    metadata?: {
+        /**
+         * Timestamp when serialized
+         */
+        timestamp: number;
+        /**
+         * Version of the serialization format
+         */
+        version: string;
+        /**
+         * Custom application version
+         */
+        appVersion?: string;
+        /**
+         * Type information for special objects
+         */
+        types?: Record<string, string>;
+        /**
+         * Circular reference paths
+         */
+        circularRefs?: Array<{
+            path: string;
+            targetPath: string;
+        }>;
+        /**
+         * Optional map of paths that indicate where the target tree contains
+         * branch nodes (objects with set/update) or root-as-signal markers.
+         * Keys are paths (dot/array notation), values: 'b' = branch, 'r' = root
+         */
+        nodeMap?: Record<string, 'b' | 'r'>;
+    };
+}
+/**
+ * Enhanced SignalTree interface with serialization capabilities
+ */
+export interface SerializableSignalTree<T> extends SignalTree<T> {
+    /** Explicit reactive alias for state (helps TS resolution in tests) */
+    $: any;
+    /**
+     * Serialize the current state to a JSON string
+     */
+    serialize(config?: SerializationConfig): string;
+    /**
+     * Deserialize and apply state from a JSON string
+     */
+    deserialize(json: string, config?: SerializationConfig): void;
+    /**
+     * Get a plain object representation of the current state
+     */
+    toJSON(): T;
+    /**
+     * Restore state from a plain object
+     */
+    fromJSON(data: T, metadata?: SerializedState<T>['metadata']): void;
+    /**
+     * Create a snapshot of the current state
+     */
+    snapshot(): SerializedState<T>;
+    /**
+     * Restore state from a snapshot
+     */
+    restore(snapshot: SerializedState<T>): void;
+}
+/**
+ * Methods added by the persistence enhancer
+ */
+export interface PersistenceMethods {
+    save(): Promise<void>;
+    load(): Promise<void>;
+    clear(): Promise<void>;
+    __flushAutoSave?: () => Promise<void>;
+}
+/**
+ * Enhances a SignalTree with serialization capabilities
+ */
+export declare function withSerialization<T extends Record<string, unknown> = Record<string, unknown>>(defaultConfig?: SerializationConfig): EnhancerWithMeta<SignalTree<T>, SerializableSignalTree<T>>;
+/**
+ * Convenience function to enable serialization with defaults
+ */
+export declare function enableSerialization<T extends Record<string, unknown> = Record<string, unknown>>(): EnhancerWithMeta<SignalTree<T>, SerializableSignalTree<T>>;
+/**
+ * Storage adapter interface for persistence
+ */
+export interface StorageAdapter {
+    getItem(key: string): string | null | Promise<string | null>;
+    setItem(key: string, value: string): void | Promise<void>;
+    removeItem(key: string): void | Promise<void>;
+}
+/**
+ * Persistence configuration
+ */
+export interface PersistenceConfig extends SerializationConfig {
+    /**
+     * Storage key to use
+     */
+    key: string;
+    /**
+     * Storage adapter (defaults to localStorage)
+     */
+    storage?: StorageAdapter;
+    /**
+     * Whether to auto-save on every update
+     * @default true
+     */
+    autoSave?: boolean;
+    /**
+     * Debounce delay for auto-save in ms
+     * @default 1000
+     */
+    debounceMs?: number;
+    /**
+     * Whether to auto-load on creation
+     * @default true
+     */
+    autoLoad?: boolean;
+    /**
+     * Whether to skip caching and force storage writes even if unchanged
+     * @default false
+     */
+    skipCache?: boolean;
+}
+/**
+ * Adds persistence capabilities to a SerializableSignalTree
+ */
+export declare function withPersistence<T extends Record<string, unknown> = Record<string, unknown>>(config: PersistenceConfig): EnhancerWithMeta<SignalTree<T>, SerializableSignalTree<T> & PersistenceMethods>;
+/**
+ * Create a custom storage adapter
+ */
+export declare function createStorageAdapter(getItem: (key: string) => string | null | Promise<string | null>, setItem: (key: string, value: string) => void | Promise<void>, removeItem: (key: string) => void | Promise<void>): StorageAdapter;
+/**
+ * IndexedDB storage adapter for large state trees
+ */
+export declare function createIndexedDBAdapter(dbName?: string, storeName?: string): StorageAdapter;
+/**
+ * Helpers to apply enhancers with explicit typing to avoid depending on
+ * complex `.with()` overload inference in tests and tooling.
+ */
+export declare function applySerialization<T extends Record<string, unknown>>(tree: SignalTree<T>): SerializableSignalTree<T>;
+export declare function applyPersistence<T extends Record<string, unknown>>(tree: SignalTree<T>, cfg: PersistenceConfig): SerializableSignalTree<T> & PersistenceMethods;
+//# sourceMappingURL=serialization.d.ts.map

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

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

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

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

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

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

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

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

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

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

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

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

package/dist/types/packages/core/src/enhancers/time-travel/lib/time-travel.d.ts

@@ -0,0 +1,145 @@
+import type { SignalTree } from '../../../lib/types';
+/**
+ * Entry in the time travel history
+ */
+export interface TimeTravelEntry<T> {
+    state: T;
+    timestamp: number;
+    action: string;
+    payload?: unknown;
+}
+/**
+ * Time travel interface for state history management
+ */
+export interface TimeTravelInterface<T> {
+    /**
+     * Navigate backward in history by one step
+     */
+    undo(): boolean;
+    /**
+     * Navigate forward in history by one step
+     */
+    redo(): boolean;
+    /**
+     * Get the complete history of state changes
+     */
+    getHistory(): TimeTravelEntry<T>[];
+    /**
+     * Reset the history, keeping only the current state
+     */
+    resetHistory(): void;
+    /**
+     * Jump to a specific point in history by index
+     */
+    jumpTo(index: number): boolean;
+    /**
+     * Get current position in history
+     */
+    getCurrentIndex(): number;
+    /**
+     * Check if undo is possible
+     */
+    canUndo(): boolean;
+    /**
+     * Check if redo is possible
+     */
+    canRedo(): boolean;
+}
+/**
+ * Configuration options for time travel
+ */
+export interface TimeTravelConfig {
+    /**
+     * Maximum number of history entries to keep
+     * @default 50
+     */
+    maxHistorySize?: number;
+    /**
+     * Whether to include payload information in history entries
+     * @default true
+     */
+    includePayload?: boolean;
+    /**
+     * Custom action names for different operations
+     */
+    actionNames?: {
+        update?: string;
+        set?: string;
+        batch?: string;
+        [key: string]: string | undefined;
+    };
+}
+/**
+ * Enhances a SignalTree with comprehensive time travel capabilities.
+ *
+ * Adds undo/redo functionality, state history management, and snapshot features.
+ * Automatically tracks state changes and provides methods to navigate through
+ * the application's state history with configurable limits and optimizations.
+ *
+ * @template T - The state object type
+ * @param config - Configuration options for time travel behavior
+ * @returns Function that enhances a SignalTree with time travel capabilities
+ *
+ * @example
+ * ```typescript
+ * // Basic time travel enhancement
+ * const store = signalTree({ count: 0, text: '' }).with(withTimeTravel());
+ *
+ * // Make some changes
+ * store.count.set(1);
+ * store.text.set('hello');
+ * store.count.set(2);
+ *
+ * // Access time travel interface
+ * const timeTravel = store.__timeTravel;
+ *
+ * // Navigate history
+ * console.log(timeTravel.canUndo()); // true
+ * timeTravel.undo(); // count: 1, text: 'hello'
+ * timeTravel.undo(); // count: 1, text: ''
+ * timeTravel.undo(); // count: 0, text: ''
+ *
+ * timeTravel.redo(); // count: 1, text: ''
+ * console.log(timeTravel.canRedo()); // true
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Advanced configuration
+ * const store = signalTree({
+ *   document: { title: '', content: '' },
+ *   settings: { theme: 'light' }
+ * }).with(withTimeTravel({
+ *   maxHistorySize: 50,        // Limit memory usage
+ *   includePayload: true,      // Store action metadata
+ *   actionNames: {             // Custom action names
+ *     'update_title': 'Update Document Title',
+ *     'change_theme': 'Change Theme'
+ *   }
+ * }));
+ *
+ * // Named actions with metadata
+ * store.update(() => ({ document: { title: 'New Title' } }), 'update_title');
+ *
+ * // View detailed history
+ * const history = store.__timeTravel.getHistory();
+ * console.log(history[0].action); // 'Update Document Title'
+ * console.log(history[0].timestamp); // Date when change occurred
+ * ```
+ */
+export declare function withTimeTravel<T>(config?: TimeTravelConfig): (tree: SignalTree<T>) => SignalTree<T> & {
+    __timeTravel: TimeTravelInterface<T>;
+};
+/**
+ * Convenience function to enable basic time travel
+ */
+export declare function enableTimeTravel<T>(maxHistorySize?: number): (tree: SignalTree<T>) => SignalTree<T> & {
+    __timeTravel: TimeTravelInterface<T>;
+};
+/**
+ * Get time travel interface from an enhanced tree
+ */
+export declare function getTimeTravel<T>(tree: SignalTree<T> & {
+    __timeTravel?: TimeTravelInterface<T>;
+}): TimeTravelInterface<T> | undefined;
+//# sourceMappingURL=time-travel.d.ts.map

package/dist/types/packages/core/src/enhancers/time-travel/lib/time-travel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time-travel.d.ts","sourceRoot":"","sources":["../../../../../../../../src/enhancers/time-travel/lib/time-travel.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,KAAK,EAAE,CAAC,CAAC;IACT,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB,CAAC,CAAC;IACpC;;OAEG;IACH,IAAI,IAAI,OAAO,CAAC;IAEhB;;OAEG;IACH,IAAI,IAAI,OAAO,CAAC;IAEhB;;OAEG;IACH,UAAU,IAAI,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC;IAEnC;;OAEG;IACH,YAAY,IAAI,IAAI,CAAC;IAErB;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IAE/B;;OAEG;IACH,eAAe,IAAI,MAAM,CAAC;IAE1B;;OAEG;IACH,OAAO,IAAI,OAAO,CAAC;IAEnB;;OAEG;IACH,OAAO,IAAI,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;OAEG;IACH,WAAW,CAAC,EAAE;QACZ,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;KACnC,CAAC;CACH;AAiID;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyDG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC9B,MAAM,GAAE,gBAAqB,GAC5B,CACD,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAChB,UAAU,CAAC,CAAC,CAAC,GAAG;IAAE,YAAY,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAA;CAAE,CA6H5D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAChC,cAAc,CAAC,EAAE,MAAM,GACtB,CACD,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAChB,UAAU,CAAC,CAAC,CAAC,GAAG;IAAE,YAAY,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAA;CAAE,CAE5D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAC7B,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG;IAAE,YAAY,CAAC,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAA;CAAE,GAC9D,mBAAmB,CAAC,CAAC,CAAC,GAAG,SAAS,CAEpC"}

package/dist/types/packages/core/src/enhancers/time-travel/lib/utils.d.ts

@@ -0,0 +1,3 @@
+/** Shared utilities consumed by the time-travel package. */
+export { deepClone, deepEqual } from '@signaltree/shared';
+//# sourceMappingURL=utils.d.ts.map

package/dist/types/packages/core/src/enhancers/time-travel/lib/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../../../../../src/enhancers/time-travel/lib/utils.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC"}

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

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

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

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