reactronic 0.24.127 → 0.24.200

package/build/dist/source/core/RxNode.d.ts

@@ -1,14 +1,14 @@
 import { LoggingOptions } from "../Logging.js";
 import { MergeListReader, MergedItem } from "../util/MergeList.js";
 import { MemberOptions } from "../Options.js";
-export type Delegate<T> = (element: T, base: () => void) => void;
-export type SimpleDelegate<T = unknown, R = void> = (element: T) => R;
+export type Delegate<T> = (el: T, basis: () => void) => void;
+export type SimpleDelegate<T = unknown, R = void> = (el: T) => R;
 export declare enum Mode {
     default = 0,
     independentUpdate = 1,
     manualMount = 2
 }
-export declare const enum Priority {
+export declare enum Priority {
     realtime = 0,
     normal = 1,
     background = 2
@@ -45,7 +45,7 @@ export declare abstract class RxNode<E = unknown> {
     static get childrenShuffling(): boolean;
     static set childrenShuffling(value: boolean);
     static triggerUpdate(node: RxNode<any>, triggers: unknown): void;
-    static triggerFinalize(node: RxNode<any>): void;
+    static triggerDeactivation(node: RxNode<any>): void;
     static updateNestedNodesThenDo(action: (error: unknown) => void): void;
     static markAsMounted(node: RxNode<any>, yes: boolean): void;
     static findMatchingHost<E = unknown, R = unknown>(node: RxNode<E>, match: SimpleDelegate<RxNode<E>, boolean>): RxNode<R> | undefined;
@@ -55,23 +55,23 @@ export declare abstract class RxNode<E = unknown> {
     static setDefaultLoggingOptions(logging?: LoggingOptions): void;
 }
 export type RxNodeDecl<E = unknown> = {
-    preset?: RxNodeDecl<E>;
+    content?: Delegate<E>;
     key?: string;
     mode?: Mode;
+    activation?: Delegate<E>;
+    deactivation?: Delegate<E>;
     triggers?: unknown;
-    initialize?: Delegate<E>;
-    update?: Delegate<E>;
-    finalize?: Delegate<E>;
+    preset?: RxNodeDecl<E>;
 };
 export type RxNodeDriver<E = unknown> = {
     readonly name: string;
     readonly isPartitionSeparator: boolean;
     readonly predefine?: SimpleDelegate<E>;
     allocate(node: RxNode<E>): E;
-    initialize(node: RxNode<E>): void;
+    activate(node: RxNode<E>): void;
     mount(node: RxNode<E>): void;
     update(node: RxNode<E>): void | Promise<void>;
-    finalize(node: RxNode<E>, isLeader: boolean): boolean;
+    deactivate(node: RxNode<E>, isLeader: boolean): boolean;
 };
 export type RxNodeContext<T extends Object = Object> = {
     value: T;
@@ -82,10 +82,10 @@ export declare abstract class BaseDriver<E = unknown> implements RxNodeDriver<E>
     readonly predefine?: SimpleDelegate<E, void> | undefined;
     constructor(name: string, isPartitionSeparator: boolean, predefine?: SimpleDelegate<E, void> | undefined);
     abstract allocate(node: RxNode<E>): E;
-    initialize(node: RxNode<E>): void;
+    activate(node: RxNode<E>): void;
     mount(node: RxNode<E>): void;
     update(node: RxNode<E>): void | Promise<void>;
-    finalize(node: RxNode<E>, isLeader: boolean): boolean;
+    deactivate(node: RxNode<E>, isLeader: boolean): boolean;
 }
 export declare class RxNodeVariable<T extends Object = Object> {
     readonly defaultValue: T | undefined;

package/build/dist/source/core/RxNode.js

@@ -106,9 +106,9 @@ export class RxNode {
             triggerUpdateViaSeat(impl.seat);
         }
     }
-    static triggerFinalize(node) {
+    static triggerDeactivation(node) {
         const impl = node;
-        triggerFinalization(impl.seat, true, true);
+        triggerDeactivation(impl.seat, true, true);
     }
     static updateNestedNodesThenDo(action) {
         runUpdateNestedNodesThenDo(undefined, action);
@@ -116,9 +116,9 @@ export class RxNode {
     static markAsMounted(node, yes) {
         const n = node;
         if (n.stamp < 0)
-            throw new Error("finalized node cannot be mounted or unmounted");
+            throw new Error("deactivated node cannot be mounted or unmounted");
         if (n.stamp >= Number.MAX_SAFE_INTEGER)
-            throw new Error("node must be initialized before mounting");
+            throw new Error("node must be activated before mounting");
         n.stamp = yes ? 0 : Number.MAX_SAFE_INTEGER - 1;
     }
     static findMatchingHost(node, match) {
@@ -155,18 +155,18 @@ export class BaseDriver {
         this.isPartitionSeparator = isPartitionSeparator;
         this.predefine = predefine;
     }
-    initialize(node) {
+    activate(node) {
         var _a;
         (_a = this.predefine) === null || _a === void 0 ? void 0 : _a.call(this, node.element);
-        initializeViaPresetChain(node.element, node.declaration);
+        activateViaPresetChain(node.element, node.declaration);
     }
     mount(node) {
     }
     update(node) {
         updateViaPresetChain(node.element, node.declaration);
     }
-    finalize(node, isLeader) {
-        finalizeViaPresetChain(node.element, node.declaration);
+    deactivate(node, isLeader) {
+        deactivateViaPresetChain(node.element, node.declaration);
         return isLeader;
     }
 }
@@ -198,29 +198,29 @@ function getModeViaPresetChain(declaration) {
     var _a;
     return (_a = declaration === null || declaration === void 0 ? void 0 : declaration.mode) !== null && _a !== void 0 ? _a : ((declaration === null || declaration === void 0 ? void 0 : declaration.preset) ? getModeViaPresetChain(declaration === null || declaration === void 0 ? void 0 : declaration.preset) : Mode.default);
 }
-function initializeViaPresetChain(element, declaration) {
+function activateViaPresetChain(element, declaration) {
     const preset = declaration.preset;
-    const initialize = declaration.initialize;
-    if (initialize)
-        initialize(element, preset ? () => initializeViaPresetChain(element, preset) : NOP);
+    const activation = declaration.activation;
+    if (activation)
+        activation(element, preset ? () => activateViaPresetChain(element, preset) : NOP);
     else if (preset)
-        initializeViaPresetChain(element, preset);
+        activateViaPresetChain(element, preset);
 }
 function updateViaPresetChain(element, declaration) {
     const preset = declaration.preset;
-    const update = declaration.update;
-    if (update)
-        update(element, preset ? () => updateViaPresetChain(element, preset) : NOP);
+    const content = declaration.content;
+    if (content)
+        content(element, preset ? () => updateViaPresetChain(element, preset) : NOP);
     else if (preset)
         updateViaPresetChain(element, preset);
 }
-function finalizeViaPresetChain(element, declaration) {
+function deactivateViaPresetChain(element, declaration) {
     const preset = declaration.preset;
-    const finalize = declaration.finalize;
-    if (finalize)
-        finalize(element, preset ? () => finalizeViaPresetChain(element, preset) : NOP);
+    const deactivation = declaration.deactivation;
+    if (deactivation)
+        deactivation(element, preset ? () => deactivateViaPresetChain(element, preset) : NOP);
     else if (preset)
-        finalizeViaPresetChain(element, preset);
+        deactivateViaPresetChain(element, preset);
 }
 class RxNodeContextImpl extends ObservableObject {
     constructor(variable, value) {
@@ -280,7 +280,7 @@ class RxNodeImpl extends RxNode {
     }
     configureReactronic(options) {
         if (this.stamp < Number.MAX_SAFE_INTEGER - 1 || !this.has(Mode.independentUpdate))
-            throw new Error("reactronic can be configured only for elements with independent update mode and only inside initialize");
+            throw new Error("reactronic can be configured only for elements with independent update mode and only during activation");
         return RxSystem.getReaction(this.update).configure(options);
     }
     static get ownSeat() {
@@ -354,7 +354,7 @@ function runUpdateNestedNodesThenDo(error, action) {
         try {
             children.endMerge(error);
             for (const child of children.removedItems(true))
-                triggerFinalization(child, true, true);
+                triggerDeactivation(child, true, true);
             if (!error) {
                 const sequential = children.isStrict;
                 let p1 = undefined;
@@ -465,7 +465,7 @@ function mountOrRemountIfNecessary(node) {
     if (node.stamp === Number.MAX_SAFE_INTEGER) {
         unobs(() => {
             node.stamp = Number.MAX_SAFE_INTEGER - 1;
-            driver.initialize(node);
+            driver.activate(node);
             if (!node.has(Mode.manualMount)) {
                 node.stamp = 0;
                 if (node.host !== node)
@@ -503,14 +503,14 @@ function updateNow(seat) {
         });
     }
 }
-function triggerFinalization(seat, isLeader, individual) {
+function triggerDeactivation(seat, isLeader, individual) {
     const node = seat.instance;
     if (node.stamp >= 0) {
         const driver = node.driver;
         if (individual && node.key !== node.declaration.key && !driver.isPartitionSeparator)
             console.log(`WARNING: it is recommended to assign explicit key for conditional element in order to avoid unexpected side effects: ${node.key}`);
         node.stamp = ~node.stamp;
-        const childrenAreLeaders = unobs(() => driver.finalize(node, isLeader));
+        const childrenAreLeaders = unobs(() => driver.deactivate(node, isLeader));
         if (node.has(Mode.independentUpdate)) {
             seat.aux = undefined;
             const last = gLastToDispose;
@@ -524,7 +524,7 @@ function triggerFinalization(seat, isLeader, individual) {
                 });
         }
         for (const child of node.children.items())
-            triggerFinalization(child, childrenAreLeaders, false);
+            triggerDeactivation(child, childrenAreLeaders, false);
         RxNodeImpl.grandNodeCount--;
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "reactronic",
-  "version": "0.24.127",
+  "version": "0.24.200",
   "description": "Reactronic - Transactional Reactive State Management",
   "publisher": "Nezaboodka Software",
   "license": "Apache-2.0",
@@ -31,10 +31,10 @@
   },
   "homepage": "https://github.com/nezaboodka/reactronic/blob/master/README.md#readme",
   "devDependencies": {
-    "@types/node": "20.11.16",
-    "@types/react": "18.2.52",
-    "@typescript-eslint/eslint-plugin": "6.20.0",
-    "@typescript-eslint/parser": "6.20.0",
+    "@types/node": "20.11.17",
+    "@types/react": "18.2.55",
+    "@typescript-eslint/eslint-plugin": "6.21.0",
+    "@typescript-eslint/parser": "6.21.0",
     "ava": "6.1.1",
     "c8": "9.1.0",
     "eslint": "8.56.0",