@pushframe/sdk 0.1.5 → 0.1.8

package/lib/module/renderer.js

@@ -0,0 +1,103 @@
+"use strict";
+
+import React from 'react';
+import { resolveProps } from './bindings';
+import { evaluateCondition } from './conditions';
+
+/**
+ * Called by the host app whenever an action is triggered.
+ * `eventName` is the prop key (e.g. "onPress").
+ * `action` is the resolved action descriptor from the schema.
+ */
+
+/**
+ * Recursively render a single PushframeNode.
+ *
+ * Returns null when:
+ *  - The node's condition evaluates to false
+ *  - The node's type is not found in the registry
+ */
+export function renderNode({
+  node,
+  context,
+  registry,
+  onAction,
+  key
+}) {
+  // 1. Evaluate conditions — skip if false.
+  if (!evaluateCondition(node.conditions, context)) {
+    return null;
+  }
+
+  // 2. Look up the component.
+  const Component = registry.get(node.type);
+  if (!Component) {
+    console.warn(`[Pushframe] No component registered for type "${node.type}". ` + `Registered types: ${registry.types().join(', ')}`);
+    return null;
+  }
+
+  // 3. Resolve props.
+  const resolvedProps = resolveProps(node.props, context);
+
+  // 4. Build action callbacks and merge into props.
+  if (node.actions) {
+    mergeActionCallbacks(resolvedProps, node.actions, onAction);
+  }
+
+  // 5. Render children recursively.
+  const childOptions = onAction ? {
+    context,
+    registry,
+    onAction
+  } : {
+    context,
+    registry
+  };
+  const children = node.children && node.children.length > 0 ? node.children.map((child, index) => renderNode({
+    node: child,
+    key: `${child.type}-${index}`,
+    ...childOptions
+  })) : undefined;
+
+  // Helper for data-driven components (e.g. FlatList) to render a template
+  // node multiple times with different context (e.g. one render per list item).
+  const renderChild = (childNode, contextOverride) => renderNode({
+    node: childNode,
+    context: contextOverride ? {
+      ...context,
+      ...contextOverride
+    } : context,
+    registry,
+    onAction
+  });
+
+  // 6. Build component props — only include onAction when defined
+  //    (required by exactOptionalPropertyTypes).
+  const componentProps = {
+    props: resolvedProps,
+    children,
+    rawChildren: node.children,
+    renderChild
+  };
+  return /*#__PURE__*/React.createElement(Component, {
+    key,
+    ...componentProps
+  });
+}
+
+/**
+ * For each entry in the actions map, inject a callback function into resolvedProps
+ * so the component can call e.g. `props.onPress()` without coupling to the schema.
+ */
+function mergeActionCallbacks(resolvedProps, actions, onAction) {
+  for (const [eventName, action] of Object.entries(actions)) {
+    resolvedProps[eventName] = () => {
+      if (onAction) {
+        onAction(eventName, action);
+      } else {
+        console.warn(`[Pushframe] Action "${eventName}" fired but no onAction handler was provided.`);
+      }
+    };
+  }
+}
+//# sourceMappingURL=renderer.js.map

package/lib/module/renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["React","resolveProps","evaluateCondition","renderNode","node","context","registry","onAction","key","conditions","Component","get","type","console","warn","types","join","resolvedProps","props","actions","mergeActionCallbacks","childOptions","children","length","map","child","index","undefined","renderChild","childNode","contextOverride","componentProps","rawChildren","createElement","eventName","action","Object","entries"],"sourceRoot":"../../src","sources":["renderer.tsx"],"mappings":";;AAAA,OAAOA,KAAK,MAAM,OAAO;AAKzB,SAASC,YAAY,QAAQ,YAAY;AACzC,SAASC,iBAAiB,QAAQ,cAAc;;AAGhD;AACA;AACA;AACA;AACA;;AAYA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,UAAUA,CAAC;EACzBC,IAAI;EACJC,OAAO;EACPC,QAAQ;EACRC,QAAQ;EACRC;AACiB,CAAC,EAAuB;EACzC;EACA,IAAI,CAACN,iBAAiB,CAACE,IAAI,CAACK,UAAU,EAAEJ,OAAO,CAAC,EAAE;IAChD,OAAO,IAAI;EACb;;EAEA;EACA,MAAMK,SAAS,GAAGJ,QAAQ,CAACK,GAAG,CAACP,IAAI,CAACQ,IAAI,CAAC;EACzC,IAAI,CAACF,SAAS,EAAE;IACdG,OAAO,CAACC,IAAI,CACV,iDAAiDV,IAAI,CAACQ,IAAI,KAAK,GAC7D,qBAAqBN,QAAQ,CAACS,KAAK,CAAC,CAAC,CAACC,IAAI,CAAC,IAAI,CAAC,EACpD,CAAC;IACD,OAAO,IAAI;EACb;;EAEA;EACA,MAAMC,aAAa,GAAGhB,YAAY,CAACG,IAAI,CAACc,KAAK,EAAEb,OAAO,CAAC;;EAEvD;EACA,IAAID,IAAI,CAACe,OAAO,EAAE;IAChBC,oBAAoB,CAACH,aAAa,EAAEb,IAAI,CAACe,OAAO,EAAEZ,QAAQ,CAAC;EAC7D;;EAEA;EACA,MAAMc,YAAY,GAAGd,QAAQ,GACzB;IAAEF,OAAO;IAAEC,QAAQ;IAAEC;EAAS,CAAC,GAC/B;IAAEF,OAAO;IAAEC;EAAS,CAAC;EAEzB,MAAMgB,QAAQ,GACZlB,IAAI,CAACkB,QAAQ,IAAIlB,IAAI,CAACkB,QAAQ,CAACC,MAAM,GAAG,CAAC,GACrCnB,IAAI,CAACkB,QAAQ,CAACE,GAAG,CAAC,CAACC,KAAK,EAAEC,KAAK,KAC7BvB,UAAU,CAAC;IACTC,IAAI,EAAEqB,KAAK;IACXjB,GAAG,EAAE,GAAGiB,KAAK,CAACb,IAAI,IAAIc,KAAK,EAAE;IAC7B,GAAGL;EACL,CAAC,CACH,CAAC,GACDM,SAAS;;EAEf;EACA;EACA,MAAMC,WAAW,GAAGA,CAClBC,SAAwB,EACxBC,eAAyC,KAEzC3B,UAAU,CAAC;IACTC,IAAI,EAAEyB,SAAS;IACfxB,OAAO,EAAEyB,eAAe,GAAG;MAAE,GAAGzB,OAAO;MAAE,GAAGyB;IAAgB,CAAC,GAAGzB,OAAO;IACvEC,QAAQ;IACRC;EACF,CAAC,CAAC;;EAEJ;EACA;EACA,MAAMwB,cAAc,GAAG;IACrBb,KAAK,EAAED,aAAwC;IAC/CK,QAAQ;IACRU,WAAW,EAAE5B,IAAI,CAACkB,QAAQ;IAC1BM;EACF,CAAC;EAED,oBAAO5B,KAAK,CAACiC,aAAa,CAACvB,SAAS,EAAE;IAAEF,GAAG;IAAE,GAAGuB;EAAe,CAAC,CAAC;AACnE;;AAEA;AACA;AACA;AACA;AACA,SAASX,oBAAoBA,CAC3BH,aAAsC,EACtCE,OAAmB,EACnBZ,QAAwB,EAClB;EACN,KAAK,MAAM,CAAC2B,SAAS,EAAEC,MAAM,CAAC,IAAIC,MAAM,CAACC,OAAO,CAAClB,OAAO,CAAC,EAAE;IACzDF,aAAa,CAACiB,SAAS,CAAC,GAAG,MAAM;MAC/B,IAAI3B,QAAQ,EAAE;QACZA,QAAQ,CAAC2B,SAAS,EAAEC,MAAM,CAAC;MAC7B,CAAC,MAAM;QACLtB,OAAO,CAACC,IAAI,CACV,uBAAuBoB,SAAS,+CAClC,CAAC;MACH;IACF,CAAC;EACH;AACF","ignoreList":[]}

package/lib/module/schema.js

@@ -0,0 +1,74 @@
+"use strict";
+
+/**
+ * Pushframe Schema — typed definitions for screen definitions.
+ *
+ * A screen is described as a tree of PushframeNode objects.
+ * Props can be static values OR data-bindings via { "$bind": "path.to.value" }.
+ * Conditions gate whether a node renders at all.
+ * Actions declare event handlers; the host app is responsible for handling them.
+ */
+
+// ---------------------------------------------------------------------------
+// Primitive schema version
+// ---------------------------------------------------------------------------
+
+export const SCHEMA_VERSION = '1.0';
+
+// ---------------------------------------------------------------------------
+// Data binding
+// ---------------------------------------------------------------------------
+
+/**
+ * A binding reference to a value in the runtime context.
+ * e.g. { "$bind": "user.firstName" }
+ */
+
+export function isBinding(value) {
+  return typeof value === 'object' && value !== null && '$bind' in value && typeof value['$bind'] === 'string';
+}
+
+/**
+ * A prop value is either a static primitive / object, or a binding.
+ */
+
+// ---------------------------------------------------------------------------
+// Conditions
+// ---------------------------------------------------------------------------
+
+/**
+ * A condition gates whether a node should render.
+ *
+ * Supported operators:
+ *   equals     — strict equality (===)
+ *   notEquals  — strict inequality (!==)
+ *   truthy     — if the resolved value is truthy (no `value` needed)
+ *   falsy      — if the resolved value is falsy  (no `value` needed)
+ */
+
+// ---------------------------------------------------------------------------
+// Actions
+// ---------------------------------------------------------------------------
+
+/** Navigate to another screen by ID. */
+
+/** Emit a named custom event. The host app decides what to do with it. */
+
+// ---------------------------------------------------------------------------
+// Node
+// ---------------------------------------------------------------------------
+
+/**
+ * A single node in the UI tree.
+ *
+ * `type` maps to a registered component (e.g. "stack", "text", "button", "image").
+ * `props` are passed (after binding resolution) directly to the component.
+ * `children` are rendered recursively.
+ * `conditions` — when present, node is skipped if the condition evaluates to false.
+ * `actions` — event handler definitions; passed to the component as resolved callbacks.
+ */
+
+// ---------------------------------------------------------------------------
+// Screen definition
+// ---------------------------------------------------------------------------
+//# sourceMappingURL=schema.js.map

package/lib/module/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["SCHEMA_VERSION","isBinding","value"],"sourceRoot":"../../src","sources":["schema.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;;AAEA,OAAO,MAAMA,cAAc,GAAG,KAAc;;AAG5C;AACA;AACA;;AAEA;AACA;AACA;AACA;;AAKA,OAAO,SAASC,SAASA,CAACC,KAAc,EAAoB;EAC1D,OACE,OAAOA,KAAK,KAAK,QAAQ,IACzBA,KAAK,KAAK,IAAI,IACd,OAAO,IAAIA,KAAK,IAChB,OAAQA,KAAK,CAA6B,OAAO,CAAC,KAAK,QAAQ;AAEnE;;AAEA;AACA;AACA;;AAYA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAeA;AACA;AACA;;AAEA;;AAOA;;AAWA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AASA;AACA;AACA","ignoreList":[]}