@jtakeit/kit 0.6.0 → 0.7.1

package/index.mjs

@@ -15,7 +15,8 @@
  * and the enquiry form the same way: `@jtakeit/kit/lead`,
  * `@jtakeit/kit/elements/lead`, `@jtakeit/kit/lead.css`.
  */
-export { renderBookingForm, SENDS } from './lib/booking/render.mjs';
+export { renderBookingForm, bookingForm, SENDS } from './lib/booking/render.mjs';
+export { ALWAYS, ASKED, SAID, HOOKS } from './lib/booking/hooks.mjs';
 export { renderLeadForm, inputType } from './lib/lead/render.mjs';
 export { wordsFor, LOCALES } from './lib/booking/words.mjs';
 export { money } from './lib/money.mjs';

package/lib/booking/hooks.mjs

@@ -0,0 +1,91 @@
+/**
+ * What `<jtk-booking>` reads off a booking form — the whole of the contract
+ * between a form's markup and the element that makes it work.
+ *
+ * The element finds everything by these: a `data-*` attribute or an input's
+ * `name`, never a class. Classes, wrappers, the order of the fields, the
+ * words and the look are the site's; a form an agent copies and dresses in
+ * its own design keeps working as long as these are on it.
+ *
+ * Three kinds:
+ *
+ *   ALWAYS  every form has them, or it cannot book — the element says which
+ *           is missing in the console, and the platform's preflight fails a
+ *           booking page without them;
+ *   ASKED   a field the element shows only when the platform's answer asks
+ *           for it — a party, how many, how long, a second date. A form for
+ *           a business that never asks may leave one out; preflight fails it
+ *           where the business does ask;
+ *   SAID    where the element writes what happened — the running total, when
+ *           the visit ends, what was taken, the link to keep. Left out, that
+ *           line is not said and nothing else changes.
+ *
+ * The test (kit/test/hooks.test.mjs) holds `renderBookingForm` and the
+ * scaffold's `BookingForm.astro` to ALWAYS, ASKED and SAID; the platform's
+ * preflight keeps its own copy of ALWAYS and ASKED, written from this one.
+ */
+
+/** @typedef {{ hook: string; says: string }} Hook */
+
+/** @type {readonly Hook[]} */
+export const ALWAYS = Object.freeze([
+  { hook: 'form[data-booking]', says: 'the form; `data-api`, `data-sends` and `data-locale` on it' },
+  { hook: '[name=service]', says: 'a `<select>` for one service, or checkboxes for several (`combine`)' },
+  { hook: '[name=day]', says: 'an `<input type="date">`; the week of days is drawn over it' },
+  { hook: '[data-times]', says: 'around the times: the hint, the times and when the visit ends' },
+  { hook: '[data-slots]', says: 'empty; the element writes a button per free time into it' },
+  { hook: '[data-times-hint]', says: '«pick a day», «nothing free», «…» while it asks' },
+  { hook: '[name=name]', says: 'the visitor\'s name' },
+  { hook: '[name=phone]', says: 'a phone or an email, one of the two is needed' },
+  { hook: '[name=email]', says: 'a phone or an email, one of the two is needed' },
+  { hook: '[data-challenge]', says: 'empty and hidden; the anti-bot widget goes here where the host has one' },
+  { hook: '[data-booking-error]', says: 'the refusal, said; tied to the fields it is about' },
+  { hook: '[data-submit]', says: 'the submit button' },
+  { hook: '[data-done]', says: 'hidden; shown once booked, with the lines below inside it' },
+  { hook: '[data-done-line]', says: '«you are booked» or «waiting for the business»' },
+  { hook: '[data-done-when]', says: 'the day and the time booked' },
+  { hook: '[data-manage]', says: 'a link to the visitor\'s own page: cancel, move' },
+  { hook: '[data-pay-note]', says: 'the sentence before paying, where the booking is paid online' },
+  { hook: '[data-pay]', says: 'the link that pays, where the booking is paid online' },
+]);
+
+/** @type {readonly (Hook & { when: string })[]} */
+export const ASKED = Object.freeze([
+  { hook: '[data-party-field]', when: 'party_max > 1', says: 'hidden; around `[name=party]`, a `<select>` the element fills' },
+  { hook: '[name=party]', when: 'party_max > 1', says: 'how many people' },
+  { hook: '[data-quantity-field]', when: 'quantity_max > 1', says: 'hidden; around `[name=quantity]`' },
+  { hook: '[name=quantity]', when: 'quantity_max > 1', says: 'how many of a class at once' },
+  { hook: '[data-hours-field]', when: 'an hourly service with most > fewest', says: 'hidden; around `[name=hours]`' },
+  { hook: '[name=hours]', when: 'an hourly service with most > fewest', says: 'how long, in the service\'s units' },
+  { hook: '[data-back-field]', when: 'a daily service with most > fewest', says: 'hidden; around `[name=back]` and `[data-length]`' },
+  { hook: '[name=back]', when: 'a daily service with most > fewest', says: 'the second date: until when' },
+  { hook: '[data-length]', when: 'a daily service with most > fewest', says: 'how many nights may be taken' },
+  { hook: '[name=resource]', when: 'the visitor chooses whom', says: 'a `<select>`: anyone, a class, or one by name' },
+]);
+
+/** @type {readonly Hook[]} */
+export const SAID = Object.freeze([
+  { hook: '[data-field]', says: 'on each field\'s wrapper: what the two steps sort and what is hidden once booked' },
+  { hook: '[data-services]', says: 'the checklist\'s fieldset' },
+  { hook: '[data-service-row]', says: 'the `<label>` around each checkbox: greyed with `data-off` when the one chosen does not do it' },
+  { hook: '[data-service-name]', says: 'the service\'s name inside the row' },
+  { hook: '[data-total]', says: 'the running total of a checklist' },
+  { hook: '[data-ends]', says: '«until about 10:45 · 1 h 15 min»' },
+  { hook: '[data-stay-total]', says: 'the price of a stay' },
+  { hook: '[data-done-what]', says: 'what was taken: «with Noa», «any of Economy»' },
+  { hook: '[data-keep]', says: 'hidden; the link to keep, with `[data-keep-note]`, `[data-keep-link]`, `[data-keep-copy]`, `[data-keep-open]`, `[data-keep-said]`' },
+  { hook: '[data-telegram]', says: 'a link to the business\'s Telegram bot, where it has one' },
+  { hook: '[name=note]', says: 'a note to the business' },
+]);
+
+/** Every hook, for a check that reads them all. */
+export const HOOKS = Object.freeze([...ALWAYS, ...ASKED, ...SAID].map((one) => one.hook));
+
+/**
+ * The hooks in `ALWAYS` a form lacks — what the element says in the console
+ * when it wires one.
+ * @param {ParentNode & { matches?: (s: string) => boolean }} form
+ */
+export function lacking(form) {
+  return ALWAYS.filter(({ hook }) => hook !== 'form[data-booking]' && !form.querySelector(hook)).map(({ hook }) => hook);
+}

package/lib/booking/render.mjs

@@ -8,11 +8,14 @@
  * what they answer. Nothing about availability is computed on the page, and
  * nothing about the visitor's choice is trusted by the server.
  *
- * This is the markup `@jtakeit/astro`'s `BookingForm.astro` used to carry
- * itself; it is a string now so a site on any generator can put the same form
- * on a page: Eleventy in a shortcode, Next in `dangerouslySetInnerHTML`, a
- * Node script in a template literal. Keep the `data-*` hooks and the input
- * `name`s whatever you do to its classes: the element reads those, and the
+ * Two ways to the same form. `renderBookingForm` writes it as a string, for a
+ * site on any generator: Eleventy in a shortcode, Next in
+ * `dangerouslySetInnerHTML`, a Node script in a template literal.
+ * `bookingForm` gives what that string is made of — the words, the services
+ * in their runs, the form's attributes, the days — for a page that writes the
+ * markup itself, the way `@jtakeit/astro`'s `BookingForm.astro` does, so the
+ * markup is the site's and only the facts are the kit's. Either way, keep the
+ * hooks (`./hooks.mjs`): the element reads those and nothing else, and the
  * platform reads what the element sends.
  *
  * ── what the page passes in ─────────────────────────────────────────────────
@@ -87,31 +90,45 @@ function esc(value) {
 /**
  * A service's price as the list says it: the price, or «from …» for one
  * priced by the hour of the week — whose price is the slot's and is printed
- * beside the time once one is chosen (wiki/68).
+ * beside the time once one is chosen (wiki/68). Plain text, not escaped.
  * @param {Named} one
  * @param {string} currency
  * @param {string} lang
+ * @param {Record<string, string>} words
  */
-function priceSaid(one, currency, lang) {
-  if (one.costs) return ` · ${esc(money(one.costs, currency, lang))}`;
+function priceText(one, currency, lang, words) {
+  if (one.costs) return money(one.costs, currency, lang);
   const least = priceFrom(one);
-  return least > 0 ? ` · ${esc(wordsFor(lang).from)} ${esc(money(least, currency, lang))}` : '';
+  return least > 0 ? `${words.from} ${money(least, currency, lang)}` : '';
 }
 
 /**
- * The booking form as HTML.
+ * @typedef {object} BookingForm
+ * @property {Record<string, string>} words  the form's words, in the page's language; the platform's answer replaces the kind's
+ * @property {string} lang                 the language tag prices and days are written in
+ * @property {boolean} combine             a checklist, or one `<select>`
+ * @property {{ group: string; items: (Named & { meta: string })[] }[]} runs  the checklist's runs, headings in order, the ones with none after them, the add-ons last under their own; `meta` is «45 min · CHF 95»
+ * @property {Named[]} services            for one `<select>`, as they came
+ * @property {(Named & { does: string })[]} resources  the choice of whom — empty for none; `does` is the slugs, joined, for `data-does`
+ * @property {string} today                the day input's `min`
+ * @property {string} last                 its `max`
+ * @property {Record<string, string>} attrs  every attribute of the `<form>`, `data-booking` and `novalidate` among them — spread them on it
+ */
+
+/**
+ * What the booking form is made of, for a page that writes the markup.
  *
  * @param {BookingFormProps} props
- * @returns {string}
+ * @returns {BookingForm}
  */
-export function renderBookingForm(props) {
+export function bookingForm(props) {
   const {
     services, resources = [], locale, daysAhead = 30, combine = false, currency = '', scale = '', kind = '',
-    api = '/api/', tag = 'jtk-booking', now = new Date(), open = [], ui = true,
+    api = '/api/', now = new Date(), open = [], ui = true,
   } = props;
-  if (!Array.isArray(services)) throw new TypeError('renderBookingForm: services is a list of { slug, title }');
+  if (!Array.isArray(services)) throw new TypeError('bookingForm: services is a list of { slug, title }');
   const unsaid = kind !== '' && kind !== 'salon';
-  const WORDS = wordsFor(locale, scale);
+  const words = wordsFor(locale, scale);
   const lang = { de: 'de-CH', uk: 'uk-UA', ru: 'ru-RU', es: 'es-ES', it: 'it-IT', pt: 'pt-PT', fr: 'fr-FR' }[locale] ?? 'en';
 
   // The checklist's runs, in the order the services came, each heading once.
@@ -139,15 +156,62 @@ export function renderBookingForm(props) {
   // its own heading, after the services, and rides on the visit (wiki/70).
   const addOns = runs.flatMap((run) => run.items.filter((one) => !one.takes && (one.costs || priceFrom(one))));
   const timedRuns = runs.map((run) => ({ ...run, items: run.items.filter((one) => !addOns.includes(one)) })).filter((run) => run.items.length > 0);
+  /** @param {Named} one */
+  const meta = (one) => [one.takes ? `${one.takes} min` : '', priceText(one, currency, lang, words), one.per === 'person' ? words.perPerson : ''].filter(Boolean).join(' · ');
+
+  // Fixed, the whole form, as the lead form's labels are: every word in it is
+  // the platform's — spoken in the business's kind from the availability
+  // answer, «Забронювати» over the build's «Записатися» — or an entry's own
+  // title, which the owner edits on the entry. None is the owner's to edit
+  // here, and `jtk catalogue` asked whose all seventeen were on a fresh
+  // restaurant (30 September 2026).
+  /** @type {Record<string, string>} */
+  const attrs = {
+    'data-booking': '',
+    'data-locale': locale,
+    'data-currency': currency,
+    'data-words': JSON.stringify(words),
+    'data-scale': scale,
+    'data-api': api,
+    'data-sends': SENDS.join(','),
+    'data-open': open.join(','),
+    ...(ui ? { 'data-ui': ui === true ? 'steps week parts select' : String(ui) } : {}),
+    ...(unsaid ? { 'data-unsaid': '' } : {}),
+    // Its own name as its value: Astro drops a boolean attribute spread as
+    // '', and the browser's own check stopped every booking without a name
+    // before the form could say so (12 October 2026).
+    novalidate: 'novalidate',
+    'data-jtk-fixed': '',
+  };
+
+  return {
+    words, lang, combine, today, last, attrs, services,
+    runs: [...timedRuns, ...(addOns.length ? [{ group: words.addOns, items: addOns }] : [])].map((run) => ({ ...run, items: run.items.map((one) => ({ ...one, meta: meta(one) })) })),
+    resources: resources.length > 1 ? resources.map((one) => ({ ...one, does: Array.isArray(one.does) ? one.does.join(',') : '' })) : [],
+  };
+}
+
+/**
+ * The booking form as HTML — `bookingForm`'s facts in the kit's own markup.
+ *
+ * @param {BookingFormProps} props
+ * @returns {string}
+ */
+export function renderBookingForm(props) {
+  const { tag = 'jtk-booking', kind = '' } = props;
+  if (!Array.isArray(props.services)) throw new TypeError('renderBookingForm: services is a list of { slug, title }');
+  const { words: WORDS, combine, runs, services, resources, today, last, attrs } = bookingForm(props);
+  const unsaid = kind !== '' && kind !== 'salon';
+
   const servicesField = combine
     ? `<fieldset class="booking__services" data-services>
         <legend class="field__label" data-say="services">${esc(WORDS.services)}</legend>
-        ${[...timedRuns, ...(addOns.length ? [{ group: WORDS.addOns, items: addOns }] : [])].map((run) => `<div class="booking__run">
-            ${run.group !== '' ? `<p class="booking__run-title">${esc(run.group)}</p>` : ''}
-            ${run.items.map((one) => `<label class="booking__service">
+        ${runs.map((run, i) => `<div class="booking__run"${run.group !== '' ? ` role="group" aria-labelledby="booking-run-${i}"` : ''}>
+            ${run.group !== '' ? `<p class="booking__run-title" id="booking-run-${i}">${esc(run.group)}</p>` : ''}
+            ${run.items.map((one) => `<label class="booking__service" data-service-row>
                 <input type="checkbox" name="service" value="${esc(one.slug)}" data-takes="${esc(one.takes ?? 0)}" data-costs="${esc(one.costs ?? 0)}"${one.per === 'person' ? ' data-per="person"' : ''}>
-                <span class="booking__service-name">${esc(one.title)}</span>
-                <span class="booking__service-meta">${one.takes ? `${esc(one.takes)} min` : ''}${priceSaid(one, currency, lang)}${one.per === 'person' ? ` · ${esc(WORDS.perPerson)}` : ''}</span>
+                <span class="booking__service-name" data-service-name>${esc(one.title)}</span>
+                <span class="booking__service-meta">${esc(one.meta)}</span>
               </label>`).join('\n')}
           </div>`).join('\n')}
         <p class="booking__total" data-total hidden></p>
@@ -157,53 +221,48 @@ export function renderBookingForm(props) {
           ${services.map((one) => `<option value="${esc(one.slug)}">${esc(one.title)}</option>`).join('\n')}
         </select>`;
 
-  const resourcesField = resources.length > 1
-    ? `<div class="field">
+  const resourcesField = resources.length > 0
+    ? `<div class="field" data-field>
       <label class="field__label" for="booking-resource" data-say="resource">${esc(WORDS.resource)}</label>
       <select class="field__input" id="booking-resource" name="resource" data-say-wait>
         <option value="" data-say="any">${esc(WORDS.any)}</option>
-        ${resources.map((one) => `<option value="${esc(one.slug)}"${Array.isArray(one.does) && one.does.length > 0 ? ` data-does="${esc(one.does.join(','))}"` : ''}>${esc(one.title)}</option>`).join('\n')}
+        ${resources.map((one) => `<option value="${esc(one.slug)}"${one.does ? ` data-does="${esc(one.does)}"` : ''}>${esc(one.title)}</option>`).join('\n')}
       </select>
     </div>`
     : '';
 
-  // Fixed, the whole form, as the lead form's labels are: every word in it is
-  // the platform's — spoken in the business's kind from the availability
-  // answer, «Забронювати» over the build's «Записатися» — or an entry's own
-  // title, which the owner edits on the entry. None is the owner's to edit
-  // here, and `jtk catalogue` asked whose all seventeen were on a fresh
-  // restaurant (30 September 2026).
-  const form = `<form class="booking${unsaid ? ' booking--unsaid' : ''}" data-booking data-locale="${esc(locale)}" data-currency="${esc(currency)}" data-words="${esc(JSON.stringify(WORDS))}" data-scale="${esc(scale)}" data-api="${esc(api)}" data-sends="${SENDS.join(',')}" data-open="${esc(open.join(','))}"${ui ? ` data-ui="${ui === true ? 'steps week parts select' : esc(ui)}"` : ''} novalidate data-jtk-fixed>
+  const said = Object.entries(attrs).map(([key, value]) => (value === '' || value === key ? ` ${key}` : ` ${key}="${esc(value)}"`)).join('');
+  const form = `<form class="booking${unsaid ? ' booking--unsaid' : ''}"${said}>
   <noscript><p class="booking__note">${esc(WORDS.noScript)}</p></noscript>
 
-  <div class="field">
+  <div class="field" data-field>
     ${servicesField}
   </div>
 
   ${resourcesField}
 
-  <div class="field">
+  <div class="field" data-field>
     <label class="field__label" for="booking-day">${esc(WORDS.day)}</label>
     <input class="field__input" id="booking-day" name="day" type="date" min="${today}" max="${last}" required>
   </div>
 
-  <div class="field" data-back-field hidden>
+  <div class="field" data-field data-back-field hidden>
     <label class="field__label" for="booking-back">${esc(WORDS.back)}</label>
     <input class="field__input" id="booking-back" name="back" type="date" min="${today}">
     <p class="booking__hint" data-length hidden></p>
   </div>
 
-  <div class="field" data-hours-field hidden>
+  <div class="field" data-field data-hours-field hidden>
     <label class="field__label" for="booking-hours">${esc(WORDS.hours)}</label>
     <select class="field__input" id="booking-hours" name="hours"></select>
   </div>
 
-  <div class="field" data-party-field hidden>
+  <div class="field" data-field data-party-field hidden>
     <label class="field__label" for="booking-party">${esc(WORDS.party)}</label>
     <select class="field__input" id="booking-party" name="party"></select>
   </div>
 
-  <div class="field" data-quantity-field hidden>
+  <div class="field" data-field data-quantity-field hidden>
     <label class="field__label" for="booking-quantity">${esc(WORDS.quantity)}</label>
     <select class="field__input" id="booking-quantity" name="quantity"></select>
   </div>
@@ -216,26 +275,26 @@ export function renderBookingForm(props) {
     <p class="booking__total" data-stay-total hidden></p>
   </fieldset>
 
-  <div class="field">
+  <div class="field" data-field>
     <label class="field__label" for="booking-name">${esc(WORDS.name)} <span aria-hidden="true">*</span></label>
     <input class="field__input" id="booking-name" name="name" type="text" autocomplete="name" required maxlength="120">
   </div>
-  <div class="field">
+  <div class="field" data-field>
     <label class="field__label" for="booking-phone">${esc(WORDS.phone)}</label>
     <input class="field__input" id="booking-phone" name="phone" type="tel" inputmode="tel" autocomplete="tel" maxlength="40">
   </div>
-  <div class="field">
+  <div class="field" data-field>
     <label class="field__label" for="booking-email">${esc(WORDS.email)}</label>
     <input class="field__input" id="booking-email" name="email" type="email" inputmode="email" autocomplete="email" maxlength="120">
   </div>
-  <div class="field">
+  <div class="field" data-field>
     <label class="field__label" for="booking-note">${esc(WORDS.note)}</label>
     <textarea class="field__input field__input--area" id="booking-note" name="note" rows="3" maxlength="2000"></textarea>
   </div>
 
   <div class="booking__challenge" data-challenge hidden></div>
 
-  <p class="field__error" data-booking-error role="alert" hidden></p>
+  <p class="field__error" id="booking-error" data-booking-error role="alert" hidden></p>
 
   <button class="booking__submit" type="submit" data-submit data-say="book">${esc(WORDS.book)}</button>
 
@@ -250,6 +309,7 @@ export function renderBookingForm(props) {
         <button type="button" class="booking__keep-copy" data-keep-copy></button>
         <a class="booking__keep-open" data-keep-open></a>
       </div>
+      <span class="booking__sr" role="status" data-keep-said></span>
     </div>
     <p class="booking__note" data-pay-note hidden></p>
     <p class="booking__links">

package/lib/booking/words.mjs

@@ -49,6 +49,7 @@ const BASE = {
     back: 'До', length: 'Від {min} до {max} діб.', anyOf: 'Будь-яке вільне — {class}', noneOf: '{class} — немає вільних', notFor: '{who} — не для обраного', notForChosen: '{who} — не для обраного. Оберіть іншого або «{any}».', took: 'Ви берете: {what}',
     party: 'Скільки вас', perPerson: 'за особу', addOns: 'Додатково', quantity: 'Скільки — доріжок, столів, кімнат', together: '{n} разом', hours: 'Скільки часу', hourShort: 'год', minuteShort: 'хв', challenge: 'Підтвердіть, що ви не робот, і спробуйте ще раз.', tooMany: 'У вас уже є кілька відкритих записів. Скасуйте один із них або зателефонуйте нам.',
     from: 'від',
+    needName: "Вкажіть імʼя, щоб ми знали, кого чекати.",
     needContact: 'Вкажіть телефон або пошту, щоб ми могли з вами звʼязатися.', noScript: 'Онлайн-форма працює з увімкненим JavaScript — увімкніть його або зателефонуйте нам.',
   },
   de: {
@@ -87,6 +88,7 @@ const BASE = {
     back: 'Bis', length: 'Von {min} bis {max} Nächte.', anyOf: 'Beliebig frei — {class}', noneOf: '{class} — nichts verfügbar', notFor: '{who} — nicht für diese Auswahl', notForChosen: '{who} — nicht für diese Auswahl. Bitte jemand anderen oder «{any}» wählen.', took: 'Sie nehmen: {what}',
     party: 'Wie viele Personen', perPerson: 'pro Person', addOns: 'Zusätzlich', quantity: 'Wie viele — Bahnen, Tische, Zimmer', together: '{n} zusammen', hours: 'Wie lange', hourShort: 'Std.', minuteShort: 'Min.', challenge: 'Bitte bestätigen Sie, dass Sie kein Roboter sind, und versuchen Sie es erneut.', tooMany: 'Sie haben bereits mehrere offene Termine. Sagen Sie einen ab oder rufen Sie uns an.',
     from: 'ab',
+    needName: "Bitte geben Sie Ihren Namen an.",
     needContact: 'Bitte Telefon oder E-Mail angeben, damit wir Sie erreichen können.', noScript: 'Für die Online-Buchung ist JavaScript nötig — oder rufen Sie uns an.',
   },
   en: {
@@ -125,6 +127,7 @@ const BASE = {
     back: 'Until', length: 'From {min} to {max} nights.', anyOf: 'Any free — {class}', noneOf: '{class} — none available', notFor: '{who} — not for this choice', notForChosen: '{who} — not for this choice. Pick another, or «{any}».', took: 'You are taking: {what}',
     party: 'How many of you', perPerson: 'per person', addOns: 'Add-ons', quantity: 'How many — lanes, tables, rooms', together: '{n} together', hours: 'How long', hourShort: 'h', minuteShort: 'min', challenge: 'Please confirm you are not a robot and try again.', tooMany: 'You already have several open bookings. Cancel one, or ring us.',
     from: 'from',
+    needName: "Please give your name.",
     needContact: 'Leave a phone number or an email so we can reach you.', noScript: 'Booking online needs JavaScript — or ring us.',
   },
   ru: {
@@ -192,6 +195,7 @@ const BASE = {
     challenge: "Подтвердите, что вы не робот, и попробуйте еще раз.",
     tooMany: "У вас уже есть несколько открытых записей. Отмените одну из них или позвоните нам.",
     from: 'от',
+    needName: "Укажите имя, чтобы мы знали, кого ждать.",
     needContact: "Укажите телефон или почту, чтобы мы могли с вами связаться.",
     noScript: "Онлайн-форма работает с включенным JavaScript — включите его или позвоните нам.",
   },
@@ -260,6 +264,7 @@ const BASE = {
     challenge: "Confirme que no es un robot e inténtelo de nuevo.",
     tooMany: "Ya tiene varias reservas abiertas. Cancele una o llámenos.",
     from: 'desde',
+    needName: "Indique su nombre, por favor.",
     needContact: "Deje un teléfono o un correo electrónico para que podamos contactar con usted.",
     noScript: "Para reservar en línea hace falta JavaScript — o llámenos.",
   },
@@ -328,6 +333,7 @@ const BASE = {
     challenge: "Confermi di non essere un robot e riprovi.",
     tooMany: "Ha già diverse prenotazioni aperte. Ne annulli una, o ci chiami.",
     from: 'da',
+    needName: "Indichi il Suo nome, per favore.",
     needContact: "Lasci un numero di telefono o un'email per poterLa contattare.",
     noScript: "Per prenotare online serve JavaScript: oppure ci chiami.",
   },
@@ -396,6 +402,7 @@ const BASE = {
     challenge: "Confirme que não é um robô e tente de novo.",
     tooMany: "Já tem várias reservas em aberto. Cancele uma ou ligue-nos.",
     from: 'desde',
+    needName: "Indique o seu nome, por favor.",
     needContact: "Deixe um telefone ou um e-mail para podermos contactá-lo.",
     noScript: "Reservar online precisa de JavaScript — ou ligue-nos.",
   },
@@ -464,6 +471,7 @@ const BASE = {
     challenge: "Veuillez confirmer que vous n’êtes pas un robot et réessayer.",
     tooMany: "Vous avez déjà plusieurs réservations en cours. Annulez-en une, ou appelez-nous.",
     from: 'à partir de',
+    needName: "Indiquez votre nom, s'il vous plaît.",
     needContact: "Laissez un numéro de téléphone ou un e-mail pour que nous puissions vous joindre.",
     noScript: "Réserver en ligne nécessite JavaScript — ou appelez-nous.",
   },

package/lib/lint.mjs

@@ -363,8 +363,45 @@ export async function lint(options = {}) {
  * The command: print the findings the way the build does, and exit 1 on any.
  * @param {{ root?: string, dist?: string, siteURL?: string }} options
  */
+/**
+ * The files under a built directory the platform never publishes: a path with
+ * a segment that starts with a dot, `.well-known/` at the root aside — the
+ * rule the platform's upload and edge keep (its wiki/81). A directory is said
+ * once, with a slash.
+ * @param {string} dir
+ * @returns {Promise<string[]>}
+ */
+export async function withheldIn(dir) {
+  /** @type {string[]} */
+  const out = [];
+  /** @param {string} at @param {string} rel */
+  async function walk(at, rel) {
+    let entries;
+    try {
+      entries = await readdir(at, { withFileTypes: true });
+    } catch {
+      return;
+    }
+    for (const entry of entries) {
+      const path = rel === '' ? entry.name : `${rel}/${entry.name}`;
+      const dotted = entry.name.startsWith('.') && !(rel === '' && entry.name === '.well-known');
+      if (dotted) out.push(entry.isDirectory() ? `${path}/` : path);
+      else if (entry.isDirectory()) await walk(join(at, entry.name), path);
+    }
+  }
+  await walk(dir, '');
+  return out.sort();
+}
+
 export async function lintCommand(options) {
   const out = await lint(options);
+  // Said, and not a failure: the platform leaves these out of the upload and
+  // its preflight fails the site until a build without them is served. Here
+  // they are caught before the push, which is when they are cheapest.
+  const withheld = await withheldIn(options.dist ?? join(options.root ?? process.cwd(), 'dist'));
+  if (withheld.length > 0) {
+    console.error(`  not published: ${withheld.join(', ')} — a path starting with a dot is never served (.well-known/ aside). It comes from the repository (usually public/): remove it there, and change any secret it held — it is in the history.`);
+  }
   for (const one of out.findings) console.error('  ' + said(one.code, one.says));
   if (out.line !== '') (out.ok ? console.log : console.error)('  ' + out.line);
   return out.ok ? 0 : 1;

package/lib/phases.mjs

@@ -103,9 +103,15 @@ export function sayPhase(where, progress, platform) {
     case 'laidOut':
       return 'Laying the site out';
     case 'writing': {
+      // In the order the work goes, not always «the pages»: an agent declaring
+      // the blocks and setting the diary up for five minutes read as writing
+      // a page it had not reached (13 October 2026).
+      if (progress && progress.catalogue !== true) return 'Declaring the blocks — what the site is made of';
+      if (progress && progress.kit !== null && progress.settings === null) return 'Setting up the bookings — hours, prices, what is booked';
       const pages = progress?.pages ?? [];
       const written = pages.filter((one) => one.written).length;
-      return `Writing the pages — ${written} of ${pages.length} with their text · still to do: ${progress?.missing.length ?? 0}`;
+      if (pages.length > 0 && written < pages.length) return `Writing the pages — ${written} of ${pages.length} with their text`;
+      return `Finishing — still to do: ${progress?.missing.length ?? 0}`;
     }
     case 'judged':
       if (!known || !platform.judged) return 'To be checked before the push';
@@ -137,3 +143,18 @@ export function meanwhile(platform) {
     done: theirs.filter((step) => step.done).map(named),
   };
 }
+
+/**
+ * Whether the page being looked at has no words yet: a page the files know,
+ * with not one text field filled. A page they do not know — a listing, an
+ * entry, a 404 — is never blank by this; nor is any page before the files
+ * could be read.
+ * @param {any} progress
+ */
+export function blankHere(progress, path = typeof location === 'undefined' ? '/' : location.pathname) {
+  if (!progress || !Array.isArray(progress.pages)) return false;
+  const norm = (p) => (p.length > 1 && p.endsWith('/') ? p.slice(0, -1) : p);
+  const here = norm(path);
+  const page = progress.pages.find((one) => norm(one.path) === here);
+  return page !== undefined && page.filled === 0;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jtakeit/kit",
-  "version": "0.6.0",
+  "version": "0.7.1",
   "description": "The framework-free half of a site on jtakeit: the booking form as an element and as markup, for Astro through @jtakeit/astro and for any other generator directly",
   "license": "MIT",
   "type": "module",
@@ -24,6 +24,10 @@
       "types": "./types/parts.d.ts",
       "default": "./lib/booking/parts.mjs"
     },
+    "./booking/hooks": {
+      "types": "./types/hooks.d.ts",
+      "default": "./lib/booking/hooks.mjs"
+    },
     "./lead": {
       "types": "./types/lead.d.ts",
       "default": "./lib/lead/render.mjs"

package/types/booking.d.ts

@@ -35,5 +35,26 @@ export interface BookingFormProps {
 
 /** What the form sends to /api/book, as `data-sends` says it. */
 export const SENDS: readonly string[];
+/** What the booking form is made of, for a page that writes the markup itself (the scaffold's BookingForm.astro). */
+export interface BookingForm {
+  /** The form's words in the page's language; the platform's answer replaces the kind's. */
+  words: Record<string, string>;
+  /** The language tag prices and days are written in. */
+  lang: string;
+  /** A checklist, or one `<select>`. */
+  combine: boolean;
+  /** The checklist's runs: headings in order, the ones with none after them, add-ons last. `meta` is «45 min · CHF 95». */
+  runs: { group: string; items: (Named & { meta: string })[] }[];
+  /** For one `<select>`, as they came. */
+  services: Named[];
+  /** The choice of whom — empty for none; `does` is the slugs joined for `data-does`. */
+  resources: (Omit<Named, 'does'> & { does: string })[];
+  /** The day input's `min` and `max`. */
+  today: string;
+  last: string;
+  /** Every attribute of the `<form>` — `data-booking`, `data-api`, `data-sends`, `novalidate`… — to spread on it. */
+  attrs: Record<string, string>;
+}
+export function bookingForm(props: BookingFormProps): BookingForm;
 /** The booking form as HTML, wrapped in `<jtk-booking>`. */
 export function renderBookingForm(props: BookingFormProps): string;

package/types/elements-booking.d.ts

@@ -7,3 +7,4 @@ export class JtkBooking extends HTMLElement {
   connectedCallback(): void;
 }
 export function defineBooking(name?: string): void;
+export const BOOKING_PROTOCOL: number;

package/types/hooks.d.ts

@@ -0,0 +1,12 @@
+export interface Hook {
+  hook: string;
+  says: string;
+}
+/** Every form has these, or it cannot book. */
+export const ALWAYS: readonly Hook[];
+/** Shown only when the platform's answer asks; preflight fails a form without one where the business asks. */
+export const ASKED: readonly (Hook & { when: string })[];
+/** Where the element writes what happened; left out, that line is not said. */
+export const SAID: readonly Hook[];
+export const HOOKS: readonly string[];
+export function lacking(form: ParentNode): string[];

package/types/index.d.ts

@@ -1,5 +1,7 @@
-export { renderBookingForm, SENDS } from './booking';
-export type { BookingFormProps, Named } from './booking';
+export { renderBookingForm, bookingForm, SENDS } from './booking';
+export type { BookingFormProps, BookingForm, Named } from './booking';
+export { ALWAYS, ASKED, SAID, HOOKS } from './hooks';
+export type { Hook } from './hooks';
 export { renderLeadForm, inputType } from './lead';
 export type { Ask, LeadCopy, LeadPaths, LeadFormProps } from './lead';
 export { wordsFor, LOCALES } from './words';

package/types/phases.d.ts

@@ -39,3 +39,4 @@ export function meanwhile(platform: PlatformHalf | null | undefined): {
   open: { key: string; name: string; done: boolean }[];
   done: { key: string; name: string; done: boolean }[];
 };
+export function blankHere(progress: unknown, path?: string): boolean;