reactronic 0.21.514 → 0.21.518

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

@@ -34,8 +34,3 @@ export declare enum Reentrance {
     OverwritePrevious = -3,
     RunSideBySide = -4
 }
-export declare enum Sensitivity {
-    ReactOnFinalDifferenceOnly = 0,
-    ReactOnFinalAndIntermediateDifference = 1,
-    ReactEvenOnSameValueAssignment = 2
-}

package/build/dist/source/Options.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Sensitivity = exports.Reentrance = exports.Kind = exports.TraceLevel = void 0;
+exports.Reentrance = exports.Kind = exports.TraceLevel = void 0;
 var Trace_1 = require("./Trace");
 Object.defineProperty(exports, "TraceLevel", { enumerable: true, get: function () { return Trace_1.TraceLevel; } });
 var Kind;
@@ -19,9 +19,3 @@ var Reentrance;
     Reentrance[Reentrance["OverwritePrevious"] = -3] = "OverwritePrevious";
     Reentrance[Reentrance["RunSideBySide"] = -4] = "RunSideBySide";
 })(Reentrance = exports.Reentrance || (exports.Reentrance = {}));
-var Sensitivity;
-(function (Sensitivity) {
-    Sensitivity[Sensitivity["ReactOnFinalDifferenceOnly"] = 0] = "ReactOnFinalDifferenceOnly";
-    Sensitivity[Sensitivity["ReactOnFinalAndIntermediateDifference"] = 1] = "ReactOnFinalAndIntermediateDifference";
-    Sensitivity[Sensitivity["ReactEvenOnSameValueAssignment"] = 2] = "ReactEvenOnSameValueAssignment";
-})(Sensitivity = exports.Sensitivity || (exports.Sensitivity = {}));

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

@@ -1,6 +1,6 @@
 import { F } from './util/Utils';
 import { Controller } from './Controller';
-import { MemberOptions, TraceOptions, ProfilingOptions, Sensitivity } from './Options';
+import { MemberOptions, TraceOptions, ProfilingOptions } from './Options';
 export declare class Reactronic {
     static why(brief?: boolean): string;
     static getController<T>(method: F<T>): Controller<T>;
@@ -19,7 +19,7 @@ export declare class Reactronic {
 }
 export declare function nonreactive<T>(func: F<T>, ...args: any[]): T;
 export declare function standalone<T>(func: F<T>, ...args: any[]): T;
-export declare function sensitive<T>(sensitivity: Sensitivity, func: F<T>, ...args: any[]): T;
+export declare function sensitive<T>(sensitivity: boolean, func: F<T>, ...args: any[]): T;
 export declare function unobservable(proto: object, prop: PropertyKey): any;
 export declare function transaction(proto: object, prop: PropertyKey, pd: PropertyDescriptor): any;
 export declare function reaction(proto: object, prop: PropertyKey, pd: PropertyDescriptor): any;

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

@@ -24,10 +24,10 @@ export interface ProfilingOptions {
 }
 export declare const TraceLevel: {
     Error: TraceOptions;
-    Minimal: TraceOptions;
-    Info: TraceOptions;
+    Transactions: TraceOptions;
+    Operations: TraceOptions;
     Debug: TraceOptions;
-    Suppress: TraceOptions;
+    Silent: TraceOptions;
 };
 declare global {
     interface Window {

package/build/dist/source/Trace.js

@@ -20,7 +20,7 @@ exports.TraceLevel = {
         margin1: 0,
         margin2: 0,
     },
-    Minimal: {
+    Transactions: {
         silent: false,
         transaction: true,
         operation: false,
@@ -38,7 +38,7 @@ exports.TraceLevel = {
         margin1: 0,
         margin2: 0,
     },
-    Info: {
+    Operations: {
         silent: false,
         transaction: true,
         operation: true,
@@ -74,7 +74,7 @@ exports.TraceLevel = {
         margin1: 0,
         margin2: 0,
     },
-    Suppress: {
+    Silent: {
         silent: true,
         transaction: false,
         operation: false,

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

@@ -2,7 +2,7 @@ export { all, sleep } from './util/Utils';
 export { SealedArray } from './util/SealedArray';
 export { SealedMap } from './util/SealedMap';
 export { SealedSet } from './util/SealedSet';
-export { MemberOptions, Kind, Reentrance, Sensitivity, TraceOptions, ProfilingOptions, TraceLevel } from './Options';
+export { MemberOptions, Kind, Reentrance, TraceOptions, ProfilingOptions, TraceLevel } 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.standalone = exports.nonreactive = exports.Reactronic = exports.TransactionJournal = exports.Monitor = exports.Transaction = exports.Snapshot = exports.ObservableObject = exports.ToggleRef = exports.Ref = exports.Controller = exports.TraceLevel = exports.Sensitivity = exports.Reentrance = exports.Kind = exports.SealedSet = exports.SealedMap = exports.SealedArray = exports.sleep = exports.all = void 0;
+exports.options = exports.cached = exports.reaction = exports.transaction = exports.unobservable = exports.sensitive = exports.standalone = exports.nonreactive = exports.Reactronic = 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.sleep = 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, "sleep", { enumerable: true, get: function () { return Utils_1.sleep; } });
@@ -13,7 +13,6 @@ 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, "Sensitivity", { enumerable: true, get: function () { return Options_1.Sensitivity; } });
 Object.defineProperty(exports, "TraceLevel", { enumerable: true, get: function () { return Options_1.TraceLevel; } });
 var Controller_1 = require("./Controller");
 Object.defineProperty(exports, "Controller", { enumerable: true, get: function () { return Controller_1.Controller; } });

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

@@ -1,5 +1,5 @@
 import { F } from '../util/Utils';
-import { MemberOptions, Kind, Reentrance, Sensitivity } from '../Options';
+import { MemberOptions, Kind, Reentrance } from '../Options';
 import { TraceOptions, ProfilingOptions } from '../Trace';
 import { MemberName, ObjectHolder } from './Data';
 import { TransactionJournal } from './TransactionJournal';
@@ -28,7 +28,7 @@ export declare class Hooks implements ProxyHandler<ObjectHolder> {
     static repetitiveUsageWarningThreshold: number;
     static mainThreadBlockingWarningThreshold: number;
     static asyncActionDurationWarningThreshold: number;
-    static sensitivity: Sensitivity;
+    static sensitivity: boolean;
     static readonly proxy: Hooks;
     getPrototypeOf(h: ObjectHolder): object | null;
     get(h: ObjectHolder, m: MemberName, receiver: any): any;
@@ -42,7 +42,7 @@ export declare class Hooks implements ProxyHandler<ObjectHolder> {
     static acquireObjectHolder(obj: any): ObjectHolder;
     static createObjectHolder(unobservable: any, blank: any, hint: string): ObjectHolder;
     static setProfilingMode(enabled: boolean, options?: Partial<ProfilingOptions>): void;
-    static sensitive<T>(sensitivity: Sensitivity, func: F<T>, ...args: any[]): T;
+    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 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

@@ -78,24 +78,18 @@ class Hooks {
     set(h, m, value, receiver) {
         const r = Snapshot_1.Snapshot.edit().getEditableRevision(h, m, value);
         if (r !== Snapshot_1.ROOT_REV) {
-            const curr = r.data[m];
-            if (curr !== undefined || (r.prev.revision.snapshot === Snapshot_1.ROOT_REV.snapshot && m in h.unobservable === false)) {
-                const prev = r.prev.revision.data[m];
-                let edited = prev === undefined || prev.value !== value ||
-                    Hooks.sensitivity === Options_1.Sensitivity.ReactEvenOnSameValueAssignment;
-                if (edited) {
-                    if (prev === curr)
-                        r.data[m] = new Data_1.Observable(value);
-                    else
+            let curr = r.data[m];
+            if (curr !== undefined || (r.prev.revision.snapshot === Snapshot_1.ROOT_REV.snapshot && (m in h.unobservable) === false)) {
+                if (curr === undefined || curr.value !== value || Hooks.sensitivity) {
+                    if (r.prev.revision.data[m] === curr) {
+                        curr = r.data[m] = new Data_1.Observable(value);
+                        Snapshot_1.Snapshot.markEdited(value, true, r, m, h);
+                    }
+                    else {
                         curr.value = value;
+                        Snapshot_1.Snapshot.markEdited(value, true, r, m, h);
+                    }
                 }
-                else if (prev !== curr) {
-                    if (Hooks.sensitivity === Options_1.Sensitivity.ReactOnFinalDifferenceOnly)
-                        r.data[m] = prev;
-                    else
-                        edited = true;
-                }
-                Snapshot_1.Snapshot.markEdited(value, edited, r, m, h);
             }
             else
                 Reflect.set(h.unobservable, m, value, receiver);
@@ -233,7 +227,7 @@ Hooks.reactionsAutoStartDisabled = false;
 Hooks.repetitiveUsageWarningThreshold = Number.MAX_SAFE_INTEGER;
 Hooks.mainThreadBlockingWarningThreshold = Number.MAX_SAFE_INTEGER;
 Hooks.asyncActionDurationWarningThreshold = Number.MAX_SAFE_INTEGER;
-Hooks.sensitivity = Options_1.Sensitivity.ReactOnFinalDifferenceOnly;
+Hooks.sensitivity = false;
 Hooks.proxy = new Hooks();
 Hooks.createControllerAndGetHook = function (h, m, options) {
     throw (0, Dbg_1.misuse)('createControllerAndGetHook should never be called');

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

@@ -12,7 +12,7 @@ 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 ROOT_CAUSE = { revision: Snapshot_1.ROOT_REV, memberName: 'root-cause', usageCount: 0 };
+const ROOT_TRIGGER = { revision: Snapshot_1.ROOT_REV, memberName: 'root-trigger', usageCount: 0 };
 class OperationController extends Controller_1.Controller {
     constructor(ownHolder, memberName) {
         super();
@@ -35,7 +35,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 === ROOT_CAUSE || !op.successor ||
+            && (!weak || op.cause === ROOT_TRIGGER || !op.successor ||
                 op.successor.transaction.isFinished)) {
             const standalone = weak || opts.kind === Options_1.Kind.Reaction ||
                 (opts.kind === Options_1.Kind.Cache && (oc.revision.snapshot.sealed ||
@@ -69,7 +69,7 @@ class OperationController extends Controller_1.Controller {
             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 = ...`);
+            Dbg_1.Dbg.log('║', '  ✎', `${op.hint()}.options = ...`);
         return op.options;
     }
     static runWithin(op, func, ...args) {
@@ -105,7 +105,7 @@ class OperationController extends Controller_1.Controller {
         const ctx = Snapshot_1.Snapshot.current();
         const r = ctx.seekRevision(this.ownHolder, this.memberName);
         const op = this.peekFromRevision(r);
-        const isValid = op.options.kind !== Options_1.Kind.Transaction && op.cause !== ROOT_CAUSE &&
+        const isValid = op.options.kind !== Options_1.Kind.Transaction && op.cause !== ROOT_TRIGGER &&
             (ctx === op.revision.snapshot || ctx.timestamp < op.obsoleteSince) &&
             (!op.options.sensitiveArgs || args === undefined ||
                 op.args.length === args.length && op.args.every((t, i) => t === args[i])) ||
@@ -144,7 +144,7 @@ class OperationController extends Controller_1.Controller {
                 if (op2.controller !== this) {
                     r2 = Snapshot_1.Snapshot.edit().getEditableRevision(h, m, Data_1.Meta.Holder, this);
                     op2 = r2.data[m] = new Operation(this, r2, op2);
-                    op2.cause = ROOT_CAUSE;
+                    op2.cause = ROOT_TRIGGER;
                     Snapshot_1.Snapshot.markEdited(op2, true, r2, m, h);
                 }
                 return op2;
@@ -160,7 +160,7 @@ class OperationController extends Controller_1.Controller {
             if (!oc.operation.transaction.isCanceled) {
                 oc = this.edit();
                 if (Dbg_1.Dbg.isOn && (Dbg_1.Dbg.trace.transaction || Dbg_1.Dbg.trace.operation || Dbg_1.Dbg.trace.obsolete))
-                    Dbg_1.Dbg.log('║', ' (f)', `${oc.operation.why()}`);
+                    Dbg_1.Dbg.log('║', '  𝑓', `${oc.operation.why()}`);
                 oc.operation.run(this.ownHolder.proxy, argsx);
             }
             else {
@@ -168,7 +168,7 @@ class OperationController extends Controller_1.Controller {
                 if (oc.operation.options.kind === Options_1.Kind.Transaction || !oc.isUpToDate) {
                     oc = this.edit();
                     if (Dbg_1.Dbg.isOn && (Dbg_1.Dbg.trace.transaction || Dbg_1.Dbg.trace.operation || Dbg_1.Dbg.trace.obsolete))
-                        Dbg_1.Dbg.log('║', ' (f)', `${oc.operation.why()}`);
+                        Dbg_1.Dbg.log('║', '  𝑓', `${oc.operation.why()}`);
                     oc.operation.run(this.ownHolder.proxy, argsx);
                 }
             }
@@ -215,14 +215,14 @@ class Operation extends Data_1.Observable {
         const prev = this.revision.prev.revision.data[this.controller.memberName];
         if (prev instanceof Operation)
             ms = prev.started !== 0 ? Math.abs(this.started || ms) - Math.abs(prev.started) : Infinity;
-        let cause;
+        let trigger;
         if (this.cause)
-            cause = `   <<   ${propagationHint(this.cause, true).join('   <<   ')}`;
+            trigger = `   <<   ${propagationHint(this.cause, true).join('   <<   ')}`;
         else if (this.controller.options.kind === Options_1.Kind.Transaction)
-            cause = '   <<   operation';
+            trigger = '   <<   operation';
         else
-            cause = `   <<   called within ${this.revision.snapshot.hint}`;
-        return `${this.hint()}${cause}   (${ms !== Infinity ? `${ms}ms since previous run` : 'initial run'})`;
+            trigger = `   <<   called within ${this.revision.snapshot.hint}`;
+        return `${this.hint()}${trigger}   (${ms !== Infinity ? `${ms}ms since previous run` : 'initial run'})`;
     }
     briefWhy() {
         return this.cause ? propagationHint(this.cause, false)[0] : ROOT_HOLDER.hint;
@@ -443,12 +443,12 @@ class Operation extends Data_1.Observable {
     static markEdited(value, edited, r, m, h) {
         edited ? r.changes.set(m, Operation.current) : r.changes.delete(m);
         if (Dbg_1.Dbg.isOn && Dbg_1.Dbg.trace.write)
-            edited ? Dbg_1.Dbg.log('║', '  ♦', `${Snapshot_1.Dump.rev(r, m)} = ${valueHint(value)}`) : Dbg_1.Dbg.log('║', '  ♦', `${Snapshot_1.Dump.rev(r, m)} = ${valueHint(value)}`, undefined, ' (same as previous)');
+            edited ? Dbg_1.Dbg.log('║', '  ✎', `${Snapshot_1.Dump.rev(r, m)} = ${valueHint(value)}`) : Dbg_1.Dbg.log('║', '  ✎', `${Snapshot_1.Dump.rev(r, m)} = ${valueHint(value)}`, undefined, ' (same as previous)');
     }
     static isConflicting(oldValue, newValue) {
         let result = oldValue !== newValue;
         if (result)
-            result = oldValue instanceof Operation && oldValue.cause !== ROOT_CAUSE;
+            result = oldValue instanceof Operation && oldValue.cause !== ROOT_TRIGGER;
         return result;
     }
     static propagateAllChangesThroughSubscriptions(snapshot) {
@@ -569,7 +569,7 @@ class Operation extends Data_1.Observable {
     }
     static init() {
         Object.freeze(ROOT_ARGS);
-        Object.freeze(ROOT_CAUSE);
+        Object.freeze(ROOT_TRIGGER);
         Dbg_1.Dbg.getMergedTraceOptions = getMergedTraceOptions;
         Snapshot_1.Snapshot.markUsed = Operation.markUsed;
         Snapshot_1.Snapshot.markEdited = Operation.markEdited;

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

@@ -27,7 +27,7 @@ class Dbg {
             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 @trace decorator');
+            Dbg.log('', '', 'Method-level trace can be configured with @options({ trace: ... }) decorator');
         }
         else
             Dbg.log('', '', 'Reactronic trace is disabled');

package/package.json

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