@evinvest/kitstart 0.13.0 → 0.15.0

package/README.md

@@ -45,7 +45,7 @@ brand's `flake.nix` is its own config plus one call — `template/flake.nix` is
 the whole of one:
 
 ```nix
-inputs.ev.url = "github:EV-invest/lib?ref=@evinvest/kitstart-v0.13.0"; # the version in package-lock.json
+inputs.ev.url = "github:EV-invest/lib?ref=@evinvest/kitstart-v0.15.0"; # the version in package-lock.json
 inputs.ev.inputs.v_flakes.follows = "v_flakes";
 
 landing = ev.lib.mkLanding {
@@ -122,7 +122,7 @@ the two must be one release. Pin the flake to the matching
 Structural only — where behaviour matters more than look. Marketing sections
 (hero, prices, reviews…) stay in the brand until two brands hold the same one.
 Each widget is a Server Component unless it needs the browser (`MapFacade`,
-`AnalyticsBoundary`, `FormSelect`), styled with the kit's token roles only, restyled through
+`AnalyticsBoundary`, `FormSelect`, `AbSwitcher`), styled with the kit's token roles only, restyled through
 `className` — and, where a brand needs geometry inside one (`Faq`, `CallBar`,
 `StatusScreen`, `PlaceDirectory`, `Coverage`), through its named parts:
 `classNames={{ list: "rounded-none", answer: "px-2" }}`, merged after the
@@ -166,6 +166,7 @@ which CI runs: `npm run check:template -- --e2e`).
 |---|---|
 | `name`, `options: { value, label }[]` | the posted field and its choices (labels are text) |
 | `defaultValue` | without it: empty under a `placeholder`, else the first option — the native rule |
+| `value` | controlled: shown and posted until the parent changes it from `onValueChange`; `""` is the placeholder, `undefined` uncontrolled |
 | `placeholder` | an empty, unpickable choice shown until one is made |
 | `required`, `disabled` | as on a `<select>`: required refuses the submit, disabled posts nothing |
 | `size` | `sm` · `md` · `lg` (the landing's) — the kit's form scale |
@@ -175,7 +176,7 @@ which CI runs: `npm run check:template -- --e2e`).
 
 - **The value survives the swap.** A choice made in the native select before
   the script arrived is read in the hydration commit; a form `reset` puts the
-  default back in both states. With nothing chosen (under a `placeholder`) it
+  default back in both states (uncontrolled; under `value`, see below). With nothing chosen (under a `placeholder`) it
   posts nothing, as a native select on its disabled placeholder does.
 - **`required` still refuses the submit.** A `type="hidden"` input is never
   validated, so under `required` the value rides in a transparent input under
@@ -192,6 +193,19 @@ which CI runs: `npm run check:template -- --e2e`).
 - **Weight.** It is a client module and pulls the kit's `Select` into the
   page: 3.8 KB gz of first-load JS on the template's place page (152,774 →
   156,565 B of its 158,000 B budget).
+- **Controlled, as an `<input>`.** Under `value` the prop is the value: a
+  pick only calls `onValueChange`, and the parent's state (or a reset of its
+  own, `setSubject("")` back to the placeholder) is what moves it. A form
+  `reset` leaves it on `value` — clear the parent's state from the form's
+  `onReset` if it should follow. Without JavaScript it is still the native
+  select, starting on `value`; a pick made there before hydration is reported
+  through `onValueChange`. Switching between `value` and `undefined` warns
+  once in development, as React does for an input, and keeps the last value.
+
+```tsx
+const [subject, setSubject] = useState<string>(LEAD.subjects[0]);
+<FormSelect name={LEAD.wire.subject} size="lg" value={subject} onValueChange={setSubject} options={subjects} />
+```
 
 ### `LeadCapture`: the lead form every brand shares
 
@@ -208,8 +222,8 @@ it is the plain POST to `/quote` it always was.
   wire={LEAD.wire}
   needs={LEAD.subjects.map(s => ({ value: s, label: t.subjects[s] }))}
   text={{ ...LEAD_CAPTURE_TEXT[view.locale], submit: "…" }}
-  layout={arm === "b" ? "qualify-first" : "single"}
-  experiment={{ name: "lead_layout", variant: arm }}
+  layout={arm === "b" ? "steps" : "single"}
+  experiment={{ name: "lead_form", variant: arm }}
 />
 ```
 
@@ -217,9 +231,16 @@ it is the plain POST to `/quote` it always was.
 |---|---|
 | `place`, `contact` | the hours order the channels, the service area suggests the commune; `contact` is `contactOf(site, place)` — a `null` number is a channel not offered |
 | `locale`, `renderedAt` | the page's language; the render stamp (time trap, and "now" until the script runs) |
-| `wire`, `needs` | `site.lead.wire`; the subjects with their labels |
-| `need` | the need the page already knows — also set by `?need=` and by a tap on any `[data-need="…"]` element |
-| `layout` | `single` (default) · `qualify-first`: a tile per need, then the contact step |
+| `wire`, `needs` | `site.lead.wire`; the subjects with their labels, an `icon` each (any node, the brand's — the kit ships none) for `needDisplay="cards"`, and an optional `shortLabel` drawn on tiles under `sm` |
+| `need` | the need the page already knows — also set by `?need=` and by a tap on any `[data-need="…"]` element. `?postcode=` fills the postcode the same way |
+| `layout` | `single` (default) · `steps`: one question per screen — see [One question per screen](#one-question-per-screen-layoutsteps) · `qualify-first`: a tile per need, then the contact step (the two screens `steps` grew from, kept as they were) |
+| `needDisplay` | how the need is asked: `select` (default on `single`) · `tiles` (default otherwise) · `cards`, a grid with each need's `icon` |
+| `intro`, `localityStep` | `steps` only: a question before the need, posted as a brand's extra, whose answer may turn the form into a callback · the postcode on its own screen (`own`, default) or on the phone's (`with-phone`) |
+| `focusNext` | on one screen: after a choice the focus moves to the next empty field, and Enter in a field moves to the next empty one before it submits. Off by default; always so in `steps` |
+| `questions` | by estimate input id: `{ display?: "tiles" \| "cards", unknown?: true, unknownSpan?: 2, badges?: { [option]: text }, shortLabels?: { [option]: text }, step?: number, next?: string }` — see [The compact form](#the-compact-form) and [steps](#one-question-per-screen-layoutsteps) |
+| `price`, `taxCredit` | `box` (default) · `compact`: the price on one line, what is left after a tax credit of `taxCredit` (a ratio, `0.5`), the breakdown behind "Détail" |
+| `afterPhone` | a node right under the phone field: one line of reassurance |
+| `channelsDisplay`, `channelIcons` | the other ways out: `stack` (default, under `otherChannels`) · `row`, one row of compact buttons named by `otherChannels` · the brand's icon per channel (`phone`, `whatsapp`, `sms`, `callback`) |
 | `locality` | `required` (default) · `optional` |
 | `name` | `{ field, required? }`: a name field posted as the brand's extra; off by default |
 | `extras` | the brand's own fields, after the phone |
@@ -236,7 +257,7 @@ it is the plain POST to `/quote` it always was.
 | `bookingVariant` · `bookingEmbed` · `bookingAdapters` | the `booking_provider` variant that picks the place's provider · the providers' embeds (after cookie consent) rather than a new tab · the brand's adapters over the built-ins (from a client component) — see [Booking](#booking-manual-link-google_calendar-cal_com) |
 | `initialError` | `leadErrorOf(searchParams)` on a page that reads its query: the refusal a 303 brought back, drawn on the server by the card it names (`lead_card`) so the card says why without a script (see *Refusals*) |
 | `head`, `trust` | the brand's heading instead of the title; a slot beside the submit. Like `extras`, `done` and `booking`, any node, built on the server or not, and never asked for a `key`: each slot sits alone in a keyed fragment |
-| `className` · `classNames` | the root · its parts: `root`, `head`, `title`, `lede`, `form`, `contact`, `field`, `label`, `control` (every input, the need's select in both states, the callback's phone), `hint`, `error` (a refusal: under the field, or above the submit), `chips`, `chip`, `needs`, `need`, `summary`, `submit`, `trust`, `privacy`, `opening`, `others`, `channel`, `primary`, `callback`, `callbackSummary`, `callbackForm`, `callbackLede`, `callbackSubmit`, `consent`, `done`, and for the flows `estimate`, `estimateInput`, `estimateLegend`, `estimateGrid` (an input's answers: 2 columns, 3 from `sm`), `estimateOption` (an answer's tile), `price`, `priceTotal`, `breakdown`, `priceNote`, `photos`, `priced`, `pricedPrice`, `pricedNote`, and for the booking `booking`, `bookingCta`, `bookingNote`, `prefer`, `preferOption`, `preferSubmit` |
+| `className` · `classNames` | the root · its parts: `root`, `head`, `title`, `lede`, `form`, `contact`, `field`, `label`, `control` (every input, the need's select in both states, the callback's phone), `hint`, `error` (a refusal: under the field, or above the submit), `chips`, `chip`, `needs`, `need`, `summary`, `icon` (a need's or an intro answer's icon), `submit`, `trust`, `privacy` (not drawn when `text.privacy` is `""`), `opening`, `others`, `channel`, `channelIcon`, `primary`, `callback`, `callbackSummary`, `callbackForm`, `callbackLede`, `callbackSubmit`, `consent`, `done`, for `steps` `progress`, `stepBack`, `step` (each screen), `answers`, `answer` (the chips of the screens answered), `stepNext`, `intro`, `introOption`, and for the flows `estimate`, `estimateInput`, `estimateLegend`, `estimateGrid` (an input's answers: 2 columns, 3 from `sm`), `estimateOption` (an answer's tile), `estimateUnknown` (the "I don't know" tile, after `estimateOption`), `badge`, `optionPrice` (a card's total), `price`, `priceTotal`, `breakdown`, `priceNote`, `priceLine`, `priceTaxCredit`, `priceDetail` (`price="compact"`), `photos`, `priced`, `pricedPrice`, `pricedNote`, and for the booking `booking`, `bookingCta`, `bookingNote`, `prefer`, `preferOption`, `preferSubmit` |
 
 - **Taps.** A need the page knows is not asked again, and a place serving one
   commune fills it: focus the phone, type, send — two taps. `qualify-first`
@@ -325,7 +346,8 @@ it is the plain POST to `/quote` it always was.
   refused it, `false` the phone hint showed — the field's role, never its
   value), `lead_form_submit_error {reason, channel}` (`network` /
   `timeout`), `lead_form_step {step}`
-  (`contact` / `need`), each with `form_id`, `layout`, `experiment`,
+  (`contact` / `need` in `qualify-first`; in `steps` each screen moved to —
+  `intro`, `need`, `estimate_<input>`, `locality`, `phone`), each with `form_id`, `layout`, `experiment`,
   `variant`; `contact_intent_click {channel}` for `phone`, `whatsapp`, `sms`,
   `callback`, with the experiment; and on the server `lead_form_submit
   {form_id, channel}` and `lead_form_reject {form_id, channel, field,
@@ -335,6 +357,104 @@ it is the plain POST to `/quote` it always was.
   within the 20 % tolerance); the refusals and the shared phone rule are
   2.0 KB of it, sending (the id, the busy state, the retry) 0.6 KB.
 
+### One question per screen: `layout="steps"`
+
+```tsx
+<LeadCapture … layout="steps" needDisplay="cards" price="compact" taxCredit={0.5}
+  questions={{ surface: { unknown: true }, frequency: { display: "cards", badges: { biweekly: "Le plus avantageux" } } }}
+  intro={{ label: "C’est pour quand ?", field: "urgency", options: [
+    { value: "today", label: "Urgent — aujourd’hui", channel: "callback" },
+    { value: "week", label: "Cette semaine" },
+  ] }}
+  afterPhone={<p>Votre numéro reste entre nous — rappel sous 15 min.</p>} channelsDisplay="row" />
+```
+
+- **Screens.** The intro question when there is one; the need; each of the
+  estimate's questions; the postcode (`localityStep="own"`, the default, or
+  with the phone, `with-phone`); the phone, always last, with the price, the
+  name and the brand's extras and the submit. A tap answers and moves on
+  (from the keyboard the tiles are a radio group: arrows choose, Enter or
+  Space answers); the postcode moves on with "Continuer" or Enter. The
+  focus goes to the new screen's field — inside the tap when that is a typed
+  field, so iOS opens the keyboard.
+- **Over the screens** a thin bar (`progress`; the screen is read out as
+  `stepProgress`, "Étape 2/4", never drawn), "Retour" (`stepBack`), and the
+  screens answered as chips (`answers`, `answer`), each a tap back to its
+  screen with "Modifier" (`needChange`). The total counts the most screens
+  an answer to come could add (the longest estimate while the need is
+  open), so the bar only moves forward as the visitor answers; until the
+  intro is answered — its branches differ in length — no total is said
+  (`stepProgressOpen`, "Étape 1").
+- **Questions sharing a screen** (`questions: { bedrooms: { step: 1, next:
+  "Voir les prix" }, surface: { step: 1 } }`): questions with the same `step`
+  number are one screen. It moves on by itself once all are answered; until
+  then the focus goes to the next question, and the button (`next` of the
+  first, else `stepNext`) says which one is missing.
+- **Never asked twice.** A need the page knows (`need`, `?need=`, a
+  `[data-need]` card) and a postcode it knows (`?postcode=`, a place serving
+  one commune) are answered screens: a chip, not a question.
+- **The intro** (`intro: { label, field, options }`) is posted under `field`
+  — declare it in `site.lead.extras` (`{ name: "urgency", max: 16 }`) and it
+  is stored and mailed with the lead like any extra. An answer with
+  `channel: "callback"` cuts the form to the phone and the callback's
+  consent, posted as a callback lead (`channel=callback`, `callbackSubmit`);
+  the folded callback is then not offered a second time.
+- **A refusal** opens the screen of the field it is about (the phone's for
+  anything the form cannot place).
+- **Without a script** every screen is in the form, hidden but posted; a
+  `<noscript>` style shows them all at once and hides the bar, the back link,
+  the chips and "Continuer": the form posts as one, as `qualify-first` does.
+  The server draws the same screen the script starts on — no shift at
+  hydration.
+
+### The compact form
+
+Pieces any layout takes, for a card that fits a phone's screen:
+
+- **The price on one line** (`price="compact"`): `priceLine` ("Votre prix :
+  {price}" — a brand may write "≈ {price}"), then, with `taxCredit` (a ratio
+  of the price a tax credit gives back, `0.5` for the French *crédit
+  d'impôt*), what is left to pay (`priceTaxCredit`, `data-credit-cents`),
+  and the breakdown and `priceNote` behind a `<details>` ("Détail",
+  `priceDetail`). Read out as it changes, the line only.
+- **A question as cards** (`questions: { frequency: { display: "cards" } }`):
+  one answer a line, each with the total it would make given the other
+  answers (once they are given), and an optional `badges` tag per option.
+- **Short labels on a phone** (`needs[].shortLabel`, `questions[id].shortLabels`):
+  under `sm` the tile draws the short one; the radio stays named by the
+  whole label (`aria-label`, with the badge and the price).
+- **Badges are the brand's words** (`badges`): the kit marks nothing as
+  popular or cheapest by itself.
+- **"Je ne sais pas"** (`questions: { surface: { unknown: true, unknownSpan: 2 } }`) adds the
+  answer `estimateUnknown` to that question, posted as `ESTIMATE_UNKNOWN`
+  (`?` — never a slug, so never an option a model prices). The questions
+  after it are not asked, the price goes, and the lead is a `quote`: the
+  submit says `submit`, a quote need's photos ask shows, and the server
+  stores it as a quote too (`answeredUnknown`), without the warning a stale
+  answer logs.
+- **Need cards** (`needDisplay="cards"`): a grid of cards with each need's
+  `icon`; `tiles` a list without. Required either way: nothing is chosen
+  for the visitor, unlike the select's first need.
+- **One line under the phone** (`afterPhone`) — and `text.privacy: ""` drops
+  the kit's privacy line, so the reassurance is said once.
+- **The other channels in a row** (`channelsDisplay="row"`): one row of
+  compact buttons (call, WhatsApp, text, "Rappelez-moi" — its form on a line
+  of its own once open), named by `otherChannels` as a group, each with the
+  brand's `channelIcons`; a channel the place lacks is not drawn. Hiding the
+  row where a sticky call bar already offers the same (`classNames.others`)
+  is the brand's.
+- **`focusNext`** on one screen: after the need's select, a tile, or an
+  estimate's answer, the focus moves to the next empty field; Enter in a
+  typed field moves to the next empty one, and submits from the last.
+- **Words.** `estimateUnknown`, `priceLine`, `priceTaxCredit`, `priceDetail`,
+  `stepProgress`, `stepProgressOpen`, `stepBack`, `stepNext` are in `LEAD_CAPTURE_TEXT` and
+  optional in `LeadCaptureText`, falling back to the kit's in the page's
+  language (`flowTextOf`) — a brand's text from 0.13 still type-checks.
+- **Weight.** The steps, the tiles, the compact price and the focus ride
+  with `LeadCapture` whichever layout a page uses: about 9 KB gz of
+  first-load JS on the template's place page (170,375 → 179,430 B against
+  its 158,000 B target: +13.6 %, a warning within the 20 % tolerance).
+
 ### Form variants: quote, estimate, fixed
 
 A need is sold one of three ways, chosen per need — one brand can mix them:
@@ -731,8 +851,9 @@ export const POST = quoteRoute(site, { env: serverEnv, notifier, webhook, unavai
 
 ## Experiments from the panel
 
-The experiments live in code (`@evinvest/experiments`, one `as const` config);
-the panel decides their weights and kill switch, and PostHog counts them.
+The experiments live in code (`@evinvest/experiments`, one `as const` config
+of variants, split equally); the panel decides any other weights and the kill
+switch, and PostHog counts them.
 
 **Overrides** (`createExperimentsSource`): `GET <base>/experiments`, the same
 base as the place source, `{ "experiments": { "<key>": { enabled?, weights?,
@@ -756,7 +877,8 @@ declared length, holdout in `[0, 1)`) is `applyOverrides`' call.
 
 **Declaration** (`declareExperiments`): at every start the landing tells the
 panel which experiments this build runs — `experiments.declared@1`, one event
-with every experiment's key, variants, weights, `enabled`, `holdout` and an
+with every experiment's key, variants, weights (always one each — the code's
+equal split), `enabled`, `holdout` and an
 optional one-line `summary`, under a fresh UUIDv7. It goes through the lead
 webhook's outbox, signed and retried like a lead (so it needs the same
 `LEAD_WEBHOOK_URL` and sqlite lead store), and the panel keeps the latest by
@@ -773,10 +895,51 @@ export async function register() {
 It never throws and never holds the start: no webhook, one that cannot be
 built, or a queue that refuses the row is logged and skipped — the panel keeps
 the last declaration. An experiment the panel would refuse (key not
-`[a-z0-9_]{1,64}`, fewer than two unique slug variants, weights not one per
-variant, negative or summing to zero, holdout outside `[0, 1)`, summary over
+`[a-z0-9_]{1,64}`, fewer than two unique slug variants, holdout outside
+`[0, 1)`, summary over
 200 characters) is left out and logged, since the panel judges the event whole.
 
+### The QA switcher: `AbSwitcher`
+
+A chip in a corner that switches an experiment's variant in one tap — for the
+owner on a phone, in production. It drives the brand proxy's own mechanism and
+adds no server path: a tap on a variant goes to the same URL with
+`?ab_<key>=<value>`, which forces it and sets the QA cookie.
+
+```tsx
+// app/[locale]/[location]/layout.tsx — a server layout; the props are plain data
+<AbSwitcher
+  experiments={[{ key: "lead_form", label: "Lead form", variants: [{ value: "a", label: "Compact" }, { value: "b", label: "Steps" }] }]}
+  qaCookie="ab__qa"              // the cookie the brand's force parameter sets
+  className="bottom-20 md:bottom-4" // over the brand's sticky bars; bottom-right by default
+/>
+```
+
+- `current` — the assignments, if the caller knows them; left out, the panel
+  reads `ab_<key>` from `document.cookie` (the normal case: the page stays
+  static, the server reads no cookie). `forceParam` — `ab_` by default.
+  `text` — the menu's words, English by default.
+- **Turning it on, on a phone, in production:** open any page with
+  `?ab_<key>=<value>`. The proxy sets the QA cookie and the chip appears;
+  every visit after is tagged as a test in analytics. Outside production
+  (`next dev`) the chip is always there.
+- **What a visitor pays:** ~190 B gz of first load on the template's place
+  page. After hydration the gate checks `NODE_ENV` and the QA cookie
+  (non-empty) and only then imports the panel — a chunk of its own, ~2.1 KB
+  gz, that a visitor without the cookie never requests. The panel is the
+  kit's `Button` and `Badge` over its own small layer, not `Popover`: sharing
+  the overlay primitives with the page made Turbopack re-split the page's
+  chunks, ~400 B gz more for every visitor.
+- **Reset** drops the experiments' assignment cookies (`ab_<key>`) and the
+  force parameters from the URL, then reloads: the variants are drawn again
+  and the visit stays a test, menu included. **Leave test** drops the QA cookie
+  too. **Minimize** and **Hide** last until the next load.
+- Screenshots: the chip and its panel carry `data-ab-switcher`; hide it in the
+  section stylesheet, `[data-ab-switcher] { display: none !important; }`.
+
+The decisions are plain functions in the core (`abSwitcherVisible`,
+`abVariantUrl`, `abReset`, `abAssignments`), for a brand's own tests.
+
 ## The site
 
 ```ts

package/dist/core/ab-gate.d.ts

@@ -0,0 +1,11 @@
+/**
+ * The QA switcher's one decision a visitor pays for, apart from the rest
+ * (`ab-switcher.ts`) so the gate's bundle carries this function and nothing
+ * else: the panel's helpers arrive with the panel.
+ */
+/**
+ * Whether the switcher shows: always outside production, and in production
+ * only to a visit carrying the QA cookie with a value — the cookie the brand's
+ * force parameter sets, so nobody else ever downloads the panel.
+ */
+export declare function abSwitcherVisible(cookies: string, qaCookie: string, nodeEnv: string | undefined): boolean;

package/dist/core/ab-gate.js

@@ -0,0 +1,19 @@
+/**
+ * The QA switcher's one decision a visitor pays for, apart from the rest
+ * (`ab-switcher.ts`) so the gate's bundle carries this function and nothing
+ * else: the panel's helpers arrive with the panel.
+ */
+/**
+ * Whether the switcher shows: always outside production, and in production
+ * only to a visit carrying the QA cookie with a value — the cookie the brand's
+ * force parameter sets, so nobody else ever downloads the panel.
+ */
+export function abSwitcherVisible(cookies, qaCookie, nodeEnv) {
+    if (nodeEnv !== "production")
+        return true;
+    // Presence and non-empty only, no decoding: every visitor runs this.
+    return cookies.split(";").some(pair => {
+        const eq = pair.indexOf("=");
+        return eq > 0 && pair.slice(0, eq).trim() === qaCookie && pair.slice(eq + 1).trim() !== "";
+    });
+}

package/dist/core/ab-switcher.d.ts

@@ -0,0 +1,33 @@
+/**
+ * The QA switcher's decisions, as plain functions over strings: what the
+ * cookies assign, where a variant's tap leads, what a reset clears — whether
+ * the menu shows at all is `ab-gate.ts`. The lazy panel only applies them to
+ * `document.cookie` and `location`.
+ *
+ * The mechanism is the brand proxy's, unchanged: it keeps an assignment in a
+ * cookie `ab_<key>`, and `?ab_<key>=<value>` forces a variant and sets the QA
+ * cookie that marks the visit as a test.
+ */
+/** The prefix of an assignment cookie: `ab_lead_form` holds `lead_form`'s variant. */
+export declare const AB_COOKIE_PREFIX = "ab_";
+/** The default prefix of the query parameter that forces a variant. */
+export declare const AB_FORCE_PARAM = "ab_";
+/** A cookie's value from a `document.cookie` string, by exact name, or `null`. */
+export declare function cookieValue(cookies: string, name: string): string | null;
+/** Each key's assigned variant read off the cookies; a key with none is left out. */
+export declare function abAssignments(cookies: string, keys: readonly string[]): Record<string, string>;
+/** The same page forcing `key` to `value`: the other parameters and the hash kept, an earlier force replaced. */
+export declare function abVariantUrl(href: string, key: string, value: string, forceParam?: string): string;
+export interface AbReset {
+    /** Each a `document.cookie` assignment that deletes one cookie. */
+    cookies: string[];
+    /** The page without the force parameters: left in, a reload would force the variant again. */
+    url: string;
+}
+/**
+ * What a reset clears. `"reassign"` drops the experiments' assignments only —
+ * the variant is drawn again and the visit stays a test, the menu with it;
+ * `"leave"` drops the QA cookie too. The QA cookie may itself start with the
+ * assignment prefix (`ab__qa`), so it is excluded by name, never by pattern.
+ */
+export declare function abReset(href: string, keys: readonly string[], qaCookie: string, mode: "reassign" | "leave", forceParam?: string): AbReset;

package/dist/core/ab-switcher.js

@@ -0,0 +1,61 @@
+/**
+ * The QA switcher's decisions, as plain functions over strings: what the
+ * cookies assign, where a variant's tap leads, what a reset clears — whether
+ * the menu shows at all is `ab-gate.ts`. The lazy panel only applies them to
+ * `document.cookie` and `location`.
+ *
+ * The mechanism is the brand proxy's, unchanged: it keeps an assignment in a
+ * cookie `ab_<key>`, and `?ab_<key>=<value>` forces a variant and sets the QA
+ * cookie that marks the visit as a test.
+ */
+/** The prefix of an assignment cookie: `ab_lead_form` holds `lead_form`'s variant. */
+export const AB_COOKIE_PREFIX = "ab_";
+/** The default prefix of the query parameter that forces a variant. */
+export const AB_FORCE_PARAM = "ab_";
+/** A cookie's value from a `document.cookie` string, by exact name, or `null`. */
+export function cookieValue(cookies, name) {
+    for (const pair of cookies.split(";")) {
+        const eq = pair.indexOf("=");
+        if (eq < 0 || pair.slice(0, eq).trim() !== name)
+            continue;
+        const raw = pair.slice(eq + 1).trim();
+        try {
+            return decodeURIComponent(raw);
+        }
+        catch {
+            return raw;
+        }
+    }
+    return null;
+}
+/** Each key's assigned variant read off the cookies; a key with none is left out. */
+export function abAssignments(cookies, keys) {
+    const out = {};
+    for (const key of keys) {
+        const value = cookieValue(cookies, `${AB_COOKIE_PREFIX}${key}`);
+        if (value)
+            out[key] = value;
+    }
+    return out;
+}
+/** The same page forcing `key` to `value`: the other parameters and the hash kept, an earlier force replaced. */
+export function abVariantUrl(href, key, value, forceParam = AB_FORCE_PARAM) {
+    const url = new URL(href);
+    url.searchParams.set(`${forceParam}${key}`, value);
+    return url.toString();
+}
+/**
+ * What a reset clears. `"reassign"` drops the experiments' assignments only —
+ * the variant is drawn again and the visit stays a test, the menu with it;
+ * `"leave"` drops the QA cookie too. The QA cookie may itself start with the
+ * assignment prefix (`ab__qa`), so it is excluded by name, never by pattern.
+ */
+export function abReset(href, keys, qaCookie, mode, forceParam = AB_FORCE_PARAM) {
+    const names = keys.map(k => `${AB_COOKIE_PREFIX}${k}`).filter(n => n !== qaCookie);
+    if (mode === "leave")
+        names.push(qaCookie);
+    const url = new URL(href);
+    for (const key of keys)
+        url.searchParams.delete(`${forceParam}${key}`);
+    return { cookies: names.map(n => `${n}=; path=/; max-age=0`), url: url.toString() };
+}

package/dist/core/accept.js

@@ -1,7 +1,7 @@
 import { ANALYTICS_ID, experimentProps } from "./analytics.js";
 import { HONEYPOT_FIELD, LEGACY_HONEYPOT_FIELDS, RENDERED_AT_FIELD, screen } from "./antispam.js";
 import { channelOf, MAX_FIELD, readCandidate, validateCandidate } from "./lead.js";
-import { flowOf, readEstimateInputs } from "./pricing/flow.js";
+import { answeredUnknown, flowOf, readEstimateInputs } from "./pricing/flow.js";
 import { priceOf } from "./pricing/price.js";
 /** Hidden fields the form carries besides what the visitor types. */
 export const LOCATION_FIELD = "location";
@@ -52,7 +52,8 @@ export function leadRef(id, seed) {
  * from the posted answers through the same `priceOf` the form showed; a
  * posted amount is never read. A callback asks for a call, not a price: no
  * flow. An estimate whose answers do not price (a stale form, a tampered
- * field) is kept as a `quote`: the customer is still a customer.
+ * field) is kept as a `quote`: the customer is still a customer — and so is
+ * one answered "I don't know" (`ESTIMATE_UNKNOWN`), on purpose.
  */
 async function priced(site, form, lead, deps) {
     const flows = site.lead.flows;
@@ -69,6 +70,9 @@ async function priced(site, form, lead, deps) {
     const flow = flowOf(flows, model, lead.subject);
     if (flow === "quote" || !model)
         return { flow: "quote" };
+    // "I don't know" is an answer, not a stale form: a quote, said so, without a warning.
+    if (flow === "estimate" && answeredUnknown(model, lead.subject, name => field(form, name)))
+        return { flow: "quote" };
     const inputs = flow === "estimate" ? readEstimateInputs(model, lead.subject, name => field(form, name)) : {};
     const price = priceOf(model, lead.subject, inputs);
     if (!price) {

package/dist/core/analytics.d.ts

@@ -26,8 +26,13 @@ export type IntentChannel = "form_open" | "whatsapp" | "phone" | "sms" | "callba
  * one field reads the same on every site. A brand's extra is its own name.
  */
 export type LeadField = "need" | "locality" | "phone" | "name" | "consent" | (string & {});
-/** `qualify-first`'s two screens; `single` has one and never reports a step. */
-export type LeadStep = "need" | "contact";
+/**
+ * A screen of the lead form, as `lead_form_step` names it. `qualify-first`'s
+ * two are `need` and `contact`; `steps` reports each screen it moves to —
+ * `intro`, `need`, `estimate_<input id>`, `locality`, `phone`. `single` has one
+ * screen and never reports a step. Slugs only: an input id, never an answer.
+ */
+export type LeadStep = "need" | "contact" | "intro" | "locality" | "phone" | `estimate_${string}`;
 /**
  * Every property name an event may carry. A customer's phone or address comes
  * through the same pages, and once it reaches PostHog the only remedy is

package/dist/core/lead-capture-text.d.ts

@@ -82,7 +82,11 @@ export interface LeadCaptureText extends Partial<LeadCaptureFlowText> {
     /** The honeypot's label — read only by a bot filling every field. */
     honeypotLabel: string;
 }
-/** What the `estimate` and `fixed` flows, the photos ask and the booking print. */
+/**
+ * What the `estimate` and `fixed` flows, the photos ask and the booking
+ * print — and every word added since (the compact price, the steps): optional
+ * in `LeadCaptureText`, so a brand's text from before them still type-checks.
+ */
 export interface LeadCaptureFlowText {
     /** Heads the live price. */
     priceTitle: string;
@@ -130,6 +134,22 @@ export interface LeadCaptureFlowText {
     photosCta: string;
     /** The WhatsApp message, `{need}` the need's label. */
     photosMessage: string;
+    /** The answer an estimate's question may offer (`EstimateQuestion.unknown`): the lead becomes a quote. */
+    estimateUnknown: string;
+    /** `price="compact"`: the one line, `{price}` the total. */
+    priceLine: string;
+    /** `price="compact"` with a `taxCredit`: after the line, `{price}` what is left to pay. */
+    priceTaxCredit: string;
+    /** `price="compact"`: opens how the price was reached. */
+    priceDetail: string;
+    /** `layout="steps"`: the screen read out, `{n}` of `{total}` — never drawn, the bar is. */
+    stepProgress: string;
+    /** The same before the intro is answered, when how many screens follow is not known yet: `{n}` only. */
+    stepProgressOpen: string;
+    /** `layout="steps"`: back one screen. */
+    stepBack: string;
+    /** `layout="steps"`: on to the next screen, from a field that is typed (the postcode). */
+    stepNext: string;
 }
 export declare const LEAD_CAPTURE_TEXT: Readonly<Record<"fr" | "en", LeadCaptureText>>;
 /** The flows' words for a page: the brand's, else the kit's in its language (English for `en*`, French otherwise). */

package/dist/core/lead-capture-text.js

@@ -27,6 +27,14 @@ const FR_FLOW = {
     photosLede: "Pour ce besoin, quelques photos nous permettent de vous donner un prix juste.",
     photosCta: "Envoyer des photos sur WhatsApp",
     photosMessage: "Bonjour, voici des photos pour : {need}.",
+    estimateUnknown: "Je ne sais pas",
+    priceLine: "Votre prix : {price}",
+    priceTaxCredit: "{price} après crédit d’impôt",
+    priceDetail: "Détail",
+    stepProgress: "Étape {n}/{total}",
+    stepProgressOpen: "Étape {n}",
+    stepBack: "Retour",
+    stepNext: "Continuer",
 };
 const EN_FLOW = {
     priceTitle: "Your price",
@@ -57,6 +65,14 @@ const EN_FLOW = {
     photosLede: "For this job, a few photos let us give you a fair price.",
     photosCta: "Send photos on WhatsApp",
     photosMessage: "Hello, here are photos for: {need}.",
+    estimateUnknown: "I don’t know",
+    priceLine: "Your price: {price}",
+    priceTaxCredit: "{price} after tax credit",
+    priceDetail: "Details",
+    stepProgress: "Step {n} of {total}",
+    stepProgressOpen: "Step {n}",
+    stepBack: "Back",
+    stepNext: "Continue",
 };
 const FR = {
     ...FR_FLOW,

package/dist/core/pricing/flow.d.ts

@@ -19,6 +19,15 @@ export declare function flowOf(flows: LeadFlows | undefined, model: PricingModel
 /** The form field an estimate's input is posted under: `estimate_<input id>`. */
 export declare const ESTIMATE_FIELD_PREFIX = "estimate_";
 export declare const estimateField: (input: string) => string;
+/**
+ * The answer "I don't know" to an estimate's question (`EstimateQuestion.unknown`
+ * in `LeadCapture`): not a slug, so it can never be an option a model prices.
+ * A need answered with it is sold as a `quote` for that lead — on the form and
+ * on the server alike (`answeredUnknown`).
+ */
+export declare const ESTIMATE_UNKNOWN = "?";
+/** Whether any of the need's questions was answered "I don't know" — the lead is then a `quote`. */
+export declare function answeredUnknown(model: PricingModel, need: string, get: (field: string) => string | null): boolean;
 /**
  * The answers a form posted for the need's inputs — only those, and only
  * slugs. Read by the server, which prices them itself: a posted amount, if

package/dist/core/pricing/flow.js

@@ -18,6 +18,20 @@ export function flowOf(flows, model, need) {
 /** The form field an estimate's input is posted under: `estimate_<input id>`. */
 export const ESTIMATE_FIELD_PREFIX = "estimate_";
 export const estimateField = (input) => `${ESTIMATE_FIELD_PREFIX}${input}`;
+/**
+ * The answer "I don't know" to an estimate's question (`EstimateQuestion.unknown`
+ * in `LeadCapture`): not a slug, so it can never be an option a model prices.
+ * A need answered with it is sold as a `quote` for that lead — on the form and
+ * on the server alike (`answeredUnknown`).
+ */
+export const ESTIMATE_UNKNOWN = "?";
+/** Whether any of the need's questions was answered "I don't know" — the lead is then a `quote`. */
+export function answeredUnknown(model, need, get) {
+    const pricing = Object.hasOwn(model.needs, need) ? model.needs[need] : undefined;
+    if (pricing?.kind !== "estimate")
+        return false;
+    return pricing.inputs.some(id => get(estimateField(id))?.trim() === ESTIMATE_UNKNOWN);
+}
 /**
  * The answers a form posted for the need's inputs — only those, and only
  * slugs. Read by the server, which prices them itself: a posted amount, if

package/dist/core/pricing/index.d.ts

@@ -1,4 +1,4 @@
 export { PRICING_CURRENCY, PRICING_FORMAT, PRICING_LIMITS, type AddOption, type DiscountOption, type MultiplyOption, type NeedPricing, type Price, type PriceLine, type PricingInput, type PricingInputKind, type PricingInputs, type PricingLabels, type PricingModel, } from "./model.js";
 export { CENTS_BUCKETS, centsBucket, mulBp, priceOf, roundTo } from "./price.js";
 export { labelOf, parsePricingModel, PricingModelError, pricingProblems, pricingProblemsFor } from "./validate.js";
-export { ESTIMATE_FIELD_PREFIX, estimateField, flowOf, LEAD_FLOWS, readEstimateInputs, type LeadFlow, type LeadFlows } from "./flow.js";
+export { answeredUnknown, ESTIMATE_FIELD_PREFIX, ESTIMATE_UNKNOWN, estimateField, flowOf, LEAD_FLOWS, readEstimateInputs, type LeadFlow, type LeadFlows } from "./flow.js";

package/dist/core/pricing/index.js

@@ -1,4 +1,4 @@
 export { PRICING_CURRENCY, PRICING_FORMAT, PRICING_LIMITS, } from "./model.js";
 export { CENTS_BUCKETS, centsBucket, mulBp, priceOf, roundTo } from "./price.js";
 export { labelOf, parsePricingModel, PricingModelError, pricingProblems, pricingProblemsFor } from "./validate.js";
-export { ESTIMATE_FIELD_PREFIX, estimateField, flowOf, LEAD_FLOWS, readEstimateInputs } from "./flow.js";
+export { answeredUnknown, ESTIMATE_FIELD_PREFIX, ESTIMATE_UNKNOWN, estimateField, flowOf, LEAD_FLOWS, readEstimateInputs } from "./flow.js";

package/dist/index.d.ts

@@ -8,7 +8,7 @@ export { createPlaceView, DEFAULT_TIME_ZONE, freshRating, isOpenAt, nextOpening,
 export { createRouting, GONE, GONE_HEADER, gonePath, goneHeader, HOST_MARK, LANG_COOKIE, LANG_COOKIE_MAX_AGE, NON_PAGE_ROUTES, parseGoneHeader, parsePlaceParam, PASS_PATHS, placeParam, pointSuffixes, THANKS, type Decision, type RequestFacts, type Routing, } from "./core/routing.js";
 export { CARD_FIELD, CARD_ID, CHANNEL_FIELD, channelOf, CONSENT_FIELD, LEAD_CHANNELS, LEAD_ERROR_PARAM, LEAD_CARD_PARAM, leadErrorFor, leadErrorOf, LEAD_SCHEMA_VERSION, MAX_CONSENT, MAX_FIELD, readCandidate, rejectionOf, suspectOf, SUBMISSION_FIELD, SUBMISSION_ID, validateCallbackLead, validateCandidate, validateLead, type Lead, type LeadCandidate, type LeadChannel, type LeadError, type PageLeadError, type LeadConsent, type LeadExtra, type LeadPrice, type LeadRejection, type LeadSchema, type LeadStore, type LeadSuspect, type LeadVerdict, type LeadWire, type SpamVerdict, } from "./core/lead.js";
 export { isMobilePhone, isPlausiblePhone, normalizePhone, phoneProblem } from "./core/phone.js";
-export { CENTS_BUCKETS, centsBucket, ESTIMATE_FIELD_PREFIX, estimateField, flowOf, labelOf, LEAD_FLOWS, mulBp, parsePricingModel, priceOf, PRICING_CURRENCY, PRICING_FORMAT, PRICING_LIMITS, PricingModelError, pricingProblems, pricingProblemsFor, readEstimateInputs, roundTo, type AddOption, type DiscountOption, type LeadFlow, type LeadFlows, type MultiplyOption, type NeedPricing, type Price, type PriceLine, type PricingInput, type PricingInputKind, type PricingInputs, type PricingLabels, type PricingModel, } from "./core/pricing/index.js";
+export { answeredUnknown, CENTS_BUCKETS, centsBucket, ESTIMATE_FIELD_PREFIX, ESTIMATE_UNKNOWN, estimateField, flowOf, labelOf, LEAD_FLOWS, mulBp, parsePricingModel, priceOf, PRICING_CURRENCY, PRICING_FORMAT, PRICING_LIMITS, PricingModelError, pricingProblems, pricingProblemsFor, readEstimateInputs, roundTo, type AddOption, type DiscountOption, type LeadFlow, type LeadFlows, type MultiplyOption, type NeedPricing, type Price, type PriceLine, type PricingInput, type PricingInputKind, type PricingInputs, type PricingLabels, type PricingModel, } from "./core/pricing/index.js";
 export { flowTextOf, LEAD_CAPTURE_TEXT, type LeadCaptureFlowText, type LeadCaptureText } from "./core/lead-capture-text.js";
 export { fillText, formatCents, openingText } from "./core/lead-capture-format.js";
 export { channelHref, resolveChannels, smsHref, type CaptureChannel, type ChannelFacts, type ChannelOptions, type ResolvedChannels, } from "./core/channels.js";
@@ -17,6 +17,8 @@ export { createAcceptLead, ANALYTICS_ID_FIELD, EXPERIMENT_FIELD, FORM_ID_FIELD,
 export { areaServedNodes, breadcrumbNode, businessId, businessNode, faqPageNode, offerNodes, organizationId, organizationNode, placeGraph, websiteId, type OfferInput, type PageGraphCopy, type QuestionAnswer, } from "./core/seo/ld.js";
 export { AI_CRAWLERS, ogImageUrl, robotsFor, sitemapFor, type RobotsFile, type RobotsRule, type SitemapEntry, } from "./core/seo/sitemap.js";
 export { ALLOWED_PROPS, ANALYTICS_ID, analyticsSink, countsAsPageView, EVENTS, EXPERIMENT_SLUG, experimentProps, type AnalyticsTarget, type IntentChannel, type LeadField, type LeadStep, } from "./core/analytics.js";
+export { AB_COOKIE_PREFIX, AB_FORCE_PARAM, abAssignments, abReset, abVariantUrl, cookieValue, type AbReset, } from "./core/ab-switcher.js";
+export { abSwitcherVisible } from "./core/ab-gate.js";
 export type { CallBarText, CopySlice, CoreText, PageMetaCopy, QuoteFormCopy, Said, StatusAction, StatusCopy, StatusScreenText, } from "./core/content.js";
 export { BOOKING_LIMITS, BOOKING_PROVIDERS, BOOKING_STATUSES, BookingConfigError, bookingConfigProblems, BOOKING_EXPERIMENT, bookingHref, bookingOf, bookingRequestedProperties, bookingRequestProblems, calComHostsProblems, DEFAULT_BOOKING, DEFAULT_CAL_COM_HOSTS, isBookingProvider, isLeadRef, isPageProvider, isPreferredPart, parseBookingConfig, parseBookingRequest, PREFERRED_PARTS, type BookingChoice, type BookingConfig, type BookingPrefill, type BookingProvider, type BookingRequest, type BookingRequestedProperties, type BookingRules, type BookingStatus, type OpenBookingConfig, type PageProvider, type PreferredPart, } from "./core/booking/index.js";
 export { brandStatusTarget, statusTarget, thanksChannel, thanksSuffix, type StatusTarget } from "./core/status.js";

package/dist/index.js

@@ -8,7 +8,7 @@ export { createPlaceView, DEFAULT_TIME_ZONE, freshRating, isOpenAt, nextOpening,
 export { createRouting, GONE, GONE_HEADER, gonePath, goneHeader, HOST_MARK, LANG_COOKIE, LANG_COOKIE_MAX_AGE, NON_PAGE_ROUTES, parseGoneHeader, parsePlaceParam, PASS_PATHS, placeParam, pointSuffixes, THANKS, } from "./core/routing.js";
 export { CARD_FIELD, CARD_ID, CHANNEL_FIELD, channelOf, CONSENT_FIELD, LEAD_CHANNELS, LEAD_ERROR_PARAM, LEAD_CARD_PARAM, leadErrorFor, leadErrorOf, LEAD_SCHEMA_VERSION, MAX_CONSENT, MAX_FIELD, readCandidate, rejectionOf, suspectOf, SUBMISSION_FIELD, SUBMISSION_ID, validateCallbackLead, validateCandidate, validateLead, } from "./core/lead.js";
 export { isMobilePhone, isPlausiblePhone, normalizePhone, phoneProblem } from "./core/phone.js";
-export { CENTS_BUCKETS, centsBucket, ESTIMATE_FIELD_PREFIX, estimateField, flowOf, labelOf, LEAD_FLOWS, mulBp, parsePricingModel, priceOf, PRICING_CURRENCY, PRICING_FORMAT, PRICING_LIMITS, PricingModelError, pricingProblems, pricingProblemsFor, readEstimateInputs, roundTo, } from "./core/pricing/index.js";
+export { answeredUnknown, CENTS_BUCKETS, centsBucket, ESTIMATE_FIELD_PREFIX, ESTIMATE_UNKNOWN, estimateField, flowOf, labelOf, LEAD_FLOWS, mulBp, parsePricingModel, priceOf, PRICING_CURRENCY, PRICING_FORMAT, PRICING_LIMITS, PricingModelError, pricingProblems, pricingProblemsFor, readEstimateInputs, roundTo, } from "./core/pricing/index.js";
 export { flowTextOf, LEAD_CAPTURE_TEXT } from "./core/lead-capture-text.js";
 export { fillText, formatCents, openingText } from "./core/lead-capture-format.js";
 export { channelHref, resolveChannels, smsHref, } from "./core/channels.js";
@@ -17,6 +17,8 @@ export { createAcceptLead, ANALYTICS_ID_FIELD, EXPERIMENT_FIELD, FORM_ID_FIELD,
 export { areaServedNodes, breadcrumbNode, businessId, businessNode, faqPageNode, offerNodes, organizationId, organizationNode, placeGraph, websiteId, } from "./core/seo/ld.js";
 export { AI_CRAWLERS, ogImageUrl, robotsFor, sitemapFor, } from "./core/seo/sitemap.js";
 export { ALLOWED_PROPS, ANALYTICS_ID, analyticsSink, countsAsPageView, EVENTS, EXPERIMENT_SLUG, experimentProps, } from "./core/analytics.js";
+export { AB_COOKIE_PREFIX, AB_FORCE_PARAM, abAssignments, abReset, abVariantUrl, cookieValue, } from "./core/ab-switcher.js";
+export { abSwitcherVisible } from "./core/ab-gate.js";
 export { BOOKING_LIMITS, BOOKING_PROVIDERS, BOOKING_STATUSES, BookingConfigError, bookingConfigProblems, BOOKING_EXPERIMENT, bookingHref, bookingOf, bookingRequestedProperties, bookingRequestProblems, calComHostsProblems, DEFAULT_BOOKING, DEFAULT_CAL_COM_HOSTS, isBookingProvider, isLeadRef, isPageProvider, isPreferredPart, parseBookingConfig, parseBookingRequest, PREFERRED_PARTS, } from "./core/booking/index.js";
 export { brandStatusTarget, statusTarget, thanksChannel, thanksSuffix } from "./core/status.js";
 // A landing needs these beside the machinery; re-exported by name so a brand