@meonode/ui 0.4.5 → 0.4.7

package/dist/core.node.js

@@ -1,4 +1,4 @@
-var _BaseNode,_excluded=["key","children","ref"],_excluded2=["ref","key","children","css","props","disableEmotion"],_excluded3=["style"],_excluded4=["children","key","css","nativeProps","disableEmotion"];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 _slicedToArray(a,b){return _arrayWithHoles(a)||_iterableToArrayLimit(a,b)||_unsupportedIterableToArray(a,b)||_nonIterableRest()}function _nonIterableRest(){throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}function _iterableToArrayLimit(b,c){var d=null==b?null:"undefined"!=typeof Symbol&&b[Symbol.iterator]||b["@@iterator"];if(null!=d){var g,h,j,k,l=[],a=!0,m=!1;try{if(j=(d=d.call(b)).next,0===c){if(Object(d)!==d)return;a=!1}else for(;!(a=(g=j.call(d)).done)&&(l.push(g.value),l.length!==c);a=!0);}catch(a){m=!0,h=a}finally{try{if(!a&&null!=d["return"]&&(k=d["return"](),Object(k)!==k))return}finally{if(m)throw h}}return l}}function _arrayWithHoles(a){if(Array.isArray(a))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 _createForOfIteratorHelper(b,c){var d="undefined"!=typeof Symbol&&b[Symbol.iterator]||b["@@iterator"];if(!d){if(Array.isArray(b)||(d=_unsupportedIterableToArray(b))||c&&b&&"number"==typeof b.length){d&&(b=d);var e=0,f=function F(){};return{s:f,n:function n(){return e>=b.length?{done:!0}:{done:!1,value:b[e++]}},e:function e(a){throw a},f:f}}throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}var g,h=!0,i=!1;return{s:function s(){d=d.call(b)},n:function n(){var a=d.next();return h=a.done,a},e:function e(a){i=!0,g=a},f:function f(){try{h||null==d["return"]||d["return"]()}finally{if(i)throw g}}}}function _unsupportedIterableToArray(b,c){if(b){if("string"==typeof b)return _arrayLikeToArray(b,c);var a={}.toString.call(b).slice(8,-1);return"Object"===a&&b.constructor&&(a=b.constructor.name),"Map"===a||"Set"===a?Array.from(b):"Arguments"===a||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(a)?_arrayLikeToArray(b,c):void 0}}function _arrayLikeToArray(b,c){(null==c||c>b.length)&&(c=b.length);for(var d=0,f=Array(c);d<c;d++)f[d]=b[d];return f}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 _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,isValidElement,Fragment,StrictMode}from"react";import{isNodeInstance}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,omitUndefined}from"./helper/common.helper.js";import StyledRenderer from"./components/styled-renderer.client.js";import{__DEV__}from"./constants/common.const.js";import{MountTracker}from"./helper/mount-tracker.helper.js";import{NavigationCacheManager}from"./helper/navigation-cache-manager.helper.js";import{clearThemeCache}from"./helper/theme.helper.js";/**
+var _BaseNode,_excluded=["ref","children"],_excluded2=["key"],_excluded3=["children","key","css","nativeProps","disableEmotion"];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 _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 _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{createElement,isValidElement,Fragment}from"react";import{isFragment,isValidElementType}from"./helper/react-is.helper.js";import{getComponentType,getElementTypeName,hasNoStyleTag}from"./helper/common.helper.js";import StyledRenderer from"./components/styled-renderer.client.js";import{__DEBUG__}from"./constants/common.const.js";import{MountTrackerUtil}from"./util/mount-tracker.util.js";import MeoNodeUnmounter from"./components/meonode-unmounter.client.js";import{NavigationCacheManagerUtil}from"./util/navigation-cache-manager.util.js";import{NodeUtil}from"./util/node.util.js";import{ThemeUtil}from"./util/theme.util.js";/**
  * The core abstraction of the MeoNode library. It wraps a React element or component,
  * providing a unified interface for processing props, normalizing children, and handling styles.
  * This class is central to the library's ability to offer a JSX-free, fluent API for building UIs.
@@ -6,47 +6,20 @@ var _BaseNode,_excluded=["key","children","ref"],_excluded2=["ref","key","childr
  * @class BaseNode
  * @template E - The type of React element or component this node represents.
  */export class BaseNode{constructor(a){var b=1<arguments.length&&void 0!==arguments[1]?arguments[1]:{},c=2<arguments.length?arguments[2]:void 0;// Element type validation is performed once at construction to prevent invalid nodes from being created.
-if(_defineProperty(this,"rawProps",{}),_defineProperty(this,"isBaseNode",!0),_defineProperty(this,"_lastPropsRef",null),_defineProperty(this,"_lastSignature",""),!BaseNode._isValidElement(a)){var d=getComponentType(a);throw new Error("Invalid element type: ".concat(d," provided!"))}this.element=a,this.rawProps=b,this._deps=c;// Generate an initial stable key used for internal caching.
-// Exclude React's `key`, `ref`, and `children` from the signature so positional or ref changes
-// do not unintentionally affect the component's cache identity.
-var e=b.key,f=b.children,g=b.ref,h=_objectWithoutProperties(b,_excluded);this._stableKey=this._getCachedSignature(h),void 0!==e&&null!==e&&(this._stableKey="".concat(e+"",":").concat(this._stableKey)),BaseNode._isServer||BaseNode._navigationStarted||(NavigationCacheManager.getInstance().start(),BaseNode._navigationStarted=!0)}/**
+if(_defineProperty(this,"instanceId",Math.random().toString(36).slice(2)+Date.now().toString(36)),_defineProperty(this,"rawProps",{}),_defineProperty(this,"isBaseNode",!0),_defineProperty(this,"_lastPropsRef",null),!isValidElementType(a)){var d=getComponentType(a);throw new Error("Invalid element type: ".concat(d," provided!"))}this.element=a,this.rawProps=b,this._deps=c;// Extract commonly handled props; the remaining `propsForSignature` are used to compute a stable hash.
+var e=b.ref,f=b.children,g=_objectWithoutProperties(b,_excluded);// Generate or get cached stable key
+this.stableKey=this._getStableKey(g),NodeUtil.isServer||BaseNode._navigationStarted||(NavigationCacheManagerUtil.getInstance().start(),BaseNode._navigationStarted=!0)}/**
    * Lazily processes and retrieves the final, normalized props for the node.
    * The props are processed only once and then cached for subsequent accesses.
    * @getter props
-   */get props(){return this._props||(this._props=this._processProps()),this._props}/**
+   */get props(){return this._props||(this._props=NodeUtil.processProps(this.element,this.rawProps,this.stableKey)),this._props}/**
    * Returns the dependency list associated with this node.
    * Used by the renderer to decide if the node (and subtree) should update.
    * Mirrors React hook semantics: `undefined` means always update; when an
    * array is provided a shallow comparison against previous deps determines
    * whether a re-render is required.
    * @getter deps
-   */get dependencies(){return this._deps}// --- Enhanced Prop Caching and Processing ---
-/**
-   * FNV-1a hash function.
-   * @method _fnv1aHash
-   */static _fnv1aHash(a){// FNV offset basis
-for(var b=Math.imul,c=2166136261,d=0;d<a.length;d++)c^=a.charCodeAt(d),c=b(c,16777619);return c>>>0;// Convert to unsigned 32-bit integer
-}/**
-   * djb2 hash function.
-   * @method _djb2Hash
-   */static _djb2Hash(a){for(var b=5381,c=0;c<a.length;c++)b=33*b^a.charCodeAt(c);return b>>>0;// Convert to unsigned 32-bit integer
-}/**
-   * Combines FNV-1a and djb2 hash functions for a more robust signature.
-   * @method _hashString
-   */static _hashString(a){var b=BaseNode._fnv1aHash(a),c=BaseNode._djb2Hash(a);return"".concat(b.toString(36),"_").concat(c.toString(36));// Combine and convert to base36
-}/**
-   * Performs a shallow equality check between two objects.
-   * @method _shallowEqual
-   */_shallowEqual(c,a){var b=Object.keys(c),d=Object.keys(a);return!(b.length!==d.length)&&b.every(function(b){return c[b]===a[b]})}/**
-   * Generates a stable identifier for the given element type.
-   * For primitive types (strings), it returns the string itself.
-   * For component types (functions, classes, exotic components), it generates
-   * and caches a unique ID using a WeakMap to ensure stability across calls.
-   * @method _getStableElementId
-   */static _getStableElementId(a){if(a===StrictMode)return"StrictMode";if("string"==typeof a)return a;// On server, avoid WeakMap caching. Directly return a stable string identifier.
-if(BaseNode._isServer)try{return getElementTypeName(a)}catch(a){// Fallback for components without a name
-return"ServerComponentFallback_".concat(BaseNode._elementIdCounter++)}// Client-side: Use WeakMap to maintain stable IDs across calls
-return BaseNode._elementIdMap.has(a)||BaseNode._elementIdMap.set(a,"Component_".concat(BaseNode._elementIdCounter++)),BaseNode._elementIdMap.get(a)}/**
+   */get dependencies(){return this._deps}/**
    * Generates or returns a cached signature representing the props shape and values.
    * The signature is used as a stable key for caching prop-derived computations (e.g. CSS extraction).
    * - Uses a fast reference check to return the previous signature if the same props object is passed.
@@ -54,129 +27,18 @@ return BaseNode._elementIdMap.has(a)||BaseNode._elementIdMap.set(a,"Component_".
    * containing only style-related keys, event handlers, className/css and a `_keyCount` to avoid
    * expensive serialization of huge objects while still retaining reasonable cache discrimination.
    * - Stores the last props reference and computed signature to speed up repeated calls with the same object.
+   * @param key Key passed for prefix if exist
    * @param props The props object to create a signature for.
    * @returns A compact string signature suitable for use as a cache key.
-   */_getCachedSignature(a){if(BaseNode._isServer)return BaseNode._createPropSignature(this.element,a);if(a===this._lastPropsRef)return this._lastSignature;if(this._lastPropsRef&&this._shallowEqual(a,this._lastPropsRef))return this._lastPropsRef=a,this._lastSignature;var b=Object.keys(a),c=b.length;if(100<c){var d,e={_keyCount:c},f=0,g=_createForOfIteratorHelper(b);try{for(g.s();!(d=g.n()).done;){var h=d.value;if(f>=50)break;(BaseNode._isStyleProp(h)||"css"===h||"className"===h||h.startsWith("on"))&&(e[h]=a[h],f++)}}catch(a){g.e(a)}finally{g.f()}this._lastSignature=BaseNode._createPropSignature(this.element,e),__DEV__&&200<c&&console.warn("MeoNode: Large props (".concat(c," keys) on \"").concat(getElementTypeName(this.element),"\". Consider splitting."))}else this._lastSignature=BaseNode._createPropSignature(this.element,a);return this._lastPropsRef=a,this._lastSignature}/**
-   * Creates a unique, stable signature from the element type and props.
-   * This signature includes the element's type to prevent collisions between different components
-   * and handles primitive values in arrays and objects for better caching.
-   * @method _createPropSignature
-   */static _createPropSignature(a,b){// Safe element identification that works with Next.js Client Components
-var c;if(BaseNode._isServer)c=BaseNode._getStableElementId(a);else try{c=getElementTypeName(a)}catch(b){__DEV__&&console.error("MeoNode: Could not determine element name for signature.",b),c=BaseNode._getStableElementId(a)}var d,e=Object.keys(b).sort(),f="".concat(c,":"),g=_createForOfIteratorHelper(e);try{for(g.s();!(d=g.n()).done;){var h=d.value,i=b[h],j=void 0,k=_typeof(i);if("string"===k||"number"===k||"boolean"===k)j="".concat(h,":").concat(i,";");else if(null===i)j="".concat(h,":null;");else if(i===void 0)j="".concat(h,":undefined;");else if(Array.isArray(i)){// Hash primitive values in arrays for better cache hits
-var l=i.filter(function(a){var b=_typeof(a);return"string"===b||"number"===b||"boolean"===b||null===a});j=l.length===i.length?"".concat(h,":[").concat(l.join(","),"];"):"".concat(h,":[").concat(i.length,"];")}else{// Include sorted keys for object structure signature
-var m=Object.keys(i).sort();j="".concat(h,":{").concat(m.join(","),"};")}f+=j}}catch(a){g.e(a)}finally{g.f()}return BaseNode._hashString(f)}/**
-   * Retrieves computed CSS props from the cache with LRU tracking.
-   * Access time and hit count are tracked for smarter eviction.
-   * @method _getCachedCssProps
-   */static _getCachedCssProps(a,b){if(BaseNode._isServer)return{cssProps:getCSSProps(a)};var c=BaseNode._propProcessingCache.get(b);if(c)return c.lastAccess=Date.now(),c.hitCount++,{cssProps:c.cssProps};var d=getCSSProps(a);return BaseNode._propProcessingCache.set(b,{cssProps:d,signature:b,lastAccess:Date.now(),hitCount:1}),BaseNode._propProcessingCache.size>BaseNode.CACHE_SIZE_LIMIT&&!BaseNode._scheduledCleanup&&(BaseNode._scheduledCleanup=!0,"undefined"==typeof requestIdleCallback?setTimeout(function(){BaseNode._evictLRUEntries(),BaseNode._scheduledCleanup=!1},100):requestIdleCallback(function(){BaseNode._evictLRUEntries(),BaseNode._scheduledCleanup=!1},{timeout:2e3})),{cssProps:d}}/**
-   * Implements an LRU eviction strategy that removes multiple entries at once.
-   * It uses a scoring system where older and less frequently used entries have a higher eviction priority.
-   * @method _evictLRUEntries
-   */static _evictLRUEntries(){var a,b=Date.now(),c=[],d=_createForOfIteratorHelper(BaseNode._propProcessingCache.entries());// Calculate eviction scores for all entries
-try{for(d.s();!(a=d.n()).done;){var e=_slicedToArray(a.value,2),f=e[0],g=e[1],h=b-g.lastAccess,j=g.hitCount,k=h/1e3+1e3/(j+1);// Score: older age + lower frequency = higher score (more likely to evict)
-// Normalize: age in seconds, frequency as inverse
-c.push({key:f,score:k})}// Sort by score (highest = most evictable)
-}catch(a){d.e(a)}finally{d.f()}c.sort(function(c,a){return a.score-c.score});// Remove top N entries
-for(var l=Math.min(BaseNode.CACHE_CLEANUP_BATCH,c.length),m=0;m<l;m++)BaseNode._propProcessingCache["delete"](c[m].key)}/**
-   * The main prop processing pipeline, which now passes the element type for improved caching.
-   * @method _processProps
-   */_processProps(){var a=this.rawProps,b=a.ref,c=a.key,d=a.children,e=a.css,f=a.props,g=void 0===f?{}:f,h=a.disableEmotion,i=_objectWithoutProperties(a,_excluded2);// --- Fast Path Optimization ---
-if(0===Object.keys(i).length&&!e)return omitUndefined({ref:b,key:c,disableEmotion:h,nativeProps:omitUndefined(g),children:this._processChildren(d,h)});// --- Hybrid Caching Strategy ---
-var j={},k={};// 1. Categorize props into cacheable (primitives) and non-cacheable (objects/functions).
-for(var l in i)if(Object.prototype.hasOwnProperty.call(i,l)){var m=i[l],n=_typeof(m);"string"===n||"number"===n||"boolean"===n?j[l]=m:k[l]=m}// 2. Pass element type to signature generation
-var o=BaseNode._createPropSignature(this.element,j),p=BaseNode._getCachedCssProps(j,o),q=p.cssProps,r=getCSSProps(k),s=getDOMProps(i),t=_objectSpread(_objectSpread(_objectSpread({},q),r),e),u=this._processChildren(d,h,this._stableKey);// 3. Process non-cacheable props on every render to ensure correctness for functions and objects.
-// DOM props are always processed fresh.
-// 4. Assemble the final CSS object.
-// --- Child Normalization ---
-// --- Final Assembly ---
-return omitUndefined(_objectSpread(_objectSpread({ref:b,key:c,css:t},s),{},{disableEmotion:h,nativeProps:omitUndefined(g),children:u}))}/**
-   * Determines if a node should update based on its dependency array.
-   * Uses a shallow comparison, similar to React's `useMemo` and `useCallback`.
-   * @method _shouldNodeUpdate
-   */static _shouldNodeUpdate(a,b,c){// SSR has no concept of re-renders, so deps system doesn't apply
-return!!BaseNode._isServer||!c&&(!(void 0!==b)||!(void 0!==a)||b.length!==a.length||!!b.some(function(b,c){return!Object.is(b,a[c])}));// No deps array means always update.
-// First render for this keyed component, or no previous deps.
-// Length change means update.
-// Shallow compare deps. If any have changed, update.
-// Deps are the same, no update needed.
-}// --- Child Processing ---
-/**
-   * Processes the `children` prop of a node. It handles single children, arrays of children,
-   * and function-as-a-child render props, passing them to `_processRawNode` for normalization.
-   * @method _processChildren
-   */_processChildren(a,b,c){return a?"function"==typeof a?a:Array.isArray(a)?a.map(function(a,d){return BaseNode._processRawNode(a,b,"".concat(c,"_").concat(d))}):BaseNode._processRawNode(a,b,c):void 0}/**
-   * The core normalization function for a single child. It takes any valid `NodeElement`
-   * (primitive, React element, function, `BaseNode` instance) and converts it into a standardized `BaseNode`
-   * instance if it isn't one already. This ensures a consistent structure for the iterative renderer.
-   * @method _processRawNode
-   */static _processRawNode(a,b,c){// Primitives and null/undefined are returned as-is.
-if(null===a||a===void 0||"string"==typeof a||"number"==typeof a||"boolean"==typeof a)return a;// If it's already a BaseNode, clone it with a positional key if available.
-if(isNodeInstance(a)){var d=c||b&&!a.rawProps.disableEmotion;if(d){// Create a new BaseNode instance.
-var e=new BaseNode(a.element,a.rawProps,a.dependencies);// Augment the internal _stableKey with positional information.
-// This is purely for BaseNode's internal caching, not for React's 'key' prop.
-return e._stableKey="".concat(c,":").concat(e._stableKey),b&&!e.rawProps.disableEmotion&&(e.rawProps.disableEmotion=!0),e}return a}// Handle function-as-a-child (render props).
-if(BaseNode._isFunctionChild(a))return new BaseNode(BaseNode._functionRenderer,{props:{render:a,disableEmotion:b}},void 0);// Handle standard React elements.
-if(isValidElement(a)){var f=a.props,g=f.style,h=_objectWithoutProperties(f,_excluded3),i=_objectSpread(_objectSpread({},h),g||{});return new BaseNode(a.type,_objectSpread(_objectSpread(_objectSpread({},i),null!==a.key&&void 0!==a.key?{key:a.key}:{}),{},{disableEmotion:b}),void 0)}// Handle component classes and memos.
-return isReactClassComponent(a)||isMemo(a)||isForwardRef(a)?new BaseNode(a,{disableEmotion:b},void 0):a instanceof React.Component?BaseNode._processRawNode(a.render(),b,c):a;// Handle component instances.
-}/**
-   * A helper to reliably identify if a given function is a "function-as-a-child" (render prop)
-   * rather than a standard Function Component.
-   * @method _isFunctionChild
-   */static _isFunctionChild(a){if("function"!=typeof a||isReactClassComponent(a)||isMemo(a)||isForwardRef(a))return!1;try{return!(a.prototype&&"function"==typeof a.prototype.render)}catch(a){return __DEV__&&console.error("MeoNode: Error checking if a node is a function child.",a),!0}}/**
-   * A special internal React component used to render "function-as-a-child" (render prop) patterns.
-   * When a `BaseNode` receives a function as its `children` prop, it wraps that function
-   * inside this `_functionRenderer` component. This component then executes the render function
-   * and processes its return value, normalizing it into a renderable ReactNode.
-   *
-   * This allows `BaseNode` to support render props while maintaining its internal processing
-   * and normalization logic for the dynamically generated content.
-   * @method _functionRenderer
-   * @param {Object} props The properties passed to the renderer.
-   * @param {Function} props.render The function-as-a-child to execute.
-   * @param {boolean} [props.disableEmotion] Inherited flag to disable Emotion styling for children.
-   * @returns {ReactNode | null | undefined} The processed and rendered output of the render function.
-   */static _functionRenderer(a){var b,c=a.render,d=a.disableEmotion;try{// Execute the render prop function to get its output.
-b=c()}catch(a){// If the render function throws, treat its output as null to prevent crashes.
-__DEV__&&console.error("MeoNode: Error executing function-as-a-child.",a),b=null}// Handle null or undefined results directly, as they are valid React render outputs.
-if(null===b||b===void 0)return b;// If the result is already a BaseNode instance, process it.
-if(isNodeInstance(b))// If emotion is disabled for the parent and not explicitly re-enabled on the child,
-// create a new BaseNode with emotion disabled and render it.
-return d&&!b.rawProps.disableEmotion?new BaseNode(b.element,_objectSpread(_objectSpread({},b.rawProps),{},{disableEmotion:!0})).render():b.render();// Otherwise, render the existing BaseNode directly.
-// If the result is an array, it likely contains multiple children.
-if(Array.isArray(b)){// Helper to generate a stable key for array items, crucial for React's reconciliation.
-var e=function safeGetKey(a,b){try{// Attempt to get a meaningful name for the element type.
-return"".concat(getElementTypeName(a),"-").concat(b)}catch(a){// Fallback to a generic key if type name cannot be determined.
-return __DEV__&&console.error("MeoNode: Could not determine element type name for key in function-as-a-child.",a),"item-".concat(b)}};// Map over the array, processing each item and assigning a key.
-return b.map(function(a,b){return BaseNode._renderProcessedNode({processedElement:BaseNode._processRawNode(a,d),passedKey:e(a,b),disableEmotion:d})})}if(b instanceof React.Component)return BaseNode._renderProcessedNode({processedElement:BaseNode._processRawNode(b.render(),d),disableEmotion:d});// Handle primitive types directly, as they are valid React children.
-if("string"==typeof b||"number"==typeof b||"boolean"==typeof b)return b;// For any other non-primitive, non-array result, process it as a single NodeElement.
-var f=BaseNode._processRawNode(b,d);// If processing yields a valid element, render it.
-return f?BaseNode._renderProcessedNode({processedElement:f,disableEmotion:d}):b;// Fallback: return the original result if it couldn't be processed into a renderable node.
-}/**
-   * Renders a processed `NodeElement` into a ReactNode.
-   * This helper is primarily used by `_functionRenderer` to handle the output of render props,
-   * ensuring that `BaseNode` instances are correctly rendered and other React elements or primitives
-   * are passed through. It also applies `disableEmotion` and `key` props as needed.
+   */_getStableKey(a){var b=a.key,c=_objectWithoutProperties(a,_excluded2);if(!NodeUtil.isServer){if(c===this._lastPropsRef)return this._lastSignature;if(this._lastPropsRef&&NodeUtil.shallowEqual(c,this._lastPropsRef))return this._lastPropsRef=c,this._lastSignature;var d=Object.keys(c),e=d.length;if(100<e){var f=NodeUtil.extractCriticalProps(c,d);this._lastSignature=NodeUtil.createPropSignature(this.element,f),__DEBUG__&&200<e&&console.warn("MeoNode: Large props (".concat(e," keys) on \"").concat(getElementTypeName(this.element),"\". Consider splitting."))}else this._lastSignature=NodeUtil.createPropSignature(this.element,c);return this._lastPropsRef=c,void 0!==b&&null!==b?"".concat(b+"",":").concat(this._lastSignature):this._lastSignature}}/**
+   * FinalizationRegistry for cleaning up `elementCache` entries when the associated `BaseNode` instance
+   * is garbage-collected. This helps prevent memory leaks by ensuring that cache entries for
+   * unreferenced nodes are eventually removed.
    *
-   * This method is part of the child processing pipeline, converting internal `NodeElement` representations
-   * into actual React elements that can be rendered by React.
-   * @method _renderProcessedNode
-   */static _renderProcessedNode(a){var b=a.processedElement,c=a.passedKey,d=a.disableEmotion,e={};// Initialize an object to hold common props that might be applied to the new BaseNode.
-// If a `passedKey` is provided, add it to `commonBaseNodeProps`.
-// This key is typically used for React's reconciliation process.
-// If the processed element is already a BaseNode instance.
-if(void 0!==c&&(e.key=c),isNodeInstance(b)){var f,g=null===(f=b.rawProps)||void 0===f?void 0:f.key;// Get the existing key from the raw props of the BaseNode.
-// Apply the `disableEmotion` flag to the raw props of the BaseNode.
-// If the existing key is the same as the passed key, render the existing BaseNode directly.
-// This avoids unnecessary re-creation of the BaseNode instance.
-return b.rawProps.disableEmotion=d,g===c?b.render():new BaseNode(b.element,_objectSpread(_objectSpread({},b.rawProps),e)).render();// Otherwise, create a new BaseNode instance, merging existing raw props with common props, then render it.
-}// If the processed element is a React class component (e.g., `class MyComponent extends React.Component`).
-// Create a new BaseNode for it, applying common props and `disableEmotion`, then render.
-return isReactClassComponent(b)?new BaseNode(b,_objectSpread(_objectSpread({},e),{},{disableEmotion:d})).render():b instanceof React.Component?b.render():"function"==typeof b?createElement(b,{key:c}):b;// If the processed element is an instance of a React component (e.g., `new MyComponent()`).
-// Directly call its `render` method.
-// If the processed element is a function (likely a functional component or a render prop that returned a component type).
-// Create a React element directly using `createElement`, passing the `passedKey`.
-// For any other type (primitives, null, undefined, etc.), return it as a ReactNode.
-}// --- Iterative Renderer with Deps Support ---
+   * The held value must include `cacheKey` which is used to identify and delete the corresponding
+   * entry from `BaseNode.elementCache`.
+   * @public
+   */// --- Iterative Renderer with Deps Support ---
 /**
    * Renders the `BaseNode` and its entire subtree into a ReactElement, with support for opt-in reactivity
    * via dependency arrays and inherited blocking.
@@ -190,56 +52,59 @@ return isReactClassComponent(b)?new BaseNode(b,_objectSpread(_objectSpread({},e)
    * 2. **Complete Phase:** After all of a node's descendants have been rendered, the loop returns to the node.
    *    It then collects the rendered children from a temporary map and creates its own React element.
    * @method render
-   */render(){var a=!!(0<arguments.length&&arguments[0]!==void 0)&&arguments[0];BaseNode._isServer||MountTracker.trackMount(this);// A stable cache key derived from the element + important props signature.
-var b=this._stableKey,c=BaseNode._isServer?void 0:BaseNode._elementCache.get(b),d=BaseNode._shouldNodeUpdate(null===c||void 0===c?void 0:c.prevDeps,this._deps,a);// On server we never reuse cached elements because that can cause hydration mismatches.
-// Decide whether this node (and its subtree) should update given dependency arrays.
+   */render(){var a=!!(0<arguments.length&&arguments[0]!==void 0)&&arguments[0];!NodeUtil.isServer&&this.stableKey&&MountTrackerUtil.trackMount(this.stableKey);// On server, we never reuse cached elements because that can cause hydration mismatches.
+var b=NodeUtil.isServer||!this.stableKey?void 0:BaseNode.elementCache.get(this.stableKey),c=NodeUtil.shouldNodeUpdate(null===b||void 0===b?void 0:b.prevDeps,this._deps,a);// Decide whether this node (and its subtree) should update given dependency arrays.
 // Fast return: if nothing should update and we have a cached element, reuse it.
-if(!d&&null!==c&&void 0!==c&&c.renderedElement)return c.accessCount+=1,c.renderedElement;// When this node doesn't need update, its children are considered "blocked" and may be skipped.
+if(!c&&null!==b&&void 0!==b&&b.renderedElement)return b.accessCount+=1,b.renderedElement;// When this node doesn't need update, its children are considered "blocked" and may be skipped.
 // Work stack for iterative, non-recursive traversal.
 // Each entry tracks the BaseNode, whether its children were pushed (isProcessed) and whether it is blocked.
 // Map to collect rendered React elements for processed BaseNode instances.
 // Iterative depth-first traversal with explicit begin/complete phases to avoid recursion.
-for(var e=[{node:this,isProcessed:!1,blocked:!d}],f=new Map,g=function _loop(){var a=e[e.length-1],b=a.node,c=a.isProcessed,d=a.blocked;if(!c){a.isProcessed=!0;var g=b.props.children;if(g)// Only consider BaseNode children for further traversal; primitives and React elements are terminal.
-for(var h=(Array.isArray(g)?g:[g]).filter(isNodeInstance),j=h.length-1;0<=j;j--){var k=h[j],l=k._stableKey,m=BaseNode._isServer?void 0:BaseNode._elementCache.get(l),n=BaseNode._shouldNodeUpdate(null===m||void 0===m?void 0:m.prevDeps,k._deps,d);// Respect server/client differences for child cache lookup.
+for(var d=[{node:this,isProcessed:!1,blocked:!c}],e=new Map;0<d.length;){var f=d[d.length-1],g=f.node,h=f.isProcessed,j=f.blocked;if(!h){f.isProcessed=!0;var k=g.props.children;if(k)// Only consider BaseNode children for further traversal; primitives and React elements are terminal.
+for(var l=(Array.isArray(k)?k:[k]).filter(NodeUtil.isNodeInstance),m=l.length-1;0<=m;m--){var n=l[m],o=NodeUtil.isServer||!n.stableKey?void 0:BaseNode.elementCache.get(n.stableKey),p=NodeUtil.shouldNodeUpdate(null===o||void 0===o?void 0:o.prevDeps,n._deps,j);// Respect server/client differences for child cache lookup.
 // Determine whether the child should update given its deps and the parent's blocked state.
 // If child doesn't need update and has cached element, reuse it immediately (no push).
-if(!n&&null!==m&&void 0!==m&&m.renderedElement){f.set(k,m.renderedElement);continue}// Otherwise push child for processing; childBlocked inherits parent's blocked state.
-var o=d||!n;e.push({node:k,isProcessed:!1,blocked:o})}}else{e.pop();// Extract node props. Non-present props default to undefined via destructuring.
-var p=b.props,q=p.children,r=p.key,s=p.css,t=p.nativeProps,u=p.disableEmotion,v=_objectWithoutProperties(p,_excluded4),w=[];q&&(w=(Array.isArray(q)?q:[q]).map(function(a){return isNodeInstance(a)?f.get(a):isValidElement(a)?a:a}));// Merge element props: explicit other props + DOM native props + React key.
-var x,y=_objectSpread(_objectSpread({},v),{},{key:r},t);// Handle fragments specially: create fragment element with key and children.
-if(b.element===Fragment||isFragment(b.element))x=createElement(b.element,{key:r},...w);else{// StyledRenderer for emotion-based styling unless explicitly disabled or no styles are present.
+if(!p&&null!==o&&void 0!==o&&o.renderedElement){e.set(n,o.renderedElement);continue}// Otherwise push child for processing; childBlocked inherits parent's blocked state.
+var q=j||!p;d.push({node:n,isProcessed:!1,blocked:q})}}else{d.pop();// Extract node props. Non-present props default to undefined via destructuring.
+var r=g.props,s=r.children,t=r.key,u=r.css,v=r.nativeProps,w=r.disableEmotion,x=_objectWithoutProperties(r,_excluded3),y=[];s&&(y=(Array.isArray(s)?s:[s]).map(function(a){return NodeUtil.isNodeInstance(a)?e.get(a):isValidElement(a)?a:a}));// Merge element props: explicit other props + DOM native props + React key.
+var z=_objectSpread(_objectSpread({},x),{},{key:t},v),A=void 0;// Handle fragments specially: create fragment element with key and children.
+if(g.element===Fragment||isFragment(g.element))A=createElement(g.element,{key:t},...y);else{// StyledRenderer for emotion-based styling unless explicitly disabled or no styles are present.
 // StyledRenderer handles SSR hydration and emotion CSS injection when css prop exists or element has style tags.
-var z=!u&&(s||!hasNoStyleTag(b.element));x=z?createElement(StyledRenderer,_objectSpread(_objectSpread({element:b.element},y),{},{css:s,suppressHydrationWarning:!0}),...w):createElement(b.element,y,...w)}// Cache the generated element on client-side to speed up future renders.
-if(!BaseNode._isServer){var A={prevDeps:b._deps,renderedElement:x,onEvict:function onEvict(){return MountTracker.trackUnmount(b)},nodeRef:new WeakRef(b),createdAt:Date.now(),accessCount:1};BaseNode._elementCache.set(b._stableKey,A)}// Store the rendered element so parent nodes can reference it.
-f.set(b,x)}};0<e.length;)g();// Return the ReactElement corresponding to the root node (this).
-return f.get(this)}/**
-   * Registers a node instance with the MountTracker for unmount tracking.
-   * This is only executed on the client-side.
-   * @method registerUnmount
-   */static registerUnmount(a){BaseNode._isServer||MountTracker.trackUnmount(a)}// --- Portal System ---
-/**
-   * Ensures that the necessary DOM element and React root are available for portal rendering.
-   * This is only executed on the client-side.
-   * @method _ensurePortalInfrastructure
-   */_ensurePortalInfrastructure(){var a,b;if(BaseNode._isServer)return!1;var c=BaseNode._portalInfrastructure.get(this);// Check if infrastructure exists and is still connected
-if(null!==(a=c)&&void 0!==a&&null!==(a=a.domElement)&&void 0!==a&&a.isConnected)return!0;// Clean up disconnected infrastructure
-if(null!==(b=c)&&void 0!==b&&b.domElement&&!c.domElement.isConnected){try{c.reactRoot.unmount()}catch(a){__DEV__&&console.error("MeoNode: Error unmounting disconnected portal root.",a)}BaseNode._portalInfrastructure["delete"](this),c=void 0}// Create new infrastructure
-var d=document.createElement("div");document.body.appendChild(d);var e=createRoot(d),f={render:e.render.bind(e),unmount:e.unmount.bind(e),update:function update(){}// Placeholder, will be overridden
-};return c={domElement:d,reactRoot:f},BaseNode._portalInfrastructure.set(this,c),!0}/**
+var B=!w&&(u||!hasNoStyleTag(g.element));A=B?createElement(StyledRenderer,_objectSpread(_objectSpread({element:g.element},z),{},{css:u,suppressHydrationWarning:!0}),...y):createElement(g.element,z,...y)}// Cache the generated element on client-side to speed up future renders.
+if(!NodeUtil.isServer&&g.stableKey){var C=BaseNode.elementCache.get(g.stableKey);if(C)C.prevDeps=g._deps,C.renderedElement=A,C.accessCount+=1;else{// Create new cache entry and register for cleanup
+var D={prevDeps:g._deps,renderedElement:A,nodeRef:new WeakRef(g),createdAt:Date.now(),accessCount:1,instanceId:g.instanceId};BaseNode.elementCache.set(g.stableKey,D),BaseNode.cacheCleanupRegistry.register(g,{cacheKey:g.stableKey,instanceId:g.instanceId},g)}}// Store the rendered element so parent nodes can reference it.
+e.set(g,A)}}// Get the final rendered element for the root node of this render cycle.
+var E=e.get(this);return!NodeUtil.isServer&&this.stableKey?createElement(MeoNodeUnmounter,{stableKey:this.stableKey},E):E}/**
    * Renders the node into a React Portal, mounting it directly under `document.body`.
    * Returns a handle with `update` and `unmount` methods to control the portal's lifecycle.
    * @method toPortal
-   */toPortal(){var a=this;if(!this._ensurePortalInfrastructure())throw new Error("toPortal() can only be called in a client-side environment where document.body is available.");var b=BaseNode._portalInfrastructure.get(this),c=b.domElement,d=b.reactRoot;(function renderCurrent(){try{d.render(a.render())}catch(a){__DEV__&&console.error("MeoNode: Error rendering initial portal content.",a)}})();try{var e=d.unmount.bind(d);// Override update method
-return d.update=function(a){try{var b=isNodeInstance(a)?a.render():a;d.render(b)}catch(a){__DEV__&&console.error("MeoNode: Error updating portal content.",a)}},d.unmount=function(){try{e()}catch(a){__DEV__&&console.error("MeoNode: Error unmounting portal root.",a)}if(c.parentNode)try{c.parentNode.removeChild(c)}catch(a){__DEV__&&console.error("MeoNode: Error removing portal DOM element.",a)}// Clean up from WeakMap
-BaseNode._portalInfrastructure["delete"](a)},d}catch(a){return __DEV__&&console.error("MeoNode: Error creating portal handle.",a),d}}/**
+   */toPortal(){var a=this;if(!NodeUtil.ensurePortalInfrastructure(this))throw new Error("toPortal() can only be called in a client-side environment");var b=NodeUtil.portalInfrastructure.get(this),c=b.domElement,d=b.reactRoot;(function renderCurrent(){try{d.render(a.render())}catch(a){__DEBUG__&&console.error("[MeoNode] Portal render error:",a)}})();// Track if already unmounted to make unmount idempotent
+var e=!1,f=d.unmount.bind(d);return d.update=function(a){if(e)return void(__DEBUG__&&console.warn("[MeoNode] Attempt to update already-unmounted portal"));try{var b=NodeUtil.isNodeInstance(a)?a.render():a;d.render(b)}catch(a){__DEBUG__&&console.error("[MeoNode] Portal update error:",a)}},d.unmount=function(){// Idempotent guard
+if(e)return void(__DEBUG__&&console.warn("[MeoNode] Portal already unmounted"));e=!0;// Unregister FIRST to prevent FinalizationRegistry from firing
+try{BaseNode.portalCleanupRegistry.unregister(a)}catch(a){__DEBUG__&&console.warn("[MeoNode] Portal unregister warning:",a)}// Remove from WeakMap
+NodeUtil.portalInfrastructure["delete"](a);// Now do the actual cleanup
+try{null!==c&&void 0!==c&&c.isConnected&&f()}catch(a){__DEBUG__&&console.error("[MeoNode] Portal unmount error:",a)}try{null!==c&&void 0!==c&&c.isConnected&&c.remove()}catch(a){__DEBUG__&&console.error("[MeoNode] Portal DOM cleanup error:",a)}},d}/**
    * A static method to clear all internal caches.
+   *
+   * This method performs manual cleanup of all cache entries, calling their
+   * `onEvict` callbacks before clearing. Note that FinalizationRegistry entries
+   * are not manually cleared as they will be garbage collected naturally when
+   * the associated nodes are collected.
    * @method clearCaches
-   */static clearCaches(){BaseNode._propProcessingCache.clear(),BaseNode._elementCache.clear(),clearThemeCache()}}// --- Factory Functions ---
+   */static clearCaches(){// Collect all cache keys first
+var a=Array.from(BaseNode.elementCache.keys());__DEBUG__&&console.log("[MeoNode] clearCaches: Clearing ".concat(a.length," entries"));// Call onEvict for all entries (idempotent)
+for(var b=0,c=a;b<c.length;b++){var d=c[b],e=BaseNode.elementCache.get(d);if(e){var f,g=null===(f=e.nodeRef)||void 0===f?void 0:f.deref();// Try to unregister from FinalizationRegistry
+if(g)try{BaseNode.cacheCleanupRegistry.unregister(g)}catch(a){__DEBUG__&&console.warn("[MeoNode] Could not unregister ".concat(d," from FinalizationRegistry"))}}}// Clear all caches
+// Clear mount tracking
+BaseNode.propProcessingCache.clear(),BaseNode.elementCache.clear(),ThemeUtil.clearThemeCache(),MountTrackerUtil.cleanup(),__DEBUG__&&console.log("[MeoNode] All caches cleared")}// --- Utilities ---
+}// --- Factory Functions ---
 /**
  * The primary factory function for creating a `BaseNode` instance.
  * It's the simplest way to wrap a component or element.
  * @function Node
- */_BaseNode=BaseNode,_defineProperty(BaseNode,"_isServer","undefined"==typeof window),_defineProperty(BaseNode,"_propProcessingCache",new Map),_defineProperty(BaseNode,"_isValidElement",isValidElementType),_defineProperty(BaseNode,"_isStyleProp",_BaseNode._isServer||"undefined"==typeof document?function(){return!1}:function(a){return a in document.body.style}),_defineProperty(BaseNode,"_elementCache",new Map),_defineProperty(BaseNode,"_portalInfrastructure",new WeakMap),_defineProperty(BaseNode,"CACHE_SIZE_LIMIT",500),_defineProperty(BaseNode,"CACHE_CLEANUP_BATCH",50),_defineProperty(BaseNode,"_elementIdMap",new WeakMap),_defineProperty(BaseNode,"_elementIdCounter",0),_defineProperty(BaseNode,"_scheduledCleanup",!1),_defineProperty(BaseNode,"_navigationStarted",!1);function Node(a){var b=1<arguments.length&&arguments[1]!==void 0?arguments[1]:{},c=2<arguments.length?arguments[2]:void 0;return new BaseNode(a,b,c)}/**
+ */_BaseNode=BaseNode,_defineProperty(BaseNode,"elementCache",new Map),_defineProperty(BaseNode,"propProcessingCache",new Map),_defineProperty(BaseNode,"scheduledCleanup",!1),_defineProperty(BaseNode,"_navigationStarted",!1),_defineProperty(BaseNode,"cacheCleanupRegistry",new FinalizationRegistry(function(a){var b=a.cacheKey,c=a.instanceId,d=_BaseNode.elementCache.get(b);MountTrackerUtil.mountedNodes.has(b)&&(null===d||void 0===d?void 0:d.instanceId)===c&&(_BaseNode.elementCache["delete"](b),MountTrackerUtil.untrackMount(b))})),_defineProperty(BaseNode,"portalCleanupRegistry",new FinalizationRegistry(function(a){var b=a.domElement,c=a.reactRoot;__DEBUG__&&console.log("[MeoNode] FinalizationRegistry auto-cleaning portal");// Guard: Check if already unmounted
+try{c&&"function"==typeof c.unmount&&c.unmount()}catch(a){__DEBUG__&&console.error("[MeoNode] Portal auto-cleanup unmount error:",a)}// Guard: Check if DOM element still connected
+try{null!==b&&void 0!==b&&b.isConnected&&b.remove()}catch(a){__DEBUG__&&console.error("[MeoNode] Portal auto-cleanup DOM removal error:",a)}}));function Node(a){var b=1<arguments.length&&arguments[1]!==void 0?arguments[1]:{},c=2<arguments.length?arguments[2]:void 0;return new BaseNode(a,b,c)}/**
  * Static alias on the `Node` factory for clearing all internal caches used by `BaseNode`.
  *
  * Use cases include:

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

@@ -26,7 +26,7 @@ export declare const getValueByPath: (obj: any, path: string) => any;
  * getComponentType(React.memo(() => <div/>)) // 'memo'
  * getComponentType(() => <div/>) // 'function'
  */
-export declare const getComponentType: (component?: NodeInstance<NodeElement> | NodeElement) => string;
+export declare const getComponentType: (component?: NodeInstance | NodeElement) => string;
 /**
  * Generates a string name for an ElementType or ReactElement.
  *

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,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAExF,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,iEAmC5B,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;;;;;GAKG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAQ1F;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAQlE"}
+{"version":3,"file":"common.helper.d.ts","sourceRoot":"","sources":["../../src/helper/common.helper.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAExF,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,oDAmC5B,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;;;;;GAKG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAQ1F;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAQlE"}

package/dist/hoc/component.hoc.js

@@ -1,4 +1,4 @@
-import{BaseNode,Node}from"../core.node.js";import{getElementTypeName}from"../helper/common.helper.js";import{isNodeInstance}from"../helper/node.helper.js";/**
+import{BaseNode,Node}from"../core.node.js";import{getElementTypeName}from"../helper/common.helper.js";import{NodeUtil}from"../util/node.util.js";/**
  * Props definition for components wrapped using the `Component` higher-order function.
  *
  * This type adapts based on whether the underlying component defines its own props:
@@ -47,4 +47,4 @@ import{BaseNode,Node}from"../core.node.js";import{getElementTypeName}from"../hel
  *//**
  * Internal implementation of the `Component` HOC.
  * Handles BaseNode conversion and wrapper creation.
- */export function Component(a){function Func(){var a=0<arguments.length&&void 0!==arguments[0]?arguments[0]:{},b=1<arguments.length?arguments[1]:void 0;return Node(c,a,b).render()}var b=getElementTypeName(a),c=function Renderer(b){var c=a(b);return c instanceof BaseNode||isNodeInstance(c)?Node(c.element,c.rawProps).render():c};return c.displayName="Renderer(".concat(b,")"),Func.displayName="Component(".concat(b,")"),Func}
+ */export function Component(a){function Func(){var a=0<arguments.length&&void 0!==arguments[0]?arguments[0]:{},b=1<arguments.length?arguments[1]:void 0;return Node(c,a,b).render()}var b=getElementTypeName(a),c=function Renderer(b){var c=a(b);return c instanceof BaseNode||NodeUtil.isNodeInstance(c)?Node(c.element,c.rawProps).render():c};return c.displayName="Renderer(".concat(b,")"),Func.displayName="Component(".concat(b,")"),Func}

package/dist/main.d.ts

@@ -1,6 +1,6 @@
+export { setDebugMode } from './constants/common.const.js';
 export { Node, createNode, createChildrenFirstNode } from './core.node.js';
 export * from './hoc/index.js';
-export * from './helper/node.helper.js';
 export * from './types/node.type.js';
 export * from './components/react.node.js';
 export * from './components/html.node.js';

package/dist/main.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAA;AAG7E,cAAc,mBAAmB,CAAA;AAGjC,cAAc,4BAA4B,CAAA;AAG1C,cAAc,yBAAyB,CAAA;AAGvC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,8BAA8B,CAAA;AAC5C,cAAc,mCAAmC,CAAA;AAGjD,cAAc,oBAAoB,CAAA"}
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAA;AAG7D,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAA;AAG7E,cAAc,mBAAmB,CAAA;AAGjC,cAAc,yBAAyB,CAAA;AAGvC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,8BAA8B,CAAA;AAC5C,cAAc,mCAAmC,CAAA;AAGjD,cAAc,oBAAoB,CAAA"}

package/dist/main.js

@@ -1,6 +1,7 @@
+// Common
+export{setDebugMode}from"./constants/common.const.js";// Core
 export{Node,createNode,createChildrenFirstNode}from"./core.node.js";// High Order Components
-export*from"./hoc/index.js";// Helpers
-export*from"./helper/node.helper.js";// Types
+export*from"./hoc/index.js";// Types
 export*from"./types/node.type.js";// Components
 export*from"./components/react.node.js";export*from"./components/html.node.js";export*from"./components/theme-provider.js";// Hooks
 export*from"./hook/index.js";

package/dist/types/node.type.d.ts

@@ -51,31 +51,17 @@ export interface PropProcessingCache {
 export interface ElementCacheEntry {
     renderedElement: ReactElement<FinalNodeProps>;
     prevDeps?: DependencyList;
-    onEvict: () => void;
-    nodeRef: WeakRef<BaseNode<any>>;
+    nodeRef: WeakRef<NodeInstance>;
     createdAt: number;
     accessCount: number;
+    instanceId: string;
 }
 /**
  * Forward declaration of the BaseNode interface to avoid circular dependencies.
  * Defines the core structure and capabilities of a BaseNode instance.
  * @template E - The type of React element/component that this node represents
  */
-export interface NodeInstance<E extends NodeElement = NodeElement> {
-    /** The underlying React element or component type that this node will render */
-    readonly element: E;
-    /** Original props passed during node construction, preserved for cloning/recreation */
-    readonly rawProps: Partial<NodeProps<E>>;
-    readonly isBaseNode: true;
-    /** The dependency list for memoization */
-    readonly dependencies: DependencyList | undefined;
-    /** Lazily processed and retrieved final, normalized props for the node. */
-    readonly props: FinalNodeProps;
-    /** Converts this node instance into a renderable React element/tree */
-    render(): ReactElement;
-    /** Creates Portal-compatible React elements for rendering outside the DOM tree */
-    toPortal(): NodePortal;
-}
+export type NodeInstance<E extends NodeElementType = NodeElementType> = BaseNode<E>;
 /**
  * Infers the props type for a given NodeElement.
  * - For intrinsic JSX elements (e.g., 'div', 'span'), returns the corresponding JSX.IntrinsicElements props.

package/dist/types/node.type.d.ts.map

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

package/dist/util/mount-tracker.util.d.ts

@@ -0,0 +1,26 @@
+/**
+ * MountTrackerUtil keeps track of which BaseNode instances are currently mounted in the DOM.
+ * It provides a simple registry for mount/unmount state that other systems
+ * (like NavigationCacheManager) can query for safe cache eviction.
+ */
+export declare class MountTrackerUtil {
+    private constructor();
+    static mountedNodes: Set<string>;
+    private static _unmountCallCount;
+    /**
+     * Tracks a node as mounted. Adds its stable key and a WeakRef to the node to the map of mounted nodes.
+     */
+    static trackMount(key: string): void;
+    /**
+     * Removes its stable key from the set of mounted nodes.
+     * In development mode, it also tracks multiple unmount calls for debugging purposes.
+     * @returns True if the node was previously tracked as mounted and is now removed, false otherwise.
+     */
+    static untrackMount(key: string): boolean;
+    /**
+     * Cleans up all internal state of the MountTrackerUtil.
+     * Removes all tracked nodes and debug counters.
+     */
+    static cleanup(): void;
+}
+//# sourceMappingURL=mount-tracker.util.d.ts.map

package/dist/util/mount-tracker.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mount-tracker.util.d.ts","sourceRoot":"","sources":["../../src/util/mount-tracker.util.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,eAAiB;IAExB,OAAc,YAAY,cAAoB;IAC9C,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAA4B;IAE5D;;OAEG;IACH,OAAc,UAAU,CAAC,GAAG,EAAE,MAAM,QAMnC;IAED;;;;OAIG;IACH,OAAc,YAAY,CAAC,GAAG,EAAE,MAAM,WAerC;IAED;;;OAGG;IACH,OAAc,OAAO,SAMpB;CACF"}

package/dist/util/mount-tracker.util.js

@@ -0,0 +1,15 @@
+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{__DEBUG__}from"../constants/common.const.js";/**
+ * MountTrackerUtil keeps track of which BaseNode instances are currently mounted in the DOM.
+ * It provides a simple registry for mount/unmount state that other systems
+ * (like NavigationCacheManager) can query for safe cache eviction.
+ */export class MountTrackerUtil{constructor(){}// Debug only
+/**
+   * Tracks a node as mounted. Adds its stable key and a WeakRef to the node to the map of mounted nodes.
+   */static trackMount(a){this.mountedNodes.add(a),__DEBUG__&&this._unmountCallCount["delete"](a)}/**
+   * Removes its stable key from the set of mounted nodes.
+   * In development mode, it also tracks multiple unmount calls for debugging purposes.
+   * @returns True if the node was previously tracked as mounted and is now removed, false otherwise.
+   */static untrackMount(a){var b=this.mountedNodes["delete"](a);if(__DEBUG__&&!b){var c=(this._unmountCallCount.get(a)||0)+1;this._unmountCallCount.set(a,c),1<c&&console.warn("[MeoNode] untrackMount called ".concat(c," times for an already unmounted node: ").concat(a,". This could indicate a memory leak or a bug in a component's lifecycle."))}return b}/**
+   * Cleans up all internal state of the MountTrackerUtil.
+   * Removes all tracked nodes and debug counters.
+   */static cleanup(){this.mountedNodes.clear(),__DEBUG__&&this._unmountCallCount.clear()}}_defineProperty(MountTrackerUtil,"mountedNodes",new Set),_defineProperty(MountTrackerUtil,"_unmountCallCount",new Map);

package/dist/util/navigation-cache-manager.util.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Lightweight navigation handler that clears cache on SPA navigation.
+ */
+export declare class NavigationCacheManagerUtil {
+    private constructor();
+    private static _instance;
+    private static _originalPushState;
+    private static _originalReplaceState;
+    private static _isPatched;
+    private _isListening;
+    private _cleanupTimeout;
+    static getInstance(): NavigationCacheManagerUtil;
+    /**
+     * Start listening for navigation events. Idempotent.
+     */
+    start(): void;
+    /**
+     * Stops listening for navigation events and restores original browser APIs.
+     * This is important for cleanup during HMR or when unmounting the library.
+     */
+    private _stop;
+    /**
+     * Debounced navigation handler. Clears mounted element cache and props cache.
+     */
+    private _handleNavigation;
+    /**
+     * Patch history.pushState/replaceState to detect SPA navigation.
+     */
+    private _patchHistoryMethods;
+    /**
+     * Setup automatic cleanup on page unload.
+     * Covers HMR, navigation away, and browser close.
+     */
+    private _setupAutoCleanup;
+}
+//# sourceMappingURL=navigation-cache-manager.util.d.ts.map

package/dist/util/navigation-cache-manager.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation-cache-manager.util.d.ts","sourceRoot":"","sources":["../../src/util/navigation-cache-manager.util.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,qBAAa,0BAA0B;IACrC,OAAO,eAAiB;IAExB,OAAO,CAAC,MAAM,CAAC,SAAS,CAA0C;IAClE,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAwC;IACzE,OAAO,CAAC,MAAM,CAAC,qBAAqB,CAA2C;IAC/E,OAAO,CAAC,MAAM,CAAC,UAAU,CAAQ;IAEjC,OAAO,CAAC,YAAY,CAAQ;IAC5B,OAAO,CAAC,eAAe,CAAY;IAEnC,OAAc,WAAW,IAAI,0BAA0B,CAKtD;IAED;;OAEG;IACI,KAAK,SAaX;IAED;;;OAGG;IACH,OAAO,CAAC,KAAK;IAkBb;;OAEG;IACH,OAAO,CAAC,iBAAiB,CA4BxB;IAED;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAmB5B;;;OAGG;IACH,OAAO,CAAC,iBAAiB;CAW1B"}