@appfunnel-dev/sdk 2.0.0-canary.2 → 2.0.0-canary.3

package/dist/{manifest-DQThneiG.d.cts → manifest-Cr2y1op6.d.cts}

@@ -210,6 +210,8 @@ type Interval = 'day' | 'week' | 'month' | 'year' | 'one_time';
 /** What the platform hands the funnel per product (a single provider-resolved price). */
 interface ProductInput {
     id: string;
+    /** The catalog product KEY this input charges (the slot's assignment). Defaults to `id` (legacy/identity slots). */
+    catalogKey?: string;
     name?: string;
     displayName?: string;
     /** Provider-resolved price in **minor units** (the provider chose the currency). */
@@ -240,6 +242,8 @@ interface Money {
  */
 interface ResolvedProduct {
     id: string;
+    /** The catalog product KEY charged (the CHARGE identity; `id` is the SLOT/display identity). */
+    catalogKey: string;
     name: string;
     displayName: string;
     provider: string;
@@ -258,6 +262,8 @@ interface ResolvedProduct {
 /** Display-ready product the author reads (every amount locale-formatted). */
 interface Product {
     id: string;
+    /** The catalog product KEY charged (the CHARGE identity; `id` is the SLOT/display identity). */
+    catalogKey: string;
     name: string;
     displayName: string;
     provider: string;
@@ -456,8 +462,15 @@ interface FunnelDefinition {
     responses?: Record<string, VariableConfig>;
     /** `data.*` working/scratch variables (default values). */
     data?: Record<string, VariableConfig>;
-    /** Product ids from the platform catalog this funnel uses (prices resolved at render). */
-    products?: string[];
+    /**
+     * The catalog products this funnel sells, as SLOTS: a local, stable key each PAGE
+     * references (`useProduct('primary')`, `<Checkout product="primary">`) → the catalog product
+     * KEY it's assigned to. Swap the assignment to change the offer WITHOUT touching page code;
+     * `null` = a declared-but-unassigned slot. A bare `string[]` is legacy sugar for IDENTITY
+     * slots (`['pro'] ≡ { pro: 'pro' }`) — every existing funnel keeps working. Prices resolve
+     * from the project catalog per environment (Live/Test) at render.
+     */
+    products?: string[] | Record<string, string | null>;
     locales?: FunnelLocales;
     /**
      * When `true`, the funnel shows the **geo-specific** currency/price the payment
@@ -471,6 +484,19 @@ interface FunnelDefinition {
 }
 /** Identity helper for a funnel definition. */
 declare function defineFunnel(def: FunnelDefinition): FunnelDefinition;
+/** A funnel product SLOT: the local key pages reference → the assigned catalog product key (null = unassigned). */
+interface ProductSlot {
+    slot: string;
+    catalogKey: string | null;
+}
+/**
+ * Normalize `FunnelDefinition.products` to a slot list. A legacy `string[]` becomes IDENTITY
+ * slots (`['pro'] → [{ slot:'pro', catalogKey:'pro' }]`); a `{ slot: key|null }` map becomes its
+ * entries (insertion order preserved, so `useProducts()` is deterministic).
+ */
+declare function normalizeProducts(products: FunnelDefinition['products']): ProductSlot[];
+/** The unique, ASSIGNED catalog keys a funnel charges — for the promote gate + catalog reverse-lookup. */
+declare function funnelCatalogKeys(products: FunnelDefinition['products']): string[];
 
 /**
  * Pure locale resolution — no React. Split out of {@link ./translation} so the
@@ -750,6 +776,10 @@ interface ManifestValidation {
      * though every page can proceed. Hard error.
      */
     noReachableFinish: boolean;
+    /** Slot names a PAGE references (`useProduct`/`<Checkout product>`) that the funnel doesn't declare — hard error. */
+    unknownProductRefs: string[];
+    /** Declared slots a page references but which have no catalog product assigned (map value `null`) — hard error. */
+    unassignedSlots: string[];
 }
 interface FunnelManifest {
     id: string;
@@ -759,7 +789,12 @@ interface FunnelManifest {
         nodes: string[];
         edges: ManifestEdge[];
     };
+    /** The unique, ASSIGNED catalog keys the funnel charges (for the promote gate + catalog reverse-lookup). */
     products: string[];
+    /** Product SLOTS: slot → assigned catalog key|null. `products` above is the unique assigned keys. */
+    productSlots: ProductSlot[];
+    /** Slot names PAGES reference (from the build's scan); validated against `productSlots`. Absent = no scan ran. */
+    productRefs?: string[];
     locales?: FunnelLocales;
     validation: ManifestValidation;
 }
@@ -770,8 +805,10 @@ interface CompileInput {
         key: string;
         meta?: PageMeta;
     }[];
+    /** Slot names the funnel's PAGES reference (from `scanProductRefs`) — cross-checked against the declared slots. */
+    productRefs?: string[];
 }
 /** Compile a funnel's spine into its declarative {@link FunnelManifest} IR. */
 declare function compileManifest(input: CompileInput): FunnelManifest;
 
-export { evaluateCondition as $, type Acquisition as A, type BrowserContext as B, type ClickIdContext as C, type Direction as D, type EdgeCondition as E, type FunnelContext as F, type Gate as G, type Route as H, type IdentityContext as I, type SystemContext as J, assignVariant as K, type LocaleContext as L, type ManifestEdge as M, bucketingSeed as N, type OsContext as O, type Product as P, buildAcquisition as Q, type RuntimeExperiment as R, type SessionContext as S, buildCatalog as T, type UtmContext as U, type VariableValue as V, compileManifest as W, currencyExponent as X, defineFunnel as Y, definePage as Z, entryGuard as _, type VariableConfig as a, evaluateGate as a0, expectedPathLength as a1, fnv1a as a2, formatMoney as a3, formatProduct as a4, hashToUnit as a5, isRtl as a6, isVariantKey as a7, nextPage as a8, outgoingKeys as a9, pageMeta as aa, parseSlotKey as ab, pickByWeight as ac, resolveExperiments as ad, resolveLocale as ae, resolveProduct as af, resolveRoute as ag, validateExperiments as ah, type FunnelPage as ai, weightsOf as aj, type FunnelSnapshot as b, type FunnelDefinition as c, buildContext as d, type ProductInput as e, type PageMeta as f, type PageContext as g, type BuildContextOptions as h, type CompileInput as i, type Condition as j, type ConditionOp as k, type DeviceContext as l, type ExperimentIssue as m, type ExperimentResolution as n, type ExperimentValidation as o, type ExperimentVariant as p, type FlowPage as q, type FunnelLocales as r, type FunnelManifest as s, type Interval as t, type ManifestPage as u, type ManifestValidation as v, type Money as w, type PageType as x, type Predicate as y, type ResolvedProduct as z };
+export { evaluateCondition as $, type Acquisition as A, type BrowserContext as B, type ClickIdContext as C, type Direction as D, type EdgeCondition as E, type FunnelContext as F, type Gate as G, type Route as H, type IdentityContext as I, type SystemContext as J, assignVariant as K, type LocaleContext as L, type ManifestEdge as M, bucketingSeed as N, type OsContext as O, type Product as P, buildAcquisition as Q, type RuntimeExperiment as R, type SessionContext as S, buildCatalog as T, type UtmContext as U, type VariableValue as V, compileManifest as W, currencyExponent as X, defineFunnel as Y, definePage as Z, entryGuard as _, type VariableConfig as a, evaluateGate as a0, expectedPathLength as a1, fnv1a as a2, formatMoney as a3, formatProduct as a4, hashToUnit as a5, isRtl as a6, isVariantKey as a7, nextPage as a8, outgoingKeys as a9, pageMeta as aa, parseSlotKey as ab, pickByWeight as ac, resolveExperiments as ad, resolveLocale as ae, resolveProduct as af, resolveRoute as ag, validateExperiments as ah, type FunnelPage as ai, type ProductSlot as aj, funnelCatalogKeys as ak, normalizeProducts as al, weightsOf as am, type FunnelSnapshot as b, type FunnelDefinition as c, buildContext as d, type ProductInput as e, type PageMeta as f, type PageContext as g, type BuildContextOptions as h, type CompileInput as i, type Condition as j, type ConditionOp as k, type DeviceContext as l, type ExperimentIssue as m, type ExperimentResolution as n, type ExperimentValidation as o, type ExperimentVariant as p, type FlowPage as q, type FunnelLocales as r, type FunnelManifest as s, type Interval as t, type ManifestPage as u, type ManifestValidation as v, type Money as w, type PageType as x, type Predicate as y, type ResolvedProduct as z };

package/dist/{manifest-DQThneiG.d.ts → manifest-Cr2y1op6.d.ts}

@@ -210,6 +210,8 @@ type Interval = 'day' | 'week' | 'month' | 'year' | 'one_time';
 /** What the platform hands the funnel per product (a single provider-resolved price). */
 interface ProductInput {
     id: string;
+    /** The catalog product KEY this input charges (the slot's assignment). Defaults to `id` (legacy/identity slots). */
+    catalogKey?: string;
     name?: string;
     displayName?: string;
     /** Provider-resolved price in **minor units** (the provider chose the currency). */
@@ -240,6 +242,8 @@ interface Money {
  */
 interface ResolvedProduct {
     id: string;
+    /** The catalog product KEY charged (the CHARGE identity; `id` is the SLOT/display identity). */
+    catalogKey: string;
     name: string;
     displayName: string;
     provider: string;
@@ -258,6 +262,8 @@ interface ResolvedProduct {
 /** Display-ready product the author reads (every amount locale-formatted). */
 interface Product {
     id: string;
+    /** The catalog product KEY charged (the CHARGE identity; `id` is the SLOT/display identity). */
+    catalogKey: string;
     name: string;
     displayName: string;
     provider: string;
@@ -456,8 +462,15 @@ interface FunnelDefinition {
     responses?: Record<string, VariableConfig>;
     /** `data.*` working/scratch variables (default values). */
     data?: Record<string, VariableConfig>;
-    /** Product ids from the platform catalog this funnel uses (prices resolved at render). */
-    products?: string[];
+    /**
+     * The catalog products this funnel sells, as SLOTS: a local, stable key each PAGE
+     * references (`useProduct('primary')`, `<Checkout product="primary">`) → the catalog product
+     * KEY it's assigned to. Swap the assignment to change the offer WITHOUT touching page code;
+     * `null` = a declared-but-unassigned slot. A bare `string[]` is legacy sugar for IDENTITY
+     * slots (`['pro'] ≡ { pro: 'pro' }`) — every existing funnel keeps working. Prices resolve
+     * from the project catalog per environment (Live/Test) at render.
+     */
+    products?: string[] | Record<string, string | null>;
     locales?: FunnelLocales;
     /**
      * When `true`, the funnel shows the **geo-specific** currency/price the payment
@@ -471,6 +484,19 @@ interface FunnelDefinition {
 }
 /** Identity helper for a funnel definition. */
 declare function defineFunnel(def: FunnelDefinition): FunnelDefinition;
+/** A funnel product SLOT: the local key pages reference → the assigned catalog product key (null = unassigned). */
+interface ProductSlot {
+    slot: string;
+    catalogKey: string | null;
+}
+/**
+ * Normalize `FunnelDefinition.products` to a slot list. A legacy `string[]` becomes IDENTITY
+ * slots (`['pro'] → [{ slot:'pro', catalogKey:'pro' }]`); a `{ slot: key|null }` map becomes its
+ * entries (insertion order preserved, so `useProducts()` is deterministic).
+ */
+declare function normalizeProducts(products: FunnelDefinition['products']): ProductSlot[];
+/** The unique, ASSIGNED catalog keys a funnel charges — for the promote gate + catalog reverse-lookup. */
+declare function funnelCatalogKeys(products: FunnelDefinition['products']): string[];
 
 /**
  * Pure locale resolution — no React. Split out of {@link ./translation} so the
@@ -750,6 +776,10 @@ interface ManifestValidation {
      * though every page can proceed. Hard error.
      */
     noReachableFinish: boolean;
+    /** Slot names a PAGE references (`useProduct`/`<Checkout product>`) that the funnel doesn't declare — hard error. */
+    unknownProductRefs: string[];
+    /** Declared slots a page references but which have no catalog product assigned (map value `null`) — hard error. */
+    unassignedSlots: string[];
 }
 interface FunnelManifest {
     id: string;
@@ -759,7 +789,12 @@ interface FunnelManifest {
         nodes: string[];
         edges: ManifestEdge[];
     };
+    /** The unique, ASSIGNED catalog keys the funnel charges (for the promote gate + catalog reverse-lookup). */
     products: string[];
+    /** Product SLOTS: slot → assigned catalog key|null. `products` above is the unique assigned keys. */
+    productSlots: ProductSlot[];
+    /** Slot names PAGES reference (from the build's scan); validated against `productSlots`. Absent = no scan ran. */
+    productRefs?: string[];
     locales?: FunnelLocales;
     validation: ManifestValidation;
 }
@@ -770,8 +805,10 @@ interface CompileInput {
         key: string;
         meta?: PageMeta;
     }[];
+    /** Slot names the funnel's PAGES reference (from `scanProductRefs`) — cross-checked against the declared slots. */
+    productRefs?: string[];
 }
 /** Compile a funnel's spine into its declarative {@link FunnelManifest} IR. */
 declare function compileManifest(input: CompileInput): FunnelManifest;
 
-export { evaluateCondition as $, type Acquisition as A, type BrowserContext as B, type ClickIdContext as C, type Direction as D, type EdgeCondition as E, type FunnelContext as F, type Gate as G, type Route as H, type IdentityContext as I, type SystemContext as J, assignVariant as K, type LocaleContext as L, type ManifestEdge as M, bucketingSeed as N, type OsContext as O, type Product as P, buildAcquisition as Q, type RuntimeExperiment as R, type SessionContext as S, buildCatalog as T, type UtmContext as U, type VariableValue as V, compileManifest as W, currencyExponent as X, defineFunnel as Y, definePage as Z, entryGuard as _, type VariableConfig as a, evaluateGate as a0, expectedPathLength as a1, fnv1a as a2, formatMoney as a3, formatProduct as a4, hashToUnit as a5, isRtl as a6, isVariantKey as a7, nextPage as a8, outgoingKeys as a9, pageMeta as aa, parseSlotKey as ab, pickByWeight as ac, resolveExperiments as ad, resolveLocale as ae, resolveProduct as af, resolveRoute as ag, validateExperiments as ah, type FunnelPage as ai, weightsOf as aj, type FunnelSnapshot as b, type FunnelDefinition as c, buildContext as d, type ProductInput as e, type PageMeta as f, type PageContext as g, type BuildContextOptions as h, type CompileInput as i, type Condition as j, type ConditionOp as k, type DeviceContext as l, type ExperimentIssue as m, type ExperimentResolution as n, type ExperimentValidation as o, type ExperimentVariant as p, type FlowPage as q, type FunnelLocales as r, type FunnelManifest as s, type Interval as t, type ManifestPage as u, type ManifestValidation as v, type Money as w, type PageType as x, type Predicate as y, type ResolvedProduct as z };
+export { evaluateCondition as $, type Acquisition as A, type BrowserContext as B, type ClickIdContext as C, type Direction as D, type EdgeCondition as E, type FunnelContext as F, type Gate as G, type Route as H, type IdentityContext as I, type SystemContext as J, assignVariant as K, type LocaleContext as L, type ManifestEdge as M, bucketingSeed as N, type OsContext as O, type Product as P, buildAcquisition as Q, type RuntimeExperiment as R, type SessionContext as S, buildCatalog as T, type UtmContext as U, type VariableValue as V, compileManifest as W, currencyExponent as X, defineFunnel as Y, definePage as Z, entryGuard as _, type VariableConfig as a, evaluateGate as a0, expectedPathLength as a1, fnv1a as a2, formatMoney as a3, formatProduct as a4, hashToUnit as a5, isRtl as a6, isVariantKey as a7, nextPage as a8, outgoingKeys as a9, pageMeta as aa, parseSlotKey as ab, pickByWeight as ac, resolveExperiments as ad, resolveLocale as ae, resolveProduct as af, resolveRoute as ag, validateExperiments as ah, type FunnelPage as ai, type ProductSlot as aj, funnelCatalogKeys as ak, normalizeProducts as al, weightsOf as am, type FunnelSnapshot as b, type FunnelDefinition as c, buildContext as d, type ProductInput as e, type PageMeta as f, type PageContext as g, type BuildContextOptions as h, type CompileInput as i, type Condition as j, type ConditionOp as k, type DeviceContext as l, type ExperimentIssue as m, type ExperimentResolution as n, type ExperimentValidation as o, type ExperimentVariant as p, type FlowPage as q, type FunnelLocales as r, type FunnelManifest as s, type Interval as t, type ManifestPage as u, type ManifestValidation as v, type Money as w, type PageType as x, type Predicate as y, type ResolvedProduct as z };

package/dist/manifest-entry.cjs

@@ -1,9 +1,102 @@
 'use strict';
 
-var chunkZ3TWO2PW_cjs = require('./chunk-Z3TWO2PW.cjs');
+var chunkJSRKA375_cjs = require('./chunk-JSRKA375.cjs');
 var chunkLJYLGLFS_cjs = require('./chunk-LJYLGLFS.cjs');
 
+// src/manifest/product-refs.ts
+function mask(src) {
+  const out = src.split("");
+  const n = src.length;
+  let i = 0;
+  while (i < n) {
+    const c = src[i];
+    const d = src[i + 1];
+    if (c === "/" && d === "/") {
+      while (i < n && src[i] !== "\n") {
+        out[i] = " ";
+        i++;
+      }
+    } else if (c === "/" && d === "*") {
+      out[i] = " ";
+      out[i + 1] = " ";
+      i += 2;
+      while (i < n) {
+        if (src[i] === "*" && src[i + 1] === "/") {
+          out[i] = " ";
+          out[i + 1] = " ";
+          i += 2;
+          break;
+        }
+        if (src[i] !== "\n") out[i] = " ";
+        i++;
+      }
+    } else if (c === "'" || c === '"' || c === "`") {
+      i++;
+      while (i < n && src[i] !== c) {
+        if (src[i] === "\\") {
+          out[i] = " ";
+          i++;
+          if (i < n && src[i] !== "\n") out[i] = " ";
+          i++;
+          continue;
+        }
+        if (src[i] !== "\n") out[i] = " ";
+        i++;
+      }
+      i++;
+    } else i++;
+  }
+  return out.join("");
+}
+function literalAt(src, masked, open) {
+  const q = masked[open];
+  if (q !== "'" && q !== '"' && q !== "`") return null;
+  const close = masked.indexOf(q, open + 1);
+  if (close === -1) return null;
+  return src.slice(open + 1, close);
+}
+function skipWs(masked, i) {
+  while (i < masked.length && (masked[i] === " " || masked[i] === "	" || masked[i] === "\n" || masked[i] === "\r")) i++;
+  return i;
+}
+function scanProductRefs(files) {
+  const seen = /* @__PURE__ */ new Set();
+  const order = [];
+  let dynamic = false;
+  const add = (v) => {
+    if (v && !seen.has(v)) {
+      seen.add(v);
+      order.push(v);
+    }
+  };
+  for (const [path, source] of Object.entries(files)) {
+    if (!/\.(tsx|jsx|ts|js)$/.test(path)) continue;
+    const masked = mask(source);
+    for (const m of masked.matchAll(/\buseProducts?\s*\(/g)) {
+      const plural = source.slice(m.index, m.index + 11) === "useProducts";
+      const j = skipWs(masked, m.index + m[0].length);
+      if (masked[j] === ")") {
+        if (plural) dynamic = true;
+        continue;
+      }
+      const lit = literalAt(source, masked, j);
+      if (lit !== null) add(lit);
+      else dynamic = true;
+    }
+    for (const m of masked.matchAll(/<(?:Checkout|Upsell)\b[^>]*?\bproduct\s*=\s*/g)) {
+      const j = m.index + m[0].length;
+      const lit = literalAt(source, masked, j);
+      if (lit !== null) add(lit);
+      else if (masked[j] === "{") dynamic = true;
+    }
+  }
+  return { slots: order, dynamic };
+}
+
 // src/flow/scaffold.ts
+function msgId(locale) {
+  return "msg_" + locale.replace(/[^a-zA-Z0-9]/g, "_");
+}
 var DRIVERS = {
   stripe: { name: "stripeCheckoutDriver", sub: "driver-stripe" },
   paddle: { name: "paddleCheckoutDriver", sub: "driver-paddle" }
@@ -12,11 +105,13 @@ var HEADER = "// GENERATED by AppFunnel \u2014 do not edit. Built from funnel.ts
 function generateMount(opts) {
   const p = opts.importPrefix ?? "./";
   const driver = opts.checkout ? DRIVERS[opts.checkout] : null;
+  const locales = opts.messageLocales ?? [];
   const imports = [
     `import { createFunnelTree, type MountOpts, type RuntimePage } from '@appfunnel-dev/sdk'`,
     driver && `import { ${driver.name} } from '@appfunnel-dev/sdk/${driver.sub}'`,
     `import { config } from '${p}funnel'`,
-    opts.hasLayout && `import Layout from '${p}layout'`
+    opts.hasLayout && `import Layout from '${p}layout'`,
+    ...locales.map((loc) => `import ${msgId(loc)} from '${p}messages/${loc}.json'`)
   ].filter(Boolean).join("\n");
   const loaders = opts.pageKeys.map(
     (k) => `	${JSON.stringify(k)}: () => import(${JSON.stringify(`${p}pages/${k}`)}),`
@@ -25,8 +120,12 @@ function generateMount(opts) {
     "config",
     "pages",
     opts.hasLayout && "layout: Layout",
-    driver && `checkoutDriver: ${driver.name}`
+    driver && `checkoutDriver: ${driver.name}`,
+    locales.length > 0 && "messages"
   ].filter(Boolean).join(", ");
+  const messagesConst = locales.length > 0 ? `
+const messages = { ${locales.map((loc) => `${JSON.stringify(loc)}: ${msgId(loc)}`).join(", ")} }
+` : "";
   return `${HEADER}${imports}
 
 const loaders: Record<string, () => Promise<unknown>> = {
@@ -43,7 +142,7 @@ export const pages: RuntimePage[] = [
 		.filter((k) => !flowKeys.has(k))
 		.map((k) => ({ key: k, meta: {}, load: loaders[k] })),
 ] as RuntimePage[]
-
+${messagesConst}
 export const tree = createFunnelTree({ ${treeArgs} })
 
 export type { MountOpts }
@@ -74,6 +173,7 @@ import { tree, pages, type MountOpts } from './mount'
 export const manifest = compileManifest({
 	funnel: config,
 	pages: pages.map((pg) => ({ key: pg.key, meta: pg.meta })),
+	productRefs: ${JSON.stringify(opts.productRefs ?? [])},
 })
 
 export async function ssr(opts: MountOpts): Promise<string> {
@@ -97,67 +197,75 @@ if (el) createRoot(el).render(tree(${JSON.stringify(opts.data)}))
 
 Object.defineProperty(exports, "assignVariant", {
   enumerable: true,
-  get: function () { return chunkZ3TWO2PW_cjs.assignVariant; }
+  get: function () { return chunkJSRKA375_cjs.assignVariant; }
 });
 Object.defineProperty(exports, "bucketingSeed", {
   enumerable: true,
-  get: function () { return chunkZ3TWO2PW_cjs.bucketingSeed; }
+  get: function () { return chunkJSRKA375_cjs.bucketingSeed; }
 });
 Object.defineProperty(exports, "buildCatalog", {
   enumerable: true,
-  get: function () { return chunkZ3TWO2PW_cjs.buildCatalog; }
+  get: function () { return chunkJSRKA375_cjs.buildCatalog; }
 });
 Object.defineProperty(exports, "compileManifest", {
   enumerable: true,
-  get: function () { return chunkZ3TWO2PW_cjs.compileManifest; }
+  get: function () { return chunkJSRKA375_cjs.compileManifest; }
 });
 Object.defineProperty(exports, "currencyExponent", {
   enumerable: true,
-  get: function () { return chunkZ3TWO2PW_cjs.currencyExponent; }
+  get: function () { return chunkJSRKA375_cjs.currencyExponent; }
 });
 Object.defineProperty(exports, "defineFunnel", {
   enumerable: true,
-  get: function () { return chunkZ3TWO2PW_cjs.defineFunnel; }
+  get: function () { return chunkJSRKA375_cjs.defineFunnel; }
 });
 Object.defineProperty(exports, "formatMoney", {
   enumerable: true,
-  get: function () { return chunkZ3TWO2PW_cjs.formatMoney; }
+  get: function () { return chunkJSRKA375_cjs.formatMoney; }
 });
 Object.defineProperty(exports, "formatProduct", {
   enumerable: true,
-  get: function () { return chunkZ3TWO2PW_cjs.formatProduct; }
+  get: function () { return chunkJSRKA375_cjs.formatProduct; }
+});
+Object.defineProperty(exports, "funnelCatalogKeys", {
+  enumerable: true,
+  get: function () { return chunkJSRKA375_cjs.funnelCatalogKeys; }
 });
 Object.defineProperty(exports, "isRtl", {
   enumerable: true,
-  get: function () { return chunkZ3TWO2PW_cjs.isRtl; }
+  get: function () { return chunkJSRKA375_cjs.isRtl; }
 });
 Object.defineProperty(exports, "isVariantKey", {
   enumerable: true,
-  get: function () { return chunkZ3TWO2PW_cjs.isVariantKey; }
+  get: function () { return chunkJSRKA375_cjs.isVariantKey; }
+});
+Object.defineProperty(exports, "normalizeProducts", {
+  enumerable: true,
+  get: function () { return chunkJSRKA375_cjs.normalizeProducts; }
 });
 Object.defineProperty(exports, "pageMeta", {
   enumerable: true,
-  get: function () { return chunkZ3TWO2PW_cjs.pageMeta; }
+  get: function () { return chunkJSRKA375_cjs.pageMeta; }
 });
 Object.defineProperty(exports, "parseSlotKey", {
   enumerable: true,
-  get: function () { return chunkZ3TWO2PW_cjs.parseSlotKey; }
+  get: function () { return chunkJSRKA375_cjs.parseSlotKey; }
 });
 Object.defineProperty(exports, "resolveLocale", {
   enumerable: true,
-  get: function () { return chunkZ3TWO2PW_cjs.resolveLocale; }
+  get: function () { return chunkJSRKA375_cjs.resolveLocale; }
 });
 Object.defineProperty(exports, "resolveProduct", {
   enumerable: true,
-  get: function () { return chunkZ3TWO2PW_cjs.resolveProduct; }
+  get: function () { return chunkJSRKA375_cjs.resolveProduct; }
 });
 Object.defineProperty(exports, "validateExperiments", {
   enumerable: true,
-  get: function () { return chunkZ3TWO2PW_cjs.validateExperiments; }
+  get: function () { return chunkJSRKA375_cjs.validateExperiments; }
 });
 Object.defineProperty(exports, "weightsOf", {
   enumerable: true,
-  get: function () { return chunkZ3TWO2PW_cjs.weightsOf; }
+  get: function () { return chunkJSRKA375_cjs.weightsOf; }
 });
 Object.defineProperty(exports, "INLINE_SURFACES", {
   enumerable: true,
@@ -199,5 +307,6 @@ exports.generateDevEntry = generateDevEntry;
 exports.generateEntryClient = generateEntryClient;
 exports.generateEntryServer = generateEntryServer;
 exports.generateMount = generateMount;
+exports.scanProductRefs = scanProductRefs;
 //# sourceMappingURL=manifest-entry.cjs.map
 //# sourceMappingURL=manifest-entry.cjs.map

package/dist/manifest-entry.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/flow/scaffold.ts"],"names":[],"mappings":"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","file":"manifest-entry.cjs","sourcesContent":["/**\n * Source generators for the funnel build \"machinery\" authors no longer write. `funnel.ts` (the\n * spine: id, responses, products, checkout, and the page list + declarative routing) plus the\n * `pages/` folder are the ONLY authored source. The build (renderer/builder) and the CLI dev server\n * call these to synthesize:\n *   - `mount.tsx`         — code-split page loaders + `createFunnelTree`\n *   - `entry.client.tsx`  — hydrate the SSR'd markup from injected data\n *   - `entry.server.tsx`  — `ssr()` + the compiled `manifest`\n *\n * All string templates, zero runtime deps — this module lives in the pure `@appfunnel-dev/sdk/\n * manifest` entry so tooling imports it without the funnel runtime.\n */\n\nexport interface ScaffoldOptions {\n\t/** Page component keys = `pages/<key>.tsx` filenames (base flow pages AND `@variant` pages). */\n\tpageKeys: string[]\n\t/** Import prefix to reach the funnel root: `'./'` at the root (build), `'../../'` in a subdir (CLI dev). */\n\timportPrefix?: string\n\t/** Whether a `layout.tsx` exists to wrap the pages. */\n\thasLayout?: boolean\n\t/** Whether a `styles.css` exists (client entry imports it). */\n\thasStyles?: boolean\n\t/** Checkout provider from `config.checkout` — wires the driver; omit for none. */\n\tcheckout?: 'stripe' | 'paddle' | null\n}\n\nconst DRIVERS = {\n\tstripe: { name: 'stripeCheckoutDriver', sub: 'driver-stripe' },\n\tpaddle: { name: 'paddleCheckoutDriver', sub: 'driver-paddle' },\n} as const\n\nconst HEADER = '// GENERATED by AppFunnel — do not edit. Built from funnel.ts + the pages/ folder.\\n'\n\n/** `mount.tsx` — the code-split loaders + tree, derived from `config.pages` and the `pages/` files. */\nexport function generateMount(opts: ScaffoldOptions): string {\n\tconst p = opts.importPrefix ?? './'\n\tconst driver = opts.checkout ? DRIVERS[opts.checkout] : null\n\n\tconst imports = [\n\t\t`import { createFunnelTree, type MountOpts, type RuntimePage } from '@appfunnel-dev/sdk'`,\n\t\tdriver && `import { ${driver.name} } from '@appfunnel-dev/sdk/${driver.sub}'`,\n\t\t`import { config } from '${p}funnel'`,\n\t\topts.hasLayout && `import Layout from '${p}layout'`,\n\t]\n\t\t.filter(Boolean)\n\t\t.join('\\n')\n\n\t// A static import() per page file so Vite emits one code-split chunk each.\n\tconst loaders = opts.pageKeys\n\t\t.map(\n\t\t\t(k) => `\\t${JSON.stringify(k)}: () => import(${JSON.stringify(`${p}pages/${k}`)}),`\n\t\t)\n\t\t.join('\\n')\n\n\tconst treeArgs = [\n\t\t'config',\n\t\t'pages',\n\t\topts.hasLayout && 'layout: Layout',\n\t\tdriver && `checkoutDriver: ${driver.name}`,\n\t]\n\t\t.filter(Boolean)\n\t\t.join(', ')\n\n\treturn `${HEADER}${imports}\n\nconst loaders: Record<string, () => Promise<unknown>> = {\n${loaders}\n}\n\n// Flow pages come from funnel.ts (order + meta + routing). Any remaining page file is an off-flow\n// \\`@variant\\` page (wired by experiment records at render time), appended so it's loadable.\nconst decls = config.pages ?? []\nconst flowKeys = new Set(decls.map((d) => d.key))\nexport const pages: RuntimePage[] = [\n\t...decls.map((d) => ({ key: d.key, meta: d, load: loaders[d.key] })),\n\t...Object.keys(loaders)\n\t\t.filter((k) => !flowKeys.has(k))\n\t\t.map((k) => ({ key: k, meta: {}, load: loaders[k] })),\n] as RuntimePage[]\n\nexport const tree = createFunnelTree({ ${treeArgs} })\n\nexport type { MountOpts }\n`\n}\n\n/** `entry.client.tsx` — hydrate the SSR'd markup from the injected `#__af_data`. */\nexport function generateEntryClient(opts: Pick<ScaffoldOptions, 'importPrefix' | 'hasStyles'>): string {\n\tconst p = opts.importPrefix ?? './'\n\tconst styles = opts.hasStyles ? `import '${p}styles.css'\\n` : ''\n\treturn `${HEADER}${styles}import { hydrateRoot } from 'react-dom/client'\nimport { tree, type MountOpts } from './mount'\n\nconst dataEl = document.getElementById('__af_data')\nconst data = (dataEl?.textContent ? JSON.parse(dataEl.textContent) : {}) as MountOpts & {\n\tinitialKey?: string | null\n}\nconst root = document.getElementById('root')\nif (root) hydrateRoot(root, tree({ ...data, initialKey: data.initialKey ?? undefined }))\n`\n}\n\n/** `entry.server.tsx` — `ssr(opts)` HTML + the compiled `manifest` (read by the build). */\nexport function generateEntryServer(opts: Pick<ScaffoldOptions, 'importPrefix'>): string {\n\tconst p = opts.importPrefix ?? './'\n\treturn `${HEADER}import { renderToReadableStream } from 'react-dom/server.browser'\nimport { compileManifest } from '@appfunnel-dev/sdk'\nimport { config } from '${p}funnel'\nimport { tree, pages, type MountOpts } from './mount'\n\nexport const manifest = compileManifest({\n\tfunnel: config,\n\tpages: pages.map((pg) => ({ key: pg.key, meta: pg.meta })),\n})\n\nexport async function ssr(opts: MountOpts): Promise<string> {\n\tconst stream = await renderToReadableStream(tree(opts))\n\tawait stream.allReady\n\treturn await new Response(stream).text()\n}\n`\n}\n\n/** Client-only dev entry (createRoot, no SSR) — for the CLI `dev` server. */\nexport function generateDevEntry(\n\topts: Pick<ScaffoldOptions, 'importPrefix' | 'hasStyles'> & { data: unknown }\n): string {\n\tconst p = opts.importPrefix ?? './'\n\tconst styles = opts.hasStyles ? `import '${p}styles.css'\\n` : ''\n\treturn `${HEADER}${styles}import { createRoot } from 'react-dom/client'\nimport { tree } from './mount'\n\nconst el = document.getElementById('root')\nif (el) createRoot(el).render(tree(${JSON.stringify(opts.data)}))\n`\n}\n"]}
+{"version":3,"sources":["../src/manifest/product-refs.ts","../src/flow/scaffold.ts"],"names":[],"mappings":"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","file":"manifest-entry.cjs","sourcesContent":["/**\n * Pure, React-free page scan: find which product SLOTS a funnel's pages reference — the first\n * string-literal arg of `useProduct(...)` and the `product` prop of `<Checkout>` / `<Upsell>`.\n * Ships via `@appfunnel-dev/sdk/manifest` so the BUILD, the EDITOR, and the AI all run the SAME\n * check. The result feeds `compileManifest({ productRefs })`, which flags references to slots the\n * funnel doesn't declare (unknown) or hasn't assigned a catalog product to (unassigned).\n *\n * Non-literal args (`useProduct(selectedId)`, `product={expr}`) and the `useProducts()` wildcard are\n * DYNAMIC — they can't be statically enumerated, so they're reported via `dynamic` and never turned\n * into a hard error (validation relaxes when a funnel is dynamic). Mirrors the mask-then-read\n * discipline the funnel.ts code-mods use, so a `useProduct('x')` inside a comment or string literal\n * can't false-positive.\n */\n\nexport interface ProductRefScan {\n  /** Concrete slot names referenced by LITERAL args, deduped, in first-seen order. */\n  slots: string[]\n  /** True if any ref is a non-literal arg or a `useProducts()` wildcard (not statically enumerable). */\n  dynamic: boolean\n}\n\n/** Blank comment + string/template CONTENTS (keep quote delimiters + length) so scans don't fire inside them. */\nfunction mask(src: string): string {\n  const out = src.split('')\n  const n = src.length\n  let i = 0\n  while (i < n) {\n    const c = src[i]\n    const d = src[i + 1]\n    if (c === '/' && d === '/') {\n      while (i < n && src[i] !== '\\n') { out[i] = ' '; i++ }\n    } else if (c === '/' && d === '*') {\n      out[i] = ' '; out[i + 1] = ' '; i += 2\n      while (i < n) {\n        if (src[i] === '*' && src[i + 1] === '/') { out[i] = ' '; out[i + 1] = ' '; i += 2; break }\n        if (src[i] !== '\\n') out[i] = ' '\n        i++\n      }\n    } else if (c === \"'\" || c === '\"' || c === '`') {\n      i++\n      while (i < n && src[i] !== c) {\n        if (src[i] === '\\\\') { out[i] = ' '; i++; if (i < n && src[i] !== '\\n') out[i] = ' '; i++; continue }\n        if (src[i] !== '\\n') out[i] = ' '\n        i++\n      }\n      i++ // closing delimiter (kept)\n    } else i++\n  }\n  return out.join('')\n}\n\n/** A quoted string literal starting at `open` (a quote char in the MASK). Value read from the ORIGINAL. */\nfunction literalAt(src: string, masked: string, open: number): string | null {\n  const q = masked[open]\n  if (q !== \"'\" && q !== '\"' && q !== '`') return null\n  const close = masked.indexOf(q, open + 1)\n  if (close === -1) return null\n  return src.slice(open + 1, close)\n}\n\n/** Advance past whitespace in `masked` from `i`. */\nfunction skipWs(masked: string, i: number): number {\n  while (i < masked.length && (masked[i] === ' ' || masked[i] === '\\t' || masked[i] === '\\n' || masked[i] === '\\r')) i++\n  return i\n}\n\nexport function scanProductRefs(files: Record<string, string>): ProductRefScan {\n  const seen = new Set<string>()\n  const order: string[] = []\n  let dynamic = false\n  const add = (v: string) => { if (v && !seen.has(v)) { seen.add(v); order.push(v) } }\n\n  for (const [path, source] of Object.entries(files)) {\n    if (!/\\.(tsx|jsx|ts|js)$/.test(path)) continue\n    const masked = mask(source)\n\n    // useProduct( … ) / useProducts( … ) — positions on the MASK (a call inside a string won't match).\n    for (const m of masked.matchAll(/\\buseProducts?\\s*\\(/g)) {\n      const plural = source.slice(m.index!, m.index! + 11) === 'useProducts'\n      const j = skipWs(masked, m.index! + m[0].length)\n      if (masked[j] === ')') { if (plural) dynamic = true; continue } // useProducts() = whole-catalog wildcard\n      const lit = literalAt(source, masked, j)\n      if (lit !== null) add(lit)\n      else dynamic = true // useProduct(variable) — can't resolve statically\n    }\n\n    // <Checkout product=\"…\"> / <Upsell product=\"…\"> — the `product` attribute value.\n    for (const m of masked.matchAll(/<(?:Checkout|Upsell)\\b[^>]*?\\bproduct\\s*=\\s*/g)) {\n      const j = m.index! + m[0].length\n      const lit = literalAt(source, masked, j)\n      if (lit !== null) add(lit)\n      else if (masked[j] === '{') dynamic = true // product={expr}\n    }\n  }\n  return { slots: order, dynamic }\n}\n","/**\n * Source generators for the funnel build \"machinery\" authors no longer write. `funnel.ts` (the\n * spine: id, responses, products, checkout, and the page list + declarative routing) plus the\n * `pages/` folder are the ONLY authored source. The build (renderer/builder) and the CLI dev server\n * call these to synthesize:\n *   - `mount.tsx`         — code-split page loaders + `createFunnelTree`\n *   - `entry.client.tsx`  — hydrate the SSR'd markup from injected data\n *   - `entry.server.tsx`  — `ssr()` + the compiled `manifest`\n *\n * All string templates, zero runtime deps — this module lives in the pure `@appfunnel-dev/sdk/\n * manifest` entry so tooling imports it without the funnel runtime.\n */\n\nexport interface ScaffoldOptions {\n\t/** Page component keys = `pages/<key>.tsx` filenames (base flow pages AND `@variant` pages). */\n\tpageKeys: string[]\n\t/** Import prefix to reach the funnel root: `'./'` at the root (build), `'../../'` in a subdir (CLI dev). */\n\timportPrefix?: string\n\t/** Whether a `layout.tsx` exists to wrap the pages. */\n\thasLayout?: boolean\n\t/** Whether a `styles.css` exists (client entry imports it). */\n\thasStyles?: boolean\n\t/** Checkout provider from `config.checkout` — wires the driver; omit for none. */\n\tcheckout?: 'stripe' | 'paddle' | null\n\t/** Locales with a `messages/<locale>.json` catalog to bake into the mount (so `t()` resolves at render). */\n\tmessageLocales?: string[]\n\t/** Slot names the pages reference (from `scanProductRefs`), baked into the manifest for validation. */\n\tproductRefs?: string[]\n}\n\n/** A safe JS identifier for a message-catalog import (`en` → `msg_en`, `pt-BR` → `msg_pt_BR`). */\nfunction msgId(locale: string): string {\n\treturn 'msg_' + locale.replace(/[^a-zA-Z0-9]/g, '_')\n}\n\nconst DRIVERS = {\n\tstripe: { name: 'stripeCheckoutDriver', sub: 'driver-stripe' },\n\tpaddle: { name: 'paddleCheckoutDriver', sub: 'driver-paddle' },\n} as const\n\nconst HEADER = '// GENERATED by AppFunnel — do not edit. Built from funnel.ts + the pages/ folder.\\n'\n\n/** `mount.tsx` — the code-split loaders + tree, derived from `config.pages` and the `pages/` files. */\nexport function generateMount(opts: ScaffoldOptions): string {\n\tconst p = opts.importPrefix ?? './'\n\tconst driver = opts.checkout ? DRIVERS[opts.checkout] : null\n\n\tconst locales = opts.messageLocales ?? []\n\tconst imports = [\n\t\t`import { createFunnelTree, type MountOpts, type RuntimePage } from '@appfunnel-dev/sdk'`,\n\t\tdriver && `import { ${driver.name} } from '@appfunnel-dev/sdk/${driver.sub}'`,\n\t\t`import { config } from '${p}funnel'`,\n\t\topts.hasLayout && `import Layout from '${p}layout'`,\n\t\t...locales.map((loc) => `import ${msgId(loc)} from '${p}messages/${loc}.json'`),\n\t]\n\t\t.filter(Boolean)\n\t\t.join('\\n')\n\n\t// A static import() per page file so Vite emits one code-split chunk each.\n\tconst loaders = opts.pageKeys\n\t\t.map(\n\t\t\t(k) => `\\t${JSON.stringify(k)}: () => import(${JSON.stringify(`${p}pages/${k}`)}),`\n\t\t)\n\t\t.join('\\n')\n\n\tconst treeArgs = [\n\t\t'config',\n\t\t'pages',\n\t\topts.hasLayout && 'layout: Layout',\n\t\tdriver && `checkoutDriver: ${driver.name}`,\n\t\tlocales.length > 0 && 'messages',\n\t]\n\t\t.filter(Boolean)\n\t\t.join(', ')\n\n\t// The baked message catalog: locale → messages/<locale>.json (so `t()` resolves at render).\n\tconst messagesConst =\n\t\tlocales.length > 0\n\t\t\t? `\\nconst messages = { ${locales.map((loc) => `${JSON.stringify(loc)}: ${msgId(loc)}`).join(', ')} }\\n`\n\t\t\t: ''\n\n\treturn `${HEADER}${imports}\n\nconst loaders: Record<string, () => Promise<unknown>> = {\n${loaders}\n}\n\n// Flow pages come from funnel.ts (order + meta + routing). Any remaining page file is an off-flow\n// \\`@variant\\` page (wired by experiment records at render time), appended so it's loadable.\nconst decls = config.pages ?? []\nconst flowKeys = new Set(decls.map((d) => d.key))\nexport const pages: RuntimePage[] = [\n\t...decls.map((d) => ({ key: d.key, meta: d, load: loaders[d.key] })),\n\t...Object.keys(loaders)\n\t\t.filter((k) => !flowKeys.has(k))\n\t\t.map((k) => ({ key: k, meta: {}, load: loaders[k] })),\n] as RuntimePage[]\n${messagesConst}\nexport const tree = createFunnelTree({ ${treeArgs} })\n\nexport type { MountOpts }\n`\n}\n\n/** `entry.client.tsx` — hydrate the SSR'd markup from the injected `#__af_data`. */\nexport function generateEntryClient(opts: Pick<ScaffoldOptions, 'importPrefix' | 'hasStyles'>): string {\n\tconst p = opts.importPrefix ?? './'\n\tconst styles = opts.hasStyles ? `import '${p}styles.css'\\n` : ''\n\treturn `${HEADER}${styles}import { hydrateRoot } from 'react-dom/client'\nimport { tree, type MountOpts } from './mount'\n\nconst dataEl = document.getElementById('__af_data')\nconst data = (dataEl?.textContent ? JSON.parse(dataEl.textContent) : {}) as MountOpts & {\n\tinitialKey?: string | null\n}\nconst root = document.getElementById('root')\nif (root) hydrateRoot(root, tree({ ...data, initialKey: data.initialKey ?? undefined }))\n`\n}\n\n/** `entry.server.tsx` — `ssr(opts)` HTML + the compiled `manifest` (read by the build). */\nexport function generateEntryServer(opts: Pick<ScaffoldOptions, 'importPrefix' | 'productRefs'>): string {\n\tconst p = opts.importPrefix ?? './'\n\treturn `${HEADER}import { renderToReadableStream } from 'react-dom/server.browser'\nimport { compileManifest } from '@appfunnel-dev/sdk'\nimport { config } from '${p}funnel'\nimport { tree, pages, type MountOpts } from './mount'\n\nexport const manifest = compileManifest({\n\tfunnel: config,\n\tpages: pages.map((pg) => ({ key: pg.key, meta: pg.meta })),\n\tproductRefs: ${JSON.stringify(opts.productRefs ?? [])},\n})\n\nexport async function ssr(opts: MountOpts): Promise<string> {\n\tconst stream = await renderToReadableStream(tree(opts))\n\tawait stream.allReady\n\treturn await new Response(stream).text()\n}\n`\n}\n\n/** Client-only dev entry (createRoot, no SSR) — for the CLI `dev` server. */\nexport function generateDevEntry(\n\topts: Pick<ScaffoldOptions, 'importPrefix' | 'hasStyles'> & { data: unknown }\n): string {\n\tconst p = opts.importPrefix ?? './'\n\tconst styles = opts.hasStyles ? `import '${p}styles.css'\\n` : ''\n\treturn `${HEADER}${styles}import { createRoot } from 'react-dom/client'\nimport { tree } from './mount'\n\nconst el = document.getElementById('root')\nif (el) createRoot(el).render(tree(${JSON.stringify(opts.data)}))\n`\n}\n"]}

package/dist/manifest-entry.d.cts

@@ -1,8 +1,29 @@
-export { i as CompileInput, j as Condition, k as ConditionOp, E as EdgeCondition, m as ExperimentIssue, o as ExperimentValidation, p as ExperimentVariant, q as FlowPage, c as FunnelDefinition, r as FunnelLocales, s as FunnelManifest, ai as FunnelPage, b as FunnelSnapshot, G as Gate, t as Interval, M as ManifestEdge, u as ManifestPage, v as ManifestValidation, w as Money, f as PageMeta, x as PageType, y as Predicate, P as Product, e as ProductInput, z as ResolvedProduct, H as Route, R as RuntimeExperiment, K as assignVariant, N as bucketingSeed, T as buildCatalog, W as compileManifest, X as currencyExponent, Y as defineFunnel, a3 as formatMoney, a4 as formatProduct, a6 as isRtl, a7 as isVariantKey, aa as pageMeta, ab as parseSlotKey, ae as resolveLocale, af as resolveProduct, ah as validateExperiments, aj as weightsOf } from './manifest-DQThneiG.cjs';
+export { i as CompileInput, j as Condition, k as ConditionOp, E as EdgeCondition, m as ExperimentIssue, o as ExperimentValidation, p as ExperimentVariant, q as FlowPage, c as FunnelDefinition, r as FunnelLocales, s as FunnelManifest, ai as FunnelPage, b as FunnelSnapshot, G as Gate, t as Interval, M as ManifestEdge, u as ManifestPage, v as ManifestValidation, w as Money, f as PageMeta, x as PageType, y as Predicate, P as Product, e as ProductInput, aj as ProductSlot, z as ResolvedProduct, H as Route, R as RuntimeExperiment, K as assignVariant, N as bucketingSeed, T as buildCatalog, W as compileManifest, X as currencyExponent, Y as defineFunnel, a3 as formatMoney, a4 as formatProduct, ak as funnelCatalogKeys, a6 as isRtl, a7 as isVariantKey, al as normalizeProducts, aa as pageMeta, ab as parseSlotKey, ae as resolveLocale, af as resolveProduct, ah as validateExperiments, am as weightsOf } from './manifest-Cr2y1op6.cjs';
 import { C as CheckoutError, b as CheckoutIntent, U as UpsellKind, d as CheckoutSurface } from './capabilities-7_hy5f5G.cjs';
 export { a as CheckoutErrorCategory, c as CheckoutProvider, I as INLINE_SURFACES, O as OffSessionReliability, P as PROVIDER_PROFILES, e as ProviderProfile, S as SurfaceCapability, V as ValidationResult, f as checkoutError, i as isInlineSurface, g as isMerchantOfRecord, h as isOrchestrator, s as surfacesFor, v as validateCheckout, j as validateUpsell } from './capabilities-7_hy5f5G.cjs';
 import 'react';
 
+/**
+ * Pure, React-free page scan: find which product SLOTS a funnel's pages reference — the first
+ * string-literal arg of `useProduct(...)` and the `product` prop of `<Checkout>` / `<Upsell>`.
+ * Ships via `@appfunnel-dev/sdk/manifest` so the BUILD, the EDITOR, and the AI all run the SAME
+ * check. The result feeds `compileManifest({ productRefs })`, which flags references to slots the
+ * funnel doesn't declare (unknown) or hasn't assigned a catalog product to (unassigned).
+ *
+ * Non-literal args (`useProduct(selectedId)`, `product={expr}`) and the `useProducts()` wildcard are
+ * DYNAMIC — they can't be statically enumerated, so they're reported via `dynamic` and never turned
+ * into a hard error (validation relaxes when a funnel is dynamic). Mirrors the mask-then-read
+ * discipline the funnel.ts code-mods use, so a `useProduct('x')` inside a comment or string literal
+ * can't false-positive.
+ */
+interface ProductRefScan {
+    /** Concrete slot names referenced by LITERAL args, deduped, in first-seen order. */
+    slots: string[];
+    /** True if any ref is a non-literal arg or a `useProducts()` wildcard (not statically enumerable). */
+    dynamic: boolean;
+}
+declare function scanProductRefs(files: Record<string, string>): ProductRefScan;
+
 /**
  * Source generators for the funnel build "machinery" authors no longer write. `funnel.ts` (the
  * spine: id, responses, products, checkout, and the page list + declarative routing) plus the
@@ -26,13 +47,17 @@ interface ScaffoldOptions {
     hasStyles?: boolean;
     /** Checkout provider from `config.checkout` — wires the driver; omit for none. */
     checkout?: 'stripe' | 'paddle' | null;
+    /** Locales with a `messages/<locale>.json` catalog to bake into the mount (so `t()` resolves at render). */
+    messageLocales?: string[];
+    /** Slot names the pages reference (from `scanProductRefs`), baked into the manifest for validation. */
+    productRefs?: string[];
 }
 /** `mount.tsx` — the code-split loaders + tree, derived from `config.pages` and the `pages/` files. */
 declare function generateMount(opts: ScaffoldOptions): string;
 /** `entry.client.tsx` — hydrate the SSR'd markup from the injected `#__af_data`. */
 declare function generateEntryClient(opts: Pick<ScaffoldOptions, 'importPrefix' | 'hasStyles'>): string;
 /** `entry.server.tsx` — `ssr(opts)` HTML + the compiled `manifest` (read by the build). */
-declare function generateEntryServer(opts: Pick<ScaffoldOptions, 'importPrefix'>): string;
+declare function generateEntryServer(opts: Pick<ScaffoldOptions, 'importPrefix' | 'productRefs'>): string;
 /** Client-only dev entry (createRoot, no SSR) — for the CLI `dev` server. */
 declare function generateDevEntry(opts: Pick<ScaffoldOptions, 'importPrefix' | 'hasStyles'> & {
     data: unknown;
@@ -181,4 +206,4 @@ interface CheckoutCompleteRequest {
 }
 type CheckoutCompleteResponse = StepSettled | StepPending | StepFailed;
 
-export { type CheckoutCompleteRequest, type CheckoutCompleteResponse, CheckoutError, CheckoutIntent, type CheckoutSessionRequest, type CheckoutSessionResponse, type CheckoutSettlement, CheckoutSurface, type ScaffoldOptions, type StepClientConfirm, type StepEmbedded, type StepFailed, type StepPending, type StepProviderCheckout, type StepRedirect, type StepSettled, UpsellKind, generateDevEntry, generateEntryClient, generateEntryServer, generateMount };
+export { type CheckoutCompleteRequest, type CheckoutCompleteResponse, CheckoutError, CheckoutIntent, type CheckoutSessionRequest, type CheckoutSessionResponse, type CheckoutSettlement, CheckoutSurface, type ProductRefScan, type ScaffoldOptions, type StepClientConfirm, type StepEmbedded, type StepFailed, type StepPending, type StepProviderCheckout, type StepRedirect, type StepSettled, UpsellKind, generateDevEntry, generateEntryClient, generateEntryServer, generateMount, scanProductRefs };

package/dist/manifest-entry.d.ts

@@ -1,8 +1,29 @@
-export { i as CompileInput, j as Condition, k as ConditionOp, E as EdgeCondition, m as ExperimentIssue, o as ExperimentValidation, p as ExperimentVariant, q as FlowPage, c as FunnelDefinition, r as FunnelLocales, s as FunnelManifest, ai as FunnelPage, b as FunnelSnapshot, G as Gate, t as Interval, M as ManifestEdge, u as ManifestPage, v as ManifestValidation, w as Money, f as PageMeta, x as PageType, y as Predicate, P as Product, e as ProductInput, z as ResolvedProduct, H as Route, R as RuntimeExperiment, K as assignVariant, N as bucketingSeed, T as buildCatalog, W as compileManifest, X as currencyExponent, Y as defineFunnel, a3 as formatMoney, a4 as formatProduct, a6 as isRtl, a7 as isVariantKey, aa as pageMeta, ab as parseSlotKey, ae as resolveLocale, af as resolveProduct, ah as validateExperiments, aj as weightsOf } from './manifest-DQThneiG.js';
+export { i as CompileInput, j as Condition, k as ConditionOp, E as EdgeCondition, m as ExperimentIssue, o as ExperimentValidation, p as ExperimentVariant, q as FlowPage, c as FunnelDefinition, r as FunnelLocales, s as FunnelManifest, ai as FunnelPage, b as FunnelSnapshot, G as Gate, t as Interval, M as ManifestEdge, u as ManifestPage, v as ManifestValidation, w as Money, f as PageMeta, x as PageType, y as Predicate, P as Product, e as ProductInput, aj as ProductSlot, z as ResolvedProduct, H as Route, R as RuntimeExperiment, K as assignVariant, N as bucketingSeed, T as buildCatalog, W as compileManifest, X as currencyExponent, Y as defineFunnel, a3 as formatMoney, a4 as formatProduct, ak as funnelCatalogKeys, a6 as isRtl, a7 as isVariantKey, al as normalizeProducts, aa as pageMeta, ab as parseSlotKey, ae as resolveLocale, af as resolveProduct, ah as validateExperiments, am as weightsOf } from './manifest-Cr2y1op6.js';
 import { C as CheckoutError, b as CheckoutIntent, U as UpsellKind, d as CheckoutSurface } from './capabilities-7_hy5f5G.js';
 export { a as CheckoutErrorCategory, c as CheckoutProvider, I as INLINE_SURFACES, O as OffSessionReliability, P as PROVIDER_PROFILES, e as ProviderProfile, S as SurfaceCapability, V as ValidationResult, f as checkoutError, i as isInlineSurface, g as isMerchantOfRecord, h as isOrchestrator, s as surfacesFor, v as validateCheckout, j as validateUpsell } from './capabilities-7_hy5f5G.js';
 import 'react';
 
+/**
+ * Pure, React-free page scan: find which product SLOTS a funnel's pages reference — the first
+ * string-literal arg of `useProduct(...)` and the `product` prop of `<Checkout>` / `<Upsell>`.
+ * Ships via `@appfunnel-dev/sdk/manifest` so the BUILD, the EDITOR, and the AI all run the SAME
+ * check. The result feeds `compileManifest({ productRefs })`, which flags references to slots the
+ * funnel doesn't declare (unknown) or hasn't assigned a catalog product to (unassigned).
+ *
+ * Non-literal args (`useProduct(selectedId)`, `product={expr}`) and the `useProducts()` wildcard are
+ * DYNAMIC — they can't be statically enumerated, so they're reported via `dynamic` and never turned
+ * into a hard error (validation relaxes when a funnel is dynamic). Mirrors the mask-then-read
+ * discipline the funnel.ts code-mods use, so a `useProduct('x')` inside a comment or string literal
+ * can't false-positive.
+ */
+interface ProductRefScan {
+    /** Concrete slot names referenced by LITERAL args, deduped, in first-seen order. */
+    slots: string[];
+    /** True if any ref is a non-literal arg or a `useProducts()` wildcard (not statically enumerable). */
+    dynamic: boolean;
+}
+declare function scanProductRefs(files: Record<string, string>): ProductRefScan;
+
 /**
  * Source generators for the funnel build "machinery" authors no longer write. `funnel.ts` (the
  * spine: id, responses, products, checkout, and the page list + declarative routing) plus the
@@ -26,13 +47,17 @@ interface ScaffoldOptions {
     hasStyles?: boolean;
     /** Checkout provider from `config.checkout` — wires the driver; omit for none. */
     checkout?: 'stripe' | 'paddle' | null;
+    /** Locales with a `messages/<locale>.json` catalog to bake into the mount (so `t()` resolves at render). */
+    messageLocales?: string[];
+    /** Slot names the pages reference (from `scanProductRefs`), baked into the manifest for validation. */
+    productRefs?: string[];
 }
 /** `mount.tsx` — the code-split loaders + tree, derived from `config.pages` and the `pages/` files. */
 declare function generateMount(opts: ScaffoldOptions): string;
 /** `entry.client.tsx` — hydrate the SSR'd markup from the injected `#__af_data`. */
 declare function generateEntryClient(opts: Pick<ScaffoldOptions, 'importPrefix' | 'hasStyles'>): string;
 /** `entry.server.tsx` — `ssr(opts)` HTML + the compiled `manifest` (read by the build). */
-declare function generateEntryServer(opts: Pick<ScaffoldOptions, 'importPrefix'>): string;
+declare function generateEntryServer(opts: Pick<ScaffoldOptions, 'importPrefix' | 'productRefs'>): string;
 /** Client-only dev entry (createRoot, no SSR) — for the CLI `dev` server. */
 declare function generateDevEntry(opts: Pick<ScaffoldOptions, 'importPrefix' | 'hasStyles'> & {
     data: unknown;
@@ -181,4 +206,4 @@ interface CheckoutCompleteRequest {
 }
 type CheckoutCompleteResponse = StepSettled | StepPending | StepFailed;
 
-export { type CheckoutCompleteRequest, type CheckoutCompleteResponse, CheckoutError, CheckoutIntent, type CheckoutSessionRequest, type CheckoutSessionResponse, type CheckoutSettlement, CheckoutSurface, type ScaffoldOptions, type StepClientConfirm, type StepEmbedded, type StepFailed, type StepPending, type StepProviderCheckout, type StepRedirect, type StepSettled, UpsellKind, generateDevEntry, generateEntryClient, generateEntryServer, generateMount };
+export { type CheckoutCompleteRequest, type CheckoutCompleteResponse, CheckoutError, CheckoutIntent, type CheckoutSessionRequest, type CheckoutSessionResponse, type CheckoutSettlement, CheckoutSurface, type ProductRefScan, type ScaffoldOptions, type StepClientConfirm, type StepEmbedded, type StepFailed, type StepPending, type StepProviderCheckout, type StepRedirect, type StepSettled, UpsellKind, generateDevEntry, generateEntryClient, generateEntryServer, generateMount, scanProductRefs };