@evinvest/kitstart 0.8.0 → 0.10.0

package/dist/testing/lead-rules.js

@@ -0,0 +1,50 @@
+import { readCandidate, validateCandidate } from "../core/lead.js";
+import { phoneProblem } from "../core/phone.js";
+/**
+ * Numbers people type, and whether each is a way to reach them — the
+ * review's matrix (LEAD-FORMS-REVIEW-2026-10-03) and the spellings that must
+ * keep working.
+ */
+export const PHONE_MATRIX = [
+    { mobile: "06 12 34 56 78", valid: true },
+    { mobile: "0612345678", valid: true },
+    { mobile: "6 12 34 56 78", valid: true },
+    { mobile: "+33 (0)6 12 34 56 78", valid: true },
+    { mobile: "0033 6 12 34 56 78", valid: true },
+    { mobile: "06.12.34.56.78", valid: true },
+    { mobile: "06-12-34-56-78", valid: true },
+    { mobile: "01 23 45 67 89", valid: true },
+    { mobile: "+1 415 555 0123", valid: true },
+    { mobile: "+44 7911 123456", valid: true },
+    { mobile: "+12345678", valid: true },
+    { mobile: "０６１２３４５６７８", valid: true },
+    { mobile: "(415) 555-0123", valid: false },
+    { mobile: "+3361234567", valid: false },
+    { mobile: "0000000000", valid: false },
+    { mobile: "06 66 66 66 66", valid: false },
+    { mobile: "06 12 34 56 7", valid: false },
+    { mobile: "12 34 56 7", valid: false },
+    { mobile: "+1234567", valid: false },
+    { mobile: "06 12", valid: false },
+];
+/**
+ * Where a brand's form rule disagrees with the form's own phone check: a
+ * number the form lets through that the server refuses (the visitor is sent
+ * back for nothing they can see), or one the form blocks that the rule would
+ * take. Every other field is filled as the form fills it — the first subject,
+ * a postcode — so only the phone is judged. Empty is agreement.
+ */
+export function leadRuleDisagreements(schema) {
+    const out = [];
+    for (const { mobile } of PHONE_MATRIX) {
+        const form = new FormData();
+        form.set(schema.wire.subject, schema.subjects[0] ?? "");
+        form.set(schema.wire.locality, "75011");
+        form.set(schema.wire.mobile, mobile);
+        const blocked = phoneProblem(mobile) !== null;
+        const refused = validateCandidate(schema, readCandidate(schema, form, null)) !== null;
+        if (blocked !== refused)
+            out.push(`${mobile}: the form ${blocked ? "blocks" : "takes"} it, the server ${refused ? "refuses" : "takes"} it`);
+    }
+    return out;
+}

package/dist/testing/lead-store-contract.js

@@ -29,10 +29,13 @@ export function describeLeadStoreContract(name, harness) {
                 lead({ subject: "x".repeat(200), locality: "Clermont-Ferrand — 63000" }),
                 lead({ channel: "callback", subject: "", locality: "", consent: { text: "J’accepte d’être rappelé·e.", at: "2026-10-03T10:00:00.000Z" } }),
                 lead({ channel: "callback", consent: { text: "x".repeat(500), at: "2026-10-03T10:00:00.000Z" } }),
+                lead({ flow: "quote" }),
+                lead({ flow: "estimate", price: { cents: 8400, validFrom: "2026-10-01", inputs: { zone: "proche", frequency: "biweekly" } } }),
+                lead({ flow: "fixed", price: { cents: 0, validFrom: "2026-10-01" } }),
             ]) {
                 expect(await store.insert(variant)).toBeGreaterThan(0);
             }
-            expect(await store.count()).toBe(6);
+            expect(await store.count()).toBe(9);
             await store.close();
         });
         it("stands at the current schema version and reports itself healthy", async () => {
@@ -41,6 +44,30 @@ export function describeLeadStoreContract(name, harness) {
             await expect(store.health()).resolves.toBeUndefined();
             await store.close();
         });
+        // LEAD-FORMS-REVIEW-2026-10-03 #3: a resend after a lost answer is the same lead.
+        it("keeps one row per submission id, and finds it back", async () => {
+            const store = await harness().open();
+            if (!store.findSubmission)
+                return void (await store.close());
+            const sid = "3f2b8c1e-5d4a-4f6b-9c7e-1a2b3c4d5e6f";
+            const first = await store.insert(lead({ submissionId: sid, channel: "callback", consent: { text: "Oui.", at: "2026-10-03T10:00:00.000Z" }, extras: { name: "Ana" } }));
+            await expect(store.insert(lead({ submissionId: sid }))).rejects.toThrow();
+            expect(await store.count()).toBe(1);
+            expect(await store.findSubmission(sid)).toEqual({
+                id: first,
+                lead: lead({ submissionId: sid, channel: "callback", consent: { text: "Oui.", at: "2026-10-03T10:00:00.000Z" }, extras: { name: "Ana" } }),
+            });
+            expect(await store.findSubmission("00000000-0000-4000-8000-000000000000")).toBeNull();
+            // A priced lead reads back at the price it was taken at.
+            const priced = lead({ submissionId: "7c9e6679-7425-40de-944b-e07fc1f90ae7", flow: "estimate", price: { cents: 8400, validFrom: "2026-10-01", inputs: { zone: "proche" } } });
+            const pricedId = await store.insert(priced);
+            expect(await store.findSubmission("7c9e6679-7425-40de-944b-e07fc1f90ae7")).toEqual({ id: pricedId, lead: { ...priced, channel: "form" } });
+            // Leads without one (the no-JS post) never collide.
+            await store.insert(lead());
+            await store.insert(lead());
+            expect(await store.count()).toBe(4);
+            await store.close();
+        });
         it("keeps what it acknowledged across a close and a reopen", async () => {
             const h = harness();
             if (!h.reopen)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@evinvest/kitstart",
-  "version": "0.8.0",
+  "version": "0.10.0",
   "description": "Landing-site machinery for local-service brands: a site composition root, the Place/Presence/ServiceArea model with a publication gate, host/locale routing, schema.org and SEO builders, the lead funnel with its antispam, and analytics events. Pure core at '.', more subpaths per runtime.",
   "license": "BlueOak-1.0.0",
   "publishConfig": {
@@ -57,7 +57,8 @@
   "types": "./dist/index.d.ts",
   "main": "./dist/index.js",
   "bin": {
-    "kitstart-size": "./dist/cli/kitstart-size.js"
+    "kitstart-size": "./dist/cli/kitstart-size.js",
+    "kitstart-outbox": "./dist/cli/kitstart-outbox.js"
   },
   "files": [
     "dist",

package/template/app/[locale]/[location]/page.tsx

@@ -1,6 +1,7 @@
 import { placeMetadata } from "@evinvest/kitstart/next";
 import type { Metadata } from "next";
 import { loadPlace } from "@/views/place/server";
+import { pricing } from "@/shared/config/env";
 import { site } from "@/shared/config/site";
 import { PlaceHome } from "@/views/home";
 
@@ -13,6 +14,7 @@ export async function generateMetadata({ params }: Props): Promise<Metadata> {
 }
 
 export default async function PlaceHomePage({ params }: Props) {
-  const { view, copy, renderedAt } = await loadPlace(params);
-  return <PlaceHome view={view} copy={copy} renderedAt={renderedAt} />;
+  // The price list only where the form is: the other pages of a place need none.
+  const [{ view, copy, renderedAt }, model] = await Promise.all([loadPlace(params), pricing.model()]);
+  return <PlaceHome view={view} copy={copy} renderedAt={renderedAt} model={model} />;
 }

package/template/app/quote/route.ts

@@ -1,6 +1,6 @@
 import { quoteRoute } from "@evinvest/kitstart/next";
 import { TEXT } from "@/entities/content";
-import { notifier, serverEnv } from "@/shared/config/env";
+import { notifier, pricing, serverEnv } from "@/shared/config/env";
 import { site } from "@/shared/config/site";
 
 /** The no-JS path: a plain form POST answered with a 303. */
@@ -9,6 +9,7 @@ export const dynamic = "force-dynamic";
 export const POST = quoteRoute(site, {
   env: serverEnv,
   notifier,
+  pricing,
   unavailable: locale => {
     const t = TEXT[locale];
     const f = { place: site.brand.name, phone: site.brand.phone };

package/template/flake.nix

@@ -3,7 +3,7 @@
     v_flakes.url = "github:valeratrades/v_flakes?ref=v1.6";
     # The lib flake at the tag of the @evinvest/kitstart version in
     # package-lock.json — mkLanding refuses a mismatch.
-    ev.url = "github:EV-invest/lib?ref=@evinvest/kitstart-v0.8.0";
+    ev.url = "github:EV-invest/lib?ref=@evinvest/kitstart-v0.10.0";
     ev.inputs.v_flakes.follows = "v_flakes";
   };
 

package/template/package.json

@@ -20,7 +20,7 @@
   "dependencies": {
     "@evinvest/analytics": "^0.3.0",
     "@evinvest/i18n": "^0.9.0",
-    "@evinvest/kitstart": "^0.8.0",
+    "@evinvest/kitstart": "^0.10.0",
     "@evinvest/marketing": "^0.3.0",
     "@evinvest/uikit": "^0.25.0",
     "next": "16.3.6",

package/template/src/entities/content/model/en.ts

@@ -41,7 +41,7 @@ export const EN = {
   coverageTitle: "Where we work",
   brandPage: { title: "Brand", description: "Cleaning at a fixed price.", open: "Open" },
   contactLabel: "Contact us",
-  subjects: { standard: "Regular cleaning", deep: "Deep cleaning", other: "Other" },
+  subjects: { standard: "Regular cleaning", deep: "Deep cleaning", other: "Other", recurring: "Recurring cleaning" },
   leadCapture: { ...LEAD_CAPTURE_TEXT.en, needLabel: "Service" },
   faqs: [{ q: "Can the price change?", a: "No: the price quoted is the price you pay." }],
 } satisfies Text;

package/template/src/entities/content/model/fr.ts

@@ -41,7 +41,7 @@ export const FR = {
   coverageTitle: "Où nous intervenons",
   brandPage: { title: "Brand", description: "Le ménage à prix fixe.", open: "Ouvrir" },
   contactLabel: "Nous contacter",
-  subjects: { standard: "Ménage courant", deep: "Grand ménage", other: "Autre" },
+  subjects: { standard: "Ménage courant", deep: "Grand ménage", other: "Autre", recurring: "Ménage régulier" },
   leadCapture: { ...LEAD_CAPTURE_TEXT.fr, needLabel: "Prestation" },
   faqs: [{ q: "Le prix peut-il changer ?", a: "Non : le prix annoncé est celui que vous payez." }],
 } satisfies Text;

package/template/src/shared/config/env.ts

@@ -1,5 +1,5 @@
 import "server-only";
-import { createPlaceSource, createServerEnv, leadNotifier, type LeadNotifier } from "@evinvest/kitstart/server";
+import { createPlaceSource, createPricingSource, createServerEnv, leadNotifier, type LeadNotifier } from "@evinvest/kitstart/server";
 import { site } from "./site";
 
 /** Parsed once, lazily: `next build` imports this and must need no secrets. */
@@ -8,6 +8,9 @@ export const serverEnv = createServerEnv(site);
 /** The live place data, when `LOCATIONS_API_URL` is set; baked otherwise. */
 export const places = createPlaceSource(site, { baseUrl: () => serverEnv().locationsApiUrl });
 
+/** The live price list from the same source (`<LOCATIONS_API_URL>/pricing`); `site.pricing` otherwise. */
+export const pricing = createPricingSource(site, { baseUrl: () => serverEnv().locationsApiUrl });
+
 let built: LeadNotifier | undefined;
 
 /** Built at boot (`instrumentation.ts`), so SMTP with no sender fails startup. */

package/template/src/shared/config/lead.ts

@@ -1,11 +1,23 @@
-import type { LeadSchema } from "@evinvest/kitstart";
+import { validateLead, type LeadFlows, type LeadSchema } from "@evinvest/kitstart";
 
-export const SUBJECTS = ["standard", "deep", "other"] as const;
+export const SUBJECTS = ["standard", "deep", "other", "recurring"] as const;
 export type Subject = (typeof SUBJECTS)[number];
 
+/**
+ * How each need is sold. `recurring` is priced live from a few answers
+ * (`pricing.ts`) and booked; the rest ask for a quote, and `deep` — priced
+ * from photos — offers to send them on WhatsApp once the place has a number.
+ * The form and the quote route read the same map.
+ */
+export const FLOWS = { recurring: "estimate", standard: "quote", deep: "quote", other: "quote" } as const satisfies LeadFlows;
+export const PHOTO_NEEDS: readonly Subject[] = ["deep"];
+
 /**
  * What the quote form asks, and the one rule worth enforcing: a lead with no
- * way to reach the customer is not a lead. The reason is for the log only.
+ * way to reach the customer is not a lead. `validateLead` is the number rule
+ * the form itself blocks on; a brand rule of its own composes with it —
+ * `lead => validateLead(lead) ?? mine(lead)` — and names the field it refuses,
+ * which the form shows the error at.
  */
 export const LEAD: LeadSchema<Subject> = {
   subjects: SUBJECTS,
@@ -13,5 +25,6 @@ export const LEAD: LeadSchema<Subject> = {
   extras: [{ name: "surface_m2", max: 6 }],
   // One shape for the mail, the webhook and a dialler: `+33612345678`.
   mobileFormat: "e164",
-  validate: lead => (lead.mobile.replace(/\D/g, "").length < 10 ? "a mobile number" : null),
+  validate: validateLead,
+  flows: FLOWS,
 };

package/template/src/shared/config/pricing.ts

@@ -0,0 +1,49 @@
+import type { PricingModel } from "@evinvest/kitstart";
+
+/**
+ * The baked price list: what `recurring` is priced from until the panel
+ * serves one (`GET <LOCATIONS_API_URL>/pricing`), and whenever it is down.
+ * OWNER_TODO: placeholder amounts — the owner sets the real ones in the panel.
+ */
+export const PRICING: PricingModel = {
+  format: 1,
+  currency: "EUR",
+  validFrom: "2026-10-01",
+  roundToCents: 100,
+  minimumCents: 4900,
+  inputs: [
+    {
+      id: "bedrooms",
+      kind: "add",
+      labels: { fr: "Chambres", en: "Bedrooms" },
+      options: [
+        { id: "studio", labels: { fr: "Studio", en: "Studio" }, addCents: 0 },
+        { id: "t2", labels: { fr: "1 chambre", en: "1 bedroom" }, addCents: 1500 },
+        { id: "t3", labels: { fr: "2 chambres", en: "2 bedrooms" }, addCents: 3000 },
+        { id: "t4", labels: { fr: "3 chambres et plus", en: "3 bedrooms or more" }, addCents: 4500 },
+      ],
+    },
+    {
+      id: "surface",
+      kind: "add",
+      labels: { fr: "Surface", en: "Floor area" },
+      options: [
+        { id: "s40", labels: { fr: "Moins de 40 m²", en: "Under 40 m²" }, addCents: 0 },
+        { id: "s70", labels: { fr: "40 à 70 m²", en: "40 to 70 m²" }, addCents: 1000 },
+        { id: "s70p", labels: { fr: "Plus de 70 m²", en: "Over 70 m²" }, addCents: 2500 },
+      ],
+    },
+    {
+      id: "frequency",
+      kind: "discount",
+      labels: { fr: "Fréquence", en: "How often" },
+      options: [
+        { id: "weekly", labels: { fr: "Chaque semaine", en: "Every week" }, discountBp: 1500 },
+        { id: "biweekly", labels: { fr: "Toutes les 2 semaines", en: "Every 2 weeks" }, discountBp: 1000 },
+        { id: "monthly", labels: { fr: "Chaque mois", en: "Every month" }, discountBp: 500 },
+        { id: "once", labels: { fr: "Une fois", en: "Once" }, discountBp: 0 },
+      ],
+    },
+  ],
+  needs: { recurring: { kind: "estimate", baseCents: 4500, inputs: ["bedrooms", "surface", "frequency"] } },
+};

package/template/src/shared/config/site.ts

@@ -2,6 +2,7 @@ import { cardFact, defineSite, SERVICE_AREA_GATE, type OwnerTodo } from "@evinve
 import { i18n } from "./i18n";
 import { LEAD } from "./lead";
 import { PLACES } from "./places";
+import { PRICING } from "./pricing";
 
 /**
  * The brand as the machinery sees it — routing, the lead funnel, schema.org,
@@ -29,6 +30,7 @@ export const site = defineSite({
   places: PLACES,
   publication: SERVICE_AREA_GATE,
   lead: LEAD,
+  pricing: PRICING,
 });
 
 export type PageKey = (typeof site.pageKeys)[number];
@@ -36,4 +38,5 @@ export type PageKey = (typeof site.pageKeys)[number];
 export const OWNER_TODO: readonly OwnerTodo[] = [
   { field: "site.brand.legalName", why: "raison sociale as registered", blocksLaunch: true },
   { field: "assets/card.toml phone", why: "the public number", blocksLaunch: false },
+  { field: "shared/config/pricing.ts", why: "placeholder prices until the panel serves the real ones", blocksLaunch: false },
 ];

package/template/src/views/home/ui/PlaceHome.tsx

@@ -1,8 +1,8 @@
-import { contactOf, placeGraph, type PlaceView } from "@evinvest/kitstart";
+import { contactOf, placeGraph, type PlaceView, type PricingModel } from "@evinvest/kitstart";
 import { CallBar, Coverage, Display, Faq, JsonLd, LeadCapture, Section } from "@evinvest/kitstart/react";
 import type { Copy } from "@/entities/content";
 import type { Locale } from "@/shared/config/i18n";
-import { LEAD } from "@/shared/config/lead";
+import { LEAD, PHOTO_NEEDS } from "@/shared/config/lead";
 import { site } from "@/shared/config/site";
 
 /**
@@ -12,7 +12,7 @@ import { site } from "@/shared/config/site";
  * `site.lead.wire` — restyle it through `classNames`, drive `layout` and
  * `prefer` from an experiment.
  */
-export function PlaceHome({ view, copy, renderedAt }: { view: PlaceView<Locale>; copy: Copy; renderedAt: number }) {
+export function PlaceHome({ view, copy, renderedAt, model }: { view: PlaceView<Locale>; copy: Copy; renderedAt: number; model: PricingModel | null }) {
   const { t, f } = copy;
   const contact = contactOf(site, view.place);
   const graph = placeGraph(site, view, "home", { placeName: f.place, title: t.pages.home.title(f), description: t.pages.home.description(f) }, new Date(renderedAt));
@@ -32,6 +32,9 @@ export function PlaceHome({ view, copy, renderedAt }: { view: PlaceView<Locale>;
             renderedAt={renderedAt}
             wire={LEAD.wire}
             needs={LEAD.subjects.map(s => ({ value: s, label: t.subjects[s] }))}
+            flows={LEAD.flows}
+            pricing={model}
+            photos={PHOTO_NEEDS}
             text={t.leadCapture}
             className="max-w-md"
           />

package/template/tests/bundle_budget.txt

@@ -8,6 +8,8 @@
 # first measurement plus a few percent; change it only in a commit that says why.
 #
 # Over it now, on purpose: the form became `LeadCapture`, a client island
-# (162,985 B gz, +3.2 %) — a warning to pay back, not a new target.
+# (162,985 B gz, +3.2 %) — a warning to pay back, not a new target. The form
+# variants (an estimate's tiles and live price, the priced success) add
+# about 3.9 KB gz more (170,375 B gz, +7.8 %).
 158000
 tolerance 20%

package/template/tests/e2e/flows.spec.ts

@@ -0,0 +1,106 @@
+import { expect, test, type Page } from "@playwright/test";
+
+// The form variants: `recurring` is an estimate, priced live from the baked
+// model (the mock panel's price list is down) and stored at the server's own
+// price; the slot is then set by a call — no booking provider yet.
+
+const hydrated = (page: Page) => expect(page.locator("#quote select")).toHaveCount(0);
+
+async function pickRecurring(page: Page, locale: "fr" | "en") {
+  await page.goto(`/${locale}`);
+  await hydrated(page);
+  await page.getByRole("combobox", { name: locale === "fr" ? "Prestation" : "Service" }).click();
+  await page.getByRole("listbox").getByRole("option", { name: locale === "fr" ? "Ménage régulier" : "Recurring cleaning" }).click();
+}
+
+const form = (page: Page) => page.locator("#quote-form");
+const answer = (page: Page, label: string) => form(page).getByRole("radio", { name: label, exact: true }).check();
+const price = (page: Page) => form(page).locator("[data-price-cents]");
+
+async function contact(page: Page, locale: "fr" | "en") {
+  await form(page).getByLabel(locale === "fr" ? "Code postal" : "Postcode").fill("75011");
+  await form(page).getByLabel(locale === "fr" ? "Téléphone" : "Phone").fill("0612345678");
+}
+
+const quote = (page: Page) => page.waitForResponse(r => r.request().method() === "POST" && new URL(r.url()).pathname === "/quote");
+
+test("an estimate prices the answers live, from the baked model while the panel's is down", async ({ page }) => {
+  await pickRecurring(page, "fr");
+  await expect(form(page).getByText("Répondez aux questions pour voir le prix.")).toBeVisible();
+  await expect(price(page)).toHaveCount(0);
+  await answer(page, "2 chambres");
+  await answer(page, "40 à 70 m²");
+  await answer(page, "Toutes les 2 semaines");
+  // 45 € + 30 € + 10 € = 85 €, less 10 % = 76,50 €, to the euro: 77 €.
+  await expect(price(page)).toHaveAttribute("data-price-cents", "7700");
+  await answer(page, "Une fois");
+  await expect(price(page)).toHaveAttribute("data-price-cents", "8500");
+  await expect(form(page).getByRole("button", { name: "Réserver" })).toBeVisible();
+});
+
+test("the server prices the posted answers itself: a posted amount is ignored", async ({ page }) => {
+  await pickRecurring(page, "fr");
+  await answer(page, "2 chambres");
+  await answer(page, "40 à 70 m²");
+  await answer(page, "Toutes les 2 semaines");
+  await expect(price(page)).toHaveAttribute("data-price-cents", "7700");
+  await contact(page, "fr");
+  // A tampered page: a price of its own, and an answer the screen did not price.
+  await form(page).evaluate(el => {
+    for (const name of ["quoted_cents", "cents", "price"]) {
+      const input = document.createElement("input");
+      input.type = "hidden";
+      input.name = name;
+      input.value = "1";
+      el.append(input);
+    }
+    const t3 = el.querySelector<HTMLInputElement>("input[name=estimate_bedrooms][value=t3]");
+    if (t3) t3.value = "t4";
+  });
+  const answered = quote(page);
+  await form(page).getByRole("button", { name: "Réserver" }).click();
+  // 45 € + 45 € + 10 € = 100 €, less 10 % = 90 €.
+  expect(await (await answered).json()).toMatchObject({ ok: true, cents: 9000 });
+  await expect(page.getByRole("status")).toContainText(/Demande enregistrée au prix de 90\s€\./);
+});
+
+test("a priced lead confirms the server's price and promises a call to set the slot, with no third party", async ({ page }) => {
+  const outside: string[] = [];
+  page.on("request", r => void (new URL(r.url()).hostname !== "localhost" && outside.push(r.url())));
+  await pickRecurring(page, "fr");
+  await answer(page, "Studio");
+  await answer(page, "Moins de 40 m²");
+  await answer(page, "Une fois");
+  await contact(page, "fr");
+  const answered = quote(page);
+  await form(page).getByRole("button", { name: "Réserver" }).click();
+  expect(await (await answered).json()).toMatchObject({ ok: true, cents: 4900, lead: expect.stringMatching(/^lead-\d+-[0-9a-f]{8}$/) });
+  const status = page.getByRole("status");
+  // 45 €, under the 49 € minimum.
+  await expect(status).toContainText(/Demande enregistrée au prix de 49\s€\./);
+  await expect(status).toContainText("Nous vous rappelons pour fixer le créneau.");
+  await expect(status).toBeFocused();
+  await expect(page.locator("iframe")).toHaveCount(0);
+  expect(outside).toEqual([]);
+});
+
+test("in English too", async ({ page }) => {
+  await pickRecurring(page, "en");
+  await answer(page, "1 bedroom");
+  await answer(page, "Over 70 m²");
+  await answer(page, "Every week");
+  // 45 € + 15 € + 25 € = 85 €, less 15 % = 72,25 €, to the euro: 72 €.
+  await expect(price(page)).toHaveAttribute("data-price-cents", "7200");
+  await contact(page, "en");
+  await form(page).getByRole("button", { name: "Book" }).click();
+  const status = page.getByRole("status");
+  await expect(status).toContainText("Request saved at €72.");
+  await expect(status).toContainText("We will call you to set the slot.");
+});
+
+test("a quote need is the form it always was", async ({ page }) => {
+  await page.goto("/fr");
+  await hydrated(page);
+  await expect(form(page).locator("input[name^=estimate_]")).toHaveCount(0);
+  await expect(form(page).getByRole("button", { name: "Recevoir le prix" })).toBeVisible();
+});

package/template/tests/e2e/mock-panel.mjs

@@ -0,0 +1,20 @@
+// The panel's internal endpoints as the e2e suite needs them, on
+// `E2E_MOCK_PORT`: the place's live half (nothing over the baked place), and
+// a price list that is down — so the page prices from the baked model.
+import { createServer } from "node:http";
+
+const port = Number(process.env["E2E_MOCK_PORT"]);
+const json = (res, status, body) => {
+  res.writeHead(status, { "content-type": "application/json" });
+  res.end(JSON.stringify(body));
+};
+
+createServer((req, res) => {
+  const url = new URL(req.url ?? "/", "http://mock");
+  if (url.pathname === "/health") return json(res, 200, { ok: true });
+  if (url.pathname === "/pricing") return json(res, 503, { error: "down" });
+  if (url.pathname === "/locations/paris") {
+    return json(res, 200, {});
+  }
+  return json(res, 404, { error: "no such route" });
+}).listen(port, "127.0.0.1");

package/template/tests/e2e/playwright.config.ts

@@ -4,6 +4,8 @@ import { BREAKPOINTS } from "@evinvest/kitstart/testing/e2e";
 // The standalone server under test, never `next dev`. Baselines are Linux's
 // (CI's); elsewhere the pixel comparison is skipped.
 const PORT = Number(process.env["E2E_PORT"] ?? 59089);
+// The panel stand-in (`mock-panel.mjs`): the live place and the price list.
+const MOCK_PORT = Number(process.env["E2E_MOCK_PORT"] ?? PORT + 1);
 const linux = process.platform === "linux";
 
 export default defineConfig({
@@ -14,13 +16,27 @@ export default defineConfig({
   expect: { toHaveScreenshot: { maxDiffPixelRatio: 0.01, animations: "disabled", stylePath: "./screenshot-section.css" } },
   use: { baseURL: `http://localhost:${PORT}`, deviceScaleFactor: 1, colorScheme: "light", locale: "fr-FR" },
   projects: BREAKPOINTS.map(b => ({ name: b.name, use: { ...devices["Desktop Chrome"], viewport: b.viewport } })),
-  webServer: {
-    command: "node .next/standalone/server.js",
-    cwd: "../..",
-    url: `http://localhost:${PORT}/health`,
-    reuseExistingServer: false,
-    // The prod server refuses to boot without these (instrumentation.ts); on
-    // loopback the one hop is the runner itself.
-    env: { PORT: String(PORT), HOSTNAME: "127.0.0.1", LEADS_DB_PATH: `/tmp/brand-e2e-${PORT}/leads.db`, TRUSTED_PROXY: "xff:1" },
-  },
+  webServer: [
+    {
+      command: "node mock-panel.mjs",
+      url: `http://127.0.0.1:${MOCK_PORT}/health`,
+      reuseExistingServer: false,
+      env: { E2E_MOCK_PORT: String(MOCK_PORT) },
+    },
+    {
+      command: "node .next/standalone/server.js",
+      cwd: "../..",
+      url: `http://localhost:${PORT}/health`,
+      reuseExistingServer: false,
+      // The prod server refuses to boot without these (instrumentation.ts); on
+      // loopback the one hop is the runner itself.
+      env: {
+        PORT: String(PORT),
+        HOSTNAME: "127.0.0.1",
+        LEADS_DB_PATH: `/tmp/brand-e2e-${PORT}/leads.db`,
+        TRUSTED_PROXY: "xff:1",
+        LOCATIONS_API_URL: `http://127.0.0.1:${MOCK_PORT}`,
+      },
+    },
+  ],
 });

package/template/tests/e2e/quote-form.spec.ts

@@ -131,7 +131,7 @@ for (const javaScriptEnabled of [false, true]) {
       expect(body.get("location")).toBe("paris");
       // The sentence shown is what is posted, and what the lead keeps.
       expect(body.get("consent")).toBe("J’accepte d’être rappelé·e à ce numéro au sujet de ma demande.");
-      await expect(page).toHaveURL(/\/fr\/thanks$/);
+      await expect(page).toHaveURL(/\/fr\/thanks\?channel=callback$/);
     });
 
     test("is refused without the consent", async ({ page }) => {
@@ -208,3 +208,88 @@ test("a scripted post of the form lands on the thanks page", async ({ page }) =>
   });
   expect(answer).toEqual({ ok: true, redirected: true, path: "/fr/thanks" });
 });
+
+// A number the server refuses: never silent, never lost (LEAD-FORMS-REVIEW-2026-10-03 #1).
+const INVALID = "Ce numéro n’est pas valide. Exemple : 06 12 34 56 78 ou +33 6 12 34 56 78.";
+
+test.describe("a refused number, without JavaScript", () => {
+  test.use({ javaScriptEnabled: false, reducedMotion: "reduce" });
+
+  test("goes back to the card, naming the field and keeping the need", async ({ page }) => {
+    await page.goto("/fr#quote");
+    const form = page.locator("#quote-form");
+    await form.getByLabel("Code postal").fill("75011");
+    await form.getByLabel("Téléphone").fill("06 12 34 56 7");
+    await form.getByRole("button", { name: "Recevoir le prix" }).click();
+    await expect(page).toHaveURL(/\/fr\?lead_error=phone&need=standard#quote$/);
+  });
+});
+
+test.describe("a refused number, with JavaScript", () => {
+  const hydrated = (page: Page) => expect(page.locator("#quote select")).toHaveCount(0);
+
+  test("is blocked before it is sent, in the page's words", async ({ page }) => {
+    await page.goto("/fr");
+    await hydrated(page);
+    let sent = 0;
+    page.on("request", r => void (r.method() === "POST" && sent++));
+    const form = page.locator("#quote-form");
+    await form.getByLabel("Code postal").fill("75011");
+    const phone = form.getByLabel("Téléphone");
+    await phone.fill("+3361234567");
+    await form.getByRole("button", { name: "Recevoir le prix" }).click();
+    await expect(phone).toHaveAttribute("aria-invalid", "true");
+    await expect(form.getByRole("alert")).toHaveText(INVALID);
+    expect(await phone.evaluate(el => (el instanceof HTMLInputElement ? el.validationMessage : ""))).toBe(INVALID);
+    expect(sent).toBe(0);
+  });
+
+  test("refused by the server, shows why at the field and keeps what was typed", async ({ page }) => {
+    await page.goto("/fr");
+    await hydrated(page);
+    const form = page.locator("#quote-form");
+    // Past the form's own check, as a stale page's would be.
+    await form.evaluate(el => el instanceof HTMLFormElement && (el.noValidate = true));
+    await form.getByLabel("Code postal").fill("75011");
+    const phone = form.getByLabel("Téléphone");
+    await phone.fill("0000000000");
+    const answered = page.waitForResponse(r => new URL(r.url()).pathname === "/quote");
+    await form.getByRole("button", { name: "Recevoir le prix" }).click();
+    expect((await answered).status()).toBe(422);
+    await expect(form.getByRole("alert")).toHaveText(INVALID);
+    await expect(phone).toBeFocused();
+    await expect(phone).toHaveValue("0000000000");
+    await expect(form.getByLabel("Code postal")).toHaveValue("75011");
+    await expect(page).toHaveURL(/\/fr$/);
+  });
+
+  test("brought back by the no-JS refusal, shows it at the field", async ({ page }) => {
+    await page.goto("/fr?lead_error=phone&need=deep#quote");
+    const form = page.locator("#quote-form");
+    await expect(form.getByRole("alert")).toHaveText(INVALID);
+    await expect(form.getByLabel("Téléphone")).toBeFocused();
+    // The need came back with it: chosen, not asked again.
+    await expect(form.locator("input[name=subject]")).toHaveValue("deep");
+    await expect(form.getByText("Grand ménage")).toBeVisible();
+    await expect(page).toHaveURL(/\/fr\?need=deep#quote$/);
+  });
+});
+
+// No network at the press of submit: the form stays, says so, and sends the
+// same lead once the network is back (LEAD-FORMS-REVIEW-2026-10-03 #4).
+test("offline, the form says so, keeps what was typed and sends it on retry", async ({ page, context }) => {
+  await page.goto("/fr");
+  await expect(page.locator("#quote select")).toHaveCount(0);
+  const form = page.locator("#quote-form");
+  await form.getByLabel("Code postal").fill("75011");
+  await form.getByLabel("Téléphone").fill("0612345678");
+  await context.setOffline(true);
+  await form.getByRole("button", { name: "Recevoir le prix" }).click();
+  const alert = form.getByRole("alert");
+  await expect(alert).toContainText("Pas de connexion");
+  await expect(page).toHaveURL(/\/fr$/);
+  await expect(form.getByLabel("Téléphone")).toHaveValue("0612345678");
+  await context.setOffline(false);
+  await alert.getByRole("button", { name: "Réessayer" }).click();
+  await expect(page).toHaveURL(/\/fr\/thanks$/);
+});