j-templates 7.0.74 → 7.0.76

package/DOM/createPropertyAssignment.js

@@ -9,7 +9,7 @@ function CreatePropertyAssignment(target, property) {
     let childAssignment;
     return function (next) {
         const nextValue = next && next[property];
-        if (nextValue === lastValue)
+        if (nextValue === lastValue || nextValue === undefined)
             return;
         jsonType ??= (0, json_1.JsonType)(nextValue);
         switch (jsonType) {
@@ -31,7 +31,7 @@ function CreateRootPropertyAssignment(target, property) {
     let childAssignment;
     return function (next) {
         const nextValue = next && next[property];
-        if (nextValue === lastValue)
+        if (nextValue === lastValue || nextValue === undefined)
             return;
         switch (property) {
             case "nodeValue": {
@@ -67,11 +67,18 @@ function AssignNodeValue(target, value) {
     target.nodeValue = value;
 }
 function AssignValue(target, value) {
-    const start = target.selectionStart;
-    const end = target.selectionEnd;
-    target.value = value;
-    if (target.ownerDocument.activeElement === target)
-        target.setSelectionRange(start, end);
+    switch (target.nodeName) {
+        case "INPUT": {
+            const start = target.selectionStart;
+            const end = target.selectionEnd;
+            target.value = value;
+            if (target.ownerDocument.activeElement === target)
+                target.setSelectionRange(start, end);
+            break;
+        }
+        default:
+            target.value = value;
+    }
 }
 function AssignClassName(target, value) {
     target.className = value;

package/DOM/elements.d.ts

@@ -4,7 +4,7 @@ export declare const div: <T>(config: {
         [name: string]: string;
     }>;
     on?: import("../Node/vNode.types").FunctionOr<import("../Node/vNode.types").vNodeEvents<HTMLElementEventMap>>;
-    data?: () => T | Array<T> | Promise<Array<T>> | Promise<T>;
+    data?: () => T | T[] | Promise<T[]> | Promise<T>;
 }, children?: import("../Node/vNode.types").vNode[] | import("../Node/vNode.types").vNodeChildrenFunction<T>) => import("../Node/vNode.types").vNode;
 export declare const a: <T>(config: {
     props?: import("../Node/vNode.types").FunctionOr<import("../Utils/utils.types").RecursivePartial<HTMLElement>>;
@@ -12,7 +12,7 @@ export declare const a: <T>(config: {
         [name: string]: string;
     }>;
     on?: import("../Node/vNode.types").FunctionOr<import("../Node/vNode.types").vNodeEvents<HTMLElementEventMap>>;
-    data?: () => T | Array<T> | Promise<Array<T>> | Promise<T>;
+    data?: () => T | T[] | Promise<T[]> | Promise<T>;
 }, children?: import("../Node/vNode.types").vNode[] | import("../Node/vNode.types").vNodeChildrenFunction<T>) => import("../Node/vNode.types").vNode;
 export declare const b: <T>(config: {
     props?: import("../Node/vNode.types").FunctionOr<import("../Utils/utils.types").RecursivePartial<HTMLElement>>;
@@ -20,7 +20,7 @@ export declare const b: <T>(config: {
         [name: string]: string;
     }>;
     on?: import("../Node/vNode.types").FunctionOr<import("../Node/vNode.types").vNodeEvents<HTMLElementEventMap>>;
-    data?: () => T | Array<T> | Promise<Array<T>> | Promise<T>;
+    data?: () => T | T[] | Promise<T[]> | Promise<T>;
 }, children?: import("../Node/vNode.types").vNode[] | import("../Node/vNode.types").vNodeChildrenFunction<T>) => import("../Node/vNode.types").vNode;
 export declare const button: <T>(config: {
     props?: import("../Node/vNode.types").FunctionOr<import("../Utils/utils.types").RecursivePartial<HTMLButtonElement>>;
@@ -28,7 +28,7 @@ export declare const button: <T>(config: {
         [name: string]: string;
     }>;
     on?: import("../Node/vNode.types").FunctionOr<import("../Node/vNode.types").vNodeEvents<HTMLElementEventMap>>;
-    data?: () => T | Array<T> | Promise<Array<T>> | Promise<T>;
+    data?: () => T | T[] | Promise<T[]> | Promise<T>;
 }, children?: import("../Node/vNode.types").vNode[] | import("../Node/vNode.types").vNodeChildrenFunction<T>) => import("../Node/vNode.types").vNode;
 export declare const h1: <T>(config: {
     props?: import("../Node/vNode.types").FunctionOr<import("../Utils/utils.types").RecursivePartial<HTMLElement>>;
@@ -36,7 +36,7 @@ export declare const h1: <T>(config: {
         [name: string]: string;
     }>;
     on?: import("../Node/vNode.types").FunctionOr<import("../Node/vNode.types").vNodeEvents<HTMLElementEventMap>>;
-    data?: () => T | Array<T> | Promise<Array<T>> | Promise<T>;
+    data?: () => T | T[] | Promise<T[]> | Promise<T>;
 }, children?: import("../Node/vNode.types").vNode[] | import("../Node/vNode.types").vNodeChildrenFunction<T>) => import("../Node/vNode.types").vNode;
 export declare const h2: <T>(config: {
     props?: import("../Node/vNode.types").FunctionOr<import("../Utils/utils.types").RecursivePartial<HTMLElement>>;
@@ -44,7 +44,7 @@ export declare const h2: <T>(config: {
         [name: string]: string;
     }>;
     on?: import("../Node/vNode.types").FunctionOr<import("../Node/vNode.types").vNodeEvents<HTMLElementEventMap>>;
-    data?: () => T | Array<T> | Promise<Array<T>> | Promise<T>;
+    data?: () => T | T[] | Promise<T[]> | Promise<T>;
 }, children?: import("../Node/vNode.types").vNode[] | import("../Node/vNode.types").vNodeChildrenFunction<T>) => import("../Node/vNode.types").vNode;
 export declare const h3: <T>(config: {
     props?: import("../Node/vNode.types").FunctionOr<import("../Utils/utils.types").RecursivePartial<HTMLElement>>;
@@ -52,7 +52,7 @@ export declare const h3: <T>(config: {
         [name: string]: string;
     }>;
     on?: import("../Node/vNode.types").FunctionOr<import("../Node/vNode.types").vNodeEvents<HTMLElementEventMap>>;
-    data?: () => T | Array<T> | Promise<Array<T>> | Promise<T>;
+    data?: () => T | T[] | Promise<T[]> | Promise<T>;
 }, children?: import("../Node/vNode.types").vNode[] | import("../Node/vNode.types").vNodeChildrenFunction<T>) => import("../Node/vNode.types").vNode;
 export declare const input: <T>(config: {
     props?: import("../Node/vNode.types").FunctionOr<import("../Utils/utils.types").RecursivePartial<HTMLInputElement>>;
@@ -60,7 +60,7 @@ export declare const input: <T>(config: {
         [name: string]: string;
     }>;
     on?: import("../Node/vNode.types").FunctionOr<import("../Node/vNode.types").vNodeEvents<HTMLElementEventMap>>;
-    data?: () => T | Array<T> | Promise<Array<T>> | Promise<T>;
+    data?: () => T | T[] | Promise<T[]> | Promise<T>;
 }, children?: import("../Node/vNode.types").vNode[] | import("../Node/vNode.types").vNodeChildrenFunction<T>) => import("../Node/vNode.types").vNode;
 export declare const textarea: <T>(config: {
     props?: import("../Node/vNode.types").FunctionOr<import("../Utils/utils.types").RecursivePartial<HTMLTextAreaElement>>;
@@ -68,7 +68,7 @@ export declare const textarea: <T>(config: {
         [name: string]: string;
     }>;
     on?: import("../Node/vNode.types").FunctionOr<import("../Node/vNode.types").vNodeEvents<HTMLElementEventMap>>;
-    data?: () => T | Array<T> | Promise<Array<T>> | Promise<T>;
+    data?: () => T | T[] | Promise<T[]> | Promise<T>;
 }, children?: import("../Node/vNode.types").vNode[] | import("../Node/vNode.types").vNodeChildrenFunction<T>) => import("../Node/vNode.types").vNode;
 export declare const span: <T>(config: {
     props?: import("../Node/vNode.types").FunctionOr<import("../Utils/utils.types").RecursivePartial<HTMLElement>>;
@@ -76,7 +76,7 @@ export declare const span: <T>(config: {
         [name: string]: string;
     }>;
     on?: import("../Node/vNode.types").FunctionOr<import("../Node/vNode.types").vNodeEvents<HTMLElementEventMap>>;
-    data?: () => T | Array<T> | Promise<Array<T>> | Promise<T>;
+    data?: () => T | T[] | Promise<T[]> | Promise<T>;
 }, children?: import("../Node/vNode.types").vNode[] | import("../Node/vNode.types").vNodeChildrenFunction<T>) => import("../Node/vNode.types").vNode;
 export declare const table: <T>(config: {
     props?: import("../Node/vNode.types").FunctionOr<import("../Utils/utils.types").RecursivePartial<HTMLElement>>;
@@ -84,7 +84,7 @@ export declare const table: <T>(config: {
         [name: string]: string;
     }>;
     on?: import("../Node/vNode.types").FunctionOr<import("../Node/vNode.types").vNodeEvents<HTMLElementEventMap>>;
-    data?: () => T | Array<T> | Promise<Array<T>> | Promise<T>;
+    data?: () => T | T[] | Promise<T[]> | Promise<T>;
 }, children?: import("../Node/vNode.types").vNode[] | import("../Node/vNode.types").vNodeChildrenFunction<T>) => import("../Node/vNode.types").vNode;
 export declare const thead: <T>(config: {
     props?: import("../Node/vNode.types").FunctionOr<import("../Utils/utils.types").RecursivePartial<HTMLElement>>;
@@ -92,7 +92,7 @@ export declare const thead: <T>(config: {
         [name: string]: string;
     }>;
     on?: import("../Node/vNode.types").FunctionOr<import("../Node/vNode.types").vNodeEvents<HTMLElementEventMap>>;
-    data?: () => T | Array<T> | Promise<Array<T>> | Promise<T>;
+    data?: () => T | T[] | Promise<T[]> | Promise<T>;
 }, children?: import("../Node/vNode.types").vNode[] | import("../Node/vNode.types").vNodeChildrenFunction<T>) => import("../Node/vNode.types").vNode;
 export declare const th: <T>(config: {
     props?: import("../Node/vNode.types").FunctionOr<import("../Utils/utils.types").RecursivePartial<HTMLElement>>;
@@ -100,7 +100,7 @@ export declare const th: <T>(config: {
         [name: string]: string;
     }>;
     on?: import("../Node/vNode.types").FunctionOr<import("../Node/vNode.types").vNodeEvents<HTMLElementEventMap>>;
-    data?: () => T | Array<T> | Promise<Array<T>> | Promise<T>;
+    data?: () => T | T[] | Promise<T[]> | Promise<T>;
 }, children?: import("../Node/vNode.types").vNode[] | import("../Node/vNode.types").vNodeChildrenFunction<T>) => import("../Node/vNode.types").vNode;
 export declare const tbody: <T>(config: {
     props?: import("../Node/vNode.types").FunctionOr<import("../Utils/utils.types").RecursivePartial<HTMLElement>>;
@@ -108,7 +108,7 @@ export declare const tbody: <T>(config: {
         [name: string]: string;
     }>;
     on?: import("../Node/vNode.types").FunctionOr<import("../Node/vNode.types").vNodeEvents<HTMLElementEventMap>>;
-    data?: () => T | Array<T> | Promise<Array<T>> | Promise<T>;
+    data?: () => T | T[] | Promise<T[]> | Promise<T>;
 }, children?: import("../Node/vNode.types").vNode[] | import("../Node/vNode.types").vNodeChildrenFunction<T>) => import("../Node/vNode.types").vNode;
 export declare const tr: <T>(config: {
     props?: import("../Node/vNode.types").FunctionOr<import("../Utils/utils.types").RecursivePartial<HTMLElement>>;
@@ -116,7 +116,7 @@ export declare const tr: <T>(config: {
         [name: string]: string;
     }>;
     on?: import("../Node/vNode.types").FunctionOr<import("../Node/vNode.types").vNodeEvents<HTMLElementEventMap>>;
-    data?: () => T | Array<T> | Promise<Array<T>> | Promise<T>;
+    data?: () => T | T[] | Promise<T[]> | Promise<T>;
 }, children?: import("../Node/vNode.types").vNode[] | import("../Node/vNode.types").vNodeChildrenFunction<T>) => import("../Node/vNode.types").vNode;
 export declare const td: <T>(config: {
     props?: import("../Node/vNode.types").FunctionOr<import("../Utils/utils.types").RecursivePartial<HTMLElement>>;
@@ -124,7 +124,7 @@ export declare const td: <T>(config: {
         [name: string]: string;
     }>;
     on?: import("../Node/vNode.types").FunctionOr<import("../Node/vNode.types").vNodeEvents<HTMLElementEventMap>>;
-    data?: () => T | Array<T> | Promise<Array<T>> | Promise<T>;
+    data?: () => T | T[] | Promise<T[]> | Promise<T>;
 }, children?: import("../Node/vNode.types").vNode[] | import("../Node/vNode.types").vNodeChildrenFunction<T>) => import("../Node/vNode.types").vNode;
 export declare const img: <T>(config: {
     props?: import("../Node/vNode.types").FunctionOr<import("../Utils/utils.types").RecursivePartial<HTMLImageElement>>;
@@ -132,7 +132,7 @@ export declare const img: <T>(config: {
         [name: string]: string;
     }>;
     on?: import("../Node/vNode.types").FunctionOr<import("../Node/vNode.types").vNodeEvents<HTMLElementEventMap>>;
-    data?: () => T | Array<T> | Promise<Array<T>> | Promise<T>;
+    data?: () => T | T[] | Promise<T[]> | Promise<T>;
 }, children?: import("../Node/vNode.types").vNode[] | import("../Node/vNode.types").vNodeChildrenFunction<T>) => import("../Node/vNode.types").vNode;
 export declare const video: <T>(config: {
     props?: import("../Node/vNode.types").FunctionOr<import("../Utils/utils.types").RecursivePartial<HTMLVideoElement>>;
@@ -140,7 +140,7 @@ export declare const video: <T>(config: {
         [name: string]: string;
     }>;
     on?: import("../Node/vNode.types").FunctionOr<import("../Node/vNode.types").vNodeEvents<HTMLElementEventMap>>;
-    data?: () => T | Array<T> | Promise<Array<T>> | Promise<T>;
+    data?: () => T | T[] | Promise<T[]> | Promise<T>;
 }, children?: import("../Node/vNode.types").vNode[] | import("../Node/vNode.types").vNodeChildrenFunction<T>) => import("../Node/vNode.types").vNode;
 export declare const select: <T>(config: {
     props?: import("../Node/vNode.types").FunctionOr<import("../Utils/utils.types").RecursivePartial<HTMLSelectElement>>;
@@ -148,7 +148,7 @@ export declare const select: <T>(config: {
         [name: string]: string;
     }>;
     on?: import("../Node/vNode.types").FunctionOr<import("../Node/vNode.types").vNodeEvents<HTMLElementEventMap>>;
-    data?: () => T | Array<T> | Promise<Array<T>> | Promise<T>;
+    data?: () => T | T[] | Promise<T[]> | Promise<T>;
 }, children?: import("../Node/vNode.types").vNode[] | import("../Node/vNode.types").vNodeChildrenFunction<T>) => import("../Node/vNode.types").vNode;
 export declare const option: <T>(config: {
     props?: import("../Node/vNode.types").FunctionOr<import("../Utils/utils.types").RecursivePartial<HTMLOptionElement>>;
@@ -156,7 +156,7 @@ export declare const option: <T>(config: {
         [name: string]: string;
     }>;
     on?: import("../Node/vNode.types").FunctionOr<import("../Node/vNode.types").vNodeEvents<HTMLElementEventMap>>;
-    data?: () => T | Array<T> | Promise<Array<T>> | Promise<T>;
+    data?: () => T | T[] | Promise<T[]> | Promise<T>;
 }, children?: import("../Node/vNode.types").vNode[] | import("../Node/vNode.types").vNodeChildrenFunction<T>) => import("../Node/vNode.types").vNode;
 export declare const aside: <T>(config: {
     props?: import("../Node/vNode.types").FunctionOr<import("../Utils/utils.types").RecursivePartial<HTMLElement>>;
@@ -164,7 +164,7 @@ export declare const aside: <T>(config: {
         [name: string]: string;
     }>;
     on?: import("../Node/vNode.types").FunctionOr<import("../Node/vNode.types").vNodeEvents<HTMLElementEventMap>>;
-    data?: () => T | Array<T> | Promise<Array<T>> | Promise<T>;
+    data?: () => T | T[] | Promise<T[]> | Promise<T>;
 }, children?: import("../Node/vNode.types").vNode[] | import("../Node/vNode.types").vNodeChildrenFunction<T>) => import("../Node/vNode.types").vNode;
 export declare const p: <T>(config: {
     props?: import("../Node/vNode.types").FunctionOr<import("../Utils/utils.types").RecursivePartial<HTMLElement>>;
@@ -172,7 +172,7 @@ export declare const p: <T>(config: {
         [name: string]: string;
     }>;
     on?: import("../Node/vNode.types").FunctionOr<import("../Node/vNode.types").vNodeEvents<HTMLElementEventMap>>;
-    data?: () => T | Array<T> | Promise<Array<T>> | Promise<T>;
+    data?: () => T | T[] | Promise<T[]> | Promise<T>;
 }, children?: import("../Node/vNode.types").vNode[] | import("../Node/vNode.types").vNodeChildrenFunction<T>) => import("../Node/vNode.types").vNode;
 export declare const label: <T>(config: {
     props?: import("../Node/vNode.types").FunctionOr<import("../Utils/utils.types").RecursivePartial<HTMLElement>>;
@@ -180,7 +180,7 @@ export declare const label: <T>(config: {
         [name: string]: string;
     }>;
     on?: import("../Node/vNode.types").FunctionOr<import("../Node/vNode.types").vNodeEvents<HTMLElementEventMap>>;
-    data?: () => T | Array<T> | Promise<Array<T>> | Promise<T>;
+    data?: () => T | T[] | Promise<T[]> | Promise<T>;
 }, children?: import("../Node/vNode.types").vNode[] | import("../Node/vNode.types").vNodeChildrenFunction<T>) => import("../Node/vNode.types").vNode;
 export declare const pre: <T>(config: {
     props?: import("../Node/vNode.types").FunctionOr<import("../Utils/utils.types").RecursivePartial<HTMLElement>>;
@@ -188,6 +188,6 @@ export declare const pre: <T>(config: {
         [name: string]: string;
     }>;
     on?: import("../Node/vNode.types").FunctionOr<import("../Node/vNode.types").vNodeEvents<HTMLElementEventMap>>;
-    data?: () => T | Array<T> | Promise<Array<T>> | Promise<T>;
+    data?: () => T | T[] | Promise<T[]> | Promise<T>;
 }, children?: import("../Node/vNode.types").vNode[] | import("../Node/vNode.types").vNodeChildrenFunction<T>) => import("../Node/vNode.types").vNode;
 export declare const text: (callback: () => string) => import("../Node/vNode.types").vNode;

package/DOM/index.d.ts

@@ -1 +1,3 @@
 export * from "./elements";
+export * from "./createPropertyAssignment";
+export * from "./createEventAssignment";

package/DOM/index.js

@@ -16,5 +16,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./elements"), exports);
 // export * from "./svgElements";
-// export * from "./createPropertyAssignment";
-// export * from "./createEventAssignment";
+__exportStar(require("./createPropertyAssignment"), exports);
+__exportStar(require("./createEventAssignment"), exports);

package/Node/vNode.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.vNode = void 0;
 const Store_1 = require("../Store");
 const observableScope_1 = require("../Store/Tree/observableScope");
+const emitter_1 = require("../Utils/emitter");
 const functions_1 = require("../Utils/functions");
 const injector_1 = require("../Utils/injector");
 const thread_1 = require("../Utils/thread");
@@ -21,6 +22,7 @@ var vNode;
             node: definition.node ?? null,
             children: null,
             destroyed: false,
+            onDestroyed: null,
             component: null,
             scopes: [],
         };
@@ -34,6 +36,7 @@ var vNode;
             node: nodeConfig_1.NodeConfig.createTextNode(text),
             children: null,
             destroyed: false,
+            onDestroyed: null,
             component: null,
             scopes: [],
         };
@@ -56,6 +59,7 @@ var vNode;
         vnode.destroyed = true;
         vnode.component?.Destroy();
         Store_1.ObservableScope.DestroyAll(vnode.scopes);
+        vnode.onDestroyed && emitter_1.Emitter.Emit(vnode.onDestroyed);
         for (let x = 0; vnode.children && x < vnode.children.length; x++) {
             DestroyAll(vnode.children[x][1]);
             Store_1.ObservableScope.Destroy(vnode.children[x][2]);

package/Node/vNode.types.d.ts

@@ -2,6 +2,7 @@ import { Component } from "./component";
 import { IObservableScope } from "../Store/Tree/observableScope";
 import { Injector } from "../Utils/injector";
 import { RecursivePartial } from "../Utils/utils.types";
+import { Emitter } from "../Utils/emitter";
 export type FunctionOr<T> = {
     (): T | Promise<T>;
 } | T;
@@ -20,6 +21,7 @@ export type vNode = {
     node: Node | null;
     children: [any, vNode[], IObservableScope<string | vNode | vNode[]> | null][] | null;
     destroyed: boolean;
+    onDestroyed: Emitter | null;
     scopes: IObservableScope<unknown>[];
     component: Component;
 };

package/Store/Diff/diffAsync.d.ts

@@ -1,18 +1,46 @@
 import { IDiffTree } from "./diffTree";
 import { JsonDiffResult } from "../../Utils/json";
+/**
+ * Async version of IDiffTree interface with all methods returning promises.
+ */
 type IDiffTreeAsync = {
     [property in keyof IDiffTree]: (...args: Parameters<IDiffTree[property]>) => Promise<ReturnType<IDiffTree[property]>>;
 };
+/**
+ * Asynchronous diff implementation using web workers.
+ * Offloads diff computation to a worker to prevent blocking the main thread.
+ *
+ * @see StoreAsync
+ * @see DiffSync
+ */
 export declare class DiffAsync implements IDiffTreeAsync {
     private workerQueue;
+    /**
+     * Creates a DiffAsync instance and initializes the worker.
+     * @param keyFunc - Optional function to extract a key from objects
+     */
     constructor(keyFunc?: {
         (val: any): string;
     });
+    /**
+     * Computes the diff between a new value and the current value at a path asynchronously.
+     * @param path - Dot-separated path to the value
+     * @param value - The new value to compare
+     * @returns Promise that resolves to diff results showing changes
+     */
     DiffPath(path: string, value: any): Promise<JsonDiffResult>;
+    /**
+     * Computes diffs for a batch of path/value pairs asynchronously.
+     * @param data - Array of objects with path and value properties
+     * @returns Promise that resolves to combined diff results
+     */
     DiffBatch(data: Array<{
         path: string;
         value: any;
     }>): Promise<JsonDiffResult>;
+    /**
+     * Destroys the DiffAsync instance and terminates the worker.
+     */
     Destroy(): void;
 }
 export {};

package/Store/Diff/diffAsync.js

@@ -3,7 +3,18 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.DiffAsync = void 0;
 const workerQueue_1 = require("./workerQueue");
 const diffWorker_1 = require("./diffWorker");
+/**
+ * Asynchronous diff implementation using web workers.
+ * Offloads diff computation to a worker to prevent blocking the main thread.
+ *
+ * @see StoreAsync
+ * @see DiffSync
+ */
 class DiffAsync {
+    /**
+     * Creates a DiffAsync instance and initializes the worker.
+     * @param keyFunc - Optional function to extract a key from objects
+     */
     constructor(keyFunc) {
         this.workerQueue = new workerQueue_1.WorkerQueue(diffWorker_1.DiffWorker.Create());
         this.workerQueue.Push({
@@ -11,18 +22,32 @@ class DiffAsync {
             arguments: keyFunc ? [keyFunc.toString()] : [],
         });
     }
+    /**
+     * Computes the diff between a new value and the current value at a path asynchronously.
+     * @param path - Dot-separated path to the value
+     * @param value - The new value to compare
+     * @returns Promise that resolves to diff results showing changes
+     */
     async DiffPath(path, value) {
         return await this.workerQueue.Push({
             method: "diffpath",
             arguments: [path, value],
         });
     }
+    /**
+     * Computes diffs for a batch of path/value pairs asynchronously.
+     * @param data - Array of objects with path and value properties
+     * @returns Promise that resolves to combined diff results
+     */
     async DiffBatch(data) {
         return await this.workerQueue.Push({
             method: "diffbatch",
             arguments: [data],
         });
     }
+    /**
+     * Destroys the DiffAsync instance and terminates the worker.
+     */
     Destroy() {
         this.workerQueue.Destroy();
     }

package/Store/Diff/diffSync.d.ts

@@ -1,10 +1,32 @@
 import { IDiffTree } from "./diffTree";
+/**
+ * Synchronous diff implementation.
+ * Computes diffs immediately without queuing or workers.
+ *
+ * @see StoreSync
+ * @see DiffAsync
+ */
 export declare class DiffSync implements IDiffTree {
     private diffTree;
+    /**
+     * Creates a DiffSync instance.
+     * @param keyFunc - Optional function to extract a key from objects
+     */
     constructor(keyFunc?: {
         (val: any): string;
     });
+    /**
+     * Computes the diff between a new value and the current value at a path.
+     * @param path - Dot-separated path to the value
+     * @param value - The new value to compare
+     * @returns Diff results showing changes
+     */
     DiffPath(path: string, value: any): import("../../Utils/json").JsonDiffResult;
+    /**
+     * Computes diffs for a batch of path/value pairs.
+     * @param data - Array of objects with path and value properties
+     * @returns Combined diff results
+     */
     DiffBatch(data: Array<{
         path: string;
         value: any;

package/Store/Diff/diffSync.js

@@ -4,13 +4,35 @@ exports.DiffSync = void 0;
 const json_1 = require("../../Utils/json");
 const diffTree_1 = require("./diffTree");
 const diffCnstr = (0, diffTree_1.DiffTreeFactory)(json_1.JsonDiffFactory);
+/**
+ * Synchronous diff implementation.
+ * Computes diffs immediately without queuing or workers.
+ *
+ * @see StoreSync
+ * @see DiffAsync
+ */
 class DiffSync {
+    /**
+     * Creates a DiffSync instance.
+     * @param keyFunc - Optional function to extract a key from objects
+     */
     constructor(keyFunc) {
         this.diffTree = new diffCnstr(keyFunc);
     }
+    /**
+     * Computes the diff between a new value and the current value at a path.
+     * @param path - Dot-separated path to the value
+     * @param value - The new value to compare
+     * @returns Diff results showing changes
+     */
     DiffPath(path, value) {
         return this.diffTree.DiffPath(path, value);
     }
+    /**
+     * Computes diffs for a batch of path/value pairs.
+     * @param data - Array of objects with path and value properties
+     * @returns Combined diff results
+     */
     DiffBatch(data) {
         return this.diffTree.DiffBatch(data);
     }

package/Store/Diff/diffTree.d.ts

@@ -1,18 +1,51 @@
 import { JsonDiffFactoryResult, JsonDiffResult } from "../../Utils/json";
+/**
+ * Represents a method call for worker-based diff operations.
+ */
 export interface IDiffMethod {
+    /** The method to call */
     method: "create" | "diffpath" | "diffbatch" | "updatepath" | "getpath";
+    /** Arguments for the method call */
     arguments: Array<any>;
 }
+/**
+ * Interface for diff tree operations.
+ */
 export interface IDiffTree {
+    /**
+     * Computes diffs for a batch of path/value pairs.
+     * @param data - Array of objects with path and value properties
+     * @returns Combined diff results
+     */
     DiffBatch(data: Array<{
         path: string;
         value: any;
     }>): JsonDiffResult;
+    /**
+     * Computes the diff between a new value and the current value at a path.
+     * @param path - Dot-separated path to the value
+     * @param value - The new value to compare
+     * @returns Diff results showing changes
+     */
     DiffPath(path: string, value: any): JsonDiffResult;
 }
+/**
+ * Constructor interface for IDiffTree.
+ */
 export interface IDiffTreeConstructor {
+    /**
+     * Creates a new IDiffTree instance.
+     * @param keyFunc - Optional function to extract a key from a value
+     */
     new (keyFunc?: {
         (val: any): string;
     }): IDiffTree;
 }
+/**
+ * Factory function that creates a DiffTree class.
+ * Can operate in worker mode for async operations.
+ * @param jsonDiffFactory - Optional factory for JSON diff utilities
+ * @param worker - If true, sets up worker message handling
+ * @returns DiffTree constructor
+ */
 export declare function DiffTreeFactory(jsonDiffFactory?: () => JsonDiffFactoryResult, worker?: boolean): IDiffTreeConstructor;