@pushframe/sdk 0.1.4 → 0.1.8

package/lib/commonjs/renderer/bindingResolver.js

@@ -0,0 +1,98 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.resolveDeep = resolveDeep;
+exports.resolveProps = resolveProps;
+exports.resolveValue = resolveValue;
+/**
+ * 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
+ */
+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.
+ */
+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).
+ */
+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/commonjs/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/commonjs/renderer/conditionalEvaluator.js

@@ -0,0 +1,31 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.evaluateIf = evaluateIf;
+var _bindingResolver = require("./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
+ */
+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 = (0, _bindingResolver.resolveValue)(ifExpr, context);
+
+  // Standard falsy check — any falsy value hides the node
+  return Boolean(resolved);
+}
+//# sourceMappingURL=conditionalEvaluator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["_bindingResolver","require","evaluateIf","ifExpr","context","undefined","Boolean","resolved","resolveValue"],"sourceRoot":"../../../src","sources":["renderer/conditionalEvaluator.ts"],"mappings":";;;;;;AAAA,IAAAA,gBAAA,GAAAC,OAAA;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,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,GAAG,IAAAC,6BAAY,EAACL,MAAM,EAAEC,OAAO,CAAC;;EAE9C;EACA,OAAOE,OAAO,CAACC,QAAQ,CAAC;AAC1B","ignoreList":[]}

package/lib/commonjs/renderer.js

@@ -0,0 +1,107 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.renderNode = renderNode;
+var _react = _interopRequireDefault(require("react"));
+var _bindings = require("./bindings");
+var _conditions = require("./conditions");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+/**
+ * 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
+ */
+function renderNode({
+  node,
+  context,
+  registry,
+  onAction,
+  key
+}) {
+  // 1. Evaluate conditions — skip if false.
+  if (!(0, _conditions.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 = (0, _bindings.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.default.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/commonjs/renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_react","_interopRequireDefault","require","_bindings","_conditions","e","__esModule","default","renderNode","node","context","registry","onAction","key","evaluateCondition","conditions","Component","get","type","console","warn","types","join","resolvedProps","resolveProps","props","actions","mergeActionCallbacks","childOptions","children","length","map","child","index","undefined","renderChild","childNode","contextOverride","componentProps","rawChildren","React","createElement","eventName","action","Object","entries"],"sourceRoot":"../../src","sources":["renderer.tsx"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/schema.js

@@ -0,0 +1,79 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.SCHEMA_VERSION = void 0;
+exports.isBinding = isBinding;
+/**
+ * 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
+// ---------------------------------------------------------------------------
+
+const SCHEMA_VERSION = exports.SCHEMA_VERSION = '1.0';
+
+// ---------------------------------------------------------------------------
+// Data binding
+// ---------------------------------------------------------------------------
+
+/**
+ * A binding reference to a value in the runtime context.
+ * e.g. { "$bind": "user.firstName" }
+ */
+
+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/commonjs/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["SCHEMA_VERSION","exports","isBinding","value"],"sourceRoot":"../../src","sources":["schema.ts"],"mappings":";;;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;;AAEO,MAAMA,cAAc,GAAAC,OAAA,CAAAD,cAAA,GAAG,KAAc;;AAG5C;AACA;AACA;;AAEA;AACA;AACA;AACA;;AAKO,SAASE,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":[]}