@meonode/ui 0.4.7 → 0.4.8

package/dist/util/node.util.js

@@ -1,4 +1,4 @@
-var _NodeUtil,_excluded=["ref","key","children","css","props","disableEmotion"],_excluded2=["style"];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 _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 _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}from"react";import{isForwardRef,isMemo,isReactClassComponent}from"../helper/react-is.helper.js";import{getCSSProps,getDOMProps,getElementTypeName,omitUndefined}from"../helper/common.helper.js";import{__DEBUG__}from"../constants/common.const.js";import{BaseNode}from"../core.node.js";import{createRoot}from"react-dom/client";/**
+const _excluded=["ref","key","children","css","props","disableEmotion"],_excluded2=["style"];var _NodeUtil;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 React,{createElement,isValidElement}from"react";import{isForwardRef,isMemo,isReactClassComponent}from"../helper/react-is.helper.js";import{getCSSProps,getDOMProps,getElementTypeName,omitUndefined}from"../helper/common.helper.js";import{__DEBUG__}from"../constants/common.const.js";import{BaseNode}from"../core.node.js";import{createRoot}from"react-dom/client";/**
  * NodeUtil provides a collection of static utility methods and properties
  * used internally by BaseNode for various tasks such as hashing, shallow comparison,
  * and stable element ID generation. This centralizes common helper functions,
@@ -7,64 +7,70 @@ var _NodeUtil,_excluded=["ref","key","children","css","props","disableEmotion"],
 /**
    * Combines FNV-1a and djb2 hash functions for a more robust signature.
    * @method hashString
-   */static hashString(a){// FNV offset basis
+   */static hashString(a){let b=2166136261,c=5381;// FNV offset basis
 // djb2 init
-for(var b=Math.imul,c,d=2166136261,e=5381,f=0;f<a.length;f++)// FNV-1a
+for(let d=0;d<a.length;d++){const e=a.charCodeAt(d);// FNV-1a
 // djb2
-c=a.charCodeAt(f),d^=c,d=b(d,16777619),e=33*e^c;return"".concat((d>>>0).toString(36),"_").concat((e>>>0).toString(36))}/**
+b^=e,b=Math.imul(b,16777619),c=33*c^e}return`${(b>>>0).toString(36)}_${(c>>>0).toString(36)}`}/**
    * Performs a shallow equality check between two objects.
    * @method shallowEqual
-   */static shallowEqual(c,a){if(c===a)return!0;var b=0,d=0;for(var e in c){if(!(e in a)||c[e]!==a[e])return!1;b++}for(var f in a)d++;return b===d}/**
+   */static shallowEqual(c,a){if(c===a)return!0;let b=0,d=0;for(const d in c){if(!(d in a)||c[d]!==a[d])return!1;b++}for(const b in a)d++;return b===d}/**
    * 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){if(!NodeUtil.isServer){var c=getElementTypeName(a),d=Object.keys(b).sort(),e=["".concat(c,":")];if("function"==typeof a){var f=NodeUtil._functionSignatureCache.get(a);f||(f=NodeUtil.hashString(a.toString()),NodeUtil._functionSignatureCache.set(a,f)),e.push(f)}var g,h=_createForOfIteratorHelper(d);try{for(h.s();!(g=h.n()).done;){var i=g.value,j=b[i],k=void 0,l=_typeof(j);if("string"===l||"number"===l||"boolean"===l)k="".concat(i,":").concat(j,";");else if(null===j)k="".concat(i,":null;");else if(void 0===j)k="".concat(i,":undefined;");else if(Array.isArray(j)){// Hash primitive values in arrays for better cache hits
-var m=j.filter(function(a){var b=_typeof(a);return"string"===b||"number"===b||"boolean"===b||null===a});k=m.length===j.length?"".concat(i,":[").concat(m.join(","),"];"):"".concat(i,":[").concat(j.length,"];")}else if(j&&j.isBaseNode)k="".concat(i,":").concat(j.stableKey,";");else{// Include sorted keys for object structure signature
-var n=Object.keys(j).sort();k="".concat(i,":{").concat(n.join(","),"};")}e.push(k)}}catch(a){h.e(a)}finally{h.f()}return NodeUtil.hashString(e.join(","))}}/**
+   */static createPropSignature(a,b){if(NodeUtil.isServer)return;const c=getElementTypeName(a),d=Object.keys(b).sort(),e=[`${c}:`];if("function"==typeof a){let b=NodeUtil._functionSignatureCache.get(a);b||(b=NodeUtil.hashString(a.toString()),NodeUtil._functionSignatureCache.set(a,b)),e.push(b)}for(const c of d){const a=b[c];let d;const f=typeof a;if("string"==f||"number"===f||"boolean"===f)d=`${c}:${a};`;else if(null===a)d=`${c}:null;`;else if(a===void 0)d=`${c}:undefined;`;else if(Array.isArray(a)){// Hash primitive values in arrays for better cache hits
+const b=a.filter(a=>{const b=typeof a;return"string"==b||"number"===b||"boolean"===b||null===a});d=b.length===a.length?`${c}:[${b.join(",")}];`:`${c}:[${a.length}];`}else if(a&&a.isBaseNode)d=`${c}:${a.stableKey};`;else{// Include sorted keys for object structure signature
+const b=Object.keys(a).sort();d=`${c}:{${b.join(",")}};`}e.push(d)}return NodeUtil.hashString(e.join(","))}/**
    * Extracts "critical" props from a given set of props. Critical props are those
    * that are frequently used for styling or event handling, such as `on*` handlers,
    * `aria-*` attributes, `data-*` attributes, `css`, `className`, and `style`.
    * This method is used to optimize prop processing by focusing on props that are
    * most likely to influence rendering or behavior.
-   */static extractCriticalProps(a,b){var c,d={_keyCount:b.length},e=0,f=_createForOfIteratorHelper(b);try{var g=function _loop(){var b=c.value;return 50<=e?1:void((NodeUtil.CRITICAL_PROPS.has(b)||NodeUtil.isStyleProp(b)||Array.from(NodeUtil.CRITICAL_PROP_PREFIXES).some(function(a){return b.startsWith(a)}))&&(d[b]=a[b],e++))};for(f.s();!(c=f.n()).done&&!g(););}catch(a){f.e(a)}finally{f.f()}return d}/**
+   */static extractCriticalProps(a,b){const c={_keyCount:b.length};let d=0;for(const e of b){if(50<=d)break;// Fast path: direct Set check first (O(1))
+if(NodeUtil.CRITICAL_PROPS.has(e)){c[e]=a[e],d++;continue}// Inline prefix checks using charCode (faster than startsWith for short prefixes)
+const f=e.charCodeAt(0);// Check 'on' prefix (111 = 'o', 110 = 'n')
+if(111===f&&110===e.charCodeAt(1)){c[e]=a[e],d++;continue}// Check 'aria' prefix (97 = 'a', 114 = 'r', 105 = 'i')
+if(97===f&&114===e.charCodeAt(1)&&105===e.charCodeAt(2)&&97===e.charCodeAt(3)){c[e]=a[e],d++;continue}// Check 'data' prefix (100 = 'd', 97 = 'a', 116 = 't')
+if(100===f&&97===e.charCodeAt(1)&&116===e.charCodeAt(2)&&97===e.charCodeAt(3)){c[e]=a[e],d++;continue}// Style prop check last (most expensive), only for smaller objects
+100>=b.length&&NodeUtil.isStyleProp(e)&&(c[e]=a[e],d++)}return c}/**
    * 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(NodeUtil.isServer||!b)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>NodeUtil.CACHE_SIZE_LIMIT&&!BaseNode.scheduledCleanup&&(BaseNode.scheduledCleanup=!0,"undefined"==typeof requestIdleCallback?setTimeout(function(){NodeUtil._evictLRUEntries(),BaseNode.scheduledCleanup=!1},100):requestIdleCallback(function(){NodeUtil._evictLRUEntries(),BaseNode.scheduledCleanup=!1},{timeout:2e3})),{cssProps:d}}/**
+   */static getCachedCssProps(a,b){if(NodeUtil.isServer||!b)return{cssProps:getCSSProps(a)};const c=BaseNode.propProcessingCache.get(b);if(c)return c.lastAccess=Date.now(),c.hitCount++,{cssProps:c.cssProps};const d=getCSSProps(a);return BaseNode.propProcessingCache.set(b,{cssProps:d,signature:b,lastAccess:Date.now(),hitCount:1}),BaseNode.propProcessingCache.size>NodeUtil.CACHE_SIZE_LIMIT&&!BaseNode.scheduledCleanup&&(BaseNode.scheduledCleanup=!0,"undefined"==typeof requestIdleCallback?setTimeout(()=>{NodeUtil._evictLRUEntries(),BaseNode.scheduledCleanup=!1},100):requestIdleCallback(()=>{NodeUtil._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)
+   */static _evictLRUEntries(){const a=Date.now(),b=[];// Calculate eviction scores for all entries
+for(const[c,d]of BaseNode.propProcessingCache.entries()){const e=a-d.lastAccess,f=d.hitCount;// 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(NodeUtil.CACHE_CLEANUP_BATCH,c.length),m=0;m<l;m++)BaseNode.propProcessingCache["delete"](c[m].key)}/**
+b.push({key:c,score:e/1e3+1e3/(f+1)})}// Sort by score (highest = most evictable)
+b.sort((c,a)=>a.score-c.score);// Remove top N entries
+const c=Math.min(NodeUtil.CACHE_CLEANUP_BATCH,b.length);for(let a=0;a<c;a++)BaseNode.propProcessingCache.delete(b[a].key)}/**
    * The main prop processing pipeline. It separates cacheable and non-cacheable props,
    * generates a signature for caching, and assembles the final props object.
    * @method processProps
-   */static processProps(a){var b=1<arguments.length&&arguments[1]!==void 0?arguments[1]:{},c=2<arguments.length?arguments[2]:void 0,d=b.ref,e=b.key,f=b.children,g=b.css,h=b.props,i=void 0===h?{}:h,j=b.disableEmotion,k=_objectWithoutProperties(b,_excluded);// --- Fast Path Optimization ---
-if(0===Object.keys(k).length&&!g)return omitUndefined({ref:d,key:e,disableEmotion:j,nativeProps:omitUndefined(i),children:NodeUtil._processChildren(f,j)});// --- Hybrid Caching Strategy ---
-var l={},m={};// 1. Categorize props into cacheable (primitives) and non-cacheable (objects/functions).
-for(var n in k)if(Object.prototype.hasOwnProperty.call(k,n)){var o=k[n],p=_typeof(o);"string"===p||"number"===p||"boolean"===p?l[n]=o:m[n]=o}// 2. Pass element type to signature generation
-var q=NodeUtil.createPropSignature(a,l),r=NodeUtil.getCachedCssProps(l,q),s=r.cssProps,t=getCSSProps(m),u=getDOMProps(k),v=_objectSpread(_objectSpread(_objectSpread({},s),t),g),w=NodeUtil._processChildren(f,j,c);// 3. Process non-cacheable props on every render to ensure correctness for functions and objects.
+   */static processProps(a,b={},c){const{ref:d,key:e,children:f,css:g,props:i={},disableEmotion:h}=b,j=_objectWithoutProperties(b,_excluded);// --- Fast Path Optimization ---
+if(0===Object.keys(j).length&&!g)return omitUndefined({ref:d,key:e,disableEmotion:h,nativeProps:omitUndefined(i),children:NodeUtil._processChildren(f,h)});// --- Hybrid Caching Strategy ---
+const k={},l={};// 1. Categorize props into cacheable (primitives) and non-cacheable (objects/functions).
+for(const d in j)if(Object.prototype.hasOwnProperty.call(j,d)){const a=j[d],b=typeof a;"string"===b||"number"===b||"boolean"===b?k[d]=a:l[d]=a}// 2. Pass element type to signature generation
+const m=NodeUtil.createPropSignature(a,k),{cssProps:n}=NodeUtil.getCachedCssProps(k,m),o=getCSSProps(l),p=getDOMProps(j),q=_objectSpread(_objectSpread(_objectSpread({},n),o),g),r=NodeUtil._processChildren(f,h,c);// 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:d,key:e,css:v},u),{},{disableEmotion:j,nativeProps:omitUndefined(i),children:w}))}/**
+return omitUndefined(_objectSpread(_objectSpread({ref:d,key:e,css:q},p),{},{disableEmotion:h,nativeProps:omitUndefined(i),children:r}))}/**
    * Processes and normalizes children of the node.
    * Converts raw children (React elements, primitives, or other BaseNodes) into a consistent format.
    * @param children The raw children to process.
    * @param disableEmotion If true, emotion styling will be disabled for these children.
    * @param parentStableKey The stable key of the parent node, used for generating unique keys for children.
-   */static _processChildren(a,b,c){return a?"function"==typeof a?a:Array.isArray(a)?a.map(function(a,d){return NodeUtil.processRawNode(a,b,"".concat(c,"_").concat(d))}):NodeUtil.processRawNode(a,b,c):void 0}/**
+   */static _processChildren(a,b,c){return a?"function"==typeof a?a:Array.isArray(a)?a.map((a,d)=>NodeUtil.processRawNode(a,b,`${c}_${d}`)):NodeUtil.processRawNode(a,b,c):void 0}/**
    * 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!!NodeUtil.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.
+return!!NodeUtil.isServer||!c&&(!(void 0!==b)||!(void 0!==a)||b.length!==a.length||!!b.some((b,c)=>!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.
@@ -76,12 +82,12 @@ return!!NodeUtil.isServer||!c&&(!(void 0!==b)||!(void 0!==a)||b.length!==a.lengt
    * @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(NodeUtil.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.
+if(NodeUtil.isNodeInstance(a)){const d=c||b&&!a.rawProps.disableEmotion;if(d){// Create a new BaseNode instance.
+const d=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).
+return d.stableKey=`${c}:${d.stableKey}`,b&&!d.rawProps.disableEmotion&&(d.rawProps.disableEmotion=!0),d}return a}// Handle function-as-a-child (render props).
 if(NodeUtil.isFunctionChild(a))return new BaseNode(NodeUtil.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,_excluded2),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.
+if(isValidElement(a)){const c=a.props,{style:d}=c,e=_objectWithoutProperties(c,_excluded2),f=_objectSpread(_objectSpread({},e),d||{});return new BaseNode(a.type,_objectSpread(_objectSpread(_objectSpread({},f),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?NodeUtil.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)
@@ -100,22 +106,23 @@ return isReactClassComponent(a)||isMemo(a)||isForwardRef(a)?new BaseNode(a,{disa
    * @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.
-__DEBUG__&&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(NodeUtil.isNodeInstance(b))// If emotion is disabled for the parent and not explicitly re-enabled on the child,
+   */static functionRenderer({render:a,disableEmotion:b}){let c;try{// Execute the render prop function to get its output.
+c=a()}catch(a){// If the render function throws, treat its output as null to prevent crashes.
+__DEBUG__&&console.error("MeoNode: Error executing function-as-a-child.",a),c=null}// Handle null or undefined results directly, as they are valid React render outputs.
+if(null===c||c===void 0)return c;// If the result is already a BaseNode instance, process it.
+if(NodeUtil.isNodeInstance(c))// 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.
+return b&&!c.rawProps.disableEmotion?new BaseNode(c.element,_objectSpread(_objectSpread({},c.rawProps),{},{disableEmotion:!0})).render():c.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 __DEBUG__&&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 NodeUtil.renderProcessedNode({processedElement:NodeUtil.processRawNode(a,d),passedKey:e(a,b),disableEmotion:d})})}if(b instanceof React.Component)return NodeUtil.renderProcessedNode({processedElement:NodeUtil.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=NodeUtil.processRawNode(b,d);// If processing yields a valid element, render it.
-return f?NodeUtil.renderProcessedNode({processedElement:f,disableEmotion:d}):b;// Fallback: return the original result if it couldn't be processed into a renderable node.
+if(Array.isArray(c)){// Helper to generate a stable key for array items, crucial for React's reconciliation.
+const a=(a,b)=>{try{// Attempt to get a meaningful name for the element type.
+return`${getElementTypeName(a)}-${b}`}catch(a){// Fallback to a generic key if type name cannot be determined.
+return __DEBUG__&&console.error("MeoNode: Could not determine element type name for key in function-as-a-child.",a),`item-${b}`}};// Map over the array, processing each item and assigning a key.
+return c.map((c,d)=>NodeUtil.renderProcessedNode({processedElement:NodeUtil.processRawNode(c,b),passedKey:a(c,d),disableEmotion:b}))}// If the result is a React component instance (e.g., `new MyClassComponent()`).
+if(c instanceof React.Component)return NodeUtil.renderProcessedNode({processedElement:NodeUtil.processRawNode(c.render(),b),disableEmotion:b});// Handle primitive types directly, as they are valid React children.
+if("string"==typeof c||"number"==typeof c||"boolean"==typeof c)return c;// For any other non-primitive, non-array result, process it as a single NodeElement.
+const d=NodeUtil.processRawNode(c,b);// If processing yields a valid element, render it.
+return d?NodeUtil.renderProcessedNode({processedElement:d,disableEmotion:b}):c;// 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,
@@ -125,18 +132,18 @@ return f?NodeUtil.renderProcessedNode({processedElement:f,disableEmotion:d}):b;/
    * 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`.
+   */static renderProcessedNode({processedElement:a,passedKey:b,disableEmotion:c}){// Initialize an object to hold common props that might be applied to the new BaseNode.
+const d={};// 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),NodeUtil.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(void 0!==b&&(d.key=b),NodeUtil.isNodeInstance(a)){// Get the existing key from the raw props of the BaseNode.
+const e=a.rawProps?.key;// 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.
+return a.rawProps.disableEmotion=c,e===b?a.render():new BaseNode(a.element,_objectSpread(_objectSpread({},a.rawProps),d)).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()`).
+return isReactClassComponent(a)?new BaseNode(a,_objectSpread(_objectSpread({},d),{},{disableEmotion:c})).render():a instanceof React.Component?a.render():"function"==typeof a?createElement(a,{key:b}):a;// 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`.
@@ -145,11 +152,11 @@ return isReactClassComponent(b)?new BaseNode(b,_objectSpread(_objectSpread({},e)
    * Ensures that the necessary DOM element and React root are available for portal rendering.
    * This is only executed on the client-side.
    * @method ensurePortalInfrastructure
-   */static ensurePortalInfrastructure(a){var b,c,d;if(NodeUtil.isServer)return!1;var e=NodeUtil.portalInfrastructure.get(a);// Check if infrastructure exists and is still connected
-if(null!==(b=e)&&void 0!==b&&null!==(b=b.domElement)&&void 0!==b&&b.isConnected&&null!==(c=e)&&void 0!==c&&c.reactRoot)return!0;// Clean up stale or disconnected infrastructure
-if(e&&(!(null!==(d=e.domElement)&&void 0!==d&&d.isConnected)||!e.reactRoot)){try{var f,g;null===(f=e.reactRoot)||void 0===f||null===(g=f.unmount)||void 0===g||g.call(f)}catch(a){__DEBUG__&&console.error("MeoNode: Error unmounting stale portal root.",a)}NodeUtil.cleanupPortalInfra(e),NodeUtil.portalInfrastructure["delete"](a),e=void 0}// Create new infrastructure
-var h=document.createElement("div");document.body.appendChild(h);var i=createRoot(h),j={render:i.render.bind(i),unmount:i.unmount.bind(i),update:function update(){}// Placeholder, will be overridden
-};return e={domElement:h,reactRoot:j},NodeUtil.portalInfrastructure.set(a,e),BaseNode.portalCleanupRegistry.register(a,{domElement:h,reactRoot:j},a),!0}static cleanupPortalInfra(a){try{var b;null!==(b=a.reactRoot)&&void 0!==b&&b.unmount&&a.reactRoot.unmount()}catch(a){__DEBUG__&&console.error("Portal cleanup error:",a)}try{var c;null!==(c=a.domElement)&&void 0!==c&&c.isConnected&&a.domElement.remove()}catch(a){__DEBUG__&&console.error("DOM removal error:",a)}}}// Unique ID generation for elements
+   */static ensurePortalInfrastructure(a){if(NodeUtil.isServer)return!1;let b=NodeUtil.portalInfrastructure.get(a);// Check if infrastructure exists and is still connected
+if(b?.domElement?.isConnected&&b?.reactRoot)return!0;// Clean up stale or disconnected infrastructure
+if(b&&(!b.domElement?.isConnected||!b.reactRoot)){try{b.reactRoot?.unmount?.()}catch(a){__DEBUG__&&console.error("MeoNode: Error unmounting stale portal root.",a)}NodeUtil.cleanupPortalInfra(b),NodeUtil.portalInfrastructure.delete(a),b=void 0}// Create new infrastructure
+const c=document.createElement("div");document.body.appendChild(c);const d=createRoot(c),e={render:d.render.bind(d),unmount:d.unmount.bind(d),update:()=>{}// Placeholder, will be overridden
+};return b={domElement:c,reactRoot:e},NodeUtil.portalInfrastructure.set(a,b),BaseNode.portalCleanupRegistry.register(a,{domElement:c,reactRoot:e},a),!0}static cleanupPortalInfra(a){try{a.reactRoot?.unmount&&a.reactRoot.unmount()}catch(a){__DEBUG__&&console.error("Portal cleanup error:",a)}try{a.domElement?.isConnected&&a.domElement.remove()}catch(a){__DEBUG__&&console.error("DOM removal error:",a)}}}// Unique ID generation for elements
 // Cache configuration
 // Clean up 50 entries at once when limit hit
 // Critical props for signature generation and shallow comparison
@@ -169,4 +176,4 @@ var h=document.createElement("div");document.body.appendChild(h);var i=createRoo
    * This check is performed only on the client-side by checking if the property exists in `document.body.style`.
    * On the server-side, it always returns `false`.
    * @param k The string to check.
-   */_NodeUtil=NodeUtil,_defineProperty(NodeUtil,"isServer","undefined"==typeof window),_defineProperty(NodeUtil,"_functionSignatureCache",new WeakMap),_defineProperty(NodeUtil,"CACHE_SIZE_LIMIT",500),_defineProperty(NodeUtil,"CACHE_CLEANUP_BATCH",50),_defineProperty(NodeUtil,"CRITICAL_PROP_PREFIXES",new Set(["on","aria","data"])),_defineProperty(NodeUtil,"CRITICAL_PROPS",new Set(["css","className","disableEmotion","props"])),_defineProperty(NodeUtil,"portalInfrastructure",new WeakMap),_defineProperty(NodeUtil,"isNodeInstance",function(a){return"object"===_typeof(a)&&null!==a&&"element"in a&&"function"==typeof a.render&&"function"==typeof a.toPortal&&"isBaseNode"in a}),_defineProperty(NodeUtil,"isStyleProp",_NodeUtil.isServer||"undefined"==typeof document?function(){return!1}:function(a){return a in document.body.style});
+   */_NodeUtil=NodeUtil,_defineProperty(NodeUtil,"isServer","undefined"==typeof window),_defineProperty(NodeUtil,"_functionSignatureCache",new WeakMap),_defineProperty(NodeUtil,"CACHE_SIZE_LIMIT",500),_defineProperty(NodeUtil,"CACHE_CLEANUP_BATCH",50),_defineProperty(NodeUtil,"CRITICAL_PROPS",new Set(["css","className","disableEmotion","props"])),_defineProperty(NodeUtil,"portalInfrastructure",new WeakMap),_defineProperty(NodeUtil,"isNodeInstance",a=>"object"==typeof a&&null!==a&&"element"in a&&"function"==typeof a.render&&"function"==typeof a.toPortal&&"isBaseNode"in a),_defineProperty(NodeUtil,"isStyleProp",_NodeUtil.isServer||"undefined"==typeof document?()=>!1:a=>a in document.body.style);

package/dist/util/theme.util.d.ts

@@ -1,5 +1,5 @@
-import type { CSSInterpolation, CSSProperties } from '@emotion/serialize';
-import type { Theme } from '../types/node.type.js';
+import type { CSSProperties } from '@emotion/serialize';
+import type { CssProp, Theme } from '../types/node.type.js';
 /**
  * Parsed flex shorthand components for CSS flex property
  * @interface FlexComponents
@@ -34,7 +34,7 @@ export declare class ThemeUtil {
      * parseFlexShorthand('1 0 auto') // → {grow: 1, shrink: 0, basis: 'auto'}
      */
     static parseFlexShorthand(flex: CSSProperties['flex']): FlexComponents | null;
-    static isPlainObject: (value: any) => boolean;
+    static isPlainObject: (value: unknown) => value is Record<string, unknown>;
     /**
      * Resolves theme variable references in an object's values iteratively.
      * This function uses a manual work stack to traverse the object, which prevents
@@ -44,9 +44,9 @@ export declare class ThemeUtil {
      * object references for unchanged parts of the tree, which is critical for
      * React's reconciliation and memoization.
      */
-    static resolveObjWithTheme: (obj?: Record<string, any>, theme?: Theme | undefined, options?: {
+    static resolveObjWithTheme: <O extends Record<string, unknown>>(obj: O, theme?: Theme | undefined, options?: {
         processFunctions?: boolean | undefined;
-    }) => any;
+    }) => O;
     static clearThemeCache: () => void;
     /**
      * Resolves default CSS styles to fix common flexbox layout issues.
@@ -102,7 +102,7 @@ export declare class ThemeUtil {
      * })
      * // → { display: 'flex', flexWrap: 'wrap', minHeight: 0, minWidth: 0 }
      */
-    static resolveDefaultStyle: (style: CSSInterpolation) => {};
+    static resolveDefaultStyle: (style: CssProp) => {};
 }
 export {};
 //# sourceMappingURL=theme.util.d.ts.map

package/dist/util/theme.util.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"theme.util.d.ts","sourceRoot":"","sources":["../../src/util/theme.util.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AACzE,OAAO,KAAK,EAAE,KAAK,EAAe,MAAM,yBAAyB,CAAA;AAiGjE;;;;;;GAMG;AACH,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,GAAG,MAAM,CAAA;CACvB;AACD,qBAAa,SAAS;IACpB,OAAO,eAAiB;IAExB,OAAO,CAAC,MAAM,CAAC,UAAU,CAAmC;IAE5D;;;;;;;;;;;;;;;;;OAiBG;IACH,OAAc,kBAAkB,CAAC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,cAAc,GAAG,IAAI,CA2BnF;IAED,OAAc,aAAa,0BAM1B;IAED;;;;;;;;OAQG;IACH,OAAc,mBAAmB;;cAoHhC;IAED,OAAc,eAAe,aAE5B;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAqDG;IACH,OAAc,mBAAmB,kCAmEhC;CACF"}
+{"version":3,"file":"theme.util.d.ts","sourceRoot":"","sources":["../../src/util/theme.util.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AACvD,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAe,MAAM,yBAAyB,CAAA;AAiG1E;;;;;;GAMG;AACH,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,GAAG,MAAM,CAAA;CACvB;AACD,qBAAa,SAAS;IACpB,OAAO,eAAiB;IAExB,OAAO,CAAC,MAAM,CAAC,UAAU,CAAmC;IAE5D;;;;;;;;;;;;;;;;;OAiBG;IACH,OAAc,kBAAkB,CAAC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,cAAc,GAAG,IAAI,CA2BnF;IAED,OAAc,aAAa,uDAM1B;IAED;;;;;;;;OAQG;IACH,OAAc,mBAAmB,GAAI,CAAC;;YA0HrC;IAED,OAAc,eAAe,aAE5B;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAqDG;IACH,OAAc,mBAAmB,yBAmEhC;CACF"}

package/dist/util/theme.util.js

@@ -1,9 +1,9 @@
-var _ThemeUtil,_excluded=["flex"];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{ObjHelper}from"../helper/obj.helper.js";import{getValueByPath}from"../helper/common.helper.js";/**
+const _excluded=["flex"];var _ThemeUtil;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{ObjHelper}from"../helper/obj.helper.js";import{getValueByPath}from"../helper/common.helper.js";/**
  * Cache manager for theme resolution operations.
  */class ThemeResolverCache{constructor(){_defineProperty(this,"CACHE_SIZE_LIMIT",500),_defineProperty(this,"CACHE_EVICTION_BATCH_SIZE",50),_defineProperty(this,"_resolutionCache",new Map),_defineProperty(this,"_pathLookupCache",new Map),_defineProperty(this,"_themeRegex",/theme\.([a-zA-Z0-9_.-]+)/g)}static getInstance(){return ThemeResolverCache._instance||(ThemeResolverCache._instance=new ThemeResolverCache),ThemeResolverCache._instance}/**
    * Generate a stable cache key from object and theme, including the theme mode.
    */_generateCacheKey(a,b){// Including theme.mode is critical for cache correctness.
-return"".concat(ObjHelper.stringify(a),"_").concat(b.mode,"_").concat(ObjHelper.stringify(b.system))}getResolution(a,b){var c=this._generateCacheKey(a,b),d=this._resolutionCache.get(c);return d&&(this._resolutionCache["delete"](c),this._resolutionCache.set(c,d)),d||null}setResolution(a,b,c){var d=this._generateCacheKey(a,b);this._resolutionCache.set(d,c),this._resolutionCache.size>this.CACHE_SIZE_LIMIT&&this._evict(this._resolutionCache)}getPathLookup(a,b){var c="".concat(ObjHelper.stringify(a),"_").concat(b),d=this._pathLookupCache.get(c);return d&&(this._pathLookupCache["delete"](c),this._pathLookupCache.set(c,d)),d||null}setPathLookup(a,b,c){var d="".concat(ObjHelper.stringify(a),"_").concat(b);this._pathLookupCache.set(d,c),this._pathLookupCache.size>this.CACHE_SIZE_LIMIT&&this._evict(this._pathLookupCache)}_evict(a){for(var b,c=a.keys(),d=0;d<this.CACHE_EVICTION_BATCH_SIZE&&(b=c.next().value,b);d++)a["delete"](b)}getThemeRegex(){return this._themeRegex.lastIndex=0,this._themeRegex}shouldCache(){return"undefined"==typeof window}clear(){this._resolutionCache.clear(),this._pathLookupCache.clear()}}/**
+return`${ObjHelper.stringify(a)}_${b.mode}_${ObjHelper.stringify(b.system)}`}getResolution(a,b){const c=this._generateCacheKey(a,b),d=this._resolutionCache.get(c);return d&&(this._resolutionCache.delete(c),this._resolutionCache.set(c,d)),d||null}setResolution(a,b,c){const d=this._generateCacheKey(a,b);this._resolutionCache.set(d,c),this._resolutionCache.size>this.CACHE_SIZE_LIMIT&&this._evict(this._resolutionCache)}getPathLookup(a,b){const c=`${ObjHelper.stringify(a)}_${b}`,d=this._pathLookupCache.get(c);return d&&(this._pathLookupCache.delete(c),this._pathLookupCache.set(c,d)),d??null}setPathLookup(a,b,c){const d=`${ObjHelper.stringify(a)}_${b}`;this._pathLookupCache.set(d,c),this._pathLookupCache.size>this.CACHE_SIZE_LIMIT&&this._evict(this._pathLookupCache)}_evict(a){const b=a.keys();for(let c=0;c<this.CACHE_EVICTION_BATCH_SIZE;c++){const c=b.next().value;if(c)a.delete(c);else break}}getThemeRegex(){return this._themeRegex.lastIndex=0,this._themeRegex}shouldCache(){return"undefined"==typeof window}clear(){this._resolutionCache.clear(),this._pathLookupCache.clear()}}/**
  * Parsed flex shorthand components for CSS flex property
  * @interface FlexComponents
  * @property grow - The flex-grow value (how much the item should grow)
@@ -28,7 +28,7 @@ return"".concat(ObjHelper.stringify(a),"_").concat(b.mode,"_").concat(ObjHelper.
    * parseFlexShorthand('1 0 auto') // → {grow: 1, shrink: 0, basis: 'auto'}
    */static parseFlexShorthand(a){// Early returns for invalid inputs
 if(null===a||a===void 0)return null;// Handle numeric flex values (e.g., flex: 1)
-if("number"==typeof a)return{grow:a,shrink:1,basis:"0%"};if("string"!=typeof a)return null;var b=a.trim().toLowerCase();if(!b)return null;// Handle CSS keyword values
+if("number"==typeof a)return{grow:a,shrink:1,basis:"0%"};if("string"!=typeof a)return null;const b=a.trim().toLowerCase();if(!b)return null;// Handle CSS keyword values
 return"none"===b?{grow:0,shrink:0,basis:"auto"}:"auto"===b?{grow:1,shrink:1,basis:"auto"}:"initial"===b?{grow:0,shrink:1,basis:"auto"}:null}}/**
    * Resolves theme variable references in an object's values iteratively.
    * This function uses a manual work stack to traverse the object, which prevents
@@ -90,11 +90,12 @@ return"none"===b?{grow:0,shrink:0,basis:"auto"}:"auto"===b?{grow:1,shrink:1,basi
    *   flexWrap: 'wrap'
    * })
    * // → { display: 'flex', flexWrap: 'wrap', minHeight: 0, minWidth: 0 }
-   */_ThemeUtil=ThemeUtil,_defineProperty(ThemeUtil,"themeCache",ThemeResolverCache.getInstance()),_defineProperty(ThemeUtil,"isPlainObject",function(a){if("object"!==_typeof(a)||null===a)return!1;var b=Object.getPrototypeOf(a);return null===b||b===Object.prototype}),_defineProperty(ThemeUtil,"resolveObjWithTheme",function(){var a,b=0<arguments.length&&void 0!==arguments[0]?arguments[0]:{},c=1<arguments.length?arguments[1]:void 0,d=2<arguments.length&&void 0!==arguments[2]?arguments[2]:{},e=d.processFunctions;if(!c||!c.system||"object"!==_typeof(c.system)||0===Object.keys(c.system).length||0===Object.keys(b).length)return b;var f=c.system;if(_ThemeUtil.themeCache.shouldCache()){var g=_ThemeUtil.themeCache.getResolution(b,c);if(null!==g)return g}// Used for cycle detection within the current traversal path.
-for(var h=[{value:b,isProcessed:!1}],j=new Map,k=new Set,l=function processThemeString(a){var b=_ThemeUtil.themeCache.getThemeRegex(),c=!1,d=a.replace(b,function(a,b){var d=_ThemeUtil.themeCache.getPathLookup(f,b);return null===d&&(d=getValueByPath(f,b),_ThemeUtil.themeCache.setPathLookup(f,b,d)),void 0!==d&&null!==d?(c=!0,"object"===_typeof(d)&&!Array.isArray(d)&&"default"in d?d["default"]:d):a});return c?d:a};0<h.length;){var m=h[h.length-1],n=m.value;if(!_ThemeUtil.isPlainObject(n)&&!Array.isArray(n)){h.pop();continue}if(j.has(n)){h.pop();continue}if(!m.isProcessed){m.isProcessed=!0,k.add(n);for(var o,p=Array.isArray(n)?n:Object.values(n),q=p.length-1;0<=q;q--)o=p[q],(_ThemeUtil.isPlainObject(o)||Array.isArray(o))&&!k.has(o)&&h.push({value:o,isProcessed:!1})}else{h.pop(),k["delete"](n);// Unwind the path
-var r=n;if(Array.isArray(n)){for(var s=null,t=0;t<n.length;t++){var u,v=n[t],w=null!==(u=j.get(v))&&void 0!==u?u:v;w!==v&&(null===s&&(s=[...n]),s[t]=w)}null!==s&&(r=s)}else{var x=null;for(var y in n)if(Object.prototype.hasOwnProperty.call(n,y)){var z,A=n[y],B=null!==(z=j.get(A))&&void 0!==z?z:A;if("function"==typeof B&&void 0!==e&&e){var C=B(c);B="string"==typeof C&&C.includes("theme.")?l(C):C}else"string"==typeof B&&B.includes("theme.")&&(B=l(B));B!==A&&(null===x&&(x=_objectSpread({},n)),x[y]=B)}null!==x&&(r=x)}j.set(n,r)}}var D=null!==(a=j.get(b))&&void 0!==a?a:b;return _ThemeUtil.themeCache.shouldCache()&&_ThemeUtil.themeCache.setResolution(b,c,D),D}),_defineProperty(ThemeUtil,"clearThemeCache",function(){_ThemeUtil.themeCache.clear()}),_defineProperty(ThemeUtil,"resolveDefaultStyle",function(a){var b;if(null===a||a===void 0||"string"==typeof a||"number"==typeof a||"boolean"==typeof a)return{};// === STEP 1: EXTRACT FLEX PROPERTY ===
+   */_ThemeUtil=ThemeUtil,_defineProperty(ThemeUtil,"themeCache",ThemeResolverCache.getInstance()),_defineProperty(ThemeUtil,"isPlainObject",a=>{if("object"!=typeof a||null===a)return!1;const b=Object.getPrototypeOf(a);return null===b||b===Object.prototype}),_defineProperty(ThemeUtil,"resolveObjWithTheme",(a,b,c={})=>{const{processFunctions:d=!1}=c;if(!b||!b.system||"object"!=typeof b.system||0===Object.keys(b.system).length||!a||0===Object.keys(a).length)return a;const e=b.system;if(_ThemeUtil.themeCache.shouldCache()){const c=_ThemeUtil.themeCache.getResolution(a,b);if(null!==c)return c}const f=[{value:a,isProcessed:!1}],g=new Map,h=new Set,i=a=>{const b=_ThemeUtil.themeCache.getThemeRegex();let c=!1;const d=a.replace(b,(a,b)=>{let d=_ThemeUtil.themeCache.getPathLookup(e,b);if(null===d&&(d=getValueByPath(e,b),_ThemeUtil.themeCache.setPathLookup(e,b,d)),void 0!==d&&null!==d){if(c=!0,"object"==typeof d){if(!Array.isArray(d)&&"default"in d)return d.default;throw new Error("The provided theme path is invalid!")}return d}return a});return c?d:a};// Used for cycle detection within the current traversal path.
+for(;0<f.length;){const a=f[f.length-1],c=a.value;if(!_ThemeUtil.isPlainObject(c)&&!Array.isArray(c)){f.pop();continue}if(g.has(c)){f.pop();continue}if(!a.isProcessed){a.isProcessed=!0,h.add(c);const b=Array.isArray(c)?c:Object.values(c);for(let a=b.length-1;0<=a;a--){const c=b[a];// Only push containers that are not already in the current path (cycle detection).
+(_ThemeUtil.isPlainObject(c)||Array.isArray(c))&&!h.has(c)&&f.push({value:c,isProcessed:!1})}}else{f.pop(),h.delete(c);// Unwind the path
+let a=c;if(Array.isArray(c)){let b=null;for(let a=0;a<c.length;a++){const d=c[a],e=g.get(d)??d;e!==d&&(null===b&&(b=[...c]),b[a]=e)}null!==b&&(a=b)}else{let e=null;for(const a in c)if(Object.prototype.hasOwnProperty.call(c,a)){const f=c[a];let h=g.get(f)??f;if("function"==typeof h&&d){const a=h(b);h="string"==typeof a&&a.includes("theme.")?i(a):a}else"string"==typeof h&&h.includes("theme.")&&(h=i(h));h!==f&&(null===e&&(e=_objectSpread({},c)),e[a]=h)}null!==e&&(a=e)}g.set(c,a)}}const j=g.get(a)??a;return _ThemeUtil.themeCache.shouldCache()&&_ThemeUtil.themeCache.setResolution(a,b,j),j}),_defineProperty(ThemeUtil,"clearThemeCache",()=>{_ThemeUtil.themeCache.clear()}),_defineProperty(ThemeUtil,"resolveDefaultStyle",a=>{if(null===a||a===void 0||"string"==typeof a||"number"==typeof a||"boolean"==typeof a)return{};// === STEP 1: EXTRACT FLEX PROPERTY ===
 // Extract flex shorthand to handle it separately from individual flex properties
-var c=a,d=c.flex,e=_objectWithoutProperties(c,_excluded),f="flex"===e.display||"inline-flex"===e.display,g=!!(e.overflow||e.overflowY||e.overflowX),h=(null===(b=e.flexFlow)||void 0===b?void 0:b.includes("wrap"))||"wrap"===e.flexWrap||"wrap-reverse"===e.flexWrap,i="flexShrink"in a&&a.flexShrink!==void 0,j=d?_ThemeUtil.parseFlexShorthand(d):null,k=void 0;// === STEP 2: ANALYZE LAYOUT CONTEXT ===
+const b=a,{flex:c}=b,d=_objectWithoutProperties(b,_excluded),e="flex"===d.display||"inline-flex"===d.display,f=!!(d.overflow||d.overflowY||d.overflowX),g=d.flexFlow?.includes("wrap")||"wrap"===d.flexWrap||"wrap-reverse"===d.flexWrap,h="flexShrink"in a&&a.flexShrink!==void 0,i=c?_ThemeUtil.parseFlexShorthand(c):null;// === STEP 2: ANALYZE LAYOUT CONTEXT ===
 // Determine what kind of element we're dealing with
 // Check if overflow is set (any overflow value indicates potential scrolling)
 // Check if flex wrapping is enabled (allows items to wrap to new lines)
@@ -102,16 +103,16 @@ var c=a,d=c.flex,e=_objectWithoutProperties(c,_excluded),f="flex"===e.display||"
 // Respect user's explicit flexShrink setting
 // Extract shrink value from flex shorthand if provided
 // === STEP 4: DETERMINE FLEX SHRINK BEHAVIOR ===
-// Only set flexShrink if user hasn't explicitly provided it
-if(!i)// If flex shorthand contains a shrink value, use that
-if(j)k=j.shrink;else// Apply context-based defaults
-if(!f)// NON-FLEX CONTAINER LOGIC:
+let j;// Only set flexShrink if user hasn't explicitly provided it
+if(!h)// If flex shorthand contains a shrink value, use that
+if(i)j=i.shrink;else// Apply context-based defaults
+if(!e)// NON-FLEX CONTAINER LOGIC:
 // Default flex-shrink to 0 to prevent unwanted shrinking of flex items
-k=0;else// FLEX CONTAINER LOGIC:
+j=0;else// FLEX CONTAINER LOGIC:
 // Only prevent shrinking when container is constrained (no overflow handling, no wrapping)
-if(!g){var l="column"===e.flexDirection||"column-reverse"===e.flexDirection,m="row"===e.flexDirection||"row-reverse"===e.flexDirection||!e.flexDirection;l&&!h?k=0:m&&!h&&(k=0)}// === STEP 5: RETURN RESOLVED STYLES ===
+if(!f){const a="column"===d.flexDirection||"column-reverse"===d.flexDirection,b="row"===d.flexDirection||"row-reverse"===d.flexDirection||!d.flexDirection;a&&!g?j=0:b&&!g&&(j=0)}// === STEP 5: RETURN RESOLVED STYLES ===
 // Combine all processed styles with essential defaults
-return _objectSpread({flex:d,// Preserve original flex shorthand
-flexShrink:k,// Apply computed or explicit flexShrink
+return _objectSpread({flex:c,// Preserve original flex shorthand
+flexShrink:j,// Apply computed or explicit flexShrink
 minHeight:0,// Fix flex item scrolling issues
-minWidth:0},e)});
+minWidth:0},d)});

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@meonode/ui",
   "description": "A structured approach to component composition, direct CSS-first prop styling, built-in theming, smart prop handling (including raw property pass-through), and dynamic children.",
-  "version": "0.4.7",
+  "version": "0.4.8",
   "type": "module",
   "main": "./dist/main.js",
   "types": "./dist/main.d.ts",