reactronic 0.22.200 → 0.22.201

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

@@ -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]() {
@@ -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/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,8 +107,8 @@ 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.args.length === args.length && op.args.every((t, i) => t === args[i])) ||
@@ -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;
@@ -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,7 +626,7 @@ 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.Snapshot.markUsed = Operation.markUsed;
         Snapshot_1.Snapshot.markEdited = Operation.markEdited;
@@ -622,7 +634,7 @@ class Operation extends Data_1.Observable {
         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 {

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;

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;
@@ -314,7 +314,7 @@ class Dump {
     static obj(h, m, stamp, snapshotId, originSnapshotId, typeless) {
         const member = m !== undefined ? `.${m.toString()}` : '';
         return h === undefined
-            ? `root${member}`
+            ? `boot${member}`
             : stamp === undefined ? `${h.hint}${member} #${h.id}` : `${h.hint}${member} #${h.id}t${snapshotId}v${stamp}${originSnapshotId !== undefined && originSnapshotId !== 0 ? `t${originSnapshotId}` : ''}`;
     }
     static rev2(h, s, m, value) {
@@ -339,7 +339,7 @@ class Dump {
     }
 }
 exports.Dump = Dump;
-exports.ROOT_REV = new Data_1.ObjectRevision(new Snapshot({ hint: 'root-rev' }), undefined, {});
+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.201",
   "description": "Reactronic - Transactional Reactive State Management",
   "main": "build/dist/source/api.js",
   "types": "build/dist/source/api.d.ts",