@signaltree/core 3.0.2 → 4.0.1

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

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

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

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

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

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

@@ -0,0 +1,112 @@
+/**
+ * SignalTree Enhancers Types
+ * Type definitions for all enhancers
+ *
+ * @packageDocumentation
+ */
+export interface BatchingConfig {
+    maxBatchSize?: number;
+    debounceMs?: number;
+    flushOnMicrotask?: boolean;
+}
+export interface BatchUpdate<T = unknown> {
+    path: string[];
+    value: T;
+    timestamp: number;
+}
+export interface ComputedSignal<T> {
+    (): T;
+    readonly value: T;
+}
+export interface ComputedConfig {
+    lazy?: boolean;
+    memoize?: boolean;
+}
+export interface MiddlewareConfig {
+    beforeUpdate?: (path: string[], value: unknown) => void | boolean;
+    afterUpdate?: (path: string[], value: unknown, previousValue: unknown) => void;
+    beforeRead?: (path: string[]) => void;
+    afterRead?: (path: string[], value: unknown) => void;
+}
+export interface MiddlewareContext {
+    path: string[];
+    value: unknown;
+    previousValue?: unknown;
+    operation: 'read' | 'write';
+}
+export interface MemoizationConfig {
+    maxSize?: number;
+    ttl?: number;
+    strategy?: 'lru' | 'fifo' | 'lfu';
+}
+export interface MemoizedFunction<T extends (...args: never[]) => unknown> {
+    (...args: Parameters<T>): ReturnType<T>;
+    clear(): void;
+    stats(): {
+        hits: number;
+        misses: number;
+        size: number;
+    };
+}
+export interface TimeTravelConfig {
+    maxHistorySize?: number;
+    enableCompression?: boolean;
+}
+export interface TimeTravelState {
+    canUndo: boolean;
+    canRedo: boolean;
+    historySize: number;
+    currentIndex: number;
+}
+export interface DevToolsConfig {
+    name?: string;
+    enabled?: boolean;
+    logLevel?: 'debug' | 'info' | 'warn' | 'error';
+}
+export interface DevToolsAction {
+    type: string;
+    payload?: unknown;
+    timestamp: number;
+    source: string;
+}
+export interface PresetConfig {
+    name: string;
+    enhancers: unknown[];
+    config?: Record<string, unknown>;
+}
+export interface EntityConfig {
+    idField?: string;
+    indexes?: string[];
+    relations?: Record<string, string>;
+}
+export interface EntityCollection<T = unknown> {
+    add(entity: T): void;
+    remove(id: string | number): boolean;
+    update(id: string | number, updates: Partial<T>): boolean;
+    get(id: string | number): T | undefined;
+    find(predicate: (entity: T) => boolean): T | undefined;
+    filter(predicate: (entity: T) => boolean): T[];
+    count(): number;
+}
+export interface AsyncConfig {
+    timeout?: number;
+    retryAttempts?: number;
+    retryDelay?: number;
+}
+export interface AsyncAction<T = unknown> {
+    execute(): Promise<T>;
+    cancel(): void;
+    status: 'pending' | 'fulfilled' | 'rejected' | 'cancelled';
+}
+export interface SerializationConfig {
+    includeComputed?: boolean;
+    includeMeta?: boolean;
+    customSerializers?: Record<string, (value: unknown) => unknown>;
+}
+export interface SerializedState {
+    version: string;
+    timestamp: number;
+    data: unknown;
+    meta?: Record<string, unknown>;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

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

@@ -0,0 +1,119 @@
+/**
+ * SignalTree v1.1.6
+ * A reactive state management library for Angular
+ *
+ * Provides reactive state management with deep signal trees, enhancer system,
+ * and performance optimizations including lazy loading and batch updates.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Main factory function to create a SignalTree
+ * @see {@link signalTree}
+ */
+export { signalTree } from './lib/signal-tree';
+export type { SignalTree, TreeNode, RemoveSignalMethods, Primitive, BuiltInObject, NotFn, TreeConfig, TreePreset, Enhancer, EnhancerMeta, EnhancerWithMeta, ChainResult, WithMethod, Middleware, PerformanceMetrics, EntityHelpers, AsyncActionConfig, AsyncAction, TimeTravelEntry, } from './lib/types';
+export { equal, deepEqual, isNodeAccessor, isAnySignal, parsePath, composeEnhancers, isBuiltInObject, createLazySignalTree, } from './lib/utils';
+/**
+ * Security utilities for preventing common vulnerabilities
+ * @see {@link SecurityValidator} for validation and sanitization
+ * @see {@link SecurityPresets} for common security configurations
+ */
+export { SecurityValidator, SecurityPresets, type SecurityEvent, type SecurityEventType, type SecurityValidatorConfig, } from './lib/security/security-validator';
+/**
+ * Enhancer creation and composition utilities
+ * @see {@link createEnhancer} for creating enhancers with metadata
+ * @see {@link resolveEnhancerOrder} for dependency resolution
+ */
+export { createEnhancer, resolveEnhancerOrder } from './enhancers/index';
+/**
+ * Enhancer metadata symbol for third-party compatibility
+ */
+export { ENHANCER_META } from './lib/types';
+/**
+ * Batching enhancer for high-performance state updates
+ * @see {@link withBatching} for intelligent batching capabilities
+ */
+export { withBatching, withHighPerformanceBatching, flushBatchedUpdates, hasPendingUpdates, getBatchQueueSize, } from './enhancers/batching/lib/batching';
+/**
+ * Memoization enhancer for performance optimization
+ * @see {@link withMemoization} for intelligent memoization capabilities
+ */
+export { withMemoization, withSelectorMemoization, withComputedMemoization, withDeepStateMemoization, withHighFrequencyMemoization, withHighPerformanceMemoization, withLightweightMemoization, withShallowMemoization, memoize, memoizeShallow, memoizeReference, cleanupMemoizationCache, clearAllCaches, getGlobalCacheStats, } from './enhancers/memoization/lib/memoization';
+/**
+ * Time travel enhancer for debugging and undo/redo functionality
+ * @see {@link withTimeTravel} for time travel capabilities
+ */
+export { withTimeTravel, enableTimeTravel, getTimeTravel, type TimeTravelInterface, } from './enhancers/time-travel/lib/time-travel';
+/**
+ * Entities enhancer for normalized collection helpers
+ * @see {@link withEntities}
+ */
+export { withEntities, enableEntities, withHighPerformanceEntities, } from './enhancers/entities/lib/entities';
+/**
+ * Serialization enhancer for state persistence and restoration
+ * @see {@link withSerialization} for serialization capabilities
+ */
+export { withSerialization, enableSerialization, withPersistence, createStorageAdapter, createIndexedDBAdapter, applySerialization, applyPersistence, } from './enhancers/serialization/lib/serialization';
+/**
+ * Preset configurations for common use cases
+ * @see {@link createPresetConfig} for preset configuration
+ */
+export { TREE_PRESETS, createPresetConfig, validatePreset, getAvailablePresets, combinePresets, createDevTree, } from './enhancers/presets/lib/presets';
+/**
+ * Configuration constants and error messages
+ * Exposed for library extensions and debugging
+ * @see {@link SIGNAL_TREE_CONSTANTS} for configuration values
+ * @see {@link SIGNAL_TREE_MESSAGES} for error/warning messages
+ */
+export { SIGNAL_TREE_CONSTANTS, SIGNAL_TREE_MESSAGES } from './lib/constants';
+/**
+ * SignalTree Core API Summary:
+ *
+ * **Main Factory:**
+ * - `signalTree(state, config?)` - Create a reactive signal tree
+ *
+ * **Core Types:**
+ * - `SignalTree<T>` - Main interface for signal trees
+ * - `TreeNode<T>` - Type transformation for nested signals
+ * - `TreeConfig` - Configuration options
+ *
+ * **Utilities:**
+ * - `equal()` / `deepEqual()` - Comparison functions
+ *
+ * **Enhancer System:**
+ * - `createEnhancer()` - Create enhancers with metadata
+ * - `composeEnhancers()` - Combine multiple enhancers
+ *
+ * **Advanced:**
+ * - `createLazySignalTree()` - For performance optimizations
+ * - Constants and messages for extensions
+ *
+ * @example Basic Usage
+ * ```typescript
+ * import { signalTree } from '@signaltree/core';
+ *
+ * const state = signalTree({ count: 0, user: { name: 'John' } });
+ *
+ * // Access signals
+ * console.log(state.count()); // 0
+ * console.log(state.user.name()); // 'John'
+ *
+ * // Update values
+ * state.count.set(5);
+ * state.user.name.set('Jane');
+ * ```
+ *
+ * @example With Enhancers
+ * ```typescript
+ * import { signalTree, createEnhancer } from '@signaltree/core';
+ *
+ * const logger = createEnhancer(
+ *   { name: 'logger', provides: ['logging'] },
+ *   (tree) => ({ ...tree, log: () => console.log(tree) })
+ * );
+ *
+ * const state = signalTree({ count: 0 }, { enhancers: [logger] });
+ * ```
+ */
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH;;;GAGG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAM/C,YAAY,EAEV,UAAU,EACV,QAAQ,EACR,mBAAmB,EACnB,SAAS,EACT,aAAa,EACb,KAAK,EAGL,UAAU,EACV,UAAU,EAGV,QAAQ,EACR,YAAY,EACZ,gBAAgB,EAChB,WAAW,EACX,UAAU,EAGV,UAAU,EACV,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACjB,WAAW,EACX,eAAe,GAChB,MAAM,aAAa,CAAC;AAMrB,OAAO,EAEL,KAAK,EACL,SAAS,EAGT,cAAc,EACd,WAAW,EAGX,SAAS,EACT,gBAAgB,EAChB,eAAe,EAGf,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAMrB;;;;GAIG;AACH,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,GAC7B,MAAM,mCAAmC,CAAC;AAQ3C;;;;GAIG;AACH,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAEzE;;GAEG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAM5C;;;GAGG;AACH,OAAO,EACL,YAAY,EACZ,2BAA2B,EAC3B,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,mCAAmC,CAAC;AAE3C;;;GAGG;AACH,OAAO,EACL,eAAe,EACf,uBAAuB,EACvB,uBAAuB,EACvB,wBAAwB,EACxB,4BAA4B,EAC5B,8BAA8B,EAC9B,0BAA0B,EAC1B,sBAAsB,EACtB,OAAO,EACP,cAAc,EACd,gBAAgB,EAChB,uBAAuB,EACvB,cAAc,EACd,mBAAmB,GACpB,MAAM,yCAAyC,CAAC;AAEjD;;;GAGG;AACH,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,KAAK,mBAAmB,GACzB,MAAM,yCAAyC,CAAC;AAEjD;;;GAGG;AACH,OAAO,EACL,YAAY,EACZ,cAAc,EACd,2BAA2B,GAC5B,MAAM,mCAAmC,CAAC;AAE3C;;;GAGG;AACH,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,oBAAoB,EACpB,sBAAsB,EACtB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,6CAA6C,CAAC;AAErD;;;GAGG;AACH,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,aAAa,GACd,MAAM,iCAAiC,CAAC;AAMzC;;;;;GAKG;AACH,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAM9E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG"}