@jtakeit/kit 0.5.2 → 0.7.0

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 ─────────────────────────────────────────────────
@@ -48,7 +51,7 @@ export const SENDS = Object.freeze(['service', 'services', 'resource', 'class',
  * @property {number} [costs] minor units, for the same
  * @property {{ day: string, from: number, until: number, costs: number }[]} [rates] a price by the hour of the week instead of `costs`: the list says «from …», and the price is the slot's, printed beside the time
  * @property {string} [per]   `'person'` for a price times the party — a class per place, shoes; the list says so and the running total multiplies
- * @property {string} [group] a heading the services are listed under
+ * @property {string} [group] a heading the services are listed under — the words (an option's label, a category's title), not the stored value; services with none are listed after every heading
  * @property {string[]} [does] for a resource: the services they perform, by slug — the element greys the others out once they are chosen; empty or absent is everything
  */
 
@@ -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.
@@ -123,6 +140,14 @@ export function renderBookingForm(props) {
     if (run) run.items.push(one);
     else runs.push({ group, items: [one] });
   }
+  // The services with no heading go after every run that has one, wherever
+  // the first of them came: drawn first, they read as the run above the first
+  // heading, and drawn between two they read as the one before. A group is
+  // the heading's words — an option's label, a category's title — never the
+  // stored value; the page that reads the catalogue resolves it (12 October
+  // 2026: the scaffold passed `entry.data.group` itself).
+  const loose = runs.findIndex((r) => r.group === '');
+  if (loose >= 0 && runs.length > 1) runs.push(...runs.splice(loose, 1));
 
   const today = now.toISOString().slice(0, 10);
   const last = new Date(now.getTime() + daysAhead * 86_400_000).toISOString().slice(0, 10);
@@ -131,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>
@@ -149,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>
@@ -208,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>
 
@@ -242,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/catalogue.mjs

@@ -51,6 +51,7 @@ import { dirname, join, relative, resolve, sep } from 'node:path';
 import { pathToFileURL } from 'node:url';
 
 import { E, isAdvice, isPlatformCode, LOCAL } from './codes.mjs';
+import { shownAt } from './schedule.mjs';
 
 // What this tool calls itself in a catalogue it writes. Bumped when the shape
 // it emits changes; the `contract` beside it moves only when the format does.
@@ -587,11 +588,49 @@ for (const collection of collections) {
     }
   }
 
+  /*
+   * What the entries are grouped by: a select, or a ref to another
+   * collection, and nothing else — the platform's validateEntryGroup, mirrored
+   * (12 October 2026, wiki/78). Free text would be a list of one-entry groups
+   * with three spellings of "manicure". A ref into the collection itself is a
+   * tree, which is a `parent` field and takes no part in grouping: an entry
+   * heading its own siblings is a listing nobody can order.
+   */
+  if (collection.group !== undefined && collection.group !== '') {
+    const groupWhere = `${where}.group`;
+    const by = field(collection.group);
+    if (by === undefined) {
+      fault(E.COLLECTION, groupWhere, `grouped by "${collection.group}", which ${collection.type} does not declare`);
+    } else if (by.kind === 'ref' && by.ref === collection.name) {
+      fault(E.COLLECTION, groupWhere, `grouped by ${collection.type}.${collection.group}, which points into "${collection.name}" itself — group by another collection, and make a tree with a parent field`);
+    } else if (by.kind !== 'select' && by.kind !== 'ref') {
+      fault(E.COLLECTION, groupWhere, `grouped by ${collection.type}.${collection.group}, which is "${by.kind}" — group by a select, or by a ref to another collection`);
+    }
+  }
+
   const perPage = collection.per_page ?? 0;
   if (!Number.isInteger(perPage) || perPage < 0 || perPage > 200) {
     fault(E.COLLECTION, where, 'per_page must be between 1 and 200, or absent for one page');
   }
 
+  /*
+   * A listing at the prefix, asked for (the platform's CollectionDef.Listing,
+   * 12 October 2026): the scaffold draws one only where a collection says
+   * `listing: true`, because a page nobody asked for is an address on a
+   * client's site nobody designed. Only for a collection whose entries have
+   * pages — one without is listed on its prefix's page already, which the
+   * repository writes.
+   */
+  if (collection.listing !== undefined && typeof collection.listing !== 'boolean') {
+    fault(E.COLLECTION, `${where}.listing`, `listing is ${JSON.stringify(collection.listing)} — true, or absent for no listing at the prefix`);
+  } else if (collection.listing === true && collection.pages === false) {
+    fault(
+      E.COLLECTION,
+      `${where}.listing`,
+      `collection "${collection.name}" has no pages of its own, so its prefix's page is the listing already — the repository writes it; \`listing\` is for a collection whose entries have pages`,
+    );
+  }
+
   /*
    * What a post may hold, and the one type it must.
    *
@@ -619,6 +658,30 @@ for (const collection of collections) {
   }
 }
 
+/*
+ * Every `ref`, wherever it is — a block's field, a row of a list, the page's
+ * SEO, the business facts — names a collection this catalogue declares. The
+ * platform's validateRefs, mirrored on 12 October 2026, when a ref became
+ * the way a site has categories and tags (wiki/78): `tags: list of { tag:
+ * ref tags }` with no `tags` collection is a field whose every value points
+ * nowhere, and the judge refused it while this said nothing.
+ */
+{
+  const names = new Set(collections.map((one) => one.name));
+  const walk = (where, fields) => {
+    for (const one of fields ?? []) {
+      const at = `${where}.${one.key}`;
+      if (one.kind === 'ref' && !names.has(one.ref)) {
+        fault(E.COLLECTION, `${at}.ref`, `${at} refers to collection ${JSON.stringify(one.ref ?? '')}, which this catalogue does not declare`);
+      }
+      walk(at, one.of);
+    }
+  };
+  catalogue.blocks.forEach((block, at) => walk(`blocks[${at}]`, block.fields));
+  walk('page_seo', catalogue.page_seo);
+  walk('business_facts', catalogue.business_facts);
+}
+
 /*
  * ── can the platform serve this at all ─────────────────────────────────────
  *
@@ -1346,6 +1409,21 @@ const sharedBlocks = existsSync(sharedFile)
 const byType = new Map(catalogue.blocks.map((block) => [block.type, block]));
 const disagreements = [];
 
+/*
+ * Which fields a page must carry a tap target for: the platform's own rule,
+ * `tappable()` in its sitebuild/annotation-lint.mjs, copied (12 October 2026).
+ *
+ * This used to ask it of every field but a bool or a `no_tap_target`, which
+ * is stricter than the judge in exactly the shapes wiki/78 made the way a
+ * site has categories and tags: a service's `category: ref categories`, a
+ * dish's `course` select, a work's `tags: [{ tag }]` were each reported as a
+ * control that edits nothing — they are edited in the panel beside the page,
+ * and the platform's build asks no element of them. A field outside the rule
+ * may still be annotated; it is accepted, never required.
+ */
+const TAPPABLE = new Set(['text', 'textarea', 'richtext_lite', 'markdown', 'media', 'money', 'duration']);
+const tappable = (field) => TAPPABLE.has(field.kind) && field.client_editable !== false && field.no_tap_target !== true;
+
 /** `/de/services/x` without its language: `/services/x`. The site's own language has no prefix. */
 function basePathOf(path, locales) {
   for (const locale of locales) {
@@ -1370,6 +1448,13 @@ for (const page of pages) {
       (c) => c.pages === false && (page.collection === c.name || bare.startsWith(`${c.prefix}/`)),
     );
     if (listedOnly) {
+      /*
+       * A hidden one is on no listing — `visible: false`, or a schedule not
+       * come or gone (schedule.mjs), which the platform writes `visible:
+       * false` before its build — and is owed nowhere, as the platform's
+       * lint says (`listable`). This asked it of a hidden one too.
+       */
+      if (!shownAt(page)) continue;
       /*
        * No page of its own, so its fields are annotated on the listing as
        * `page:<address>:<field>` — and the platform's lint fails a build
@@ -1389,7 +1474,7 @@ for (const page of pages) {
           const value = block[field.key];
           const empty = value === undefined || value === null || value === '' ||
             (Array.isArray(value) && value.length === 0);
-          if (empty || field.no_tap_target || field.kind === 'bool' || (field.kind === 'media' && field.multiple)) continue;
+          if (empty || !tappable(field) || (field.kind === 'media' && field.multiple)) continue;
           if (!everywhere.has(`page:${page.path}:blocks[${at}].${field.key}`)) {
             disagreements.push(
               `${page.path}: blocks[${at}].${field.key} is on no page — an entry without a page of its own is annotated on its listing as page:${page.path}:blocks[${at}].${field.key}`,
@@ -1419,6 +1504,12 @@ for (const page of pages) {
       if (empty || field.no_tap_target || field.kind === 'bool') continue;
 
       const path = `blocks[${at}].${field.key}`;
+      // Outside the platform's rule and not a list (whose rows are asked one
+      // by one below): accepted where it is annotated, asked for nowhere.
+      if (field.kind !== 'list' && !tappable(field)) {
+        onThePage.delete(path);
+        continue;
+      }
 
       /*
        * A gallery: one field, many pictures, and each picture is its own tap
@@ -1455,6 +1546,10 @@ for (const page of pages) {
           for (const sub of field.of ?? []) {
             if (sub.no_tap_target || !row[sub.key]) continue;
             const rowPath = `blocks[${at}].${field.key}[${i}].${sub.key}`;
+            if (!tappable(sub)) {
+              onThePage.delete(rowPath);
+              continue;
+            }
             if (!onThePage.has(rowPath)) {
               disagreements.push(`${rowPath} is declared and the page does not render it`);
             }

package/lib/content.mjs

@@ -10,6 +10,7 @@
  */
 import { readFile, readdir } from 'node:fs/promises';
 import { join } from 'node:path';
+import { shownAt } from './schedule.mjs';
 
 /** @param {string} path */
 async function readJSON(path) {
@@ -59,9 +60,10 @@ export function sharedLocaleOf(name) {
  * anyway with the site's facts left empty — the annotations do not depend on
  * them.
  * @param {string} root the site's root, holding `jtk/`
- * @param {{ dir?: string }} [options] `dir`: where `jtk/` is, relative to the root
+ * @param {{ dir?: string; now?: number }} [options] `dir`: where `jtk/` is, relative to the root; `now`: the clock a `show_at`/`hide_at` is read against
  */
 export async function collectContent(root, options = {}) {
+  const now = options.now ?? Date.now();
   const dir = join(root, options.dir ?? 'jtk');
   const site = (await readJSON(join(dir, 'site.json'))) ?? {};
   const pages = [];
@@ -72,7 +74,10 @@ export async function collectContent(root, options = {}) {
     const collected = { path: page.path, seo: page.seo ?? {}, blocks: page.blocks ?? [] };
     if (typeof page.collection === 'string' && page.collection !== '') {
       collected.collection = page.collection;
-      collected.visible = page.visible !== false;
+      // Hidden by `visible: false`, or by a schedule not come or gone
+      // (schedule.mjs) — read by the clock of this check, as the platform's
+      // build reads it by its own.
+      collected.visible = shownAt(page, now);
     }
     pages.push(collected);
   }

package/lib/kits.mjs

@@ -137,7 +137,11 @@ export function kitEntries(kit, locale) {
     const collection = kit.catalogue.collections.find((one) => one.name === entry.collection);
     const block = { _key: `kit${String(i + 1).padStart(5, '0')}`, type: collection.type, v: 1 };
     for (const [key, value] of Object.entries(entry.fields)) {
-      block[key] = value !== null && typeof value === 'object' ? (value[lang] ?? '') : value;
+      // An object is the words per language; a list — a master's `does`, a
+      // post's `tags: [{ tag }]` — is the value itself. It was read as a map
+      // of languages and laid out as '' (12 October 2026), which broke the
+      // listing that maps a resource's `does`.
+      block[key] = Array.isArray(value) ? value : value !== null && typeof value === 'object' ? (value[lang] ?? '') : value;
     }
     const path = `${collection.prefix}/${entry.slug}`;
     const doc = { path, collection: collection.name, visible: true, seo: { title: '', description: '' }, blocks: [block] };

package/lib/lint.mjs

@@ -301,6 +301,8 @@ export async function lint(options = {}) {
   // Entries of a collection without pages: on their listing, annotated there.
   const pageless = new Set((registry?.collections ?? []).filter((one) => one.pages === false).map((one) => one.name));
   const everywhere = [...htmlByPath.values()].join('\n');
+  // `visible` as collectContent read it: false for `visible: false` and for a
+  // schedule not come or gone (schedule.mjs) — a listing leaves both out.
   const listable = (page) => page.visible !== false;
   for (const one of registry?.collections ?? []) {
     if (one.pages !== false) continue;
@@ -361,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/meta.mjs

@@ -34,6 +34,7 @@
  */
 import { readdir, readFile, writeFile } from 'node:fs/promises';
 import { join, relative, sep } from 'node:path';
+import { shownAt } from './schedule.mjs';
 
 /** The id of one specimen, which is also its address under the collection. */
 export function specimenId(type, view) {
@@ -76,12 +77,16 @@ export function specimenAddresses(collections, blocks, locales = []) {
  *
  * A document, not frontmatter: an entry is a page of blocks in a `.json`
  * file. Only an entry carries `visible` at all; a page has none and is not a
- * draft. `=== false` and not falsy: absent means listed.
+ * draft. `=== false` and not falsy: absent means listed — and so does a
+ * schedule that has come and not gone (`shownAt`, schedule.mjs): a `show_at`
+ * still ahead or a `hide_at` behind is a draft at the moment of the build,
+ * as it is on the platform, which writes it `visible: false` before building.
  *
  * @param {string} [root] where the content is, `jtk/content` under the working directory
+ * @param {number} [now] the clock a schedule is read against, the build's by default
  * @returns {Promise<string[]>}
  */
-export async function hiddenEntries(root = join(process.cwd(), 'jtk', 'content')) {
+export async function hiddenEntries(root = join(process.cwd(), 'jtk', 'content'), now = Date.now()) {
   const out = [];
   const walk = async (at) => {
     let entries;
@@ -104,7 +109,10 @@ export async function hiddenEntries(root = join(process.cwd(), 'jtk', 'content')
       } catch {
         continue; // unreadable JSON is the build's error to report, not this one
       }
-      if (document?.visible === false) {
+      // A schedule is an entry's (it names its collection); a page carries
+      // none, and `visible: false` is read wherever it is written, as before.
+      const isEntry = typeof document?.collection === 'string' && document.collection !== '';
+      if (document?.visible === false || (isEntry && !shownAt(document, now))) {
         const name = relative(root, full).split(sep).join('/').replace(/\.json$/, '');
         out.push(`/${name}/`);
       }