@jtakeit/kit 0.3.0 → 0.5.1

package/lib/booking/words.mjs

@@ -14,6 +14,31 @@ export const LOCALES = Object.freeze(['uk', 'de', 'en', 'ru', 'es', 'it', 'pt',
 
 const BASE = {
   uk: {
+    // the form's look — the steps, the week, the parts of the day, the
+    // kept time, the link kept (10 October 2026)
+    notWith: 'не з {who}',
+    retime: 'Візит тепер іншої тривалості, тому час змінився — оберіть ще раз.',
+    until: 'Приблизно до {time}',
+    withNamed: 'Майстер: {who}',
+    keep: 'Збережіть це посилання — ним можна перенести чи скасувати запис.',
+    copy: 'Копіювати',
+    copied: 'Скопійовано',
+    open: 'Відкрити',
+    stepWhat: 'Що і коли',
+    stepWho: 'Хто прийде',
+    next: 'Далі',
+    change: 'Змінити',
+    needAll: 'Спершу оберіть послугу, день і час.',
+    summary: 'Ваш запис',
+    what: 'Що',
+    when: 'Коли',
+    takes: 'Тривалість',
+    morning: 'Ранок',
+    afternoon: 'День',
+    evening: 'Вечір',
+    prevWeek: 'Попередній тиждень',
+    nextWeek: 'Наступний тиждень',
+    again: 'Записатися ще раз',
     service: 'Послуга', services: 'Послуги', total: 'Разом', pickService: 'Оберіть хоча б одну послугу.', resource: 'Майстер', any: 'Будь-хто', day: 'День', time: 'Час',
     name: "Ім'я", phone: 'Телефон', email: 'Електронна пошта', note: 'Коментар',
     book: 'Записатися', sending: 'Записуємо…', none: 'У цей день вільного часу немає.', noParty: 'Немає вільних місць для такої компанії.',
@@ -27,6 +52,31 @@ const BASE = {
     needContact: 'Вкажіть телефон або пошту, щоб ми могли з вами звʼязатися.', noScript: 'Онлайн-форма працює з увімкненим JavaScript — увімкніть його або зателефонуйте нам.',
   },
   de: {
+    // the form's look — the steps, the week, the parts of the day, the
+    // kept time, the link kept (10 October 2026)
+    notWith: 'nicht bei {who}',
+    retime: 'Der Besuch dauert jetzt anders lang, darum haben sich die Zeiten verschoben — bitte wählen Sie neu.',
+    until: 'Bis etwa {time}',
+    withNamed: 'Bei {who}',
+    keep: 'Bewahren Sie diesen Link auf — damit verschieben oder stornieren Sie den Termin.',
+    copy: 'Kopieren',
+    copied: 'Kopiert',
+    open: 'Öffnen',
+    stepWhat: 'Was und wann',
+    stepWho: 'Wer kommt',
+    next: 'Weiter',
+    change: 'Ändern',
+    needAll: 'Bitte zuerst Leistung, Tag und Zeit wählen.',
+    summary: 'Ihr Termin',
+    what: 'Was',
+    when: 'Wann',
+    takes: 'Dauer',
+    morning: 'Vormittag',
+    afternoon: 'Nachmittag',
+    evening: 'Abend',
+    prevWeek: 'Vorherige Woche',
+    nextWeek: 'Nächste Woche',
+    again: 'Noch einen Termin buchen',
     service: 'Leistung', services: 'Leistungen', total: 'Zusammen', pickService: 'Bitte mindestens eine Leistung wählen.', resource: 'Bei', any: 'Egal wer', day: 'Tag', time: 'Uhrzeit',
     name: 'Name', phone: 'Telefon', email: 'E-Mail', note: 'Bemerkung',
     book: 'Termin buchen', sending: 'Wird gebucht…', none: 'An diesem Tag ist nichts frei.', noParty: 'Für so viele Personen gibt es keinen freien Platz.',
@@ -40,6 +90,31 @@ const BASE = {
     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: {
+    // the form's look — the steps, the week, the parts of the day, the
+    // kept time, the link kept (10 October 2026)
+    notWith: 'not with {who}',
+    retime: 'The visit is a different length now, so the times moved — pick one again.',
+    until: 'Until about {time}',
+    withNamed: 'With {who}',
+    keep: 'Keep this link — it is how you move or cancel the booking.',
+    copy: 'Copy',
+    copied: 'Copied',
+    open: 'Open',
+    stepWhat: 'What and when',
+    stepWho: 'Who is coming',
+    next: 'Continue',
+    change: 'Change',
+    needAll: 'Pick a service, a day and a time first.',
+    summary: 'Your booking',
+    what: 'What',
+    when: 'When',
+    takes: 'Takes',
+    morning: 'Morning',
+    afternoon: 'Afternoon',
+    evening: 'Evening',
+    prevWeek: 'Previous week',
+    nextWeek: 'Next week',
+    again: 'Book another time',
     service: 'Service', services: 'Services', total: 'Total', pickService: 'Pick at least one service.', resource: 'With', any: 'Anyone', day: 'Day', time: 'Time',
     name: 'Name', phone: 'Phone', email: 'Email', note: 'Note',
     book: 'Book', sending: 'Booking…', none: 'Nothing is free on that day.', noParty: 'There is no place for a party this large.',
@@ -53,6 +128,31 @@ const BASE = {
     needContact: 'Leave a phone number or an email so we can reach you.', noScript: 'Booking online needs JavaScript — or ring us.',
   },
   ru: {
+    // the form's look — the steps, the week, the parts of the day, the
+    // kept time, the link kept (10 October 2026)
+    notWith: 'не у {who}',
+    retime: 'Визит теперь другой длительности, поэтому время изменилось — выберите ещё раз.',
+    until: 'Примерно до {time}',
+    withNamed: 'Мастер: {who}',
+    keep: 'Сохраните эту ссылку — по ней можно перенести или отменить запись.',
+    copy: 'Копировать',
+    copied: 'Скопировано',
+    open: 'Открыть',
+    stepWhat: 'Что и когда',
+    stepWho: 'Кто придёт',
+    next: 'Далее',
+    change: 'Изменить',
+    needAll: 'Сначала выберите услугу, день и время.',
+    summary: 'Ваша запись',
+    what: 'Что',
+    when: 'Когда',
+    takes: 'Длительность',
+    morning: 'Утро',
+    afternoon: 'День',
+    evening: 'Вечер',
+    prevWeek: 'Предыдущая неделя',
+    nextWeek: 'Следующая неделя',
+    again: 'Записаться ещё раз',
     service: "Услуга",
     services: "Услуги",
     total: "Итого",
@@ -96,6 +196,31 @@ const BASE = {
     noScript: "Онлайн-форма работает с включенным JavaScript — включите его или позвоните нам.",
   },
   es: {
+    // the form's look — the steps, the week, the parts of the day, the
+    // kept time, the link kept (10 October 2026)
+    notWith: 'no con {who}',
+    retime: 'La visita ahora dura distinto, así que los horarios cambiaron: elija uno de nuevo.',
+    until: 'Hasta las {time} aproximadamente',
+    withNamed: 'Con {who}',
+    keep: 'Guarde este enlace: con él puede mover o cancelar la reserva.',
+    copy: 'Copiar',
+    copied: 'Copiado',
+    open: 'Abrir',
+    stepWhat: 'Qué y cuándo',
+    stepWho: 'Quién viene',
+    next: 'Continuar',
+    change: 'Cambiar',
+    needAll: 'Elija primero un servicio, un día y una hora.',
+    summary: 'Su reserva',
+    what: 'Qué',
+    when: 'Cuándo',
+    takes: 'Duración',
+    morning: 'Mañana',
+    afternoon: 'Tarde',
+    evening: 'Noche',
+    prevWeek: 'Semana anterior',
+    nextWeek: 'Semana siguiente',
+    again: 'Reservar otra hora',
     service: "Servicio",
     services: "Servicios",
     total: "Total",
@@ -139,6 +264,31 @@ const BASE = {
     noScript: "Para reservar en línea hace falta JavaScript — o llámenos.",
   },
   it: {
+    // the form's look — the steps, the week, the parts of the day, the
+    // kept time, the link kept (10 October 2026)
+    notWith: 'non con {who}',
+    retime: 'La visita ora ha una durata diversa, quindi gli orari sono cambiati: ne scelga uno di nuovo.',
+    until: 'Fino alle {time} circa',
+    withNamed: 'Con {who}',
+    keep: 'Conservi questo link: serve per spostare o annullare la prenotazione.',
+    copy: 'Copia',
+    copied: 'Copiato',
+    open: 'Apri',
+    stepWhat: 'Cosa e quando',
+    stepWho: 'Chi viene',
+    next: 'Continua',
+    change: 'Cambia',
+    needAll: 'Scelga prima un servizio, un giorno e un orario.',
+    summary: 'La sua prenotazione',
+    what: 'Cosa',
+    when: 'Quando',
+    takes: 'Durata',
+    morning: 'Mattina',
+    afternoon: 'Pomeriggio',
+    evening: 'Sera',
+    prevWeek: 'Settimana precedente',
+    nextWeek: 'Settimana successiva',
+    again: 'Prenota un altro orario',
     service: "Servizio",
     services: "Servizi",
     total: "Totale",
@@ -182,6 +332,31 @@ const BASE = {
     noScript: "Per prenotare online serve JavaScript: oppure ci chiami.",
   },
   pt: {
+    // the form's look — the steps, the week, the parts of the day, the
+    // kept time, the link kept (10 October 2026)
+    notWith: 'não com {who}',
+    retime: 'A visita tem agora outra duração, por isso os horários mudaram — escolha de novo.',
+    until: 'Até cerca das {time}',
+    withNamed: 'Com {who}',
+    keep: 'Guarde esta ligação — é com ela que move ou cancela a marcação.',
+    copy: 'Copiar',
+    copied: 'Copiado',
+    open: 'Abrir',
+    stepWhat: 'O quê e quando',
+    stepWho: 'Quem vem',
+    next: 'Continuar',
+    change: 'Alterar',
+    needAll: 'Escolha primeiro um serviço, um dia e uma hora.',
+    summary: 'A sua marcação',
+    what: 'O quê',
+    when: 'Quando',
+    takes: 'Duração',
+    morning: 'Manhã',
+    afternoon: 'Tarde',
+    evening: 'Noite',
+    prevWeek: 'Semana anterior',
+    nextWeek: 'Semana seguinte',
+    again: 'Marcar outra hora',
     service: "Serviço",
     services: "Serviços",
     total: "Total",
@@ -225,6 +400,31 @@ const BASE = {
     noScript: "Reservar online precisa de JavaScript — ou ligue-nos.",
   },
   fr: {
+    // the form's look — the steps, the week, the parts of the day, the
+    // kept time, the link kept (10 October 2026)
+    notWith: 'pas avec {who}',
+    retime: 'La visite n’a plus la même durée, les horaires ont donc changé — choisissez-en un à nouveau.',
+    until: 'Jusqu’à {time} environ',
+    withNamed: 'Avec {who}',
+    keep: 'Conservez ce lien : c’est avec lui que vous déplacez ou annulez la réservation.',
+    copy: 'Copier',
+    copied: 'Copié',
+    open: 'Ouvrir',
+    stepWhat: 'Quoi et quand',
+    stepWho: 'Qui vient',
+    next: 'Continuer',
+    change: 'Modifier',
+    needAll: 'Choisissez d’abord une prestation, un jour et une heure.',
+    summary: 'Votre réservation',
+    what: 'Quoi',
+    when: 'Quand',
+    takes: 'Durée',
+    morning: 'Matin',
+    afternoon: 'Après-midi',
+    evening: 'Soir',
+    prevWeek: 'Semaine précédente',
+    nextWeek: 'Semaine suivante',
+    again: 'Réserver un autre créneau',
     service: "Prestation",
     services: "Prestations",
     total: "Total",

package/lib/catalogue.mjs

@@ -1346,13 +1346,28 @@ const sharedBlocks = existsSync(sharedFile)
 const byType = new Map(catalogue.blocks.map((block) => [block.type, block]));
 const disagreements = [];
 
+/** `/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) {
+    if (path === `/${locale}` || path === `/${locale}/`) return '/';
+    if (path.startsWith(`/${locale}/`)) return path.slice(locale.length + 1);
+  }
+  return path;
+}
+
 for (const page of pages) {
   const onThePage = annotationsByPage.get(page.path);
   if (onThePage === undefined) {
     // A collection with `pages: false` builds no page for its entries: they
     // are read by the page that lists them and by the diary.
+    // Said by the entry's own collection, or by its address — with the
+    // language in front of it for an entry in another one: `/de/services/x`
+    // is the `services` collection's as much as `/services/x` is (wiki/75 of
+    // the platform; a German salon's eight services were each reported as a
+    // page the build did not produce, 10 October 2026).
+    const bare = basePathOf(page.path, catalogue.locales ?? []);
     const listedOnly = collections.some(
-      (c) => c.pages === false && page.path.startsWith(`${c.prefix}/`),
+      (c) => c.pages === false && (page.collection === c.name || bare.startsWith(`${c.prefix}/`)),
     );
     if (listedOnly) {
       /*
@@ -1502,8 +1517,9 @@ for (const [where, found] of annotationsByPage) {
        * against the entry's own type.
        */
       const entry = pages.find((one) => one.path === address);
+      // By the entry's collection, or its address without the language.
       const listedOnly = entry !== undefined && collections.some(
-        (c) => c.pages === false && address.startsWith(`${c.prefix}/`),
+        (c) => c.pages === false && (entry.collection === c.name || basePathOf(address, catalogue.locales ?? []).startsWith(`${c.prefix}/`)),
       );
       if (listedOnly) {
         const m = /^blocks\[(\d+)\]\.([A-Za-z0-9_]+)/.exec(inner);

package/lib/money.mjs

@@ -15,16 +15,36 @@
  * @returns {string}
  */
 export function money(minor, currency, locale) {
-  const value = minor / 100;
-  const digits = Number.isInteger(value) ? 0 : 2;
+  // In the currency's own minor unit (11 October 2026): a hundredth of a
+  // franc, a whole yen, a thousandth of a dinar — ISO 4217's digits, which
+  // `Intl` carries and the platform counts by too. A hundredth everywhere
+  // showed ¥1000 as «¥10».
+  const places = currency ? digitsOf(currency, locale) : 2;
+  const value = minor / 10 ** places;
+  const digits = Number.isInteger(value) ? 0 : places;
   if (!currency) {
-    return new Intl.NumberFormat(locale, { minimumFractionDigits: digits, maximumFractionDigits: 2 }).format(value);
+    return new Intl.NumberFormat(locale, { minimumFractionDigits: digits, maximumFractionDigits: places }).format(value);
   }
   return new Intl.NumberFormat(locale, {
     style: 'currency',
     currency: currency.toUpperCase(),
     currencyDisplay: 'narrowSymbol',
     minimumFractionDigits: digits,
-    maximumFractionDigits: 2,
+    maximumFractionDigits: places,
   }).format(value);
 }
+
+/**
+ * How many digits a currency's minor unit has, by ISO 4217 as `Intl` knows it.
+ *
+ * @param {string} currency
+ * @param {string} [locale]
+ * @returns {number}
+ */
+export function digitsOf(currency, locale = 'en') {
+  try {
+    return new Intl.NumberFormat(locale, { style: 'currency', currency: currency.toUpperCase() }).resolvedOptions().maximumFractionDigits ?? 2;
+  } catch {
+    return 2;
+  }
+}

package/lib/phases.mjs

@@ -0,0 +1,139 @@
+/**
+ * The seven phases of a site being written, from two halves (jtakeit-core,
+ * wiki/73 · §4 and §7).
+ *
+ * The kit's half is `readProgress` — the brief, the layout, the writing,
+ * read off the files. The platform's half — the judge's word, the
+ * repository, the build, the preview, and the panel's setting up — comes
+ * through the dev session (`jtkit session`). This turns the two into the
+ * strip the page shows, by the same rules the panel's own card uses
+ * (entities/site/writing.ts there): a phase is a fact; a later phase
+ * counts only once every phase before it does; written means the kit's
+ * still-to-do list is empty, not that the required fields are filled.
+ */
+
+export const PHASES = ['brief', 'laidOut', 'writing', 'judged', 'attached', 'building', 'preview'];
+
+export const PHASE_NAMES = {
+  brief: 'Brief',
+  laidOut: 'Laid out',
+  writing: 'Writing',
+  judged: 'Checked',
+  attached: 'Attached',
+  building: 'Building',
+  preview: 'Preview',
+};
+
+/** The panel's steps, as the page names them; `agent` ones are not the developer's. */
+export const STEP_NAMES = {
+  build: 'The agent builds it',
+  diary: 'Bookings: the rules and what is booked',
+  business: 'Who owns this site',
+  notifications: 'Where enquiries and bookings go',
+  subscription: 'The subscription',
+  access: 'What the studio may do',
+  payee: 'Who gets paid',
+  launch: 'First publish',
+};
+
+/**
+ * Where the site is.
+ *
+ * @param {import('./progress.mjs').Progress | null | undefined} progress the kit's reading, or null where none
+ * @param {object | null | undefined} platform the session's answer (`/v1/dev-sessions/{id}/progress`), or null where not connected
+ */
+export function phasesOf(progress, platform) {
+  const seen = progress !== null && progress !== undefined;
+  const known = platform !== null && platform !== undefined && platform.error === undefined;
+  const attached = known && platform.attached === true;
+  const served = known && platform.served === true;
+  const build = known && platform.build ? platform.build : null;
+
+  const briefDone = seen
+    ? progress.brief !== null && progress.brief.facts > 0 && progress.brief.sections['Decisions'] === true
+    : attached;
+  const laidOutDone = seen ? progress.kit !== null || progress.catalogue === true : attached;
+  const writingDone = seen
+    ? progress.pages.length > 0 &&
+      progress.pages.every((one) => one.written) &&
+      Object.values(progress.collections).every((one) => one.entries >= one.expected) &&
+      progress.missing.length === 0
+    : attached;
+  const judgedDone = known && platform.judged?.ok === true;
+  const buildingDone = served || build?.status === 'ok';
+  const buildingCurrent = build !== null && (build.status === 'running' || build.status === 'queued' || build.status === 'failed');
+
+  const done = {
+    brief: briefDone,
+    laidOut: laidOutDone,
+    writing: writingDone,
+    judged: judgedDone,
+    attached,
+    building: buildingDone,
+    preview: served,
+  };
+  // In order: a later phase counts only once every phase before it does.
+  let before = true;
+  for (const key of PHASES) {
+    done[key] = done[key] && before;
+    before = done[key];
+  }
+
+  const current = buildingCurrent && !served ? 'building' : (PHASES.find((key) => !done[key]) ?? 'preview');
+  const index = PHASES.indexOf(current);
+  const phases = PHASES.map((key, i) => {
+    let state;
+    if (key === current) state = 'current';
+    else if (done[key]) state = 'done';
+    else if (!seen && !attached && i < 3) state = 'unseen';
+    else if (!known && i >= 3) state = 'unseen';
+    else if (i < index) state = 'unseen';
+    else state = 'left';
+    return { key, state };
+  });
+  return { phases, current, index, known, seen };
+}
+
+/** The sentence under the strip, for the current phase. */
+export function sayPhase(where, progress, platform) {
+  const known = platform !== null && platform !== undefined && platform.error === undefined;
+  switch (where.current) {
+    case 'brief':
+      return 'Collecting the brief';
+    case 'laidOut':
+      return 'Laying the site out';
+    case 'writing': {
+      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}`;
+    }
+    case 'judged':
+      if (!known || !platform.judged) return 'To be checked before the push';
+      return platform.judged.ok ? 'Checked, clean' : `Checked — findings to fix: ${platform.judged.findings}`;
+    case 'attached':
+      return 'To be pushed and attached';
+    case 'building': {
+      const build = known ? platform.build : null;
+      if (!build) return 'To be built';
+      if (build.status === 'failed') return `The build failed — ${build.error || 'see its log in the panel'}`;
+      if (build.status === 'queued') return 'A build is queued';
+      return build.stage_of ? `Building — step ${build.stage_num} of ${build.stage_of}` : 'Building';
+    }
+    default:
+      return 'The preview is ready';
+  }
+}
+
+/**
+ * What the developer can do in the panel meanwhile: the setting up's steps
+ * that are not the agent's — open first, then done.
+ */
+export function meanwhile(platform) {
+  const steps = platform?.steps ?? [];
+  const named = (step) => ({ key: step.key, name: STEP_NAMES[step.key] ?? step.key, done: step.done === true });
+  const theirs = steps.filter((step) => step.whose !== 'agent');
+  return {
+    open: theirs.filter((step) => !step.done).map(named),
+    done: theirs.filter((step) => step.done).map(named),
+  };
+}