@appfunnel-dev/sdk 2.0.0-canary.5 → 2.0.0-canary.7

package/dist/{manifest-Dl7faaKe.d.ts → manifest-CMe8yVkr.d.ts}

@@ -140,16 +140,20 @@ interface SessionContext {
 }
 /**
  * Durable identity for **stable experiment bucketing** (phase-4 §4.2). The
- * preferred seed is `customerId` once known; before identification it's the
- * signed anonymous `visitorId` (P1). It is deliberately **not** the session id or
- * fingerprint — a returning visitor (e.g. via winback) must keep their variant
- * across sessions/devices (landmine #4). Both null = unidentifiable traffic, and
- * the experiment layer falls back to control rather than bucket on nothing.
+ * preferred seed is the signed anonymous `visitorId` (stable from the first
+ * pageload, matching the server-side FUNNEL split in resolve.ts); `customerId` is
+ * only the fallback for cookieless SDK embeds. visitorId-FIRST is deliberate — the
+ * anon customerId is minted server-side AFTER the first tracked event, so seeding
+ * on it would flip a returning visitor's arm between visit 1 and 2 (see
+ * {@link ../flow/experiments}.bucketingSeed). It is deliberately **not** the
+ * session id or fingerprint — a returning visitor (e.g. via winback) must keep
+ * their variant across sessions (landmine #4). Both null = unidentifiable traffic,
+ * and the experiment layer falls back to control rather than bucket on nothing.
  */
 interface IdentityContext {
-    /** Known customer id (post-identification). The preferred bucketing seed. */
+    /** Known customer id (post-identification). The fallback bucketing seed (cookieless embeds). */
     customerId: string | null;
-    /** Signed anonymous visitor id. The fallback bucketing seed. */
+    /** Signed anonymous visitor id. The preferred bucketing seed (stable from visit 1). */
     visitorId: string | null;
 }
 interface SystemContext {
@@ -203,14 +207,14 @@ declare function buildContext(opts?: BuildContextOptions): FunnelContext;
 /**
  * Pure catalog math — no React, no I/O. Split out of {@link ./catalog} so the
  * server/tooling entry (`@appfunnel-dev/sdk/manifest`) can compile/resolve
- * products without pulling react-dom or any component code into its graph.
+ * offerings without pulling react-dom or any component code into its graph.
  * {@link ./catalog} re-exports everything here and adds the React wiring.
  */
 type Interval = 'day' | 'week' | 'month' | 'year' | 'one_time';
-/** What the platform hands the funnel per product (a single provider-resolved price). */
-interface ProductInput {
+/** What the platform hands the funnel per offering (a single provider-resolved price). */
+interface OfferingInput {
     id: string;
-    /** The catalog product KEY this input charges (the slot's assignment). Defaults to `id` (legacy/identity slots). */
+    /** The catalog charge KEY this input charges (the slot's assignment). Defaults to `id` (legacy/identity slots). */
     catalogKey?: string;
     name?: string;
     displayName?: string;
@@ -237,12 +241,12 @@ interface Money {
     formatted: string;
 }
 /**
- * The product with its amounts resolved (currency + period math), **before**
- * locale formatting — what the catalog stores. `useProduct` formats it.
+ * The offering with its amounts resolved (currency + period math), **before**
+ * locale formatting — what the catalog stores. `useOffering` formats it.
  */
-interface ResolvedProduct {
+interface ResolvedOffering {
     id: string;
-    /** The catalog product KEY charged (the CHARGE identity; `id` is the SLOT/display identity). */
+    /** The catalog charge KEY charged (the CHARGE identity; `id` is the SLOT/display identity). */
     catalogKey: string;
     name: string;
     displayName: string;
@@ -259,10 +263,10 @@ interface ResolvedProduct {
     trialDays: number;
     trialMinor: number;
 }
-/** Display-ready product the author reads (every amount locale-formatted). */
-interface Product {
+/** Display-ready offering the author reads (every amount locale-formatted). */
+interface Offering {
     id: string;
-    /** The catalog product KEY charged (the CHARGE identity; `id` is the SLOT/display identity). */
+    /** The catalog charge KEY charged (the CHARGE identity; `id` is the SLOT/display identity). */
     catalogKey: string;
     name: string;
     displayName: string;
@@ -282,13 +286,13 @@ interface Product {
     trialPrice: Money | null;
 }
 /**
- * Resolve a {@link ProductInput} into amounts + period math (no formatting yet).
+ * Resolve an {@link OfferingInput} into amounts + period math (no formatting yet).
  * Per-period amounts are **integer minor units** (each derived from the exact
  * daily rate, then rounded — never round-then-multiply, so error doesn't compound).
  */
-declare function resolveProduct(input: ProductInput): ResolvedProduct;
-/** Build the id → {@link ResolvedProduct} catalog. Formatting happens at read time. */
-declare function buildCatalog(inputs: ProductInput[]): Map<string, ResolvedProduct>;
+declare function resolveOffering(input: OfferingInput): ResolvedOffering;
+/** Build the id → {@link ResolvedOffering} catalog. Formatting happens at read time. */
+declare function buildCatalog(inputs: OfferingInput[]): Map<string, ResolvedOffering>;
 /**
  * The minor-unit exponent for a currency (`USD`→2, `JPY`→0, `KWD`/`BHD`→3),
  * derived from `Intl.NumberFormat(...).resolvedOptions().maximumFractionDigits`
@@ -297,8 +301,8 @@ declare function buildCatalog(inputs: ProductInput[]): Map<string, ResolvedProdu
 declare function currencyExponent(currency: string): number;
 /** Format minor units of `currency` in `locale` (exponent-aware: 7900 JPY = ¥7,900). */
 declare function formatMoney(minor: number, currency: string, locale: string): Money;
-/** Format a {@link ResolvedProduct} into a display {@link Product} in `locale`. */
-declare function formatProduct(r: ResolvedProduct, locale: string): Product;
+/** Format a {@link ResolvedOffering} into a display {@link Offering} in `locale`. */
+declare function formatOffering(r: ResolvedOffering, locale: string): Offering;
 
 /**
  * The funnel **spine** — the constrained, declarative configuration authored as
@@ -372,6 +376,13 @@ interface PageMeta {
     /**
      * Ordered routing edges out of this page (first match wins). Each has a static
      * `to` key + an optional `when` gate. Omit for the default linear flow.
+     *
+     * OPTIONAL per-variant routing: a `@variant` page (`paywall@b`) MAY carry its own
+     * `next`. When that variant is the one served for its slot, its `next` governs
+     * routing for that visitor; absent, the variant inherits the slot's routing (the
+     * default — a pure superset, no behavior change for existing funnels). Assignment,
+     * exposure, and progress still anchor on the slot; only the next-page lookup
+     * consults the served variant's routes. See {@link FunnelPage}.
      */
     next?: Route[];
     /**
@@ -425,6 +436,15 @@ interface FlowPage {
  * AUTHORED shape (funnel.ts owns the page list, order, and routing); the build generates
  * the code-split `mount.tsx` from it. Routing (`next`) must stay DECLARATIVE (Route[] with
  * `{ to, when }` conditions, no predicate functions) so the web builder UI can edit it.
+ *
+ * OPTIONAL variant routing (default off): a served variant's OWN routing is authored by
+ * declaring the variant here with its `@` key and a `next`, e.g.
+ * `{ key: 'paywall@b', next: [{ to: 'special-offer' }] }`. A variant declared this way keys
+ * on the `@` marker, so it still collapses out of the linear flow (it is NOT a linear step);
+ * its `next` is consulted only when that variant is the one served for its slot. Omit the
+ * declaration (leave the variant an undeclared `pages/<slot>@<v>.tsx` file) to inherit the
+ * slot's routing — the existing behavior, unchanged. The slot's control keeps owning
+ * assignment/exposure/progress; only the next-page lookup for a branched variant differs.
  */
 interface FunnelPage extends PageMeta {
     key: string;
@@ -483,19 +503,19 @@ interface FunnelDefinition {
     /** `data.*` working/scratch variables (default values). */
     data?: Record<string, VariableConfig>;
     /**
-     * The catalog products this funnel sells, as SLOTS: a local, stable key each PAGE
-     * references (`useProduct('primary')`, `<Checkout product="primary">`) → the catalog product
+     * The catalog offerings this funnel sells, as SLOTS: a local, stable key each PAGE
+     * references (`useOffering('primary')`, `<Checkout offering="primary">`) → the catalog charge
      * 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>;
+    offerings?: string[] | Record<string, string | null>;
     locales?: FunnelLocales;
     /**
      * When `true`, the funnel shows the **geo-specific** currency/price the payment
      * provider resolves (Stripe `currency_options`, Paddle preview, Whop, SolidGate,
-     * …). When `false` (default), a single fixed currency is used. AppFunnel does no
+     * …). When `false` (default), a single fixed currency is used. Appfunnel does no
      * FX — this only toggles whether the platform asks the provider for the geo
      * price; the SDK just displays whatever resolved `{amount, currency}` it's handed.
      * (See docs/platform-v2 phase-3 §3.6.)
@@ -504,19 +524,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 {
+/** A funnel offering SLOT: the local key pages reference → the assigned catalog charge key (null = unassigned). */
+interface OfferingSlot {
     slot: string;
     catalogKey: string | null;
 }
 /**
- * Normalize `FunnelDefinition.products` to a slot list. A legacy `string[]` becomes IDENTITY
+ * Normalize `FunnelDefinition.offerings` 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).
+ * entries (insertion order preserved, so `useOfferings()` is deterministic).
  */
-declare function normalizeProducts(products: FunnelDefinition['products']): ProductSlot[];
+declare function normalizeOfferings(offerings: FunnelDefinition['offerings']): OfferingSlot[];
 /** The unique, ASSIGNED catalog keys a funnel charges — for the promote gate + catalog reverse-lookup. */
-declare function funnelCatalogKeys(products: FunnelDefinition['products']): string[];
+declare function funnelCatalogKeys(offerings: FunnelDefinition['offerings']): string[];
 
 /**
  * Pure locale resolution — no React. Split out of {@link ./translation} so the
@@ -610,8 +630,8 @@ declare function parseSlotKey(key: string): {
 };
 /** True if a page key is an off-flow variant (`welcome@b`), by the source-side `@` marker. */
 declare function isVariantKey(key: string): boolean;
-/** One arm of an experiment: which page renders, at what weight. */
-interface ExperimentVariant {
+/** One arm of a running experiment: which page renders, at what weight. */
+interface ExperimentArm {
     /** The page key this arm renders (the slot's control, or a `@variant` sibling). */
     page: string;
     /** Relative weight in the split (need not sum to 100; zero = paused arm). */
@@ -619,19 +639,24 @@ interface ExperimentVariant {
 }
 /**
  * A runtime experiment record — the operational wiring the **platform** owns and
- * hands to the SDK (not authored in the funnel source). The variant *pages* are
- * code in the bundle; this is the live config over them.
+ * hands to the SDK (not authored in the funnel source). Projected from the unified
+ * `Experiment`/`ExperimentArm` graph (a RUNNING PAGE experiment + its arms): the
+ * experiment's `slot` names the base page, and each arm becomes a `variants` entry
+ * `{ page: arm.pageKey, weight: arm.weight }` keyed by `arm.label`. The variant
+ * *pages* are code in the LIVE build; this is the live split over them.
+ *
+ * The serve join only ever hands over RUNNING experiments, and the server's
+ * draft-write + serve guards make every active arm's page GUARANTEED present in the
+ * LIVE build (an experiment owns its arm pages' lifecycle — you end the experiment to
+ * remove a page, you can't drift it away). So there is no lifecycle/winner state and
+ * no "arm page missing" case to resolve here.
  */
 interface RuntimeExperiment {
     id: string;
-    /** The page key holding the flow position (the anchor / control). */
+    /** The page key holding the flow position (the anchor / the control arm's base page). */
     slot: string;
-    /** label → arm. One arm's `page` is the `slot` (control); others are `@variant` siblings. */
-    variants: Record<string, ExperimentVariant>;
-    /** Lifecycle. Absent = running. */
-    status?: 'running' | 'paused' | 'stopped';
-    /** When stopped, the variant label everyone sees until promotion bakes it into the slot. */
-    winner?: string;
+    /** label → arm. The control arm's `page` is the `slot`; others are `@variant` siblings. */
+    variants: Record<string, ExperimentArm>;
     /** Primary metric (analytics only; not used for resolution). */
     metric?: string;
     /** Platform record version (immutable-while-running; reweight = new version). Rides on
@@ -661,43 +686,20 @@ declare function weightsOf(variants: Record<string, {
     weight: number;
 }>): Record<string, number>;
 /**
- * Resolve which page version each experiment slot shows for this visitor, and
- * which page keys remain in the linear flow.
+ * Resolve which page version each experiment slot shows for this visitor, and which
+ * page keys remain in the linear flow.
  *
- * Variant pages are detected structurally by the `@` in their key, so they
- * collapse out of the linear flow even for a slot with no active experiment.
- * For each *running* experiment the visitor is bucketed (stable on `seed`); a
- * *stopped* one serves its `winner`; a *paused* one (or no seed) serves the slot.
+ * Variant pages are detected structurally by the `@` in their key, so they collapse
+ * out of the linear flow even for a slot with no active experiment. Each served
+ * experiment is RUNNING with all its arm pages guaranteed present in the LIVE build
+ * (the server draft-write + serve guards enforce the experiment-owned lifecycle
+ * invariant), so the visitor is bucketed deterministically on `seed` and the assigned
+ * arm's page is swapped in with no presence check. With no `seed` there is nothing
+ * stable to bucket on, so every slot renders its own control page.
  */
 declare function resolveExperiments(pages: {
     key: string;
 }[], experiments: RuntimeExperiment[], seed: string | null): ExperimentResolution;
-/** One referential problem with an experiment record. */
-interface ExperimentIssue {
-    /** The offending experiment id (`'*'` for a cross-experiment issue). */
-    experimentId: string;
-    code: 'slot_missing' | 'slot_is_variant' | 'slot_conflict' | 'duplicate_id' | 'variant_page_missing' | 'variant_slot_mismatch' | 'no_control' | 'no_traffic' | 'negative_weight' | 'bad_winner' | 'single_arm' | 'orphan_variant';
-    message: string;
-}
-interface ExperimentValidation {
-    ok: boolean;
-    errors: ExperimentIssue[];
-    warnings: ExperimentIssue[];
-}
-/**
- * Cross-check experiment records against the funnel's pages — the publish-time /
- * experiment-edit gate that catches the dangling references the runtime can't see
- * (the experiment wiring lives in the DB; the pages live in the build, so they can
- * drift). Pure: hand it the runtime experiments + the funnel's page keys (e.g.
- * `manifest.pages`).
- *
- * Errors block; warnings inform. `orphan_variant` is a warning, not an error — a
- * `@variant` file with no running experiment is dead-but-harmless (a paused test, or
- * one not wired yet).
- */
-declare function validateExperiments(experiments: RuntimeExperiment[], pages: {
-    key: string;
-}[]): ExperimentValidation;
 
 /**
  * The **manifest** — the declarative IR a funnel project compiles to (doc 06).
@@ -773,6 +775,13 @@ interface ManifestEdge {
     kind: 'branch' | 'linear';
     /** Absent = unconditional (a fallback route, or the linear fall-through). */
     condition?: EdgeCondition;
+    /**
+     * True on a **variant-only branch**: an edge whose `from` is a `@variant` key,
+     * emitted when that served variant carries its OWN `meta.next` (optional divergent
+     * routing). Lets consumers (the editor's Flow canvas) tell a variant's private branch
+     * apart from a normal slot edge. Optional/absent on every non-variant edge.
+     */
+    variant?: true;
 }
 interface ManifestValidation {
     /**
@@ -810,9 +819,9 @@ 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. */
+    /** Slot names a PAGE references (`useOffering`/`<Checkout offering>`) that the funnel doesn't declare — hard error. */
+    unknownOfferingRefs: string[];
+    /** Declared slots a page references but which have no catalog charge key assigned (map value `null`) — hard error. */
     unassignedSlots: string[];
 }
 interface FunnelManifest {
@@ -824,11 +833,11 @@ interface FunnelManifest {
         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[];
+    offerings: string[];
+    /** Offering SLOTS: slot → assigned catalog key|null. `offerings` above is the unique assigned keys. */
+    offeringSlots: OfferingSlot[];
+    /** Slot names PAGES reference (from the build's scan); validated against `offeringSlots`. Absent = no scan ran. */
+    offeringRefs?: string[];
     locales?: FunnelLocales;
     validation: ManifestValidation;
 }
@@ -839,10 +848,10 @@ interface CompileInput {
         key: string;
         meta?: PageMeta;
     }[];
-    /** Slot names the funnel's PAGES reference (from `scanProductRefs`) — cross-checked against the declared slots. */
-    productRefs?: string[];
+    /** Slot names the funnel's PAGES reference (from `scanOfferingRefs`) — cross-checked against the declared slots. */
+    offeringRefs?: 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, 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 };
+export { expectedPathLength 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, assignVariant as H, type IdentityContext as I, bucketingSeed as J, buildAcquisition as K, type LocaleContext as L, type ManifestEdge as M, buildCatalog as N, type Offering as O, type PageMeta as P, compileManifest as Q, type RuntimeExperiment as R, type SessionContext as S, currencyExponent as T, type UtmContext as U, type VariableValue as V, defineFunnel as W, definePage as X, entryGuard as Y, evaluateCondition as Z, evaluateGate as _, type VariableConfig as a, fnv1a as a0, formatMoney as a1, formatOffering as a2, hashToUnit as a3, isRtl as a4, isVariantKey as a5, nextPage as a6, outgoingKeys as a7, pageMeta as a8, parseSlotKey as a9, pickByWeight as aa, resolveExperiments as ab, resolveLocale as ac, resolveOffering as ad, resolveRoute as ae, type FunnelPage as af, type OfferingSlot as ag, funnelCatalogKeys as ah, normalizeOfferings as ai, weightsOf as aj, type FunnelSnapshot as b, type FunnelDefinition as c, buildContext as d, type OfferingInput as e, type PageContext as f, type BuildContextOptions as g, type CompileInput as h, type Condition as i, type ConditionOp as j, type DeviceContext as k, type ExperimentArm as l, type ExperimentResolution as m, type FlowPage as n, type FunnelLocales as o, type FunnelManifest as p, type Interval as q, type ManifestPage as r, type ManifestValidation as s, type Money as t, type OsContext as u, type PageType as v, type Predicate as w, type ResolvedOffering as x, type Route as y, type SystemContext as z };

package/dist/manifest-entry.cjs

@@ -1,10 +1,10 @@
 'use strict';
 
-var chunkG44BUG6G_cjs = require('./chunk-G44BUG6G.cjs');
+var chunkBPOAWI4G_cjs = require('./chunk-BPOAWI4G.cjs');
 var chunkQMAZGLGV_cjs = require('./chunk-QMAZGLGV.cjs');
 require('./chunk-EMMSS5I5.cjs');
 
-// src/manifest/product-refs.ts
+// src/manifest/offering-refs.ts
 function mask(src) {
   const out = src.split("");
   const n = src.length;
@@ -60,7 +60,7 @@ function skipWs(masked, i) {
   while (i < masked.length && (masked[i] === " " || masked[i] === "	" || masked[i] === "\n" || masked[i] === "\r")) i++;
   return i;
 }
-function scanProductRefs(files) {
+function scanOfferingRefs(files) {
   const seen = /* @__PURE__ */ new Set();
   const order = [];
   let dynamic = false;
@@ -73,8 +73,8 @@ function scanProductRefs(files) {
   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";
+    for (const m of masked.matchAll(/\buseOfferings?\s*\(/g)) {
+      const plural = source.slice(m.index, m.index + 12) === "useOfferings";
       const j = skipWs(masked, m.index + m[0].length);
       if (masked[j] === ")") {
         if (plural) dynamic = true;
@@ -84,7 +84,7 @@ function scanProductRefs(files) {
       if (lit !== null) add(lit);
       else dynamic = true;
     }
-    for (const m of masked.matchAll(/<(?:Checkout|Upsell)\b[^>]*?\bproduct\s*=\s*/g)) {
+    for (const m of masked.matchAll(/<(?:Checkout|Upsell)\b[^>]*?\boffering\s*=\s*/g)) {
       const j = m.index + m[0].length;
       const lit = literalAt(source, masked, j);
       if (lit !== null) add(lit);
@@ -102,7 +102,7 @@ var DRIVERS = {
   stripe: { name: "stripeCheckoutDriver", sub: "driver-stripe" },
   paddle: { name: "paddleCheckoutDriver", sub: "driver-paddle" }
 };
-var HEADER = "// GENERATED by AppFunnel \u2014 do not edit. Built from funnel.ts + the pages/ folder.\n";
+var HEADER = "// GENERATED by Appfunnel \u2014 do not edit. Built from funnel.ts + the pages/ folder.\n";
 function generateMount(opts) {
   const p = opts.importPrefix ?? "./";
   const driver = opts.checkout ? DRIVERS[opts.checkout] : null;
@@ -112,7 +112,9 @@ function generateMount(opts) {
     driver && `import { ${driver.name} } from '@appfunnel-dev/sdk/${driver.sub}'`,
     `import { config } from '${p}funnel'`,
     opts.hasLayout && `import Layout from '${p}layout'`,
-    ...locales.map((loc) => `import ${msgId(loc)} from '${p}messages/${loc}.json'`)
+    ...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}`)}),`
@@ -133,8 +135,10 @@ const loaders: Record<string, () => Promise<unknown>> = {
 ${loaders}
 }
 
-// Flow pages come from funnel.ts (order + meta + routing). Any remaining page file is an off-flow
-// \`@variant\` page (wired by experiment records at render time), appended so it's loadable.
+// Flow pages come from funnel.ts (order + meta + routing). A \`@variant\` page MAY also be declared
+// there (with its \`@\` key) to carry its OWN optional routing (\`next\`) \u2014 it still collapses out of
+// the linear flow by the \`@\` marker, but its meta rides along here. Any page file NOT declared is an
+// off-flow \`@variant\` with no own routing, appended with empty meta so it's still loadable.
 const decls = config.pages ?? []
 const flowKeys = new Set(decls.map((d) => d.key))
 export const pages: RuntimePage[] = [
@@ -180,7 +184,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 ?? [])},
+	offeringRefs: ${JSON.stringify(opts.offeringRefs ?? [])},
 })
 
 export async function ssr(opts: MountOpts): Promise<string> {
@@ -204,83 +208,79 @@ if (el) createRoot(el).render(tree(${JSON.stringify(opts.data)}))
 
 Object.defineProperty(exports, "assignVariant", {
   enumerable: true,
-  get: function () { return chunkG44BUG6G_cjs.assignVariant; }
+  get: function () { return chunkBPOAWI4G_cjs.assignVariant; }
 });
 Object.defineProperty(exports, "bucketingSeed", {
   enumerable: true,
-  get: function () { return chunkG44BUG6G_cjs.bucketingSeed; }
+  get: function () { return chunkBPOAWI4G_cjs.bucketingSeed; }
 });
 Object.defineProperty(exports, "buildCatalog", {
   enumerable: true,
-  get: function () { return chunkG44BUG6G_cjs.buildCatalog; }
+  get: function () { return chunkBPOAWI4G_cjs.buildCatalog; }
 });
 Object.defineProperty(exports, "compileManifest", {
   enumerable: true,
-  get: function () { return chunkG44BUG6G_cjs.compileManifest; }
+  get: function () { return chunkBPOAWI4G_cjs.compileManifest; }
 });
 Object.defineProperty(exports, "currencyExponent", {
   enumerable: true,
-  get: function () { return chunkG44BUG6G_cjs.currencyExponent; }
+  get: function () { return chunkBPOAWI4G_cjs.currencyExponent; }
 });
 Object.defineProperty(exports, "defineFunnel", {
   enumerable: true,
-  get: function () { return chunkG44BUG6G_cjs.defineFunnel; }
+  get: function () { return chunkBPOAWI4G_cjs.defineFunnel; }
 });
 Object.defineProperty(exports, "entryGuard", {
   enumerable: true,
-  get: function () { return chunkG44BUG6G_cjs.entryGuard; }
+  get: function () { return chunkBPOAWI4G_cjs.entryGuard; }
 });
 Object.defineProperty(exports, "evaluateCondition", {
   enumerable: true,
-  get: function () { return chunkG44BUG6G_cjs.evaluateCondition; }
+  get: function () { return chunkBPOAWI4G_cjs.evaluateCondition; }
 });
 Object.defineProperty(exports, "formatMoney", {
   enumerable: true,
-  get: function () { return chunkG44BUG6G_cjs.formatMoney; }
+  get: function () { return chunkBPOAWI4G_cjs.formatMoney; }
 });
-Object.defineProperty(exports, "formatProduct", {
+Object.defineProperty(exports, "formatOffering", {
   enumerable: true,
-  get: function () { return chunkG44BUG6G_cjs.formatProduct; }
+  get: function () { return chunkBPOAWI4G_cjs.formatOffering; }
 });
 Object.defineProperty(exports, "funnelCatalogKeys", {
   enumerable: true,
-  get: function () { return chunkG44BUG6G_cjs.funnelCatalogKeys; }
+  get: function () { return chunkBPOAWI4G_cjs.funnelCatalogKeys; }
 });
 Object.defineProperty(exports, "isRtl", {
   enumerable: true,
-  get: function () { return chunkG44BUG6G_cjs.isRtl; }
+  get: function () { return chunkBPOAWI4G_cjs.isRtl; }
 });
 Object.defineProperty(exports, "isVariantKey", {
   enumerable: true,
-  get: function () { return chunkG44BUG6G_cjs.isVariantKey; }
+  get: function () { return chunkBPOAWI4G_cjs.isVariantKey; }
 });
-Object.defineProperty(exports, "normalizeProducts", {
+Object.defineProperty(exports, "normalizeOfferings", {
   enumerable: true,
-  get: function () { return chunkG44BUG6G_cjs.normalizeProducts; }
+  get: function () { return chunkBPOAWI4G_cjs.normalizeOfferings; }
 });
 Object.defineProperty(exports, "pageMeta", {
   enumerable: true,
-  get: function () { return chunkG44BUG6G_cjs.pageMeta; }
+  get: function () { return chunkBPOAWI4G_cjs.pageMeta; }
 });
 Object.defineProperty(exports, "parseSlotKey", {
   enumerable: true,
-  get: function () { return chunkG44BUG6G_cjs.parseSlotKey; }
+  get: function () { return chunkBPOAWI4G_cjs.parseSlotKey; }
 });
 Object.defineProperty(exports, "resolveLocale", {
   enumerable: true,
-  get: function () { return chunkG44BUG6G_cjs.resolveLocale; }
+  get: function () { return chunkBPOAWI4G_cjs.resolveLocale; }
 });
-Object.defineProperty(exports, "resolveProduct", {
+Object.defineProperty(exports, "resolveOffering", {
   enumerable: true,
-  get: function () { return chunkG44BUG6G_cjs.resolveProduct; }
-});
-Object.defineProperty(exports, "validateExperiments", {
-  enumerable: true,
-  get: function () { return chunkG44BUG6G_cjs.validateExperiments; }
+  get: function () { return chunkBPOAWI4G_cjs.resolveOffering; }
 });
 Object.defineProperty(exports, "weightsOf", {
   enumerable: true,
-  get: function () { return chunkG44BUG6G_cjs.weightsOf; }
+  get: function () { return chunkBPOAWI4G_cjs.weightsOf; }
 });
 Object.defineProperty(exports, "INLINE_SURFACES", {
   enumerable: true,
@@ -322,6 +322,6 @@ exports.generateDevEntry = generateDevEntry;
 exports.generateEntryClient = generateEntryClient;
 exports.generateEntryServer = generateEntryServer;
 exports.generateMount = generateMount;
-exports.scanProductRefs = scanProductRefs;
+exports.scanOfferingRefs = scanOfferingRefs;
 //# sourceMappingURL=manifest-entry.cjs.map
 //# sourceMappingURL=manifest-entry.cjs.map

package/dist/manifest-entry.cjs.map

@@ -1 +1 @@
-{"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')\n// FLASH-FREE HYDRATION (SSR-isolation Option B): always DEFER sessionValues on the client. The\n// markup we hydrate against is DEFAULT-state (build-time prerendered, or an SSR render with empty\n// sessionValues), so seeding the store with defaults for the first render is a byte-clean match —\n// no hydration mismatch. The visitor's saved answers (data.sessionValues, present on the \"tail\"\n// path) are then applied post-hydration, popping into already-visible controls with no empty\n// flash. On the cold path sessionValues is absent, so deferring is a no-op (identical output).\nif (root) hydrateRoot(root, tree({ ...data, initialKey: data.initialKey ?? undefined, deferSessionValues: true }))\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"]}
+{"version":3,"sources":["../src/manifest/offering-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 offering SLOTS a funnel's pages reference — the first\n * string-literal arg of `useOffering(...)` and the `offering` 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({ offeringRefs })`, which flags references to slots the\n * funnel doesn't declare (unknown) or hasn't assigned a catalog charge key to (unassigned).\n *\n * Non-literal args (`useOffering(selectedId)`, `offering={expr}`) and the `useOfferings()` 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 `useOffering('x')` inside a comment or string literal\n * can't false-positive.\n */\n\nexport interface OfferingRefScan {\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 `useOfferings()` 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 scanOfferingRefs(files: Record<string, string>): OfferingRefScan {\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    // useOffering( … ) / useOfferings( … ) — positions on the MASK (a call inside a string won't match).\n    for (const m of masked.matchAll(/\\buseOfferings?\\s*\\(/g)) {\n      const plural = source.slice(m.index!, m.index! + 12) === 'useOfferings'\n      const j = skipWs(masked, m.index! + m[0].length)\n      if (masked[j] === ')') { if (plural) dynamic = true; continue } // useOfferings() = whole-catalog wildcard\n      const lit = literalAt(source, masked, j)\n      if (lit !== null) add(lit)\n      else dynamic = true // useOffering(variable) — can't resolve statically\n    }\n\n    // <Checkout offering=\"…\"> / <Upsell offering=\"…\"> — the `offering` attribute value.\n    for (const m of masked.matchAll(/<(?:Checkout|Upsell)\\b[^>]*?\\boffering\\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 // offering={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, offerings, 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 `scanOfferingRefs`), baked into the manifest for validation. */\n\tofferingRefs?: 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 =\n\t'// 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 &&\n\t\t\t`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(\n\t\t\t(loc) => `import ${msgId(loc)} from '${p}messages/${loc}.json'`\n\t\t),\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) =>\n\t\t\t\t`\\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). A \\`@variant\\` page MAY also be declared\n// there (with its \\`@\\` key) to carry its OWN optional routing (\\`next\\`) — it still collapses out of\n// the linear flow by the \\`@\\` marker, but its meta rides along here. Any page file NOT declared is an\n// off-flow \\`@variant\\` with no own routing, appended with empty meta so it's still 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(\n\topts: Pick<ScaffoldOptions, 'importPrefix' | 'hasStyles'>\n): 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')\n// FLASH-FREE HYDRATION (SSR-isolation Option B): always DEFER sessionValues on the client. The\n// markup we hydrate against is DEFAULT-state (build-time prerendered, or an SSR render with empty\n// sessionValues), so seeding the store with defaults for the first render is a byte-clean match —\n// no hydration mismatch. The visitor's saved answers (data.sessionValues, present on the \"tail\"\n// path) are then applied post-hydration, popping into already-visible controls with no empty\n// flash. On the cold path sessionValues is absent, so deferring is a no-op (identical output).\nif (root) hydrateRoot(root, tree({ ...data, initialKey: data.initialKey ?? undefined, deferSessionValues: true }))\n`\n}\n\n/** `entry.server.tsx` — `ssr(opts)` HTML + the compiled `manifest` (read by the build). */\nexport function generateEntryServer(\n\topts: Pick<ScaffoldOptions, 'importPrefix' | 'offeringRefs'>\n): 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\tofferingRefs: ${JSON.stringify(opts.offeringRefs ?? [])},\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'> & {\n\t\tdata: unknown\n\t}\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"]}