@meonode/ui 0.2.13 → 0.2.15

package/dist/components/html.node.d.ts

@@ -7,16 +7,33 @@
 export declare const Div: (<AdditionalProps extends Record<string, any> = Record<string, any>>(props?: import("../node.type").MergedProps<"div", AdditionalProps> | undefined) => import("../node.type").NodeInstance<"div">) & {
     element: "div";
 };
+/**
+ * Alias for \`Div(...)\`. Recommended for general-purpose container elements.
+ *
+ * **Example:**
+ * ```typescript
+ * Container({
+ *   padding: 'theme.spacing.md',
+ *   backgroundColor: 'lightgray',
+ *   children: [H2('Welcome'), P('This is a container example.')]
+ * })
+ * ```
+ */
+export declare const Container: (<AdditionalProps extends Record<string, any> = Record<string, any>>(props?: import("../node.type").MergedProps<"div", AdditionalProps> | undefined) => import("../node.type").NodeInstance<"div">) & {
+    element: "div";
+};
 /**
  * Represents a root div element with full viewport dimensions and column flex layout.
  * By default, applies flex column layout and 100% viewport dimensions.
  * @param props Optional properties for the root div element that merge with defaults.
  * @returns A div element node configured as root container.
  * @example
+ * ```typescript
  * Root({
- * backgroundColor: 'white',
- * children: [Header(), Main(), Footer()]
+ *   backgroundColor: 'white',
+ *   children: [Header(), Main(), Footer()]
  * })
+ * ```
  */
 export declare const Root: (<AdditionalProps extends Record<string, any> = Record<string, any>>(props?: import("../node.type").MergedProps<"div", AdditionalProps> | undefined) => import("../node.type").NodeInstance<"div">) & {
     element: "div";
@@ -207,7 +224,9 @@ export declare const P: (<AdditionalProps extends Record<string, any> = Record<s
  * Renders a semantic block of text using a `<p>` element.
  * Alias for `P(...)`, recommended for general-purpose text content.
  * @example
- * Text('Hello world', { fontSize: 'theme.text.md' })
+ * ```typescript
+ * Text('This is a sample text paragraph.', { fontSize: 'theme.text.base', color: 'theme.text.primary' })
+ * ```
  */
 export declare const Text: (<AdditionalProps extends Record<string, any> = Record<string, any>>(children?: import("../node.type").NodeElement[] | import("../node.type").NodeElement, props?: Omit<import("../node.type").MergedProps<"p", AdditionalProps>, "children"> | undefined) => import("../node.type").NodeInstance<"p">) & {
     element: "p";

package/dist/components/html.node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"html.node.d.ts","sourceRoot":"","sources":["../../src/components/html.node.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"html.node.d.ts","sourceRoot":"","sources":["../../src/components/html.node.ts"],"names":[],"mappings":"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"}

package/dist/components/html.node.js

@@ -4,15 +4,28 @@
  * @param props Optional properties for the div element.
  * @returns A div element node.
  */export var Div=createNode("div");/**
+ * Alias for \`Div(...)\`. Recommended for general-purpose container elements.
+ *
+ * **Example:**
+ * ```typescript
+ * Container({
+ *   padding: 'theme.spacing.md',
+ *   backgroundColor: 'lightgray',
+ *   children: [H2('Welcome'), P('This is a container example.')]
+ * })
+ * ```
+ */export var Container=Div;/**
  * Represents a root div element with full viewport dimensions and column flex layout.
  * By default, applies flex column layout and 100% viewport dimensions.
  * @param props Optional properties for the root div element that merge with defaults.
  * @returns A div element node configured as root container.
  * @example
+ * ```typescript
  * Root({
- * backgroundColor: 'white',
- * children: [Header(), Main(), Footer()]
+ *   backgroundColor: 'white',
+ *   children: [Header(), Main(), Footer()]
  * })
+ * ```
  */export var Root=createNode("div",{display:"flex",flexDirection:"column",minHeight:"100vh",minWidth:"100vw"});/**
  * Represents a column layout using flexbox.
  * @param props Optional properties for the column layout.
@@ -115,7 +128,9 @@
  * Renders a semantic block of text using a `<p>` element.
  * Alias for `P(...)`, recommended for general-purpose text content.
  * @example
- * Text('Hello world', { fontSize: 'theme.text.md' })
+ * ```typescript
+ * Text('This is a sample text paragraph.', { fontSize: 'theme.text.base', color: 'theme.text.primary' })
+ * ```
  */export var Text=P;/**
  * Creates a preformatted text element node.
  * @param children The content to be rendered within the element (text, numbers, components, etc) for the pre element.

package/dist/components/styled-renderer.client.js

@@ -1 +1 @@
-"use client";var _excluded=["element","css","children"];function _typeof(a){"@babel/helpers - typeof";return _typeof="function"==typeof Symbol&&"symbol"==typeof Symbol.iterator?function(a){return typeof a}:function(a){return a&&"function"==typeof Symbol&&a.constructor===Symbol&&a!==Symbol.prototype?"symbol":typeof a},_typeof(a)}function ownKeys(a,b){var c=Object.keys(a);if(Object.getOwnPropertySymbols){var d=Object.getOwnPropertySymbols(a);b&&(d=d.filter(function(b){return Object.getOwnPropertyDescriptor(a,b).enumerable})),c.push.apply(c,d)}return c}function _objectSpread(a){for(var b,c=1;c<arguments.length;c++)b=null==arguments[c]?{}:arguments[c],c%2?ownKeys(Object(b),!0).forEach(function(c){_defineProperty(a,c,b[c])}):Object.getOwnPropertyDescriptors?Object.defineProperties(a,Object.getOwnPropertyDescriptors(b)):ownKeys(Object(b)).forEach(function(c){Object.defineProperty(a,c,Object.getOwnPropertyDescriptor(b,c))});return a}function _defineProperty(a,b,c){return(b=_toPropertyKey(b))in a?Object.defineProperty(a,b,{value:c,enumerable:!0,configurable:!0,writable:!0}):a[b]=c,a}function _toPropertyKey(a){var b=_toPrimitive(a,"string");return"symbol"==_typeof(b)?b:b+""}function _toPrimitive(a,b){if("object"!=_typeof(a)||!a)return a;var c=a[Symbol.toPrimitive];if(void 0!==c){var d=c.call(a,b||"default");if("object"!=_typeof(d))return d;throw new TypeError("@@toPrimitive must return a primitive value.")}return("string"===b?String:Number)(a)}function _objectWithoutProperties(a,b){if(null==a)return{};var c,d,e=_objectWithoutPropertiesLoose(a,b);if(Object.getOwnPropertySymbols){var f=Object.getOwnPropertySymbols(a);for(d=0;d<f.length;d++)c=f[d],-1===b.indexOf(c)&&{}.propertyIsEnumerable.call(a,c)&&(e[c]=a[c])}return e}function _objectWithoutPropertiesLoose(a,b){if(null==a)return{};var c={};for(var d in a)if({}.hasOwnProperty.call(a,d)){if(-1!==b.indexOf(d))continue;c[d]=a[d]}return c}import{jsx}from"@emotion/react";export default function StyledRenderer(a){var b=a.element,c=a.css,d=a.children,e=_objectWithoutProperties(a,_excluded);return jsx(b,_objectSpread(_objectSpread({},e),{},{css:c}),d)}
+"use client";var _excluded=["element","css","children"];function _typeof(a){"@babel/helpers - typeof";return _typeof="function"==typeof Symbol&&"symbol"==typeof Symbol.iterator?function(a){return typeof a}:function(a){return a&&"function"==typeof Symbol&&a.constructor===Symbol&&a!==Symbol.prototype?"symbol":typeof a},_typeof(a)}function ownKeys(a,b){var c=Object.keys(a);if(Object.getOwnPropertySymbols){var d=Object.getOwnPropertySymbols(a);b&&(d=d.filter(function(b){return Object.getOwnPropertyDescriptor(a,b).enumerable})),c.push.apply(c,d)}return c}function _objectSpread(a){for(var b,c=1;c<arguments.length;c++)b=null==arguments[c]?{}:arguments[c],c%2?ownKeys(Object(b),!0).forEach(function(c){_defineProperty(a,c,b[c])}):Object.getOwnPropertyDescriptors?Object.defineProperties(a,Object.getOwnPropertyDescriptors(b)):ownKeys(Object(b)).forEach(function(c){Object.defineProperty(a,c,Object.getOwnPropertyDescriptor(b,c))});return a}function _defineProperty(a,b,c){return(b=_toPropertyKey(b))in a?Object.defineProperty(a,b,{value:c,enumerable:!0,configurable:!0,writable:!0}):a[b]=c,a}function _toPropertyKey(a){var b=_toPrimitive(a,"string");return"symbol"==_typeof(b)?b:b+""}function _toPrimitive(a,b){if("object"!=_typeof(a)||!a)return a;var c=a[Symbol.toPrimitive];if(void 0!==c){var d=c.call(a,b||"default");if("object"!=_typeof(d))return d;throw new TypeError("@@toPrimitive must return a primitive value.")}return("string"===b?String:Number)(a)}function _objectWithoutProperties(a,b){if(null==a)return{};var c,d,e=_objectWithoutPropertiesLoose(a,b);if(Object.getOwnPropertySymbols){var f=Object.getOwnPropertySymbols(a);for(d=0;d<f.length;d++)c=f[d],-1===b.indexOf(c)&&{}.propertyIsEnumerable.call(a,c)&&(e[c]=a[c])}return e}function _objectWithoutPropertiesLoose(a,b){if(null==a)return{};var c={};for(var d in a)if({}.hasOwnProperty.call(a,d)){if(-1!==b.indexOf(d))continue;c[d]=a[d]}return c}import{jsx}from"@emotion/react";export default function StyledRenderer(a){var b=a.element,c=a.css,d=a.children,e=_objectWithoutProperties(a,_excluded);return jsx(b,_objectSpread(_objectSpread({},e),{},{css:c}),d)}StyledRenderer.displayName="Styled";

package/dist/core.node.d.ts

@@ -1,5 +1,5 @@
-import { type ElementType, type ReactNode, type ReactElement } from 'react';
-import type { MergedProps, FinalNodeProps, HasRequiredProps, NodeElement, NodeInstance, NodeProps, PropsOf, RawNodeProps, Theme } from './node.type.js';
+import React, { type ElementType, type ReactElement, type ReactNode } from 'react';
+import type { FinalNodeProps, HasRequiredProps, MergedProps, NodeElement, NodeInstance, NodeProps, PropsOf, RawNodeProps, Theme } from './node.type.js';
 import { type Root as ReactDOMRoot } from 'react-dom/client';
 /**
  * Represents a node in a React component tree with theme and styling capabilities.
@@ -27,6 +27,18 @@ export declare class BaseNode<E extends NodeElement> implements NodeInstance<E>
     private _childrenHash?;
     /** Cache for normalized children */
     private _normalizedChildren?;
+    /**
+     * WeakMap cache for processed children, keyed by object/array identity for GC friendliness.
+     * Each entry stores the hash, processed children, and a server-side flag.
+     */
+    private static _processedChildrenWeakCache;
+    /**
+     * Map cache for processed children, keyed by a stable string signature.
+     * Used for non-object cases or as a fallback. Each entry stores the processed children and a server-side flag.
+     */
+    private static _processedChildrenMapCache;
+    /** Maximum number of entries in the Map cache to prevent unbounded growth */
+    private static readonly _MAX_PROCESSED_CHILDREN_CACHE = 1000;
     /**
      * Constructs a new BaseNode instance.
      *
@@ -60,16 +72,58 @@ export declare class BaseNode<E extends NodeElement> implements NodeInstance<E>
      */
     private _processProps;
     /**
-     * Processes raw children, wrapping them in `BaseNode` instances where necessary
-     * and propagating the theme.
+     * Deeply clones processed children before returning them from cache so that each parent receives
+     * independent `BaseNode` instances (prevents sharing cycles and mutation bugs).
+     *
+     * - If the input is an array, each child is cloned recursively.
+     * - If the input is a `BaseNode`, a new instance is created with the same element and copied rawProps.
+     * - For other objects/primitives, the value is returned as-is (they are immutable or safe to reuse).
+     *
+     * This ensures that cached children are never shared between different parents in the React tree.
+     * @param processed The processed child or array of children to clone.
+     * @returns A deep clone of the processed children, safe for use in multiple parents.
+     * @private
+     */
+    private static _cloneProcessedChildren;
+    /**
+     * Retrieves cached processed children for a given set of `children` and an optional `theme`.
+     *
+     * - Skips caching entirely when executed on the server (returns `null`).
+     * - Uses a **WeakMap** for identity-based caching when `children` is an object or array,
+     * ensuring garbage collection safety.
+     * - Falls back to a **Map** keyed by a stable hash of `children` and `theme`
+     * for value-based caching.
+     * - Only returns cached entries that are **not server-side**.
+     * @param children The child node(s) to resolve cached results for.
+     * @param theme The theme context that may influence child processing.
+     * @returns A cloned version of the cached processed children if available, otherwise `null`.
+     * @private
+     */
+    private _getCachedChildren;
+    /**
+     * Caches processed children for a given set of children and theme.
+     * This method stores the processed NodeElement(s) in a Map keyed by a stable hash.
+     * The cache is bounded to avoid unbounded memory growth.
+     * No caching is performed on the server to avoid RSC issues.
+     * @param children The original children to cache.
+     * @param theme The theme associated with the children.
+     * @param processed The processed NodeElement(s) to cache.
+     * @private
+     */
+    private _setCachedChildren;
+    /**
+     * Recursively processes raw children, converting them into `BaseNode` instances as needed
+     * and propagating the provided theme.
+     *
+     * This method ensures consistent theme handling for all children and optimizes performance
+     * using caching strategies: a Map for client-side and no caching for server-side.
      *
-     * This method recursively processes each child to ensure consistent theme handling
-     * and to convert valid elements into `BaseNode` instances. It uses caching to
-     * optimize performance, with different strategies for server-side (string-based key)
-     * and client-side (WeakMap-based key) environments.
+     * - If `children` is an array, each child is processed individually.
+     * - If `children` is a single node, it is processed directly.
+     * - The processed result is cached on the client to avoid redundant work.
      * @param children The raw child or array of children to process.
      * @param theme The theme to propagate to the children.
-     * @returns The processed children, ready to be normalized for rendering.
+     * @returns The processed children, ready for normalization and rendering.
      * @private
      */
     private _processChildren;
@@ -91,7 +145,7 @@ export declare class BaseNode<E extends NodeElement> implements NodeInstance<E>
      * @private
      * @static
      */
-    static _renderProcessedNode(processedElement: NodeElement, passedTheme: Theme | undefined, passedKey: string | undefined): ReactNode;
+    static _renderProcessedNode(processedElement: NodeElement, passedTheme: Theme | undefined, passedKey: string | undefined): string | number | bigint | boolean | Iterable<ReactNode> | Promise<string | number | bigint | boolean | Iterable<ReactNode> | ReactElement<unknown, string | React.JSXElementConstructor<any>> | React.ReactPortal | null | undefined> | ReactElement<any, string | React.JSXElementConstructor<any>> | null | undefined;
     /**
      * Renders the output of a function-as-a-child, ensuring theme propagation.
      *
@@ -171,7 +225,7 @@ export declare class BaseNode<E extends NodeElement> implements NodeInstance<E>
      * @returns The rendered `ReactElement`.
      * @throws {Error} If the node's `element` is not a valid React element type.
      */
-    render(): ReactElement;
+    render(): ReactElement<FinalNodeProps>;
     /**
      * Ensures the necessary DOM elements for portal rendering are created and attached.
      *
@@ -210,7 +264,7 @@ export declare function Node<AdditionalProps extends Record<string, any>, E exte
 /**
  * Creates a curried node factory for a given React element or component type.
  *
- * Returns a function that, when called with props, produces a `BaseNode` instance.
+ * Returns a function that, when called with props, produces a `NodeInstance<E>`.
  * Useful for creating reusable node factories for specific components or element types.
  * @template AdditionalInitialProps Additional initial props to merge with node props.
  * @template E The React element or component type.

package/dist/core.node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"core.node.d.ts","sourceRoot":"","sources":["../src/core.node.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"core.node.d.ts","sourceRoot":"","sources":["../src/core.node.ts"],"names":[],"mappings":"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"}

package/dist/core.node.js

@@ -1,4 +1,4 @@
-"use strict";var _excluded=["ref","key","children","nodetheme","theme","props"],_excluded2=["style"],_excluded3=["style","css"],_excluded4=["style"],_excluded5=["children","key","nativeProps"];function _typeof(a){"@babel/helpers - typeof";return _typeof="function"==typeof Symbol&&"symbol"==typeof Symbol.iterator?function(a){return typeof a}:function(a){return a&&"function"==typeof Symbol&&a.constructor===Symbol&&a!==Symbol.prototype?"symbol":typeof a},_typeof(a)}function _objectWithoutProperties(a,b){if(null==a)return{};var c,d,e=_objectWithoutPropertiesLoose(a,b);if(Object.getOwnPropertySymbols){var f=Object.getOwnPropertySymbols(a);for(d=0;d<f.length;d++)c=f[d],-1===b.indexOf(c)&&{}.propertyIsEnumerable.call(a,c)&&(e[c]=a[c])}return e}function _objectWithoutPropertiesLoose(a,b){if(null==a)return{};var c={};for(var d in a)if({}.hasOwnProperty.call(a,d)){if(-1!==b.indexOf(d))continue;c[d]=a[d]}return c}function ownKeys(a,b){var c=Object.keys(a);if(Object.getOwnPropertySymbols){var d=Object.getOwnPropertySymbols(a);b&&(d=d.filter(function(b){return Object.getOwnPropertyDescriptor(a,b).enumerable})),c.push.apply(c,d)}return c}function _objectSpread(a){for(var b,c=1;c<arguments.length;c++)b=null==arguments[c]?{}:arguments[c],c%2?ownKeys(Object(b),!0).forEach(function(c){_defineProperty(a,c,b[c])}):Object.getOwnPropertyDescriptors?Object.defineProperties(a,Object.getOwnPropertyDescriptors(b)):ownKeys(Object(b)).forEach(function(c){Object.defineProperty(a,c,Object.getOwnPropertyDescriptor(b,c))});return a}function _defineProperty(a,b,c){return(b=_toPropertyKey(b))in a?Object.defineProperty(a,b,{value:c,enumerable:!0,configurable:!0,writable:!0}):a[b]=c,a}function _toPropertyKey(a){var b=_toPrimitive(a,"string");return"symbol"==_typeof(b)?b:b+""}function _toPrimitive(a,b){if("object"!=_typeof(a)||!a)return a;var c=a[Symbol.toPrimitive];if(void 0!==c){var d=c.call(a,b||"default");if("object"!=_typeof(d))return d;throw new TypeError("@@toPrimitive must return a primitive value.")}return("string"===b?String:Number)(a)}import React,{Fragment,createElement,isValidElement}from"react";import{createStableHash,isNodeInstance,resolveDefaultStyle}from"./helper/node.helper.js";import{isForwardRef,isFragment,isMemo,isReactClassComponent,isValidElementType}from"./helper/react-is.helper.js";import{createRoot}from"react-dom/client";import{getComponentType,getCSSProps,getDOMProps,getElementTypeName,hasNoStyleTag,shallowEqual}from"./helper/common.helper.js";import StyledRenderer from"./components/styled-renderer.client.js";import{resolveObjWithTheme}from"./helper/theme.helper.js";/**
+"use strict";var _excluded=["ref","key","children","nodetheme","theme","props"],_excluded2=["style"],_excluded3=["style","css"],_excluded4=["style"],_excluded5=["children","key","nativeProps"];function _objectWithoutProperties(a,b){if(null==a)return{};var c,d,e=_objectWithoutPropertiesLoose(a,b);if(Object.getOwnPropertySymbols){var f=Object.getOwnPropertySymbols(a);for(d=0;d<f.length;d++)c=f[d],-1===b.indexOf(c)&&{}.propertyIsEnumerable.call(a,c)&&(e[c]=a[c])}return e}function _objectWithoutPropertiesLoose(a,b){if(null==a)return{};var c={};for(var d in a)if({}.hasOwnProperty.call(a,d)){if(-1!==b.indexOf(d))continue;c[d]=a[d]}return c}function ownKeys(a,b){var c=Object.keys(a);if(Object.getOwnPropertySymbols){var d=Object.getOwnPropertySymbols(a);b&&(d=d.filter(function(b){return Object.getOwnPropertyDescriptor(a,b).enumerable})),c.push.apply(c,d)}return c}function _objectSpread(a){for(var b,c=1;c<arguments.length;c++)b=null==arguments[c]?{}:arguments[c],c%2?ownKeys(Object(b),!0).forEach(function(c){_defineProperty(a,c,b[c])}):Object.getOwnPropertyDescriptors?Object.defineProperties(a,Object.getOwnPropertyDescriptors(b)):ownKeys(Object(b)).forEach(function(c){Object.defineProperty(a,c,Object.getOwnPropertyDescriptor(b,c))});return a}function _typeof(a){"@babel/helpers - typeof";return _typeof="function"==typeof Symbol&&"symbol"==typeof Symbol.iterator?function(a){return typeof a}:function(a){return a&&"function"==typeof Symbol&&a.constructor===Symbol&&a!==Symbol.prototype?"symbol":typeof a},_typeof(a)}function _defineProperty(a,b,c){return(b=_toPropertyKey(b))in a?Object.defineProperty(a,b,{value:c,enumerable:!0,configurable:!0,writable:!0}):a[b]=c,a}function _toPropertyKey(a){var b=_toPrimitive(a,"string");return"symbol"==_typeof(b)?b:b+""}function _toPrimitive(a,b){if("object"!=_typeof(a)||!a)return a;var c=a[Symbol.toPrimitive];if(void 0!==c){var d=c.call(a,b||"default");if("object"!=_typeof(d))return d;throw new TypeError("@@toPrimitive must return a primitive value.")}return("string"===b?String:Number)(a)}import React,{createElement,Fragment,isValidElement}from"react";import{createStableHash,isNodeInstance,resolveDefaultStyle}from"./helper/node.helper.js";import{isForwardRef,isFragment,isMemo,isReactClassComponent,isValidElementType}from"./helper/react-is.helper.js";import{createRoot}from"react-dom/client";import{getComponentType,getCSSProps,getDOMProps,getElementTypeName,hasNoStyleTag}from"./helper/common.helper.js";import StyledRenderer from"./components/styled-renderer.client.js";import{resolveObjWithTheme}from"./helper/theme.helper.js";/**
  * Represents a node in a React component tree with theme and styling capabilities.
  * This class wraps React elements and handles:
  * - Props processing and normalization
@@ -6,7 +6,7 @@
  * - Child node processing and management
  * - Style processing with theme variables
  * @template E The type of React element or component this node represents
- */export class BaseNode{/** Hash of the current children and theme to detect changes *//** Cache for normalized children *//**
+ */export class BaseNode{/**
    * Constructs a new BaseNode instance.
    *
    * This constructor initializes a node with a given React element or component type
@@ -40,9 +40,11 @@
    * @returns A renderable `ReactNode`.
    * @throws {Error} If the child is not a valid React element type.
    * @private
-   */_defineProperty(this,"rawProps",{}),_defineProperty(this,"isBaseNode",!0),_defineProperty(this,"_portalDOMElement",null),_defineProperty(this,"_portalReactRoot",null),_defineProperty(this,"_generateKey",function(a){var b=a.nodeIndex,c=a.element,d=a.existingKey,e=a.children;if(d)return d;var f,g=getElementTypeName(c);return f=Array.isArray(e)&&0<e.length?void 0===b?"".concat(g,"-").concat(e.length):"".concat(g,"-").concat(b,"-").concat(e.length):void 0===b?g:"".concat(g,"-").concat(b),f}),_defineProperty(this,"_normalizeChild",function(a){var c,d;if(!a)return a;var e=(null===(c=b.rawProps)||void 0===c?void 0:c.nodetheme)||(null===(d=b.rawProps)||void 0===d?void 0:d.theme)||b.props.nodetheme||b.props.theme;// For BaseNode instances, apply current theme if child has no theme
-if(a instanceof BaseNode){var f;return null!==(f=a.rawProps)&&void 0!==f&&f.nodetheme||void 0===e?a.render():new BaseNode(a.element,_objectSpread(_objectSpread({},a.rawProps),{},{nodetheme:e})).render()}// Validate element type before returning
-if(!isValidElementType(a)){var g=getComponentType(a);throw new Error("Invalid element type: ".concat(g," provided!"))}// Return valid React elements as-is
+   */_defineProperty(this,"rawProps",{}),_defineProperty(this,"isBaseNode",!0),_defineProperty(this,"_portalDOMElement",null),_defineProperty(this,"_portalReactRoot",null),_defineProperty(this,"_generateKey",function(a){var b=a.nodeIndex,c=a.element,d=a.existingKey,e=a.children;if(d)return d;var f,g=getElementTypeName(c);return f=Array.isArray(e)&&0<e.length?void 0===b?"".concat(g,"-").concat(e.length):"".concat(g,"-").concat(b,"-").concat(e.length):void 0===b?g:"".concat(g,"-").concat(b),f}),_defineProperty(this,"_normalizeChild",function(a){var c,d;// Handle null/undefined quickly
+if(null===a||a===void 0)return a;// Primitives should be returned as-is (text nodes, numbers, booleans)
+var e=_typeof(a);if("string"===e||"number"===e||"boolean"===e)return a;var f=(null===(c=b.rawProps)||void 0===c?void 0:c.nodetheme)||(null===(d=b.rawProps)||void 0===d?void 0:d.theme)||b.props.nodetheme||b.props.theme;// For BaseNode instances, apply current theme if child has no theme
+if(a instanceof BaseNode){var g;return null!==(g=a.rawProps)&&void 0!==g&&g.nodetheme||void 0===f?a.render():new BaseNode(a.element,_objectSpread(_objectSpread({},a.rawProps),{},{nodetheme:f})).render()}// Validate element type before returning
+if(!isValidElementType(a)){var h=getComponentType(a);throw new Error("Invalid element type: ".concat(h," provided!"))}// Return valid React elements as-is
 return a}),this.element=a,this.rawProps=c}/**
    * Lazily processes and retrieves the final, normalized props for the node.
    *
@@ -65,19 +67,63 @@ return a}),this.element=a,this.rawProps=c}/**
 var a=this.rawProps,b=a.ref,c=a.key,d=a.children,e=a.nodetheme,f=a.theme,g=a.props,h=void 0===g?{}:g,i=_objectWithoutProperties(a,_excluded),j=f||e,k=h,l=k.style,m=_objectWithoutProperties(k,_excluded2),n=resolveObjWithTheme(i,j),o=resolveObjWithTheme(l,j),p=n.style,q=n.css,r=_objectWithoutProperties(n,_excluded3),s=getCSSProps(r),t=getDOMProps(r),u=resolveDefaultStyle(_objectSpread(_objectSpread({},s),p)),v=this._processChildren(d,j);// Process children while maintaining theme inheritance
 // Combine processed props into final normalized form
 return _objectSpread(_objectSpread({ref:b,key:c,nodetheme:j,theme:f,css:_objectSpread(_objectSpread({},u),q),style:o},t),{},{nativeProps:m,children:v})}/**
-   * Processes raw children, wrapping them in `BaseNode` instances where necessary
-   * and propagating the theme.
+   * Deeply clones processed children before returning them from cache so that each parent receives
+   * independent `BaseNode` instances (prevents sharing cycles and mutation bugs).
    *
-   * This method recursively processes each child to ensure consistent theme handling
-   * and to convert valid elements into `BaseNode` instances. It uses caching to
-   * optimize performance, with different strategies for server-side (string-based key)
-   * and client-side (WeakMap-based key) environments.
+   * - If the input is an array, each child is cloned recursively.
+   * - If the input is a `BaseNode`, a new instance is created with the same element and copied rawProps.
+   * - For other objects/primitives, the value is returned as-is (they are immutable or safe to reuse).
+   *
+   * This ensures that cached children are never shared between different parents in the React tree.
+   * @param processed The processed child or array of children to clone.
+   * @returns A deep clone of the processed children, safe for use in multiple parents.
+   * @private
+   */static _cloneProcessedChildren(a){var b=function cloneOne(a){return a instanceof BaseNode?new BaseNode(a.element,_objectSpread({},a.rawProps)):a;// NodeInstance returns its own instances when render() is called - we avoid calling render here.
+// For other objects/primitives, return as-is (they are immutable or safe to reuse).
+};return Array.isArray(a)?a.map(function(a){return b(a)}):b(a)}/**
+   * Retrieves cached processed children for a given set of `children` and an optional `theme`.
+   *
+   * - Skips caching entirely when executed on the server (returns `null`).
+   * - Uses a **WeakMap** for identity-based caching when `children` is an object or array,
+   * ensuring garbage collection safety.
+   * - Falls back to a **Map** keyed by a stable hash of `children` and `theme`
+   * for value-based caching.
+   * - Only returns cached entries that are **not server-side**.
+   * @param children The child node(s) to resolve cached results for.
+   * @param theme The theme context that may influence child processing.
+   * @returns A cloned version of the cached processed children if available, otherwise `null`.
+   * @private
+   */_getCachedChildren(a,b){if("undefined"==typeof window)return null;// No server caching
+// Compute hash once
+var c=createStableHash(a,b);// If children is an object (array or object), try identity-keyed WeakMap first
+if(a&&"object"===_typeof(a)){var d=BaseNode._processedChildrenWeakCache.get(a);if(d&&d.hash===c&&!d.isServerSide)return BaseNode._cloneProcessedChildren(d.children)}// Fallback to string-hash Map cache
+var e=BaseNode._processedChildrenMapCache.get(c);return e&&!e.isServerSide?BaseNode._cloneProcessedChildren(e.children):null}/**
+   * Caches processed children for a given set of children and theme.
+   * This method stores the processed NodeElement(s) in a Map keyed by a stable hash.
+   * The cache is bounded to avoid unbounded memory growth.
+   * No caching is performed on the server to avoid RSC issues.
+   * @param children The original children to cache.
+   * @param theme The theme associated with the children.
+   * @param processed The processed NodeElement(s) to cache.
+   * @private
+   */_setCachedChildren(a,b,c){if("undefined"!=typeof window){var d=createStableHash(a,b);if(a&&"object"===_typeof(a))return void BaseNode._processedChildrenWeakCache.set(a,{hash:d,children:c,isServerSide:!1});// Manage bounded Map cache (FIFO eviction)
+if(BaseNode._processedChildrenMapCache.has(d))return void BaseNode._processedChildrenMapCache.set(d,{children:c,isServerSide:!1});if(BaseNode._processedChildrenMapCache.size>=BaseNode._MAX_PROCESSED_CHILDREN_CACHE){var e=BaseNode._processedChildrenMapCache.keys().next().value;void 0!==e&&BaseNode._processedChildrenMapCache["delete"](e)}BaseNode._processedChildrenMapCache.set(d,{children:c,isServerSide:!1})}}/**
+   * Recursively processes raw children, converting them into `BaseNode` instances as needed
+   * and propagating the provided theme.
+   *
+   * This method ensures consistent theme handling for all children and optimizes performance
+   * using caching strategies: a Map for client-side and no caching for server-side.
+   *
+   * - If `children` is an array, each child is processed individually.
+   * - If `children` is a single node, it is processed directly.
+   * - The processed result is cached on the client to avoid redundant work.
    * @param children The raw child or array of children to process.
    * @param theme The theme to propagate to the children.
-   * @returns The processed children, ready to be normalized for rendering.
+   * @returns The processed children, ready for normalization and rendering.
    * @private
-   */_processChildren(a,b){var c=this;return a?Array.isArray(a)?a.map(function(a,d){return c._processRawNode(a,b,d)}):this._processRawNode(a,b):void 0;// No caching on the client, as it was ineffective and complex.
-}/**
+   */_processChildren(a,b){var c=this;if(a){// Use RSC-safe caching strategy
+var d=this._getCachedChildren(a,b);if(d)return d;var e=Array.isArray(a)?a.map(function(a,d){return c._processRawNode(a,b,d)}):this._processRawNode(a,b);// Only cache on client-side
+return"undefined"!=typeof window&&this._setCachedChildren(a,b,e),e}}/**
    * Renders a processed `NodeElement` into a `ReactNode`, applying a theme and key if necessary.
    *
    * This static method centralizes the logic for converting various types of processed elements
@@ -95,8 +141,7 @@ return _objectSpread(_objectSpread({ref:b,key:c,nodetheme:j,theme:f,css:_objectS
    * @private
    * @static
    */static _renderProcessedNode(a,b,c){var d={};// 1. BaseNode instance: re-wrap to apply key/theme if needed
-if(void 0!==c&&(d.key=c),a instanceof BaseNode){var e,f,g,h,i,j=(null===(e=a.rawProps)||void 0===e?void 0:e.theme)||(null===(f=a.rawProps)||void 0===f?void 0:f.nodetheme)||b;// Avoid creating new BaseNode if props are identical
-return shallowEqual(d,{key:null===(g=a.rawProps)||void 0===g?void 0:g.key})&&j===((null===(h=a.rawProps)||void 0===h?void 0:h.nodetheme)||(null===(i=a.rawProps)||void 0===i?void 0:i.theme))?a.render():new BaseNode(a.element,_objectSpread(_objectSpread(_objectSpread({},a.rawProps),d),{},{nodetheme:j})).render()}// 2. React class component type: wrap in BaseNode
+if(void 0!==c&&(d.key=c),a instanceof BaseNode){var e,f,g,h,i,j=(null===(e=a.rawProps)||void 0===e?void 0:e.theme)||(null===(f=a.rawProps)||void 0===f?void 0:f.nodetheme)||b,k=null===(g=a.rawProps)||void 0===g?void 0:g.key;return k===c&&j===((null===(h=a.rawProps)||void 0===h?void 0:h.nodetheme)||(null===(i=a.rawProps)||void 0===i?void 0:i.theme))?a.render():new BaseNode(a.element,_objectSpread(_objectSpread(_objectSpread({},a.rawProps),d),{},{nodetheme:j})).render()}// 2. React class component type: wrap in BaseNode
 return isReactClassComponent(a)?new BaseNode(a,d).render():isNodeInstance(a)?a.render():a instanceof React.Component?a.render():"function"==typeof a?createElement(a,{key:c}):a;// 3. NodeInstance object: call its render
 // 4. React.Component instance: call its render
 // 5. Functional component: create element with key
@@ -114,11 +159,11 @@ return isReactClassComponent(a)?new BaseNode(a,d).render():isNodeInstance(a)?a.r
    * @param props.processRawNode A reference to the `_processRawNode` method for recursive processing.
    * @returns The rendered `ReactNode`.
    * @private
-   */_functionRenderer(a){var b=a.render,c=a.passedTheme,d=a.passedKey,e=a.processRawNode,f=b();// Invoke the render function to get the child node.
-// Handle React.Component instance
-if(f instanceof React.Component){var g=f.render(),h=e(g,c);return BaseNode._renderProcessedNode(h,c,d)}// Handle BaseNode instance
-if(f instanceof BaseNode||isNodeInstance(f)){var i,j=f;return void 0===(null===(i=j.rawProps)||void 0===i?void 0:i.nodetheme)&&void 0!==c?new BaseNode(j.element,_objectSpread(_objectSpread({key:d},j.rawProps),{},{nodetheme:c})).render():j.render()}// Process other result types
-var k=e(f,c);return k?BaseNode._renderProcessedNode(k,c,d):f}/**
+   */_functionRenderer(a){var b,c=a.render,d=a.passedTheme,e=a.passedKey,f=a.processRawNode;// Invoke the render function to get the child node.
+try{b=c()}catch(a){b=null}// Handle React.Component instance
+if(b instanceof React.Component){var g=b.render(),h=f(g,d);return BaseNode._renderProcessedNode(h,d,e)}// Handle BaseNode instance
+if(b instanceof BaseNode||isNodeInstance(b)){var i,j=b;return void 0===(null===(i=j.rawProps)||void 0===i?void 0:i.nodetheme)&&void 0!==d?new BaseNode(j.element,_objectSpread(_objectSpread({key:e},j.rawProps),{},{nodetheme:d})).render():j.render()}// Process other result types
+var k=f(b,d);return k?BaseNode._renderProcessedNode(k,d,e):b}/**
    * Processes a single raw node, recursively converting it into a `BaseNode` or other renderable type.
    *
    * This is a central method for normalizing children. It handles various types of input:
@@ -178,7 +223,9 @@ return a}/**
 var c=this.props,d=c.children,e=c.key,f=c.nativeProps,g=_objectWithoutProperties(c,_excluded5),h=void 0;if(void 0!==d&&null!==d){if(!this._normalizedChildren||this._childrenHash!==createStableHash(d,this.props.nodetheme||this.props.theme))if(!Array.isArray(d))this._normalizedChildren=this._normalizeChild(d);else if(0<d.length){var i=d.map(function(b){return a._normalizeChild(b)});this._normalizedChildren=i.every(function(a){return null===a||void 0===a})?void 0:i}else this._normalizedChildren=void 0;h=this._normalizedChildren}// Prepare props for React.createElement
 var j;// If the element has a `css` prop and has style tag, render using the `StyledRenderer` component
 // This enables emotion-based style handling for the element
-return j=this.element===Fragment||isFragment(this.element)?{key:e}:_objectSpread(_objectSpread(_objectSpread({},g),{},{key:e},f),{},{suppressHydrationWarning:!0}),this.element&&!hasNoStyleTag(this.element)&&j.css?createElement(StyledRenderer,_objectSpread({element:this.element},j),h):createElement(this.element,j,h)}/**
+if(j=this.element===Fragment||isFragment(this.element)?{key:e}:_objectSpread(_objectSpread(_objectSpread({},g),{},{key:e},f),{},{suppressHydrationWarning:!0}),this.element&&!hasNoStyleTag(this.element)&&j.css){var k=_objectSpread({element:this.element},j);try{var l=getElementTypeName(k.element);StyledRenderer.displayName="Styled(".concat(l,")")}catch(a){// swallow: displayName is not critical
+}return createElement(StyledRenderer,k,h)}try{this.element.displayName=getElementTypeName(this.element)}catch(a){// swallow: displayName is not critical
+}return createElement(this.element,j,h)}/**
    * Ensures the necessary DOM elements for portal rendering are created and attached.
    *
    * On the client-side, this method checks for or creates a `div` element appended
@@ -187,7 +234,13 @@ return j=this.element===Fragment||isFragment(this.element)?{key:e}:_objectSpread
    * to call multiple times.
    * @returns `true` if the portal infrastructure is ready, `false` if on the server.
    * @private
-   */_ensurePortalInfrastructure(){if("undefined"==typeof window)return!1;if(this._portalDOMElement&&this._portalReactRoot)return!0;if(this._portalDOMElement&&!this._portalDOMElement.isConnected&&(this._portalDOMElement=null,this._portalDOMElement=null),this._portalDOMElement||(this._portalDOMElement=document.createElement("div"),document.body.appendChild(this._portalDOMElement)),!this._portalReactRoot){if(!this._portalDOMElement)return!1;this._portalReactRoot=createRoot(this._portalDOMElement)}return!0}/**
+   */_ensurePortalInfrastructure(){if("undefined"==typeof window)return!1;// If both exist and DOM is connected, we're ready
+if(this._portalDOMElement&&this._portalReactRoot&&this._portalDOMElement.isConnected)return!0;// If DOM element exists but isn't connected, clear both DOM element and root
+if(this._portalDOMElement&&!this._portalDOMElement.isConnected){// attempt to unmount root if present
+if(this._portalReactRoot){try{this._portalReactRoot.unmount()}catch(a){// swallow: unmount might fail if already removed; avoid breaking the app
+}this._portalReactRoot=null}this._portalDOMElement=null}// Create DOM element if needed
+// Create react root if needed
+if(this._portalDOMElement||(this._portalDOMElement=document.createElement("div"),document.body.appendChild(this._portalDOMElement)),!this._portalReactRoot){if(!this._portalDOMElement)return!1;this._portalReactRoot=createRoot(this._portalDOMElement)}return!0}/**
    * Renders the node into a React Portal.
    *
    * This method mounts the node's rendered content into a separate DOM tree
@@ -206,10 +259,10 @@ return j=this.element===Fragment||isFragment(this.element)?{key:e}:_objectSpread
  * @param props The props for the node (optional).
  * @param additionalProps Additional props to merge into the node (optional).
  * @returns A new `BaseNode` instance as a `NodeInstance<E>`.
- */export function Node(a){var b=1<arguments.length&&void 0!==arguments[1]?arguments[1]:{},c=2<arguments.length&&void 0!==arguments[2]?arguments[2]:{},d=_objectSpread(_objectSpread({},b),c);return d.theme&&!d.nodetheme&&(d.nodetheme=d.theme),new BaseNode(a,d)}/**
+ */_defineProperty(BaseNode,"_processedChildrenWeakCache",new WeakMap),_defineProperty(BaseNode,"_processedChildrenMapCache",new Map),_defineProperty(BaseNode,"_MAX_PROCESSED_CHILDREN_CACHE",1e3);export function Node(a){var b=1<arguments.length&&void 0!==arguments[1]?arguments[1]:{},c=2<arguments.length&&void 0!==arguments[2]?arguments[2]:{},d=_objectSpread(_objectSpread({},b),c);return d.theme&&!d.nodetheme&&(d.nodetheme=d.theme),new BaseNode(a,d)}/**
  * Creates a curried node factory for a given React element or component type.
  *
- * Returns a function that, when called with props, produces a `BaseNode` instance.
+ * Returns a function that, when called with props, produces a `NodeInstance<E>`.
  * Useful for creating reusable node factories for specific components or element types.
  * @template AdditionalInitialProps Additional initial props to merge with node props.
  * @template E The React element or component type.

package/dist/helper/common.helper.d.ts

@@ -77,6 +77,4 @@ export declare function getDOMProps<E extends ElementType, T extends ComponentPr
  * @returns `true` if the tag is in the no-style set, otherwise `false`.
  */
 export declare function hasNoStyleTag(tag?: NodeElement): boolean;
-// Shallow comparison utility
-export declare function shallowEqual(obj1: any, obj2: any): boolean;
 //# sourceMappingURL=common.helper.d.ts.map

package/dist/helper/common.helper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"common.helper.d.ts","sourceRoot":"","sources":["../../src/helper/common.helper.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAEpE,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,OAAO,CAAA;AAGvE;;;;;;;;;;GAUG;AACH,eAAO,MAAM,cAAc,iCAE1B,CAAA;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,gBAAgB,qCAmC5B,CAAA;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAsFxD;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,GAAG,CAAC,MAAM,CAA0B,CAAA;AAEjE;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,CAU3F;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,WAAW,EAAE,CAAC,SAAS,cAAc,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC,CAUjH;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,CAAC,EAAE,WAAW,GAAG,OAAO,CAGxD;AAED,6BAA6B;AAC7B,wBAAgB,YAAY,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAgB1D"}
+{"version":3,"file":"common.helper.d.ts","sourceRoot":"","sources":["../../src/helper/common.helper.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAEpE,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,OAAO,CAAA;AAGvE;;;;;;;;;;GAUG;AACH,eAAO,MAAM,cAAc,iCAE1B,CAAA;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,gBAAgB,qCAmC5B,CAAA;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAsFxD;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,GAAG,CAAC,MAAM,CAA0B,CAAA;AAEjE;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,CAU3F;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,WAAW,EAAE,CAAC,SAAS,cAAc,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC,CAUjH;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,CAAC,EAAE,WAAW,GAAG,OAAO,CAGxD"}

package/dist/helper/common.helper.js

@@ -61,5 +61,4 @@ function _typeof(a){"@babel/helpers - typeof";return _typeof="function"==typeof
  * Checks if a given tag is in the set of tags that should not receive style props.
  * @param tag The tag name to check (e.g., 'script', 'style').
  * @returns `true` if the tag is in the no-style set, otherwise `false`.
- */export function hasNoStyleTag(a){return!!(a&&"string"==typeof a)&&noStyleTagsSet.has(a.toLowerCase())}// Shallow comparison utility
-export function shallowEqual(a,b){if(a===b)return!0;if(!a||!b)return!1;if("object"!==_typeof(a)||"object"!==_typeof(b))return a===b;var c=Object.keys(a),d=Object.keys(b);if(c.length!==d.length)return!1;for(var e,f=0,g=c;f<g.length;f++)if(e=g[f],!(e in b)||a[e]!==b[e])return!1;return!0}
+ */export function hasNoStyleTag(a){return!!(a&&"string"==typeof a)&&noStyleTagsSet.has(a.toLowerCase())}

package/dist/helper/node.helper.d.ts

@@ -894,24 +894,13 @@ export declare const resolveDefaultStyle: (style: CSSProperties) => {
     minWidth: import("csstype").Property.MinWidth<string | number>;
 };
 /**
- * Creates a stable hash string based on the provided children and optional theme.
+ * Public: createStableHash
+ * Produces a deterministic string signature for children + theme.
+ * Keep traversal limited so it is cheap in large trees.
  *
- * This function generates a hash that represents the structure and types of the given
- * children nodes, along with an optional theme. The hash is designed to be stable across
- * renders, meaning that the same input will always produce the same hash output.
- *
- * The hashing strategy includes:
- * - For arrays of children, it includes the length and samples the types of the first few children.
- * - For single child nodes, it includes the type of the node.
- * - For primitive values (strings, numbers, etc.), it includes their type.
- * - If a theme is provided, it includes a stringified version of the theme.
- *
- * This approach avoids deep traversal of potentially large or complex node trees,
- * focusing instead on key characteristics that are likely to change when the structure
- * or content changes.
- * @param children The child nodes to hash, which can be a single node or an array of nodes.
- * @param theme An optional theme object or string to include in the hash.
- * @returns A stable hash string representing the structure and types of the children and theme.
+ * If you prefer a shorter hashed output, wrap the returned string in a lightweight
+ * hash function (fnv1a, xxhash, etc.). Returning the full signature is useful
+ * for debugging and deterministic comparisons.
  */
 export declare function createStableHash(children: NodeElement | NodeElement[], theme?: Theme): string;
 //# sourceMappingURL=node.helper.d.ts.map

package/dist/helper/node.helper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node.helper.d.ts","sourceRoot":"","sources":["../../src/helper/node.helper.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AAIzE;;;;;;;;;;GAUG;AACH,eAAO,MAAM,cAAc,4CAS1B,CAAA;AA4DD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiE/B,CAAA;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,WAAW,GAAG,WAAW,EAAE,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CA0B7F"}
+{"version":3,"file":"node.helper.d.ts","sourceRoot":"","sources":["../../src/helper/node.helper.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AAIzE;;;;;;;;;;GAUG;AACH,eAAO,MAAM,cAAc,4CAS1B,CAAA;AA4DD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiE/B,CAAA;AAiGD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,WAAW,GAAG,WAAW,EAAE,EAAE,KAAK,CAAC,EAAE,KAAK,UAIpF"}

package/dist/helper/node.helper.js

@@ -110,22 +110,22 @@ return _objectSpread({flex:c,// Preserve original flex shorthand
 flexShrink:j,// Apply computed or explicit flexShrink
 minHeight:0,// Fix flex item scrolling issues
 minWidth:0},d)};/**
- * Creates a stable hash string based on the provided children and optional theme.
+ * Create a stable signature for a React node (children) with bounded traversal.
+ * This focuses on the structural identity important for rendering decisions:
+ * - element type (string or component name)
+ * - key (if present)
+ * - basic children shape (recursing within limits)
+ */function nodeSignature(a){var b=Math.min,c=1<arguments.length&&void 0!==arguments[1]?arguments[1]:5,d=2<arguments.length&&void 0!==arguments[2]?arguments[2]:6,e=3<arguments.length&&void 0!==arguments[3]?arguments[3]:new WeakSet;if(null===a)return"null";if(void 0===a)return"undefined";var f=_typeof(a);if("string"===f)return"s:".concat(a);if("number"===f)return"n:".concat(a+"");if("boolean"===f)return"b:".concat(a+"");if("function"===f)return"\u0192()";if("symbol"===f)return"sym:".concat(a+"");// Arrays
+if(Array.isArray(a)){if(0>=c)return"ary[...]";for(var g=[],h=b(a.length,d),j=0;j<h;j++)g.push(nodeSignature(a[j],c-1,d,e));return a.length>d&&g.push("...len:".concat(a.length)),"ary[".concat(g.join(","),"]")}// React element-ish: detect common shapes (type + props)
+if("object"===f&&(Object.prototype.hasOwnProperty.call(a,"type")||Object.prototype.hasOwnProperty.call(a,"props"))){var l,m,n=null!==(l=a.type)&&void 0!==l?l:a,o="";// Type can be string (div) or function/class. Use helper to get name.
+try{o=getElementTypeName(n)}catch(a){try{o=n+""}catch(a){o="unknown"}}var p="key"in a&&void 0!==a.key&&null!==a.key?"#".concat(a.key+""):"",q="props"in a&&"object"===_typeof(a.props)?null!==(m=a.props)&&void 0!==m?m:{}:{},r="";try{r=nodeSignature(q.children,c-1,d,e)}catch(a){r="<err>"}var s=q&&"object"===_typeof(q)&&"id"in q&&q.id?"@id:".concat(q.id+""):"",t=q&&"object"===_typeof(q)&&"className"in q&&q.className?"@class:".concat(q.className+""):"";return"el:".concat(o).concat(p).concat(s).concat(t,"{").concat(r,"}")}// Plain object
+if("object"===f&&a&&"object"===_typeof(a)&&!("type"in a)&&!("props"in a)){if(e.has(a))return"[Circular]";if(e.add(a),0>=c)return"obj[...]";for(var u,v=Object.keys(a).sort(),w=[],x=b(v.length,d),y=0;y<x;y++){u=v[y];try{w.push("".concat(u,":").concat(nodeSignature(a[u],c-1,d,e)))}catch(a){w.push("".concat(u,":<err>"))}}return v.length>d&&w.push("...keys:".concat(v.length)),"obj{".concat(w.join(","),"}")}// Fallback
+try{return"o:".concat(a+"")}catch(a){return"o:<unserializable>"}}/**
+ * Public: createStableHash
+ * Produces a deterministic string signature for children + theme.
+ * Keep traversal limited so it is cheap in large trees.
  *
- * This function generates a hash that represents the structure and types of the given
- * children nodes, along with an optional theme. The hash is designed to be stable across
- * renders, meaning that the same input will always produce the same hash output.
- *
- * The hashing strategy includes:
- * - For arrays of children, it includes the length and samples the types of the first few children.
- * - For single child nodes, it includes the type of the node.
- * - For primitive values (strings, numbers, etc.), it includes their type.
- * - If a theme is provided, it includes a stringified version of the theme.
- *
- * This approach avoids deep traversal of potentially large or complex node trees,
- * focusing instead on key characteristics that are likely to change when the structure
- * or content changes.
- * @param children The child nodes to hash, which can be a single node or an array of nodes.
- * @param theme An optional theme object or string to include in the hash.
- * @returns A stable hash string representing the structure and types of the children and theme.
- */export function createStableHash(a,b){var c=Math.min,d="";if(b&&(d+="t:".concat("object"===_typeof(b)?ObjHelper.stringify(b):b+"",";")),Array.isArray(a)){d+="a:".concat(a.length,";");for(var e,f=c(3,a.length),g=0;g<f;g++)e=a[g],d+=e&&"object"===_typeof(e)&&"type"in e?"c".concat(g,":").concat(getElementTypeName(e),";"):"c".concat(g,":").concat(_typeof(e),";")}else d+=a&&"object"===_typeof(a)&&"type"in a?"s:".concat(getElementTypeName(a),";"):"s:".concat(_typeof(a),";");return d}
+ * If you prefer a shorter hashed output, wrap the returned string in a lightweight
+ * hash function (fnv1a, xxhash, etc.). Returning the full signature is useful
+ * for debugging and deterministic comparisons.
+ */export function createStableHash(a,b){var c=b?ObjHelper.stringify(b,6):"theme:undefined",d=nodeSignature(a,6,8);return"".concat(c,"|").concat(d)}

package/dist/helper/obj.helper.d.ts

@@ -1,5 +1,16 @@
 export declare class ObjHelper {
     private constructor();
+    /**
+     * Build a deterministic, serializable representation of `value`.
+     * - sorts plain object keys
+     * - preserves encoded placeholders for special types
+     * - emits { $type: 'Circular', ref: id } for circular refs
+     */
+    private static buildSerializable;
+    /**
+     * Deterministic stringify: first build a canonical serializable structure
+     * (with sorted object keys and encoded special types), then JSON.stringify it.
+     */
     static stringify(obj: any, space?: number): string;
     static parse(str: string): any;
 }

package/dist/helper/obj.helper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"obj.helper.d.ts","sourceRoot":"","sources":["../../src/helper/obj.helper.ts"],"names":[],"mappings":"AAWA,qBAAa,SAAS;IACpB,OAAO,eAAiB;IAExB,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,SAAI,GAAG,MAAM,CAiD5C;IAED,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CA+C7B;CACF"}
+{"version":3,"file":"obj.helper.d.ts","sourceRoot":"","sources":["../../src/helper/obj.helper.ts"],"names":[],"mappings":"AAWA,qBAAa,SAAS;IACpB,OAAO,eAAiB;IAExB;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,iBAAiB;IA2FhC;;;OAGG;IACH,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,SAAI,GAAG,MAAM,CAO5C;IAED,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CA+C7B;CACF"}