@meonode/ui 0.4.5 → 0.4.7

package/package.json

@@ -1,21 +1,24 @@
 {
   "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.5",
+  "version": "0.4.7",
   "type": "module",
   "main": "./dist/main.js",
   "types": "./dist/main.d.ts",
   "exports": {
     ".": {
       "import": "./dist/main.js",
+      "require": "./dist/main.js",
       "types": "./dist/main.d.ts"
     },
     "./client": {
       "import": "./dist/client.js",
+      "require": "./dist/client.js",
       "types": "./dist/client.d.ts"
     },
     "./nextjs-registry": {
       "import": "./dist/nextjs-registry/index.js",
+      "require": "./dist/nextjs-registry/index.js",
       "types": "./dist/nextjs-registry/index.d.ts"
     }
   },
@@ -28,7 +31,7 @@
   "scripts": {
     "watch:build": "yarn dlx nodemon --watch src --ext ts,tsx,js,json --exec \"yarn build\"",
     "lint": "eslint --fix",
-    "test": "node --stack-size=10000 --experimental-vm-modules node_modules/jest/bin/jest.js --ci --verbose",
+    "test": "NODE_OPTIONS='--expose-gc' node --stack-size=10000 --experimental-vm-modules node_modules/jest/bin/jest.js --ci --verbose",
     "prebuild": "yarn lint && yarn test",
     "build": "yarn prebuild && rm -rf ./dist && babel src --out-dir dist --extensions \".ts,.tsx,.js\" && tsgo -p tsconfig.build.json --diagnostics && tsc-alias -p tsconfig.build.json",
     "publish:pre": "./prepublish.sh && yarn build && yarn version -i prerelease && yarn npm publish --tag next",

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

@@ -1,16 +0,0 @@
-import { BaseNode } from '../core.node.js';
-/**
- * MountTracker keeps track of which BaseNode instances are currently mounted in the DOM.
- * It listens for navigation events to trigger cleanup of unmounted nodes from the cache.
- */
-export declare class MountTracker {
-    private static _mountedNodes;
-    private static _navigationListener;
-    static trackMount(node: BaseNode<any>): void;
-    static trackUnmount(node: BaseNode<any>): void;
-    static isMounted(node: BaseNode<any>): boolean;
-    private static _ensureNavigationListener;
-    private static _onNavigation;
-    static cleanup(): void;
-}
-//# sourceMappingURL=mount-tracker.helper.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"mount-tracker.helper.d.ts","sourceRoot":"","sources":["../../src/helper/mount-tracker.helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAG5C;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAC,aAAa,CAAoB;IAChD,OAAO,CAAC,MAAM,CAAC,mBAAmB,CAA4B;IAE9D,OAAc,UAAU,CAAC,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,QAG3C;IAED,OAAc,YAAY,CAAC,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,QAE7C;IAED,OAAc,SAAS,CAAC,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,GAAG,OAAO,CAEpD;IAED,OAAO,CAAC,MAAM,CAAC,yBAAyB;IAuBxC,OAAO,CAAC,MAAM,CAAC,aAAa;IAoB5B,OAAc,OAAO,SAMpB;CACF"}

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

@@ -1,8 +0,0 @@
-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 _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 _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{BaseNode}from"../core.node.js";import{__DEV__}from"../constants/common.const.js";/**
- * MountTracker keeps track of which BaseNode instances are currently mounted in the DOM.
- * It listens for navigation events to trigger cleanup of unmounted nodes from the cache.
- */export class MountTracker{static trackMount(a){this._mountedNodes.add(a._stableKey),this._ensureNavigationListener()}static trackUnmount(a){this._mountedNodes["delete"](a._stableKey)}static isMounted(a){return this._mountedNodes.has(a._stableKey)}static _ensureNavigationListener(){var a=this;if(!(this._navigationListener||"undefined"==typeof window)){this._navigationListener=function(){return a._onNavigation()},window.addEventListener("popstate",this._navigationListener);// Override pushState/replaceState
-var b=history.pushState;history.pushState=function(){for(var a,c=arguments.length,d=Array(c),e=0;e<c;e++)d[e]=arguments[e];b.apply(this,d),null===(a=MountTracker._navigationListener)||void 0===a||a.call(MountTracker)};var c=history.replaceState;history.replaceState=function(){for(var a,b=arguments.length,d=Array(b),e=0;e<b;e++)d[e]=arguments[e];c.apply(this,d),null===(a=MountTracker._navigationListener)||void 0===a||a.call(MountTracker)}}// Single listener for all navigation events
-}static _onNavigation(){// Only clear cache for UNMOUNTED nodes
-var a,b=[],c=_createForOfIteratorHelper(BaseNode._elementCache.entries());try{for(c.s();!(a=c.n()).done;){var d=_slicedToArray(a.value,1),e=d[0];this._mountedNodes.has(e)||b.push(e)}// Clear only unmounted nodes
-}catch(a){c.e(a)}finally{c.f()}b.forEach(function(a){return BaseNode._elementCache["delete"](a)}),__DEV__&&console.log("MeoNode: Cleared ".concat(b.length," unmounted elements on navigation"))}static cleanup(){this._navigationListener&&(window.removeEventListener("popstate",this._navigationListener),this._navigationListener=null),this._mountedNodes.clear()}}_defineProperty(MountTracker,"_mountedNodes",new Set),_defineProperty(MountTracker,"_navigationListener",null);

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

@@ -1,38 +0,0 @@
-/**
- * NavigationCacheManager listens for navigation events in the browser
- * and triggers safe cleanup of the element cache to prevent memory leaks.
- * It supports standard browser navigation as well as SPA routing changes.
- *
- * Framework-agnostic: Works with Next.js, React Router, Vue Router, etc.
- */
-export declare class NavigationCacheManager {
-    private static _instance;
-    private static _originalPushState;
-    private static _originalReplaceState;
-    private static _isPatched;
-    private _isListening;
-    private _cleanupTimeout;
-    private _memoryCheckInterval;
-    private constructor();
-    static getInstance(): NavigationCacheManager;
-    /**
-     * Starts listening for navigation events to trigger cache cleanup.
-     * This method is idempotent and safe to call multiple times.
-     */
-    start(): void;
-    /**
-     * Stops listening for navigation events and restores original browser APIs.
-     * This is important for cleanup during HMR or when unmounting the library.
-     */
-    private _stop;
-    private _handleNavigation;
-    private _patchHistoryMethods;
-    private _unpatchHistoryMethods;
-    private _startMemoryMonitoring;
-    /**
-     * Setup automatic cleanup on page unload.
-     * Covers HMR, navigation away, and browser close.
-     */
-    private _setupAutoCleanup;
-}
-//# sourceMappingURL=navigation-cache-manager.helper.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"navigation-cache-manager.helper.d.ts","sourceRoot":"","sources":["../../src/helper/navigation-cache-manager.helper.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAsC;IAC9D,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAwC;IACzE,OAAO,CAAC,MAAM,CAAC,qBAAqB,CAA2C;IAC/E,OAAO,CAAC,MAAM,CAAC,UAAU,CAAQ;IAEjC,OAAO,CAAC,YAAY,CAAQ;IAC5B,OAAO,CAAC,eAAe,CAAY;IACnC,OAAO,CAAC,oBAAoB,CAAY;IAExC,OAAO,eAEN;IAED,OAAc,WAAW,IAAI,sBAAsB,CAKlD;IAED;;;OAGG;IACI,KAAK,SAoBX;IAED;;;OAGG;IACH,OAAO,CAAC,KAAK;IA0Bb,OAAO,CAAC,iBAAiB,CAWxB;IAED,OAAO,CAAC,oBAAoB;IA2B5B,OAAO,CAAC,sBAAsB;IAkB9B,OAAO,CAAC,sBAAsB;IAqB9B;;;OAGG;IACH,OAAO,CAAC,iBAAiB;CAyB1B"}

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

@@ -1,34 +0,0 @@
-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{SafeCacheManager}from"./safe-cache-manager.helper.js";import{__DEV__}from"../constants/common.const.js";import{BaseNode}from"../core.node.js";/**
- * NavigationCacheManager listens for navigation events in the browser
- * and triggers safe cleanup of the element cache to prevent memory leaks.
- * It supports standard browser navigation as well as SPA routing changes.
- *
- * Framework-agnostic: Works with Next.js, React Router, Vue Router, etc.
- */export class NavigationCacheManager{constructor(){var a=this;_defineProperty(this,"_isListening",!1),_defineProperty(this,"_cleanupTimeout",null),_defineProperty(this,"_memoryCheckInterval",null),_defineProperty(this,"_handleNavigation",function(){a._cleanupTimeout&&clearTimeout(a._cleanupTimeout),a._cleanupTimeout=setTimeout(function(){var a=SafeCacheManager.safeCleanup();__DEV__&&0<a&&console.log("[MeoNode] Navigation detected. Safely evicted ".concat(a," unmounted elements from cache."))},100)})}// Private constructor for singleton
-static getInstance(){return this._instance||(this._instance=new NavigationCacheManager),this._instance}/**
-   * Starts listening for navigation events to trigger cache cleanup.
-   * This method is idempotent and safe to call multiple times.
-   */start(){this._isListening||"undefined"==typeof window||(// Listen for standard browser navigation event
-// Patch history methods to catch SPA routing changes
-// Optional: Start memory pressure monitoring
-// Setup automatic cleanup on page unload ← ADD THIS
-this._isListening=!0,window.addEventListener("popstate",this._handleNavigation),this._patchHistoryMethods(),this._startMemoryMonitoring(),this._setupAutoCleanup(),__DEV__&&console.log("[MeoNode] NavigationCacheManager 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&&(// Restore original history methods
-window.removeEventListener("popstate",this._handleNavigation),this._unpatchHistoryMethods(),this._cleanupTimeout&&(clearTimeout(this._cleanupTimeout),this._cleanupTimeout=null),this._memoryCheckInterval&&(clearInterval(this._memoryCheckInterval),this._memoryCheckInterval=null),this._isListening=!1,__DEV__&&console.log("[MeoNode] NavigationCacheManager stopped"))}_patchHistoryMethods(){var a=this;// Guard against multiple patches (HMR safety)
-NavigationCacheManager._isPatched||(// Store original methods
-// Patch pushState
-// Patch replaceState
-NavigationCacheManager._originalPushState=history.pushState,NavigationCacheManager._originalReplaceState=history.replaceState,history.pushState=function(){for(var b=arguments.length,c=Array(b),d=0;d<b;d++)c[d]=arguments[d];NavigationCacheManager._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];NavigationCacheManager._originalReplaceState.apply(history,c),a._handleNavigation()},NavigationCacheManager._isPatched=!0,__DEV__&&console.log("[MeoNode] History methods patched for SPA navigation detection"))}_unpatchHistoryMethods(){NavigationCacheManager._isPatched&&(NavigationCacheManager._originalPushState&&(history.pushState=NavigationCacheManager._originalPushState),NavigationCacheManager._originalReplaceState&&(history.replaceState=NavigationCacheManager._originalReplaceState),NavigationCacheManager._isPatched=!1,__DEV__&&console.log("[MeoNode] History methods restored"));// Restore original methods
-}_startMemoryMonitoring(){// Only in development or if explicitly enabled
-__DEV__&&"undefined"!=typeof performance&&"memory"in performance&&(this._memoryCheckInterval=setInterval(function(){var a=performance.memory;if(a){var b=a.usedJSHeapSize/a.jsHeapSizeLimit;// Trigger emergency cleanup at 85% memory usage
-if(.85<b){var c=SafeCacheManager.emergencyCleanup();console.warn("[MeoNode] High memory usage (".concat((100*b).toFixed(1),"%). ")+"Emergency cleanup evicted ".concat(c," entries."))}}},3e4));// Check if Performance Memory API is available (Chrome/Edge only)
-}/**
-   * 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)
-// Handle visibility change (tab switching, minimize)
-// Good opportunity for lazy cleanup
-window.addEventListener("beforeunload",function(){a._stop(),BaseNode.clearCaches()}),document.addEventListener("visibilitychange",function(){document.hidden&&setTimeout(function(){document.hidden&&SafeCacheManager.safeCleanup()},5e3)}),window.__MEONODE_CLEANUP_REGISTERED=!0)}}_defineProperty(NavigationCacheManager,"_instance",null),_defineProperty(NavigationCacheManager,"_originalPushState",null),_defineProperty(NavigationCacheManager,"_originalReplaceState",null),_defineProperty(NavigationCacheManager,"_isPatched",!1);

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

@@ -1,70 +0,0 @@
-import type { CSSInterpolation } from '@emotion/serialize';
-import { BaseNode } from '../core.node.js';
-/**
- * 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.
- */
-export declare const isNodeInstance: (obj: unknown) => obj is BaseNode<any>;
-/**
- * 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 }
- */
-export declare const resolveDefaultStyle: (style: CSSInterpolation) => {};
-//# sourceMappingURL=node.helper.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"node.helper.d.ts","sourceRoot":"","sources":["../../src/helper/node.helper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAiB,MAAM,oBAAoB,CAAA;AAEzE,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAE5C;;;;;;;;;;GAUG;AACH,eAAO,MAAM,cAAc,wCAS1B,CAAA;AA8DD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AACH,eAAO,MAAM,mBAAmB,iCAmE/B,CAAA"}

package/dist/helper/node.helper.js

@@ -1,112 +0,0 @@
-var _excluded=["flex"];function ownKeys(a,b){var c=Object.keys(a);if(Object.getOwnPropertySymbols){var d=Object.getOwnPropertySymbols(a);b&&(d=d.filter(function(b){return Object.getOwnPropertyDescriptor(a,b).enumerable})),c.push.apply(c,d)}return c}function _objectSpread(a){for(var b,c=1;c<arguments.length;c++)b=null==arguments[c]?{}:arguments[c],c%2?ownKeys(Object(b),!0).forEach(function(c){_defineProperty(a,c,b[c])}):Object.getOwnPropertyDescriptors?Object.defineProperties(a,Object.getOwnPropertyDescriptors(b)):ownKeys(Object(b)).forEach(function(c){Object.defineProperty(a,c,Object.getOwnPropertyDescriptor(b,c))});return a}function _defineProperty(a,b,c){return(b=_toPropertyKey(b))in a?Object.defineProperty(a,b,{value:c,enumerable:!0,configurable:!0,writable:!0}):a[b]=c,a}function _toPropertyKey(a){var b=_toPrimitive(a,"string");return"symbol"==_typeof(b)?b:b+""}function _toPrimitive(a,b){if("object"!=_typeof(a)||!a)return a;var c=a[Symbol.toPrimitive];if(void 0!==c){var d=c.call(a,b||"default");if("object"!=_typeof(d))return d;throw new TypeError("@@toPrimitive must return a primitive value.")}return("string"===b?String:Number)(a)}function _objectWithoutProperties(a,b){if(null==a)return{};var c,d,e=_objectWithoutPropertiesLoose(a,b);if(Object.getOwnPropertySymbols){var f=Object.getOwnPropertySymbols(a);for(d=0;d<f.length;d++)c=f[d],-1===b.indexOf(c)&&{}.propertyIsEnumerable.call(a,c)&&(e[c]=a[c])}return e}function _objectWithoutPropertiesLoose(a,b){if(null==a)return{};var c={};for(var d in a)if({}.hasOwnProperty.call(a,d)){if(-1!==b.indexOf(d))continue;c[d]=a[d]}return c}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)}/**
- * 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.
- */export var isNodeInstance=function isNodeInstance(a){return"object"===_typeof(a)&&null!==a&&"element"in a&&"function"==typeof a.render&&"function"==typeof a.toPortal&&"isBaseNode"in a};/**
- * 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)
- *//**
- * 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'}
- */function 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 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 }
- */export var resolveDefaultStyle=function resolveDefaultStyle(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?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)};

package/dist/helper/safe-cache-manager.helper.d.ts

@@ -1,21 +0,0 @@
-/**
- * SafeCacheManager provides methods to clean up the element cache
- * in a way that minimizes the risk of removing elements that are still in use.
- * It uses various eviction policies to determine which entries can be safely removed.
- */
-export declare class SafeCacheManager {
-    private static _evictionPolicies;
-    /**
-     * Performs a safe cleanup of the element cache.
-     * It applies standard eviction policies to remove unmounted and old entries.
-     * This is typically called after a navigation event.
-     */
-    static safeCleanup(): number;
-    /**
-     * Performs an emergency cleanup of the element cache.
-     * This uses a more aggressive eviction policy and is intended to be called
-     * when memory pressure is detected.
-     */
-    static emergencyCleanup(): number;
-}
-//# sourceMappingURL=safe-cache-manager.helper.d.ts.map

package/dist/helper/safe-cache-manager.helper.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"safe-cache-manager.helper.d.ts","sourceRoot":"","sources":["../../src/helper/safe-cache-manager.helper.ts"],"names":[],"mappings":"AAwBA;;;;GAIG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAgD/B;IAED;;;;OAIG;IACH,OAAc,WAAW,IAAI,MAAM,CAclC;IAED;;;;OAIG;IACH,OAAc,gBAAgB,IAAI,MAAM,CAUvC;CACF"}

package/dist/helper/safe-cache-manager.helper.js

@@ -1,33 +0,0 @@
-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 _defineProperty(a,b,c){return(b=_toPropertyKey(b))in a?Object.defineProperty(a,b,{value:c,enumerable:!0,configurable:!0,writable:!0}):a[b]=c,a}function _toPropertyKey(a){var b=_toPrimitive(a,"string");return"symbol"==_typeof(b)?b:b+""}function _toPrimitive(a,b){if("object"!=_typeof(a)||!a)return a;var c=a[Symbol.toPrimitive];if(void 0!==c){var d=c.call(a,b||"default");if("object"!=_typeof(d))return d;throw new TypeError("@@toPrimitive must return a primitive value.")}return("string"===b?String:Number)(a)}function _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}import{BaseNode}from"../core.node.js";import{MountTracker}from"./mount-tracker.helper.js";// Estimates the "size" of a React element based on its props and children.
-// This is a heuristic to help with eviction decisions.
-function _estimateElementSize(a){if(!a)return 0;var b=1;if(a.props&&(b+=Object.keys(a.props).length,a.props.children)){var c,d=Array.isArray(a.props.children)?a.props.children:[a.props.children],e=_createForOfIteratorHelper(d);try{for(e.s();!(c=e.n()).done;){var f=c.value;"object"===_typeof(f)&&null!==f&&"props"in f&&(b+=_estimateElementSize(f))}}catch(a){e.e(a)}finally{e.f()}}return b}/**
- * SafeCacheManager provides methods to clean up the element cache
- * in a way that minimizes the risk of removing elements that are still in use.
- * It uses various eviction policies to determine which entries can be safely removed.
- */export class SafeCacheManager{/**
-   * Performs a safe cleanup of the element cache.
-   * It applies standard eviction policies to remove unmounted and old entries.
-   * This is typically called after a navigation event.
-   */static safeCleanup(){var a,b=[this._evictionPolicies.evictUnmounted,this._evictionPolicies.evictOldUnmounted],c=0,d=_createForOfIteratorHelper(BaseNode._elementCache.entries());try{var e=function _loop(){var d=_slicedToArray(a.value,2),e=d[0],f=d[1];// An entry is evicted if ANY policy decides it should be.
-if(b.some(function(a){return a(f)})){var g;// Trigger unmount tracking.
-null===(g=f.onEvict)||void 0===g||g.call(f),BaseNode._elementCache["delete"](e),c++}};for(d.s();!(a=d.n()).done;)e()}catch(a){d.e(a)}finally{d.f()}return c}/**
-   * Performs an emergency cleanup of the element cache.
-   * This uses a more aggressive eviction policy and is intended to be called
-   * when memory pressure is detected.
-   */static emergencyCleanup(){var a,b=0,c=_createForOfIteratorHelper(BaseNode._elementCache.entries());try{for(c.s();!(a=c.n()).done;){var d=_slicedToArray(a.value,2),e=d[0],f=d[1];if(this._evictionPolicies.emergencyEviction(f)){var g;null===(g=f.onEvict)||void 0===g||g.call(f),BaseNode._elementCache["delete"](e),b++}}}catch(a){c.e(a)}finally{c.f()}return b}}_defineProperty(SafeCacheManager,"_evictionPolicies",{/**
-     * Evicts entries that are either not mounted or whose node instance has been garbage-collected.
-     * This is the primary policy for preventing memory leaks from stale cache entries.
-     */evictUnmounted:function evictUnmounted(a){var b=a.nodeRef.deref();return!b||!MountTracker.isMounted(b)},/**
-     * Evicts unmounted entries that are older than a specified threshold (e.g., 10 minutes).
-     * This is useful for cleaning up caches during long-running sessions.
-     */evictOldUnmounted:function evictOldUnmounted(a){var b=a.nodeRef.deref();return!b||!MountTracker.isMounted(b)&&Date.now()-a.createdAt>600000;// 10 minutes
-},/**
-     * An aggressive eviction policy for high memory pressure scenarios.
-     * It preserves mounted components but otherwise evicts based on a score
-     * calculated from element size and usage frequency.
-     */emergencyEviction:function emergencyEviction(a){var b=a.nodeRef.deref();if(!b)return!0;// Evict if GC'd
-if(MountTracker.isMounted(b))return!1;// Still preserve mounted components.
-// Preferentially evict large, infrequently used components.
-var c=_estimateElementSize(a.renderedElement),d=1e3/(a.accessCount+1);// Inversely proportional to access count.
-return 1e3<c*d;// Eviction threshold.
-}});

package/dist/helper/theme.helper.d.ts

@@ -1,15 +0,0 @@
-import type { Theme } from '../types/node.type.js';
-/**
- * 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.
- */
-export declare const resolveObjWithTheme: (obj?: Record<string, any>, theme?: Theme | undefined, options?: {
-    processFunctions?: boolean | undefined;
-}) => any;
-export declare const clearThemeCache: () => void;
-//# sourceMappingURL=theme.helper.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"theme.helper.d.ts","sourceRoot":"","sources":["../../src/helper/theme.helper.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAe,MAAM,yBAAyB,CAAA;AA0GjE;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB;;SAoH/B,CAAA;AAED,eAAO,MAAM,eAAe,YAE3B,CAAA"}

package/dist/helper/theme.helper.js

@@ -1,16 +0,0 @@
-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{getValueByPath}from"./common.helper.js";import{ObjHelper}from"./obj.helper.js";var CACHE_SIZE_LIMIT=500,CACHE_EVICTION_BATCH_SIZE=50;/**
- * Cache manager for theme resolution operations.
- */class ThemeResolverCache{constructor(){_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>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>CACHE_SIZE_LIMIT&&this._evict(this._pathLookupCache)}_evict(a){for(var b,c=a.keys(),d=0;d<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()}}_defineProperty(ThemeResolverCache,"_instance",null);var themeCache=ThemeResolverCache.getInstance(),isPlainObject=function isPlainObject(a){if("object"!==_typeof(a)||null===a)return!1;var b=Object.getPrototypeOf(a);return null===b||b===Object.prototype};/**
- * 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.
- */export var resolveObjWithTheme=function resolveObjWithTheme(){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(themeCache.shouldCache()){var g=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=themeCache.getThemeRegex(),c=!1,d=a.replace(b,function(a,b){var d=themeCache.getPathLookup(f,b);return null===d&&(d=getValueByPath(f,b),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(!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],(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 themeCache.shouldCache()&&themeCache.setResolution(b,c,D),D};export var clearThemeCache=function clearThemeCache(){themeCache.clear()};