reactronic 0.22.200 → 0.22.204

package/README.md

@@ -320,7 +320,7 @@ interface MemberOptions {
   readonly standalone: StandaloneMode
   readonly order: number
   readonly noSideEffects: boolean
-  readonly sensitiveArgs: boolean
+  readonly triggeringArgs: boolean
   readonly throttling: number // milliseconds, -1 is immediately, Number.MAX_SAFE_INTEGER is never
   readonly reentrance: Reentrance
   readonly journal: TransactionJournal | undefined

package/build/dist/source/Options.d.ts

@@ -15,7 +15,7 @@ export interface MemberOptions {
     readonly standalone: StandaloneMode;
     readonly order: number;
     readonly noSideEffects: boolean;
-    readonly sensitiveArgs: boolean;
+    readonly triggeringArgs: boolean;
     readonly throttling: number;
     readonly reentrance: Reentrance;
     readonly journal: TransactionJournal | undefined;

package/build/dist/source/impl/Hooks.d.ts

@@ -15,7 +15,7 @@ export declare class OptionsImpl implements MemberOptions {
     readonly standalone: StandaloneMode;
     readonly order: number;
     readonly noSideEffects: boolean;
-    readonly sensitiveArgs: boolean;
+    readonly triggeringArgs: boolean;
     readonly throttling: number;
     readonly reentrance: Reentrance;
     readonly journal: TransactionJournal | undefined;
@@ -41,10 +41,10 @@ export declare class Hooks implements ProxyHandler<ObjectHolder> {
     static decorateOperation(implicit: boolean, decorator: Function, options: Partial<MemberOptions>, proto: any, member: MemberName, pd: PropertyDescriptor | undefined): any;
     static decorateOperationParametrized(decorator: Function, options: Partial<MemberOptions>): F<any>;
     static acquireObjectHolder(obj: any): ObjectHolder;
-    static createObjectHolder(proto: any, unobservable: any, blank: any, hint: string): ObjectHolder;
+    static createObjectHolderForObservableObject(proto: any, unobservable: any, blank: any, hint: string): ObjectHolder;
     static setProfilingMode(isOn: boolean, options?: Partial<ProfilingOptions>): void;
     static sensitive<T>(sensitivity: boolean, func: F<T>, ...args: any[]): T;
     static setHint<T>(obj: T, hint: string | undefined): T;
-    static createControllerAndGetHook: (h: ObjectHolder, m: MemberName, options: OptionsImpl) => F<any>;
+    static createOperation: (h: ObjectHolder, m: MemberName, options: OptionsImpl) => F<any>;
     static rememberOperationOptions: (proto: any, m: MemberName, getter: Function | undefined, setter: Function | undefined, enumerable: boolean, configurable: boolean, options: Partial<MemberOptions>, implicit: boolean) => OptionsImpl;
 }

package/build/dist/source/impl/Hooks.js

@@ -10,7 +10,7 @@ class ObservableObject {
     constructor() {
         const proto = new.target.prototype;
         const initial = Data_1.Meta.getFrom(proto, Data_1.Meta.Initial);
-        const h = Hooks.createObjectHolder(proto, this, initial, new.target.name);
+        const h = Hooks.createObjectHolderForObservableObject(proto, this, initial, new.target.name);
         return h.proxy;
     }
     [Symbol.toStringTag]() {
@@ -24,7 +24,7 @@ const DEFAULT_OPTIONS = Object.freeze({
     standalone: false,
     order: 0,
     noSideEffects: false,
-    sensitiveArgs: false,
+    triggeringArgs: false,
     throttling: Number.MAX_SAFE_INTEGER,
     reentrance: Options_1.Reentrance.PreventWithError,
     journal: undefined,
@@ -39,7 +39,7 @@ class OptionsImpl {
         this.standalone = merge(DEFAULT_OPTIONS.standalone, existing.standalone, patch.standalone, implicit);
         this.order = merge(DEFAULT_OPTIONS.order, existing.order, patch.order, implicit);
         this.noSideEffects = merge(DEFAULT_OPTIONS.noSideEffects, existing.noSideEffects, patch.noSideEffects, implicit);
-        this.sensitiveArgs = merge(DEFAULT_OPTIONS.sensitiveArgs, existing.sensitiveArgs, patch.sensitiveArgs, implicit);
+        this.triggeringArgs = merge(DEFAULT_OPTIONS.triggeringArgs, existing.triggeringArgs, patch.triggeringArgs, implicit);
         this.throttling = merge(DEFAULT_OPTIONS.throttling, existing.throttling, patch.throttling, implicit);
         this.reentrance = merge(DEFAULT_OPTIONS.reentrance, existing.reentrance, patch.reentrance, implicit);
         this.journal = merge(DEFAULT_OPTIONS.journal, existing.journal, patch.journal, implicit);
@@ -144,18 +144,18 @@ class Hooks {
         if (opts.getter === opts.setter) {
             const bootstrap = function () {
                 const h = Hooks.acquireObjectHolder(this);
-                const hook = Hooks.createControllerAndGetHook(h, member, opts);
-                Object.defineProperty(h.unobservable, member, { value: hook, enumerable, configurable });
-                return hook;
+                const operation = Hooks.createOperation(h, member, opts);
+                Object.defineProperty(h.unobservable, member, { value: operation, enumerable, configurable });
+                return operation;
             };
             return Object.defineProperty(proto, member, { get: bootstrap, enumerable, configurable: true });
         }
         else if (opts.setter === Utils_1.UNDEF) {
             const bootstrap = function () {
                 const h = Hooks.acquireObjectHolder(this);
-                const hook = Hooks.createControllerAndGetHook(h, member, opts);
-                Object.defineProperty(h.unobservable, member, { get: hook, enumerable, configurable });
-                return hook.call(this);
+                const operation = Hooks.createOperation(h, member, opts);
+                Object.defineProperty(h.unobservable, member, { get: operation, enumerable, configurable });
+                return operation.call(this);
             };
             return Object.defineProperty(proto, member, { get: bootstrap, enumerable, configurable: true });
         }
@@ -175,14 +175,12 @@ class Hooks {
             const initial = Data_1.Meta.getFrom(Object.getPrototypeOf(obj), Data_1.Meta.Initial);
             const rev = new Data_1.ObjectRevision(Snapshot_1.ROOT_REV.snapshot, Snapshot_1.ROOT_REV, Object.assign({}, initial));
             Data_1.Meta.set(rev.data, Data_1.Meta.Holder, h);
-            if (Dbg_1.Log.isOn)
-                Snapshot_1.Snapshot.freezeObjectRevision(rev);
             h = new Data_1.ObjectHolder(obj, obj, Hooks.proxy, rev, obj.constructor.name);
             Data_1.Meta.set(obj, Data_1.Meta.Holder, h);
         }
         return h;
     }
-    static createObjectHolder(proto, unobservable, blank, hint) {
+    static createObjectHolderForObservableObject(proto, unobservable, blank, hint) {
         const ctx = Snapshot_1.Snapshot.edit();
         const h = new Data_1.ObjectHolder(unobservable, undefined, Hooks.proxy, Snapshot_1.ROOT_REV, hint);
         ctx.getEditableRevision(h, Data_1.Meta.Holder, blank);
@@ -230,8 +228,8 @@ Hooks.mainThreadBlockingWarningThreshold = Number.MAX_SAFE_INTEGER;
 Hooks.asyncActionDurationWarningThreshold = Number.MAX_SAFE_INTEGER;
 Hooks.sensitivity = false;
 Hooks.proxy = new Hooks();
-Hooks.createControllerAndGetHook = function (h, m, options) {
-    throw (0, Dbg_1.misuse)('createControllerAndGetHook should never be called');
+Hooks.createOperation = function (h, m, options) {
+    throw (0, Dbg_1.misuse)('createOperation should never be called');
 };
 Hooks.rememberOperationOptions = function (proto, m, getter, setter, enumerable, configurable, options, implicit) {
     throw (0, Dbg_1.misuse)('rememberOperationOptions should never be called');

package/build/dist/source/impl/Meta.d.ts

@@ -5,6 +5,7 @@ export declare abstract class Meta {
     static readonly Initial: unique symbol;
     static readonly Reactions: unique symbol;
     static readonly Unobservable: unique symbol;
+    static readonly Undefined: unique symbol;
     static get<T>(obj: any, sym: symbol): T;
     static set(obj: any, sym: symbol, value: any): any;
     static acquire(proto: any, sym: symbol): any;

package/build/dist/source/impl/Meta.js

@@ -30,3 +30,4 @@ Meta.Disposed = Symbol('rxDisposed');
 Meta.Initial = Symbol('rxInitial');
 Meta.Reactions = Symbol('rxReactions');
 Meta.Unobservable = Symbol('rxUnobservable');
+Meta.Undefined = Symbol('rxUndefined');

package/build/dist/source/impl/Monitor.d.ts

@@ -4,24 +4,29 @@ export declare abstract class Monitor extends ObservableObject {
     abstract readonly isActive: boolean;
     abstract readonly counter: number;
     abstract readonly workers: ReadonlySet<Worker>;
-    static create(hint: string, activationDelay: number, deactivationDelay: number): Monitor;
+    abstract readonly duration: number;
+    static create(hint: string, activationDelay: number, deactivationDelay: number, durationResolution: number): Monitor;
 }
 export declare class MonitorImpl extends Monitor {
     isActive: boolean;
     counter: number;
     workers: Set<Worker>;
+    duration: number;
     internals: {
+        started: number;
         activationDelay: number;
         activationTimeout: undefined;
         deactivationDelay: number;
         deactivationTimeout: undefined;
+        durationResolution: number;
     };
     enter(worker: Worker): void;
     leave(worker: Worker): void;
-    static create(hint: string, activationDelay: number, deactivationDelay: number): MonitorImpl;
+    static create(hint: string, activationDelay: number, deactivationDelay: number, durationResolution: number): MonitorImpl;
     static enter(mon: MonitorImpl, worker: Worker): void;
     static leave(mon: MonitorImpl, worker: Worker): void;
     private static doCreate;
     private static activate;
     private static deactivate;
+    private static tick;
 }

package/build/dist/source/impl/Monitor.js

@@ -4,8 +4,8 @@ exports.MonitorImpl = exports.Monitor = void 0;
 const Hooks_1 = require("./Hooks");
 const Transaction_1 = require("./Transaction");
 class Monitor extends Hooks_1.ObservableObject {
-    static create(hint, activationDelay, deactivationDelay) {
-        return MonitorImpl.create(hint, activationDelay, deactivationDelay);
+    static create(hint, activationDelay, deactivationDelay, durationResolution) {
+        return MonitorImpl.create(hint, activationDelay, deactivationDelay, durationResolution);
     }
 }
 exports.Monitor = Monitor;
@@ -15,11 +15,14 @@ class MonitorImpl extends Monitor {
         this.isActive = false;
         this.counter = 0;
         this.workers = new Set();
+        this.duration = 0;
         this.internals = {
+            started: 0,
             activationDelay: -1,
             activationTimeout: undefined,
             deactivationDelay: -1,
             deactivationTimeout: undefined,
+            durationResolution: 1,
         };
     }
     enter(worker) {
@@ -34,8 +37,8 @@ class MonitorImpl extends Monitor {
         workers.delete(worker);
         MonitorImpl.deactivate(this, this.internals.deactivationDelay);
     }
-    static create(hint, activationDelay, deactivationDelay) {
-        return Transaction_1.Transaction.run({ hint: 'Monitor.create' }, MonitorImpl.doCreate, hint, activationDelay, deactivationDelay);
+    static create(hint, activationDelay, deactivationDelay, durationResolution) {
+        return Transaction_1.Transaction.run({ hint: 'Monitor.create' }, MonitorImpl.doCreate, hint, activationDelay, deactivationDelay, durationResolution);
     }
     static enter(mon, worker) {
         mon.enter(worker);
@@ -43,14 +46,20 @@ class MonitorImpl extends Monitor {
     static leave(mon, worker) {
         mon.leave(worker);
     }
-    static doCreate(hint, activationDelay, deactivationDelay) {
+    static doCreate(hint, activationDelay, deactivationDelay, durationResolution) {
         const m = new MonitorImpl();
         Hooks_1.Hooks.setHint(m, hint);
         m.internals.activationDelay = activationDelay;
         m.internals.deactivationDelay = deactivationDelay;
+        m.internals.durationResolution = durationResolution;
         return m;
     }
     static activate(mon, delay) {
+        if (mon.internals.started === 0) {
+            mon.duration = 0;
+            mon.internals.started = performance.now();
+            MonitorImpl.tick(mon);
+        }
         if (delay >= 0) {
             if (mon.internals.activationTimeout === undefined)
                 mon.internals.activationTimeout = setTimeout(() => Transaction_1.Transaction.run({ hint: 'Monitor.activate', standalone: 'isolated' }, MonitorImpl.activate, mon, -1), delay);
@@ -67,6 +76,22 @@ class MonitorImpl extends Monitor {
             mon.isActive = false;
             mon.internals.activationTimeout = undefined;
         }
+        if (mon.counter === 0 && mon.internals.started !== 0) {
+            const resolution = mon.internals.durationResolution;
+            mon.duration = Math.round(resolution * (performance.now() - mon.internals.started)) / resolution;
+            mon.internals.started = 0;
+        }
+    }
+    static tick(mon) {
+        if (mon.internals.started !== 0) {
+            Transaction_1.Transaction.run(null, () => {
+                const resolution = mon.internals.durationResolution;
+                mon.duration = Math.round(resolution * (performance.now() - mon.internals.started)) / resolution;
+            });
+            const t = globalThis !== null && globalThis !== void 0 ? globalThis : global;
+            if (t.requestAnimationFrame)
+                requestAnimationFrame(() => MonitorImpl.tick(mon));
+        }
     }
 }
 exports.MonitorImpl = MonitorImpl;

package/build/dist/source/impl/Operation.d.ts

@@ -28,7 +28,7 @@ export declare class OperationController extends Controller<any> {
     private peek;
     private use;
     private edit;
-    private peekFromRevision;
+    private acquireFromRevision;
     private run;
     private static markObsolete;
 }
@@ -84,7 +84,7 @@ declare class Operation extends Observable implements Observer {
     private unsubscribeFromAllObservables;
     private subscribeTo;
     private static canSubscribe;
-    private static createControllerAndGetHook;
+    private static createOperation;
     private static rememberOperationOptions;
     static init(): void;
 }

package/build/dist/source/impl/Operation.js

@@ -10,9 +10,9 @@ const Transaction_1 = require("./Transaction");
 const Monitor_1 = require("./Monitor");
 const Hooks_1 = require("./Hooks");
 const TransactionJournal_1 = require("./TransactionJournal");
-const ROOT_ARGS = [];
-const ROOT_HOLDER = new Data_1.ObjectHolder(undefined, undefined, Hooks_1.Hooks.proxy, Snapshot_1.ROOT_REV, 'root-holder');
-const INITIAL_CAUSE = 'initial';
+const BOOT_ARGS = [];
+const BOOT_CAUSE = '<boot>';
+const ROOT_HOLDER = new Data_1.ObjectHolder(undefined, undefined, Hooks_1.Hooks.proxy, Snapshot_1.ROOT_REV, '<root>');
 class OperationController extends Controller_1.Controller {
     constructor(ownHolder, memberName) {
         super();
@@ -36,7 +36,7 @@ class OperationController extends Controller_1.Controller {
         const op = oc.operation;
         const opts = op.options;
         if (!oc.isUpToDate && oc.revision.data[Data_1.Meta.Disposed] === undefined
-            && (!weak || op.cause === INITIAL_CAUSE || !op.successor ||
+            && (!weak || op.cause === BOOT_CAUSE || !op.successor ||
                 op.successor.transaction.isFinished)) {
             const outerOpts = (_a = Operation.current) === null || _a === void 0 ? void 0 : _a.options;
             const standalone = weak || opts.standalone || opts.kind === Options_1.Kind.Reaction ||
@@ -68,8 +68,8 @@ class OperationController extends Controller_1.Controller {
             op = self.edit().operation;
         else
             op = Operation.current;
-        if (!op || op.transaction.isFinished)
-            throw (0, Dbg_1.misuse)('a method is expected with reactronic decorator');
+        if (!op)
+            throw (0, Dbg_1.misuse)('reactronic decorator is only applicable to methods');
         op.options = new Hooks_1.OptionsImpl(op.options.getter, op.options.setter, op.options, options, false);
         if (Dbg_1.Log.isOn && Dbg_1.Log.opt.write)
             Dbg_1.Log.write('║', '  ✎', `${op.hint()}.options are changed`);
@@ -93,12 +93,12 @@ class OperationController extends Controller_1.Controller {
         return result;
     }
     static why() {
-        const op = Operation.current;
-        return op ? op.why() : ROOT_HOLDER.hint;
+        var _a, _b;
+        return (_b = (_a = Operation.current) === null || _a === void 0 ? void 0 : _a.why()) !== null && _b !== void 0 ? _b : BOOT_CAUSE;
     }
     static briefWhy() {
-        const op = Operation.current;
-        return op ? op.briefWhy() : ROOT_HOLDER.hint;
+        var _a, _b;
+        return (_b = (_a = Operation.current) === null || _a === void 0 ? void 0 : _a.briefWhy()) !== null && _b !== void 0 ? _b : BOOT_CAUSE;
     }
     static dependencies() {
         const op = Operation.current;
@@ -107,10 +107,10 @@ class OperationController extends Controller_1.Controller {
     peek(args) {
         const ctx = Snapshot_1.Snapshot.current();
         const r = ctx.seekRevision(this.ownHolder, this.memberName);
-        const op = this.peekFromRevision(r, args);
-        const isValid = op.options.kind !== Options_1.Kind.Transaction && op.cause !== INITIAL_CAUSE &&
+        const op = this.acquireFromRevision(r, args);
+        const isValid = op.options.kind !== Options_1.Kind.Transaction && op.cause !== BOOT_CAUSE &&
             (ctx === op.snapshot || ctx.timestamp < op.obsoleteSince) &&
-            (!op.options.sensitiveArgs || args === undefined ||
+            (!op.options.triggeringArgs || args === undefined ||
                 op.args.length === args.length && op.args.every((t, i) => t === args[i])) ||
             r.data[Data_1.Meta.Disposed] !== undefined;
         return { operation: op, isUpToDate: isValid, snapshot: ctx, revision: r };
@@ -125,7 +125,7 @@ class OperationController extends Controller_1.Controller {
         const m = this.memberName;
         const ctx = Snapshot_1.Snapshot.edit();
         const r = ctx.getEditableRevision(h, m, Data_1.Meta.Holder, this);
-        let op = this.peekFromRevision(r, undefined);
+        let op = this.acquireFromRevision(r, undefined);
         if (op.snapshot !== r.snapshot) {
             const op2 = new Operation(this, r.snapshot, op);
             r.data[m] = op2.reenterOver(op);
@@ -135,28 +135,40 @@ class OperationController extends Controller_1.Controller {
         }
         return { operation: op, isUpToDate: true, snapshot: ctx, revision: r };
     }
-    peekFromRevision(r, args) {
+    acquireFromRevision(r, args) {
         const m = this.memberName;
         let op = r.data[m];
         if (op.controller !== this) {
-            const hint = Dbg_1.Log.isOn ? `${Snapshot_1.Dump.obj(this.ownHolder, m)}/boot` : 'MethodController/init';
-            const standalone = r.snapshot.sealed || r.prev.revision !== Snapshot_1.ROOT_REV;
-            op = Transaction_1.Transaction.run({ hint, standalone, token: this }, () => {
-                const h = this.ownHolder;
-                let r2 = Snapshot_1.Snapshot.current().getCurrentRevision(h, m);
-                let op2 = r2.data[m];
-                if (op2.controller !== this) {
-                    r2 = Snapshot_1.Snapshot.edit().getEditableRevision(h, m, Data_1.Meta.Holder, this);
-                    const t = new Operation(this, r2.snapshot, op2);
-                    if (args)
-                        t.args = args;
-                    t.cause = INITIAL_CAUSE;
-                    r2.data[m] = t;
-                    Snapshot_1.Snapshot.markEdited(op2, t, true, r2, m, h);
-                    op2 = t;
-                }
-                return op2;
-            });
+            if (r.snapshot !== Snapshot_1.ROOT_REV.snapshot) {
+                const hint = Dbg_1.Log.isOn ? `${Snapshot_1.Dump.obj(this.ownHolder, m)}/boot` : 'MethodController/init';
+                const standalone = r.snapshot.sealed || r.prev.revision !== Snapshot_1.ROOT_REV;
+                op = Transaction_1.Transaction.run({ hint, standalone, token: this }, () => {
+                    const h = this.ownHolder;
+                    let r2 = Snapshot_1.Snapshot.current().getCurrentRevision(h, m);
+                    let op2 = r2.data[m];
+                    if (op2.controller !== this) {
+                        r2 = Snapshot_1.Snapshot.edit().getEditableRevision(h, m, Data_1.Meta.Holder, this);
+                        const t = new Operation(this, r2.snapshot, op2);
+                        if (args)
+                            t.args = args;
+                        t.cause = BOOT_CAUSE;
+                        r2.data[m] = t;
+                        Snapshot_1.Snapshot.markEdited(op2, t, true, r2, m, h);
+                        op2 = t;
+                    }
+                    return op2;
+                });
+            }
+            else {
+                const t = new Operation(this, r.snapshot, op);
+                if (args)
+                    t.args = args;
+                t.cause = BOOT_CAUSE;
+                r.data[m] = t;
+                op = t;
+                if (Dbg_1.Log.isOn && Dbg_1.Log.opt.write)
+                    Dbg_1.Log.write('║', '  ⎘', `${Snapshot_1.Dump.obj(this.ownHolder, m)} is cloned outside of transaction`);
+            }
         }
         return op;
     }
@@ -188,7 +200,7 @@ class OperationController extends Controller_1.Controller {
     static markObsolete(self) {
         const oc = self.peek(undefined);
         const ctx = oc.snapshot;
-        oc.operation.markObsoleteDueTo(oc.operation, self.memberName, Snapshot_1.ROOT_REV.snapshot, ROOT_HOLDER, INITIAL_CAUSE, ctx.timestamp, ctx.reactions);
+        oc.operation.markObsoleteDueTo(oc.operation, self.memberName, Snapshot_1.ROOT_REV.snapshot, ROOT_HOLDER, BOOT_CAUSE, ctx.timestamp, ctx.reactions);
     }
 }
 exports.OperationController = OperationController;
@@ -207,7 +219,7 @@ class Operation extends Data_1.Observable {
         }
         else {
             this.options = prev;
-            this.args = ROOT_ARGS;
+            this.args = BOOT_ARGS;
             this.cause = undefined;
         }
         this.started = 0;
@@ -268,7 +280,7 @@ class Operation extends Data_1.Observable {
             const skip = !observable.isOperation &&
                 snapshot === this.snapshot;
             if (!skip) {
-                const why = `${Snapshot_1.Dump.rev2(holder, snapshot, memberName)}    <<    ${outer}`;
+                const why = `${Snapshot_1.Dump.rev2(holder, snapshot, memberName, observable)}    <<    ${outer}`;
                 this.unsubscribeFromAllObservables();
                 this.obsoleteDueTo = why;
                 this.obsoleteSince = since;
@@ -451,7 +463,7 @@ class Operation extends Data_1.Observable {
                     ctx.bumpBy(r.snapshot.timestamp);
                 const t = weak ? -1 : ctx.timestamp;
                 if (!op.subscribeTo(observable, r, m, h, t))
-                    op.markObsoleteDueTo(observable, m, r.snapshot, h, INITIAL_CAUSE, ctx.timestamp, ctx.reactions);
+                    op.markObsoleteDueTo(observable, m, r.snapshot, h, BOOT_CAUSE, ctx.timestamp, ctx.reactions);
             }
         }
     }
@@ -463,7 +475,7 @@ class Operation extends Data_1.Observable {
     static isConflicting(oldValue, newValue) {
         let result = oldValue !== newValue;
         if (result)
-            result = oldValue instanceof Operation && oldValue.cause !== INITIAL_CAUSE;
+            result = oldValue instanceof Operation && oldValue.cause !== BOOT_CAUSE;
         return result;
     }
     static propagateAllChangesThroughSubscriptions(snapshot) {
@@ -589,13 +601,13 @@ class Operation extends Data_1.Observable {
             result = !(observable instanceof Operation && timestamp >= observable.obsoleteSince);
         return result;
     }
-    static createControllerAndGetHook(h, m, options) {
+    static createOperation(h, m, options) {
         const ctl = new OperationController(h, m);
-        const hook = (...args) => {
+        const operation = (...args) => {
             return ctl.useOrRun(false, args).result;
         };
-        Data_1.Meta.set(hook, Data_1.Meta.Controller, ctl);
-        return hook;
+        Data_1.Meta.set(operation, Data_1.Meta.Controller, ctl);
+        return operation;
     }
     static rememberOperationOptions(proto, m, getter, setter, enumerable, configurable, options, implicit) {
         const initial = Data_1.Meta.acquire(proto, Data_1.Meta.Initial);
@@ -614,15 +626,16 @@ class Operation extends Data_1.Observable {
         return op.options;
     }
     static init() {
-        Object.freeze(ROOT_ARGS);
+        Object.freeze(BOOT_ARGS);
         Dbg_1.Log.getMergedLoggingOptions = getMergedLoggingOptions;
+        Snapshot_1.Dump.valueHint = valueHint;
         Snapshot_1.Snapshot.markUsed = Operation.markUsed;
         Snapshot_1.Snapshot.markEdited = Operation.markEdited;
         Snapshot_1.Snapshot.isConflicting = Operation.isConflicting;
         Snapshot_1.Snapshot.propagateAllChangesThroughSubscriptions = Operation.propagateAllChangesThroughSubscriptions;
         Snapshot_1.Snapshot.revokeAllSubscriptions = Operation.revokeAllSubscriptions;
         Snapshot_1.Snapshot.enqueueReactionsToRun = Operation.enqueueReactionsToRun;
-        Hooks_1.Hooks.createControllerAndGetHook = Operation.createControllerAndGetHook;
+        Hooks_1.Hooks.createOperation = Operation.createOperation;
         Hooks_1.Hooks.rememberOperationOptions = Operation.rememberOperationOptions;
         Promise.prototype.then = reactronicHookedThen;
         try {
@@ -662,10 +675,14 @@ function valueHint(value, m) {
         result = `${Snapshot_1.Dump.rev2(value.controller.ownHolder, value.snapshot, m)}`;
     else if (value === Data_1.Meta.Disposed)
         result = '<disposed>';
+    else if (value === Data_1.Meta.Undefined)
+        result = '◌';
+    else if (typeof (value) === 'string')
+        result = `"${value.toString().slice(0, 20)}"`;
     else if (value !== undefined && value !== null)
         result = value.toString().slice(0, 20);
     else
-        result = '∅';
+        result = '◌';
     return result;
 }
 function getMergedLoggingOptions(local) {

package/build/dist/source/impl/Snapshot.d.ts

@@ -35,7 +35,7 @@ export declare class Snapshot implements AbstractSnapshot {
     static takeSnapshot<T>(obj: T): T;
     static dispose(obj: any): void;
     static doDispose(ctx: Snapshot, h: ObjectHolder): ObjectRevision;
-    private checkIfEditable;
+    private isNewRevisionRequired;
     acquire(outer: Snapshot): void;
     bumpBy(timestamp: number): void;
     rebase(): ObjectRevision[] | undefined;
@@ -49,8 +49,9 @@ export declare class Snapshot implements AbstractSnapshot {
     static _init(): void;
 }
 export declare class Dump {
-    static obj(h: ObjectHolder | undefined, m?: MemberName | undefined, stamp?: number, snapshotId?: number, originSnapshotId?: number, typeless?: boolean): string;
-    static rev2(h: ObjectHolder, s: AbstractSnapshot, m?: MemberName, value?: Observable): string;
+    static valueHint: (value: any, m?: PropertyKey | undefined) => string;
+    static obj(h: ObjectHolder | undefined, m?: MemberName | undefined, stamp?: number, snapshotId?: number, originSnapshotId?: number, value?: any): string;
+    static rev2(h: ObjectHolder, s: AbstractSnapshot, m?: MemberName, o?: Observable): string;
     static rev(r: ObjectRevision, m?: MemberName): string;
     static conflicts(conflicts: ObjectRevision[]): string;
     static conflictingMemberHint(m: MemberName, ours: ObjectRevision, theirs: ObjectRevision): string;

package/build/dist/source/impl/Snapshot.js

@@ -65,8 +65,7 @@ class Snapshot {
         let r = this.seekRevision(h, m);
         const existing = r.data[m];
         if (existing !== Data_1.Meta.Unobservable) {
-            this.checkIfEditable(h, r, m, existing, value, token);
-            if (r.snapshot !== this) {
+            if (this.isNewRevisionRequired(h, r, m, existing, value, token)) {
                 const data = Object.assign({}, m === Data_1.Meta.Holder ? value : r.data);
                 Reflect.set(data, Data_1.Meta.Holder, h);
                 r = new Data_1.ObjectRevision(this, r, data);
@@ -98,8 +97,8 @@ class Snapshot {
         }
         return r;
     }
-    checkIfEditable(h, r, m, existing, value, token) {
-        if (this.sealed)
+    isNewRevisionRequired(h, r, m, existing, value, token) {
+        if (this.sealed && r.snapshot !== exports.ROOT_REV.snapshot)
             throw (0, Dbg_1.misuse)(`observable property ${Dump.obj(h, m)} can only be modified inside transaction`);
         if (m !== Data_1.Meta.Holder && value !== Data_1.Meta.Holder) {
             if (r.snapshot !== this || r.prev.revision !== exports.ROOT_REV) {
@@ -109,6 +108,7 @@ class Snapshot {
             if (r === exports.ROOT_REV)
                 throw (0, Dbg_1.misuse)(`member ${Dump.rev(r, m)} doesn't exist in snapshot v${this.stamp} (${this.hint})`);
         }
+        return r.snapshot !== this && !this.sealed;
     }
     acquire(outer) {
         if (!this.sealed && this.stamp === exports.UNDEFINED_TIMESTAMP) {
@@ -280,10 +280,10 @@ class Snapshot {
             Object.freeze(this);
     }
     static _init() {
-        const root = exports.ROOT_REV.snapshot;
-        root.acquire(root);
-        root.applyOrDiscard();
-        root.triggerGarbageCollection();
+        const boot = exports.ROOT_REV.snapshot;
+        boot.acquire(boot);
+        boot.applyOrDiscard();
+        boot.triggerGarbageCollection();
         Snapshot.freezeObjectRevision(exports.ROOT_REV);
         Snapshot.idGen = 100;
         Snapshot.stampGen = 101;
@@ -311,14 +311,17 @@ Snapshot.propagateAllChangesThroughSubscriptions = (snapshot) => { };
 Snapshot.revokeAllSubscriptions = (snapshot) => { };
 Snapshot.enqueueReactionsToRun = (reactions) => { };
 class Dump {
-    static obj(h, m, stamp, snapshotId, originSnapshotId, typeless) {
+    static obj(h, m, stamp, snapshotId, originSnapshotId, value) {
         const member = m !== undefined ? `.${m.toString()}` : '';
         return h === undefined
-            ? `root${member}`
-            : stamp === undefined ? `${h.hint}${member} #${h.id}` : `${h.hint}${member} #${h.id}t${snapshotId}v${stamp}${originSnapshotId !== undefined && originSnapshotId !== 0 ? `t${originSnapshotId}` : ''}`;
+            ? `boot${member}`
+            : stamp === undefined
+                ? `${h.hint}${member}${value !== undefined ? `[=${Dump.valueHint(value)}]` : ''} #${h.id}`
+                : `${h.hint}${member}${value !== undefined ? `[=${Dump.valueHint(value)}]` : ''} #${h.id}t${snapshotId}v${stamp}${originSnapshotId !== undefined && originSnapshotId !== 0 ? `t${originSnapshotId}` : ''}`;
     }
-    static rev2(h, s, m, value) {
-        return Dump.obj(h, m, s.timestamp, s.id, value === null || value === void 0 ? void 0 : value.originSnapshotId);
+    static rev2(h, s, m, o) {
+        var _a;
+        return Dump.obj(h, m, s.timestamp, s.id, o === null || o === void 0 ? void 0 : o.originSnapshotId, (_a = o === null || o === void 0 ? void 0 : o.value) !== null && _a !== void 0 ? _a : Data_1.Meta.Undefined);
     }
     static rev(r, m) {
         const h = Data_1.Meta.get(r.data, Data_1.Meta.Holder);
@@ -339,7 +342,8 @@ class Dump {
     }
 }
 exports.Dump = Dump;
-exports.ROOT_REV = new Data_1.ObjectRevision(new Snapshot({ hint: 'root-rev' }), undefined, {});
+Dump.valueHint = (value, m) => '???';
+exports.ROOT_REV = new Data_1.ObjectRevision(new Snapshot({ hint: '<root>' }), undefined, {});
 exports.DefaultSnapshotOptions = Object.freeze({
     hint: 'noname',
     standalone: false,

package/build/dist/source/impl/Transaction.js

@@ -305,7 +305,7 @@ class TransactionImpl extends Transaction {
         Snapshot_1.Snapshot._init();
     }
 }
-TransactionImpl.none = new TransactionImpl({ hint: '<none>' });
+TransactionImpl.none = new TransactionImpl({ hint: 'Transaction.off' });
 TransactionImpl.curr = TransactionImpl.none;
 TransactionImpl.inspection = false;
 TransactionImpl.frameStartTime = 0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "reactronic",
-  "version": "0.22.200",
+  "version": "0.22.204",
   "description": "Reactronic - Transactional Reactive State Management",
   "main": "build/dist/source/api.js",
   "types": "build/dist/source/api.d.ts",