reactronic 0.22.109 → 0.22.202

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();
@@ -27,7 +27,7 @@ class OperationController extends Controller_1.Controller {
     get error() { return this.use().operation.error; }
     get stamp() { return this.use().revision.snapshot.timestamp; }
     get isUpToDate() { return this.use().isUpToDate; }
-    markObsolete() { Transaction_1.Transaction.run({ hint: Dbg_1.Dbg.isOn ? `markObsolete(${Snapshot_1.Dump.obj(this.ownHolder, this.memberName)})` : 'markObsolete()' }, OperationController.markObsolete, this); }
+    markObsolete() { Transaction_1.Transaction.run({ hint: Dbg_1.Log.isOn ? `markObsolete(${Snapshot_1.Dump.obj(this.ownHolder, this.memberName)})` : 'markObsolete()' }, OperationController.markObsolete, this); }
     pullLastResult(args) { return this.useOrRun(true, args).value; }
     useOrRun(weak, args) {
         var _a;
@@ -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 ||
@@ -49,9 +49,9 @@ class OperationController extends Controller_1.Controller {
             if (!weak || ctx === ctx2 || (ctx2.sealed && ctx.timestamp >= ctx2.timestamp))
                 oc = oc2;
         }
-        else if (Dbg_1.Dbg.isOn && Dbg_1.Dbg.trace.operation && (opts.trace === undefined ||
-            opts.trace.operation === undefined || opts.trace.operation === true))
-            Dbg_1.Dbg.log(Transaction_1.Transaction.current.isFinished ? '' : '║', ' (=)', `${Snapshot_1.Dump.rev2(oc.operation.controller.ownHolder, oc.snapshot, this.memberName)} result is reused from T${oc.operation.transaction.id}[${oc.operation.transaction.hint}]`);
+        else if (Dbg_1.Log.isOn && Dbg_1.Log.opt.operation && (opts.logging === undefined ||
+            opts.logging.operation === undefined || opts.logging.operation === true))
+            Dbg_1.Log.write(Transaction_1.Transaction.current.isFinished ? '' : '║', ' (=)', `${Snapshot_1.Dump.rev2(oc.operation.controller.ownHolder, oc.snapshot, this.memberName)} result is reused from T${oc.operation.transaction.id}[${oc.operation.transaction.hint}]`);
         const t = oc.operation;
         Snapshot_1.Snapshot.markUsed(t, oc.revision, this.memberName, this.ownHolder, t.options.kind, weak);
         return t;
@@ -68,11 +68,11 @@ 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.Dbg.isOn && Dbg_1.Dbg.trace.write)
-            Dbg_1.Dbg.log('║', '  ✎', `${op.hint()}.options are changed`);
+        if (Dbg_1.Log.isOn && Dbg_1.Log.opt.write)
+            Dbg_1.Log.write('║', '  ✎', `${op.hint()}.options are changed`);
         return op.options;
     }
     static runWithin(op, func, ...args) {
@@ -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,48 +135,60 @@ 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.Dbg.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;
     }
     run(existing, standalone, options, token, args) {
-        const hint = Dbg_1.Dbg.isOn ? `${Snapshot_1.Dump.obj(this.ownHolder, this.memberName)}${args && args.length > 0 && (typeof args[0] === 'number' || typeof args[0] === 'string') ? ` - ${args[0]}` : ''}` : `${Snapshot_1.Dump.obj(this.ownHolder, this.memberName)}`;
+        const hint = Dbg_1.Log.isOn ? `${Snapshot_1.Dump.obj(this.ownHolder, this.memberName)}${args && args.length > 0 && (typeof args[0] === 'number' || typeof args[0] === 'string') ? ` - ${args[0]}` : ''}` : `${Snapshot_1.Dump.obj(this.ownHolder, this.memberName)}`;
         let oc = existing;
-        const opts = { hint, standalone, journal: options.journal, trace: options.trace, token };
+        const opts = { hint, standalone, journal: options.journal, logging: options.logging, token };
         const result = Transaction_1.Transaction.run(opts, (argsx) => {
             if (!oc.operation.transaction.isCanceled) {
                 oc = this.edit();
-                if (Dbg_1.Dbg.isOn && Dbg_1.Dbg.trace.operation)
-                    Dbg_1.Dbg.log('║', '  𝑓', `${oc.operation.why()}`);
+                if (Dbg_1.Log.isOn && Dbg_1.Log.opt.operation)
+                    Dbg_1.Log.write('║', '  𝑓', `${oc.operation.why()}`);
                 oc.operation.run(this.ownHolder.proxy, argsx);
             }
             else {
                 oc = this.peek(argsx);
                 if (oc.operation.options.kind === Options_1.Kind.Transaction || !oc.isUpToDate) {
                     oc = this.edit();
-                    if (Dbg_1.Dbg.isOn && Dbg_1.Dbg.trace.operation)
-                        Dbg_1.Dbg.log('║', '  𝑓', `${oc.operation.why()}`);
+                    if (Dbg_1.Log.isOn && Dbg_1.Log.opt.operation)
+                        Dbg_1.Log.write('║', '  𝑓', `${oc.operation.why()}`);
                     oc.operation.run(this.ownHolder.proxy, argsx);
                 }
             }
@@ -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;
@@ -240,15 +252,15 @@ class Operation extends Data_1.Observable {
     }
     wrap(func) {
         const wrappedForOperation = (...args) => {
-            if (Dbg_1.Dbg.isOn && Dbg_1.Dbg.trace.step && this.result)
-                Dbg_1.Dbg.logAs({ margin2: this.margin }, '║', '‾\\', `${this.hint()} - step in  `, 0, '        │');
+            if (Dbg_1.Log.isOn && Dbg_1.Log.opt.step && this.result)
+                Dbg_1.Log.writeAs({ margin2: this.margin }, '║', '‾\\', `${this.hint()} - step in  `, 0, '        │');
             const started = Date.now();
             const result = OperationController.runWithin(this, func, ...args);
             const ms = Date.now() - started;
-            if (Dbg_1.Dbg.isOn && Dbg_1.Dbg.trace.step && this.result)
-                Dbg_1.Dbg.logAs({ margin2: this.margin }, '║', '_/', `${this.hint()} - step out `, 0, this.started > 0 ? '        │' : '');
+            if (Dbg_1.Log.isOn && Dbg_1.Log.opt.step && this.result)
+                Dbg_1.Log.writeAs({ margin2: this.margin }, '║', '_/', `${this.hint()} - step out `, 0, this.started > 0 ? '        │' : '');
             if (ms > Hooks_1.Hooks.mainThreadBlockingWarningThreshold)
-                Dbg_1.Dbg.log('', '[!]', this.why(), ms, '    *** main thread is too busy ***');
+                Dbg_1.Log.write('', '[!]', this.why(), ms, '    *** main thread is too busy ***');
             return result;
         };
         return wrappedForOperation;
@@ -273,8 +285,8 @@ class Operation extends Data_1.Observable {
                 this.obsoleteDueTo = why;
                 this.obsoleteSince = since;
                 const isReaction = this.options.kind === Options_1.Kind.Reaction;
-                if (Dbg_1.Dbg.isOn && (Dbg_1.Dbg.trace.obsolete || ((_a = this.options.trace) === null || _a === void 0 ? void 0 : _a.obsolete)))
-                    Dbg_1.Dbg.log(Dbg_1.Dbg.trace.transaction && !Snapshot_1.Snapshot.current().sealed ? '║' : ' ', isReaction ? '█' : '▒', isReaction && snapshot === Snapshot_1.ROOT_REV.snapshot
+                if (Dbg_1.Log.isOn && (Dbg_1.Log.opt.obsolete || ((_a = this.options.logging) === null || _a === void 0 ? void 0 : _a.obsolete)))
+                    Dbg_1.Log.write(Dbg_1.Log.opt.transaction && !Snapshot_1.Snapshot.current().sealed ? '║' : ' ', isReaction ? '█' : '▒', isReaction && snapshot === Snapshot_1.ROOT_REV.snapshot
                         ? `${this.hint()} is a reaction and will run automatically (order ${this.options.order})`
                         : `${this.hint()} is obsolete due to ${Snapshot_1.Dump.rev2(holder, snapshot, memberName)} since v${since}${isReaction ? ` and will run automatically (order ${this.options.order})` : ''}`);
                 if (isReaction)
@@ -287,8 +299,8 @@ class Operation extends Data_1.Observable {
                 else if (!tran.isFinished && this !== observable)
                     tran.cancel(new Error(`T${tran.id}[${tran.hint}] is canceled due to obsolete ${Snapshot_1.Dump.rev2(holder, snapshot, memberName)} changed by T${snapshot.id}[${snapshot.hint}]`), null);
             }
-            else if (Dbg_1.Dbg.isOn && (Dbg_1.Dbg.trace.obsolete || ((_c = this.options.trace) === null || _c === void 0 ? void 0 : _c.obsolete)))
-                Dbg_1.Dbg.log(' ', 'x', `${this.hint()} is not obsolete due to its own change to ${Snapshot_1.Dump.rev2(holder, snapshot, memberName)}`);
+            else if (Dbg_1.Log.isOn && (Dbg_1.Log.opt.obsolete || ((_c = this.options.logging) === null || _c === void 0 ? void 0 : _c.obsolete)))
+                Dbg_1.Log.write(' ', 'x', `${this.hint()} is not obsolete due to its own change to ${Snapshot_1.Dump.rev2(holder, snapshot, memberName)}`);
         }
     }
     runIfNotUpToDate(now, nothrow) {
@@ -328,8 +340,8 @@ class Operation extends Data_1.Observable {
         let error = undefined;
         const opponent = head.successor;
         if (opponent && !opponent.transaction.isFinished) {
-            if (Dbg_1.Dbg.isOn && Dbg_1.Dbg.trace.obsolete)
-                Dbg_1.Dbg.log('║', ' [!]', `${this.hint()} is trying to re-enter over ${opponent.hint()}`);
+            if (Dbg_1.Log.isOn && Dbg_1.Log.opt.obsolete)
+                Dbg_1.Log.write('║', ' [!]', `${this.hint()} is trying to re-enter over ${opponent.hint()}`);
             switch (head.options.reentrance) {
                 case Options_1.Reentrance.PreventWithError:
                     if (!opponent.transaction.isCanceled)
@@ -371,8 +383,8 @@ class Operation extends Data_1.Observable {
     enter() {
         if (this.options.monitor)
             this.monitorEnter(this.options.monitor);
-        if (Dbg_1.Dbg.isOn && Dbg_1.Dbg.trace.operation)
-            Dbg_1.Dbg.log('║', '‾\\', `${this.hint()} - enter`, undefined, `    [ ${Snapshot_1.Dump.obj(this.controller.ownHolder, this.controller.memberName)} ]`);
+        if (Dbg_1.Log.isOn && Dbg_1.Log.opt.operation)
+            Dbg_1.Log.write('║', '‾\\', `${this.hint()} - enter`, undefined, `    [ ${Snapshot_1.Dump.obj(this.controller.ownHolder, this.controller.memberName)} ]`);
         this.started = Date.now();
     }
     leaveOrAsync() {
@@ -386,11 +398,11 @@ class Operation extends Data_1.Observable {
                 this.leave(false, '  ⚐', '- finished  ', 'ERR ──┘');
                 throw error;
             });
-            if (Dbg_1.Dbg.isOn) {
-                if (Dbg_1.Dbg.trace.operation)
-                    Dbg_1.Dbg.log('║', '_/', `${this.hint()} - leave... `, 0, 'ASYNC ──┐');
-                else if (Dbg_1.Dbg.trace.transaction)
-                    Dbg_1.Dbg.log('║', '  ', `${this.why()} ...`, 0, 'ASYNC');
+            if (Dbg_1.Log.isOn) {
+                if (Dbg_1.Log.opt.operation)
+                    Dbg_1.Log.write('║', '_/', `${this.hint()} - leave... `, 0, 'ASYNC ──┐');
+                else if (Dbg_1.Log.opt.transaction)
+                    Dbg_1.Log.write('║', '  ', `${this.why()} ...`, 0, 'ASYNC');
             }
         }
         else {
@@ -401,10 +413,10 @@ class Operation extends Data_1.Observable {
     leave(main, op, message, highlight = undefined) {
         const ms = Date.now() - this.started;
         this.started = -this.started;
-        if (Dbg_1.Dbg.isOn && Dbg_1.Dbg.trace.operation)
-            Dbg_1.Dbg.log('║', `${op}`, `${this.hint()} ${message}`, ms, highlight);
+        if (Dbg_1.Log.isOn && Dbg_1.Log.opt.operation)
+            Dbg_1.Log.write('║', `${op}`, `${this.hint()} ${message}`, ms, highlight);
         if (ms > (main ? Hooks_1.Hooks.mainThreadBlockingWarningThreshold : Hooks_1.Hooks.asyncActionDurationWarningThreshold))
-            Dbg_1.Dbg.log('', '[!]', this.why(), ms, main ? '    *** main thread is too busy ***' : '    *** async is too long ***');
+            Dbg_1.Log.write('', '[!]', this.why(), ms, main ? '    *** main thread is too busy ***' : '    *** async is too long ***');
         this.cause = undefined;
         if (this.options.monitor)
             this.monitorLeave(this.options.monitor);
@@ -413,7 +425,7 @@ class Operation extends Data_1.Observable {
         const options = {
             hint: 'Monitor.enter',
             standalone: 'isolated',
-            trace: Dbg_1.Dbg.isOn && Dbg_1.Dbg.trace.monitor ? undefined : Dbg_1.Dbg.global
+            logging: Dbg_1.Log.isOn && Dbg_1.Log.opt.monitor ? undefined : Dbg_1.Log.global
         };
         OperationController.runWithin(undefined, Transaction_1.Transaction.run, options, Monitor_1.MonitorImpl.enter, mon, this.transaction);
     }
@@ -423,7 +435,7 @@ class Operation extends Data_1.Observable {
                 const options = {
                     hint: 'Monitor.leave',
                     standalone: 'isolated',
-                    trace: Dbg_1.Dbg.isOn && Dbg_1.Dbg.trace.monitor ? undefined : Dbg_1.Dbg.DefaultLevel
+                    logging: Dbg_1.Log.isOn && Dbg_1.Log.opt.monitor ? undefined : Dbg_1.Log.DefaultLevel
                 };
                 OperationController.runWithin(undefined, Transaction_1.Transaction.run, options, Monitor_1.MonitorImpl.leave, mon, this.transaction);
             };
@@ -451,19 +463,19 @@ 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);
             }
         }
     }
     static markEdited(oldValue, newValue, edited, r, m, h) {
         edited ? r.changes.add(m) : r.changes.delete(m);
-        if (Dbg_1.Dbg.isOn && Dbg_1.Dbg.trace.write)
-            edited ? Dbg_1.Dbg.log('║', '  ✎', `${Snapshot_1.Dump.rev2(h, r.snapshot, m)} is changed from ${valueHint(oldValue, m)} to ${valueHint(newValue, m)}`) : Dbg_1.Dbg.log('║', '  ✎', `${Snapshot_1.Dump.rev2(h, r.snapshot, m)} is changed from ${valueHint(oldValue, m)} to ${valueHint(newValue, m)}`, undefined, ' (same as previous)');
+        if (Dbg_1.Log.isOn && Dbg_1.Log.opt.write)
+            edited ? Dbg_1.Log.write('║', '  ✎', `${Snapshot_1.Dump.rev2(h, r.snapshot, m)} is changed from ${valueHint(oldValue, m)} to ${valueHint(newValue, m)}`) : Dbg_1.Log.write('║', '  ✎', `${Snapshot_1.Dump.rev2(h, r.snapshot, m)} is changed from ${valueHint(oldValue, m)} to ${valueHint(newValue, m)}`, undefined, ' (same as previous)');
     }
     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) {
@@ -512,7 +524,7 @@ class Operation extends Data_1.Observable {
                 if (Hooks_1.Hooks.repetitiveUsageWarningThreshold < Number.MAX_SAFE_INTEGER) {
                     curr.observables.forEach((info, v) => {
                         if (info.usageCount > Hooks_1.Hooks.repetitiveUsageWarningThreshold)
-                            Dbg_1.Dbg.log('', '[!]', `${curr.hint()} uses ${info.memberHint} ${info.usageCount} times (consider remembering it in a local variable)`, 0, ' *** WARNING ***');
+                            Dbg_1.Log.write('', '[!]', `${curr.hint()} uses ${info.memberHint} ${info.usageCount} times (consider remembering it in a local variable)`, 0, ' *** WARNING ***');
                     });
                 }
                 if (unsubscribe)
@@ -522,8 +534,8 @@ class Operation extends Data_1.Observable {
         else if (curr instanceof Data_1.Observable && curr.observers) {
             curr.observers.forEach(o => {
                 o.observables.delete(curr);
-                if (Dbg_1.Dbg.isOn && Dbg_1.Dbg.trace.read)
-                    Dbg_1.Dbg.log(Dbg_1.Dbg.trace.transaction && !Snapshot_1.Snapshot.current().sealed ? '║' : ' ', '-', `${o.hint()} is unsubscribed from own-changed ${Snapshot_1.Dump.rev(r, m)}`);
+                if (Dbg_1.Log.isOn && Dbg_1.Log.opt.read)
+                    Dbg_1.Log.write(Dbg_1.Log.opt.transaction && !Snapshot_1.Snapshot.current().sealed ? '║' : ' ', '-', `${o.hint()} is unsubscribed from own-changed ${Snapshot_1.Dump.rev(r, m)}`);
             });
             curr.observers = undefined;
         }
@@ -551,8 +563,8 @@ class Operation extends Data_1.Observable {
         (_a = this.observables) === null || _a === void 0 ? void 0 : _a.forEach((info, value) => {
             var _a;
             value.observers.delete(this);
-            if (Dbg_1.Dbg.isOn && (Dbg_1.Dbg.trace.read || ((_a = this.options.trace) === null || _a === void 0 ? void 0 : _a.read)))
-                Dbg_1.Dbg.log(Dbg_1.Dbg.trace.transaction && !Snapshot_1.Snapshot.current().sealed ? '║' : ' ', '-', `${this.hint()} is unsubscribed from ${info.memberHint}`);
+            if (Dbg_1.Log.isOn && (Dbg_1.Log.opt.read || ((_a = this.options.logging) === null || _a === void 0 ? void 0 : _a.read)))
+                Dbg_1.Log.write(Dbg_1.Log.opt.transaction && !Snapshot_1.Snapshot.current().sealed ? '║' : ' ', '-', `${this.hint()} is unsubscribed from ${info.memberHint}`);
         });
         this.observables = undefined;
     }
@@ -571,15 +583,15 @@ class Operation extends Data_1.Observable {
                 const info = { memberHint: Snapshot_1.Dump.rev2(h, r.snapshot, m), usageCount: times };
                 observable.observers.add(this);
                 this.observables.set(observable, info);
-                if (Dbg_1.Dbg.isOn && (Dbg_1.Dbg.trace.read || ((_a = this.options.trace) === null || _a === void 0 ? void 0 : _a.read)))
-                    Dbg_1.Dbg.log('║', '  ∞ ', `${this.hint()} is subscribed to ${Snapshot_1.Dump.rev2(h, r.snapshot, m)}${info.usageCount > 1 ? ` (${info.usageCount} times)` : ''}`);
+                if (Dbg_1.Log.isOn && (Dbg_1.Log.opt.read || ((_a = this.options.logging) === null || _a === void 0 ? void 0 : _a.read)))
+                    Dbg_1.Log.write('║', '  ∞ ', `${this.hint()} is subscribed to ${Snapshot_1.Dump.rev2(h, r.snapshot, m)}${info.usageCount > 1 ? ` (${info.usageCount} times)` : ''}`);
             }
-            else if (Dbg_1.Dbg.isOn && (Dbg_1.Dbg.trace.read || ((_b = this.options.trace) === null || _b === void 0 ? void 0 : _b.read)))
-                Dbg_1.Dbg.log('║', '  x ', `${this.hint()} is obsolete and is NOT subscribed to ${Snapshot_1.Dump.rev2(h, r.snapshot, m)}`);
+            else if (Dbg_1.Log.isOn && (Dbg_1.Log.opt.read || ((_b = this.options.logging) === null || _b === void 0 ? void 0 : _b.read)))
+                Dbg_1.Log.write('║', '  x ', `${this.hint()} is obsolete and is NOT subscribed to ${Snapshot_1.Dump.rev2(h, r.snapshot, m)}`);
         }
         else {
-            if (Dbg_1.Dbg.isOn && (Dbg_1.Dbg.trace.read || ((_c = this.options.trace) === null || _c === void 0 ? void 0 : _c.read)))
-                Dbg_1.Dbg.log('║', '  x ', `${this.hint()} is NOT subscribed to already obsolete ${Snapshot_1.Dump.rev2(h, r.snapshot, m)}`);
+            if (Dbg_1.Log.isOn && (Dbg_1.Log.opt.read || ((_c = this.options.logging) === null || _c === void 0 ? void 0 : _c.read)))
+                Dbg_1.Log.write('║', '  x ', `${this.hint()} is NOT subscribed to already obsolete ${Snapshot_1.Dump.rev2(h, r.snapshot, m)}`);
         }
         return ok;
     }
@@ -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,15 @@ class Operation extends Data_1.Observable {
         return op.options;
     }
     static init() {
-        Object.freeze(ROOT_ARGS);
-        Dbg_1.Dbg.getMergedTraceOptions = getMergedTraceOptions;
+        Object.freeze(BOOT_ARGS);
+        Dbg_1.Log.getMergedLoggingOptions = getMergedLoggingOptions;
         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 {
@@ -668,14 +680,14 @@ function valueHint(value, m) {
         result = '∅';
     return result;
 }
-function getMergedTraceOptions(local) {
+function getMergedLoggingOptions(local) {
     const t = Transaction_1.Transaction.current;
-    let res = Dbg_1.Dbg.merge(t.options.trace, t.id > 1 ? 31 + t.id % 6 : 37, t.id > 1 ? `T${t.id}` : `-${Snapshot_1.Snapshot.idGen.toString().replace(/[0-9]/g, '-')}`, Dbg_1.Dbg.global);
-    res = Dbg_1.Dbg.merge({ margin1: t.margin }, undefined, undefined, res);
+    let res = Dbg_1.Log.merge(t.options.logging, t.id > 1 ? 31 + t.id % 6 : 37, t.id > 1 ? `T${t.id}` : `-${Snapshot_1.Snapshot.idGen.toString().replace(/[0-9]/g, '-')}`, Dbg_1.Log.global);
+    res = Dbg_1.Log.merge({ margin1: t.margin }, undefined, undefined, res);
     if (Operation.current)
-        res = Dbg_1.Dbg.merge({ margin2: Operation.current.margin }, undefined, undefined, res);
+        res = Dbg_1.Log.merge({ margin2: Operation.current.margin }, undefined, undefined, res);
     if (local)
-        res = Dbg_1.Dbg.merge(local, undefined, undefined, res);
+        res = Dbg_1.Log.merge(local, undefined, undefined, res);
     return res;
 }
 const ORIGINAL_PROMISE_THEN = Promise.prototype.then;

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;