@signaltree/core 6.0.13 → 6.0.14

package/dist/index.js

@@ -1,6 +1,7 @@
 export { signalTree } from './lib/signal-tree.js';
 export { ENHANCER_META, entityMap } from './lib/types.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';
 export { SecurityPresets, SecurityValidator } from './lib/security/security-validator.js';
 export { createEnhancer, resolveEnhancerOrder } from './enhancers/index.js';

package/dist/lib/edit-session.js

@@ -0,0 +1,84 @@
+import { signal } from '@angular/core';
+import { deepEqual } from '../deep-equal.js';
+
+function clone(value) {
+  try {
+    return globalThis.structuredClone ? globalThis.structuredClone(value) : JSON.parse(JSON.stringify(value));
+  } catch {
+    return JSON.parse(JSON.stringify(value));
+  }
+}
+function createEditSession(initial) {
+  const original = signal(clone(initial));
+  const present = signal(clone(initial));
+  const pastCount = signal(0);
+  const futureCount = signal(0);
+  let past = [];
+  let future = [];
+  function updateCounts() {
+    pastCount.set(past.length);
+    futureCount.set(future.length);
+  }
+  const canUndo = () => pastCount() > 0;
+  const canRedo = () => futureCount() > 0;
+  const isDirty = () => !deepEqual(original(), present());
+  function setOriginal(value) {
+    const v = clone(value);
+    original.set(v);
+    present.set(clone(v));
+    past = [];
+    future = [];
+    updateCounts();
+  }
+  function applyChanges(valueOrUpdater) {
+    const current = present();
+    const next = typeof valueOrUpdater === 'function' ? valueOrUpdater(clone(current)) : valueOrUpdater;
+    if (deepEqual(current, next)) return;
+    past.push(clone(current));
+    present.set(clone(next));
+    future = [];
+    updateCounts();
+  }
+  function undo() {
+    if (past.length === 0) return;
+    const prev = past.pop();
+    future.push(clone(present()));
+    present.set(clone(prev));
+    updateCounts();
+  }
+  function redo() {
+    if (future.length === 0) return;
+    const next = future.pop();
+    past.push(clone(present()));
+    present.set(clone(next));
+    updateCounts();
+  }
+  function reset() {
+    present.set(clone(original()));
+    past = [];
+    future = [];
+    updateCounts();
+  }
+  function getHistory() {
+    return {
+      past: past.map(p => clone(p)),
+      present: clone(present()),
+      future: future.map(f => clone(f))
+    };
+  }
+  return {
+    original,
+    modified: present,
+    canUndo,
+    canRedo,
+    isDirty,
+    setOriginal,
+    applyChanges,
+    undo,
+    redo,
+    reset,
+    getHistory
+  };
+}
+
+export { createEditSession, createEditSession as default };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@signaltree/core",
-  "version": "6.0.13",
+  "version": "6.0.14",
   "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,

package/src/index.d.ts

@@ -2,6 +2,7 @@ export { signalTree } from './lib/signal-tree';
 export type { ISignalTree, SignalTree, SignalTreeBase, FullSignalTree, ProdSignalTree, TreeNode, CallableWritableSignal, AccessibleNode, NodeAccessor, Primitive, NotFn, TreeConfig, TreePreset, Enhancer, EnhancerMeta, EnhancerWithMeta, EntitySignal, EntityMapMarker, EntityConfig, MutationOptions, AddOptions, AddManyOptions, TimeTravelEntry, TimeTravelMethods, } from './lib/types';
 export { entityMap } from './lib/types';
 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';
 export { SecurityValidator, SecurityPresets, type SecurityEvent, type SecurityEventType, type SecurityValidatorConfig, } from './lib/security/security-validator';
 export { createEnhancer, resolveEnhancerOrder } from './enhancers/index';

package/src/lib/edit-session.d.ts

@@ -0,0 +1,21 @@
+import { WritableSignal } from '@angular/core';
+export type UndoRedoHistory<T> = {
+    past: T[];
+    present: T;
+    future: T[];
+};
+export interface EditSession<T> {
+    readonly original: WritableSignal<T>;
+    readonly modified: WritableSignal<T>;
+    readonly canUndo: () => boolean;
+    readonly canRedo: () => boolean;
+    readonly isDirty: () => boolean;
+    setOriginal(value: T): void;
+    applyChanges(valueOrUpdater: T | ((current: T) => T)): void;
+    undo(): void;
+    redo(): void;
+    reset(): void;
+    getHistory(): UndoRedoHistory<T>;
+}
+export declare function createEditSession<T>(initial: T): EditSession<T>;
+export default createEditSession;