@pushframe/sdk 0.1.5 → 0.1.8

package/lib/module/primitives/Switch.js

@@ -0,0 +1,23 @@
+"use strict";
+
+import React from 'react';
+import { Switch as RNSwitch } from 'react-native';
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Thin wrapper over React Native Switch.
+ * Maps Pushframe schema trigger to RN event prop:
+ *   onChange → onValueChange
+ * Strips `if`, `actions`, `onChange` before forwarding to RN.
+ */
+export function Switch({
+  if: _if,
+  actions: _actions,
+  onChange,
+  ...rest
+}) {
+  return /*#__PURE__*/_jsx(RNSwitch, {
+    onValueChange: onChange,
+    ...rest
+  });
+}
+//# sourceMappingURL=Switch.js.map

package/lib/module/primitives/Switch.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["React","Switch","RNSwitch","jsx","_jsx","if","_if","actions","_actions","onChange","rest","onValueChange"],"sourceRoot":"../../../src","sources":["primitives/Switch.tsx"],"mappings":";;AAAA,OAAOA,KAAK,MAAM,OAAO;AACzB,SAASC,MAAM,IAAIC,QAAQ,QAAQ,cAAc;AAAC,SAAAC,GAAA,IAAAC,IAAA;AAclD;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASH,MAAMA,CAAC;EAAEI,EAAE,EAAEC,GAAG;EAAEC,OAAO,EAAEC,QAAQ;EAAEC,QAAQ;EAAE,GAAGC;AAA2B,CAAC,EAAE;EAC9F,oBAAON,IAAA,CAACF,QAAQ;IAACS,aAAa,EAAEF,QAAS;IAAA,GAAKC;EAAI,CAAG,CAAC;AACxD","ignoreList":[]}

package/lib/module/primitives/Text.js

@@ -0,0 +1,32 @@
+"use strict";
+
+import React from 'react';
+import { Text as RNText } from 'react-native';
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Thin wrapper over React Native Text.
+ * Strips `if`, `actions`, `content` before forwarding to RN.
+ * Display priority: value > content > children (children remain in rest).
+ */
+export function Text({
+  if: _if,
+  actions: _actions,
+  value,
+  content,
+  ...rest
+}) {
+  // When value or content is provided it takes precedence over JSX children
+  // (which are part of rest via RNTextProps inheritance).
+  const textContent = value !== undefined ? value : content;
+  if (textContent !== undefined) {
+    return /*#__PURE__*/_jsx(RNText, {
+      ...rest,
+      children: textContent
+    });
+  }
+  // No explicit text content — forward rest as-is (includes any children prop)
+  return /*#__PURE__*/_jsx(RNText, {
+    ...rest
+  });
+}
+//# sourceMappingURL=Text.js.map

package/lib/module/primitives/Text.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["React","Text","RNText","jsx","_jsx","if","_if","actions","_actions","value","content","rest","textContent","undefined","children"],"sourceRoot":"../../../src","sources":["primitives/Text.tsx"],"mappings":";;AAAA,OAAOA,KAAK,MAAM,OAAO;AACzB,SAASC,IAAI,IAAIC,MAAM,QAAQ,cAAc;AAAC,SAAAC,GAAA,IAAAC,IAAA;AAqB9C;AACA;AACA;AACA;AACA;AACA,OAAO,SAASH,IAAIA,CAAC;EACnBI,EAAE,EAAEC,GAAG;EACPC,OAAO,EAAEC,QAAQ;EACjBC,KAAK;EACLC,OAAO;EACP,GAAGC;AACe,CAAC,EAAE;EACrB;EACA;EACA,MAAMC,WAAW,GAAGH,KAAK,KAAKI,SAAS,GAAGJ,KAAK,GAAGC,OAAO;EACzD,IAAIE,WAAW,KAAKC,SAAS,EAAE;IAC7B,oBAAOT,IAAA,CAACF,MAAM;MAAA,GAAKS,IAAI;MAAAG,QAAA,EAAGF;IAAW,CAAS,CAAC;EACjD;EACA;EACA,oBAAOR,IAAA,CAACF,MAAM;IAAA,GAAKS;EAAI,CAAG,CAAC;AAC7B","ignoreList":[]}

package/lib/module/primitives/TextInput.js

@@ -0,0 +1,26 @@
+"use strict";
+
+import React from 'react';
+import { TextInput as RNTextInput } from 'react-native';
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Thin wrapper over React Native TextInput.
+ * Maps Pushframe schema triggers to RN event props:
+ *   onChange → onChangeText
+ *   onSubmit → onSubmitEditing
+ * Strips `if`, `actions`, `onChange`, `onSubmit` before forwarding to RN.
+ */
+export function TextInput({
+  if: _if,
+  actions: _actions,
+  onChange,
+  onSubmit,
+  ...rest
+}) {
+  return /*#__PURE__*/_jsx(RNTextInput, {
+    onChangeText: onChange,
+    onSubmitEditing: onSubmit ? () => onSubmit() : undefined,
+    ...rest
+  });
+}
+//# sourceMappingURL=TextInput.js.map

package/lib/module/primitives/TextInput.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["React","TextInput","RNTextInput","jsx","_jsx","if","_if","actions","_actions","onChange","onSubmit","rest","onChangeText","onSubmitEditing","undefined"],"sourceRoot":"../../../src","sources":["primitives/TextInput.tsx"],"mappings":";;AAAA,OAAOA,KAAK,MAAM,OAAO;AACzB,SAASC,SAAS,IAAIC,WAAW,QAAQ,cAAc;AAAC,SAAAC,GAAA,IAAAC,IAAA;AAmBxD;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASH,SAASA,CAAC;EACxBI,EAAE,EAAEC,GAAG;EACPC,OAAO,EAAEC,QAAQ;EACjBC,QAAQ;EACRC,QAAQ;EACR,GAAGC;AACoB,CAAC,EAAE;EAC1B,oBACEP,IAAA,CAACF,WAAW;IACVU,YAAY,EAAEH,QAAS;IACvBI,eAAe,EAAEH,QAAQ,GAAG,MAAMA,QAAQ,CAAC,CAAC,GAAGI,SAAU;IAAA,GACrDH;EAAI,CACT,CAAC;AAEN","ignoreList":[]}

package/lib/module/primitives/View.js

@@ -0,0 +1,19 @@
+"use strict";
+
+import React from 'react';
+import { View as RNView } from 'react-native';
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Thin wrapper over React Native View.
+ * Strips `if`, `actions` before forwarding to RN.
+ */
+export function View({
+  if: _if,
+  actions: _actions,
+  ...rest
+}) {
+  return /*#__PURE__*/_jsx(RNView, {
+    ...rest
+  });
+}
+//# sourceMappingURL=View.js.map

package/lib/module/primitives/View.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["React","View","RNView","jsx","_jsx","if","_if","actions","_actions","rest"],"sourceRoot":"../../../src","sources":["primitives/View.tsx"],"mappings":";;AAAA,OAAOA,KAAK,MAAM,OAAO;AACzB,SAASC,IAAI,IAAIC,MAAM,QAAQ,cAAc;AAAC,SAAAC,GAAA,IAAAC,IAAA;AAS9C;AACA;AACA;AACA;AACA,OAAO,SAASH,IAAIA,CAAC;EAAEI,EAAE,EAAEC,GAAG;EAAEC,OAAO,EAAEC,QAAQ;EAAE,GAAGC;AAAyB,CAAC,EAAE;EAChF,oBAAOL,IAAA,CAACF,MAAM;IAAA,GAAKO;EAAI,CAAG,CAAC;AAC7B","ignoreList":[]}

package/lib/module/primitives/index.js

@@ -0,0 +1,16 @@
+"use strict";
+
+export { Text } from './Text';
+export { View } from './View';
+export { ScrollView } from './ScrollView';
+export { Image } from './Image';
+export { Pressable } from './Pressable';
+export { TextInput } from './TextInput';
+export { FlatList } from './FlatList';
+export { Modal } from './Modal';
+export { ActivityIndicator } from './ActivityIndicator';
+export { Switch } from './Switch';
+export { KeyboardAvoidingView } from './KeyboardAvoidingView';
+export { SafeAreaView } from './SafeAreaView';
+export { StatusBar } from './StatusBar';
+//# sourceMappingURL=index.js.map

package/lib/module/primitives/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Text","View","ScrollView","Image","Pressable","TextInput","FlatList","Modal","ActivityIndicator","Switch","KeyboardAvoidingView","SafeAreaView","StatusBar"],"sourceRoot":"../../../src","sources":["primitives/index.ts"],"mappings":";;AAAA,SAASA,IAAI,QAAQ,QAAQ;AAG7B,SAASC,IAAI,QAAQ,QAAQ;AAG7B,SAASC,UAAU,QAAQ,cAAc;AAGzC,SAASC,KAAK,QAAQ,SAAS;AAG/B,SAASC,SAAS,QAAQ,aAAa;AAGvC,SAASC,SAAS,QAAQ,aAAa;AAGvC,SAASC,QAAQ,QAAQ,YAAY;AAGrC,SAASC,KAAK,QAAQ,SAAS;AAG/B,SAASC,iBAAiB,QAAQ,qBAAqB;AAGvD,SAASC,MAAM,QAAQ,UAAU;AAGjC,SAASC,oBAAoB,QAAQ,wBAAwB;AAG7D,SAASC,YAAY,QAAQ,gBAAgB;AAG7C,SAASC,SAAS,QAAQ,aAAa","ignoreList":[]}

package/lib/module/registry/ComponentRegistry.js

@@ -0,0 +1,66 @@
+"use strict";
+
+import { Text } from '../primitives/Text';
+import { View } from '../primitives/View';
+import { ScrollView } from '../primitives/ScrollView';
+import { Image } from '../primitives/Image';
+import { Pressable } from '../primitives/Pressable';
+import { TextInput } from '../primitives/TextInput';
+import { FlatList } from '../primitives/FlatList';
+import { Modal } from '../primitives/Modal';
+import { ActivityIndicator } from '../primitives/ActivityIndicator';
+import { Switch } from '../primitives/Switch';
+import { KeyboardAvoidingView } from '../primitives/KeyboardAvoidingView';
+import { SafeAreaView } from '../primitives/SafeAreaView';
+import { StatusBar } from '../primitives/StatusBar';
+
+// ---------------------------------------------------------------------------
+// Built-in type → component mappings (cannot be overridden)
+// ---------------------------------------------------------------------------
+
+const BUILT_IN_TYPES = new Set(['text', 'view', 'scrollview', 'image', 'pressable', 'textinput', 'flatlist', 'modal', 'activityindicator', 'switch', 'keyboardavoidingview', 'safeareaview', 'statusbar']);
+const BUILT_IN_COMPONENTS = new Map([['text', Text], ['view', View], ['scrollview', ScrollView], ['image', Image], ['pressable', Pressable], ['textinput', TextInput], ['flatlist', FlatList], ['modal', Modal], ['activityindicator', ActivityIndicator], ['switch', Switch], ['keyboardavoidingview', KeyboardAvoidingView], ['safeareaview', SafeAreaView], ['statusbar', StatusBar]]);
+
+// ---------------------------------------------------------------------------
+// ComponentRegistry
+// ---------------------------------------------------------------------------
+
+/**
+ * Maps component type strings to React components.
+ *
+ * Built-ins are always present and cannot be overridden.
+ * Developer-registered components are merged on top for non-conflicting types.
+ */
+export class ComponentRegistry {
+  constructor(developerComponents) {
+    // Start with built-ins
+    this.components = new Map(BUILT_IN_COMPONENTS);
+
+    // Merge developer components, skipping any that conflict with built-ins
+    if (developerComponents) {
+      for (const [type, component] of Object.entries(developerComponents)) {
+        if (BUILT_IN_TYPES.has(type)) {
+          console.warn(`[PushFrame] ComponentRegistry: "${type}" is a built-in type and cannot be overridden. ` + `Registration skipped.`);
+          continue;
+        }
+        this.components.set(type, component);
+      }
+    }
+  }
+
+  /**
+   * Resolve a type string to its React component.
+   * Returns null if no component is registered for the type.
+   */
+  resolve(type) {
+    return this.components.get(type) ?? null;
+  }
+
+  /**
+   * Returns all registered type strings (useful for debugging).
+   */
+  types() {
+    return Array.from(this.components.keys());
+  }
+}
+//# sourceMappingURL=ComponentRegistry.js.map

package/lib/module/registry/ComponentRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Text","View","ScrollView","Image","Pressable","TextInput","FlatList","Modal","ActivityIndicator","Switch","KeyboardAvoidingView","SafeAreaView","StatusBar","BUILT_IN_TYPES","Set","BUILT_IN_COMPONENTS","Map","ComponentRegistry","constructor","developerComponents","components","type","component","Object","entries","has","console","warn","set","resolve","get","types","Array","from","keys"],"sourceRoot":"../../../src","sources":["registry/ComponentRegistry.ts"],"mappings":";;AACA,SAASA,IAAI,QAAQ,oBAAoB;AACzC,SAASC,IAAI,QAAQ,oBAAoB;AACzC,SAASC,UAAU,QAAQ,0BAA0B;AACrD,SAASC,KAAK,QAAQ,qBAAqB;AAC3C,SAASC,SAAS,QAAQ,yBAAyB;AACnD,SAASC,SAAS,QAAQ,yBAAyB;AACnD,SAASC,QAAQ,QAAQ,wBAAwB;AACjD,SAASC,KAAK,QAAQ,qBAAqB;AAC3C,SAASC,iBAAiB,QAAQ,iCAAiC;AACnE,SAASC,MAAM,QAAQ,sBAAsB;AAC7C,SAASC,oBAAoB,QAAQ,oCAAoC;AACzE,SAASC,YAAY,QAAQ,4BAA4B;AACzD,SAASC,SAAS,QAAQ,yBAAyB;;AAEnD;AACA;AACA;;AAEA,MAAMC,cAAmC,GAAG,IAAIC,GAAG,CAAC,CAClD,MAAM,EACN,MAAM,EACN,YAAY,EACZ,OAAO,EACP,WAAW,EACX,WAAW,EACX,UAAU,EACV,OAAO,EACP,mBAAmB,EACnB,QAAQ,EACR,sBAAsB,EACtB,cAAc,EACd,WAAW,CACZ,CAAC;AAEF,MAAMC,mBAAsF,GAC1F,IAAIC,GAAG,CAAC,CACN,CAAC,MAAM,EAAEhB,IAAI,CAAiD,EAC9D,CAAC,MAAM,EAAEC,IAAI,CAAiD,EAC9D,CAAC,YAAY,EAAEC,UAAU,CAAiD,EAC1E,CAAC,OAAO,EAAEC,KAAK,CAAiD,EAChE,CAAC,WAAW,EAAEC,SAAS,CAAiD,EACxE,CAAC,WAAW,EAAEC,SAAS,CAAiD,EACxE,CAAC,UAAU,EAAEC,QAAQ,CAA4D,EACjF,CAAC,OAAO,EAAEC,KAAK,CAAiD,EAChE,CAAC,mBAAmB,EAAEC,iBAAiB,CAAiD,EACxF,CAAC,QAAQ,EAAEC,MAAM,CAAiD,EAClE,CAAC,sBAAsB,EAAEC,oBAAoB,CAAiD,EAC9F,CAAC,cAAc,EAAEC,YAAY,CAAiD,EAC9E,CAAC,WAAW,EAAEC,SAAS,CAAiD,CACzE,CAAC;;AAEJ;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMK,iBAAiB,CAAC;EAG7BC,WAAWA,CAACC,mBAAkE,EAAE;IAC9E;IACA,IAAI,CAACC,UAAU,GAAG,IAAIJ,GAAG,CAACD,mBAAmB,CAAC;;IAE9C;IACA,IAAII,mBAAmB,EAAE;MACvB,KAAK,MAAM,CAACE,IAAI,EAAEC,SAAS,CAAC,IAAIC,MAAM,CAACC,OAAO,CAACL,mBAAmB,CAAC,EAAE;QACnE,IAAIN,cAAc,CAACY,GAAG,CAACJ,IAAI,CAAC,EAAE;UAC5BK,OAAO,CAACC,IAAI,CACV,mCAAmCN,IAAI,iDAAiD,GACtF,uBACJ,CAAC;UACD;QACF;QACA,IAAI,CAACD,UAAU,CAACQ,GAAG,CAACP,IAAI,EAAEC,SAAyD,CAAC;MACtF;IACF;EACF;;EAEA;AACF;AACA;AACA;EACEO,OAAOA,CAACR,IAAY,EAAuD;IACzE,OAAO,IAAI,CAACD,UAAU,CAACU,GAAG,CAACT,IAAI,CAAC,IAAI,IAAI;EAC1C;;EAEA;AACF;AACA;EACEU,KAAKA,CAAA,EAAa;IAChB,OAAOC,KAAK,CAACC,IAAI,CAAC,IAAI,CAACb,UAAU,CAACc,IAAI,CAAC,CAAC,CAAC;EAC3C;AACF","ignoreList":[]}

package/lib/module/registry.js

@@ -0,0 +1,88 @@
+"use strict";
+
+/**
+ * Props passed to every Pushframe component.
+ *
+ * `props`        — fully-resolved (all $bind references substituted) props map.
+ * `children`     — pre-rendered child nodes (if any).
+ * `onAction`     — callback for emitting an action event back to the host app.
+ * `rawChildren`  — raw schema child nodes, available for data-driven components
+ *                  (e.g. FlatList) that need to render the same template
+ *                  multiple times with different context.
+ * `renderChild`  — render a schema node with an optional context override that
+ *                  gets merged into the parent context. Use this together with
+ *                  `rawChildren` to implement per-item rendering.
+ */
+
+/**
+ * ComponentRegistry maps a component type string (e.g. "stack") to its
+ * React component implementation.
+ *
+ * Use `createRegistry()` to construct one, then call `register()` to add
+ * custom components on top.
+ */
+export class ComponentRegistry {
+  components = new Map();
+
+  /**
+   * Register a component under the given type string.
+   * Calling register() with an existing type overwrites the previous entry,
+   * allowing host apps to override built-ins.
+   */
+  register(type, component) {
+    this.components.set(type, component);
+    return this;
+  }
+
+  /**
+   * Look up a component by type string.
+   * Returns undefined if no component is registered for that type.
+   */
+  get(type) {
+    return this.components.get(type);
+  }
+
+  /**
+   * Returns true if the registry contains an entry for the given type.
+   */
+  has(type) {
+    return this.components.has(type);
+  }
+
+  /**
+   * Returns all registered type strings (useful for debugging).
+   */
+  types() {
+    return Array.from(this.components.keys());
+  }
+}
+
+/**
+ * Build the default registry pre-loaded with all built-in components.
+ */
+export function createDefaultRegistry() {
+  // Lazy-import to keep tree-shaking effective when consumers only need
+  // a subset of built-ins.
+  const {
+    StackComponent
+  } = require('./components/StackComponent');
+  const {
+    TextComponent
+  } = require('./components/TextComponent');
+  const {
+    ButtonComponent
+  } = require('./components/ButtonComponent');
+  const {
+    ImageComponent
+  } = require('./components/ImageComponent');
+  const {
+    ScrollViewComponent
+  } = require('./components/ScrollViewComponent');
+  const {
+    FlatListComponent
+  } = require('./components/FlatListComponent');
+  return new ComponentRegistry().register('stack', StackComponent)
+  // 'screen' is a common server-side root container alias for stack
+  .register('screen', StackComponent).register('text', TextComponent).register('button', ButtonComponent).register('image', ImageComponent).register('scrollview', ScrollViewComponent).register('flatlist', FlatListComponent);
+}
+//# sourceMappingURL=registry.js.map

package/lib/module/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["ComponentRegistry","components","Map","register","type","component","set","get","has","types","Array","from","keys","createDefaultRegistry","StackComponent","require","TextComponent","ButtonComponent","ImageComponent","ScrollViewComponent","FlatListComponent"],"sourceRoot":"../../src","sources":["registry.ts"],"mappings":";;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAeA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMA,iBAAiB,CAAC;EACZC,UAAU,GAAG,IAAIC,GAAG,CAA6B,CAAC;;EAEnE;AACF;AACA;AACA;AACA;EACEC,QAAQA,CACNC,IAAY,EACZC,SAAqC,EAC/B;IACN,IAAI,CAACJ,UAAU,CAACK,GAAG,CAACF,IAAI,EAAEC,SAA+B,CAAC;IAC1D,OAAO,IAAI;EACb;;EAEA;AACF;AACA;AACA;EACEE,GAAGA,CAACH,IAAY,EAAkC;IAChD,OAAO,IAAI,CAACH,UAAU,CAACM,GAAG,CAACH,IAAI,CAAC;EAClC;;EAEA;AACF;AACA;EACEI,GAAGA,CAACJ,IAAY,EAAW;IACzB,OAAO,IAAI,CAACH,UAAU,CAACO,GAAG,CAACJ,IAAI,CAAC;EAClC;;EAEA;AACF;AACA;EACEK,KAAKA,CAAA,EAAa;IAChB,OAAOC,KAAK,CAACC,IAAI,CAAC,IAAI,CAACV,UAAU,CAACW,IAAI,CAAC,CAAC,CAAC;EAC3C;AACF;;AAEA;AACA;AACA;AACA,OAAO,SAASC,qBAAqBA,CAAA,EAAsB;EACzD;EACA;EACA,MAAM;IAAEC;EAAe,CAAC,GAAGC,OAAO,CAAC,6BAA6B,CAAC;EACjE,MAAM;IAAEC;EAAc,CAAC,GAAGD,OAAO,CAAC,4BAA4B,CAAC;EAC/D,MAAM;IAAEE;EAAgB,CAAC,GAAGF,OAAO,CAAC,8BAA8B,CAAC;EACnE,MAAM;IAAEG;EAAe,CAAC,GAAGH,OAAO,CAAC,6BAA6B,CAAC;EACjE,MAAM;IAAEI;EAAoB,CAAC,GAAGJ,OAAO,CAAC,kCAAkC,CAAC;EAC3E,MAAM;IAAEK;EAAkB,CAAC,GAAGL,OAAO,CAAC,gCAAgC,CAAC;EAEvE,OAAO,IAAIf,iBAAiB,CAAC,CAAC,CAC3BG,QAAQ,CAAC,OAAO,EAAEW,cAAc;EACjC;EAAA,CACCX,QAAQ,CAAC,QAAQ,EAAEW,cAAc,CAAC,CAClCX,QAAQ,CAAC,MAAM,EAAEa,aAAa,CAAC,CAC/Bb,QAAQ,CAAC,QAAQ,EAAEc,eAAe,CAAC,CACnCd,QAAQ,CAAC,OAAO,EAAEe,cAAc,CAAC,CACjCf,QAAQ,CAAC,YAAY,EAAEgB,mBAAmB,CAAC,CAC3ChB,QAAQ,CAAC,UAAU,EAAEiB,iBAAiB,CAAC;AAC5C","ignoreList":[]}

package/lib/module/renderer/RecursiveRenderer.js

@@ -0,0 +1,197 @@
+"use strict";
+
+import React from 'react';
+import { resolveProps, resolveDeep, resolveValue } from './bindingResolver';
+import { evaluateIf } from './conditionalEvaluator';
+
+// ---------------------------------------------------------------------------
+// Types
+// ---------------------------------------------------------------------------
+import { jsx as _jsx } from "react/jsx-runtime";
+// ---------------------------------------------------------------------------
+// Action wiring helpers
+// ---------------------------------------------------------------------------
+
+/**
+ * Group an actions array by trigger name and produce a prop map where each
+ * trigger key maps to a callback that fires all actions for that trigger.
+ */
+function buildActionProps(actions, context, dispatchAction) {
+  // Group by trigger
+  const grouped = new Map();
+  for (const action of actions) {
+    const existing = grouped.get(action.trigger);
+    if (existing) {
+      existing.push(action);
+    } else {
+      grouped.set(action.trigger, [action]);
+    }
+  }
+  const result = {};
+  for (const [trigger, triggerActions] of grouped) {
+    result[trigger] = (..._args) => {
+      for (const action of triggerActions) {
+        const resolvedPayload = action.payload !== undefined ? resolveDeep(action.payload, context) : undefined;
+        dispatchAction(action.action, resolvedPayload);
+      }
+    };
+  }
+  return result;
+}
+
+// ---------------------------------------------------------------------------
+// FlatList special handling
+// ---------------------------------------------------------------------------
+
+function renderFlatListNode(node, context, registry, dispatchAction, fallbackComponent) {
+  // Resolve all props including the data/items binding
+  const resolvedProps = resolveProps(node.props, context);
+
+  // Build action props for the FlatList container itself
+  const actionProps = node.actions ? buildActionProps(node.actions, context, dispatchAction) : {};
+
+  // Support both `data` (transformer output) and `items` (legacy) for the array source.
+  // Extract and resolve; the primitive receives it as `items`.
+  const {
+    data: resolvedData,
+    items: resolvedItems,
+    keyExtractor: keyExtractorExpr,
+    direction,
+    numColumns,
+    visible: _visible,
+    _propValues: _pv,
+    ...restProps
+  } = resolvedProps;
+  const items = Array.isArray(resolvedData) ? resolvedData : Array.isArray(resolvedItems) ? resolvedItems : [];
+
+  // Build a keyExtractor function if specified in schema
+  let keyExtractorFn;
+  if (typeof keyExtractorExpr === 'string') {
+    const extractorExpr = keyExtractorExpr;
+    keyExtractorFn = (item, index) => {
+      const itemContext = {
+        ...context,
+        item,
+        index
+      };
+      const resolved = resolveValue(extractorExpr, itemContext);
+      return resolved !== undefined && resolved !== null ? String(resolved) : String(index);
+    };
+  }
+
+  // itemTemplate: per-item context merges { item, index } into current context
+  const renderItemFn = ({
+    item,
+    index
+  }) => {
+    const itemContext = {
+      ...context,
+      item,
+      index
+    };
+    return /*#__PURE__*/_jsx(RecursiveRenderer, {
+      node: node.itemTemplate,
+      context: itemContext,
+      registry: registry,
+      dispatchAction: dispatchAction,
+      fallbackComponent: fallbackComponent
+    }, keyExtractorFn ? keyExtractorFn(item, index) : index);
+  };
+  const FlatListComponent = registry.resolve('flatlist');
+  if (!FlatListComponent) {
+    console.warn('[PushFrame] RecursiveRenderer: "flatlist" not found in registry.');
+    return fallbackComponent ? fallbackComponent : null;
+  }
+  return /*#__PURE__*/React.createElement(FlatListComponent, {
+    ...restProps,
+    ...actionProps,
+    items,
+    direction,
+    numColumns,
+    keyExtractor: keyExtractorFn,
+    renderItem: renderItemFn
+  });
+}
+
+// ---------------------------------------------------------------------------
+// RecursiveRenderer
+// ---------------------------------------------------------------------------
+
+/**
+ * Stateless recursive renderer. Evaluates schema nodes and produces React elements.
+ *
+ * - Evaluates `if` expression (string or non-string); returns null when falsy
+ * - Handles `visible` prop: returns null when visible resolves to false
+ * - Handles FlatList nodes with per-item context injection via `itemTemplate`
+ * - Supports `data` (transformer) and `items` (legacy) as FlatList data source
+ * - Resolves all prop bindings against current context
+ * - Merges `_propValues` into child context (custom component prop injection)
+ * - Wires actions to component event handler props
+ * - Looks up component in registry; renders fallback or null when not found
+ * - Recurses into children
+ */
+export function RecursiveRenderer({
+  node,
+  context,
+  registry,
+  dispatchAction,
+  fallbackComponent
+}) {
+  // 1. Evaluate conditional — skip entire subtree if falsy
+  if (!evaluateIf(node.if, context)) {
+    return null;
+  }
+
+  // 2. FlatList special case
+  if (node.type === 'flatlist') {
+    return renderFlatListNode(node, context, registry, dispatchAction, fallbackComponent);
+  }
+
+  // 3. Resolve props
+  const resolvedProps = resolveProps(node.props, context);
+
+  // 4. Handle `visible` prop — transformer sets visible:false when a node is hidden.
+  //    A missing or true value means visible; anything falsy hides the node.
+  if (resolvedProps.visible !== undefined && !resolvedProps.visible) {
+    return null;
+  }
+
+  // 5. Extract SDK-internal props that must not be forwarded to RN components.
+  //    `_propValues` carries custom-component instance overrides → merge into
+  //    child context so nested bindings resolve against them.
+  const {
+    visible: _visible,
+    _propValues: propValuesRaw,
+    ...propsToForward
+  } = resolvedProps;
+  const propValues = propValuesRaw;
+  const childContext = propValues && Object.keys(propValues).length > 0 ? {
+    ...context,
+    ...propValues
+  } : context;
+
+  // 6. Wire actions → inject as trigger-named props
+  const actionProps = node.actions ? buildActionProps(node.actions, context, dispatchAction) : {};
+
+  // 7. Resolve component from registry
+  const Component = registry.resolve(node.type);
+  if (!Component) {
+    console.warn(`[PushFrame] RecursiveRenderer: Unknown component type "${node.type}". ` + `Registered types: ${registry.types().join(', ')}`);
+    return fallbackComponent ? fallbackComponent : null;
+  }
+
+  // 8. Render children recursively (using childContext for _propValues injection)
+  const children = node.children && node.children.length > 0 ? node.children.map((child, index) => /*#__PURE__*/_jsx(RecursiveRenderer, {
+    node: child,
+    context: childContext,
+    registry: registry,
+    dispatchAction: dispatchAction,
+    fallbackComponent: fallbackComponent
+  }, `${child.type}-${index}`)) : undefined;
+  return /*#__PURE__*/React.createElement(Component, {
+    ...propsToForward,
+    ...actionProps,
+    children
+  });
+}
+//# sourceMappingURL=RecursiveRenderer.js.map

package/lib/module/renderer/RecursiveRenderer.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["React","resolveProps","resolveDeep","resolveValue","evaluateIf","jsx","_jsx","buildActionProps","actions","context","dispatchAction","grouped","Map","action","existing","get","trigger","push","set","result","triggerActions","_args","resolvedPayload","payload","undefined","renderFlatListNode","node","registry","fallbackComponent","resolvedProps","props","actionProps","data","resolvedData","items","resolvedItems","keyExtractor","keyExtractorExpr","direction","numColumns","visible","_visible","_propValues","_pv","restProps","Array","isArray","keyExtractorFn","extractorExpr","item","index","itemContext","resolved","String","renderItemFn","RecursiveRenderer","itemTemplate","FlatListComponent","resolve","console","warn","createElement","renderItem","if","type","propValuesRaw","propsToForward","propValues","childContext","Object","keys","length","Component","types","join","children","map","child"],"sourceRoot":"../../../src","sources":["renderer/RecursiveRenderer.tsx"],"mappings":"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","ignoreList":[]}

package/lib/module/renderer/bindingResolver.js

@@ -0,0 +1,92 @@
+"use strict";
+
+/**
+ * Binding resolver for PushFrame {{expression}} syntax.
+ *
+ * Rules:
+ * - A value that is entirely "{{expr}}" resolves to the bound value (any type)
+ * - A value with inline bindings "Hello {{user.name}}" resolves to a string
+ * - Unresolved paths return undefined — never throws
+ * - Non-string values are returned as-is
+ */
+
+const FULL_BINDING_RE = /^\{\{(.+)\}\}$/;
+const INLINE_BINDING_RE = /\{\{([^}]+)\}\}/g;
+
+/**
+ * Evaluate a binding expression string against the provided context.
+ * Uses Function constructor for safe, sandboxed expression evaluation.
+ * Returns undefined on any error.
+ */
+function evaluateExpression(expr, context) {
+  try {
+    const keys = Object.keys(context);
+    const values = keys.map(k => context[k]);
+    // eslint-disable-next-line no-new-func
+    const fn = new Function(...keys, `"use strict"; try { return (${expr}); } catch(e) { return undefined; }`);
+    return fn(...values);
+  } catch {
+    return undefined;
+  }
+}
+
+/**
+ * Resolve a single prop value against context.
+ *
+ * - String values: check for full binding "{{expr}}" or inline bindings "Hello {{name}}"
+ * - Non-string values: returned as-is
+ */
+export function resolveValue(value, context) {
+  if (typeof value !== 'string') {
+    return value;
+  }
+
+  // Full binding: entire string is "{{expr}}" — return the actual resolved value
+  const fullMatch = FULL_BINDING_RE.exec(value);
+  if (fullMatch?.[1] !== undefined) {
+    return evaluateExpression(fullMatch[1].trim(), context);
+  }
+
+  // Inline binding: replace each "{{expr}}" occurrence within the string
+  if (INLINE_BINDING_RE.test(value)) {
+    INLINE_BINDING_RE.lastIndex = 0;
+    return value.replace(INLINE_BINDING_RE, (_, expr) => {
+      const resolved = evaluateExpression(expr.trim(), context);
+      return resolved !== undefined && resolved !== null ? String(resolved) : '';
+    });
+  }
+
+  // No bindings — return as-is
+  return value;
+}
+
+/**
+ * Resolve all values in a props map against the context.
+ * Recursively resolves nested objects and arrays.
+ */
+export function resolveProps(props, context) {
+  if (!props) return {};
+  const resolved = {};
+  for (const [key, value] of Object.entries(props)) {
+    resolved[key] = resolveDeep(value, context);
+  }
+  return resolved;
+}
+
+/**
+ * Recursively resolve binding expressions in a value (including nested objects/arrays).
+ */
+export function resolveDeep(value, context) {
+  if (Array.isArray(value)) {
+    return value.map(item => resolveDeep(item, context));
+  }
+  if (typeof value === 'object' && value !== null) {
+    const result = {};
+    for (const [k, v] of Object.entries(value)) {
+      result[k] = resolveDeep(v, context);
+    }
+    return result;
+  }
+  return resolveValue(value, context);
+}
+//# sourceMappingURL=bindingResolver.js.map

package/lib/module/renderer/bindingResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["FULL_BINDING_RE","INLINE_BINDING_RE","evaluateExpression","expr","context","keys","Object","values","map","k","fn","Function","undefined","resolveValue","value","fullMatch","exec","trim","test","lastIndex","replace","_","resolved","String","resolveProps","props","key","entries","resolveDeep","Array","isArray","item","result","v"],"sourceRoot":"../../../src","sources":["renderer/bindingResolver.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/renderer/conditionalEvaluator.js

@@ -0,0 +1,28 @@
+"use strict";
+
+import { resolveValue } from './bindingResolver';
+
+/**
+ * Evaluate the `if` expression of a SchemaNode against the current context.
+ *
+ * Returns true  → node should render
+ * Returns false → node (and its entire subtree) should be skipped
+ *
+ * Falsy values: false, null, undefined, 0, "" all hide the node.
+ * When `ifExpr` is undefined/null the node always renders.
+ *
+ * Accepts `unknown` to match the transformer's `if?: unknown` output:
+ *   - String values are resolved as {{}} binding expressions
+ *   - Non-string values (boolean, number, null) are coerced directly
+ */
+export function evaluateIf(ifExpr, context) {
+  if (ifExpr === undefined || ifExpr === null) return true;
+
+  // Non-string: treat the value itself as the condition (e.g. `if: false`)
+  if (typeof ifExpr !== 'string') return Boolean(ifExpr);
+  const resolved = resolveValue(ifExpr, context);
+
+  // Standard falsy check — any falsy value hides the node
+  return Boolean(resolved);
+}
+//# sourceMappingURL=conditionalEvaluator.js.map

package/lib/module/renderer/conditionalEvaluator.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["resolveValue","evaluateIf","ifExpr","context","undefined","Boolean","resolved"],"sourceRoot":"../../../src","sources":["renderer/conditionalEvaluator.ts"],"mappings":";;AAAA,SAASA,YAAY,QAAQ,mBAAmB;;AAEhD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,UAAUA,CACxBC,MAAe,EACfC,OAAgC,EACvB;EACT,IAAID,MAAM,KAAKE,SAAS,IAAIF,MAAM,KAAK,IAAI,EAAE,OAAO,IAAI;;EAExD;EACA,IAAI,OAAOA,MAAM,KAAK,QAAQ,EAAE,OAAOG,OAAO,CAACH,MAAM,CAAC;EAEtD,MAAMI,QAAQ,GAAGN,YAAY,CAACE,MAAM,EAAEC,OAAO,CAAC;;EAE9C;EACA,OAAOE,OAAO,CAACC,QAAQ,CAAC;AAC1B","ignoreList":[]}