@meonode/ui 0.4.6 → 0.4.8

package/CHANGELOG.md

@@ -2,6 +2,63 @@
 
 All notable changes to this project will be documented in this file.
 
+## [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
+- **core/cache:** optimize navigation cache debounce timing and enhance stableKey handling ([`fff6f207`](https://github.com/l7aromeo/meonode-ui/commit/fff6f2070a06cc5ad461a2f992b111fb957fae6f))
+  - Adjust navigation cleanup debounce duration dynamically based on cache size for better performance.
+  - Change stableKey and _lastSignature to be optional to better represent their possible undefined state.
+  - Refactor _getStableKey to return undefined on server instead of empty string.
+  - Optimize critical props extraction by introducing NodeUtil.extractCriticalProps helper.
+  - Improve client-side caching logic to avoid lookups when stableKey is absent.
+  - Remove unused imports and redundant code in node.util.ts; improve shallowEqual implementation.
+  - Update createPropSignature to return undefined on server and use getElementTypeName directly.
+  - Add detailed comments and refine hashString combining FNV-1a and djb2 hashes for robustness.
+
 ## [0.4.6] - 2025-11-17
 
 ### Fixes

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}