@mapples/render 1.1.0 → 1.1.2

package/README.md

@@ -126,18 +126,17 @@ The main component for rendering component trees from definitions.
 
 #### `RenderProvider`
 
-Provider component that makes registered components and assets available to the render system.
+Provider component that makes registered components available to the render system.
 
 **Props:**
 
 - `components: RegisteredComponents` - Map of registered components
-- `assets?: AnyObject` - Optional map of asset refs to values (e.g. images, fonts) for resolving `ref(type:id:name)` in component props
 - `children: ReactNode` - Child components
 
 **Example:**
 
 ```tsx
-<RenderProvider components={registeredComponents} assets={assets}>
+<RenderProvider components={registeredComponents}>
   <App />
 </RenderProvider>
 ```

package/dist/components/Render.d.ts

@@ -6,7 +6,7 @@ import { RenderProps } from '../types';
  * definition and renders it using either a custom render component or the default
  * RenderComponent implementation.
  *
- * @param {RenderProps} props - The render props
+ * @param props - The render props
  *
  * @example
  * ```tsx

package/dist/components/Render.js

@@ -7,7 +7,7 @@ import RenderComponent from './RenderComponent';
  * definition and renders it using either a custom render component or the default
  * RenderComponent implementation.
  *
- * @param {RenderProps} props - The render props
+ * @param props - The render props
  *
  * @example
  * ```tsx

package/dist/components/RenderComponent.d.ts

@@ -10,14 +10,15 @@ import { RenderComponentType } from '../types';
  * The component is memoized for performance optimization to prevent unnecessary
  * re-renders when props haven't changed.
  *
- * @param {RenderComponentType} props - The component definition
- * @param {string} props.type - The component type name (must be registered)
- * @param {AnyObject & { zIndex?: number }} props.props - Component props
- * @param {DataProps} [props.dataProps] - Optional data property bindings
- * @param {string[]} props.children - Array of child component IDs
- * @param {ChildComponents} props.childComponents - Map of child components
+ * @param props - The component definition
+ * @param props.type - The component type name (must be registered in the render context)
+ * @param props.props - Component props including optional `zIndex`
+ * @param props.dataProps - Optional data property bindings
+ * @param props.refProps - Optional map of ref property names to asset reference strings
+ * @param props.children - Array of child component IDs
+ * @param props.childComponents - Map of child components keyed by their IDs
  *
- * @returns {JSX.Element | null} The rendered component or null if component type not found
+ * @returns The rendered component, or `null` if the component type is not registered
  *
  * @example
  * ```tsx
@@ -32,8 +33,6 @@ import { RenderComponentType } from '../types';
  *
  * <RenderComponent {...componentDef} />
  * ```
- *
- * @throws {Error} If the component type is not registered in the render context
  */
 declare const RenderComponent: FC<RenderComponentType>;
 export default RenderComponent;

package/dist/components/RenderComponent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RenderComponent.d.ts","sourceRoot":"","sources":["../../src/components/RenderComponent.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAQ,MAAM,OAAO,CAAC;AAQjC,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,QAAA,MAAM,eAAe,EAAE,EAAE,CAAC,mBAAmB,CAsC5C,CAAC;AAQF,eAAe,eAAe,CAAC"}
+{"version":3,"file":"RenderComponent.d.ts","sourceRoot":"","sources":["../../src/components/RenderComponent.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAiB,MAAM,OAAO,CAAC;AAU1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,QAAA,MAAM,eAAe,EAAE,EAAE,CAAC,mBAAmB,CA+E5C,CAAC;AAQF,eAAe,eAAe,CAAC"}

package/dist/components/RenderComponent.js

@@ -1,6 +1,8 @@
-import { memo } from 'react';
-import { useDataProps } from '@mapples/state';
-import { map } from 'lodash';
+import { memo, useMemo } from 'react';
+import { useActionStore } from '@mapples/action';
+import { isThis, parseThis } from '@mapples/inlang';
+import { useDataProps, useDataState } from '@mapples/state';
+import { isPlainObject, map, mapValues } from 'lodash';
 import { useRender } from '../hooks';
 import useConditionalStyled from '../hooks/useConditionalStyled';
 import useRefProps from '../hooks/useRefProps';
@@ -14,14 +16,15 @@ import useRefProps from '../hooks/useRefProps';
  * The component is memoized for performance optimization to prevent unnecessary
  * re-renders when props haven't changed.
  *
- * @param {RenderComponentType} props - The component definition
- * @param {string} props.type - The component type name (must be registered)
- * @param {AnyObject & { zIndex?: number }} props.props - Component props
- * @param {DataProps} [props.dataProps] - Optional data property bindings
- * @param {string[]} props.children - Array of child component IDs
- * @param {ChildComponents} props.childComponents - Map of child components
+ * @param props - The component definition
+ * @param props.type - The component type name (must be registered in the render context)
+ * @param props.props - Component props including optional `zIndex`
+ * @param props.dataProps - Optional data property bindings
+ * @param props.refProps - Optional map of ref property names to asset reference strings
+ * @param props.children - Array of child component IDs
+ * @param props.childComponents - Map of child components keyed by their IDs
  *
- * @returns {JSX.Element | null} The rendered component or null if component type not found
+ * @returns The rendered component, or `null` if the component type is not registered
  *
  * @example
  * ```tsx
@@ -36,14 +39,45 @@ import useRefProps from '../hooks/useRefProps';
  *
  * <RenderComponent {...componentDef} />
  * ```
- *
- * @throws {Error} If the component type is not registered in the render context
  */
-const RenderComponent = ({ type, props, dataProps, children, refProps, childComponents, }) => {
+const RenderComponent = ({ type, props, dataProps, actionProps, children, refProps, childComponents, }) => {
     const { components } = useRender();
     const propsWithData = useDataProps(dataProps);
     const resolvedRefProps = useRefProps(refProps);
     const propsWithConditional = useConditionalStyled(props);
+    const { getValue } = useDataState();
+    const actionStore = useActionStore();
+    // Turn each `actionProps` entry into a handler that emits onto the action
+    // store. `dataProp` resolves from state (or an event arg for `"this"`);
+    // `staticData` is a literal payload merged in last so author-time config —
+    // e.g. a navigation target — survives regardless of state.
+    const mappedActionProps = useMemo(() => mapValues(actionProps, (actionProp) => {
+        return (...originalEventData) => {
+            const dataProp = actionProp?.dataProp || '';
+            let resolved;
+            if (isThis(dataProp)) {
+                const [, indexStr] = parseThis(dataProp);
+                const index = indexStr ? parseInt(indexStr) : 0;
+                resolved = originalEventData[!isNaN(index) ? index : 0];
+            }
+            else if (dataProp) {
+                resolved = getValue({ key: dataProp, active: true });
+            }
+            const data = actionProp?.staticData
+                ? {
+                    ...(isPlainObject(resolved)
+                        ? resolved
+                        : {}),
+                    ...actionProp.staticData,
+                }
+                : resolved;
+            actionStore.next({
+                time: Date.now(),
+                type: actionProp?.type,
+                payload: { originalEventData, data },
+            });
+        };
+    }), [actionProps, actionStore, getValue]);
     const Component = components[type].Component;
     if (!Component) {
         return null;
@@ -52,7 +86,7 @@ const RenderComponent = ({ type, props, dataProps, children, refProps, childComp
         const renderComponentProps = childComponents[child];
         return (<RenderComponentMemorized {...renderComponentProps} key={renderComponentProps.id}/>);
     };
-    return (<Component {...propsWithConditional} {...propsWithData} {...resolvedRefProps}>
+    return (<Component {...propsWithConditional} {...propsWithData} {...resolvedRefProps} {...mappedActionProps}>
       {map(children, renderChildren)}
     </Component>);
 };

package/dist/components/RenderComponent.js.map

@@ -1 +1 @@
-{"version":3,"file":"RenderComponent.js","sourceRoot":"","sources":["../../src/components/RenderComponent.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAM,IAAI,EAAE,MAAM,OAAO,CAAC;AAEjC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAE7B,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,oBAAoB,MAAM,+BAA+B,CAAC;AACjE,OAAO,WAAW,MAAM,sBAAsB,CAAC;AAG/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,eAAe,GAA4B,CAAC,EAChD,IAAI,EACJ,KAAK,EACL,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,eAAe,GAChB,EAAE,EAAE;IACH,MAAM,EAAE,UAAU,EAAE,GAAG,SAAS,EAAE,CAAC;IACnC,MAAM,aAAa,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;IAC9C,MAAM,gBAAgB,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC/C,MAAM,oBAAoB,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAEzD,MAAM,SAAS,GAAG,UAAU,CAAC,IAA+B,CAAC,CAAC,SAAS,CAAC;IAExE,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,cAAc,GAAG,CAAC,KAAa,EAAE,EAAE;QACvC,MAAM,oBAAoB,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;QACpD,OAAO,CACL,CAAC,wBAAwB,CACvB,IAAI,oBAAoB,CAAC,CACzB,GAAG,CAAC,CAAC,oBAAoB,CAAC,EAAE,CAAC,EAC7B,CACH,CAAC;IACJ,CAAC,CAAC;IAEF,OAAO,CACL,CAAC,SAAS,CACR,IAAI,oBAAoB,CAAC,CACzB,IAAI,aAAa,CAAC,CAClB,IAAI,gBAAgB,CAAC,CAErB;MAAA,CAAC,GAAG,CAAC,QAAQ,EAAE,cAAc,CAAC,CAChC;IAAA,EAAE,SAAS,CAAC,CACb,CAAC;AACJ,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,wBAAwB,GAAG,IAAI,CAAC,eAAe,CAAC,CAAC;AAEvD,eAAe,eAAe,CAAC"}
+{"version":3,"file":"RenderComponent.js","sourceRoot":"","sources":["../../src/components/RenderComponent.tsx"],"names":[],"mappings":"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"}

package/dist/components/RenderProvider.d.ts

@@ -7,10 +7,10 @@ import { RenderContextType } from '../types';
  * to all child components through React context. It's essential for the render
  * system to function properly as it makes components available for dynamic rendering.
  *
- * @param {PropsWithChildren<RenderContextType>} props - The component props
- * @param {RegisteredComponents} props.components - Map of registered components
- * @param {AnyObject} [props.assets] - Optional map of asset refs (ref(type:id:name)) to values
- * @param {ReactNode} props.children - Child components to render
+ * @param props - The component props
+ * @param props.components - Map of registered components available for rendering
+ * @param props.assets - Map of asset references (e.g. images, icons) resolved by `useRefProps`
+ * @param props.children - Child components to render
  *
  * @example
  * ```tsx

package/dist/components/RenderProvider.js

@@ -6,10 +6,10 @@ import { RenderContextProvider } from '../context';
  * to all child components through React context. It's essential for the render
  * system to function properly as it makes components available for dynamic rendering.
  *
- * @param {PropsWithChildren<RenderContextType>} props - The component props
- * @param {RegisteredComponents} props.components - Map of registered components
- * @param {AnyObject} [props.assets] - Optional map of asset refs (ref(type:id:name)) to values
- * @param {ReactNode} props.children - Child components to render
+ * @param props - The component props
+ * @param props.components - Map of registered components available for rendering
+ * @param props.assets - Map of asset references (e.g. images, icons) resolved by `useRefProps`
+ * @param props.children - Child components to render
  *
  * @example
  * ```tsx

package/dist/context/RenderStateContext.d.ts

@@ -1,5 +1,32 @@
 import { StateCondition } from '../types';
+/**
+ * React context for render-level state conditions.
+ *
+ * Carries a map of named {@link StateCondition} objects that drive conditional
+ * styling inside the render tree. The value is `undefined` when no state has
+ * been provided (i.e. when the component is rendered outside a
+ * {@link RenderStateContextProvider}).
+ *
+ * @example
+ * ```tsx
+ * const state = useContext(RenderStateContext);
+ * const condition = state?.['isActive'];
+ * ```
+ */
 declare const RenderStateContext: import("react").Context<Record<string, StateCondition> | undefined>;
+/**
+ * Provider component for {@link RenderStateContext}.
+ *
+ * Wrap a subtree with this provider to supply state conditions used for
+ * conditional styling and rendering.
+ *
+ * @example
+ * ```tsx
+ * <RenderStateContextProvider value={stateConditions}>
+ *   <RenderComponent {...componentDef} />
+ * </RenderStateContextProvider>
+ * ```
+ */
 export declare const RenderStateContextProvider: import("react").Provider<Record<string, StateCondition> | undefined>;
 export default RenderStateContext;
 //# sourceMappingURL=RenderStateContext.d.ts.map

package/dist/context/RenderStateContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RenderStateContext.d.ts","sourceRoot":"","sources":["../../src/context/RenderStateContext.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE1C,QAAA,MAAM,kBAAkB,qEAEZ,CAAC;AAEb,eAAO,MAAM,0BAA0B,sEAA8B,CAAC;AAEtE,eAAe,kBAAkB,CAAC"}
+{"version":3,"file":"RenderStateContext.d.ts","sourceRoot":"","sources":["../../src/context/RenderStateContext.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE1C;;;;;;;;;;;;;GAaG;AACH,QAAA,MAAM,kBAAkB,qEAEZ,CAAC;AAEb;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,0BAA0B,sEAA8B,CAAC;AAEtE,eAAe,kBAAkB,CAAC"}

package/dist/context/RenderStateContext.js

@@ -1,5 +1,32 @@
 import { createContext } from 'react';
+/**
+ * React context for render-level state conditions.
+ *
+ * Carries a map of named {@link StateCondition} objects that drive conditional
+ * styling inside the render tree. The value is `undefined` when no state has
+ * been provided (i.e. when the component is rendered outside a
+ * {@link RenderStateContextProvider}).
+ *
+ * @example
+ * ```tsx
+ * const state = useContext(RenderStateContext);
+ * const condition = state?.['isActive'];
+ * ```
+ */
 const RenderStateContext = createContext(undefined);
+/**
+ * Provider component for {@link RenderStateContext}.
+ *
+ * Wrap a subtree with this provider to supply state conditions used for
+ * conditional styling and rendering.
+ *
+ * @example
+ * ```tsx
+ * <RenderStateContextProvider value={stateConditions}>
+ *   <RenderComponent {...componentDef} />
+ * </RenderStateContextProvider>
+ * ```
+ */
 export const RenderStateContextProvider = RenderStateContext.Provider;
 export default RenderStateContext;
 //# sourceMappingURL=RenderStateContext.js.map

package/dist/context/RenderStateContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"RenderStateContext.js","sourceRoot":"","sources":["../../src/context/RenderStateContext.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAItC,MAAM,kBAAkB,GAAG,aAAa,CAEtC,SAAS,CAAC,CAAC;AAEb,MAAM,CAAC,MAAM,0BAA0B,GAAG,kBAAkB,CAAC,QAAQ,CAAC;AAEtE,eAAe,kBAAkB,CAAC"}
+{"version":3,"file":"RenderStateContext.js","sourceRoot":"","sources":["../../src/context/RenderStateContext.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAItC;;;;;;;;;;;;;GAaG;AACH,MAAM,kBAAkB,GAAG,aAAa,CAEtC,SAAS,CAAC,CAAC;AAEb;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,kBAAkB,CAAC,QAAQ,CAAC;AAEtE,eAAe,kBAAkB,CAAC"}

package/dist/hooks/useRender.d.ts

@@ -5,7 +5,7 @@
  * context data. It should be used within components that are wrapped by
  * a RenderProvider.
  *
- * @returns {RenderContextType} The render context containing registered components
+ * @returns The render context containing registered components
  *
  * @example
  * ```tsx
@@ -17,7 +17,7 @@
  * };
  * ```
  *
- * @throws {Error} If used outside of a RenderProvider context
+ * @throws If used outside of a RenderProvider context
  */
 declare const useRender: () => import("..").RenderContextType;
 export default useRender;

package/dist/hooks/useRender.js

@@ -7,7 +7,7 @@ import { RenderContext } from '../context';
  * context data. It should be used within components that are wrapped by
  * a RenderProvider.
  *
- * @returns {RenderContextType} The render context containing registered components
+ * @returns The render context containing registered components
  *
  * @example
  * ```tsx
@@ -19,7 +19,7 @@ import { RenderContext } from '../context';
  * };
  * ```
  *
- * @throws {Error} If used outside of a RenderProvider context
+ * @throws If used outside of a RenderProvider context
  */
 const useRender = () => {
     return useContext(RenderContext);

package/dist/index.d.ts

@@ -1,11 +1,3 @@
-/**
- * @packageDocumentation
- * @module @mapples/render
- *
- * Dynamic component rendering from JSON-like definitions. Register components,
- * provide optional assets, and render trees from RenderComponentType with
- * data binding and action props support.
- */
 export * from './types';
 export * from './context';
 export * from './components';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC"}

package/dist/index.js

@@ -1,11 +1,3 @@
-/**
- * @packageDocumentation
- * @module @mapples/render
- *
- * Dynamic component rendering from JSON-like definitions. Register components,
- * provide optional assets, and render trees from RenderComponentType with
- * data binding and action props support.
- */
 export * from './types';
 export * from './context';
 export * from './components';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC"}

package/dist/types/index.d.ts

@@ -14,12 +14,18 @@ export type ChildComponents = Record<string, RenderComponentType>;
  * Configuration for action properties that define component interactions.
  *
  * @interface ActionProps
- * @property {string} [type] - The type of action to perform
- * @property {string} [dataProp] - The data property key to bind to this action
+ * @property [type] - The type of action to perform
+ * @property [dataProp] - The data property key to bind to this action
+ * @property [staticData] - Literal payload merged into the emitted
+ *   `Action.payload.data` (wins over `dataProp` resolution). Use this for
+ *   configuration that is known at author time and must not be resolved from
+ *   state — e.g. a navigation target (`{ routeName }`). `dataProp` stays for
+ *   genuine state binding.
  */
 export interface ActionProps {
     type?: string;
     dataProp?: string;
+    staticData?: Record<string, unknown>;
 }
 /**
  * A map of action properties indexed by their names.
@@ -28,7 +34,7 @@ export interface ActionProps {
 export type ActionPropsMap = Partial<Record<string, ActionProps>>;
 /**
  * A map of ref properties indexed by their names.
- * Each entry has ref link in format ref(assetType:uuid:name)
+ * Each entry has a ref link in the format ref(assetType:uuid:name)
  */
 export type RefPropsMap = Partial<Record<string, string>>;
 /**
@@ -36,14 +42,15 @@ export type RefPropsMap = Partial<Record<string, string>>;
  * This is the core type used throughout the render system.
  *
  * @interface RenderComponentType
- * @property {string} id - Unique identifier for this component instance
- * @property {string} type - The component type name (must be registered in components)
- * @property {AnyObject & { zIndex?: number }} props - Component props including optional zIndex
- * @property {AnyObject} [_canvasProps] - Optional drag-and-drop configuration for canvas interactions
- * @property {string[]} children - Array of child component IDs
- * @property {ChildComponents} childComponents - Map of child components by their IDs
- * @property {DataProps} [dataProps] - Optional data property bindings
- * @property {ActionPropsMap} [actionProps] - Optional action property configurations
+ * @property id - Unique identifier for this component instance
+ * @property type - The component type name (must be registered in components)
+ * @property props - Component props including optional zIndex
+ * @property [_canvasProps] - Optional drag-and-drop configuration for canvas interactions
+ * @property children - Array of child component IDs
+ * @property childComponents - Map of child components by their IDs
+ * @property [dataProps] - Optional data property bindings
+ * @property [actionProps] - Optional action property configurations
+ * @property [refProps] - Optional map of ref property names to asset reference strings (format: `ref(assetType:uuid:name)`)
  */
 export interface RenderComponentType {
     id: string;
@@ -66,9 +73,9 @@ export interface RenderComponentType {
  * used by the state package's condition system.
  *
  * @interface StateCondition
- * @property {string} name - The name identifier for this condition
- * @property {string} condition - The condition string (e.g., "user.age::eq::18")
- * @property {string} id - Unique identifier for this condition instance
+ * @property name - The name identifier for this condition
+ * @property condition - The condition string (e.g., "user.age::eq::18")
+ * @property id - Unique identifier for this condition instance
  * @public
  */
 export interface StateCondition {
@@ -81,7 +88,7 @@ export interface StateCondition {
  * Extends ChildComponents with a special 'root' component.
  *
  * @interface RenderDom
- * @property {RenderComponentType} root - The root component of the render tree
+ * @property root - The root component of the render tree
  */
 export interface RenderDom {
     root: RenderComponentType;
@@ -91,19 +98,19 @@ export interface RenderDom {
  * Props for the main Render component.
  *
  * @type RenderProps
- * @property {RenderComponentType} root - The root component to render
- * @property {FC<RenderComponentType>} [CustomRenderComponent] - Optional custom render component to override default rendering
+ * @property root - The root component to render
+ * @property [CustomRenderComponent] - Optional custom render component to override default rendering
  */
 export type RenderProps = Pick<RenderDom, 'root' | 'state'> & {
     CustomRenderComponent?: FC<RenderComponentType>;
 };
 /**
  * Context type for the render system.
- * Provides access to registered components and assets throughout the component tree.
+ * Provides access to registered components throughout the component tree.
  *
  * @interface RenderContextType
- * @property {RegisteredComponents} components - Map of registered components available for rendering
- * @property {AnyObject} assets - Map of asset refs (e.g. ref(type:id:name)) to values for resolving in component props
+ * @property components - Map of registered components available for rendering
+ * @property assets - Map of resolved asset values keyed by their ref strings (format: `ref(assetType:uuid:name)`)
  */
 export interface RenderContextType {
     components: RegisteredComponents;

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC;AAE3B,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAEjE;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAE5C;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;AAElE;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;AAElE;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAE1D;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,SAAS,GAAG;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACvC,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,eAAe,EAAE,eAAe,CAAC;IACjC,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,WAAW,CAAC,EAAE,cAAc,CAAC;IAC7B,QAAQ,CAAC,EAAE,WAAW,CAAC;CACxB;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;;;;;GAMG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,mBAAmB,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CACxC;AAED;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG;IAC5D,qBAAqB,CAAC,EAAE,EAAE,CAAC,mBAAmB,CAAC,CAAC;CACjD,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,oBAAoB,CAAC;IACjC,MAAM,EAAE,SAAS,CAAC;CACnB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC;AAE3B,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAEjE;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAE5C;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;AAElE;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;AAElE;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAE1D;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,SAAS,GAAG;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACvC,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,eAAe,EAAE,eAAe,CAAC;IACjC,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,WAAW,CAAC,EAAE,cAAc,CAAC;IAC7B,QAAQ,CAAC,EAAE,WAAW,CAAC;CACxB;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;;;;;GAMG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,mBAAmB,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CACxC;AAED;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG;IAC5D,qBAAqB,CAAC,EAAE,EAAE,CAAC,mBAAmB,CAAC,CAAC;CACjD,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,oBAAoB,CAAC;IACjC,MAAM,EAAE,SAAS,CAAC;CACnB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mapples/render",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {