reactronic 0.22.106 → 0.22.110

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (C) 2016-2021 Yury Chetyrko <ychetyrko@gmail.com>
+Copyright (C) 2016-2022 Yury Chetyrko <ychetyrko@gmail.com>
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -302,29 +302,20 @@ function reaction(proto, prop, pd) // method only
 function cached(proto, prop, pd) // method only
 function options(value: Partial<MemberOptions>): F<any>
 
-function noSideEffects(value: boolean) // transaction & cached & reaction
-function sensitiveArgs(value: boolean) // cached & reaction
-function throttling(milliseconds: number) // reaction only
-function reentrance(value: Reentrance) // transaction & reaction
-function monitor(value: Monitor | null)
-function trace(value: Partial<TraceOptions>)
-
 function nonreactive<T>(func: F<T>, ...args: any[]): T
 function sensitive<T>(sensitivity: Sensitivity, func: F<T>, ...args: any[]): T
 
-// Options, ObjectOptions, Kind, Reentrance, Monitor, TraceOptions, ProfilingOptions
+// SnapshotOptions, MemberOptions, Kind, Reentrance, Monitor, LoggingOptions, ProfilingOptions
 
-interface Options {
-  readonly kind: Kind
-  readonly noSideEffects: boolean
-  readonly sensitiveArgs: boolean
-  readonly throttling: number // milliseconds, -1 is immediately, Number.MAX_SAFE_INTEGER is never
-  readonly reentrance: Reentrance
-  readonly monitor: Monitor | null
-  readonly trace?: Partial<TraceOptions>
+export interface SnapshotOptions {
+  readonly hint?: string
+  readonly standalone?: StandaloneMode
+  readonly journal?: TransactionJournal
+  readonly logging?: Partial<LoggingOptions>
+  readonly token?: any
 }
 
-export interface MemberOptions {
+interface MemberOptions {
   readonly kind: Kind
   readonly standalone: StandaloneMode
   readonly order: number
@@ -334,7 +325,7 @@ export interface MemberOptions {
   readonly reentrance: Reentrance
   readonly journal: TransactionJournal | undefined
   readonly monitor: Monitor | null
-  readonly trace?: Partial<TraceOptions>
+  readonly logging?: Partial<LoggingOptions>
 }
 
 enum Kind {
@@ -375,7 +366,7 @@ interface Worker {
   whenFinished(): Promise<void>
 }
 
-interface TraceOptions {
+interface LoggingOptions {
   readonly silent: boolean
   readonly transaction: boolean
   readonly operation: boolean
@@ -451,12 +442,12 @@ class Reactronic {
   static takeSnapshot<T>(obj: T): T
   static dispose(obj: any): void
   static reactionsAutoStartDisabled: boolean
-  static readonly isTraceEnabled: boolean
-  static readonly traceOptions: TraceOptions
-  static setTraceMode(enabled: boolean, options?: TraceOptions)
-  static setTraceHint<T extends object>(obj: T, name: string | undefined): void
-  static getTraceHint<T extends object>(obj: T): string | undefined
-  static setProfilingMode(enabled: boolean, options?: Partial<ProfilingOptions>): void
+  static readonly isLogging: boolean
+  static readonly loggingOptions: LoggingOptions
+  static setLoggingMode(isOn: boolean, options?: LoggingOptions)
+  static setLoggingHint<T extends object>(obj: T, name: string | undefined): void
+  static getLoggingHint<T extends object>(obj: T): string | undefined
+  static setProfilingMode(isOn: boolean, options?: Partial<ProfilingOptions>): void
 }
 
 ```

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

@@ -1,13 +1,13 @@
-import { TraceOptions } from './Trace';
+import { LoggingOptions } from './Trace';
 import { StandaloneMode } from './impl/Data';
-export { TraceOptions, ProfilingOptions, TraceLevel } from './Trace';
+export { LoggingOptions, ProfilingOptions, LoggingLevel } from './Trace';
 import { TransactionJournal } from './impl/TransactionJournal';
 import { Monitor } from './impl/Monitor';
 export interface SnapshotOptions {
     readonly hint?: string;
     readonly standalone?: StandaloneMode;
     readonly journal?: TransactionJournal;
-    readonly trace?: Partial<TraceOptions>;
+    readonly logging?: Partial<LoggingOptions>;
     readonly token?: any;
 }
 export interface MemberOptions {
@@ -20,7 +20,7 @@ export interface MemberOptions {
     readonly reentrance: Reentrance;
     readonly journal: TransactionJournal | undefined;
     readonly monitor: Monitor | null;
-    readonly trace?: Partial<TraceOptions>;
+    readonly logging?: Partial<LoggingOptions>;
 }
 export declare enum Kind {
     Plain = 0,

package/build/dist/source/Options.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Reentrance = exports.Kind = exports.TraceLevel = void 0;
+exports.Reentrance = exports.Kind = exports.LoggingLevel = void 0;
 var Trace_1 = require("./Trace");
-Object.defineProperty(exports, "TraceLevel", { enumerable: true, get: function () { return Trace_1.TraceLevel; } });
+Object.defineProperty(exports, "LoggingLevel", { enumerable: true, get: function () { return Trace_1.LoggingLevel; } });
 var Kind;
 (function (Kind) {
     Kind[Kind["Plain"] = 0] = "Plain";

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

@@ -1,6 +1,6 @@
 import { F } from './util/Utils';
 import { Controller } from './Controller';
-import { MemberOptions, TraceOptions, ProfilingOptions } from './Options';
+import { MemberOptions, LoggingOptions, ProfilingOptions } from './Options';
 export declare class Rx {
     static why(brief?: boolean): string;
     static getController<T>(method: F<T>): Controller<T>;
@@ -10,12 +10,12 @@ export declare class Rx {
     static dispose(obj: any): void;
     static get reactionsAutoStartDisabled(): boolean;
     static set reactionsAutoStartDisabled(value: boolean);
-    static get isTraceEnabled(): boolean;
-    static get traceOptions(): TraceOptions;
-    static setTraceMode(enabled: boolean, options?: TraceOptions): void;
-    static setTraceHint<T extends object>(obj: T, name: string | undefined): void;
-    static getTraceHint<T extends object>(obj: T, full?: boolean): string | undefined;
-    static setProfilingMode(enabled: boolean, options?: Partial<ProfilingOptions>): void;
+    static get isLogging(): boolean;
+    static get loggingOptions(): LoggingOptions;
+    static setLoggingMode(isOn: boolean, options?: LoggingOptions): void;
+    static setLoggingHint<T extends object>(obj: T, name: string | undefined): void;
+    static getLoggingHint<T extends object>(obj: T, full?: boolean): string | undefined;
+    static setProfilingMode(isOn: boolean, options?: Partial<ProfilingOptions>): void;
 }
 export declare function nonreactive<T>(func: F<T>, ...args: any[]): T;
 export declare function sensitive<T>(sensitivity: boolean, func: F<T>, ...args: any[]): T;

package/build/dist/source/Rx.js

@@ -16,12 +16,12 @@ class Rx {
     static dispose(obj) { Snapshot_1.Snapshot.dispose(obj); }
     static get reactionsAutoStartDisabled() { return Hooks_1.Hooks.reactionsAutoStartDisabled; }
     static set reactionsAutoStartDisabled(value) { Hooks_1.Hooks.reactionsAutoStartDisabled = value; }
-    static get isTraceEnabled() { return Dbg_1.Dbg.isOn; }
-    static get traceOptions() { return Dbg_1.Dbg.trace; }
-    static setTraceMode(enabled, options) { Dbg_1.Dbg.setTraceMode(enabled, options); }
-    static setTraceHint(obj, name) { Hooks_1.Hooks.setHint(obj, name); }
-    static getTraceHint(obj, full = false) { return Data_1.ObjectHolder.getHint(obj, full); }
-    static setProfilingMode(enabled, options) { Hooks_1.Hooks.setProfilingMode(enabled, options); }
+    static get isLogging() { return Dbg_1.Log.isOn; }
+    static get loggingOptions() { return Dbg_1.Log.opt; }
+    static setLoggingMode(isOn, options) { Dbg_1.Log.setMode(isOn, options); }
+    static setLoggingHint(obj, name) { Hooks_1.Hooks.setHint(obj, name); }
+    static getLoggingHint(obj, full = false) { return Data_1.ObjectHolder.getHint(obj, full); }
+    static setProfilingMode(isOn, options) { Hooks_1.Hooks.setProfilingMode(isOn, options); }
 }
 exports.Rx = Rx;
 function nonreactive(func, ...args) {

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

@@ -1,4 +1,4 @@
-export interface TraceOptions {
+export interface LoggingOptions {
     readonly silent: boolean;
     readonly transaction: boolean;
     readonly operation: boolean;
@@ -22,13 +22,13 @@ export interface ProfilingOptions {
     asyncActionDurationWarningThreshold: number;
     garbageCollectionSummaryInterval: number;
 }
-export declare const TraceLevel: {
-    ErrorsOnly: TraceOptions;
-    Reactions: TraceOptions;
-    Transactions: TraceOptions;
-    Operations: TraceOptions;
-    Debug: TraceOptions;
-    Silent: TraceOptions;
+export declare const LoggingLevel: {
+    ErrorsOnly: LoggingOptions;
+    Reactions: LoggingOptions;
+    Transactions: LoggingOptions;
+    Operations: LoggingOptions;
+    Debug: LoggingOptions;
+    Silent: LoggingOptions;
 };
 declare global {
     interface Window {

package/build/dist/source/Trace.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TraceLevel = void 0;
-exports.TraceLevel = {
+exports.LoggingLevel = void 0;
+exports.LoggingLevel = {
     ErrorsOnly: {
         silent: false,
         transaction: false,

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

@@ -2,7 +2,7 @@ export { all, pause } from './util/Utils';
 export { SealedArray } from './util/SealedArray';
 export { SealedMap } from './util/SealedMap';
 export { SealedSet } from './util/SealedSet';
-export { MemberOptions, Kind, Reentrance, TraceOptions, ProfilingOptions, TraceLevel } from './Options';
+export { MemberOptions, SnapshotOptions, Kind, Reentrance, LoggingOptions, ProfilingOptions, LoggingLevel } from './Options';
 export { Worker } from './Worker';
 export { Controller } from './Controller';
 export { Ref, ToggleRef, BoolOnly, GivenTypeOnly } from './Ref';

package/build/dist/source/api.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.options = exports.cached = exports.reaction = exports.transaction = exports.unobservable = exports.sensitive = exports.nonreactive = exports.Rx = exports.TransactionJournal = exports.Monitor = exports.Transaction = exports.Snapshot = exports.ObservableObject = exports.ToggleRef = exports.Ref = exports.Controller = exports.TraceLevel = exports.Reentrance = exports.Kind = exports.SealedSet = exports.SealedMap = exports.SealedArray = exports.pause = exports.all = void 0;
+exports.options = exports.cached = exports.reaction = exports.transaction = exports.unobservable = exports.sensitive = exports.nonreactive = exports.Rx = exports.TransactionJournal = exports.Monitor = exports.Transaction = exports.Snapshot = exports.ObservableObject = exports.ToggleRef = exports.Ref = exports.Controller = exports.LoggingLevel = exports.Reentrance = exports.Kind = exports.SealedSet = exports.SealedMap = exports.SealedArray = exports.pause = exports.all = void 0;
 var Utils_1 = require("./util/Utils");
 Object.defineProperty(exports, "all", { enumerable: true, get: function () { return Utils_1.all; } });
 Object.defineProperty(exports, "pause", { enumerable: true, get: function () { return Utils_1.pause; } });
@@ -13,7 +13,7 @@ Object.defineProperty(exports, "SealedSet", { enumerable: true, get: function ()
 var Options_1 = require("./Options");
 Object.defineProperty(exports, "Kind", { enumerable: true, get: function () { return Options_1.Kind; } });
 Object.defineProperty(exports, "Reentrance", { enumerable: true, get: function () { return Options_1.Reentrance; } });
-Object.defineProperty(exports, "TraceLevel", { enumerable: true, get: function () { return Options_1.TraceLevel; } });
+Object.defineProperty(exports, "LoggingLevel", { enumerable: true, get: function () { return Options_1.LoggingLevel; } });
 var Controller_1 = require("./Controller");
 Object.defineProperty(exports, "Controller", { enumerable: true, get: function () { return Controller_1.Controller; } });
 var Ref_1 = require("./Ref");

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

@@ -18,7 +18,7 @@ class ObjectRevision {
         this.data = data;
         this.changes = new Set();
         this.conflicts = new Map();
-        if (Dbg_1.Dbg.isOn)
+        if (Dbg_1.Log.isOn)
             Object.freeze(this);
     }
 }

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

@@ -1,6 +1,6 @@
 import { F } from '../util/Utils';
 import { MemberOptions, Kind, Reentrance } from '../Options';
-import { TraceOptions, ProfilingOptions } from '../Trace';
+import { LoggingOptions, ProfilingOptions } from '../Trace';
 import { MemberName, ObjectHolder, StandaloneMode } from './Data';
 import { TransactionJournal } from './TransactionJournal';
 import { Monitor } from './Monitor';
@@ -20,7 +20,7 @@ export declare class OptionsImpl implements MemberOptions {
     readonly reentrance: Reentrance;
     readonly journal: TransactionJournal | undefined;
     readonly monitor: Monitor | null;
-    readonly trace?: Partial<TraceOptions>;
+    readonly logging?: Partial<LoggingOptions>;
     static readonly INITIAL: Readonly<OptionsImpl>;
     constructor(getter: Function | undefined, setter: Function | undefined, existing: OptionsImpl, patch: Partial<OptionsImpl>, implicit: boolean);
 }
@@ -42,7 +42,7 @@ export declare class Hooks implements ProxyHandler<ObjectHolder> {
     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 setProfilingMode(enabled: boolean, options?: Partial<ProfilingOptions>): void;
+    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>;

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

@@ -29,7 +29,7 @@ const DEFAULT_OPTIONS = Object.freeze({
     reentrance: Options_1.Reentrance.PreventWithError,
     journal: undefined,
     monitor: null,
-    trace: undefined,
+    logging: undefined,
 });
 class OptionsImpl {
     constructor(getter, setter, existing, patch, implicit) {
@@ -44,8 +44,8 @@ class OptionsImpl {
         this.reentrance = merge(DEFAULT_OPTIONS.reentrance, existing.reentrance, patch.reentrance, implicit);
         this.journal = merge(DEFAULT_OPTIONS.journal, existing.journal, patch.journal, implicit);
         this.monitor = merge(DEFAULT_OPTIONS.monitor, existing.monitor, patch.monitor, implicit);
-        this.trace = merge(DEFAULT_OPTIONS.trace, existing.trace, patch.trace, implicit);
-        if (Dbg_1.Dbg.isOn)
+        this.logging = merge(DEFAULT_OPTIONS.logging, existing.logging, patch.logging, implicit);
+        if (Dbg_1.Log.isOn)
             Object.freeze(this);
     }
 }
@@ -175,7 +175,7 @@ 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.Dbg.isOn)
+            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);
@@ -191,11 +191,11 @@ class Hooks {
                 h.proxy[m][Data_1.Meta.Controller].markObsolete();
         return h;
     }
-    static setProfilingMode(enabled, options) {
-        if (enabled) {
+    static setProfilingMode(isOn, options) {
+        if (isOn) {
             Hooks.repetitiveUsageWarningThreshold = options && options.repetitiveUsageWarningThreshold !== undefined ? options.repetitiveUsageWarningThreshold : 10;
-            Hooks.mainThreadBlockingWarningThreshold = options && options.mainThreadBlockingWarningThreshold !== undefined ? options.mainThreadBlockingWarningThreshold : 16.6;
-            Hooks.asyncActionDurationWarningThreshold = options && options.asyncActionDurationWarningThreshold !== undefined ? options.asyncActionDurationWarningThreshold : 150;
+            Hooks.mainThreadBlockingWarningThreshold = options && options.mainThreadBlockingWarningThreshold !== undefined ? options.mainThreadBlockingWarningThreshold : 14;
+            Hooks.asyncActionDurationWarningThreshold = options && options.asyncActionDurationWarningThreshold !== undefined ? options.asyncActionDurationWarningThreshold : 300;
             Snapshot_1.Snapshot.garbageCollectionSummaryInterval = options && options.garbageCollectionSummaryInterval !== undefined ? options.garbageCollectionSummaryInterval : 100;
         }
         else {

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

@@ -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;
@@ -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;
@@ -71,8 +71,8 @@ class OperationController extends Controller_1.Controller {
         if (!op || op.transaction.isFinished)
             throw (0, Dbg_1.misuse)('a method is expected with reactronic decorator');
         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) {
@@ -139,7 +139,7 @@ class OperationController extends Controller_1.Controller {
         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 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;
@@ -161,22 +161,22 @@ class OperationController extends Controller_1.Controller {
         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);
                 }
             }
@@ -240,15 +240,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 +273,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 +287,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 +328,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 +371,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 +386,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 +401,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 +413,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 +423,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);
             };
@@ -457,8 +457,8 @@ class Operation extends Data_1.Observable {
     }
     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;
@@ -512,7 +512,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 +522,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 +551,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 +571,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;
     }
@@ -615,7 +615,7 @@ class Operation extends Data_1.Observable {
     }
     static init() {
         Object.freeze(ROOT_ARGS);
-        Dbg_1.Dbg.getMergedTraceOptions = getMergedTraceOptions;
+        Dbg_1.Log.getMergedLoggingOptions = getMergedLoggingOptions;
         Snapshot_1.Snapshot.markUsed = Operation.markUsed;
         Snapshot_1.Snapshot.markEdited = Operation.markEdited;
         Snapshot_1.Snapshot.isConflicting = Operation.isConflicting;
@@ -668,14 +668,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.js

@@ -73,8 +73,8 @@ class Snapshot {
                 this.changeset.set(h, r);
                 h.editing = r;
                 h.editors++;
-                if (Dbg_1.Dbg.isOn && Dbg_1.Dbg.trace.write)
-                    Dbg_1.Dbg.log('║', '  ⎘', `${Dump.obj(h)} is cloned`);
+                if (Dbg_1.Log.isOn && Dbg_1.Log.opt.write)
+                    Dbg_1.Log.write('║', '  ⎘', `${Dump.obj(h)} is cloned`);
             }
         }
         else
@@ -117,8 +117,8 @@ class Snapshot {
             Snapshot.pending.push(this);
             if (Snapshot.oldest === undefined)
                 Snapshot.oldest = this;
-            if (Dbg_1.Dbg.isOn && Dbg_1.Dbg.trace.transaction)
-                Dbg_1.Dbg.log('╔══', `v${this.stamp}`, `${this.hint}`);
+            if (Dbg_1.Log.isOn && Dbg_1.Log.opt.transaction)
+                Dbg_1.Log.write('╔══', `v${this.stamp}`, `${this.hint}`);
         }
     }
     bumpBy(timestamp) {
@@ -136,8 +136,8 @@ class Snapshot {
                             conflicts = [];
                         conflicts.push(r);
                     }
-                    if (Dbg_1.Dbg.isOn && Dbg_1.Dbg.trace.transaction)
-                        Dbg_1.Dbg.log('╠╝', '', `${Dump.rev2(h, r.snapshot)} is merged with ${Dump.rev2(h, h.head.snapshot)} among ${merged} properties with ${r.conflicts.size} conflicts.`);
+                    if (Dbg_1.Log.isOn && Dbg_1.Log.opt.transaction)
+                        Dbg_1.Log.write('╠╝', '', `${Dump.rev2(h, r.snapshot)} is merged with ${Dump.rev2(h, h.head.snapshot)} among ${merged} properties with ${r.conflicts.size} conflicts.`);
                 }
             });
             if (this.options.token === undefined) {
@@ -165,8 +165,8 @@ class Snapshot {
             if (headDisposed || m === Data_1.Meta.Disposed) {
                 if (headDisposed !== (m === Data_1.Meta.Disposed)) {
                     if (headDisposed || this.options.standalone !== 'disposal') {
-                        if (Dbg_1.Dbg.isOn && Dbg_1.Dbg.trace.change)
-                            Dbg_1.Dbg.log('║╠', '', `${Dump.rev2(h, ours.snapshot, m)} <> ${Dump.rev2(h, head.snapshot, m)}`, 0, ' *** CONFLICT ***');
+                        if (Dbg_1.Log.isOn && Dbg_1.Log.opt.change)
+                            Dbg_1.Log.write('║╠', '', `${Dump.rev2(h, ours.snapshot, m)} <> ${Dump.rev2(h, head.snapshot, m)}`, 0, ' *** CONFLICT ***');
                         ours.conflicts.set(m, head);
                     }
                 }
@@ -175,8 +175,8 @@ class Snapshot {
                 const conflict = Snapshot.isConflicting(head.data[m], ours.prev.revision.data[m]);
                 if (conflict)
                     ours.conflicts.set(m, head);
-                if (Dbg_1.Dbg.isOn && Dbg_1.Dbg.trace.change)
-                    Dbg_1.Dbg.log('║╠', '', `${Dump.rev2(h, ours.snapshot, m)} ${conflict ? '<>' : '=='} ${Dump.rev2(h, head.snapshot, m)}`, 0, conflict ? ' *** CONFLICT ***' : undefined);
+                if (Dbg_1.Log.isOn && Dbg_1.Log.opt.change)
+                    Dbg_1.Log.write('║╠', '', `${Dump.rev2(h, ours.snapshot, m)} ${conflict ? '<>' : '=='} ${Dump.rev2(h, head.snapshot, m)}`, 0, conflict ? ' *** CONFLICT ***' : undefined);
             }
         });
         Utils_1.Utils.copyAllMembers(merged, ours.data);
@@ -199,17 +199,17 @@ class Snapshot {
                 }
             }
         });
-        if (Dbg_1.Dbg.isOn) {
-            if (Dbg_1.Dbg.trace.change && !error) {
+        if (Dbg_1.Log.isOn) {
+            if (Dbg_1.Log.opt.change && !error) {
                 this.changeset.forEach((r, h) => {
                     const members = [];
                     r.changes.forEach((o, m) => members.push(m.toString()));
                     const s = members.join(', ');
-                    Dbg_1.Dbg.log('║', '√', `${Dump.rev2(h, r.snapshot)} (${s}) is ${r.prev.revision === exports.ROOT_REV ? 'constructed' : `applied on top of ${Dump.rev2(h, r.prev.revision.snapshot)}`}`);
+                    Dbg_1.Log.write('║', '√', `${Dump.rev2(h, r.snapshot)} (${s}) is ${r.prev.revision === exports.ROOT_REV ? 'constructed' : `applied on top of ${Dump.rev2(h, r.prev.revision.snapshot)}`}`);
                 });
             }
-            if (Dbg_1.Dbg.trace.transaction)
-                Dbg_1.Dbg.log(this.stamp < exports.UNDEFINED_TIMESTAMP ? '╚══' : '═══', `v${this.stamp}`, `${this.hint} - ${error ? 'CANCEL' : 'APPLY'}(${this.changeset.size})${error ? ` - ${error}` : ''}`);
+            if (Dbg_1.Log.opt.transaction)
+                Dbg_1.Log.write(this.stamp < exports.UNDEFINED_TIMESTAMP ? '╚══' : '═══', `v${this.stamp}`, `${this.hint} - ${error ? 'CANCEL' : 'APPLY'}(${this.changeset.size})${error ? ` - ${error}` : ''}`);
         }
         if (!error)
             Snapshot.propagateAllChangesThroughSubscriptions(this);
@@ -221,7 +221,7 @@ class Snapshot {
         else
             for (const m in r.prev.revision.data)
                 r.data[m] = Data_1.Meta.Disposed;
-        if (Dbg_1.Dbg.isOn)
+        if (Dbg_1.Log.isOn)
             Snapshot.freezeObjectRevision(r);
     }
     static sealObservable(observable, m, typeName) {
@@ -254,18 +254,18 @@ class Snapshot {
                 Snapshot.oldest = Snapshot.pending[0];
                 const now = Date.now();
                 if (now - Snapshot.lastGarbageCollectionSummaryTimestamp > Snapshot.garbageCollectionSummaryInterval) {
-                    Dbg_1.Dbg.log('', '[G]', `Total object/revision count: ${Snapshot.totalObjectHolderCount}/${Snapshot.totalObjectRevisionCount}`);
+                    Dbg_1.Log.write('', '[G]', `Total object/revision count: ${Snapshot.totalObjectHolderCount}/${Snapshot.totalObjectRevisionCount}`);
                     Snapshot.lastGarbageCollectionSummaryTimestamp = now;
                 }
             }
         }
     }
     unlinkHistory() {
-        if (Dbg_1.Dbg.isOn && Dbg_1.Dbg.trace.gc)
-            Dbg_1.Dbg.log('', '[G]', `Dismiss history below v${this.stamp}t${this.id} (${this.hint})`);
+        if (Dbg_1.Log.isOn && Dbg_1.Log.opt.gc)
+            Dbg_1.Log.write('', '[G]', `Dismiss history below v${this.stamp}t${this.id} (${this.hint})`);
         this.changeset.forEach((r, h) => {
-            if (Dbg_1.Dbg.isOn && Dbg_1.Dbg.trace.gc && r.prev.revision !== exports.ROOT_REV)
-                Dbg_1.Dbg.log(' ', '  ', `${Dump.rev2(h, r.prev.revision.snapshot)} is ready for GC because overwritten by ${Dump.rev2(h, r.snapshot)}`);
+            if (Dbg_1.Log.isOn && Dbg_1.Log.opt.gc && r.prev.revision !== exports.ROOT_REV)
+                Dbg_1.Log.write(' ', '  ', `${Dump.rev2(h, r.prev.revision.snapshot)} is ready for GC because overwritten by ${Dump.rev2(h, r.snapshot)}`);
             if (Snapshot.garbageCollectionSummaryInterval < Number.MAX_SAFE_INTEGER) {
                 if (r.prev.revision !== exports.ROOT_REV)
                     Snapshot.totalObjectRevisionCount--;
@@ -276,7 +276,7 @@ class Snapshot {
         });
         this.changeset = EMPTY_MAP;
         this.reactions = EMPTY_ARRAY;
-        if (Dbg_1.Dbg.isOn)
+        if (Dbg_1.Log.isOn)
             Object.freeze(this);
     }
     static _init() {
@@ -344,6 +344,6 @@ exports.DefaultSnapshotOptions = Object.freeze({
     hint: 'noname',
     standalone: false,
     journal: undefined,
-    trace: undefined,
+    logging: undefined,
     token: undefined,
 });

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

@@ -22,7 +22,7 @@ class Transaction {
     static run(options, func, ...args) { return TransactionImpl.run(options, func, ...args); }
     static standalone(func, ...args) { return TransactionImpl.standalone(func, ...args); }
     static off(func, ...args) { return TransactionImpl.off(func, ...args); }
-    static isFrameOver(everyN = 1, timeLimit = 14) { return TransactionImpl.isFrameOver(everyN, timeLimit); }
+    static isFrameOver(everyN = 1, timeLimit = 10) { return TransactionImpl.isFrameOver(everyN, timeLimit); }
     static requestNextFrame(sleepTime = 0) { return TransactionImpl.requestNextFrame(sleepTime); }
     static get isCanceled() { return TransactionImpl.current.isCanceled; }
 }
@@ -54,8 +54,8 @@ class TransactionImpl extends Transaction {
         const restore = TransactionImpl.inspection;
         try {
             TransactionImpl.inspection = true;
-            if (Dbg_1.Dbg.isOn && Dbg_1.Dbg.trace.transaction)
-                Dbg_1.Dbg.log(' ', ' ', `T${this.id}[${this.hint}] is being inspected by T${TransactionImpl.curr.id}[${TransactionImpl.curr.hint}]`);
+            if (Dbg_1.Log.isOn && Dbg_1.Log.opt.transaction)
+                Dbg_1.Log.write(' ', ' ', `T${this.id}[${this.hint}] is being inspected by T${TransactionImpl.curr.id}[${TransactionImpl.curr.hint}]`);
             return this.runImpl(undefined, func, ...args);
         }
         finally {
@@ -119,7 +119,7 @@ class TransactionImpl extends Transaction {
         const t = TransactionImpl.acquire(options);
         const root = t !== TransactionImpl.curr;
         t.guard();
-        let result = t.runImpl(options === null || options === void 0 ? void 0 : options.trace, func, ...args);
+        let result = t.runImpl(options === null || options === void 0 ? void 0 : options.logging, func, ...args);
         if (root) {
             if (result instanceof Promise) {
                 result = TransactionImpl.off(() => {
@@ -143,7 +143,7 @@ class TransactionImpl extends Transaction {
             TransactionImpl.curr = outer;
         }
     }
-    static isFrameOver(everyN = 1, timeLimit = 14) {
+    static isFrameOver(everyN = 1, timeLimit = 10) {
         TransactionImpl.frameOverCounter++;
         let result = TransactionImpl.frameOverCounter % everyN === 0;
         if (result) {
@@ -181,7 +181,7 @@ class TransactionImpl extends Transaction {
                         const options = {
                             hint: `${this.hint} - restart after T${this.after.id}`,
                             standalone: this.options.standalone === 'isolated' ? 'isolated' : true,
-                            trace: this.snapshot.options.trace,
+                            logging: this.snapshot.options.logging,
                             token: this.snapshot.options.token,
                         };
                         return TransactionImpl.run(options, func, ...args);
@@ -201,7 +201,7 @@ class TransactionImpl extends Transaction {
             return result;
         });
     }
-    runImpl(trace, func, ...args) {
+    runImpl(logging, func, ...args) {
         let result;
         const outer = TransactionImpl.curr;
         try {
@@ -241,10 +241,10 @@ class TransactionImpl extends Transaction {
         if (!t.canceled && error) {
             t.canceled = error;
             t.after = after;
-            if (Dbg_1.Dbg.isOn && Dbg_1.Dbg.trace.transaction) {
-                Dbg_1.Dbg.log('║', ' [!]', `${error.message}`, undefined, ' *** CANCEL ***');
+            if (Dbg_1.Log.isOn && Dbg_1.Log.opt.transaction) {
+                Dbg_1.Log.write('║', ' [!]', `${error.message}`, undefined, ' *** CANCEL ***');
                 if (after && after !== TransactionImpl.none)
-                    Dbg_1.Dbg.log('║', ' [!]', `T${t.id}[${t.hint}] will be restarted${t !== after ? ` after T${after.id}[${after.hint}]` : ''}`);
+                    Dbg_1.Log.write('║', ' [!]', `T${t.id}[${t.hint}] will be restarted${t !== after ? ` after T${after.id}[${after.hint}]` : ''}`);
             }
             Snapshot_1.Snapshot.revokeAllSubscriptions(t.snapshot);
         }
@@ -261,8 +261,8 @@ class TransactionImpl extends Transaction {
     applyOrDiscard() {
         let reactions;
         try {
-            if (Dbg_1.Dbg.isOn && Dbg_1.Dbg.trace.change)
-                Dbg_1.Dbg.log('╠═', '', '', undefined, 'changes');
+            if (Dbg_1.Log.isOn && Dbg_1.Log.opt.change)
+                Dbg_1.Log.write('╠═', '', '', undefined, 'changes');
             reactions = this.snapshot.applyOrDiscard(this.canceled);
             this.snapshot.triggerGarbageCollection();
             if (this.promise) {
@@ -271,7 +271,7 @@ class TransactionImpl extends Transaction {
                 else
                     this.resolve();
             }
-            if (Dbg_1.Dbg.isOn)
+            if (Dbg_1.Log.isOn)
                 Object.freeze(this);
         }
         catch (e) {

package/build/dist/source/util/Dbg.d.ts

@@ -1,15 +1,15 @@
-import { TraceOptions } from '../Trace';
+import { LoggingOptions } from '../Trace';
 export declare function error(message: string, dump: Error | undefined): Error;
 export declare function misuse(message: string, dump?: any): Error;
 export declare function fatal(error: Error): Error;
-export declare class Dbg {
-    static DefaultLevel: TraceOptions;
+export declare class Log {
+    static DefaultLevel: LoggingOptions;
     static isOn: boolean;
-    static global: TraceOptions;
-    static get trace(): TraceOptions;
-    static getMergedTraceOptions: (local: Partial<TraceOptions> | undefined) => TraceOptions;
-    static setTraceMode(enabled: boolean, options?: TraceOptions): void;
-    static log(bar: string, tran: string, message: string, ms?: number, highlight?: string | undefined, dump?: any): void;
-    static logAs(options: Partial<TraceOptions> | undefined, bar: string, tran: string, message: string, ms?: number, highlight?: string | undefined, dump?: any): void;
-    static merge(t: Partial<TraceOptions> | undefined, color: number | undefined, prefix: string | undefined, existing: TraceOptions): TraceOptions;
+    static global: LoggingOptions;
+    static get opt(): LoggingOptions;
+    static getMergedLoggingOptions: (local: Partial<LoggingOptions> | undefined) => LoggingOptions;
+    static setMode(isOn: boolean, options?: LoggingOptions): void;
+    static write(bar: string, tran: string, message: string, ms?: number, highlight?: string | undefined, dump?: any): void;
+    static writeAs(options: Partial<LoggingOptions> | undefined, bar: string, tran: string, message: string, ms?: number, highlight?: string | undefined, dump?: any): void;
+    static merge(t: Partial<LoggingOptions> | undefined, color: number | undefined, prefix: string | undefined, existing: LoggingOptions): LoggingOptions;
 }

package/build/dist/source/util/Dbg.js

@@ -1,42 +1,42 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Dbg = exports.fatal = exports.misuse = exports.error = void 0;
+exports.Log = exports.fatal = exports.misuse = exports.error = void 0;
 function error(message, dump) {
-    if (Dbg.isOn && Dbg.trace.error)
-        Dbg.log('█', ' ███', message, undefined, ' *** ERROR ***', dump);
+    if (Log.isOn && Log.opt.error)
+        Log.write('█', ' ███', message, undefined, ' *** ERROR ***', dump);
     return new Error(message);
 }
 exports.error = error;
 function misuse(message, dump) {
     const error = new Error(message);
-    Dbg.log(' ', ' ███', message, undefined, ' *** ERROR / MISUSE ***', dump !== null && dump !== void 0 ? dump : error);
+    Log.write(' ', ' ███', message, undefined, ' *** ERROR / MISUSE ***', dump !== null && dump !== void 0 ? dump : error);
     return error;
 }
 exports.misuse = misuse;
 function fatal(error) {
-    Dbg.log(' ', ' ███', error.message, undefined, ' *** FATAL ***', error);
+    Log.write(' ', ' ███', error.message, undefined, ' *** FATAL ***', error);
     return error;
 }
 exports.fatal = fatal;
-class Dbg {
-    static get trace() { return this.getMergedTraceOptions(undefined); }
-    static setTraceMode(enabled, options) {
-        Dbg.isOn = enabled;
-        Dbg.global = options || Dbg.DefaultLevel;
-        if (enabled) {
-            const t = Dbg.global;
-            const o = Object.keys(Dbg.global).filter(x => t[x] === true).join(', ');
-            Dbg.log('', '', `Reactronic trace is enabled: ${o}`);
-            Dbg.log('', '', 'Method-level trace can be configured with @options({ trace: ... }) decorator');
+class Log {
+    static get opt() { return this.getMergedLoggingOptions(undefined); }
+    static setMode(isOn, options) {
+        Log.global = options || Log.DefaultLevel;
+        if (isOn) {
+            const t = Log.global;
+            const o = Object.keys(Log.global).filter(x => t[x] === true).join(', ');
+            Log.write('', '', `Reactronic logging is turned on: ${o}`);
+            Log.write('', '', 'Member-level logging can be configured with @options({ logging: ... }) decorator');
         }
-        else
-            Dbg.log('', '', 'Reactronic trace is disabled');
+        else if (Log.isOn)
+            Log.write('', '', 'Reactronic logging is turned off');
+        Log.isOn = isOn;
     }
-    static log(bar, tran, message, ms = 0, highlight = undefined, dump) {
-        Dbg.logAs(undefined, bar, tran, message, ms, highlight, dump);
+    static write(bar, tran, message, ms = 0, highlight = undefined, dump) {
+        Log.writeAs(undefined, bar, tran, message, ms, highlight, dump);
     }
-    static logAs(options, bar, tran, message, ms = 0, highlight = undefined, dump) {
-        const t = Dbg.getMergedTraceOptions(options);
+    static writeAs(options, bar, tran, message, ms = 0, highlight = undefined, dump) {
+        const t = Log.getMergedLoggingOptions(options);
         const margin1 = '  '.repeat(t.margin1 >= 0 ? t.margin1 : 0);
         const margin2 = '  '.repeat(t.margin2);
         const silent = (options && options.silent !== undefined) ? options.silent : t.silent;
@@ -72,8 +72,8 @@ class Dbg {
         return result;
     }
 }
-exports.Dbg = Dbg;
-Dbg.DefaultLevel = {
+exports.Log = Log;
+Log.DefaultLevel = {
     silent: false,
     error: false,
     warning: false,
@@ -91,6 +91,6 @@ Dbg.DefaultLevel = {
     margin1: 0,
     margin2: 0,
 };
-Dbg.isOn = false;
-Dbg.global = Dbg.DefaultLevel;
-Dbg.getMergedTraceOptions = (local) => Dbg.global;
+Log.isOn = false;
+Log.global = Log.DefaultLevel;
+Log.getMergedLoggingOptions = (local) => Log.global;

package/build/dist/source/util/Sealant.js

@@ -8,8 +8,8 @@ class Sealant {
         const createCopy = result[Sealant.CreateCopy];
         if (createCopy)
             result = createCopy.call(result);
-        if (Dbg_1.Dbg.isOn && Dbg_1.Dbg.trace.write)
-            Dbg_1.Dbg.log('║', ' ', `${typeName}.${member.toString()} - collection is sealed`);
+        if (Dbg_1.Log.isOn && Dbg_1.Log.opt.write)
+            Dbg_1.Log.write('║', ' ', `${typeName}.${member.toString()} - collection is sealed`);
         Object.setPrototypeOf(result, sealedType);
         Object.freeze(result);
         return result;

package/package.json

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