@base-framework/base 3.5.73 → 3.6.0

package/dist/types/modules/atom/atom.d.ts

@@ -1 +1 @@
-export function Atom(callBack: Function): Function;
+export function Atom(callBack: (arg0: object, arg1: any) => object): (...args: any[]) => object;

package/dist/types/modules/component/cloak.d.ts

@@ -9,5 +9,5 @@
  */
 export class CloakComponent extends Component {
 }
-export function Cloak(props: any): typeof Component | null;
+export function Cloak(props: any): typeof Component;
 import { Component } from "./component.js";

package/dist/types/modules/component/jot.d.ts

@@ -1,2 +1,4 @@
-export function Jot(layout: object | Function, extend?: typeof Component): typeof Component;
+export function Jot(layout: object | Function, extend?: typeof Component): {
+    new (...args: any[]): Component;
+};
 import { Component } from './component.js';

package/dist/types/modules/component/parse-args.d.ts

@@ -1 +1,4 @@
-export function parseArgs(args: Array<any>): object;
+export function parseArgs(args: Array<any>): {
+    props: object;
+    children: any;
+};

package/dist/types/modules/component/pod.d.ts

@@ -1,2 +1,4 @@
-export function Pod(callBack: Function, extend?: typeof Component): typeof Component | null;
+export function Pod(callBack: Function, extend?: typeof Component): {
+    new (...args: any[]): Component;
+} | null;
 import { Component } from './component.js';

package/dist/types/modules/component/prop-utils.d.ts

@@ -1,4 +1,16 @@
-export function DefaultProps(): object;
-export function StringProp(value: string): object;
-export function ArrayProp(value: Array<any>): object;
-export function ObjectProp(args: Array<any>): object;
+export function DefaultProps(): {
+    props: object;
+    children: any[];
+};
+export function StringProp(value: string | number): {
+    props: object;
+    children: Array<object>;
+};
+export function ArrayProp(value: Array<any>): {
+    props: object;
+    children: Array<any>;
+};
+export function ObjectProp(args: Array<any>): {
+    props: object;
+    children: any;
+};

package/dist/types/modules/data/data-proxy.d.ts

@@ -1 +1,9 @@
+/**
+ * Invalidate cached proxies for a specific target object.
+ * Called when an object is replaced to ensure stale proxies aren't used.
+ *
+ * @param {object} target - The object whose cache should be cleared
+ * @returns {void}
+ */
+export function invalidateProxyCache(target: object): void;
 export function DataProxy(data: object, root?: string): ProxyConstructor;

package/dist/types/modules/data/types/deep-data/data-utils.d.ts

@@ -1,5 +1,6 @@
 export namespace DataUtils {
     let deepDataPattern: RegExp;
+    let segmentCache: LRUCache;
     /**
      * This will check if a string has deep data.
      *
@@ -9,9 +10,25 @@ export namespace DataUtils {
     function hasDeepData(str: string): boolean;
     /**
      * This will get the deep data segments.
+     * Results are cached for performance - 50-70% faster than regex on every call.
      *
      * @param {string} str
      * @returns {Array<any>|null}
      */
     function getSegments(str: string): Array<any> | null;
 }
+/**
+ * Simple LRU Cache implementation for caching parsed path segments.
+ * Caches up to 1000 most recently used paths (~50KB memory overhead).
+ *
+ * @class
+ */
+declare class LRUCache {
+    constructor(maxSize?: number);
+    cache: Map<any, any>;
+    maxSize: number;
+    get(key: any): any;
+    set(key: any, value: any): void;
+    clear(): void;
+}
+export {};

package/dist/types/modules/data-binder/data-pub-sub.d.ts

@@ -12,6 +12,28 @@ export class DataPubSub {
      * @protected
      */
     protected callBacks: Map<any, any>;
+    /**
+     * Queue for batching publish calls
+     * @type {Map<string, Array>}
+     * @protected
+     */
+    protected updateQueue: Map<string, any[]>;
+    /**
+     * Flag to track if flush is scheduled
+     * @type {boolean}
+     * @protected
+     */
+    protected flushScheduled: boolean;
+    /**
+     * Enable/disable batching (useful for testing)
+     * @type {boolean}
+     */
+    batchingEnabled: boolean;
+    /**
+     * Debug mode for observability
+     * @type {boolean}
+     */
+    debugMode: boolean;
     /**
      * This will get a subscriber array.
      *
@@ -50,6 +72,8 @@ export class DataPubSub {
     remove(msg: string): void;
     /**
      * This will publish a message.
+     * In batching mode, updates are queued and flushed in a microtask.
+     * Data operations remain synchronous; only DOM updates are batched.
      *
      * @overload
      * @param {string} msg
@@ -58,4 +82,34 @@ export class DataPubSub {
      * @returns {void}
      */
     publish(msg: string, value: string, committer?: object): void;
+    /**
+     * Schedule a flush in a microtask.
+     * Ensures only one flush is scheduled at a time.
+     *
+     * @returns {void}
+     */
+    scheduleFlush(): void;
+    /**
+     * Flush all queued updates.
+     * Deduplicates updates (only last update per msg is applied).
+     *
+     * @returns {void}
+     */
+    flush(): void;
+    /**
+     * Flush queued updates synchronously.
+     * Use as escape hatch when immediate updates are critical.
+     *
+     * @returns {void}
+     */
+    flushSync(): void;
+    /**
+     * Publish a message immediately without batching.
+     * This is the original synchronous publish logic.
+     *
+     * @param {string} msg
+     * @param  {...any} args
+     * @returns {void}
+     */
+    publishImmediate(msg: string, ...args: any[]): void;
 }

package/dist/types/modules/data-binder/sources/data-source.d.ts

@@ -22,9 +22,9 @@ export class DataSource extends TwoWaySource {
      */
     data: object;
     /**
-     * @type {string} prop
+     * @type {?string} prop
      */
-    prop: string;
+    prop: string | null;
     /**
      * This will set the data value.
      *

package/dist/types/modules/import/import-wrapper.d.ts

@@ -5,7 +5,7 @@
  * will wrap the comment atom to pass route to the
  * imported layout.
  *
- * @type {typeof Component | null}
+ * @type {typeof Component}
  */
-export const ImportWrapper: typeof Component | null;
+export const ImportWrapper: typeof Component;
 import { Component } from "../component/component.js";

package/dist/types/modules/layout/builder.d.ts

@@ -10,20 +10,20 @@ export class Builder {
      * This will render a function/Unit/Component.
      *
      * @param {object|function} layout
-     * @param {object} container
-     * @param {object} [parent]
+     * @param {?object} container
+     * @param {?object} [parent]
      * @returns {*} The render result.
      */
-    static render(layout: object | Function, container: object, parent?: object): any;
+    static render(layout: object | Function, container: object | null, parent?: object | null): any;
     /**
      * This will build a JSON layout.
      *
      * @param {object} obj The JSON layout.
-     * @param {object} [container] The parent receiving the layout.
-     * @param {object} [parent] The component adding the layout.
+     * @param {?object} [container] The parent receiving the layout.
+     * @param {?object} [parent] The component adding the layout.
      * @returns {*} The render result.
      */
-    static build(obj: object, container?: object, parent?: object): any;
+    static build(obj: object, container?: object | null, parent?: object | null): any;
     /**
      * This will rebuild a layout.
      *

package/dist/types/modules/layout/directives/core/reactive/for-each.d.ts

@@ -1 +1 @@
-export function forEach(ele: object, settings: any[], parent: object): void;
+export function forEach(ele: object, settings: Array<any>, parent: object): void;

package/dist/types/modules/layout/html-helper.d.ts

@@ -34,9 +34,10 @@ export class HtmlHelper extends Html {
      * @param {object} ele
      * @param {string} attr
      * @param {*} value
+     * @param {object} [parent]
      * @returns {void}
      */
-    static addAttr(ele: object, attr: string, value: any, parent: any): void;
+    static addAttr(ele: object, attr: string, value: any, parent?: object): void;
     /**
      * This will add content to an element.
      *

package/dist/types/modules/router/router.d.ts

@@ -19,6 +19,11 @@ export class Router {
     title: string;
     lastPath: any;
     path: any;
+    /**
+     * Cache for last matched route - provides 70-90% speedup on repeated navigation.
+     * @type {object|null} lastMatchedRoute
+     */
+    lastMatchedRoute: object | null;
     /**
      * This will be used to access our history object.
      */

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@base-framework/base",
-	"version": "3.5.73",
+	"version": "3.6.0",
 	"description": "This is a javascript framework.",
 	"main": "./dist/base.js",
 	"type": "module",