@getrheo/flow-runtime 1.0.0

package/dist/manifestBillingSlice.js

@@ -0,0 +1,102 @@
+import '@getrheo/contracts/localized';
+import '@getrheo/contracts/layers';
+
+// src/layers.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);
+};
+
+// src/manifestBillingSlice.ts
+var cloneManifestForBillingSlice = (m) => structuredClone(m);
+var stripRestingMotionFromLayer = (layer) => {
+  const l = layer;
+  delete l.restingMotion;
+  delete l.restingMotions;
+};
+var stripManifestAnimations = (manifest) => {
+  const next = cloneManifestForBillingSlice(manifest);
+  for (const screen of next.screens) {
+    const s = screen;
+    delete s.animations;
+    delete s.stagger;
+  }
+  return next;
+};
+var stripManifestMotion = (manifest) => {
+  const next = stripManifestAnimations(manifest);
+  for (const screen of next.screens) {
+    walkScreen(screen, stripRestingMotionFromLayer);
+  }
+  return next;
+};
+var collapseLocalizedObjects = (node) => {
+  if (node === null || node === void 0) return;
+  if (Array.isArray(node)) {
+    for (const x of node) collapseLocalizedObjects(x);
+    return;
+  }
+  if (typeof node !== "object") return;
+  const o = node;
+  if (typeof o.default === "string" && Object.prototype.hasOwnProperty.call(o, "translations")) {
+    delete o.translations;
+  }
+  for (const v of Object.values(o)) collapseLocalizedObjects(v);
+};
+var collapseManifestToDefaultLocaleOnly = (manifest) => {
+  const next = cloneManifestForBillingSlice(manifest);
+  collapseLocalizedObjects(next);
+  next.locales = [next.defaultLocale];
+  return next;
+};
+var manifestHasScreenAnimations = (manifest) => manifest.screens.some((s) => {
+  const anim = s.animations;
+  return Array.isArray(anim) && anim.length > 0;
+});
+var recordHasNonEmptyTranslations = (node) => {
+  if (node === null || node === void 0) return false;
+  if (Array.isArray(node)) return node.some(recordHasNonEmptyTranslations);
+  if (typeof node !== "object") return false;
+  const o = node;
+  const tr = o.translations;
+  if (tr && typeof tr === "object" && Object.keys(tr).length > 0) return true;
+  return Object.values(o).some(recordHasNonEmptyTranslations);
+};
+var manifestUsesTranslationsBeyondDefault = (manifest) => {
+  if (manifest.locales.length > 1) return true;
+  return recordHasNonEmptyTranslations(manifest);
+};
+var manifestUsesExternalIntegrations = (manifest) => (manifest.externalSurfaceNodes ?? []).some(
+  (n) => n.config?.provider != null && n.config.provider !== "unspecified"
+);
+
+export { cloneManifestForBillingSlice, collapseManifestToDefaultLocaleOnly, manifestHasScreenAnimations, manifestUsesExternalIntegrations, manifestUsesTranslationsBeyondDefault, stripManifestAnimations, stripManifestMotion };
+//# sourceMappingURL=manifestBillingSlice.js.map
+//# sourceMappingURL=manifestBillingSlice.js.map

package/dist/manifestBillingSlice.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/layers.ts","../src/manifestBillingSlice.ts"],"names":[],"mappings":"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","file":"manifestBillingSlice.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 type { Layer } from '@getrheo/contracts/layers';\nimport type { FlowManifest } from '@getrheo/contracts/manifest';\nimport { walkScreen } from './layers.js';\n\n/** Deep clone manifest JSON shape for SDK responses. */\nexport const cloneManifestForBillingSlice = (m: FlowManifest): FlowManifest =>\n  structuredClone(m) as FlowManifest;\n\nconst stripRestingMotionFromLayer = (layer: Layer): void => {\n  const l = layer as { restingMotion?: unknown; restingMotions?: unknown };\n  delete l.restingMotion;\n  delete l.restingMotions;\n};\n\n/** Removes per-screen animation clips (timeline / transitions). */\nexport const stripManifestAnimations = (manifest: FlowManifest): FlowManifest => {\n  const next = cloneManifestForBillingSlice(manifest);\n  for (const screen of next.screens) {\n    const s = screen as { animations?: unknown; stagger?: unknown };\n    delete s.animations;\n    delete s.stagger;\n  }\n  return next;\n};\n\n/** Removes screen clips, stagger defaults, and per-layer resting motion. */\nexport const stripManifestMotion = (manifest: FlowManifest): FlowManifest => {\n  const next = stripManifestAnimations(manifest);\n  for (const screen of next.screens) {\n    walkScreen(screen, stripRestingMotionFromLayer);\n  }\n  return next;\n};\n\nconst collapseLocalizedObjects = (node: unknown): void => {\n  if (node === null || node === undefined) return;\n  if (Array.isArray(node)) {\n    for (const x of node) collapseLocalizedObjects(x);\n    return;\n  }\n  if (typeof node !== 'object') return;\n  const o = node as Record<string, unknown>;\n  if (\n    typeof o.default === 'string' &&\n    Object.prototype.hasOwnProperty.call(o, 'translations')\n  ) {\n    delete o.translations;\n  }\n  for (const v of Object.values(o)) collapseLocalizedObjects(v);\n};\n\n/** Drops `translations` on every LocalizedText-shaped object; trims locales list to default only. */\nexport const collapseManifestToDefaultLocaleOnly = (manifest: FlowManifest): FlowManifest => {\n  const next = cloneManifestForBillingSlice(manifest);\n  collapseLocalizedObjects(next);\n  next.locales = [next.defaultLocale];\n  return next;\n};\n\nexport const manifestHasScreenAnimations = (manifest: FlowManifest): boolean =>\n  manifest.screens.some((s) => {\n    const anim = (s as { animations?: unknown }).animations;\n    return Array.isArray(anim) && anim.length > 0;\n  });\n\nconst recordHasNonEmptyTranslations = (node: unknown): boolean => {\n  if (node === null || node === undefined) return false;\n  if (Array.isArray(node)) return node.some(recordHasNonEmptyTranslations);\n  if (typeof node !== 'object') return false;\n  const o = node as Record<string, unknown>;\n  const tr = o.translations;\n  if (tr && typeof tr === 'object' && Object.keys(tr as object).length > 0) return true;\n  return Object.values(o).some(recordHasNonEmptyTranslations);\n};\n\n/** True when manifest carries locale variants editors expect Grow+ for. */\nexport const manifestUsesTranslationsBeyondDefault = (manifest: FlowManifest): boolean => {\n  if (manifest.locales.length > 1) return true;\n  return recordHasNonEmptyTranslations(manifest);\n};\n\n/** True when manifest includes an external integration step with a concrete provider (Grow+). */\nexport const manifestUsesExternalIntegrations = (manifest: FlowManifest): boolean =>\n  (manifest.externalSurfaceNodes ?? []).some(\n    (n) => n.config?.provider != null && n.config.provider !== 'unspecified',\n  );\n"]}

package/dist/prepareAiGeneratedScreen.d.ts

@@ -0,0 +1,17 @@
+import { FlowManifest } from '@getrheo/contracts/manifest';
+import { Screen } from '@getrheo/contracts/screens';
+
+/** All layer ids across every screen (manifest-level uniqueness). */
+declare const collectManifestLayerIds: (manifest: FlowManifest) => Set<string>;
+/**
+ * Rewrites the screen's id and every layer id so they cannot collide with an existing manifest.
+ * Uses JSON substitution with longest-id-first ordering to avoid partial replacements.
+ */
+declare const remapScreenIdsForManifestIngest: (manifest: FlowManifest, screen: Screen) => Screen;
+/**
+ * After in-place AI screen replace, ensure layer ids are unique across the manifest:
+ * forbidden = ids used on other screens; duplicate ids within the replacement tree are remapped.
+ */
+declare const remapReplacedScreenLayerCollisionsInManifest: (manifest: FlowManifest, targetScreenId: string, screen: Screen) => Screen;
+
+export { collectManifestLayerIds, remapReplacedScreenLayerCollisionsInManifest, remapScreenIdsForManifestIngest };

package/dist/prepareAiGeneratedScreen.js

@@ -0,0 +1,99 @@
+import { walkScreenLayers } from '@getrheo/contracts/screens';
+
+// src/prepareAiGeneratedScreen.ts
+var randomHex = (byteLength) => {
+  const bytes = new Uint8Array(byteLength);
+  if (typeof globalThis.crypto?.getRandomValues === "function") {
+    globalThis.crypto.getRandomValues(bytes);
+  } else {
+    for (let i = 0; i < byteLength; i++) bytes[i] = Math.floor(Math.random() * 256);
+  }
+  return [...bytes].map((b) => b.toString(16).padStart(2, "0")).join("");
+};
+var collectManifestLayerIds = (manifest) => {
+  const ids = /* @__PURE__ */ new Set();
+  for (const s of manifest.screens) {
+    walkScreenLayers(s, (l) => {
+      ids.add(l.id);
+    });
+  }
+  return ids;
+};
+var remapScreenIdsForManifestIngest = (manifest, screen) => {
+  const screenIds = new Set(manifest.screens.map((s) => s.id));
+  let newScreenId = `scr_ai_${randomHex(4)}`;
+  let sn = 0;
+  while (screenIds.has(newScreenId)) {
+    newScreenId = `scr_ai_${randomHex(4)}_${sn++}`.slice(0, 64);
+  }
+  const usedLayers = collectManifestLayerIds(manifest);
+  const token = randomHex(3);
+  const map = /* @__PURE__ */ new Map();
+  walkScreenLayers(screen, (l) => {
+    if (map.has(l.id)) return;
+    const tail = l.id.replace(/^lyr_/i, "").replace(/[^a-z0-9_]/gi, "_") || "layer";
+    let nid = `lyr_ai_${token}_${tail}`;
+    let i = 0;
+    for (; ; ) {
+      const taken = usedLayers.has(nid) || [...map.values()].some((v) => v === nid);
+      if (!taken) break;
+      i += 1;
+      nid = `lyr_ai_${token}_${tail}_${i}`.slice(0, 64);
+    }
+    map.set(l.id, nid);
+    usedLayers.add(nid);
+  });
+  let json = JSON.stringify({ ...screen, id: newScreenId });
+  const pairs = [...map.entries()].sort((a, b) => b[0].length - a[0].length);
+  for (const [oldId, newId] of pairs) {
+    json = json.split(oldId).join(newId);
+  }
+  return JSON.parse(json);
+};
+var remapReplacedScreenLayerCollisionsInManifest = (manifest, targetScreenId, screen) => {
+  const forbidden = /* @__PURE__ */ new Set();
+  for (const s of manifest.screens) {
+    if (s.id === targetScreenId) continue;
+    walkScreenLayers(s, (l) => forbidden.add(l.id));
+  }
+  const next = JSON.parse(JSON.stringify(screen));
+  const seen = /* @__PURE__ */ new Set();
+  const used = new Set(forbidden);
+  const alloc = () => {
+    let i = 0;
+    for (; ; ) {
+      const nid = `lyr_ai_${randomHex(4)}_${i++}`.slice(0, 64);
+      if (!used.has(nid)) {
+        used.add(nid);
+        return nid;
+      }
+    }
+  };
+  const fix = (layer) => {
+    if (forbidden.has(layer.id) || seen.has(layer.id)) {
+      layer.id = alloc();
+    }
+    seen.add(layer.id);
+    if (layer.kind === "stack") layer.children.forEach(fix);
+    else if (layer.kind === "carousel") layer.slides.forEach(fix);
+    else if (layer.kind === "button" || layer.kind === "back_button") layer.children.forEach(fix);
+    else if (layer.kind === "hyperlink") layer.children.forEach(fix);
+    else if (layer.kind === "single_choice" || layer.kind === "multiple_choice") {
+      layer.children.forEach(fix);
+    } else if (layer.kind === "text_input" || layer.kind === "scale_input") {
+      layer.children?.forEach(fix);
+    } else if (layer.kind === "oauth_login") layer.children.forEach(fix);
+    else if (layer.kind === "oauth_provider" && layer.variant === "custom") layer.children.forEach(fix);
+    else if (layer.kind === "email_password_auth") layer.children.forEach(fix);
+    else if (layer.kind === "email_password_field") layer.children?.forEach(fix);
+    else if (layer.kind === "email_password_submit") layer.children.forEach(fix);
+  };
+  if (next.regions.header) fix(next.regions.header);
+  fix(next.regions.body);
+  if (next.regions.footer) fix(next.regions.footer);
+  return next;
+};
+
+export { collectManifestLayerIds, remapReplacedScreenLayerCollisionsInManifest, remapScreenIdsForManifestIngest };
+//# sourceMappingURL=prepareAiGeneratedScreen.js.map
+//# sourceMappingURL=prepareAiGeneratedScreen.js.map

package/dist/prepareAiGeneratedScreen.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/prepareAiGeneratedScreen.ts"],"names":[],"mappings":"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","file":"prepareAiGeneratedScreen.js","sourcesContent":["import type { Layer } from '@getrheo/contracts/layers';\nimport type { FlowManifest } from '@getrheo/contracts/manifest';\nimport type { Screen } from '@getrheo/contracts/screens';\nimport { walkScreenLayers } from '@getrheo/contracts/screens';\n\nconst randomHex = (byteLength: number): string => {\n  const bytes = new Uint8Array(byteLength);\n  if (typeof globalThis.crypto?.getRandomValues === 'function') {\n    globalThis.crypto.getRandomValues(bytes);\n  } else {\n    for (let i = 0; i < byteLength; i++) bytes[i] = Math.floor(Math.random() * 256);\n  }\n  return [...bytes].map((b) => b.toString(16).padStart(2, '0')).join('');\n};\n\n/** All layer ids across every screen (manifest-level uniqueness). */\nexport const collectManifestLayerIds = (manifest: FlowManifest): Set<string> => {\n  const ids = new Set<string>();\n  for (const s of manifest.screens) {\n    walkScreenLayers(s, (l) => {\n      ids.add(l.id);\n    });\n  }\n  return ids;\n};\n\n/**\n * Rewrites the screen's id and every layer id so they cannot collide with an existing manifest.\n * Uses JSON substitution with longest-id-first ordering to avoid partial replacements.\n */\nexport const remapScreenIdsForManifestIngest = (\n  manifest: FlowManifest,\n  screen: Screen,\n): Screen => {\n  const screenIds = new Set(manifest.screens.map((s) => s.id));\n  let newScreenId = `scr_ai_${randomHex(4)}`;\n  let sn = 0;\n  while (screenIds.has(newScreenId)) {\n    newScreenId = `scr_ai_${randomHex(4)}_${sn++}`.slice(0, 64);\n  }\n\n  const usedLayers = collectManifestLayerIds(manifest);\n  const token = randomHex(3);\n  const map = new Map<string, string>();\n\n  walkScreenLayers(screen, (l) => {\n    if (map.has(l.id)) return;\n    const tail = l.id.replace(/^lyr_/i, '').replace(/[^a-z0-9_]/gi, '_') || 'layer';\n    let nid = `lyr_ai_${token}_${tail}`;\n    let i = 0;\n    for (;;) {\n      const taken =\n        usedLayers.has(nid) || [...map.values()].some((v) => v === nid);\n      if (!taken) break;\n      i += 1;\n      nid = `lyr_ai_${token}_${tail}_${i}`.slice(0, 64);\n    }\n    map.set(l.id, nid);\n    usedLayers.add(nid);\n  });\n\n  let json = JSON.stringify({ ...screen, id: newScreenId });\n  const pairs = [...map.entries()].sort((a, b) => b[0].length - a[0].length);\n  for (const [oldId, newId] of pairs) {\n    json = json.split(oldId).join(newId);\n  }\n  return JSON.parse(json) as Screen;\n};\n\n/**\n * After in-place AI screen replace, ensure layer ids are unique across the manifest:\n * forbidden = ids used on other screens; duplicate ids within the replacement tree are remapped.\n */\nexport const remapReplacedScreenLayerCollisionsInManifest = (\n  manifest: FlowManifest,\n  targetScreenId: string,\n  screen: Screen,\n): Screen => {\n  const forbidden = new Set<string>();\n  for (const s of manifest.screens) {\n    if (s.id === targetScreenId) continue;\n    walkScreenLayers(s, (l) => forbidden.add(l.id));\n  }\n\n  const next = JSON.parse(JSON.stringify(screen)) as Screen;\n  const seen = new Set<string>();\n  const used = new Set(forbidden);\n\n  const alloc = (): string => {\n    let i = 0;\n    for (;;) {\n      const nid = `lyr_ai_${randomHex(4)}_${i++}`.slice(0, 64);\n      if (!used.has(nid)) {\n        used.add(nid);\n        return nid;\n      }\n    }\n  };\n\n  const fix = (layer: Layer): void => {\n    if (forbidden.has(layer.id) || seen.has(layer.id)) {\n      layer.id = alloc();\n    }\n    seen.add(layer.id);\n\n    if (layer.kind === 'stack') layer.children.forEach(fix);\n    else if (layer.kind === 'carousel') layer.slides.forEach(fix);\n    else if (layer.kind === 'button' || layer.kind === 'back_button') layer.children.forEach(fix);\n    else if (layer.kind === 'hyperlink') layer.children.forEach(fix);\n    else if (layer.kind === 'single_choice' || layer.kind === 'multiple_choice') {\n      layer.children.forEach(fix);\n    } else if (layer.kind === 'text_input' || layer.kind === 'scale_input') {\n      layer.children?.forEach(fix);\n    } else if (layer.kind === 'oauth_login') layer.children.forEach(fix);\n    else if (layer.kind === 'oauth_provider' && layer.variant === 'custom') layer.children.forEach(fix);\n    else if (layer.kind === 'email_password_auth') layer.children.forEach(fix);\n    else if (layer.kind === 'email_password_field') layer.children?.forEach(fix);\n    else if (layer.kind === 'email_password_submit') layer.children.forEach(fix);\n  };\n\n  if (next.regions.header) fix(next.regions.header);\n  fix(next.regions.body);\n  if (next.regions.footer) fix(next.regions.footer);\n  return next;\n};\n"]}

package/dist/publish-exports.json

@@ -0,0 +1,166 @@
+[
+  {
+    "exportKey": ".",
+    "distFile": "./dist/index.js"
+  },
+  {
+    "exportKey": "./agentPrompt",
+    "distFile": "./dist/agentPrompt/index.js"
+  },
+  {
+    "exportKey": "./animations",
+    "distFile": "./dist/animations.js"
+  },
+  {
+    "exportKey": "./buttonVariantChrome",
+    "distFile": "./dist/buttonVariantChrome.js"
+  },
+  {
+    "exportKey": "./counterLayer",
+    "distFile": "./dist/counterLayer.js"
+  },
+  {
+    "exportKey": "./emailPasswordAuthValidation",
+    "distFile": "./dist/emailPasswordAuthValidation.js"
+  },
+  {
+    "exportKey": "./hyperlinkLabel",
+    "distFile": "./dist/hyperlinkLabel.js"
+  },
+  {
+    "exportKey": "./interpolateTemplate",
+    "distFile": "./dist/interpolateTemplate.js"
+  },
+  {
+    "exportKey": "./layerTypography",
+    "distFile": "./dist/layerTypography.js"
+  },
+  {
+    "exportKey": "./layers",
+    "distFile": "./dist/layers.js"
+  },
+  {
+    "exportKey": "./layout",
+    "distFile": "./dist/layout/index.js"
+  },
+  {
+    "exportKey": "./responsive",
+    "distFile": "./dist/responsive/index.js"
+  },
+  {
+    "exportKey": "./responsive/breakpoints",
+    "distFile": "./dist/responsive/breakpoints.js"
+  },
+  {
+    "exportKey": "./responsive/layerResolve",
+    "distFile": "./dist/responsive/layerResolve.js"
+  },
+  {
+    "exportKey": "./responsive/merge",
+    "distFile": "./dist/responsive/merge.js"
+  },
+  {
+    "exportKey": "./responsive/previewSafeAreaInsets",
+    "distFile": "./dist/responsive/previewSafeAreaInsets.js"
+  },
+  {
+    "exportKey": "./responsive/screenContainerResolve",
+    "distFile": "./dist/responsive/screenContainerResolve.js"
+  },
+  {
+    "exportKey": "./responsive/screenShellInsets",
+    "distFile": "./dist/responsive/screenShellInsets.js"
+  },
+  {
+    "exportKey": "./restingMotion",
+    "distFile": "./dist/restingMotion.js"
+  },
+  {
+    "exportKey": "./scaleValidation",
+    "distFile": "./dist/scaleValidation.js"
+  },
+  {
+    "exportKey": "./stateMachine",
+    "distFile": "./dist/stateMachine.js"
+  },
+  {
+    "exportKey": "./textInputValidation",
+    "distFile": "./dist/textInputValidation.js"
+  },
+  {
+    "exportKey": "./aiFlowGenerationMerge",
+    "distFile": "./dist/aiFlowGenerationMerge.js"
+  },
+  {
+    "exportKey": "./assignment",
+    "distFile": "./dist/assignment.js"
+  },
+  {
+    "exportKey": "./brandGradient",
+    "distFile": "./dist/brandGradient.js"
+  },
+  {
+    "exportKey": "./brandGradientManifestIssues",
+    "distFile": "./dist/brandGradientManifestIssues.js"
+  },
+  {
+    "exportKey": "./buildFlowPreview",
+    "distFile": "./dist/buildFlowPreview.js"
+  },
+  {
+    "exportKey": "./checkboxGlyphStyle",
+    "distFile": "./dist/checkboxGlyphStyle.js"
+  },
+  {
+    "exportKey": "./choiceOptionSelection",
+    "distFile": "./dist/choiceOptionSelection.js"
+  },
+  {
+    "exportKey": "./colorAlpha",
+    "distFile": "./dist/colorAlpha.js"
+  },
+  {
+    "exportKey": "./decisionEval",
+    "distFile": "./dist/decisionEval.js"
+  },
+  {
+    "exportKey": "./dropShadow",
+    "distFile": "./dist/dropShadow.js"
+  },
+  {
+    "exportKey": "./flowBuilderRules",
+    "distFile": "./dist/flowBuilderRules.js"
+  },
+  {
+    "exportKey": "./flowGraph",
+    "distFile": "./dist/flowGraph.js"
+  },
+  {
+    "exportKey": "./layerRotate",
+    "distFile": "./dist/layerRotate.js"
+  },
+  {
+    "exportKey": "./manifestBillingSlice",
+    "distFile": "./dist/manifestBillingSlice.js"
+  },
+  {
+    "exportKey": "./prepareAiGeneratedScreen",
+    "distFile": "./dist/prepareAiGeneratedScreen.js"
+  },
+  {
+    "exportKey": "./rheoAgentManifestMerge",
+    "distFile": "./dist/rheoAgentManifestMerge.js"
+  },
+  {
+    "exportKey": "./scaleInputStyle",
+    "distFile": "./dist/scaleInputStyle.js"
+  },
+  {
+    "exportKey": "./translationPlaceholders",
+    "distFile": "./dist/translationPlaceholders.js"
+  },
+  {
+    "exportKey": "./validation",
+    "distFile": "./dist/validation.js"
+  }
+]

package/dist/responsive/breakpoints.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Tailwind CSS default `screens` min-width values (px). Single source of truth
+ * for preview buckets, manifest breakpoints, and runtime style resolution.
+ *
+ * @see https://tailwindcss.com/docs/screens
+ */
+declare const TAILWIND_DEFAULT_BREAKPOINTS: {
+    readonly sm: 640;
+    readonly md: 768;
+    readonly lg: 1024;
+    readonly xl: 1280;
+    readonly '2xl': 1536;
+};
+/** Viewport classification used by preview UI and editing scope. */
+type ScreenSizeBucket = 'default' | 'sm' | 'md' | 'lg' | 'xl' | '2xl';
+/** Ordered keys stored on layers (`styleBreakpoints`) and merged mobile-first. */
+declare const STYLE_BREAKPOINT_MERGE_ORDER: readonly ["sm", "md", "lg", "xl", "2xl"];
+type StyleBreakpointKey = (typeof STYLE_BREAKPOINT_MERGE_ORDER)[number];
+declare const SCREEN_SIZE_BUCKET_ORDER: readonly ScreenSizeBucket[];
+/** Buckets shown in the flow builder inspector (xl / 2xl omitted from authoring UI). */
+declare const BUILDER_INSPECTOR_BUCKET_ORDER: readonly ScreenSizeBucket[];
+/** Human-readable bucket titles; ranges lie between consecutive breakpoints. */
+declare const SCREEN_SIZE_BUCKET_LABEL: Record<ScreenSizeBucket, string>;
+/** Fallback viewport width when no `previewWidthPx` is passed (simulator / static previews). */
+declare const DEFAULT_PREVIEW_VIEWPORT_WIDTH_PX = 390;
+/** Maps viewport width (CSS px) to the Tailwind viewport bucket. */
+declare const getScreenSizeBucketForWidth: (width: number) => ScreenSizeBucket;
+/**
+ * Breakpoint keys whose partials apply at this width (mobile-first), e.g.
+ * width 800 → `['sm','md']`.
+ */
+declare const getActiveStyleBreakpointChain: (widthPx: number) => StyleBreakpointKey[];
+
+export { BUILDER_INSPECTOR_BUCKET_ORDER, DEFAULT_PREVIEW_VIEWPORT_WIDTH_PX, SCREEN_SIZE_BUCKET_LABEL, SCREEN_SIZE_BUCKET_ORDER, STYLE_BREAKPOINT_MERGE_ORDER, type ScreenSizeBucket, type StyleBreakpointKey, TAILWIND_DEFAULT_BREAKPOINTS, getActiveStyleBreakpointChain, getScreenSizeBucketForWidth };

package/dist/responsive/breakpoints.js

@@ -0,0 +1,52 @@
+// src/responsive/breakpoints.ts
+var TAILWIND_DEFAULT_BREAKPOINTS = {
+  sm: 640,
+  md: 768,
+  lg: 1024,
+  xl: 1280,
+  "2xl": 1536
+};
+var STYLE_BREAKPOINT_MERGE_ORDER = ["sm", "md", "lg", "xl", "2xl"];
+var SCREEN_SIZE_BUCKET_ORDER = [
+  "default",
+  "sm",
+  "md",
+  "lg",
+  "xl",
+  "2xl"
+];
+var BUILDER_INSPECTOR_BUCKET_ORDER = [
+  "default",
+  "sm",
+  "md",
+  "lg"
+];
+var SCREEN_SIZE_BUCKET_LABEL = {
+  default: "Default (< 640px)",
+  sm: "sm (640\u2013767px)",
+  md: "md (768\u20131023px)",
+  lg: "lg (1024\u20131279px)",
+  xl: "xl (1280\u20131535px)",
+  "2xl": "2xl (1536px+)"
+};
+var DEFAULT_PREVIEW_VIEWPORT_WIDTH_PX = 390;
+var getScreenSizeBucketForWidth = (width) => {
+  const { sm, md, lg, xl, "2xl": xxl } = TAILWIND_DEFAULT_BREAKPOINTS;
+  if (width < sm) return "default";
+  if (width < md) return "sm";
+  if (width < lg) return "md";
+  if (width < xl) return "lg";
+  if (width < xxl) return "xl";
+  return "2xl";
+};
+var getActiveStyleBreakpointChain = (widthPx) => {
+  const bucket = getScreenSizeBucketForWidth(widthPx);
+  if (bucket === "default") return [];
+  const idx = STYLE_BREAKPOINT_MERGE_ORDER.indexOf(bucket);
+  if (idx < 0) return [];
+  return STYLE_BREAKPOINT_MERGE_ORDER.slice(0, idx + 1);
+};
+
+export { BUILDER_INSPECTOR_BUCKET_ORDER, DEFAULT_PREVIEW_VIEWPORT_WIDTH_PX, SCREEN_SIZE_BUCKET_LABEL, SCREEN_SIZE_BUCKET_ORDER, STYLE_BREAKPOINT_MERGE_ORDER, TAILWIND_DEFAULT_BREAKPOINTS, getActiveStyleBreakpointChain, getScreenSizeBucketForWidth };
+//# sourceMappingURL=breakpoints.js.map
+//# sourceMappingURL=breakpoints.js.map

package/dist/responsive/breakpoints.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/responsive/breakpoints.ts"],"names":[],"mappings":";AAMO,IAAM,4BAAA,GAA+B;AAAA,EAC1C,EAAA,EAAI,GAAA;AAAA,EACJ,EAAA,EAAI,GAAA;AAAA,EACJ,EAAA,EAAI,IAAA;AAAA,EACJ,EAAA,EAAI,IAAA;AAAA,EACJ,KAAA,EAAO;AACT;AAMO,IAAM,+BAA+B,CAAC,IAAA,EAAM,IAAA,EAAM,IAAA,EAAM,MAAM,KAAK;AAGnE,IAAM,wBAAA,GAAwD;AAAA,EACnE,SAAA;AAAA,EACA,IAAA;AAAA,EACA,IAAA;AAAA,EACA,IAAA;AAAA,EACA,IAAA;AAAA,EACA;AACF;AAGO,IAAM,8BAAA,GAA8D;AAAA,EACzE,SAAA;AAAA,EACA,IAAA;AAAA,EACA,IAAA;AAAA,EACA;AACF;AAGO,IAAM,wBAAA,GAA6D;AAAA,EACxE,OAAA,EAAS,mBAAA;AAAA,EACT,EAAA,EAAI,qBAAA;AAAA,EACJ,EAAA,EAAI,sBAAA;AAAA,EACJ,EAAA,EAAI,uBAAA;AAAA,EACJ,EAAA,EAAI,uBAAA;AAAA,EACJ,KAAA,EAAO;AACT;AAGO,IAAM,iCAAA,GAAoC;AAG1C,IAAM,2BAAA,GAA8B,CAAC,KAAA,KAAoC;AAC9E,EAAA,MAAM,EAAE,EAAA,EAAI,EAAA,EAAI,IAAI,EAAA,EAAI,KAAA,EAAO,KAAI,GAAI,4BAAA;AACvC,EAAA,IAAI,KAAA,GAAQ,IAAI,OAAO,SAAA;AACvB,EAAA,IAAI,KAAA,GAAQ,IAAI,OAAO,IAAA;AACvB,EAAA,IAAI,KAAA,GAAQ,IAAI,OAAO,IAAA;AACvB,EAAA,IAAI,KAAA,GAAQ,IAAI,OAAO,IAAA;AACvB,EAAA,IAAI,KAAA,GAAQ,KAAK,OAAO,IAAA;AACxB,EAAA,OAAO,KAAA;AACT;AAMO,IAAM,6BAAA,GAAgC,CAAC,OAAA,KAA0C;AACtF,EAAA,MAAM,MAAA,GAAS,4BAA4B,OAAO,CAAA;AAClD,EAAA,IAAI,MAAA,KAAW,SAAA,EAAW,OAAO,EAAC;AAClC,EAAA,MAAM,GAAA,GAAM,4BAAA,CAA6B,OAAA,CAAQ,MAA4B,CAAA;AAC7E,EAAA,IAAI,GAAA,GAAM,CAAA,EAAG,OAAO,EAAC;AACrB,EAAA,OAAO,4BAAA,CAA6B,KAAA,CAAM,CAAA,EAAG,GAAA,GAAM,CAAC,CAAA;AACtD","file":"breakpoints.js","sourcesContent":["/**\n * Tailwind CSS default `screens` min-width values (px). Single source of truth\n * for preview buckets, manifest breakpoints, and runtime style resolution.\n *\n * @see https://tailwindcss.com/docs/screens\n */\nexport const TAILWIND_DEFAULT_BREAKPOINTS = {\n  sm: 640,\n  md: 768,\n  lg: 1024,\n  xl: 1280,\n  '2xl': 1536,\n} as const;\n\n/** Viewport classification used by preview UI and editing scope. */\nexport type ScreenSizeBucket = 'default' | 'sm' | 'md' | 'lg' | 'xl' | '2xl';\n\n/** Ordered keys stored on layers (`styleBreakpoints`) and merged mobile-first. */\nexport const STYLE_BREAKPOINT_MERGE_ORDER = ['sm', 'md', 'lg', 'xl', '2xl'] as const;\nexport type StyleBreakpointKey = (typeof STYLE_BREAKPOINT_MERGE_ORDER)[number];\n\nexport const SCREEN_SIZE_BUCKET_ORDER: readonly ScreenSizeBucket[] = [\n  'default',\n  'sm',\n  'md',\n  'lg',\n  'xl',\n  '2xl',\n] as const;\n\n/** Buckets shown in the flow builder inspector (xl / 2xl omitted from authoring UI). */\nexport const BUILDER_INSPECTOR_BUCKET_ORDER: readonly ScreenSizeBucket[] = [\n  'default',\n  'sm',\n  'md',\n  'lg',\n] as const;\n\n/** Human-readable bucket titles; ranges lie between consecutive breakpoints. */\nexport const SCREEN_SIZE_BUCKET_LABEL: Record<ScreenSizeBucket, string> = {\n  default: 'Default (< 640px)',\n  sm: 'sm (640–767px)',\n  md: 'md (768–1023px)',\n  lg: 'lg (1024–1279px)',\n  xl: 'xl (1280–1535px)',\n  '2xl': '2xl (1536px+)',\n};\n\n/** Fallback viewport width when no `previewWidthPx` is passed (simulator / static previews). */\nexport const DEFAULT_PREVIEW_VIEWPORT_WIDTH_PX = 390;\n\n/** Maps viewport width (CSS px) to the Tailwind viewport bucket. */\nexport const getScreenSizeBucketForWidth = (width: number): ScreenSizeBucket => {\n  const { sm, md, lg, xl, '2xl': xxl } = TAILWIND_DEFAULT_BREAKPOINTS;\n  if (width < sm) return 'default';\n  if (width < md) return 'sm';\n  if (width < lg) return 'md';\n  if (width < xl) return 'lg';\n  if (width < xxl) return 'xl';\n  return '2xl';\n};\n\n/**\n * Breakpoint keys whose partials apply at this width (mobile-first), e.g.\n * width 800 → `['sm','md']`.\n */\nexport const getActiveStyleBreakpointChain = (widthPx: number): StyleBreakpointKey[] => {\n  const bucket = getScreenSizeBucketForWidth(widthPx);\n  if (bucket === 'default') return [];\n  const idx = STYLE_BREAKPOINT_MERGE_ORDER.indexOf(bucket as StyleBreakpointKey);\n  if (idx < 0) return [];\n  return STYLE_BREAKPOINT_MERGE_ORDER.slice(0, idx + 1) as StyleBreakpointKey[];\n};\n"]}

package/dist/responsive/index.d.ts

@@ -0,0 +1,8 @@
+export { BUILDER_INSPECTOR_BUCKET_ORDER, DEFAULT_PREVIEW_VIEWPORT_WIDTH_PX, SCREEN_SIZE_BUCKET_LABEL, SCREEN_SIZE_BUCKET_ORDER, STYLE_BREAKPOINT_MERGE_ORDER, ScreenSizeBucket, StyleBreakpointKey, TAILWIND_DEFAULT_BREAKPOINTS, getActiveStyleBreakpointChain, getScreenSizeBucketForWidth } from './breakpoints.js';
+export { deepMergeStyle, mergeResponsivePartial, mergeResponsivePartialUpToBucket } from './merge.js';
+export { ButtonLayoutBreakpointPatch, StackLayoutBreakpointPatch, resolveButtonLayoutAtWidth, resolveButtonStyleAtWidth, resolveCommonStyleAtWidth, resolveCommonStyleForEditBucket, resolveIconStyleAtWidth, resolveImageStyleAtWidth, resolveLayerGap, resolveLoaderCircularSizePx, resolveLoaderLinearHeightPx, resolveLoaderStrokeWidthPx, resolveProgressLinearHeightPx, resolveStackLayoutAtWidth, resolveTextStyleAtWidth, resolveTextStyleForEditBucket } from './layerResolve.js';
+export { resolveScreenContainerForEditBucket, resolveScreenContainerStyleAtWidth, screenBackgroundFillUsesMedia } from './screenContainerResolve.js';
+export { PreviewPhoneSystemUi, previewPhoneSafeAreaInsetBottomPx, previewPhoneSafeAreaInsetHorizontalPx, previewPhoneSafeAreaInsetTopPx, previewPhoneSafeAreaPadding } from './previewSafeAreaInsets.js';
+export { addPadding, resolveEffectiveScreenShellPadding } from './screenShellInsets.js';
+import '@getrheo/contracts/layers';
+import '@getrheo/contracts';