@signaltree/core 9.6.0 → 10.1.0

package/dist/edit-session.js

@@ -1 +1 @@
-export { createEditSession } from './lib/edit-session.js';
+export { createEditSession, createTreeEditSession } from './lib/edit-session.js';

package/dist/lib/edit-session.js

@@ -80,5 +80,26 @@ function createEditSession(initial) {
     getHistory
   };
 }
+function createTreeEditSession(source) {
+  if (typeof source !== 'function' || typeof source.set !== 'function') {
+    throw new TypeError('createTreeEditSession: source must be a callable accessor with a .set() method ' + '(e.g. tree.$.user.profile or a WritableSignal).');
+  }
+  const initial = clone(source());
+  const base = createEditSession(initial);
+  return {
+    ...base,
+    commit() {
+      source.set(clone(base.modified()));
+    },
+    cancel() {
+      const current = clone(source());
+      base.setOriginal(current);
+    },
+    pullFromSource() {
+      const current = clone(source());
+      base.original.set(current);
+    }
+  };
+}
 
-export { createEditSession, createEditSession as default };
+export { createEditSession, createTreeEditSession, createEditSession as default };

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

@@ -18,15 +18,25 @@ function isRegisteredMarker(value) {
   return false;
 }
 function registerMarkerProcessor(check, create) {
+  if (typeof check !== 'function' || typeof create !== 'function') {
+    throw new TypeError("registerMarkerProcessor: both 'check' (type guard) and 'create' " + '(materializer) must be functions. Received check=' + typeof check + ', create=' + typeof create + '. ' + 'See https://signaltree.io/docs (custom markers section) for usage.');
+  }
   const alreadyRegistered = MARKER_PROCESSORS.some(p => p.check === check);
   if (alreadyRegistered) {
     return;
   }
+  if ((typeof ngDevMode === 'undefined' || ngDevMode) && treesConstructedCount > 0) {
+    console.warn('[SignalTree] registerMarkerProcessor() was called AFTER at least one ' + `signalTree() had already been constructed (${treesConstructedCount} trees so far). ` + 'Existing trees will NOT pick up this marker — only trees built after ' + 'this point will use it. To process your custom marker in existing ' + "trees, register it at module load time (before any signalTree() call), " + "or rebuild the tree after registration.");
+  }
   MARKER_PROCESSORS.push({
     check,
     create: create
   });
 }
+let treesConstructedCount = 0;
+function _recordTreeConstruction() {
+  treesConstructedCount += 1;
+}
 function materializeMarkers(node, notifier, path = []) {
   if (node == null) return;
   if (typeof node !== 'object' && typeof node !== 'function') return;
@@ -69,4 +79,4 @@ function materializeMarkers(node, notifier, path = []) {
   }
 }
 
-export { isRegisteredMarker, materializeMarkers, registerMarkerProcessor };
+export { _recordTreeConstruction, isRegisteredMarker, materializeMarkers, registerMarkerProcessor };

package/dist/lib/signal-tree.js

@@ -1,7 +1,7 @@
 import { signal, isSignal, untracked } from '@angular/core';
 import { SIGNAL_TREE_MESSAGES, SIGNAL_TREE_CONSTANTS } from './constants.js';
 import { batchScope } from './internals/batch-scope.js';
-import { isRegisteredMarker, materializeMarkers } from './internals/materialize-markers.js';
+import { isRegisteredMarker, materializeMarkers, _recordTreeConstruction } from './internals/materialize-markers.js';
 import { applyDerivedFactories } from './internals/merge-derived.js';
 import { isStatusMarker } from './markers/status.js';
 import { isStoredMarker } from './markers/stored.js';
@@ -387,6 +387,7 @@ function createBuilder(baseTree) {
     isFinalized = true;
     materializeMarkers(baseTree.$);
     materializeMarkers(baseTree.state);
+    _recordTreeConstruction();
     if (derivedQueue.length > 0) {
       applyDerivedFactories(baseTree.$, derivedQueue);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@signaltree/core",
-  "version": "9.6.0",
+  "version": "10.1.0",
   "description": "Reactive JSON for Angular. JSON branches, reactive leaves. No actions. No reducers. No selectors.",
   "license": "MIT",
   "type": "module",

package/src/edit-session.d.ts

@@ -1 +1 @@
-export { createEditSession, type EditSession, type UndoRedoHistory, } from './lib/edit-session';
+export { createEditSession, createTreeEditSession, type EditSession, type TreeEditSession, type TreeEditSource, type UndoRedoHistory, } from './lib/edit-session';

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

@@ -19,3 +19,14 @@ export interface EditSession<T> {
 }
 export declare function createEditSession<T>(initial: T): EditSession<T>;
 export default createEditSession;
+export interface TreeEditSource<T> {
+    (): T;
+    set(value: T): void;
+    update?(fn: (current: T) => T): void;
+}
+export interface TreeEditSession<T> extends EditSession<T> {
+    commit(): void;
+    cancel(): void;
+    pullFromSource(): void;
+}
+export declare function createTreeEditSession<T>(source: TreeEditSource<T>): TreeEditSession<T>;