@katn30/trakr 1.1.1 → 2.1.0

package/dist/prod/index.cjs

@@ -27,6 +27,7 @@ __export(index_exports, {
   TrackedCollectionChanged: () => TrackedCollectionChanged,
   TrackedObject: () => TrackedObject,
   Tracker: () => Tracker,
+  TrackerSession: () => TrackerSession,
   TypedEvent: () => TypedEvent
 });
 module.exports = __toCommonJS(index_exports);
@@ -249,6 +250,242 @@ function validateSingleProperty(tracked, property) {
   return error;
 }
 
+// src/OperationProperties.ts
+var OperationProperties = class {
+  constructor(trackedObject, property, type, validator, coalesceWithin) {
+    this.trackedObject = trackedObject;
+    this.property = property;
+    this.type = type;
+    this.validator = validator;
+    this.coalesceWithin = coalesceWithin;
+  }
+};
+
+// src/ExternallyAssigned.ts
+var AUTO_ID = /* @__PURE__ */ Symbol("autoId");
+function AutoId(_target, context) {
+  context.addInitializer(function() {
+    Object.defineProperty(Object.getPrototypeOf(this), AUTO_ID, {
+      value: String(context.name),
+      configurable: true
+    });
+  });
+}
+function getAutoIdProperty(proto) {
+  return AUTO_ID in proto ? proto[AUTO_ID] : void 0;
+}
+
+// src/TrackedObjectStateMachine.ts
+function applyStateTransition(obj, event, direction, context) {
+  if (event === "added") {
+    applyAdded(obj, direction);
+  } else if (event === "removed") {
+    applyRemoved(obj, direction, context);
+  } else {
+    applyCommitted(obj, direction, context);
+  }
+}
+function applyAdded(obj, direction) {
+  if (direction === "undo") {
+    obj._setState("Unchanged" /* Unchanged */);
+  } else {
+    obj._setState("Insert" /* Insert */);
+  }
+}
+function applyRemoved(obj, direction, context) {
+  if (direction === "undo") {
+    const prev = context?.prevState ?? "Unchanged" /* Unchanged */;
+    obj._setState(prev);
+    if (prev === "Insert" /* Insert */) {
+      if (context?.prevDirtyCounter !== void 0) {
+        obj._setDirtyCounter(context.prevDirtyCounter);
+      }
+    }
+  } else {
+    if (obj.state === "Insert" /* Insert */) {
+      obj._setState("Unchanged" /* Unchanged */);
+      obj._setDirtyCounter(0);
+    } else {
+      obj._setState("Deleted" /* Deleted */);
+    }
+  }
+}
+function applyCommitted(obj, direction, context) {
+  if (direction === "undo") {
+    const prev = context?.prevState ?? "Unchanged" /* Unchanged */;
+    if (prev === "Insert" /* Insert */) {
+      obj._setState("Deleted" /* Deleted */);
+    } else if (prev === "Deleted" /* Deleted */) {
+      obj._setState("Insert" /* Insert */);
+    } else if (prev === "Changed" /* Changed */) {
+      obj._setState("Changed" /* Changed */);
+    }
+  } else {
+    if ((context?.prevState === "Insert" /* Insert */ || context?.prevState === "Changed" /* Changed */) && context.autoIdProp && context.realId !== void 0) {
+      obj[context.autoIdProp] = context.realId;
+    }
+    obj._setState("Unchanged" /* Unchanged */);
+    obj._setDirtyCounter(0);
+  }
+}
+function buildCommittedContext(obj, autoIdProp, keys) {
+  const prevState = obj.state;
+  let realId;
+  if ((prevState === "Insert" /* Insert */ || prevState === "Changed" /* Changed */) && keys) {
+    realId = keys.find((k) => k.trackingId === obj.trackingId)?.value;
+  }
+  return { prevState, autoIdProp, realId };
+}
+
+// src/TrackedObject.ts
+var TrackedObject = class {
+  constructor(tracker) {
+    this.tracker = tracker;
+    this._dirtyCounter = 0;
+    this._isValid = true;
+    this._state = "Unchanged" /* Unchanged */;
+    this.changed = new TypedEvent();
+    this.trackedChanged = new TypedEvent();
+    if (false) {
+      throw new Error(`${this.constructor.name} must be created inside tracker.construct()`);
+    }
+    this.trackingId = tracker._nextTrackingId();
+    this.validationMessages = /* @__PURE__ */ new Map();
+    tracker._trackObject(this);
+  }
+  // ---- StateTarget interface (internal) ----
+  /** @internal */
+  get state() {
+    return this._state;
+  }
+  /** @internal */
+  _setState(value) {
+    this._state = value;
+  }
+  /** @internal */
+  _getDirtyCounter() {
+    return this._dirtyCounter;
+  }
+  /** @internal */
+  _setDirtyCounter(value) {
+    this._dirtyCounter = value;
+  }
+  // ---- Public API ----
+  get validationMessages() {
+    return this._validationMessages ?? /* @__PURE__ */ new Map();
+  }
+  set validationMessages(value) {
+    this._validationMessages = value;
+  }
+  get isValid() {
+    return this._isValid;
+  }
+  set isValid(value) {
+    const wasValid = this._isValid;
+    this._isValid = value;
+    if (wasValid !== value) {
+      this.tracker._onValidityChanged(wasValid, value);
+    }
+  }
+  get isDirty() {
+    return this._dirtyCounter !== 0;
+  }
+  get dirtyCounter() {
+    return this._dirtyCounter;
+  }
+  set dirtyCounter(value) {
+    this._dirtyCounter = value;
+  }
+  /** @internal */
+  _onCommitted(lastOp, keys) {
+    const autoIdProp = getAutoIdProperty(Object.getPrototypeOf(this));
+    const context = buildCommittedContext(this, autoIdProp, keys);
+    const redoFn = () => applyStateTransition(this, "committed", "do", context);
+    const undoFn = () => applyStateTransition(this, "committed", "undo", context);
+    if (lastOp) {
+      lastOp.updateOrAdd(redoFn, undoFn, new OperationProperties(this, "__state__", 4 /* Object */));
+    }
+    redoFn();
+  }
+  /** @internal */
+  _markRemoved() {
+    const prevState = this._state;
+    const prevDirtyCounter = this._dirtyCounter;
+    this.tracker._doAndTrack(
+      () => applyStateTransition(this, "removed", "do"),
+      () => applyStateTransition(this, "removed", "undo", { prevState, prevDirtyCounter }),
+      new OperationProperties(this, "__state__", 4 /* Object */)
+    );
+  }
+  /** @internal */
+  _markAdded() {
+    if (this._state !== "Unchanged" /* Unchanged */) return;
+    if (this.tracker._isTrackingSuppressed) return;
+    this.tracker._doAndTrack(
+      () => applyStateTransition(this, "added", "do"),
+      () => applyStateTransition(this, "added", "undo"),
+      new OperationProperties(this, "__state__", 4 /* Object */)
+    );
+  }
+  /** @internal */
+  _validate(property, errorMessage) {
+    if (errorMessage) {
+      this.validationMessages.set(property, errorMessage);
+    } else {
+      this.validationMessages.delete(property);
+    }
+    this.validationMessages = new Map(this.validationMessages);
+    this.isValid = this.validationMessages.size === 0;
+  }
+  /** @internal */
+  _applyValidation(messages) {
+    this.validationMessages = messages;
+    this.isValid = messages.size === 0;
+  }
+  destroy() {
+    DependencyTracker.clearDeps(this);
+    this.tracker._untrackObject(this);
+  }
+};
+
+// src/TrackerSession.ts
+var TrackerSession = class {
+  constructor(scope, _end, _rollback) {
+    this._end = _end;
+    this._rollback = _rollback;
+    this._isDirty = false;
+    if (scope && scope.length > 0) {
+      this._scope = new Map(scope.map(([obj, props]) => [obj, new Set(props)]));
+    }
+  }
+  /** @internal */
+  _onWrite(obj, property) {
+    if (this._scope === void 0) return;
+    const declaredProps = this._scope.get(obj);
+    if (declaredProps === void 0 || !declaredProps.has(property)) return;
+    this._isDirty = true;
+  }
+  get isDirty() {
+    if (this._scope === void 0) return void 0;
+    return this._isDirty;
+  }
+  get isValid() {
+    if (this._scope === void 0) return void 0;
+    for (const [obj, props] of this._scope) {
+      for (const prop of props) {
+        if (obj.validationMessages.has(prop)) return false;
+      }
+    }
+    return true;
+  }
+  end() {
+    this._end();
+  }
+  rollback() {
+    this._rollback();
+  }
+};
+
 // src/Tracker.ts
 var Tracker = class {
   constructor() {
@@ -422,6 +659,9 @@ var Tracker = class {
       properties
     );
     redoAction();
+    if (this._currentSession !== void 0 && properties.property !== void 0 && properties.trackedObject instanceof TrackedObject) {
+      this._currentSession._onWrite(properties.trackedObject, properties.property);
+    }
     if (this.isEndingCurrentOperation(properties)) {
       this._currentOperation = void 0;
       this._currentOperationOwner = void 0;
@@ -484,13 +724,20 @@ var Tracker = class {
     this.canRedo = this._redoOperations.length > 0;
     this.isDirty = CollectionUtilities.getLast(this._undoOperations) !== this._commitStateOperation;
   }
-  startComposing() {
-    if (this._composingBaseIndex !== void 0) return;
+  startSession(scope) {
+    if (this._currentSession !== void 0) return this._currentSession;
     this._composingBaseIndex = this._undoOperations.length;
     this._composingRedoLength = this._redoOperations.length;
+    this._currentSession = new TrackerSession(
+      scope,
+      () => this.endComposing(),
+      () => this.rollbackComposing()
+    );
+    return this._currentSession;
   }
   endComposing() {
     if (this._composingBaseIndex === void 0) return;
+    this._currentSession = void 0;
     const composed = this._undoOperations.splice(this._composingBaseIndex);
     this._redoOperations.splice(this._composingRedoLength);
     this._composingBaseIndex = void 0;
@@ -515,6 +762,7 @@ var Tracker = class {
   }
   rollbackComposing() {
     if (this._composingBaseIndex === void 0) return;
+    this._currentSession = void 0;
     const toRevert = this._undoOperations.splice(this._composingBaseIndex);
     this._redoOperations.splice(this._composingRedoLength);
     this._composingBaseIndex = void 0;
@@ -566,204 +814,6 @@ var Tracker = class {
   }
 };
 
-// src/OperationProperties.ts
-var OperationProperties = class {
-  constructor(trackedObject, property, type, validator, coalesceWithin) {
-    this.trackedObject = trackedObject;
-    this.property = property;
-    this.type = type;
-    this.validator = validator;
-    this.coalesceWithin = coalesceWithin;
-  }
-};
-
-// src/ExternallyAssigned.ts
-var AUTO_ID = /* @__PURE__ */ Symbol("autoId");
-function AutoId(_target, context) {
-  context.addInitializer(function() {
-    Object.defineProperty(Object.getPrototypeOf(this), AUTO_ID, {
-      value: String(context.name),
-      configurable: true
-    });
-  });
-}
-function getAutoIdProperty(proto) {
-  return AUTO_ID in proto ? proto[AUTO_ID] : void 0;
-}
-
-// src/TrackedObjectStateMachine.ts
-function applyStateTransition(obj, event, direction, context) {
-  if (event === "added") {
-    applyAdded(obj, direction);
-  } else if (event === "removed") {
-    applyRemoved(obj, direction, context);
-  } else {
-    applyCommitted(obj, direction, context);
-  }
-}
-function applyAdded(obj, direction) {
-  if (direction === "undo") {
-    obj._setState("Unchanged" /* Unchanged */);
-  } else {
-    obj._setState("Insert" /* Insert */);
-  }
-}
-function applyRemoved(obj, direction, context) {
-  if (direction === "undo") {
-    const prev = context?.prevState ?? "Unchanged" /* Unchanged */;
-    obj._setState(prev);
-    if (prev === "Insert" /* Insert */) {
-      if (context?.prevDirtyCounter !== void 0) {
-        obj._setDirtyCounter(context.prevDirtyCounter);
-      }
-    }
-  } else {
-    if (obj.state === "Insert" /* Insert */) {
-      obj._setState("Unchanged" /* Unchanged */);
-      obj._setDirtyCounter(0);
-    } else {
-      obj._setState("Deleted" /* Deleted */);
-    }
-  }
-}
-function applyCommitted(obj, direction, context) {
-  if (direction === "undo") {
-    const prev = context?.prevState ?? "Unchanged" /* Unchanged */;
-    if (prev === "Insert" /* Insert */) {
-      obj._setState("Deleted" /* Deleted */);
-    } else if (prev === "Deleted" /* Deleted */) {
-      obj._setState("Insert" /* Insert */);
-    } else if (prev === "Changed" /* Changed */) {
-      obj._setState("Changed" /* Changed */);
-    }
-  } else {
-    if ((context?.prevState === "Insert" /* Insert */ || context?.prevState === "Changed" /* Changed */) && context.autoIdProp && context.realId !== void 0) {
-      obj[context.autoIdProp] = context.realId;
-    }
-    obj._setState("Unchanged" /* Unchanged */);
-    obj._setDirtyCounter(0);
-  }
-}
-function buildCommittedContext(obj, autoIdProp, keys) {
-  const prevState = obj.state;
-  let realId;
-  if ((prevState === "Insert" /* Insert */ || prevState === "Changed" /* Changed */) && keys) {
-    realId = keys.find((k) => k.trackingId === obj.trackingId)?.value;
-  }
-  return { prevState, autoIdProp, realId };
-}
-
-// src/TrackedObject.ts
-var TrackedObject = class {
-  constructor(tracker) {
-    this.tracker = tracker;
-    this._dirtyCounter = 0;
-    this._isValid = true;
-    this._state = "Unchanged" /* Unchanged */;
-    this.changed = new TypedEvent();
-    this.trackedChanged = new TypedEvent();
-    if (false) {
-      throw new Error(`${this.constructor.name} must be created inside tracker.construct()`);
-    }
-    this.trackingId = tracker._nextTrackingId();
-    this.validationMessages = /* @__PURE__ */ new Map();
-    tracker._trackObject(this);
-  }
-  // ---- StateTarget interface (internal) ----
-  /** @internal */
-  get state() {
-    return this._state;
-  }
-  /** @internal */
-  _setState(value) {
-    this._state = value;
-  }
-  /** @internal */
-  _getDirtyCounter() {
-    return this._dirtyCounter;
-  }
-  /** @internal */
-  _setDirtyCounter(value) {
-    this._dirtyCounter = value;
-  }
-  // ---- Public API ----
-  get validationMessages() {
-    return this._validationMessages ?? /* @__PURE__ */ new Map();
-  }
-  set validationMessages(value) {
-    this._validationMessages = value;
-  }
-  get isValid() {
-    return this._isValid;
-  }
-  set isValid(value) {
-    const wasValid = this._isValid;
-    this._isValid = value;
-    if (wasValid !== value) {
-      this.tracker._onValidityChanged(wasValid, value);
-    }
-  }
-  get isDirty() {
-    return this._dirtyCounter !== 0;
-  }
-  get dirtyCounter() {
-    return this._dirtyCounter;
-  }
-  set dirtyCounter(value) {
-    this._dirtyCounter = value;
-  }
-  /** @internal */
-  _onCommitted(lastOp, keys) {
-    const autoIdProp = getAutoIdProperty(Object.getPrototypeOf(this));
-    const context = buildCommittedContext(this, autoIdProp, keys);
-    const redoFn = () => applyStateTransition(this, "committed", "do", context);
-    const undoFn = () => applyStateTransition(this, "committed", "undo", context);
-    if (lastOp) {
-      lastOp.updateOrAdd(redoFn, undoFn, new OperationProperties(this, "__state__", 4 /* Object */));
-    }
-    redoFn();
-  }
-  /** @internal */
-  _markRemoved() {
-    const prevState = this._state;
-    const prevDirtyCounter = this._dirtyCounter;
-    this.tracker._doAndTrack(
-      () => applyStateTransition(this, "removed", "do"),
-      () => applyStateTransition(this, "removed", "undo", { prevState, prevDirtyCounter }),
-      new OperationProperties(this, "__state__", 4 /* Object */)
-    );
-  }
-  /** @internal */
-  _markAdded() {
-    if (this._state !== "Unchanged" /* Unchanged */) return;
-    if (this.tracker._isTrackingSuppressed) return;
-    this.tracker._doAndTrack(
-      () => applyStateTransition(this, "added", "do"),
-      () => applyStateTransition(this, "added", "undo"),
-      new OperationProperties(this, "__state__", 4 /* Object */)
-    );
-  }
-  /** @internal */
-  _validate(property, errorMessage) {
-    if (errorMessage) {
-      this.validationMessages.set(property, errorMessage);
-    } else {
-      this.validationMessages.delete(property);
-    }
-    this.validationMessages = new Map(this.validationMessages);
-    this.isValid = this.validationMessages.size === 0;
-  }
-  /** @internal */
-  _applyValidation(messages) {
-    this.validationMessages = messages;
-    this.isValid = messages.size === 0;
-  }
-  destroy() {
-    DependencyTracker.clearDeps(this);
-    this.tracker._untrackObject(this);
-  }
-};
-
 // src/Tracked.ts
 function Tracked(validator, onChange, options) {
   function decorator(target, context) {
@@ -1260,6 +1310,7 @@ var TrackedCollectionChanged = class {
   TrackedCollectionChanged,
   TrackedObject,
   Tracker,
+  TrackerSession,
   TypedEvent
 });
 //# sourceMappingURL=index.cjs.map