@signaltree/core 6.4.0 → 7.0.1

package/LICENSE

@@ -0,0 +1,54 @@
+BUSINESS SOURCE LICENSE 1.1
+
+Copyright (c) 2025 Jonathan D Borgia
+
+This Business Source License 1.1 ("License") governs the use of the software and associated documentation files (the "Software"). You are granted a limited license to use the Software under the terms of this License.
+
+1. Definitions
+
+"Change Date" means the date on which the Change License set out in section 6 will apply to the Software. The Change Date for this release is 2028-09-05.
+
+"Change License" means the open source license that will apply to the Software on and after the Change Date. The Change License for this release is the MIT License.
+
+"Licensor" means the copyright owner granting rights under this License (Jonathan D Borgia).
+
+"You" ("Licensee") means an individual or legal entity exercising rights under this License who has not violated the terms of this License or had their rights terminated.
+
+2. License Grant
+
+Subject to the terms and conditions of this License, Licensor hereby grants You a non-exclusive, non-transferable, worldwide license to use, reproduce, display, perform, and distribute the Software, and to make modifications and derivative works for internal use, until the Change Date.
+
+3. Commercial Use
+
+You may use the Software in commercial applications, including for providing services, selling products that include the Software, or otherwise exploiting the Software commercially, subject to the other terms of this License.
+
+4. Limitations and Conditions
+
+a. You may not remove or alter this License, the copyright notice, or notices of the Change Date.
+
+b. You may not publicly offer a modified version of the Software that would directly compete with Licensor's public offering of the Software if doing so would circumvent the intent of this License.
+
+c. Except as expressly provided in this License, no rights are granted to You under any patent or trademark of Licensor.
+
+5. Disclaimer and Limitation of Liability
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. TO THE FULLEST EXTENT PERMITTED BY LAW, LICENSOR WILL NOT BE LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER LIABILITY ARISING FROM OR RELATING TO THE SOFTWARE.
+
+6. Change License
+
+On and after the Change Date specified above, the Software will be licensed under the Change License (MIT License) on the same terms and conditions as set forth by that Change License.
+
+7. Governing Law
+
+This License will be governed by and construed in accordance with the laws of the State of New York, USA, without regard to conflict of law principles.
+
+8. Accepting this License
+
+You accept this License by copying, modifying, or distributing the Software or any portion thereof.
+
+---
+
+LICENSE NOTE
+
+- Original license file replaced on 2025-09-05 to Business Source License 1.1. Change Date: 2028-09-05. Change License: MIT.
+  or standard modifications for your own applications.

package/dist/enhancers/entities/entities.js

@@ -1,38 +1,11 @@
-import { createEntitySignal } from '../../lib/entity-signal.js';
-import { getPathNotifier } from '../../lib/path-notifier.js';
-
-function isEntityMapMarker(value) {
-  return Boolean(value && typeof value === 'object' && value['__isEntityMap'] === true);
-}
 function entities(config = {}) {
+  if (typeof ngDevMode === 'undefined' || ngDevMode) {
+    console.warn('SignalTree: entities() enhancer is deprecated in v7. ' + 'EntityMap markers are now automatically processed. ' + 'Remove .with(entities()) from your code. ' + 'This enhancer will be removed in v8.');
+  }
   const {
     enabled = true
   } = config;
   return tree => {
-    if (!enabled) {
-      tree.__entitiesEnabled = true;
-      return tree;
-    }
-    const notifier = getPathNotifier();
-    function materialize(node, path = []) {
-      if (!node || typeof node !== 'object') return;
-      for (const [k, v] of Object.entries(node)) {
-        if (isEntityMapMarker(v)) {
-          const cfg = v.__entityMapConfig ?? {};
-          const sig = createEntitySignal(cfg, notifier, path.concat(k).join('.'));
-          try {
-            node[k] = sig;
-          } catch {}
-          try {
-            tree[k] = sig;
-          } catch {}
-        } else if (typeof v === 'object' && v !== null && !Array.isArray(v)) {
-          materialize(v, path.concat(k));
-        }
-      }
-    }
-    materialize(tree.state);
-    materialize(tree.$);
     tree.__entitiesEnabled = true;
     return tree;
   };

package/dist/index.js

@@ -1,6 +1,9 @@
 export { signalTree } from './lib/signal-tree.js';
 export { ENHANCER_META, entityMap } from './lib/types.js';
-export { derived, isDerivedMarker } from './lib/markers/derived.js';
+export { isDerivedMarker } from './lib/markers/derived.js';
+export { LoadingState, isStatusMarker, status } from './lib/markers/status.js';
+export { isStoredMarker, stored } from './lib/markers/stored.js';
+export { registerMarkerProcessor } from './lib/internals/materialize-markers.js';
 export { composeEnhancers, createLazySignalTree, isAnySignal, isNodeAccessor, toWritableSignal } from './lib/utils.js';
 export { createEditSession } from './lib/edit-session.js';
 export { getPathNotifier } from './lib/path-notifier.js';

package/dist/lib/internals/batch-scope.js

@@ -0,0 +1,8 @@
+function batchScope(fn) {
+  try {
+    fn();
+  } finally {
+  }
+}
+
+export { batchScope };

package/dist/lib/internals/materialize-markers.js

@@ -0,0 +1,66 @@
+import { isSignal } from '@angular/core';
+import { createEntitySignal } from '../entity-signal.js';
+import { createStatusSignal, isStatusMarker } from '../markers/status.js';
+import { createStoredSignal, isStoredMarker } from '../markers/stored.js';
+import { getPathNotifier } from '../path-notifier.js';
+import { isNodeAccessor } from '../utils.js';
+
+function isEntityMapMarker(value) {
+  return Boolean(value && typeof value === 'object' && value['__isEntityMap'] === true);
+}
+const MARKER_PROCESSORS = [];
+function registerMarkerProcessor(check, create) {
+  MARKER_PROCESSORS.push({
+    check,
+    create: create
+  });
+}
+registerMarkerProcessor(isEntityMapMarker, (marker, notifier, path) => {
+  const cfg = marker.__entityMapConfig ?? {};
+  return createEntitySignal(cfg, notifier, path);
+});
+registerMarkerProcessor(isStatusMarker, marker => createStatusSignal(marker));
+registerMarkerProcessor(isStoredMarker, marker => createStoredSignal(marker));
+function materializeMarkers(node, notifier, path = []) {
+  if (node == null) return;
+  if (typeof node !== 'object' && typeof node !== 'function') return;
+  if (isSignal(node)) return;
+  const isAccessor = typeof node === 'function' && isNodeAccessor(node);
+  if (typeof node === 'function' && !isAccessor) return;
+  const getNotifier = () => {
+    if (!notifier) {
+      notifier = getPathNotifier();
+    }
+    return notifier;
+  };
+  const keys = Object.keys(node);
+  for (const key of keys) {
+    const value = node[key];
+    const currentPath = [...path, key];
+    const pathString = currentPath.join('.');
+    let processed = false;
+    for (const processor of MARKER_PROCESSORS) {
+      if (processor.check(value)) {
+        try {
+          const materialized = processor.create(value, getNotifier(), pathString);
+          node[key] = materialized;
+          processed = true;
+        } catch (err) {
+          if (typeof ngDevMode === 'undefined' || ngDevMode) {
+            console.error(`SignalTree: Failed to materialize marker at "${pathString}"`, err);
+          }
+        }
+        break;
+      }
+    }
+    if (!processed && value != null) {
+      if (isNodeAccessor(value)) {
+        materializeMarkers(value, notifier, currentPath);
+      } else if (typeof value === 'object' && !Array.isArray(value) && !isSignal(value)) {
+        materializeMarkers(value, notifier, currentPath);
+      }
+    }
+  }
+}
+
+export { materializeMarkers, registerMarkerProcessor };

package/dist/lib/markers/derived.js

@@ -1,12 +1,6 @@
 const DERIVED_MARKER = Symbol.for('signaltree:derived');
-function derived(factory) {
-  return {
-    [DERIVED_MARKER]: true,
-    factory
-  };
-}
 function isDerivedMarker(value) {
   return value !== null && typeof value === 'object' && DERIVED_MARKER in value && value[DERIVED_MARKER] === true;
 }
 
-export { derived, isDerivedMarker };
+export { isDerivedMarker };

package/dist/lib/markers/status.js

@@ -0,0 +1,65 @@
+import { signal, computed } from '@angular/core';
+
+const STATUS_MARKER = Symbol('STATUS_MARKER');
+var LoadingState;
+(function (LoadingState) {
+  LoadingState["NotLoaded"] = "NOT_LOADED";
+  LoadingState["Loading"] = "LOADING";
+  LoadingState["Loaded"] = "LOADED";
+  LoadingState["Error"] = "ERROR";
+})(LoadingState || (LoadingState = {}));
+function status(initialState = LoadingState.NotLoaded) {
+  return {
+    [STATUS_MARKER]: true,
+    initialState
+  };
+}
+function isStatusMarker(value) {
+  return value !== null && typeof value === 'object' && STATUS_MARKER in value && value[STATUS_MARKER] === true;
+}
+function createStatusSignal(marker) {
+  const stateSignal = signal(marker.initialState);
+  const errorSignal = signal(null);
+  let _isNotLoaded = null;
+  let _isLoading = null;
+  let _isLoaded = null;
+  let _isError = null;
+  return {
+    state: stateSignal,
+    error: errorSignal,
+    get isNotLoaded() {
+      return _isNotLoaded ??= computed(() => stateSignal() === LoadingState.NotLoaded);
+    },
+    get isLoading() {
+      return _isLoading ??= computed(() => stateSignal() === LoadingState.Loading);
+    },
+    get isLoaded() {
+      return _isLoaded ??= computed(() => stateSignal() === LoadingState.Loaded);
+    },
+    get isError() {
+      return _isError ??= computed(() => stateSignal() === LoadingState.Error);
+    },
+    setNotLoaded() {
+      stateSignal.set(LoadingState.NotLoaded);
+      errorSignal.set(null);
+    },
+    setLoading() {
+      stateSignal.set(LoadingState.Loading);
+      errorSignal.set(null);
+    },
+    setLoaded() {
+      stateSignal.set(LoadingState.Loaded);
+      errorSignal.set(null);
+    },
+    setError(err) {
+      stateSignal.set(LoadingState.Error);
+      errorSignal.set(err);
+    },
+    reset() {
+      stateSignal.set(LoadingState.NotLoaded);
+      errorSignal.set(null);
+    }
+  };
+}
+
+export { LoadingState, STATUS_MARKER, createStatusSignal, isStatusMarker, status };

package/dist/lib/markers/stored.js

@@ -0,0 +1,105 @@
+import { signal } from '@angular/core';
+
+const STORED_MARKER = Symbol('STORED_MARKER');
+function stored(key, defaultValue, options = {}) {
+  return {
+    [STORED_MARKER]: true,
+    key,
+    defaultValue,
+    options
+  };
+}
+function isStoredMarker(value) {
+  return value !== null && typeof value === 'object' && STORED_MARKER in value && value[STORED_MARKER] === true;
+}
+function createStoredSignal(marker) {
+  const {
+    key,
+    defaultValue,
+    options: {
+      serialize = JSON.stringify,
+      deserialize = JSON.parse,
+      debounceMs = 100
+    }
+  } = marker;
+  const storage = marker.options.storage !== undefined ? marker.options.storage : typeof localStorage !== 'undefined' ? localStorage : null;
+  let initialValue = defaultValue;
+  if (storage) {
+    try {
+      const storedValue = storage.getItem(key);
+      if (storedValue !== null) {
+        initialValue = deserialize(storedValue);
+      }
+    } catch (e) {
+      if (typeof ngDevMode === 'undefined' || ngDevMode) {
+        console.warn(`SignalTree: Failed to read "${key}" from storage`, e);
+      }
+    }
+  }
+  const sig = signal(initialValue);
+  let pendingWrite = null;
+  let pendingValue;
+  const saveToStorage = value => {
+    if (!storage) return;
+    if (debounceMs === 0) {
+      queueMicrotask(() => {
+        try {
+          storage.setItem(key, serialize(value));
+        } catch (e) {
+          if (typeof ngDevMode === 'undefined' || ngDevMode) {
+            console.warn(`SignalTree: Failed to save "${key}" to storage`, e);
+          }
+        }
+      });
+      return;
+    }
+    pendingValue = value;
+    if (pendingWrite !== null) {
+      clearTimeout(pendingWrite);
+    }
+    pendingWrite = setTimeout(() => {
+      pendingWrite = null;
+      queueMicrotask(() => {
+        try {
+          storage.setItem(key, serialize(pendingValue));
+        } catch (e) {
+          if (typeof ngDevMode === 'undefined' || ngDevMode) {
+            console.warn(`SignalTree: Failed to save "${key}" to storage`, e);
+          }
+        }
+      });
+    }, debounceMs);
+  };
+  const storedSignal = () => sig();
+  storedSignal.set = value => {
+    sig.set(value);
+    saveToStorage(value);
+  };
+  storedSignal.update = fn => {
+    const newValue = fn(sig());
+    sig.set(newValue);
+    saveToStorage(newValue);
+  };
+  storedSignal.clear = () => {
+    sig.set(defaultValue);
+    if (storage) {
+      storage.removeItem(key);
+    }
+  };
+  storedSignal.reload = () => {
+    if (!storage) return;
+    try {
+      const storedValue = storage.getItem(key);
+      if (storedValue !== null) {
+        sig.set(deserialize(storedValue));
+      } else {
+        sig.set(defaultValue);
+      }
+    } catch {
+      sig.set(defaultValue);
+    }
+  };
+  return storedSignal;
+}
+
+export { STORED_MARKER, createStoredSignal, isStoredMarker, stored };

package/dist/lib/signal-tree.js

@@ -1,6 +1,10 @@
 import { signal, isSignal } from '@angular/core';
 import { SIGNAL_TREE_MESSAGES, SIGNAL_TREE_CONSTANTS } from './constants.js';
+import { batchScope } from './internals/batch-scope.js';
+import { materializeMarkers } from './internals/materialize-markers.js';
 import { applyDerivedFactories } from './internals/merge-derived.js';
+import { isStatusMarker } from './markers/status.js';
+import { isStoredMarker } from './markers/stored.js';
 import { SignalMemoryManager } from './memory/memory-manager.js';
 import { getPathNotifier } from './path-notifier.js';
 import { SecurityValidator } from './security/security-validator.js';
@@ -89,16 +93,21 @@ function makeNodeAccessor(store) {
     if (typeof arg === 'function') {
       const updater = arg;
       const current = unwrap(store);
-      recursiveUpdate(store, updater(current));
-    } else {
-      recursiveUpdate(store, arg);
+      batchScope(() => recursiveUpdate(store, updater(current)));
+      return;
+    }
+    if (typeof arg === 'object' && arg !== null && !Array.isArray(arg)) {
+      batchScope(() => recursiveUpdate(store, arg));
+      return;
     }
+    recursiveUpdate(store, arg);
   };
   accessor[NODE_ACCESSOR_SYMBOL] = true;
   for (const key of Object.keys(store)) {
     Object.defineProperty(accessor, key, {
       value: store[key],
       enumerable: true,
+      writable: true,
       configurable: true
     });
   }
@@ -143,6 +152,14 @@ function createSignalStore(obj, equalityFn) {
       store[key] = value;
       continue;
     }
+    if (isStatusMarker(value)) {
+      store[key] = value;
+      continue;
+    }
+    if (isStoredMarker(value)) {
+      store[key] = value;
+      continue;
+    }
     if (isSignal(value)) {
       store[key] = value;
       continue;
@@ -292,6 +309,8 @@ function createBuilder(baseTree) {
   const finalize = () => {
     if (isFinalized) return;
     isFinalized = true;
+    materializeMarkers(baseTree.$);
+    materializeMarkers(baseTree.state);
     if (derivedQueue.length > 0) {
       applyDerivedFactories(baseTree.$, derivedQueue);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@signaltree/core",
-  "version": "6.4.0",
+  "version": "7.0.1",
   "description": "Lightweight, type-safe signal-based state management for Angular. Core package providing hierarchical signal trees, basic entity management, and async actions.",
   "type": "module",
   "sideEffects": false,
@@ -89,4 +89,4 @@
     "src/**/*.d.ts",
     "README.md"
   ]
-}
+}

package/src/index.d.ts

@@ -3,7 +3,10 @@ export type { ISignalTree, SignalTree, SignalTreeBase, FullSignalTree, ProdSigna
 export { entityMap } from './lib/types';
 export type { ProcessDerived, DeepMergeTree, DerivedFactory, } from './lib/internals/derived-types';
 export type { SignalTreeBuilder } from './lib/internals/builder-types';
-export { derived, isDerivedMarker, type DerivedMarker, type DerivedType, } from './lib/markers/derived';
+export { isDerivedMarker, type DerivedMarker, type DerivedType, } from './lib/markers/derived';
+export { status, isStatusMarker, LoadingState, type StatusMarker, type StatusSignal, type StatusConfig, } from './lib/markers/status';
+export { stored, isStoredMarker, type StoredMarker, type StoredSignal, type StoredOptions, } from './lib/markers/stored';
+export { registerMarkerProcessor } from './lib/internals/materialize-markers';
 export { equal, deepEqual, isNodeAccessor, isAnySignal, toWritableSignal, parsePath, composeEnhancers, isBuiltInObject, createLazySignalTree, } from './lib/utils';
 export { createEditSession, type EditSession, type UndoRedoHistory, } from './lib/edit-session';
 export { getPathNotifier } from './lib/path-notifier';

package/src/lib/internals/batch-scope.d.ts

@@ -0,0 +1,3 @@
+export declare function batchScope(fn: () => void): void;
+export declare function isInBatchScope(): boolean;
+export declare function getBatchDepth(): number;

package/src/lib/internals/builder-types.d.ts

@@ -2,7 +2,7 @@ import type { ProcessDerived } from './derived-types';
 import type { ISignalTree, TreeNode } from '../types';
 export interface SignalTreeBuilder<TSource, TAccum = TreeNode<TSource>> {
     (): TSource;
-    (value: TSource): void;
+    (value: Partial<TSource>): void;
     (updater: (current: TSource) => TSource): void;
     readonly $: TAccum;
     readonly state: TAccum;

package/src/lib/internals/materialize-markers.d.ts

@@ -0,0 +1,4 @@
+import { PathNotifier } from '../path-notifier';
+export declare function registerMarkerProcessor<T, R>(check: (value: unknown) => value is T, create: (marker: T, notifier: PathNotifier, path: string) => R): void;
+export declare function materializeMarkers(node: unknown, notifier?: PathNotifier, path?: string[]): void;
+export declare function hasMarkers(node: unknown, visited?: WeakSet<object>): boolean;

package/src/lib/markers/derived.d.ts

@@ -5,6 +5,5 @@ export interface DerivedMarker<T> {
     readonly __type?: T;
 }
 export type DerivedType<T> = T extends DerivedMarker<infer R> ? R : never;
-export declare function derived<T>(factory: () => T): DerivedMarker<T>;
 export declare function isDerivedMarker(value: unknown): value is DerivedMarker<unknown>;
 export {};

package/src/lib/markers/index.d.ts

@@ -1 +1,3 @@
-export { derived, isDerivedMarker, getDerivedMarkerSymbol, type DerivedMarker, type DerivedType, } from './derived';
+export { isDerivedMarker, getDerivedMarkerSymbol, type DerivedMarker, type DerivedType, } from './derived';
+export { status, isStatusMarker, createStatusSignal, LoadingState, STATUS_MARKER, type StatusMarker, type StatusSignal, type StatusConfig, } from './status';
+export { stored, isStoredMarker, createStoredSignal, STORED_MARKER, type StoredMarker, type StoredSignal, type StoredOptions, } from './stored';

package/src/lib/markers/status.d.ts

@@ -0,0 +1,31 @@
+import { Signal, WritableSignal } from '@angular/core';
+export declare const STATUS_MARKER: unique symbol;
+export declare enum LoadingState {
+    NotLoaded = "NOT_LOADED",
+    Loading = "LOADING",
+    Loaded = "LOADED",
+    Error = "ERROR"
+}
+export interface StatusConfig {
+    initialState?: LoadingState;
+}
+export interface StatusMarker {
+    [STATUS_MARKER]: true;
+    initialState: LoadingState;
+}
+export interface StatusSignal {
+    state: WritableSignal<LoadingState>;
+    error: WritableSignal<Error | null>;
+    isNotLoaded: Signal<boolean>;
+    isLoading: Signal<boolean>;
+    isLoaded: Signal<boolean>;
+    isError: Signal<boolean>;
+    setNotLoaded(): void;
+    setLoading(): void;
+    setLoaded(): void;
+    setError(error: Error): void;
+    reset(): void;
+}
+export declare function status(initialState?: LoadingState): StatusMarker;
+export declare function isStatusMarker(value: unknown): value is StatusMarker;
+export declare function createStatusSignal(marker: StatusMarker): StatusSignal;

package/src/lib/markers/stored.d.ts

@@ -0,0 +1,23 @@
+export declare const STORED_MARKER: unique symbol;
+export interface StoredOptions<T> {
+    serialize?: (value: T) => string;
+    deserialize?: (stored: string) => T;
+    storage?: Storage | null;
+    debounceMs?: number;
+}
+export interface StoredMarker<T> {
+    [STORED_MARKER]: true;
+    key: string;
+    defaultValue: T;
+    options: StoredOptions<T>;
+}
+export interface StoredSignal<T> {
+    (): T;
+    set(value: T): void;
+    update(fn: (current: T) => T): void;
+    clear(): void;
+    reload(): void;
+}
+export declare function stored<T>(key: string, defaultValue: T, options?: StoredOptions<T>): StoredMarker<T>;
+export declare function isStoredMarker(value: unknown): value is StoredMarker<unknown>;
+export declare function createStoredSignal<T>(marker: StoredMarker<T>): StoredSignal<T>;

package/src/lib/path-notifier.d.ts

@@ -2,3 +2,33 @@ export type PathNotifierInterceptor = (value: unknown, prev: unknown, path: stri
     block?: boolean;
     transform?: unknown;
 };
+export declare class PathNotifier {
+    private subscribers;
+    private interceptors;
+    private batchingEnabled;
+    private pendingFlush;
+    private pending;
+    private firstValues;
+    private flushCallbacks;
+    constructor(options?: {
+        batching?: boolean;
+    });
+    setBatchingEnabled(enabled: boolean): void;
+    isBatchingEnabled(): boolean;
+    subscribe(pattern: string, handler: PathNotifierHandler): () => void;
+    intercept(pattern: string, interceptor: PathNotifierInterceptor): () => void;
+    notify(path: string, value: unknown, prev: unknown): {
+        blocked: boolean;
+        value: unknown;
+    };
+    private _runNotify;
+    private flush;
+    flushSync(): void;
+    onFlush(callback: () => void): () => void;
+    hasPending(): boolean;
+    private matches;
+    clear(): void;
+    getSubscriberCount(): number;
+    getInterceptorCount(): number;
+}
+export declare function getPathNotifier(): PathNotifier;

package/src/lib/types.d.ts

@@ -1,4 +1,6 @@
 import { Signal, WritableSignal } from '@angular/core';
+import { StatusMarker, StatusSignal } from './markers/status';
+import { StoredMarker, StoredSignal } from './markers/stored';
 import { SecurityValidatorConfig } from './security/security-validator';
 export interface TimeTravelConfig {
     enabled?: boolean;
@@ -28,11 +30,11 @@ declare module '@angular/core' {
 }
 export interface NodeAccessor<T> {
     (): T;
-    (value: T): void;
+    (value: Partial<T>): void;
     (updater: (current: T) => T): void;
 }
 export type TreeNode<T> = {
-    [K in keyof T]: T[K] extends EntityMapMarker<infer E, infer Key> ? EntitySignal<E, Key> : T[K] extends Primitive ? CallableWritableSignal<T[K]> : T[K] extends readonly unknown[] ? CallableWritableSignal<T[K]> : T[K] extends Date | RegExp | Map<any, any> | Set<any> | Error | ((...args: unknown[]) => unknown) ? CallableWritableSignal<T[K]> : T[K] extends object ? NodeAccessor<T[K]> & TreeNode<T[K]> : CallableWritableSignal<T[K]>;
+    [K in keyof T]: T[K] extends EntityMapMarker<infer E, infer Key> ? EntitySignal<E, Key> : T[K] extends StatusMarker ? StatusSignal : T[K] extends StoredMarker<infer V> ? StoredSignal<V> : T[K] extends Primitive ? CallableWritableSignal<T[K]> : T[K] extends readonly unknown[] ? CallableWritableSignal<T[K]> : T[K] extends Date | RegExp | Map<any, any> | Set<any> | Error | ((...args: unknown[]) => unknown) ? CallableWritableSignal<T[K]> : T[K] extends object ? NodeAccessor<T[K]> & TreeNode<T[K]> : CallableWritableSignal<T[K]>;
 };
 export interface ISignalTree<T> extends NodeAccessor<T> {
     readonly state: TreeNode<T>;

package/src/lib/utils.d.ts

@@ -1,5 +1,4 @@
-import { Signal, WritableSignal } from '@angular/core';
-import { deepEqual, isBuiltInObject, parsePath } from '@signaltree/shared';
+import { WritableSignal } from '@angular/core';
 export { deepEqual };
 export { deepEqual as equal };
 export { isBuiltInObject };
@@ -10,14 +9,23 @@ export interface MemoryManager {
     cacheSignal(path: string, signal: WritableSignal<unknown>): void;
     dispose(): void;
 }
-export interface NodeAccessor<T> {
-    (): T;
-    (value: T): void;
-    (updater: (current: T) => T): void;
+import type { NodeAccessor, TreeNode } from './types';
+
+// Inlined from @signaltree/shared (internal package)
+declare function deepEqual<T>(a: T, b: T): boolean;
+declare function deepClone<T>(obj: T): T;
+declare function isBuiltInObject(value: unknown): boolean;
+declare function parsePath(path: string): string[];
+declare class LRUCache<K, V> {
+  constructor(maxSize: number);
+  get(key: K): V | undefined;
+  set(key: K, value: V): void;
+  has(key: K): boolean;
+  delete(key: K): boolean;
+  clear(): void;
+  get size(): number;
 }
-export type TreeNode<T> = {
-    [K in keyof T]: T[K] extends readonly unknown[] ? WritableSignal<T[K]> : T[K] extends object ? T[K] extends Signal<unknown> ? T[K] : T[K] extends (...args: unknown[]) => unknown ? WritableSignal<T[K]> : NodeAccessor<T[K]> : WritableSignal<T[K]>;
-};
+declare const DEFAULT_PATH_CACHE_SIZE: number;
 export declare function isNodeAccessor(value: unknown): value is NodeAccessor<unknown>;
 export declare function isAnySignal(value: unknown): boolean;
 export declare function toWritableSignal<T>(node: NodeAccessor<T>, injector?: unknown): WritableSignal<T>;