reactronic 0.22.300 → 0.22.301

package/README.md

@@ -19,13 +19,13 @@ isolated data snapshot and then, once atomically applied, are
 **consistently propagated** to corresponding visual components for
 (re)rendering. All that is done in automatic, seamless, and fine-grained
 way, because reactronic **takes full care of tracking dependencies**
-between visual components (subscribers) and state (subscribing objects).
+between visual components (subscribers) and state (reactive objects).
 
 Transactional reactivity is based on four fundamental concepts:
 
-  - **Subscribing Objects** - a set of objects that store data of an
+  - **Reactive Objects** - a set of objects that store data of an
     application (state) and maintain subscription lists;
-  - **Transaction** - a function that makes changes in subscribing
+  - **Transaction** - a function that makes changes in reactive
     objects in transactional (atomic) way;
   - **Reaction** - a function that is executed automatically in
     response to changes made by a transaction;
@@ -40,10 +40,10 @@ Quick introduction and detailed description is below.
 ## Quick Introduction
 
 Here is an example of transactional reactive code with
-subscribing object, transaction and reaction:
+reactive object, transaction and reaction:
 
 ``` typescript
-class Demo extends SubscribingObject {
+class Demo extends ReactiveObject {
   name: string = 'Nezaboodka Software'
   email: string = 'contact@nezaboodka.com'
 
@@ -70,7 +70,7 @@ to changes of these fields made by `saveContact` transaction.
 Here is an example of if cached value computed on-demand:
 
 ``` typescript
-class Demo extends SubscribingObject {
+class Demo extends ReactiveObject {
   name: string = 'Nezaboodka Software'
   email: string = 'contact@nezaboodka.com'
 
@@ -95,14 +95,14 @@ invalidated, thus causing execution of depending reaction
 `printContact`. Then `printContact` reaction causes `contact`
 re-computation on the first use.
 
-## Subscribing Objects
+## Reactive Objects
 
-Subscribing objects store data of an application. All such objects
+Reactive objects store data of an application. All such objects
 are transparently hooked to track access to their properties,
 both on reads and writes.
 
 ``` typescript
-class MyModel extends SubscribingObject {
+class MyModel extends ReactiveObject {
   url: string = "https://github.com/nezaboodka/reactronic"
   content: string = "transactional reactive state management"
   timestamp: Date = Date.now()
@@ -110,18 +110,18 @@ class MyModel extends SubscribingObject {
 ```
 
 In the example above, the class `MyModel` is based on Reactronic's
-`SubscribingObject` class and all its properties `url`, `content`,
+`ReactiveObject` class and all its properties `url`, `content`,
 and `timestamp` are hooked.
 
 ## Transaction
 
-Transaction is a function that makes changes in subscribing objects
+Transaction is a function that makes changes in reactive objects
 in transactional (atomic) way. Such a function is instrumented with hooks
 to provide transparent atomicity (by implicit context switching
 and isolation).
 
 ``` typescript
-class MyModel extends SubscribingObject {
+class MyModel extends ReactiveObject {
   // ...
   @transaction
   async load(url: string): Promise<void> {
@@ -164,12 +164,12 @@ of asynchronous operations is fully completed.
 ## Reaction & Cache
 
 Reaction is an code block that is immediately called in response to
-changes made by a transaction in subscribing objects. Cache is a
+changes made by a transaction in reactive objects. Cache is a
 computed value having an associated function that is called
 on-demand to renew the value if it was marked as obsolete due to changes
 made by a transaction. Reactive and cached functions are
 instrumented with hooks to seamlessly subscribe to those
-subscribing objects and other cached functions (dependencies),
+reactive objects and other cached functions (dependencies),
 which are used during their execution.
 
 ``` tsx
@@ -223,15 +223,15 @@ function enqueues re-rendering request to React, which calls
 `render` function causing it to renew its cached value.
 
 In general case, all reactions and caches are automatically and
-immediately marked as obsolete when changes are made in those subscribing
+immediately marked as obsolete when changes are made in those reactive
 objects and cached functions that were used during their execution.
 And once marked, the functions are automatically executed again,
 either immediately (for @reactive functions) or on-demand
 (for @cached functions).
 
 Reactronic takes full care of tracking dependencies between
-all the subscribing objects and reactions/caches (subscribing objects
-and subscribers). With Reactronic, you no longer need to create data change events
+all the reactive objects and reactions/caches.
+With Reactronic, you no longer need to create data change events
 in one set of objects, subscribe to these events in other objects,
 and manually maintain switching from the previous object version
 to a new one.
@@ -292,17 +292,17 @@ NPM: `npm install reactronic`
 
 // Classes
 
-class SubscribingObject { }
+class ReactiveObject { }
 
 // Decorators & Operators
 
-function subscribeless(proto, prop) // field only
+function plain(proto, prop) // field only
 function transaction(proto, prop, pd) // method only
 function reaction(proto, prop, pd) // method only
 function cached(proto, prop, pd) // method only
 function options(value: Partial<MemberOptions>): F<any>
 
-function nonsubscribing<T>(func: F<T>, ...args: any[]): T
+function nonreactive<T>(func: F<T>, ...args: any[]): T
 function sensitive<T>(sensitivity: Sensitivity, func: F<T>, ...args: any[]): T
 
 // SnapshotOptions, MemberOptions, Kind, Reentrance, Monitor, LoggingOptions, ProfilingOptions

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

@@ -1,5 +1,5 @@
-import { SubscribingObject } from './impl/Hooks';
-export declare abstract class Buffer<T> extends SubscribingObject {
+import { ReactiveObject } from './impl/Hooks';
+export declare abstract class Buffer<T> extends ReactiveObject {
     abstract readonly capacity: number;
     abstract readonly count: number;
     abstract put(...items: T[]): void;

package/build/dist/source/Buffer.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Buffer = void 0;
 const Hooks_1 = require("./impl/Hooks");
-class Buffer extends Hooks_1.SubscribingObject {
+class Buffer extends Hooks_1.ReactiveObject {
     static create(hint, capacity) { throw new Error('not implemented'); }
 }
 exports.Buffer = Buffer;

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

@@ -11,7 +11,7 @@ export declare class Ref<T = any> {
     constructor(owner: any, name: string, index?: number);
     get value(): T;
     set value(value: T);
-    nonsubscribing(): T;
+    nonreactive(): T;
     observe(): T;
     unobserve(): T;
     static to<O extends object = object>(owner: O): {

package/build/dist/source/Ref.js

@@ -21,8 +21,8 @@ class Ref {
         else
             this.owner[this.name][this.index] = value;
     }
-    nonsubscribing() {
-        return (0, Rx_1.nonsubscribing)(() => this.value);
+    nonreactive() {
+        return (0, Rx_1.nonreactive)(() => this.value);
     }
     observe() {
         return this.value;

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

@@ -17,9 +17,9 @@ export declare class Rx {
     static getLoggingHint<T extends object>(obj: T, full?: boolean): string | undefined;
     static setProfilingMode(isOn: boolean, options?: Partial<ProfilingOptions>): void;
 }
-export declare function nonsubscribing<T>(func: F<T>, ...args: any[]): T;
+export declare function nonreactive<T>(func: F<T>, ...args: any[]): T;
 export declare function sensitive<T>(sensitivity: boolean, func: F<T>, ...args: any[]): T;
-export declare function subscribeless(proto: object, prop: PropertyKey): any;
+export declare function plain(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;

package/build/dist/source/Rx.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.options = exports.cached = exports.reaction = exports.transaction = exports.subscribeless = exports.sensitive = exports.nonsubscribing = exports.Rx = void 0;
+exports.options = exports.cached = exports.reaction = exports.transaction = exports.plain = exports.sensitive = exports.nonreactive = exports.Rx = void 0;
 const Dbg_1 = require("./util/Dbg");
 const Options_1 = require("./Options");
 const Data_1 = require("./impl/Data");
@@ -24,18 +24,18 @@ class Rx {
     static setProfilingMode(isOn, options) { Hooks_1.Hooks.setProfilingMode(isOn, options); }
 }
 exports.Rx = Rx;
-function nonsubscribing(func, ...args) {
+function nonreactive(func, ...args) {
     return Operation_1.OperationController.runWithin(undefined, func, ...args);
 }
-exports.nonsubscribing = nonsubscribing;
+exports.nonreactive = nonreactive;
 function sensitive(sensitivity, func, ...args) {
     return Hooks_1.Hooks.sensitive(sensitivity, func, ...args);
 }
 exports.sensitive = sensitive;
-function subscribeless(proto, prop) {
+function plain(proto, prop) {
     return Hooks_1.Hooks.decorateData(false, proto, prop);
 }
-exports.subscribeless = subscribeless;
+exports.plain = plain;
 function transaction(proto, prop, pd) {
     const opts = { kind: Options_1.Kind.Transaction };
     return Hooks_1.Hooks.decorateOperation(true, transaction, opts, proto, prop, pd);

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

@@ -6,9 +6,9 @@ export { MemberOptions, SnapshotOptions, Kind, Reentrance, LoggingOptions, Profi
 export { Worker } from './Worker';
 export { Controller } from './Controller';
 export { Ref, ToggleRef, BoolOnly, GivenTypeOnly } from './Ref';
-export { SubscribingObject } from './impl/Hooks';
+export { ReactiveObject } from './impl/Hooks';
 export { Snapshot } from './impl/Snapshot';
 export { Transaction } from './impl/Transaction';
 export { Monitor } from './impl/Monitor';
 export { Journal } from './impl/Journal';
-export { Rx, nonsubscribing, sensitive, subscribeless, transaction, reaction, cached, options } from './Rx';
+export { Rx, nonreactive, sensitive, plain, transaction, reaction, cached, options } from './Rx';

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.subscribeless = exports.sensitive = exports.nonsubscribing = exports.Rx = exports.Journal = exports.Monitor = exports.Transaction = exports.Snapshot = exports.SubscribingObject = exports.ToggleRef = exports.Ref = exports.Controller = exports.LoggingLevel = 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.plain = exports.sensitive = exports.nonreactive = exports.Rx = exports.Journal = exports.Monitor = exports.Transaction = exports.Snapshot = exports.ReactiveObject = 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; } });
@@ -20,7 +20,7 @@ var Ref_1 = require("./Ref");
 Object.defineProperty(exports, "Ref", { enumerable: true, get: function () { return Ref_1.Ref; } });
 Object.defineProperty(exports, "ToggleRef", { enumerable: true, get: function () { return Ref_1.ToggleRef; } });
 var Hooks_1 = require("./impl/Hooks");
-Object.defineProperty(exports, "SubscribingObject", { enumerable: true, get: function () { return Hooks_1.SubscribingObject; } });
+Object.defineProperty(exports, "ReactiveObject", { enumerable: true, get: function () { return Hooks_1.ReactiveObject; } });
 var Snapshot_1 = require("./impl/Snapshot");
 Object.defineProperty(exports, "Snapshot", { enumerable: true, get: function () { return Snapshot_1.Snapshot; } });
 var Transaction_1 = require("./impl/Transaction");
@@ -31,9 +31,9 @@ var Journal_1 = require("./impl/Journal");
 Object.defineProperty(exports, "Journal", { enumerable: true, get: function () { return Journal_1.Journal; } });
 var Rx_1 = require("./Rx");
 Object.defineProperty(exports, "Rx", { enumerable: true, get: function () { return Rx_1.Rx; } });
-Object.defineProperty(exports, "nonsubscribing", { enumerable: true, get: function () { return Rx_1.nonsubscribing; } });
+Object.defineProperty(exports, "nonreactive", { enumerable: true, get: function () { return Rx_1.nonreactive; } });
 Object.defineProperty(exports, "sensitive", { enumerable: true, get: function () { return Rx_1.sensitive; } });
-Object.defineProperty(exports, "subscribeless", { enumerable: true, get: function () { return Rx_1.subscribeless; } });
+Object.defineProperty(exports, "plain", { enumerable: true, get: function () { return Rx_1.plain; } });
 Object.defineProperty(exports, "transaction", { enumerable: true, get: function () { return Rx_1.transaction; } });
 Object.defineProperty(exports, "reaction", { enumerable: true, get: function () { return Rx_1.reaction; } });
 Object.defineProperty(exports, "cached", { enumerable: true, get: function () { return Rx_1.cached; } });

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

@@ -4,7 +4,7 @@ import { LoggingOptions, ProfilingOptions } from '../Logging';
 import { MemberName, DataHolder, StandaloneMode } from './Data';
 import { Journal } from './Journal';
 import { Monitor } from './Monitor';
-export declare abstract class SubscribingObject {
+export declare abstract class ReactiveObject {
     constructor();
     [Symbol.toStringTag](): string;
 }
@@ -37,11 +37,11 @@ export declare class Hooks implements ProxyHandler<DataHolder> {
     has(h: DataHolder, m: MemberName): boolean;
     getOwnPropertyDescriptor(h: DataHolder, m: MemberName): PropertyDescriptor | undefined;
     ownKeys(h: DataHolder): Array<string | symbol>;
-    static decorateData(subscribing: boolean, proto: any, m: MemberName): any;
+    static decorateData(reactive: boolean, proto: any, m: MemberName): any;
     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 acquireDataHolder(obj: any): DataHolder;
-    static createDataHolderForSubscribingObject(proto: any, data: any, blank: any, hint: string): DataHolder;
+    static createDataHolderForReactiveObject(proto: any, data: any, blank: any, hint: string): DataHolder;
     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;

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

@@ -1,16 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Hooks = exports.OptionsImpl = exports.SubscribingObject = void 0;
+exports.Hooks = exports.OptionsImpl = exports.ReactiveObject = void 0;
 const Utils_1 = require("../util/Utils");
 const Dbg_1 = require("../util/Dbg");
 const Options_1 = require("../Options");
 const Data_1 = require("./Data");
 const Snapshot_1 = require("./Snapshot");
-class SubscribingObject {
+class ReactiveObject {
     constructor() {
         const proto = new.target.prototype;
         const initial = Data_1.Meta.getFrom(proto, Data_1.Meta.Initial);
-        const h = Hooks.createDataHolderForSubscribingObject(proto, this, initial, new.target.name);
+        const h = Hooks.createDataHolderForReactiveObject(proto, this, initial, new.target.name);
         return h.proxy;
     }
     [Symbol.toStringTag]() {
@@ -18,7 +18,7 @@ class SubscribingObject {
         return Snapshot_1.Dump.obj(h);
     }
 }
-exports.SubscribingObject = SubscribingObject;
+exports.ReactiveObject = ReactiveObject;
 const DEFAULT_OPTIONS = Object.freeze({
     kind: Options_1.Kind.Plain,
     standalone: false,
@@ -117,8 +117,8 @@ class Hooks {
         }
         return result;
     }
-    static decorateData(subscribing, proto, m) {
-        if (subscribing) {
+    static decorateData(reactive, proto, m) {
+        if (reactive) {
             const get = function () {
                 const h = Hooks.acquireDataHolder(this);
                 return Hooks.proxy.get(h, m, this);
@@ -132,7 +132,7 @@ class Hooks {
             return Object.defineProperty(proto, m, { get, set, enumerable, configurable });
         }
         else
-            Data_1.Meta.acquire(proto, Data_1.Meta.Initial)[m] = Data_1.Meta.Nonsubscribing;
+            Data_1.Meta.acquire(proto, Data_1.Meta.Initial)[m] = Data_1.Meta.Nonreactive;
     }
     static decorateOperation(implicit, decorator, options, proto, member, pd) {
         var _a, _b, _c, _d;
@@ -180,7 +180,7 @@ class Hooks {
         }
         return h;
     }
-    static createDataHolderForSubscribingObject(proto, data, blank, hint) {
+    static createDataHolderForReactiveObject(proto, data, blank, hint) {
         const ctx = Snapshot_1.Snapshot.edit();
         const h = new Data_1.DataHolder(data, undefined, Hooks.proxy, Snapshot_1.ROOT_REV, hint);
         ctx.getEditableRevision(h, Data_1.Meta.Holder, blank);

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

@@ -1,7 +1,7 @@
-import { SubscribingObject } from './Hooks';
+import { ReactiveObject } from './Hooks';
 import { DataHolder, DataRevision, PatchSet } from './Data';
 export declare type Saver = (patch: PatchSet) => Promise<void>;
-export declare abstract class Journal extends SubscribingObject {
+export declare abstract class Journal extends ReactiveObject {
     abstract capacity: number;
     abstract readonly edits: ReadonlyArray<PatchSet>;
     abstract readonly unsaved: PatchSet;

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

@@ -6,7 +6,7 @@ const Data_1 = require("./Data");
 const Snapshot_1 = require("./Snapshot");
 const Transaction_1 = require("./Transaction");
 const Sealant_1 = require("../util/Sealant");
-class Journal extends Hooks_1.SubscribingObject {
+class Journal extends Hooks_1.ReactiveObject {
     static create() { return new JournalImpl(); }
 }
 exports.Journal = Journal;

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

@@ -4,7 +4,7 @@ export declare abstract class Meta {
     static readonly Disposed: unique symbol;
     static readonly Initial: unique symbol;
     static readonly Reactions: unique symbol;
-    static readonly Nonsubscribing: unique symbol;
+    static readonly Nonreactive: unique symbol;
     static readonly Undefined: unique symbol;
     static get<T>(obj: any, sym: symbol): T;
     static set(obj: any, sym: symbol, value: any): any;

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

@@ -29,5 +29,5 @@ Meta.Controller = Symbol('rxController');
 Meta.Disposed = Symbol('rxDisposed');
 Meta.Initial = Symbol('rxInitial');
 Meta.Reactions = Symbol('rxReactions');
-Meta.Nonsubscribing = Symbol('rxNonsubscribing');
+Meta.Nonreactive = Symbol('rxNonreactive');
 Meta.Undefined = Symbol('rxUndefined');

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

@@ -1,6 +1,6 @@
 import { Worker } from '../Worker';
-import { SubscribingObject } from './Hooks';
-export declare abstract class Monitor extends SubscribingObject {
+import { ReactiveObject } from './Hooks';
+export declare abstract class Monitor extends ReactiveObject {
     abstract readonly isActive: boolean;
     abstract readonly counter: number;
     abstract readonly workers: ReadonlySet<Worker>;

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

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.MonitorImpl = exports.Monitor = void 0;
 const Hooks_1 = require("./Hooks");
 const Transaction_1 = require("./Transaction");
-class Monitor extends Hooks_1.SubscribingObject {
+class Monitor extends Hooks_1.ReactiveObject {
     static create(hint, activationDelay, deactivationDelay, durationResolution) {
         return MonitorImpl.create(hint, activationDelay, deactivationDelay, durationResolution);
     }

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

@@ -9,7 +9,7 @@ export declare class OperationController extends Controller<any> {
     readonly memberName: MemberName;
     configure(options: Partial<MemberOptions>): MemberOptions;
     get options(): MemberOptions;
-    get nonsubscribing(): any;
+    get nonreactive(): any;
     get args(): ReadonlyArray<any>;
     get result(): any;
     get error(): boolean;

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

@@ -21,7 +21,7 @@ class OperationController extends Controller_1.Controller {
     }
     configure(options) { return OperationController.configureImpl(this, options); }
     get options() { return this.peek(undefined).operation.options; }
-    get nonsubscribing() { return this.peek(undefined).operation.content; }
+    get nonreactive() { return this.peek(undefined).operation.content; }
     get args() { return this.use().operation.args; }
     get result() { return this.useOrRun(true, undefined).content; }
     get error() { return this.use().operation.error; }

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

@@ -19,7 +19,7 @@ Object.defineProperty(Data_1.DataHolder.prototype, '#this', {
             const v = data[m];
             if (v instanceof Data_1.Subscription)
                 result[m] = v.content;
-            else if (v === Data_1.Meta.Nonsubscribing)
+            else if (v === Data_1.Meta.Nonreactive)
                 result[m] = this.data[m];
             else
                 result[m] = v;
@@ -64,7 +64,7 @@ class Snapshot {
     getEditableRevision(h, m, value, token) {
         let r = this.seekRevision(h, m);
         const existing = r.data[m];
-        if (existing !== Data_1.Meta.Nonsubscribing) {
+        if (existing !== Data_1.Meta.Nonreactive) {
             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);
@@ -99,7 +99,7 @@ class Snapshot {
     }
     isNewRevisionRequired(h, r, m, existing, value, token) {
         if (this.sealed && r.snapshot !== exports.ROOT_REV.snapshot)
-            throw (0, Dbg_1.misuse)(`subscribing property ${Dump.obj(h, m)} can only be modified inside transaction`);
+            throw (0, Dbg_1.misuse)(`reactive 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.former.revision !== exports.ROOT_REV) {
                 if (this.options.token !== undefined && token !== this.options.token)

package/package.json

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