@meonode/ui 0.1.112 → 0.1.113

package/dist/core.node.d.ts

@@ -1,4 +1,4 @@
-import { type ElementType, type ReactNode } from 'react';
+import { type ElementType, type ReactNode, type ReactElement } from 'react';
 import type { FinalNodeProps, HasRequiredProps, NodeElement, NodeInstance, NodeProps, PropsOf, RawNodeProps, Theme } from './node.type.js';
 import { type Root as ReactDOMRoot } from 'react-dom/client';
 /**
@@ -94,7 +94,7 @@ export declare class BaseNode<E extends NodeElement = NodeElement> implements No
      * Recursively processes child nodes and uses `React.createElement` to construct the final React element.
      * @returns A ReactNode representing the rendered element.
      */
-    render(): ReactNode;
+    render(): ReactElement;
     private _ensurePortalInfrastructure;
     toPortal(): ReactDOMRoot | null;
 }
@@ -106,16 +106,38 @@ export declare class BaseNode<E extends NodeElement = NodeElement> implements No
  */
 export declare function Node<E extends NodeElement>(element: E, props?: NodeProps<E>): NodeInstance<E>;
 /**
- * Creates a curried node factory for a given React element type.
+ * Creates a curried node factory for a given React element or component type.
  *
- * This utility returns a function that, when called with props, produces a `BaseNode` instance.
- * It is useful for creating reusable node factories for specific components or element types.
+ * Returns a function that, when called with props, produces a `BaseNode` instance.
+ * Useful for creating reusable node factories for specific components or element types.
  * @template E The React element or component type.
+ * @template AdditionalInitialProps Additional props to merge with node props.
  * @param element The React element or component type to wrap.
+ * @param initialProps Initial props to apply to every node instance.
  * @returns A function that takes node props and returns a `NodeInstance<E>`.
  * @example
- * const ButtonNode = createNode('button');
+ * const ButtonNode = createNode('button', { type: 'button' });
  * const myButton = ButtonNode({ children: 'Click me', style: { color: 'red' } });
  */
-export declare function createNode<E extends ElementType>(element: E): HasRequiredProps<PropsOf<E>> extends true ? (props: NodeProps<E>) => NodeInstance<E> : (props?: NodeProps<E>) => NodeInstance<E>;
+export declare function createNode<AdditionalInitialProps extends Record<string, any> = Record<string, any>, E extends ElementType = ElementType>(element: E, initialProps?: NodeProps<E> & AdditionalInitialProps): HasRequiredProps<PropsOf<E>> extends true ? <AdditionalProps extends Record<string, any> = AdditionalInitialProps>(props: NodeProps<E> & AdditionalProps) => NodeInstance<E> : <AdditionalProps extends Record<string, any> = AdditionalInitialProps>(props?: NodeProps<E> & AdditionalProps) => NodeInstance<E>;
+/**
+ * Creates a node factory function where the first argument is `children` and the second is `props`.
+ *
+ * This is useful for ergonomic creation of nodes where children are the primary concern,
+ * such as for layout or container components.
+ *
+ * The returned function takes `children` as the first argument and `props` (excluding `children`) as the second.
+ * It merges any `initialProps` provided at factory creation, then creates a `BaseNode` instance.
+ *
+ * Type parameters:
+ * - `AdditionalInitialProps`: Extra props to merge with node props.
+ * - `E`: The React element or component type.
+ * @param element The React element or component type to wrap.
+ * @param initialProps Initial props to apply to every node instance (excluding `children`).
+ * @returns A function that takes `children` and `props`, returning a `NodeInstance<E>`.
+ * @example
+ * const DivNode = createChildrenFirstNode('div');
+ * const myDiv = DivNode([<span key="1" />, <span key="2" />], { className: 'container' });
+ */
+export declare function createChildrenFirstNode<AdditionalInitialProps extends Record<string, any> = Record<string, any>, E extends ElementType = ElementType>(element: E, initialProps?: Omit<NodeProps<E> & AdditionalInitialProps, 'children'>): HasRequiredProps<PropsOf<E>> extends true ? <AdditionalProps extends Record<string, any> = AdditionalInitialProps>(children: NodeElement | NodeElement[], props: Omit<NodeProps<E> & AdditionalProps, 'children'>) => NodeInstance<E> : <AdditionalProps extends Record<string, any> = AdditionalInitialProps>(children?: NodeElement | NodeElement[], props?: Omit<NodeProps<E> & AdditionalProps, 'children'>) => NodeInstance<E>;
 //# sourceMappingURL=core.node.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"core.node.d.ts","sourceRoot":"","sources":["../src/core.node.ts"],"names":[],"mappings":"AACA,OAAc,EAAgD,KAAK,WAAW,EAA4B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AACvI,OAAO,KAAK,EACV,cAAc,EAEd,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,SAAS,EACT,OAAO,EACP,YAAY,EACZ,KAAK,EACN,MAAM,mBAAmB,CAAA;AAG1B,OAAO,EAAc,KAAK,IAAI,IAAI,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAGxE;;;;;;;;GAQG;AACH,qBAAa,QAAQ,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,CAAE,YAAW,YAAY,CAAC,CAAC,CAAC;IACnF,+EAA+E;IACxE,OAAO,EAAE,CAAC,CAAA;IAEjB,kFAAkF;IAC3E,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,CAAK;IAErC,wFAAwF;IACjF,KAAK,EAAE,cAAc,CAAA;IAE5B,0CAA0C;IAC1C,SAAgB,UAAU,UAAO;IAEjC,4CAA4C;IAC5C,OAAO,CAAC,iBAAiB,CAA8B;IAEvD,+CAA+C;IAC/C,OAAO,CAAC,gBAAgB,CAA4B;IAEpD;;;;;;;;OAQG;IACH,YAAY,OAAO,EAAE,CAAC,EAAE,QAAQ,GAAE,YAAY,CAAC,CAAC,CAAM,EAuCrD;IAED,OAAO,CAAC,gBAAgB;IAYxB;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,oBAAoB,CAAC,gBAAgB,EAAE,WAAW,EAAE,WAAW,EAAE,KAAK,GAAG,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAsCnI;IAED;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,iBAAiB;IAgCzB;;;;;;;;OAQG;IACI,eAAe,CACpB,OAAO,EAAE,WAAW,EACpB,WAAW,CAAC,EAAE,KAAK,EACnB,UAAU,CAAC,EAAE,MAAM,GAClB,WAAW,CAuFb;IAED;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,eAAe,CAwBtB;IAED;;;;OAIG;IACI,MAAM,IAAI,SAAS,CAyCzB;IAED,OAAO,CAAC,2BAA2B;IAsB5B,QAAQ,IAAI,YAAY,GAAG,IAAI,CAqBrC;CACF;AAED;;;;;GAKG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS,WAAW,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAO7F;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,WAAW,EAC9C,OAAO,EAAE,CAAC,GACT,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,GAAG,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,KAAK,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,KAAK,YAAY,CAAC,CAAC,CAAC,CAElI"}
+{"version":3,"file":"core.node.d.ts","sourceRoot":"","sources":["../src/core.node.ts"],"names":[],"mappings":"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"}

package/dist/core.node.js

@@ -118,14 +118,34 @@ var i;return i=this.element===Fragment||isFragment(this.element)?{key:e}:_object
  * @param props The props for the node (optional).
  * @returns NodeInstance<E> - A new BaseNode instance.
  */export function Node(a,b){var c=_objectSpread({},b||{});return c.theme&&!c.nodetheme&&(c.nodetheme=c.theme),new BaseNode(a,c)}/**
- * Creates a curried node factory for a given React element type.
+ * Creates a curried node factory for a given React element or component type.
  *
- * This utility returns a function that, when called with props, produces a `BaseNode` instance.
- * It is useful for creating reusable node factories for specific components or element types.
+ * Returns a function that, when called with props, produces a `BaseNode` instance.
+ * Useful for creating reusable node factories for specific components or element types.
  * @template E The React element or component type.
+ * @template AdditionalInitialProps Additional props to merge with node props.
  * @param element The React element or component type to wrap.
+ * @param initialProps Initial props to apply to every node instance.
  * @returns A function that takes node props and returns a `NodeInstance<E>`.
  * @example
- * const ButtonNode = createNode('button');
+ * const ButtonNode = createNode('button', { type: 'button' });
  * const myButton = ButtonNode({ children: 'Click me', style: { color: 'red' } });
- */export function createNode(a){return function(b){return Node(a,b)}}
+ */export function createNode(a,b){return function(c){return Node(a,_objectSpread(_objectSpread({},b),c))}}/**
+ * Creates a node factory function where the first argument is `children` and the second is `props`.
+ *
+ * This is useful for ergonomic creation of nodes where children are the primary concern,
+ * such as for layout or container components.
+ *
+ * The returned function takes `children` as the first argument and `props` (excluding `children`) as the second.
+ * It merges any `initialProps` provided at factory creation, then creates a `BaseNode` instance.
+ *
+ * Type parameters:
+ * - `AdditionalInitialProps`: Extra props to merge with node props.
+ * - `E`: The React element or component type.
+ * @param element The React element or component type to wrap.
+ * @param initialProps Initial props to apply to every node instance (excluding `children`).
+ * @returns A function that takes `children` and `props`, returning a `NodeInstance<E>`.
+ * @example
+ * const DivNode = createChildrenFirstNode('div');
+ * const myDiv = DivNode([<span key="1" />, <span key="2" />], { className: 'container' });
+ */export function createChildrenFirstNode(a,b){return function(c,d){return Node(a,_objectSpread(_objectSpread(_objectSpread({},b),d),{},{children:c}))}}

package/dist/hoc/component.hoc.d.ts

@@ -1,5 +1,5 @@
 import type { ComponentNode, HasCSSCompatibleStyleProp, NodeElement, Theme } from '../node.type';
-import { type CSSProperties, type ReactNode } from 'react';
+import { type CSSProperties, type ReactElement } from 'react';
 /**
  * Props definition for components wrapped using the `Component` higher-order function.
  *
@@ -36,7 +36,7 @@ export type ComponentNodeProps<TProps> = TProps extends undefined ? Partial<{
  * Title({ children: 'Hello' })
  * ```
  */
-export declare function Component<TProps extends undefined>(component: (props: ComponentNodeProps<TProps>) => ComponentNode): (props?: ComponentNodeProps<TProps>) => ReactNode | Promise<Awaited<ReactNode>>;
+export declare function Component<TProps extends undefined>(component: (props: ComponentNodeProps<TProps>) => ComponentNode): (props?: ComponentNodeProps<TProps>) => ReactElement | Promise<Awaited<ReactElement>>;
 /**
  * Creates a component from a function that uses a defined props interface.
  * @template TProps Props interface expected by the component.
@@ -59,5 +59,5 @@ export declare function Component<TProps extends undefined>(component: (props: C
  * Button({ label: 'Click me', onClick: () => alert('clicked')})
  * ```
  */
-export declare function Component<TProps extends Record<string, any>>(component: (props: ComponentNodeProps<TProps>) => ComponentNode): (props: ComponentNodeProps<TProps>) => ReactNode | Promise<Awaited<ReactNode>>;
+export declare function Component<TProps extends Record<string, any>>(component: (props: ComponentNodeProps<TProps>) => ComponentNode): (props: ComponentNodeProps<TProps>) => ReactElement | Promise<Awaited<ReactElement>>;
 //# sourceMappingURL=component.hoc.d.ts.map

package/dist/hoc/component.hoc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"component.hoc.d.ts","sourceRoot":"","sources":["../../src/hoc/component.hoc.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,yBAAyB,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AAClG,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAE1D;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,kBAAkB,CAAC,MAAM,IAAI,MAAM,SAAS,SAAS,GAC7D,OAAO,CAAC;IACN,QAAQ,EAAE,WAAW,GAAG,WAAW,EAAE,CAAA;IACrC,KAAK,EAAE,KAAK,CAAA;CACb,CAAC,GACF,MAAM,GACJ,CAAC,yBAAyB,CAAC,MAAM,CAAC,SAAS,IAAI,GAAG,aAAa,GAAG,MAAM,CAAC,GACzE,OAAO,CAAC;IACN,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAA;IACxC,QAAQ,EAAE,WAAW,GAAG,WAAW,EAAE,CAAA;IACrC,KAAK,EAAE,KAAK,CAAA;CACb,CAAC,CAAA;AAER;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,CAAC,MAAM,SAAS,SAAS,EAChD,SAAS,EAAE,CAAC,KAAK,EAAE,kBAAkB,CAAC,MAAM,CAAC,KAAK,aAAa,GAC9D,CAAC,KAAK,CAAC,EAAE,kBAAkB,CAAC,MAAM,CAAC,KAAK,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAA;AAElF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,SAAS,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC1D,SAAS,EAAE,CAAC,KAAK,EAAE,kBAAkB,CAAC,MAAM,CAAC,KAAK,aAAa,GAC9D,CAAC,KAAK,EAAE,kBAAkB,CAAC,MAAM,CAAC,KAAK,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAA"}
+{"version":3,"file":"component.hoc.d.ts","sourceRoot":"","sources":["../../src/hoc/component.hoc.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,yBAAyB,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AAClG,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,YAAY,EAAkB,MAAM,OAAO,CAAA;AAE7E;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,kBAAkB,CAAC,MAAM,IAAI,MAAM,SAAS,SAAS,GAC7D,OAAO,CAAC;IACN,QAAQ,EAAE,WAAW,GAAG,WAAW,EAAE,CAAA;IACrC,KAAK,EAAE,KAAK,CAAA;CACb,CAAC,GACF,MAAM,GACJ,CAAC,yBAAyB,CAAC,MAAM,CAAC,SAAS,IAAI,GAAG,aAAa,GAAG,MAAM,CAAC,GACzE,OAAO,CAAC;IACN,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAA;IACxC,QAAQ,EAAE,WAAW,GAAG,WAAW,EAAE,CAAA;IACrC,KAAK,EAAE,KAAK,CAAA;CACb,CAAC,CAAA;AAER;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,CAAC,MAAM,SAAS,SAAS,EAChD,SAAS,EAAE,CAAC,KAAK,EAAE,kBAAkB,CAAC,MAAM,CAAC,KAAK,aAAa,GAC9D,CAAC,KAAK,CAAC,EAAE,kBAAkB,CAAC,MAAM,CAAC,KAAK,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAA;AAExF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,SAAS,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC1D,SAAS,EAAE,CAAC,KAAK,EAAE,kBAAkB,CAAC,MAAM,CAAC,KAAK,aAAa,GAC9D,CAAC,KAAK,EAAE,kBAAkB,CAAC,MAAM,CAAC,KAAK,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAA"}