reactronic 0.21.513 → 0.21.514

package/README.md

@@ -240,7 +240,7 @@ to a new one.
 
 There are multiple options to configure behavior of transactional reactivity.
 
-**Priority** options defines order of reactions execution:
+**Order** options defines order of reactions execution:
 
   - (TBD)
 
@@ -302,7 +302,7 @@ function reaction(proto, prop, pd) // method only
 function cached(proto, prop, pd) // method only
 
 function noSideEffects(value: boolean) // transaction & cached & reaction
-function observableArgs(value: boolean) // 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)

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

@@ -11,7 +11,7 @@ export interface SnapshotOptions {
 }
 export interface MemberOptions {
     readonly kind: Kind;
-    readonly priority: number;
+    readonly order: number;
     readonly noSideEffects: boolean;
     readonly sensitiveArgs: boolean;
     readonly throttling: number;

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

@@ -1,8 +1,6 @@
 import { F } from './util/Utils';
 import { Controller } from './Controller';
-import { Reentrance, MemberOptions, TraceOptions, ProfilingOptions, Sensitivity } from './Options';
-import { TransactionJournal } from './impl/TransactionJournal';
-import { Monitor } from './impl/Monitor';
+import { MemberOptions, TraceOptions, ProfilingOptions, Sensitivity } from './Options';
 export declare class Reactronic {
     static why(brief?: boolean): string;
     static getController<T>(method: F<T>): Controller<T>;
@@ -26,11 +24,4 @@ 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;
 export declare function cached(proto: object, prop: PropertyKey, pd: PropertyDescriptor): any;
-export declare function priority(value: number): F<any>;
-export declare function noSideEffects(value: boolean): F<any>;
-export declare function observableArgs(value: boolean): F<any>;
-export declare function throttling(milliseconds: number): F<any>;
-export declare function reentrance(value: Reentrance): F<any>;
-export declare function journal(value: TransactionJournal | undefined): F<any>;
-export declare function monitor(value: Monitor | null): F<any>;
-export declare function trace(value: Partial<TraceOptions>): F<any>;
+export declare function options(value: Partial<MemberOptions>): F<any>;

package/build/dist/source/Reactronic.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.trace = exports.monitor = exports.journal = exports.reentrance = exports.throttling = exports.observableArgs = exports.noSideEffects = exports.priority = exports.cached = exports.reaction = exports.transaction = exports.unobservable = exports.sensitive = exports.standalone = exports.nonreactive = exports.Reactronic = void 0;
+exports.options = exports.cached = exports.reaction = exports.transaction = exports.unobservable = exports.sensitive = exports.standalone = exports.nonreactive = exports.Reactronic = void 0;
 const Dbg_1 = require("./util/Dbg");
 const Options_1 = require("./Options");
 const Data_1 = require("./impl/Data");
@@ -56,35 +56,7 @@ function cached(proto, prop, pd) {
     return Hooks_1.Hooks.decorateOperation(true, cached, opts, proto, prop, pd);
 }
 exports.cached = cached;
-function priority(value) {
-    return Hooks_1.Hooks.decorateOperationParametrized(priority, { priority: value });
+function options(value) {
+    return Hooks_1.Hooks.decorateOperationParametrized(options, value);
 }
-exports.priority = priority;
-function noSideEffects(value) {
-    return Hooks_1.Hooks.decorateOperationParametrized(noSideEffects, { noSideEffects: value });
-}
-exports.noSideEffects = noSideEffects;
-function observableArgs(value) {
-    return Hooks_1.Hooks.decorateOperationParametrized(observableArgs, { sensitiveArgs: value });
-}
-exports.observableArgs = observableArgs;
-function throttling(milliseconds) {
-    return Hooks_1.Hooks.decorateOperationParametrized(throttling, { throttling: milliseconds });
-}
-exports.throttling = throttling;
-function reentrance(value) {
-    return Hooks_1.Hooks.decorateOperationParametrized(reentrance, { reentrance: value });
-}
-exports.reentrance = reentrance;
-function journal(value) {
-    return Hooks_1.Hooks.decorateOperationParametrized(journal, { journal: value });
-}
-exports.journal = journal;
-function monitor(value) {
-    return Hooks_1.Hooks.decorateOperationParametrized(monitor, { monitor: value });
-}
-exports.monitor = monitor;
-function trace(value) {
-    return Hooks_1.Hooks.decorateOperationParametrized(trace, { trace: value });
-}
-exports.trace = trace;
+exports.options = options;

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

@@ -11,4 +11,4 @@ export { Snapshot } from './impl/Snapshot';
 export { Transaction } from './impl/Transaction';
 export { Monitor } from './impl/Monitor';
 export { TransactionJournal } from './impl/TransactionJournal';
-export { Reactronic, nonreactive, standalone, sensitive, unobservable, transaction, reaction, cached, priority, noSideEffects, observableArgs, throttling, reentrance, journal, monitor, trace } from './Reactronic';
+export { Reactronic, nonreactive, standalone, sensitive, unobservable, transaction, reaction, cached, options } from './Reactronic';

package/build/dist/source/api.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.trace = exports.monitor = exports.journal = exports.reentrance = exports.throttling = exports.observableArgs = exports.noSideEffects = exports.priority = 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.Sensitivity = 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; } });
@@ -39,11 +39,4 @@ Object.defineProperty(exports, "unobservable", { enumerable: true, get: function
 Object.defineProperty(exports, "transaction", { enumerable: true, get: function () { return Reactronic_1.transaction; } });
 Object.defineProperty(exports, "reaction", { enumerable: true, get: function () { return Reactronic_1.reaction; } });
 Object.defineProperty(exports, "cached", { enumerable: true, get: function () { return Reactronic_1.cached; } });
-Object.defineProperty(exports, "priority", { enumerable: true, get: function () { return Reactronic_1.priority; } });
-Object.defineProperty(exports, "noSideEffects", { enumerable: true, get: function () { return Reactronic_1.noSideEffects; } });
-Object.defineProperty(exports, "observableArgs", { enumerable: true, get: function () { return Reactronic_1.observableArgs; } });
-Object.defineProperty(exports, "throttling", { enumerable: true, get: function () { return Reactronic_1.throttling; } });
-Object.defineProperty(exports, "reentrance", { enumerable: true, get: function () { return Reactronic_1.reentrance; } });
-Object.defineProperty(exports, "journal", { enumerable: true, get: function () { return Reactronic_1.journal; } });
-Object.defineProperty(exports, "monitor", { enumerable: true, get: function () { return Reactronic_1.monitor; } });
-Object.defineProperty(exports, "trace", { enumerable: true, get: function () { return Reactronic_1.trace; } });
+Object.defineProperty(exports, "options", { enumerable: true, get: function () { return Reactronic_1.options; } });

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

@@ -12,7 +12,7 @@ export declare class Observable {
     constructor(value: any);
 }
 export interface Observer {
-    readonly priority: number;
+    readonly order: number;
     readonly observables: Map<Observable, MemberInfo> | undefined;
     readonly obsoleteSince: number;
     hint(nop?: boolean): string;

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

@@ -12,7 +12,7 @@ export declare class OptionsImpl implements MemberOptions {
     readonly getter: Function;
     readonly setter: Function;
     readonly kind: Kind;
-    readonly priority: number;
+    readonly order: number;
     readonly noSideEffects: boolean;
     readonly sensitiveArgs: boolean;
     readonly throttling: number;

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

@@ -26,7 +26,7 @@ class ObservableObject {
 exports.ObservableObject = ObservableObject;
 const DEFAULT_OPTIONS = Object.freeze({
     kind: Options_1.Kind.Plain,
-    priority: 0,
+    order: 0,
     noSideEffects: false,
     sensitiveArgs: false,
     throttling: Number.MAX_SAFE_INTEGER,
@@ -40,7 +40,7 @@ class OptionsImpl {
         this.getter = getter !== undefined ? getter : existing.getter;
         this.setter = setter !== undefined ? setter : existing.setter;
         this.kind = merge(DEFAULT_OPTIONS.kind, existing.kind, patch.kind, implicit);
-        this.priority = merge(DEFAULT_OPTIONS.priority, existing.priority, patch.priority, implicit);
+        this.order = merge(DEFAULT_OPTIONS.order, existing.order, patch.order, implicit);
         this.noSideEffects = merge(DEFAULT_OPTIONS.noSideEffects, existing.noSideEffects, patch.noSideEffects, implicit);
         this.sensitiveArgs = merge(DEFAULT_OPTIONS.sensitiveArgs, existing.sensitiveArgs, patch.sensitiveArgs, implicit);
         this.throttling = merge(DEFAULT_OPTIONS.throttling, existing.throttling, patch.throttling, implicit);

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

@@ -52,7 +52,7 @@ declare class Operation extends Observable implements Observer {
     constructor(controller: OperationController, revision: ObjectRevision, prev: Operation | OptionsImpl);
     get isOperation(): boolean;
     hint(): string;
-    get priority(): number;
+    get order(): number;
     why(): string;
     briefWhy(): string;
     dependencies(): string[];

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

@@ -209,7 +209,7 @@ class Operation extends Data_1.Observable {
     }
     get isOperation() { return true; }
     hint() { return `${Snapshot_1.Dump.rev(this.revision, this.controller.memberName)}`; }
-    get priority() { return this.options.priority; }
+    get order() { return this.options.order; }
     why() {
         let ms = Date.now();
         const prev = this.revision.prev.revision.data[this.controller.memberName];
@@ -264,8 +264,8 @@ class Operation extends Data_1.Observable {
                 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 && cause.revision === Snapshot_1.ROOT_REV
-                        ? `${this.hint()} is a reaction and will run automatically (priority ${this.options.priority})`
-                        : `${this.hint()} is obsolete due to ${Snapshot_1.Dump.rev(cause.revision, cause.memberName)} since v${since}${isReaction ? ` and will run automatically (priority ${this.options.priority})` : ''}`);
+                        ? `${this.hint()} is a reaction and will run automatically (order ${this.options.order})`
+                        : `${this.hint()} is obsolete due to ${Snapshot_1.Dump.rev(cause.revision, cause.memberName)} since v${since}${isReaction ? ` and will run automatically (order ${this.options.order})` : ''}`);
                 if (isReaction)
                     reactions.push(this);
                 else
@@ -462,7 +462,7 @@ class Operation extends Data_1.Observable {
                 for (const m in r.prev.revision.data)
                     Operation.propagateMemberChangeThroughSubscriptions(true, since, r, m, h, reactions);
         });
-        reactions.sort(compareReactionsByPriority);
+        reactions.sort(compareReactionsByOrder);
         (_a = snapshot.options.journal) === null || _a === void 0 ? void 0 : _a.remember(TransactionJournal_1.TransactionJournalImpl.createPatch(snapshot.hint, snapshot.changeset));
     }
     static revokeAllSubscriptions(snapshot) {
@@ -661,8 +661,8 @@ function reactronicHookedThen(resolve, reject) {
     }
     return ORIGINAL_PROMISE_THEN.call(this, resolve, reject);
 }
-function compareReactionsByPriority(a, b) {
-    return a.priority - b.priority;
+function compareReactionsByOrder(a, b) {
+    return a.order - b.order;
 }
 function resolveReturn(value) {
     return value;

package/package.json

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