@getrheo/flow-runtime 1.0.0

package/dist/interpolateTemplate.d.ts

@@ -0,0 +1,44 @@
+import { FlowManifest } from '@getrheo/contracts/manifest';
+import { LocalizedText } from '@getrheo/contracts/localized';
+import { S as StepResponse } from './stepResponse-BXgoZ7o-.js';
+import '@getrheo/contracts/layers';
+import '@getrheo/contracts/externalSurfaces';
+
+/** Runtime substitution for Text layer copy (after locale resolution). */
+type InterpolationRuntimeContext = {
+    manifest: FlowManifest;
+    locale: string;
+    responses: Record<string, StepResponse>;
+    customProperties?: Record<string, string>;
+};
+/** Props-sized slice passed into renderers. */
+type InterpolationContext = {
+    responses: Record<string, StepResponse>;
+    customProperties?: Record<string, string>;
+    /** When true, the flow has a prior step so back navigation is available. */
+    canGoBack?: boolean;
+};
+declare const extractLiquidTemplateBodies: (s: string) => string[];
+type InterpolationExprAnalysis = {
+    kind: 'custom';
+    key: string;
+} | {
+    kind: 'field';
+    fieldKey: string;
+    mode: 'label' | 'id';
+} | {
+    kind: 'invalid';
+};
+/** Parse one `{{ … }}` inner (after stripping delimiters) for diagnostics / validation. */
+declare const analyzeLiquidTemplateInner: (inner: string) => {
+    expr: InterpolationExprAnalysis;
+    defaultValue?: string;
+};
+/**
+ * Interpolate `{{ … }}` segments in a plain string (already localized).
+ * Supports `custom.key`, `field_key`, `field_key.id`, and `| default: …`.
+ */
+declare const interpolateTemplateString: (template: string, ctx: InterpolationRuntimeContext) => string;
+declare const resolveAndInterpolateLocalizedText: (text: LocalizedText, ctx: InterpolationRuntimeContext) => string;
+
+export { type InterpolationContext, type InterpolationExprAnalysis, type InterpolationRuntimeContext, analyzeLiquidTemplateInner, extractLiquidTemplateBodies, interpolateTemplateString, resolveAndInterpolateLocalizedText };

package/dist/interpolateTemplate.js

@@ -0,0 +1,188 @@
+import { FIELD_KEY_RE } from '@getrheo/contracts/fields';
+import { resolveLocalizedText } from '@getrheo/contracts/localized';
+import { isInputLayer } from '@getrheo/contracts/layers';
+
+// src/interpolateTemplate.ts
+var walkLayers = (root, fn) => {
+  const visit = (l, depth) => {
+    fn(l, depth);
+    if (l.kind === "stack") l.children.forEach((c) => visit(c, depth + 1));
+    else if (l.kind === "carousel") l.slides.forEach((c) => visit(c, depth + 1));
+    else if (l.kind === "button") l.children.forEach((c) => visit(c, depth + 1));
+    else if (l.kind === "back_button") l.children.forEach((c) => visit(c, depth + 1));
+    else if (l.kind === "hyperlink") l.children.forEach((c) => visit(c, depth + 1));
+    else if (l.kind === "single_choice" || l.kind === "multiple_choice") {
+      l.children.forEach((c) => visit(c, depth + 1));
+    } else if (l.kind === "text_input" || l.kind === "scale_input") {
+      l.children?.forEach((c) => visit(c, depth + 1));
+    } else if (l.kind === "oauth_login") {
+      l.children.forEach((c) => visit(c, depth + 1));
+    } else if (l.kind === "oauth_provider" && l.variant === "custom") {
+      l.children.forEach((c) => visit(c, depth + 1));
+    } else if (l.kind === "email_password_auth") {
+      l.children.forEach((c) => visit(c, depth + 1));
+    } else if (l.kind === "email_password_field") {
+      l.children?.forEach((c) => visit(c, depth + 1));
+    } else if (l.kind === "email_password_submit") {
+      l.children.forEach((c) => visit(c, depth + 1));
+    }
+  };
+  visit(root, 0);
+};
+var walkScreen = (screen, fn) => {
+  if (screen.regions.header) walkLayers(screen.regions.header, fn);
+  walkLayers(screen.regions.body, fn);
+  if (screen.regions.footer) walkLayers(screen.regions.footer, fn);
+};
+var findInputLayer = (screen) => {
+  let found = null;
+  walkScreen(screen, (l) => {
+    if (!found && isInputLayer(l)) found = l;
+  });
+  return found;
+};
+var findOptionStackForChoice = (layer, optionId) => {
+  const binding = layer.optionBindings.find((b) => b.optionId === optionId);
+  if (!binding) return null;
+  const stack = layer.children.find((c) => c.id === binding.rootLayerId);
+  return stack ?? null;
+};
+var choiceOptionLabel = (layer, optionId, locale) => {
+  const stack = findOptionStackForChoice(layer, optionId);
+  if (!stack) return "";
+  let foundText = null;
+  walkLayers(stack, (l) => {
+    if (foundText) return;
+    if (l.kind === "text") foundText = l.text;
+  });
+  if (foundText) return resolveLocalizedText(foundText, locale);
+  return optionId;
+};
+
+// src/interpolateTemplate.ts
+var extractLiquidTemplateBodies = (s) => {
+  const out = [];
+  let i = 0;
+  while (i < s.length) {
+    const open = s.indexOf("{{", i);
+    if (open === -1) break;
+    const close = s.indexOf("}}", open + 2);
+    if (close === -1) break;
+    out.push(s.slice(open + 2, close));
+    i = close + 2;
+  }
+  return out;
+};
+var FIELD_KEY_SOURCE = FIELD_KEY_RE.source.replace(/^\^|\$$/g, "");
+var parseDefaultFilter = (inner) => {
+  const m = inner.match(/\s*\|\s*default\s*:/i);
+  if (!m || m.index === void 0) return { exprPart: inner.trim() };
+  const exprPart = inner.slice(0, m.index).trim();
+  let tail = inner.slice(m.index + m[0].length).trim();
+  if (tail.startsWith('"')) {
+    const end = tail.indexOf('"', 1);
+    if (end > 0) tail = tail.slice(1, end);
+    else tail = tail.slice(1);
+  }
+  return { exprPart, defaultValue: tail };
+};
+var parseExpression = (exprRaw) => {
+  const expr = exprRaw.trim();
+  const customM = expr.match(new RegExp(`^custom\\.(${FIELD_KEY_SOURCE})$`));
+  if (customM) return { kind: "custom", key: customM[1] };
+  const idM = expr.match(new RegExp(`^(${FIELD_KEY_SOURCE})\\.id$`));
+  if (idM) return { kind: "field", fieldKey: idM[1], mode: "id" };
+  const plainM = expr.match(new RegExp(`^(${FIELD_KEY_SOURCE})$`));
+  if (plainM) return { kind: "field", fieldKey: plainM[1], mode: "label" };
+  return { kind: "invalid" };
+};
+var analyzeLiquidTemplateInner = (inner) => {
+  const { exprPart, defaultValue } = parseDefaultFilter(inner);
+  const p = parseExpression(exprPart);
+  if (p.kind === "invalid") return { expr: { kind: "invalid" }, defaultValue };
+  if (p.kind === "custom") return { expr: { kind: "custom", key: p.key }, defaultValue };
+  return { expr: { kind: "field", fieldKey: p.fieldKey, mode: p.mode }, defaultValue };
+};
+var findInputOwner = (manifest, fieldKey) => {
+  for (const screen of manifest.screens) {
+    const input = findInputLayer(screen);
+    if (input && input.fieldKey === fieldKey) return { screen, input };
+  }
+  return null;
+};
+var choiceLabelFor = (manifest, fieldKey, choiceId, locale) => {
+  const owner = findInputOwner(manifest, fieldKey);
+  if (!owner) return "";
+  const { input } = owner;
+  if (input.kind !== "single_choice" && input.kind !== "multiple_choice") return "";
+  return choiceOptionLabel(input, choiceId, locale);
+};
+var responseToDisplayString = (manifest, fieldKey, response, mode, locale) => {
+  if (!response) return "";
+  switch (response.kind) {
+    case "text":
+      return mode === "id" ? "" : response.value;
+    case "scale":
+      return mode === "id" ? "" : String(response.value);
+    case "choice":
+      if (mode === "id") return response.choiceId;
+      return choiceLabelFor(manifest, fieldKey, response.choiceId, locale);
+    case "multiChoice":
+      if (mode === "id") return response.choiceIds.join(", ");
+      return response.choiceIds.map((id) => choiceLabelFor(manifest, fieldKey, id, locale)).filter(Boolean).join(", ");
+    case "checkbox":
+      return mode === "id" ? "" : response.value ? "true" : "false";
+    case "bypass_input":
+      return "";
+    default:
+      return "";
+  }
+};
+var evalParsed = (parsed, ctx) => {
+  if (parsed.kind === "invalid") return "";
+  if (parsed.kind === "custom") {
+    const v = ctx.customProperties?.[parsed.key];
+    return v === void 0 || v === "" ? "" : String(v);
+  }
+  const owner = findInputOwner(ctx.manifest, parsed.fieldKey);
+  const r = ctx.responses[parsed.fieldKey];
+  if (parsed.mode === "id" && owner && owner.input.kind !== "single_choice" && owner.input.kind !== "multiple_choice") {
+    return "";
+  }
+  return responseToDisplayString(ctx.manifest, parsed.fieldKey, r, parsed.mode, ctx.locale);
+};
+var interpolateTemplateString = (template, ctx) => {
+  let i = 0;
+  let out = "";
+  while (i < template.length) {
+    const open = template.indexOf("{{", i);
+    if (open === -1) {
+      out += template.slice(i);
+      break;
+    }
+    out += template.slice(i, open);
+    const close = template.indexOf("}}", open + 2);
+    if (close === -1) {
+      out += template.slice(open);
+      break;
+    }
+    const inner = template.slice(open + 2, close);
+    const { exprPart, defaultValue } = parseDefaultFilter(inner);
+    const parsed = parseExpression(exprPart);
+    let value = evalParsed(parsed, ctx);
+    if ((value === "" || value === void 0) && defaultValue !== void 0) {
+      value = defaultValue;
+    }
+    out += value;
+    i = close + 2;
+  }
+  return out;
+};
+var resolveAndInterpolateLocalizedText = (text, ctx) => {
+  const localized = resolveLocalizedText(text, ctx.locale);
+  return interpolateTemplateString(localized, ctx);
+};
+
+export { analyzeLiquidTemplateInner, extractLiquidTemplateBodies, interpolateTemplateString, resolveAndInterpolateLocalizedText };
+//# sourceMappingURL=interpolateTemplate.js.map
+//# sourceMappingURL=interpolateTemplate.js.map

package/dist/interpolateTemplate.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/layers.ts","../src/interpolateTemplate.ts"],"names":["resolveLocalizedText"],"mappings":"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","file":"interpolateTemplate.js","sourcesContent":["import type { Branding } from '@getrheo/contracts/dashboard';\nimport type { FlowManifest, Theme } from '@getrheo/contracts/manifest';\nimport type { Screen } from '@getrheo/contracts/screens';\nimport {\n  brandGradientFromThemedColor,\n  brandGradientNativeLinear,\n  brandGradientSolidFallback,\n  isStoredLinearGradientCss,\n  nativeLinearFromAngleAndStops,\n  parseLinearGradientCss,\n  resolveBrandGradientToken,\n  type BrandGradientNativeLinear,\n} from './brandGradient';\nimport type {\n  InputLayer,\n  Layer,\n  MultipleChoiceLayer,\n  ScaleInputLayer,\n  SingleChoiceLayer,\n  StackLayer,\n  TextInputLayer,\n  ThemedColor,\n} from '@getrheo/contracts/layers';\nimport type { LocalizedText } from '@getrheo/contracts/localized';\nimport { resolveLocalizedText } from '@getrheo/contracts/localized';\nimport { isInputLayer } from '@getrheo/contracts/layers';\n\n/** Walk a layer tree depth-first. */\nexport const walkLayers = (root: Layer, fn: (l: Layer, depth: number) => void): void => {\n  const visit = (l: Layer, depth: number): void => {\n    fn(l, depth);\n    if (l.kind === 'stack') l.children.forEach((c) => visit(c, depth + 1));\n    else if (l.kind === 'carousel') l.slides.forEach((c) => visit(c, depth + 1));\n    else if (l.kind === 'button') l.children.forEach((c) => visit(c, depth + 1));\n    else if (l.kind === 'back_button') l.children.forEach((c) => visit(c, depth + 1));\n    else if (l.kind === 'hyperlink') l.children.forEach((c) => visit(c, depth + 1));\n    else if (l.kind === 'single_choice' || l.kind === 'multiple_choice') {\n      l.children.forEach((c) => visit(c, depth + 1));\n    } else if (l.kind === 'text_input' || l.kind === 'scale_input') {\n      l.children?.forEach((c) => visit(c, depth + 1));\n    } else if (l.kind === 'oauth_login') {\n      l.children.forEach((c) => visit(c, depth + 1));\n    } else if (l.kind === 'oauth_provider' && l.variant === 'custom') {\n      l.children.forEach((c) => visit(c, depth + 1));\n    } else if (l.kind === 'email_password_auth') {\n      l.children.forEach((c) => visit(c, depth + 1));\n    } else if (l.kind === 'email_password_field') {\n      l.children?.forEach((c) => visit(c, depth + 1));\n    } else if (l.kind === 'email_password_submit') {\n      l.children.forEach((c) => visit(c, depth + 1));\n    }\n  };\n  visit(root, 0);\n};\n\n/** Walk every layer in a screen's regions (header → body → footer). */\nexport const walkScreen = (screen: Screen, fn: (l: Layer) => void): void => {\n  if (screen.regions.header) walkLayers(screen.regions.header, fn);\n  walkLayers(screen.regions.body, fn);\n  if (screen.regions.footer) walkLayers(screen.regions.footer, fn);\n};\n\n/** Find the screen's lone input layer (if any). Schema enforces ≤1. */\nexport const findInputLayer = (screen: Screen): InputLayer | null => {\n  let found: InputLayer | null = null;\n  walkScreen(screen, (l) => {\n    if (!found && isInputLayer(l)) found = l;\n  });\n  return found;\n};\n\n/** Input kinds that use a screen draft and require an explicit Continue to submit. */\nexport const findManualSubmitInputLayer = (\n  screen: Screen,\n): MultipleChoiceLayer | TextInputLayer | ScaleInputLayer | null => {\n  const input = findInputLayer(screen);\n  if (!input) return null;\n  if (input.kind === 'multiple_choice' || input.kind === 'text_input' || input.kind === 'scale_input') {\n    return input;\n  }\n  return null;\n};\n\n/**\n * Whether the screen contains any Button layer that submits the screen\n * (i.e. `action.kind === 'continue'`). Used by input layers to decide\n * between auto-submit-on-tap (legacy behaviour for choice-only screens)\n * and writing into the screen-level draft for a Button to submit.\n */\nexport const screenHasContinueButton = (screen: Screen): boolean => {\n  let found = false;\n  walkScreen(screen, (l) => {\n    if (l.kind === 'button' && l.action.kind === 'continue') found = true;\n  });\n  return found;\n};\n\n/**\n * Resolve a choice layer's option stack by stable optionId via its\n * binding. Returns null when the binding is missing or the bound child\n * was removed (manifest validation rejects that, but runtime stays safe).\n */\nexport const findOptionStackForChoice = (\n  layer: SingleChoiceLayer | MultipleChoiceLayer,\n  optionId: string,\n): StackLayer | null => {\n  const binding = layer.optionBindings.find((b) => b.optionId === optionId);\n  if (!binding) return null;\n  const stack = layer.children.find((c) => c.id === binding.rootLayerId);\n  return stack ?? null;\n};\n\n/**\n * Best-effort textual label for a choice option, used by interpolation\n * (e.g. `{{ goal }}` rendering the chosen option's label) and by editor\n * surfaces that show option rows. Walks the option's child subtree\n * depth-first and returns the first `text` layer's content; falls back\n * to the option's stable id when no text is present.\n */\nexport const choiceOptionLabel = (\n  layer: SingleChoiceLayer | MultipleChoiceLayer,\n  optionId: string,\n  locale: string,\n): string => {\n  const stack = findOptionStackForChoice(layer, optionId);\n  if (!stack) return '';\n  let foundText: LocalizedText | null = null;\n  walkLayers(stack, (l) => {\n    if (foundText) return;\n    if (l.kind === 'text') foundText = l.text;\n  });\n  if (foundText) return resolveLocalizedText(foundText, locale);\n  return optionId;\n};\n\n/** Find a layer in a screen by id, including nested children/slides. */\nexport const findLayerById = (screen: Screen, id: string): Layer | null => {\n  let found: Layer | null = null;\n  walkScreen(screen, (l) => {\n    if (!found && l.id === id) found = l;\n  });\n  return found;\n};\n\n/** Collect all input fieldKeys across a manifest. */\nexport const collectFieldKeys = (manifest: FlowManifest): { fieldKey: string; screenId: string }[] => {\n  const out: { fieldKey: string; screenId: string }[] = [];\n  for (const screen of manifest.screens) {\n    walkScreen(screen as unknown as Screen, (l) => {\n      if (isInputLayer(l)) out.push({ fieldKey: l.fieldKey, screenId: screen.id });\n      if (l.kind === 'checkbox') out.push({ fieldKey: l.fieldKey, screenId: screen.id });\n      if (l.kind === 'email_password_auth') {\n        out.push({ fieldKey: l.fieldKey, screenId: screen.id });\n      }\n    });\n  }\n  return out;\n};\n\n/**\n * Pick a snake_case field key starting from `base` that is not in `used`\n * (e.g. `text` → `text_2` → `text_3` when `text` is taken).\n */\nexport const nextUniqueFieldKey = (base: string, used: Iterable<string>): string => {\n  const set = used instanceof Set ? used : new Set(used);\n  if (!set.has(base)) return base;\n  let n = 2;\n  while (set.has(`${base}_${n}`)) n += 1;\n  return `${base}_${n}`;\n};\n\n/**\n * Resolve a token reference like `$primary` to a literal value from `theme`.\n * Pass-through for non-token strings; returns undefined for `undefined`.\n */\nexport const resolveTokens = <T extends string | undefined>(\n  theme: Theme | undefined,\n  value: T,\n): T | string => {\n  if (value === undefined) return value;\n  if (typeof value !== 'string' || !value.startsWith('$')) return value;\n  const key = value.slice(1) as keyof Theme;\n  const literal = theme?.[key];\n  if (typeof literal === 'string') return literal;\n  return value;\n};\n\n/**\n * Resolve a layer color for the current appearance (`light` | `dark`).\n * Plain string uses `resolveTokens` for both modes (legacy). Object form\n * picks `light` / `dark` with fallback to the other key when one is omitted.\n */\nexport const resolveThemedColor = (\n  theme: Theme | undefined,\n  palette: 'light' | 'dark',\n  value: ThemedColor | undefined,\n): string | undefined => {\n  if (value === undefined) return undefined;\n  if (typeof value === 'string') return resolveTokens(theme, value) as string;\n  const raw = palette === 'dark' ? (value.dark ?? value.light) : (value.light ?? value.dark);\n  if (raw === undefined) return undefined;\n  return resolveTokens(theme, raw) as string;\n};\n\n/**\n * Resolve a themed value used for CSS `background` (or RN background fill).\n * Supports `$brandGradient:<uuid>` when branding presets are provided; other values match {@link resolveThemedColor}.\n */\nexport const resolveThemedBackground = (\n  theme: Theme | undefined,\n  branding: Branding | undefined,\n  palette: 'light' | 'dark',\n  value: ThemedColor | undefined,\n): string | undefined => {\n  if (value === undefined) return undefined;\n  if (typeof value === 'string') {\n    if (value.startsWith('$brandGradient:')) {\n      return resolveBrandGradientToken(branding, value);\n    }\n    return resolveTokens(theme, value) as string;\n  }\n  const raw = palette === 'dark' ? (value.dark ?? value.light) : (value.light ?? value.dark);\n  if (raw === undefined) return undefined;\n  if (raw.startsWith('$brandGradient:')) {\n    return resolveBrandGradientToken(branding, raw);\n  }\n  return resolveTokens(theme, raw) as string;\n};\n\nexport const nativeBrandBackgroundFromThemedColor = (\n  theme: Theme | undefined,\n  branding: Branding | undefined,\n  palette: 'light' | 'dark',\n  value: ThemedColor | undefined,\n): { solid?: string; linear?: BrandGradientNativeLinear } => {\n  const preset = brandGradientFromThemedColor(branding, palette, value);\n  if (preset) {\n    const lin = brandGradientNativeLinear(preset);\n    if (lin) return { linear: lin };\n    return { solid: brandGradientSolidFallback(preset) };\n  }\n  const bg = resolveThemedBackground(theme, branding, palette, value) as string | undefined;\n  if (!bg) return {};\n  const parsed = parseLinearGradientCss(bg);\n  if (parsed) {\n    return {\n      linear: nativeLinearFromAngleAndStops(\n        parsed.angleDeg,\n        parsed.stops.map((s) => ({ color: s.color, offsetPct: s.offsetPct })),\n      ),\n    };\n  }\n  if (isStoredLinearGradientCss(bg)) {\n    const first = bg.match(/#[0-9a-fA-F]{3,8}/);\n    return { solid: first ? first[0] : '#808080' };\n  }\n  return { solid: bg };\n};\n","import { FIELD_KEY_RE } from '@getrheo/contracts/fields';\nimport type { FlowManifest } from '@getrheo/contracts/manifest';\nimport type { Screen } from '@getrheo/contracts/screens';\nimport type { LocalizedText } from '@getrheo/contracts/localized';\nimport { resolveLocalizedText } from '@getrheo/contracts/localized';\nimport { choiceOptionLabel, findInputLayer } from './layers';\nimport type { StepResponse } from './stateMachine';\n\n/** Runtime substitution for Text layer copy (after locale resolution). */\nexport type InterpolationRuntimeContext = {\n  manifest: FlowManifest;\n  locale: string;\n  responses: Record<string, StepResponse>;\n  customProperties?: Record<string, string>;\n};\n\n/** Props-sized slice passed into renderers. */\nexport type InterpolationContext = {\n  responses: Record<string, StepResponse>;\n  customProperties?: Record<string, string>;\n  /** When true, the flow has a prior step so back navigation is available. */\n  canGoBack?: boolean;\n};\n\nexport const extractLiquidTemplateBodies = (s: string): string[] => {\n  const out: string[] = [];\n  let i = 0;\n  while (i < s.length) {\n    const open = s.indexOf('{{', i);\n    if (open === -1) break;\n    const close = s.indexOf('}}', open + 2);\n    if (close === -1) break;\n    out.push(s.slice(open + 2, close));\n    i = close + 2;\n  }\n  return out;\n};\n\nconst FIELD_KEY_SOURCE = FIELD_KEY_RE.source.replace(/^\\^|\\$$/g, '');\n\nconst parseDefaultFilter = (\n  inner: string,\n): { exprPart: string; defaultValue?: string } => {\n  const m = inner.match(/\\s*\\|\\s*default\\s*:/i);\n  if (!m || m.index === undefined) return { exprPart: inner.trim() };\n\n  const exprPart = inner.slice(0, m.index).trim();\n  let tail = inner.slice(m.index + m[0].length).trim();\n  if (tail.startsWith('\"')) {\n    const end = tail.indexOf('\"', 1);\n    if (end > 0) tail = tail.slice(1, end);\n    else tail = tail.slice(1);\n  }\n  return { exprPart, defaultValue: tail };\n};\n\nconst parseExpression = (\n  exprRaw: string,\n):\n  | { kind: 'custom'; key: string }\n  | { kind: 'field'; fieldKey: string; mode: 'label' | 'id' }\n  | { kind: 'invalid' } => {\n  const expr = exprRaw.trim();\n  const customM = expr.match(new RegExp(`^custom\\\\.(${FIELD_KEY_SOURCE})$`));\n  if (customM) return { kind: 'custom', key: customM[1]! };\n\n  const idM = expr.match(new RegExp(`^(${FIELD_KEY_SOURCE})\\\\.id$`));\n  if (idM) return { kind: 'field', fieldKey: idM[1]!, mode: 'id' };\n\n  const plainM = expr.match(new RegExp(`^(${FIELD_KEY_SOURCE})$`));\n  if (plainM) return { kind: 'field', fieldKey: plainM[1]!, mode: 'label' };\n\n  return { kind: 'invalid' };\n};\n\nexport type InterpolationExprAnalysis =\n  | { kind: 'custom'; key: string }\n  | { kind: 'field'; fieldKey: string; mode: 'label' | 'id' }\n  | { kind: 'invalid' };\n\n/** Parse one `{{ … }}` inner (after stripping delimiters) for diagnostics / validation. */\nexport const analyzeLiquidTemplateInner = (\n  inner: string,\n): { expr: InterpolationExprAnalysis; defaultValue?: string } => {\n  const { exprPart, defaultValue } = parseDefaultFilter(inner);\n  const p = parseExpression(exprPart);\n  if (p.kind === 'invalid') return { expr: { kind: 'invalid' }, defaultValue };\n  if (p.kind === 'custom') return { expr: { kind: 'custom', key: p.key }, defaultValue };\n  return { expr: { kind: 'field', fieldKey: p.fieldKey, mode: p.mode }, defaultValue };\n};\n\nconst findInputOwner = (\n  manifest: FlowManifest,\n  fieldKey: string,\n): { screen: Screen; input: NonNullable<ReturnType<typeof findInputLayer>> } | null => {\n  for (const screen of manifest.screens) {\n    const input = findInputLayer(screen as Screen);\n    if (input && input.fieldKey === fieldKey) return { screen: screen as Screen, input };\n  }\n  return null;\n};\n\nconst choiceLabelFor = (\n  manifest: FlowManifest,\n  fieldKey: string,\n  choiceId: string,\n  locale: string,\n): string => {\n  const owner = findInputOwner(manifest, fieldKey);\n  if (!owner) return '';\n  const { input } = owner;\n  if (input.kind !== 'single_choice' && input.kind !== 'multiple_choice') return '';\n  return choiceOptionLabel(input, choiceId, locale);\n};\n\nconst responseToDisplayString = (\n  manifest: FlowManifest,\n  fieldKey: string,\n  response: StepResponse | undefined,\n  mode: 'label' | 'id',\n  locale: string,\n): string => {\n  if (!response) return '';\n  switch (response.kind) {\n    case 'text':\n      return mode === 'id' ? '' : response.value;\n    case 'scale':\n      return mode === 'id' ? '' : String(response.value);\n    case 'choice':\n      if (mode === 'id') return response.choiceId;\n      return choiceLabelFor(manifest, fieldKey, response.choiceId, locale);\n    case 'multiChoice':\n      if (mode === 'id') return response.choiceIds.join(', ');\n      return response.choiceIds\n        .map((id) => choiceLabelFor(manifest, fieldKey, id, locale))\n        .filter(Boolean)\n        .join(', ');\n    case 'checkbox':\n      return mode === 'id' ? '' : response.value ? 'true' : 'false';\n    case 'bypass_input':\n      return '';\n    default:\n      return '';\n  }\n};\n\nconst evalParsed = (\n  parsed:\n    | { kind: 'custom'; key: string }\n    | { kind: 'field'; fieldKey: string; mode: 'label' | 'id' }\n    | { kind: 'invalid' },\n  ctx: InterpolationRuntimeContext,\n): string => {\n  if (parsed.kind === 'invalid') return '';\n  if (parsed.kind === 'custom') {\n    const v = ctx.customProperties?.[parsed.key];\n    return v === undefined || v === '' ? '' : String(v);\n  }\n  const owner = findInputOwner(ctx.manifest, parsed.fieldKey);\n  const r = ctx.responses[parsed.fieldKey];\n  if (parsed.mode === 'id' && owner && owner.input.kind !== 'single_choice' && owner.input.kind !== 'multiple_choice') {\n    return '';\n  }\n  return responseToDisplayString(ctx.manifest, parsed.fieldKey, r, parsed.mode, ctx.locale);\n};\n\n/**\n * Interpolate `{{ … }}` segments in a plain string (already localized).\n * Supports `custom.key`, `field_key`, `field_key.id`, and `| default: …`.\n */\nexport const interpolateTemplateString = (\n  template: string,\n  ctx: InterpolationRuntimeContext,\n): string => {\n  let i = 0;\n  let out = '';\n  while (i < template.length) {\n    const open = template.indexOf('{{', i);\n    if (open === -1) {\n      out += template.slice(i);\n      break;\n    }\n    out += template.slice(i, open);\n    const close = template.indexOf('}}', open + 2);\n    if (close === -1) {\n      out += template.slice(open);\n      break;\n    }\n    const inner = template.slice(open + 2, close);\n    const { exprPart, defaultValue } = parseDefaultFilter(inner);\n    const parsed = parseExpression(exprPart);\n    let value = evalParsed(parsed, ctx);\n    if ((value === '' || value === undefined) && defaultValue !== undefined) {\n      value = defaultValue;\n    }\n    out += value;\n    i = close + 2;\n  }\n  return out;\n};\n\nexport const resolveAndInterpolateLocalizedText = (\n  text: LocalizedText,\n  ctx: InterpolationRuntimeContext,\n): string => {\n  const localized = resolveLocalizedText(text, ctx.locale);\n  return interpolateTemplateString(localized, ctx);\n};\n"]}

package/dist/layerRotate.d.ts

@@ -0,0 +1,10 @@
+/** Authored layer rotation (CSS `rotate`, RN `transform.rotate`, Swift `rotationEffect`). */
+declare const LAYER_ROTATE_DEG_MIN = -360;
+declare const LAYER_ROTATE_DEG_MAX = 360;
+declare const layerRotateCssTransform: (deg: number | undefined) => string | undefined;
+/** React Native `transform` entry for authored rotation. */
+declare const layerRotateNativeTransform: (deg: number | undefined) => Array<{
+    rotate: string;
+}> | undefined;
+
+export { LAYER_ROTATE_DEG_MAX, LAYER_ROTATE_DEG_MIN, layerRotateCssTransform, layerRotateNativeTransform };

package/dist/layerRotate.js

@@ -0,0 +1,9 @@
+// src/layerRotate.ts
+var LAYER_ROTATE_DEG_MIN = -360;
+var LAYER_ROTATE_DEG_MAX = 360;
+var layerRotateCssTransform = (deg) => deg === void 0 ? void 0 : `rotate(${deg}deg)`;
+var layerRotateNativeTransform = (deg) => deg === void 0 ? void 0 : [{ rotate: `${deg}deg` }];
+
+export { LAYER_ROTATE_DEG_MAX, LAYER_ROTATE_DEG_MIN, layerRotateCssTransform, layerRotateNativeTransform };
+//# sourceMappingURL=layerRotate.js.map
+//# sourceMappingURL=layerRotate.js.map

package/dist/layerRotate.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/layerRotate.ts"],"names":[],"mappings":";AACO,IAAM,oBAAA,GAAuB;AAC7B,IAAM,oBAAA,GAAuB;AAE7B,IAAM,0BAA0B,CAAC,GAAA,KACtC,QAAQ,MAAA,GAAY,MAAA,GAAY,UAAU,GAAG,CAAA,IAAA;AAGxC,IAAM,0BAAA,GAA6B,CACxC,GAAA,KAEA,GAAA,KAAQ,MAAA,GAAY,MAAA,GAAY,CAAC,EAAE,MAAA,EAAQ,CAAA,EAAG,GAAG,CAAA,GAAA,CAAA,EAAO","file":"layerRotate.js","sourcesContent":["/** Authored layer rotation (CSS `rotate`, RN `transform.rotate`, Swift `rotationEffect`). */\nexport const LAYER_ROTATE_DEG_MIN = -360;\nexport const LAYER_ROTATE_DEG_MAX = 360;\n\nexport const layerRotateCssTransform = (deg: number | undefined): string | undefined =>\n  deg === undefined ? undefined : `rotate(${deg}deg)`;\n\n/** React Native `transform` entry for authored rotation. */\nexport const layerRotateNativeTransform = (\n  deg: number | undefined,\n): Array<{ rotate: string }> | undefined =>\n  deg === undefined ? undefined : [{ rotate: `${deg}deg` }];\n"]}

package/dist/layerTypography.d.ts

@@ -0,0 +1,36 @@
+import { Branding } from '@getrheo/contracts/dashboard';
+import { Theme } from '@getrheo/contracts/manifest';
+
+/** Stored on {@link TextStyle.fontFamily} to force the document system stack (ignores `theme.fontFamily`). */
+declare const TEXT_FONT_FAMILY_SYSTEM_UI = "__rheo_system_ui__";
+/** Web sim / builder root stack when no `theme.fontFamily` is set (matches `LayerRenderer` container). */
+declare const WEB_DOCUMENT_FONT_STACK = "-apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, Helvetica, Arial, sans-serif";
+/**
+ * CSS `font-family` for the flow shell so `text` layers with no `fontFamily` inherit the theme body font.
+ */
+declare const resolveWebRootFontFamilyCss: (theme: Theme | undefined) => string | undefined;
+/**
+ * CSS `font-family` for a text layer `div` (undefined layer value → inherit shell).
+ */
+declare const resolveWebTextFontFamilyCss: (layerFont: string | undefined) => string | undefined;
+/**
+ * Inline `@font-face` rules for uploaded branding fonts (web / sim only).
+ */
+declare const brandingWebFontFacesCss: (branding: Branding | undefined) => string;
+/**
+ * Expo / RN registration name for a single uploaded style row (see {@link buildBrandingFontLoadMap}).
+ */
+declare const nativeFontRegistrationNameForStyle: (styleId: string) => string;
+/**
+ * Map of **native font registration name → font file URL** for every branding style that has a `url`.
+ * Pass the result to your host runtime’s font loader (e.g. `expo-font`’s `loadAsync`, a bare-RN native
+ * module, or pre-linked assets). Keys match {@link resolveNativeTextFontFamilyName} after fonts are registered.
+ */
+declare const buildBrandingFontLoadMap: (branding: Branding | null | undefined) => Record<string, string>;
+/**
+ * Resolves the RN `fontFamily` string for a logical family name, preferring a loaded branding file
+ * that matches weight (and falls back to nearest uploaded style with a URL).
+ */
+declare const resolveNativeTextFontFamilyName: (branding: Branding | undefined, logicalFamily: string | undefined, fontWeight: number | undefined) => string | undefined;
+
+export { TEXT_FONT_FAMILY_SYSTEM_UI, WEB_DOCUMENT_FONT_STACK, brandingWebFontFacesCss, buildBrandingFontLoadMap, nativeFontRegistrationNameForStyle, resolveNativeTextFontFamilyName, resolveWebRootFontFamilyCss, resolveWebTextFontFamilyCss };

package/dist/layerTypography.js

@@ -0,0 +1,68 @@
+// src/layerTypography.ts
+var TEXT_FONT_FAMILY_SYSTEM_UI = "__rheo_system_ui__";
+var WEB_DOCUMENT_FONT_STACK = '-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif';
+var quoteCssFamilyName = (name) => {
+  const t = name.trim();
+  if (!t) return "";
+  const safe = /^[-_a-zA-Z0-9]+$/.test(t);
+  return safe ? t : JSON.stringify(t);
+};
+var fontStackWithPrimary = (primary) => primary ? `${primary}, ${WEB_DOCUMENT_FONT_STACK}` : WEB_DOCUMENT_FONT_STACK;
+var resolveWebRootFontFamilyCss = (theme) => {
+  const raw = theme?.fontFamily?.trim();
+  if (!raw) return void 0;
+  if (raw.includes(",")) return raw;
+  return fontStackWithPrimary(quoteCssFamilyName(raw));
+};
+var resolveWebTextFontFamilyCss = (layerFont) => {
+  if (layerFont === TEXT_FONT_FAMILY_SYSTEM_UI) return WEB_DOCUMENT_FONT_STACK;
+  const raw = layerFont?.trim();
+  if (!raw) return void 0;
+  if (raw.includes(",")) return raw;
+  return fontStackWithPrimary(quoteCssFamilyName(raw));
+};
+var brandingWebFontFacesCss = (branding) => {
+  if (!branding?.fontFamilies?.length) return "";
+  const blocks = [];
+  for (const fam of branding.fontFamilies) {
+    const famCss = quoteCssFamilyName(fam.name);
+    for (const st of fam.styles) {
+      if (!st.url?.trim()) continue;
+      const url = JSON.stringify(st.url);
+      blocks.push(
+        `@font-face{font-family:${famCss};src:url(${url});font-weight:${st.weight};font-style:${st.italic ? "italic" : "normal"};font-display:swap;}`
+      );
+    }
+  }
+  return blocks.join("");
+};
+var nativeFontRegistrationNameForStyle = (styleId) => `RheoFont__${styleId}`;
+var buildBrandingFontLoadMap = (branding) => {
+  const map = {};
+  if (!branding?.fontFamilies?.length) return map;
+  for (const fam of branding.fontFamilies) {
+    for (const st of fam.styles) {
+      const u = st.url?.trim();
+      if (!u) continue;
+      map[nativeFontRegistrationNameForStyle(st.id)] = u;
+    }
+  }
+  return map;
+};
+var resolveNativeTextFontFamilyName = (branding, logicalFamily, fontWeight) => {
+  if (!logicalFamily?.trim()) return void 0;
+  if (logicalFamily === TEXT_FONT_FAMILY_SYSTEM_UI) return void 0;
+  const fam = branding?.fontFamilies.find((f) => f.name === logicalFamily);
+  if (!fam) return logicalFamily;
+  const w = fontWeight ?? 400;
+  const withUrl = fam.styles.filter((s) => !!s.url?.trim());
+  if (withUrl.length === 0) return logicalFamily;
+  const exact = withUrl.find((s) => s.weight === w && !s.italic);
+  const st = exact ?? withUrl.find((s) => s.weight === w) ?? withUrl[0];
+  if (!st) return logicalFamily;
+  return nativeFontRegistrationNameForStyle(st.id);
+};
+
+export { TEXT_FONT_FAMILY_SYSTEM_UI, WEB_DOCUMENT_FONT_STACK, brandingWebFontFacesCss, buildBrandingFontLoadMap, nativeFontRegistrationNameForStyle, resolveNativeTextFontFamilyName, resolveWebRootFontFamilyCss, resolveWebTextFontFamilyCss };
+//# sourceMappingURL=layerTypography.js.map
+//# sourceMappingURL=layerTypography.js.map

package/dist/layerTypography.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/layerTypography.ts"],"names":[],"mappings":"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","file":"layerTypography.js","sourcesContent":["import type { Branding } from '@getrheo/contracts/dashboard';\nimport type { Theme } from '@getrheo/contracts/manifest';\n\n/** Stored on {@link TextStyle.fontFamily} to force the document system stack (ignores `theme.fontFamily`). */\nexport const TEXT_FONT_FAMILY_SYSTEM_UI = '__rheo_system_ui__';\n\n/** Web sim / builder root stack when no `theme.fontFamily` is set (matches `LayerRenderer` container). */\nexport const WEB_DOCUMENT_FONT_STACK =\n  '-apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, Helvetica, Arial, sans-serif';\n\nconst quoteCssFamilyName = (name: string): string => {\n  const t = name.trim();\n  if (!t) return '';\n  const safe = /^[-_a-zA-Z0-9]+$/.test(t);\n  return safe ? t : JSON.stringify(t);\n};\n\nconst fontStackWithPrimary = (primary: string | undefined): string =>\n  primary ? `${primary}, ${WEB_DOCUMENT_FONT_STACK}` : WEB_DOCUMENT_FONT_STACK;\n\n/**\n * CSS `font-family` for the flow shell so `text` layers with no `fontFamily` inherit the theme body font.\n */\nexport const resolveWebRootFontFamilyCss = (theme: Theme | undefined): string | undefined => {\n  const raw = theme?.fontFamily?.trim();\n  if (!raw) return undefined;\n  if (raw.includes(',')) return raw;\n  return fontStackWithPrimary(quoteCssFamilyName(raw));\n};\n\n/**\n * CSS `font-family` for a text layer `div` (undefined layer value → inherit shell).\n */\nexport const resolveWebTextFontFamilyCss = (layerFont: string | undefined): string | undefined => {\n  if (layerFont === TEXT_FONT_FAMILY_SYSTEM_UI) return WEB_DOCUMENT_FONT_STACK;\n  const raw = layerFont?.trim();\n  if (!raw) return undefined;\n  if (raw.includes(',')) return raw;\n  return fontStackWithPrimary(quoteCssFamilyName(raw));\n};\n\n/**\n * Inline `@font-face` rules for uploaded branding fonts (web / sim only).\n */\nexport const brandingWebFontFacesCss = (branding: Branding | undefined): string => {\n  if (!branding?.fontFamilies?.length) return '';\n  const blocks: string[] = [];\n  for (const fam of branding.fontFamilies) {\n    const famCss = quoteCssFamilyName(fam.name);\n    for (const st of fam.styles) {\n      if (!st.url?.trim()) continue;\n      const url = JSON.stringify(st.url);\n      blocks.push(\n        `@font-face{font-family:${famCss};src:url(${url});font-weight:${st.weight};font-style:${st.italic ? 'italic' : 'normal'};font-display:swap;}`,\n      );\n    }\n  }\n  return blocks.join('');\n};\n\n/**\n * Expo / RN registration name for a single uploaded style row (see {@link buildBrandingFontLoadMap}).\n */\nexport const nativeFontRegistrationNameForStyle = (styleId: string): string => `RheoFont__${styleId}`;\n\n/**\n * Map of **native font registration name → font file URL** for every branding style that has a `url`.\n * Pass the result to your host runtime’s font loader (e.g. `expo-font`’s `loadAsync`, a bare-RN native\n * module, or pre-linked assets). Keys match {@link resolveNativeTextFontFamilyName} after fonts are registered.\n */\nexport const buildBrandingFontLoadMap = (\n  branding: Branding | null | undefined,\n): Record<string, string> => {\n  const map: Record<string, string> = {};\n  if (!branding?.fontFamilies?.length) return map;\n  for (const fam of branding.fontFamilies) {\n    for (const st of fam.styles) {\n      const u = st.url?.trim();\n      if (!u) continue;\n      map[nativeFontRegistrationNameForStyle(st.id)] = u;\n    }\n  }\n  return map;\n};\n\n/**\n * Resolves the RN `fontFamily` string for a logical family name, preferring a loaded branding file\n * that matches weight (and falls back to nearest uploaded style with a URL).\n */\nexport const resolveNativeTextFontFamilyName = (\n  branding: Branding | undefined,\n  logicalFamily: string | undefined,\n  fontWeight: number | undefined,\n): string | undefined => {\n  if (!logicalFamily?.trim()) return undefined;\n  if (logicalFamily === TEXT_FONT_FAMILY_SYSTEM_UI) return undefined;\n  const fam = branding?.fontFamilies.find((f) => f.name === logicalFamily);\n  if (!fam) return logicalFamily;\n  const w = fontWeight ?? 400;\n  const withUrl = fam.styles.filter((s) => !!s.url?.trim());\n  if (withUrl.length === 0) return logicalFamily;\n  const exact = withUrl.find((s) => s.weight === w && !s.italic);\n  const st = exact ?? withUrl.find((s) => s.weight === w) ?? withUrl[0];\n  if (!st) return logicalFamily;\n  return nativeFontRegistrationNameForStyle(st.id);\n};\n"]}

package/dist/layers.d.ts

@@ -0,0 +1,69 @@
+import { Branding } from '@getrheo/contracts/dashboard';
+import { FlowManifest, Theme } from '@getrheo/contracts/manifest';
+import { Screen } from '@getrheo/contracts/screens';
+import { BrandGradientNativeLinear } from './brandGradient.js';
+import { SingleChoiceLayer, MultipleChoiceLayer, InputLayer, Layer, TextInputLayer, ScaleInputLayer, StackLayer, ThemedColor } from '@getrheo/contracts/layers';
+
+/** Walk a layer tree depth-first. */
+declare const walkLayers: (root: Layer, fn: (l: Layer, depth: number) => void) => void;
+/** Walk every layer in a screen's regions (header → body → footer). */
+declare const walkScreen: (screen: Screen, fn: (l: Layer) => void) => void;
+/** Find the screen's lone input layer (if any). Schema enforces ≤1. */
+declare const findInputLayer: (screen: Screen) => InputLayer | null;
+/** Input kinds that use a screen draft and require an explicit Continue to submit. */
+declare const findManualSubmitInputLayer: (screen: Screen) => MultipleChoiceLayer | TextInputLayer | ScaleInputLayer | null;
+/**
+ * Whether the screen contains any Button layer that submits the screen
+ * (i.e. `action.kind === 'continue'`). Used by input layers to decide
+ * between auto-submit-on-tap (legacy behaviour for choice-only screens)
+ * and writing into the screen-level draft for a Button to submit.
+ */
+declare const screenHasContinueButton: (screen: Screen) => boolean;
+/**
+ * Resolve a choice layer's option stack by stable optionId via its
+ * binding. Returns null when the binding is missing or the bound child
+ * was removed (manifest validation rejects that, but runtime stays safe).
+ */
+declare const findOptionStackForChoice: (layer: SingleChoiceLayer | MultipleChoiceLayer, optionId: string) => StackLayer | null;
+/**
+ * Best-effort textual label for a choice option, used by interpolation
+ * (e.g. `{{ goal }}` rendering the chosen option's label) and by editor
+ * surfaces that show option rows. Walks the option's child subtree
+ * depth-first and returns the first `text` layer's content; falls back
+ * to the option's stable id when no text is present.
+ */
+declare const choiceOptionLabel: (layer: SingleChoiceLayer | MultipleChoiceLayer, optionId: string, locale: string) => string;
+/** Find a layer in a screen by id, including nested children/slides. */
+declare const findLayerById: (screen: Screen, id: string) => Layer | null;
+/** Collect all input fieldKeys across a manifest. */
+declare const collectFieldKeys: (manifest: FlowManifest) => {
+    fieldKey: string;
+    screenId: string;
+}[];
+/**
+ * Pick a snake_case field key starting from `base` that is not in `used`
+ * (e.g. `text` → `text_2` → `text_3` when `text` is taken).
+ */
+declare const nextUniqueFieldKey: (base: string, used: Iterable<string>) => string;
+/**
+ * Resolve a token reference like `$primary` to a literal value from `theme`.
+ * Pass-through for non-token strings; returns undefined for `undefined`.
+ */
+declare const resolveTokens: <T extends string | undefined>(theme: Theme | undefined, value: T) => T | string;
+/**
+ * Resolve a layer color for the current appearance (`light` | `dark`).
+ * Plain string uses `resolveTokens` for both modes (legacy). Object form
+ * picks `light` / `dark` with fallback to the other key when one is omitted.
+ */
+declare const resolveThemedColor: (theme: Theme | undefined, palette: "light" | "dark", value: ThemedColor | undefined) => string | undefined;
+/**
+ * Resolve a themed value used for CSS `background` (or RN background fill).
+ * Supports `$brandGradient:<uuid>` when branding presets are provided; other values match {@link resolveThemedColor}.
+ */
+declare const resolveThemedBackground: (theme: Theme | undefined, branding: Branding | undefined, palette: "light" | "dark", value: ThemedColor | undefined) => string | undefined;
+declare const nativeBrandBackgroundFromThemedColor: (theme: Theme | undefined, branding: Branding | undefined, palette: "light" | "dark", value: ThemedColor | undefined) => {
+    solid?: string;
+    linear?: BrandGradientNativeLinear;
+};
+
+export { choiceOptionLabel, collectFieldKeys, findInputLayer, findLayerById, findManualSubmitInputLayer, findOptionStackForChoice, nativeBrandBackgroundFromThemedColor, nextUniqueFieldKey, resolveThemedBackground, resolveThemedColor, resolveTokens, screenHasContinueButton, walkLayers, walkScreen };