@mapples/render 1.6.0-beta.20260930095510 → 1.6.0-beta.20261001084831

package/CHANGELOG.md

@@ -1,9 +1,19 @@
 # @mapples/render
 
-## 1.6.0-beta.20260930095510
+## 1.6.0-beta.20261001084831
 
 ### Minor Changes
 
+- 35e9ba6: Creator behaviour runs in the exported app.
+  - `@mapples/app`: `MapplesApp` mounts the behaviour runtime (`MapplesRuntime`) — action bus, project variables (`vars.*`) with the `mapples:setState` handler, the API runtime (`api.*`, real requests via `fetch` with secrets from `EXPO_PUBLIC_MAPPLES_SECRET_<NAME>`, or a custom `transport`) with the `mapples:request` handler, the focused route's params, and `RouterActionHandler`, which drives expo-router with the same `toNavigationCommand` semantics as Play (navigate pushes; guard redirects, `replace` and sign-in into a guarded area reset the history). It reads `mapples/navigation.ts`, `mapples/api.ts` and `mapples/variables.ts` through `mapplesResolver` (new `mapples::navigation|api|variables` modules). CLI-generated layouts wrap screens with `mapplesScreens(...)` (`MapplesScreen`: params, on-enter action, guard + fallback, page-scoped variables; `RouteGuard` for a route entering a nested navigator) and render tab/drawer icons with `RouteIcon`. New peers: `@mapples/action`, `@mapples/navigation`, `@mapples/request`, `@mapples/state`, `rxjs`; `expo-router` is no longer optional.
+  - `@mapples/render`: `useElementBindings` / `useActionHandlers` — the one implementation of data bindings, `_visible`, asset refs and actions — shared by `RenderComponent` and the new `MapplesElement`, which `babel-plugin-mapples-sid` renders every element carrying `$data` / `$actions` / `$refs` through.
+  - `@mapples/navigation`: exports `RouteScreen` / `RouteGuard`; a screen's blur no longer wipes the params the next focused screen already published (on-enter requests reading `route.*` could stall); Play's navigators take header visibility, titles and tab/drawer labels from the shared `routeHeaderVisible` / `routeTitle` / `routeItemLabel` (a route entering a nested navigator no longer draws a second header); `entersGuardFromFallback` also counts the guards on the nested initial route chain a navigate lands on, so signing in to a route whose nested area is guarded resets the history in Play and the exported app.
+  - `@mapples/state`: `ActiveRouteState.releaseParams`.
+  - `@mapples/types`: `routeHeaderVisible`, `routeTitle`, `routeItemLabel` — the header/title/label rules the canvas frame chrome and the generated layouts share (a route entering a nested navigator draws no header of its own).
+  - `@mapples/style`: styled styles accept a `boxShadow` object `{ x, y, radius, color }` in their types, as the styler already rendered it.
+  - `@mapples/sid-ast`: a newly added attribute (a binding's `$data`) goes right after the last attribute — no double space, and the space before `/>` stays.
+  - `@mapplesorg/canvas`: frame chrome follows the shared header rule (no `Auth`/`Auth` double header); switching an action's type drops the previous type's `staticData` keys (no stale `pageUuid` on a set-variable action).
+
 - 7339399: Designed navigator chrome. A tabs navigator's `TabBarOptions.componentUuid` and a drawer's `DrawerOptions.componentUuid` name a saved component that renders the bar or the drawer content, and `TabBarOptions.native` asks the exported app for expo-router's `NativeTabs`. `@mapples/render` carries the contract (`NavigatorChromeContext`, `useNavigatorChrome`): the navigator's routes as items with a label, an active flag and an icon renderer, plus `select`, `close` and the safe-area insets. Two new `@mapples/components` elements read it — `TabBarItems` (one tab per route, pill, labels, badges' tones) and `DrawerItems` (one row per route) — and show a notice when the component is not a navigator's design yet; `@mapples/components` now peers on `@mapples/render`. `@mapples/navigation` mounts a design through `TabBarHost` / `DrawerContentHost` (React Navigation's `tabBar` / `drawerContent`, reading only their props so an exported app uses them as-is) when `MapplesNavigation` is given the `chrome` map, and keeps `visible: false` working for a custom bar. The Creator canvas draws a designed tab bar on every screen frame with its measured height as the bottom inset, a platform-styled placeholder for a native bar, frames a chrome master on the components surface at the chrome's shape with the navigator's routes flowing in, and labels storyboard sections with their design. `create_navigator_chrome` creates and assigns a starter design; `set_navigator_options` accepts the new fields.
 - a6c5872: All `@mapples/*` runtime packages now share one version and are versioned and published together from `mapplesorg/mapples-kit`; `mapples-open-kit` is a read-only mirror of the source.
 

package/dist/components/MapplesElement.d.ts

@@ -0,0 +1,37 @@
+import { ElementType } from 'react';
+import { DataProps } from '@mapples/types';
+import { ActionPropsMap, RefPropsMap } from '../types';
+/**
+ * Props of {@link MapplesElement}: the element it renders and the Creator
+ * sidecars of a synced file, as the `$data` / `$actions` / `$refs` JSX
+ * attributes carry them. Every other prop is the element's own.
+ */
+export interface MapplesElementProps {
+    /** The component the element renders (`Button`, a Creator component, …). */
+    $as: ElementType;
+    /** Data bindings per prop — the canvas node's `dataProps`. */
+    $data?: DataProps;
+    /** Actions per event — the canvas node's `actionProps`. */
+    $actions?: ActionPropsMap;
+    /** Asset references per prop — the canvas node's `refProps`. */
+    $refs?: RefPropsMap;
+    [prop: string]: unknown;
+}
+/**
+ * An element of a synced page or component file that carries Creator
+ * behaviour. `babel-plugin-mapples-sid` rewrites
+ * `<Button $data={…} $actions={…} label="Go" />` into
+ * `<MapplesElement $as={Button} $data={…} $actions={…} label="Go" />` at
+ * build time, so the file itself keeps the attributes the two-way sync reads
+ * and writes, while the running app resolves them exactly as the canvas does
+ * (`useElementBindings`): bound values over the element's own props, a falsy
+ * `_visible` hides it, each action emits onto the app's action bus.
+ *
+ * An authored action replaces a code handler for the same event — the
+ * canvas never runs the code one — and says so once, so a duplicate
+ * `onPress` (an old habit of writing `router.push` next to a navigate
+ * action) is visible rather than silently doubled.
+ */
+declare const MapplesElement: import("react").ForwardRefExoticComponent<Omit<MapplesElementProps, "ref"> & import("react").RefAttributes<unknown>>;
+export default MapplesElement;
+//# sourceMappingURL=MapplesElement.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MapplesElement.d.ts","sourceRoot":"","sources":["../../src/components/MapplesElement.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAyB,MAAM,OAAO,CAAC;AAE3D,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAG3C,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvD;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,4EAA4E;IAC5E,GAAG,EAAE,WAAW,CAAC;IACjB,8DAA8D;IAC9D,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,gEAAgE;IAChE,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CACzB;AAUD;;;;;;;;;;;;;;GAcG;AACH,QAAA,MAAM,cAAc,sHA2CnB,CAAC;AAGF,eAAe,cAAc,CAAC"}

package/dist/components/MapplesElement.js

@@ -0,0 +1,45 @@
+import { forwardRef, useEffect } from 'react';
+import { useElementBindings } from '../hooks/useElementBindings';
+/** A readable name for the wrapped component, for diagnostics. */
+const elementName = (As) => typeof As === 'string'
+    ? As
+    : (As.displayName ??
+        As.name ??
+        'element');
+/**
+ * An element of a synced page or component file that carries Creator
+ * behaviour. `babel-plugin-mapples-sid` rewrites
+ * `<Button $data={…} $actions={…} label="Go" />` into
+ * `<MapplesElement $as={Button} $data={…} $actions={…} label="Go" />` at
+ * build time, so the file itself keeps the attributes the two-way sync reads
+ * and writes, while the running app resolves them exactly as the canvas does
+ * (`useElementBindings`): bound values over the element's own props, a falsy
+ * `_visible` hides it, each action emits onto the app's action bus.
+ *
+ * An authored action replaces a code handler for the same event — the
+ * canvas never runs the code one — and says so once, so a duplicate
+ * `onPress` (an old habit of writing `router.push` next to a navigate
+ * action) is visible rather than silently doubled.
+ */
+const MapplesElement = forwardRef((elementProps, ref) => {
+    // `forwardRef` strips the named members of an index-signature props
+    // type; read them through the declared shape.
+    const { $as: As, $data, $actions, $refs, ...props } = elementProps;
+    const { hidden, dataProps, refProps, actionHandlers } = useElementBindings($data, $actions, $refs);
+    const sid = props.$sid;
+    useEffect(() => {
+        const shadowed = Object.keys($actions ?? {}).filter((event) => typeof props[event] === 'function');
+        if (shadowed.length === 0)
+            return;
+        console.warn(`[mapples] <${elementName(As)}${sid ? ` $sid="${String(sid)}"` : ''}>: the Creator action on ${shadowed.join(', ')} ` +
+            'replaces the handler written in code — remove one of them.');
+        // Once per mount: the warning is about the file, not about renders.
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, []);
+    if (hidden)
+        return null;
+    return (<As ref={ref} {...props} {...dataProps} {...refProps} {...actionHandlers}/>);
+});
+MapplesElement.displayName = 'MapplesElement';
+export default MapplesElement;
+//# sourceMappingURL=MapplesElement.js.map

package/dist/components/MapplesElement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MapplesElement.js","sourceRoot":"","sources":["../../src/components/MapplesElement.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAe,UAAU,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAI3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAoBjE,kEAAkE;AAClE,MAAM,WAAW,GAAG,CAAC,EAAe,EAAU,EAAE,CAC9C,OAAO,EAAE,KAAK,QAAQ;IACpB,CAAC,CAAC,EAAE;IACJ,CAAC,CAAC,CAAE,EAA8C,CAAC,WAAW;QAC3D,EAAwB,CAAC,IAAI;QAC9B,SAAS,CAAC,CAAC;AAEjB;;;;;;;;;;;;;;GAcG;AACH,MAAM,cAAc,GAAG,UAAU,CAC/B,CAAC,YAAY,EAAE,GAAG,EAAE,EAAE;IACpB,oEAAoE;IACpE,8CAA8C;IAC9C,MAAM,EACJ,GAAG,EAAE,EAAE,EACP,KAAK,EACL,QAAQ,EACR,KAAK,EACL,GAAG,KAAK,EACT,GAAG,YAAmC,CAAC;IACxC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc,EAAE,GAAG,kBAAkB,CACxE,KAAK,EACL,QAAQ,EACR,KAAK,CACN,CAAC;IAEF,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC;IACvB,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,MAAM,CACjD,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,CAAC,KAAK,CAAC,KAAK,UAAU,CAC9C,CAAC;QACF,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAClC,OAAO,CAAC,IAAI,CACV,cAAc,WAAW,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,UAAU,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,4BAA4B,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;YACnH,4DAA4D,CAC/D,CAAC;QACF,oEAAoE;QACpE,uDAAuD;IACzD,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,IAAI,MAAM;QAAE,OAAO,IAAI,CAAC;IAExB,OAAO,CACL,CAAC,EAAE,CACD,GAAG,CAAC,CAAC,GAAG,CAAC,CACT,IAAI,KAAK,CAAC,CACV,IAAI,SAAS,CAAC,CACd,IAAI,QAAQ,CAAC,CACb,IAAI,cAAc,CAAC,EACnB,CACH,CAAC;AACJ,CAAC,CACF,CAAC;AACF,cAAc,CAAC,WAAW,GAAG,gBAAgB,CAAC;AAE9C,eAAe,cAAc,CAAC"}

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,EAAiB,MAAM,OAAO,CAAC;AAU1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,QAAA,MAAM,eAAe,EAAE,EAAE,CAAC,mBAAmB,CA6F5C,CAAC;AAQF,eAAe,eAAe,CAAC"}
+{"version":3,"file":"RenderComponent.d.ts","sourceRoot":"","sources":["../../src/components/RenderComponent.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAQ,MAAM,OAAO,CAAC;AAOjC,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,QAAA,MAAM,eAAe,EAAE,EAAE,CAAC,mBAAmB,CA4C5C,CAAC;AAQF,eAAe,eAAe,CAAC"}

package/dist/components/RenderComponent.js

@@ -1,11 +1,8 @@
-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 { memo } from 'react';
+import { map } from 'lodash';
 import { useRender } from '../hooks';
 import useConditionalStyled from '../hooks/useConditionalStyled';
-import useRefProps from '../hooks/useRefProps';
+import { useElementBindings } from '../hooks/useElementBindings';
 /**
  * Default implementation of a renderable component.
  *
@@ -42,52 +39,8 @@ import useRefProps from '../hooks/useRefProps';
  */
 const RenderComponent = ({ type, props, dataProps, actionProps, children, refProps, childComponents, }) => {
     const { components } = useRender();
-    const propsWithData = useDataProps(dataProps);
-    const resolvedRefProps = useRefProps(refProps);
-    // Reserved binding: `dataProps._visible` conditionally shows the element.
-    // Only an ACTIVE binding participates (inactive/absent → always visible);
-    // a resolved falsy value (incl. the string 'false') hides the subtree.
-    const { _visible: visibleValue, ...visibleDataProps } = propsWithData;
-    const hidden = '_visible' in propsWithData &&
-        (visibleValue == null ||
-            visibleValue === false ||
-            visibleValue === 'false' ||
-            visibleValue === 0 ||
-            visibleValue === '');
+    const { hidden, dataProps: visibleDataProps, refProps: resolvedRefProps, actionHandlers: mappedActionProps, } = useElementBindings(dataProps, actionProps, 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 || hidden) {
         return null;

package/dist/components/RenderComponent.js.map

@@ -1 +1 @@
-{"version":3,"file":"RenderComponent.js","sourceRoot":"","sources":["../../src/components/RenderComponent.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"RenderComponent.js","sourceRoot":"","sources":["../../src/components/RenderComponent.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAM,IAAI,EAAE,MAAM,OAAO,CAAC;AAEjC,OAAO,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAE7B,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,oBAAoB,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAGjE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,eAAe,GAA4B,CAAC,EAChD,IAAI,EACJ,KAAK,EACL,SAAS,EACT,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,eAAe,GAChB,EAAE,EAAE;IACH,MAAM,EAAE,UAAU,EAAE,GAAG,SAAS,EAAE,CAAC;IACnC,MAAM,EACJ,MAAM,EACN,SAAS,EAAE,gBAAgB,EAC3B,QAAQ,EAAE,gBAAgB,EAC1B,cAAc,EAAE,iBAAiB,GAClC,GAAG,kBAAkB,CAAC,SAAS,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;IACzD,MAAM,oBAAoB,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAEzD,MAAM,SAAS,GAAG,UAAU,CAAC,IAA+B,CAAC,CAAC,SAAS,CAAC;IAExE,IAAI,CAAC,SAAS,IAAI,MAAM,EAAE,CAAC;QACzB,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,gBAAgB,CAAC,CACrB,IAAI,gBAAgB,CAAC,CACrB,IAAI,iBAAiB,CAAC,CAEtB;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"}

package/dist/components/index.d.ts

@@ -1,4 +1,6 @@
 export { default as Render } from './Render';
 export { default as RenderComponent } from './RenderComponent';
 export { default as RenderProvider } from './RenderProvider';
+export { default as MapplesElement } from './MapplesElement';
+export type { MapplesElementProps } from './MapplesElement';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC7D,YAAY,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/components/index.js

@@ -1,4 +1,5 @@
 export { default as Render } from './Render';
 export { default as RenderComponent } from './RenderComponent';
 export { default as RenderProvider } from './RenderProvider';
+export { default as MapplesElement } from './MapplesElement';
 //# sourceMappingURL=index.js.map

package/dist/components/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/hooks/index.d.ts

@@ -2,4 +2,6 @@ export { default as useRender } from './useRender';
 export { default as useConditionalStyled } from './useConditionalStyled';
 export { default as useNavigatorChrome } from './useNavigatorChrome';
 export * from './useNavigatorChrome';
+export { default as useElementBindings, useActionHandlers, } from './useElementBindings';
+export type { ElementBindings } from './useElementBindings';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACrE,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACrE,cAAc,sBAAsB,CAAC;AACrC,OAAO,EACL,OAAO,IAAI,kBAAkB,EAC7B,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/hooks/index.js

@@ -2,4 +2,5 @@ export { default as useRender } from './useRender';
 export { default as useConditionalStyled } from './useConditionalStyled';
 export { default as useNavigatorChrome } from './useNavigatorChrome';
 export * from './useNavigatorChrome';
+export { default as useElementBindings, useActionHandlers, } from './useElementBindings';
 //# sourceMappingURL=index.js.map

package/dist/hooks/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACrE,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACrE,cAAc,sBAAsB,CAAC;AACrC,OAAO,EACL,OAAO,IAAI,kBAAkB,EAC7B,iBAAiB,GAClB,MAAM,sBAAsB,CAAC"}

package/dist/hooks/useElementBindings.d.ts

@@ -0,0 +1,34 @@
+import { DataProps } from '@mapples/types';
+import { ActionPropsMap, AnyObject, RefPropsMap } from '../types';
+/**
+ * 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.
+ */
+export declare const useActionHandlers: (actionProps: ActionPropsMap | undefined) => Record<string, (...originalEventData: unknown[]) => void>;
+/** What an element's bindings resolve to. */
+export interface ElementBindings {
+    /**
+     * The reserved `_visible` binding resolved to a falsy value: the element
+     * (and its subtree) does not render.
+     */
+    hidden: boolean;
+    /** Resolved data props (without `_visible`), to spread over the element's own props. */
+    dataProps: AnyObject;
+    /** Resolved `ref(…)` asset props. */
+    refProps: AnyObject;
+    /** One emitting handler per authored action. */
+    actionHandlers: Record<string, (...originalEventData: unknown[]) => void>;
+}
+/**
+ * Resolve an element's Creator bindings — data bindings (`dataProps`, with
+ * the reserved `_visible`), asset references (`refProps`) and actions
+ * (`actionProps`) — against the surrounding state, render and action
+ * contexts. The single implementation behind the canvas render pipeline
+ * (`RenderComponent`) and the exported app's `MapplesElement`, so a binding
+ * behaves the same on the canvas, in Play and in the built app.
+ */
+export declare const useElementBindings: (dataProps: DataProps | undefined, actionProps: ActionPropsMap | undefined, refProps: RefPropsMap | undefined) => ElementBindings;
+export default useElementBindings;
+//# sourceMappingURL=useElementBindings.d.ts.map

package/dist/hooks/useElementBindings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useElementBindings.d.ts","sourceRoot":"","sources":["../../src/hooks/useElementBindings.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAG3C,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAIlE;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAC5B,aAAa,cAAc,GAAG,SAAS,KACtC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,iBAAiB,EAAE,OAAO,EAAE,KAAK,IAAI,CAoC1D,CAAC;AAEF,6CAA6C;AAC7C,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,MAAM,EAAE,OAAO,CAAC;IAChB,wFAAwF;IACxF,SAAS,EAAE,SAAS,CAAC;IACrB,qCAAqC;IACrC,QAAQ,EAAE,SAAS,CAAC;IACpB,gDAAgD;IAChD,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,iBAAiB,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC,CAAC;CAC3E;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,GAC7B,WAAW,SAAS,GAAG,SAAS,EAChC,aAAa,cAAc,GAAG,SAAS,EACvC,UAAU,WAAW,GAAG,SAAS,KAChC,eAyBF,CAAC;AAEF,eAAe,kBAAkB,CAAC"}

package/dist/hooks/useElementBindings.js

@@ -0,0 +1,74 @@
+import { useMemo } from 'react';
+import { useActionStore } from '@mapples/action';
+import { isThis, parseThis } from '@mapples/inlang';
+import { useDataProps, useDataState } from '@mapples/state';
+import { isPlainObject, mapValues } from 'lodash';
+import useRefProps from './useRefProps';
+/**
+ * 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.
+ */
+export const useActionHandlers = (actionProps) => {
+    const { getValue } = useDataState();
+    const actionStore = useActionStore();
+    return 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]);
+};
+/**
+ * Resolve an element's Creator bindings — data bindings (`dataProps`, with
+ * the reserved `_visible`), asset references (`refProps`) and actions
+ * (`actionProps`) — against the surrounding state, render and action
+ * contexts. The single implementation behind the canvas render pipeline
+ * (`RenderComponent`) and the exported app's `MapplesElement`, so a binding
+ * behaves the same on the canvas, in Play and in the built app.
+ */
+export const useElementBindings = (dataProps, actionProps, refProps) => {
+    const propsWithData = useDataProps(dataProps);
+    const resolvedRefProps = useRefProps(refProps);
+    const actionHandlers = useActionHandlers(actionProps);
+    // Reserved binding: `dataProps._visible` conditionally shows the element.
+    // Only an ACTIVE binding participates (inactive/absent → always visible);
+    // a resolved falsy value (incl. the string 'false') hides the subtree.
+    const { _visible: visibleValue, ...visibleDataProps } = propsWithData;
+    const hidden = '_visible' in propsWithData &&
+        (visibleValue == null ||
+            visibleValue === false ||
+            visibleValue === 'false' ||
+            visibleValue === 0 ||
+            visibleValue === '');
+    return {
+        hidden,
+        dataProps: visibleDataProps,
+        refProps: resolvedRefProps,
+        actionHandlers,
+    };
+};
+export default useElementBindings;
+//# sourceMappingURL=useElementBindings.js.map

package/dist/hooks/useElementBindings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useElementBindings.js","sourceRoot":"","sources":["../../src/hooks/useElementBindings.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mapples/render",
-  "version": "1.6.0-beta.20260930095510",
+  "version": "1.6.0-beta.20261001084831",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {