@meonode/ui 0.4.7 → 0.4.9

package/CHANGELOG.md

@@ -2,6 +2,78 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.4.9] - 2025-11-19
+
+### Feat
+- **build**: add support for @tests alias and include tests folder in build and test configs ([`4dfd165`](https://github.com/l7aromeo/meonode-ui/commit/4dfd165fa52f93fe63ac7338344b91dfa5622c4b))
+
+### Perf
+- **core**: optimize rendering, caching, and memory management ([`4f599be`](https://github.com/l7aromeo/meonode-ui/commit/4f599be44458fef208a30849545606b060c4ec6b))
+  - Reworks the core rendering loop to use a more efficient, manually-managed work stack with exponential growth, reducing reallocations and improving performance for deep and wide node trees.
+  - Optimizes stable key generation by removing expensive shallow equality checks in favor of strict reference equality, significantly speeding up prop processing for cached components.
+  - Implements a high-performance MinHeap-based LRU cache eviction strategy for prop processing, replacing a slower sort-based method. This ensures that the most relevant props are kept in the cache with minimal overhead.
+  - Introduces CSS object hashing to accelerate prop signature generation, avoiding costly serialization of large style objects.
+  - Fixes several memory leaks by ensuring proper cleanup of node properties (lastSignature, lastPropsObj) and unregistering nodes from the cache cleanup registry upon eviction.
+  - Decouples element cache deletion from mount tracking to prevent race conditions and ensure reliable cleanup during component unmounting.
+
+### Refactor
+- **build**: rename constants directory from constants to constant and update imports accordingly ([`9531947`](https://github.com/l7aromeo/meonode-ui/commit/9531947af9b304c11c0865e8deafa1a633220753))
+
+### Test
+- **perf**: overhaul performance test suite ([`e3bd6ac`](https://github.com/l7aromeo/meonode-ui/commit/e3bd6ac6ceca474f935da644ff0c23b2f1de7692))
+  - Introduces a new, structured performance reporting system using cli-table3 for clear, grouped metrics.
+  - Refactors the entire performance test suite into logical groups: Layout Rendering, Memory Management, and Prop Processing.
+  - Adds comprehensive memory leak detection tests for heavy state changes and repeated mount/unmount cycles, using forced garbage collection for more accurate heap analysis.
+  - Extracts the large, complex CSS object into a dedicated test constant for better separation of concerns.
+  - Updates memoization tests to align with the new, weighted LRU cache eviction scoring.
+
+### Chore
+- **deps**: update dependencies including typescript-eslint to 8.47.0 and add cli-table3 0.6.5 ([`6064555`](https://github.com/l7aromeo/meonode-ui/commit/6064555f0108ed47f9b31e98c4758f7449a67ff2))
+
+## [0.4.8] - 2025-11-18
+
+### Feat
+- **client**: add generic type parameter to render function for stronger type safety ([`90a770e`](https://github.com/l7aromeo/meonode-ui/commit/90a770e))
+- **core**: improve BaseNode rendering with iterative traversal and memory optimizations ([`1d5330a`](https://github.com/l7aromeo/meonode-ui/commit/1d5330a))
+  - Introduce WorkItem interface to represent nodes in the iterative work stack during BaseNode rendering.
+  - Replace recursive render traversal with an iterative depth-first approach using a preallocated workStack array for better performance and reduced call stack usage.
+  - Implement dynamic resizing of workStack array to handle arbitrary tree sizes efficiently.
+  - Update BaseNode’s internal caching fields (`lastPropsRef` and `lastSignature`) to be public and consistently used for stable key generation.
+  - Modify MeoNodeUnmounter component to accept BaseNode instance and clear its `lastPropsRef` and `lastSignature` on unmount to prevent memory leaks.
+  - Refine type annotations across node utilities and factory functions for stronger type safety (`Record<string, unknown>` instead of `any`).
+  - Optimize critical prop extraction logic by replacing Set and startsWith checks with faster inline charCode comparisons.
+  - Clean up and clarify utility methods related to prop signature creation, shallow equality, and portal management.
+  - Improve node.util.ts by adjusting caching strategies, prop categorization, and React element handling for better robustness and maintainability.
+
+### Fixes
+- **navigation-cache-manager**: add proper typing and global window declaration for cleanup flag ([`6180d40`](https://github.com/l7aromeo/meonode-ui/commit/6180d40))
+
+### Refactor
+- improve typings and type safety in theme util and styled renderer ([`dbe1f33`](https://github.com/l7aromeo/meonode-ui/commit/dbe1f33))
+  - Added explicit TypeScript types (e.g., CssProp, Record<string, unknown>) for variables and function signatures in `styled-renderer.client.ts` and `theme.util.ts`.
+  - Updated cache maps to use more precise generic types for better type inference and safety.
+  - Enhanced `resolveObjWithTheme` and related theme resolution logic with stronger typing and nullish coalescing.
+  - Improved error handling for invalid theme path values.
+  - Applied copy-on-write pattern with properly typed arrays and objects during theme resolution.
+  - Strengthened type guards, e.g., `isPlainObject` type predicate.
+  - Minor fixes to variable declarations with explicit types for clarity and consistency.
+
+### Chore
+- **babel**: update preset-env targets and expand plugin exclusions ([`f38cd24`](https://github.com/l7aromeo/meonode-ui/commit/f38cd24))
+  - Set preset-env targets to support ES modules
+  - Enable bugfixes option
+  - Add multiple plugins to exclude list for better optimization
+  - Clean up formatting of root, alias, extensions, and exclude fields
+
+### Test
+- **performance**: add comprehensive performance tests and metrics reporting ([`c3d7a81`](https://github.com/l7aromeo/meonode-ui/commit/c3d7a81))
+  - Add detailed performance tests measuring render times for realistic layouts, 10,000 flat nodes, and 10,000 deeply nested nodes.
+  - Introduce a heavy state changes test to detect memory leaks and ensure responsiveness under frequent updates.
+  - Collect and log performance metrics including median render times and memory usage for analysis.
+  - Add tests for stableKey generation performance with identical, shallowly equal, unique, large, and complex CSS props.
+  - Enhance test suite with CSS styling for better visualization and interaction during tests.
+  - Improve cleanup and reporting to avoid resource leaks and provide clearer performance insights.
+
 ## [0.4.7] - 2025-11-17
 
 ### Fixes
@@ -771,4 +843,4 @@ All notable changes to this project will be documented in this file.
 - This changelog covers the most recent development history available
 - The project focuses on building React UIs with type-safe fluency without JSX syntax
 - Recent development has emphasized Emotion integration, type safety improvements, and enhanced flexbox support
-- For a complete history, view all commits on GitHub: [View all commits](https://github.com/l7aromeo/meonode-ui/commits)
+- For a complete history, view all commits on GitHub: [View all commits](https://github.com/l7aromeo/meonode-ui/commits)

package/dist/client.d.ts

@@ -1,9 +1,9 @@
-import type { NodeInstance } from './types/node.type.js';
+import type { NodeElementType, NodeInstance } from './types/node.type.js';
 /**
  * Renders a Meonode instance into a DOM container.
  * @param node The Meonode instance to render (e.g., created with Div(), P(), etc.).
  * @param container The DOM element to mount the content into.
  * @returns The React root instance.
  */
-export declare function render(node: NodeInstance<any>, container: Element): import("react-dom/client").Root;
+export declare function render<E extends NodeElementType>(node: NodeInstance<E>, container: Element): import("react-dom/client").Root;
 //# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAG3D;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC,GAAG,CAAC,EAAE,SAAS,EAAE,OAAO,mCAIjE"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAG5E;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,CAAC,SAAS,eAAe,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,mCAI1F"}

package/dist/client.js

@@ -3,4 +3,4 @@ import{createRoot}from"react-dom/client";/**
  * @param node The Meonode instance to render (e.g., created with Div(), P(), etc.).
  * @param container The DOM element to mount the content into.
  * @returns The React root instance.
- */export function render(a,b){var c=createRoot(b);return c.render(a.render()),c}
+ */export function render(a,b){const c=createRoot(b);return c.render(a.render()),c}