@meonode/ui 0.4.5 → 0.4.7

package/dist/util/navigation-cache-manager.util.js

@@ -0,0 +1,19 @@
+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";import{BaseNode}from"../core.node.js";import{MountTrackerUtil}from"./mount-tracker.util.js";/**
+ * Lightweight navigation handler that clears cache on SPA navigation.
+ */export class NavigationCacheManagerUtil{constructor(){var a=this;/**
+   * Debounced navigation handler. Clears mounted element cache and props cache.
+   */_defineProperty(this,"_isListening",!1),_defineProperty(this,"_cleanupTimeout",null),_defineProperty(this,"_handleNavigation",function(){a._cleanupTimeout&&clearTimeout(a._cleanupTimeout);var b=BaseNode.elementCache.size,c=100>b?50:500>b?100:200;a._cleanupTimeout=setTimeout(function(){var a=BaseNode.propProcessingCache.size,b=0;// Only clean UNMOUNTED elements
+BaseNode.elementCache.keys().forEach(function(a){MountTrackerUtil.mountedNodes.has(a)||(BaseNode.elementCache["delete"](a),b++)}),200<a&&BaseNode.propProcessingCache.clear(),__DEBUG__&&console.log("[MeoNode] Navigation: cleared ".concat(b," unmounted elements, ").concat(a," props entries"))},c)})}static getInstance(){return this._instance||(this._instance=new NavigationCacheManagerUtil),this._instance}/**
+   * Start listening for navigation events. Idempotent.
+   */start(){this._isListening||"undefined"==typeof window||(// Setup automatic cleanup on page unload
+this._isListening=!0,window.addEventListener("popstate",this._handleNavigation),this._patchHistoryMethods(),this._setupAutoCleanup(),__DEBUG__&&console.log("[MeoNode] NavigationCacheManagerUtil started"))}/**
+   * Stops listening for navigation events and restores original browser APIs.
+   * This is important for cleanup during HMR or when unmounting the library.
+   */_stop(){this._isListening&&"undefined"!=typeof window&&(window.removeEventListener("popstate",this._handleNavigation),this._cleanupTimeout&&(clearTimeout(this._cleanupTimeout),this._cleanupTimeout=null),this._isListening=!1,__DEBUG__&&console.log("[MeoNode] NavigationCacheManagerUtil stopped"))}/**
+   * Patch history.pushState/replaceState to detect SPA navigation.
+   */_patchHistoryMethods(){var a=this;NavigationCacheManagerUtil._isPatched||(NavigationCacheManagerUtil._originalPushState=history.pushState,NavigationCacheManagerUtil._originalReplaceState=history.replaceState,history.pushState=function(){for(var b=arguments.length,c=Array(b),d=0;d<b;d++)c[d]=arguments[d];NavigationCacheManagerUtil._originalPushState.apply(history,c),a._handleNavigation()},history.replaceState=function(){for(var b=arguments.length,c=Array(b),d=0;d<b;d++)c[d]=arguments[d];NavigationCacheManagerUtil._originalReplaceState.apply(history,c),a._handleNavigation()},NavigationCacheManagerUtil._isPatched=!0)}/**
+   * Setup automatic cleanup on page unload.
+   * Covers HMR, navigation away, and browser close.
+   */_setupAutoCleanup(){var a=this;// Only set up once
+window.__MEONODE_CLEANUP_REGISTERED||(// Handle page unload (navigation away, refresh, close)
+window.addEventListener("beforeunload",function(){a._stop(),BaseNode.clearCaches()}),window.__MEONODE_CLEANUP_REGISTERED=!0)}}_defineProperty(NavigationCacheManagerUtil,"_instance",null),_defineProperty(NavigationCacheManagerUtil,"_originalPushState",null),_defineProperty(NavigationCacheManagerUtil,"_originalReplaceState",null),_defineProperty(NavigationCacheManagerUtil,"_isPatched",!1);

package/dist/util/node.util.d.ts

@@ -0,0 +1,155 @@
+import React, { type ReactNode } from 'react';
+import type { FunctionRendererProps, NodeElement, NodeElementType, NodeFunction, NodeInstance, NodeProps, DependencyList, NodePortal, FinalNodeProps } from '../types/node.type.js';
+/**
+ * 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,
+ * improving modularity and maintainability of the core library.
+ */
+export declare class NodeUtil {
+    private constructor();
+    static isServer: boolean;
+    private static _functionSignatureCache;
+    private static readonly CACHE_SIZE_LIMIT = 500;
+    private static readonly CACHE_CLEANUP_BATCH = 50;
+    private static readonly CRITICAL_PROP_PREFIXES;
+    private static readonly CRITICAL_PROPS;
+    static portalInfrastructure: WeakMap<NodeInstance, {
+        domElement: HTMLDivElement;
+        reactRoot: NodePortal & {
+            render(children: ReactNode): void;
+        };
+    }>;
+    /**
+     * Type guard to check if an object is a NodeInstance.
+     *
+     * A NodeInstance is expected to be a non-null object with:
+     * - an 'element' property,
+     * - a 'render' method,
+     * - a 'toPortal' method,
+     * - and an 'isBaseNode' property.
+     * @param obj The object to check.
+     * @returns True if the object is a NodeInstance, false otherwise.
+     */
+    static isNodeInstance: (obj: unknown) => obj is NodeInstance;
+    /**
+     * Determines if a given string `k` is a valid CSS style property.
+     * 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.
+     */
+    static isStyleProp: (k: string) => boolean;
+    /**
+     * Combines FNV-1a and djb2 hash functions for a more robust signature.
+     * @method hashString
+     */
+    static hashString(str: string): string;
+    /**
+     * Performs a shallow equality check between two objects.
+     * @method shallowEqual
+     */
+    static shallowEqual(a: Record<string, any>, b: Record<string, any>): boolean;
+    /**
+     * 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(element: NodeElementType, props: Record<string, any>): string | undefined;
+    /**
+     * 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(props: Record<string, any>, keys: string[]): Record<string, any>;
+    /**
+     * Retrieves computed CSS props from the cache with LRU tracking.
+     * Access time and hit count are tracked for smarter eviction.
+     * @method getCachedCssProps
+     */
+    static getCachedCssProps(cacheableProps: Record<string, any>, signature?: string): {
+        cssProps: Record<string, any>;
+    };
+    /**
+     * 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
+     */
+    private static _evictLRUEntries;
+    /**
+     * 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(element: NodeElementType, rawProps?: Partial<NodeProps<NodeElementType>>, stableKey?: string): FinalNodeProps;
+    /**
+     * 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.
+     */
+    private static _processChildren;
+    /**
+     * 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(prevDeps: DependencyList | undefined, newDeps: DependencyList | undefined, parentBlocked: boolean): boolean;
+    /**
+     * 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(node: NodeElement, disableEmotion?: boolean, stableKey?: string): NodeElement;
+    /**
+     * 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<E extends NodeInstance | ReactNode>(node: NodeElement): node is NodeFunction<E>;
+    /**
+     * 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<E extends ReactNode | NodeInstance>({ render, disableEmotion }: FunctionRendererProps<E>): ReactNode | null | undefined;
+    /**
+     * 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.
+     *
+     * 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({ processedElement, passedKey, disableEmotion }: {
+        processedElement: NodeElement;
+        passedKey?: string;
+        disableEmotion?: boolean;
+    }): string | number | bigint | boolean | Iterable<ReactNode> | Promise<string | number | bigint | boolean | Iterable<ReactNode> | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | React.ReactPortal | null | undefined> | React.ReactElement<any, string | React.JSXElementConstructor<any>> | null | undefined;
+    /**
+     * 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(node: NodeInstance): boolean;
+    static cleanupPortalInfra(infra: {
+        domElement: HTMLDivElement;
+        reactRoot: any;
+    }): void;
+}
+//# sourceMappingURL=node.util.d.ts.map

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

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

package/dist/util/node.util.js

@@ -0,0 +1,172 @@
+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";/**
+ * 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,
+ * improving modularity and maintainability of the core library.
+ */export class NodeUtil{constructor(){}// Determines if the current environment is server-side (Node.js) or client-side (browser).
+/**
+   * Combines FNV-1a and djb2 hash functions for a more robust signature.
+   * @method hashString
+   */static hashString(a){// FNV offset basis
+// djb2 init
+for(var b=Math.imul,c,d=2166136261,e=5381,f=0;f<a.length;f++)// 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))}/**
+   * 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}/**
+   * 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(","))}}/**
+   * 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}/**
+   * 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}}/**
+   * 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(NodeUtil.CACHE_CLEANUP_BATCH,c.length),m=0;m<l;m++)BaseNode.propProcessingCache["delete"](c[m].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.
+// 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}))}/**
+   * 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}/**
+   * 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.
+// 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.
+}/**
+   * 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(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.
+// 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(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.
+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)
+   * 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 __DEBUG__&&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.
+__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,
+// 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 __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.
+}/**
+   * 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.
+   *
+   * 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),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 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.
+}/**
+   * 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
+// Cache configuration
+// Clean up 50 entries at once when limit hit
+// Critical props for signature generation and shallow comparison
+// Portal infrastructure using WeakMap for memory-safe management
+/**
+   * Type guard to check if an object is a NodeInstance.
+   *
+   * A NodeInstance is expected to be a non-null object with:
+   * - an 'element' property,
+   * - a 'render' method,
+   * - a 'toPortal' method,
+   * - and an 'isBaseNode' property.
+   * @param obj The object to check.
+   * @returns True if the object is a NodeInstance, false otherwise.
+   *//**
+   * Determines if a given string `k` is a valid CSS style property.
+   * 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});

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

@@ -0,0 +1,108 @@
+import type { CSSInterpolation, CSSProperties } from '@emotion/serialize';
+import type { Theme } from '../types/node.type.js';
+/**
+ * Parsed flex shorthand components for CSS flex property
+ * @interface FlexComponents
+ * @property grow - The flex-grow value (how much the item should grow)
+ * @property shrink - The flex-shrink value (how much the item should shrink)
+ * @property basis - The flex-basis value (initial main size before free space is distributed)
+ */
+interface FlexComponents {
+    grow: number;
+    shrink: number;
+    basis: string | number;
+}
+export declare class ThemeUtil {
+    private constructor();
+    private static themeCache;
+    /**
+     * Parses a CSS flex shorthand property into its individual components.
+     *
+     * The CSS flex property is a shorthand for flex-grow, flex-shrink, and flex-basis.
+     * This parser handles the most common flex shorthand patterns to extract the shrink value
+     * when it's explicitly set by the user.
+     *
+     * Supported patterns:
+     * - Keywords: 'none' | 'auto' | 'initial'
+     * - Single number: '1' → {grow: 1, shrink: 1, basis: '0%'}
+     * - Full shorthand: '1 0 auto' → {grow: 1, shrink: 0, basis: 'auto'}
+     * @param flex The CSS flex property value to parse
+     * @returns FlexComponents object with parsed values, or null if unparseable
+     * @example
+     * parseFlexShorthand('none') // → {grow: 0, shrink: 0, basis: 'auto'}
+     * parseFlexShorthand('1') // → {grow: 1, shrink: 1, basis: '0%'}
+     * parseFlexShorthand('1 0 auto') // → {grow: 1, shrink: 0, basis: 'auto'}
+     */
+    static parseFlexShorthand(flex: CSSProperties['flex']): FlexComponents | null;
+    static isPlainObject: (value: any) => boolean;
+    /**
+     * Resolves theme variable references in an object's values iteratively.
+     * This function uses a manual work stack to traverse the object, which prevents
+     * "Maximum call stack size exceeded" errors for deeply nested objects.
+     * It performs a "smart merge" by using a copy-on-write strategy, creating new
+     * objects/arrays only when a value inside them has changed. This preserves
+     * 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?: {
+        processFunctions?: boolean | undefined;
+    }) => any;
+    static clearThemeCache: () => void;
+    /**
+     * Resolves default CSS styles to fix common flexbox layout issues.
+     *
+     * PRIMARY PURPOSE: Fix the flexbox scrolling problem
+     * ================================================
+     *
+     * THE PROBLEM:
+     * By default, flex items have `min-width: auto` and `min-height: auto`, which means they
+     * cannot shrink below their content size. This prevents scrollable containers from working
+     * properly when they are flex items.
+     *
+     * THE SOLUTION:
+     * 1. Set `minHeight: 0` and `minWidth: 0` to allow flex items to shrink
+     * 2. Control `flexShrink` behavior based on context to prevent unwanted shrinking
+     * 3. Respect user's explicit values to avoid overriding intentional styling
+     *
+     * FLEX SHRINK BEHAVIOR RULES:
+     * ===========================
+     *
+     * For FLEX CONTAINERS:
+     * - If overflow is NOT handled AND no wrapping → flexShrink: 0 (prevent shrinking)
+     * - If overflow is handled OR wrapping enabled → flexShrink: undefined (allow default)
+     *
+     * For NON-FLEX CONTAINERS (flex items):
+     * - Always → flexShrink: 0 (prevent unwanted shrinking)
+     *
+     * NESTED SCENARIOS:
+     * ================
+     * An element can be both a flex container AND a flex item simultaneously.
+     * This function handles this correctly by checking if the element itself is a container,
+     * not whether it's inside a flex context.
+     *
+     * EXPLICIT VALUE PRESERVATION:
+     * ===========================
+     * - If user sets `flexShrink` explicitly → never override
+     * - If user sets `flex` shorthand → extract and use the shrink value from it
+     * - Otherwise → apply smart defaults based on context
+     * @param style The input CSSProperties object to process
+     * @returns Processed CSSProperties with resolved defaults
+     * @example
+     * // Fix scrollable flex item
+     * resolveDefaultStyle({
+     *   overflow: 'auto',
+     *   height: '200px'
+     * })
+     * // → { overflow: 'auto', height: '200px', flexShrink: 0, minHeight: 0, minWidth: 0 }
+     * @example
+     * // Flex container with wrapping (allows shrinking)
+     * resolveDefaultStyle({
+     *   display: 'flex',
+     *   flexWrap: 'wrap'
+     * })
+     * // → { display: 'flex', flexWrap: 'wrap', minHeight: 0, minWidth: 0 }
+     */
+    static resolveDefaultStyle: (style: CSSInterpolation) => {};
+}
+export {};
+//# sourceMappingURL=theme.util.d.ts.map

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

@@ -0,0 +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"}

package/dist/util/theme.util.js

@@ -0,0 +1,117 @@
+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";/**
+ * 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()}}/**
+ * Parsed flex shorthand components for CSS flex property
+ * @interface FlexComponents
+ * @property grow - The flex-grow value (how much the item should grow)
+ * @property shrink - The flex-shrink value (how much the item should shrink)
+ * @property basis - The flex-basis value (initial main size before free space is distributed)
+ */_defineProperty(ThemeResolverCache,"_instance",null);export class ThemeUtil{constructor(){}/**
+   * Parses a CSS flex shorthand property into its individual components.
+   *
+   * The CSS flex property is a shorthand for flex-grow, flex-shrink, and flex-basis.
+   * This parser handles the most common flex shorthand patterns to extract the shrink value
+   * when it's explicitly set by the user.
+   *
+   * Supported patterns:
+   * - Keywords: 'none' | 'auto' | 'initial'
+   * - Single number: '1' → {grow: 1, shrink: 1, basis: '0%'}
+   * - Full shorthand: '1 0 auto' → {grow: 1, shrink: 0, basis: 'auto'}
+   * @param flex The CSS flex property value to parse
+   * @returns FlexComponents object with parsed values, or null if unparseable
+   * @example
+   * parseFlexShorthand('none') // → {grow: 0, shrink: 0, basis: 'auto'}
+   * parseFlexShorthand('1') // → {grow: 1, shrink: 1, basis: '0%'}
+   * 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
+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
+   * "Maximum call stack size exceeded" errors for deeply nested objects.
+   * It performs a "smart merge" by using a copy-on-write strategy, creating new
+   * objects/arrays only when a value inside them has changed. This preserves
+   * object references for unchanged parts of the tree, which is critical for
+   * React's reconciliation and memoization.
+   *//**
+   * Resolves default CSS styles to fix common flexbox layout issues.
+   *
+   * PRIMARY PURPOSE: Fix the flexbox scrolling problem
+   * ================================================
+   *
+   * THE PROBLEM:
+   * By default, flex items have `min-width: auto` and `min-height: auto`, which means they
+   * cannot shrink below their content size. This prevents scrollable containers from working
+   * properly when they are flex items.
+   *
+   * THE SOLUTION:
+   * 1. Set `minHeight: 0` and `minWidth: 0` to allow flex items to shrink
+   * 2. Control `flexShrink` behavior based on context to prevent unwanted shrinking
+   * 3. Respect user's explicit values to avoid overriding intentional styling
+   *
+   * FLEX SHRINK BEHAVIOR RULES:
+   * ===========================
+   *
+   * For FLEX CONTAINERS:
+   * - If overflow is NOT handled AND no wrapping → flexShrink: 0 (prevent shrinking)
+   * - If overflow is handled OR wrapping enabled → flexShrink: undefined (allow default)
+   *
+   * For NON-FLEX CONTAINERS (flex items):
+   * - Always → flexShrink: 0 (prevent unwanted shrinking)
+   *
+   * NESTED SCENARIOS:
+   * ================
+   * An element can be both a flex container AND a flex item simultaneously.
+   * This function handles this correctly by checking if the element itself is a container,
+   * not whether it's inside a flex context.
+   *
+   * EXPLICIT VALUE PRESERVATION:
+   * ===========================
+   * - If user sets `flexShrink` explicitly → never override
+   * - If user sets `flex` shorthand → extract and use the shrink value from it
+   * - Otherwise → apply smart defaults based on context
+   * @param style The input CSSProperties object to process
+   * @returns Processed CSSProperties with resolved defaults
+   * @example
+   * // Fix scrollable flex item
+   * resolveDefaultStyle({
+   *   overflow: 'auto',
+   *   height: '200px'
+   * })
+   * // → { overflow: 'auto', height: '200px', flexShrink: 0, minHeight: 0, minWidth: 0 }
+   * @example
+   * // Flex container with wrapping (allows shrinking)
+   * resolveDefaultStyle({
+   *   display: 'flex',
+   *   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 ===
+// 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 ===
+// 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)
+// === STEP 3: CHECK FOR EXPLICIT USER VALUES ===
+// 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:
+// Default flex-shrink to 0 to prevent unwanted shrinking of flex items
+k=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 ===
+// Combine all processed styles with essential defaults
+return _objectSpread({flex:d,// Preserve original flex shorthand
+flexShrink:k,// Apply computed or explicit flexShrink
+minHeight:0,// Fix flex item scrolling issues
+minWidth:0},e)});