@jtakeit/kit 0.7.0 → 0.7.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 jtakeit
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -11,8 +11,8 @@ takes the same pieces instead of reproducing them. The scaffold itself
 imports this package; there is one implementation of each piece and two
 homes for it.
 
-What the platform holds a repository to is in
-[connecting a site](https://jtakeit.com/docs/guides/connecting-a-site), under
+What the platform holds a repository to is in its guide *connecting a site*
+(`jtakeit:///guides/connecting-a-site.md`, through the MCP server), under
 *On another generator*. This package is the pieces of that list that are
 worth not writing twice.
 
@@ -21,7 +21,7 @@ worth not writing twice.
 The platform's diary, on the page: the free times fetched, a stay of several
 nights, a class of cars, a party, the words in the business's kind, the
 payment step, Turnstile when the host has it. The contract it keeps is
-[bookings on the site](https://jtakeit.com/docs/guides/bookings-on-the-site);
+the platform's *bookings on the site* (`jtakeit:///guides/bookings-on-the-site.md`);
 `preflight` reads `data-sends` off the built page and books in exactly that
 shape, so the form says what it sends and the element sends nothing else.
 
@@ -96,7 +96,7 @@ platform answers with a page — and the element only spares a working browser
 the navigation. What the build's lint holds it to: a `name` control, one of
 `contact`, `phone` or `email`, the honeypot `website`, and nothing else that
 the collecting block does not declare in `asks`
-([the contract](https://jtakeit.com/docs/reference/contract.md)).
+(the platform's contract, `jtakeit:///reference/contract.md`).
 
 ```js
 import { renderLeadForm } from '@jtakeit/kit/lead';

package/bin/jtkit.mjs

@@ -84,7 +84,7 @@ switch (command) {
   case 'progress': {
     // The same reading the scaffold's dev server serves the panel as
     // /_jtk/progress.json — what the owner sees as missing is what this
-    // prints (jtakeit-core, wiki/73).
+    // prints.
     const { readProgress, sayProgress } = await import(pathToFileURL(join(HERE, '..', 'lib', 'progress.mjs')).href);
     const progress = await readProgress(resolve(flag('root', '.')));
     console.log(has('json') ? JSON.stringify(progress, null, 2) : sayProgress(progress));
@@ -93,7 +93,7 @@ switch (command) {
   case 'lint': {
     // The annotation lint the platform's build runs, on this working tree:
     // `dist/` against `jtk/` and the catalogue, every finding at once,
-    // before any push (core wiki/71 · §3.2).
+    // before any push.
     const { lintCommand } = await import(pathToFileURL(join(HERE, '..', 'lib', 'lint.mjs')).href);
     const root = resolve(flag('root', process.cwd()));
     const dist = resolve(root, flag('dist', 'dist'));
@@ -117,7 +117,8 @@ switch (command) {
   jtkit apply --kit <kind>|<file> [--locale uk] [--api <url>] [--root <dir>]
   jtkit catalogue [--declaration src/content/blocks.ts] [--emit-only] [--dist ./dist] [--judge]
 
-The contract the platform holds a repository to: https://jtakeit.com/docs/guides/connecting-a-site`);
+The contract the platform holds a repository to: jtakeit:///guides/connecting-a-site.md
+(the platform's MCP server, https://mcp.jtakeit.com/mcp, hands it to your agent)`);
     process.exit(command === undefined || command === '--help' || command === '-h' ? 0 : 1);
   }
 }

package/elements/booking.js

@@ -132,8 +132,8 @@ export function lasting(minutes, words) {
  * @param {HTMLFormElement} form
  */
 /**
- * The booking protocol's version this element speaks, named on every request
- * (the platform's wiki/79). A page is a file in a build: when the platform
+ * The booking protocol's version this element speaks, named on every request.
+ * A page is a file in a build: when the platform
  * changes, a site keeps the kit it was built with, and the platform answers it
  * by this number for as long as a live site speaks it — so it moves only with
  * a change the platform cannot make by adding, and the platform says which
@@ -181,7 +181,7 @@ export function wireBooking(form) {
     const chosenBoxes = boxes.filter((b) => b.checked);
     if (chosenBoxes.length < 2) { total.hidden = true; return; }
     const minutes = chosenBoxes.reduce((sum, b) => sum + Number(b.dataset.takes ?? 0), 0);
-    // A price per person is times the party (wiki/70); the slot's price is
+    // A price per person is times the party; the slot's price is
     // the platform's, this is the list's own running sum.
     const people = partyField.hidden ? 1 : Number(party.value) || 1;
     const minor = chosenBoxes.reduce((sum, b) => sum + Number(b.dataset.costs ?? 0) * (b.dataset.per === 'person' ? people : 1), 0);
@@ -371,7 +371,7 @@ export function wireBooking(form) {
   }
 
   /**
-   * How many of the class one request may take (wiki/69): the settings'
+   * How many of the class one request may take: the settings'
    * most, and no more than are free at the chosen time. Hidden at one, and
    * when a resource is named — a name is one thing.
    * @param {number} most
@@ -757,7 +757,7 @@ export function wireBooking(form) {
       }
       hint.textContent = '';
       // A price beside each time only where the times differ in price — a
-      // rate by the hour (wiki/68). Where every time costs the same, the
+      // rate by the hour. Where every time costs the same, the
       // price is the services' and is said beside them: «09:00 · CHF 95» on
       // thirty pills is one number read thirty times (11 October 2026).
       const slotPrices = new Set(data.slots.map((one) => one.costs_minor ?? 0));
@@ -773,7 +773,7 @@ export function wireBooking(form) {
           ? slot.ends ? `${dayAndHour(slot.start, false)} — ${dayAndHour(slot.ends, false)}` : dayAndHour(slot.start, false)
           : clock(slot.start);
         // What the booking starting here costs — the platform's number, every
-        // hour by its own row (wiki/68) — beside the time, where it varies.
+        // hour by its own row — beside the time, where it varies.
         if (pricedByTime && slot.costs_minor > 0) button.textContent += ` · ${money(slot.costs_minor, currency, pageLang())}`;
         button.dataset.start = slot.start;
         button.addEventListener('click', () => {
@@ -934,7 +934,7 @@ export function wireBooking(form) {
     // one by name and marks, where it was chosen — «VW Combi · білий ·
     // AA1234BB». Nothing where the business has one of everything.
     let what = made.class ? words.anyOf.replace('{class}', made.class) : resourceChosen() ? made.resource ?? '' : '';
-    // A group: the resources it took, and how many together (wiki/69).
+    // A group: the resources it took, and how many together.
     if (made.group && made.group.quantity > 1) {
       what = `${made.group.bookings.map((/** @type {{resource_name?: string, resource: string}} */ b) => b.resource_name || b.resource).join(', ')} · ${words.together.replace('{n}', String(made.group.quantity))}`;
     }

package/elements/writing.js

@@ -1,6 +1,6 @@
 /**
  * The page's own card: where the site is, bottom right, on the dev server
- * only (jtakeit-core, wiki/73 · §7).
+ * only.
  *
  * A scaffold just made is an empty page, and a developer looking at
  * localhost while the agent writes sees nothing of what is happening. This
@@ -14,15 +14,27 @@
  *
  * Collapsed, it is a pill with the phase; a press opens it; the choice is
  * remembered in this browser.
+ *
+ * ── the stage, while the page has no words ──────────────────────────────────
+ *
+ * A scaffold just laid out is a page of empty fields and asterisks, and a
+ * developer who opens localhost to watch the agent saw that and nothing else
+ * (13 October 2026). So while the page being looked at has not one word in it
+ * yet, the element covers it with a stage: a page assembling itself, what the
+ * agent is on, what is left, the panel's steps meanwhile, and the promise that
+ * the page will appear here by itself. The moment the page has its first
+ * words, the stage goes and the page is loaded again — nobody presses
+ * anything. A page the files do not know (a listing, an entry) is never
+ * covered, nor is any page when the dev server cannot be read.
  */
-import { PHASES, PHASE_NAMES, phasesOf, sayPhase, meanwhile } from '../lib/phases.mjs';
+import { PHASES, PHASE_NAMES, phasesOf, sayPhase, meanwhile, blankHere } from '../lib/phases.mjs';
 
 const STORE = 'jtk-writing:collapsed';
 
 const CSS = `
 :host{position:fixed;right:16px;bottom:16px;z-index:2147483000;font:13px/1.45 system-ui,-apple-system,"Segoe UI",Roboto,sans-serif;-webkit-font-smoothing:antialiased;
-  --bg:#fbfaf7;--ink:#1d1b17;--ink2:#3f3b33;--muted:#6b665c;--faint:#9b958a;--line:#e6e1d6;--line2:#d8d2c4;--ok:#2f7d5a;--attn:#9a6b1c;--shadow:0 12px 36px rgba(30,25,15,.16),0 2px 6px rgba(30,25,15,.08)}
-@media (prefers-color-scheme:dark){:host{--bg:#1c1b18;--ink:#f1ede5;--ink2:#d9d3c7;--muted:#a8a295;--faint:#716c62;--line:#33302a;--line2:#443f36;--ok:#5bb38a;--attn:#d4a24a;--shadow:0 12px 36px rgba(0,0,0,.5)}}
+  --paper:#f4f1ea;--glow:rgba(212,162,74,.16);--bg:#fbfaf7;--ink:#1d1b17;--ink2:#3f3b33;--muted:#6b665c;--faint:#9b958a;--line:#e6e1d6;--line2:#d8d2c4;--ok:#2f7d5a;--attn:#9a6b1c;--shadow:0 12px 36px rgba(30,25,15,.16),0 2px 6px rgba(30,25,15,.08)}
+@media (prefers-color-scheme:dark){:host{--paper:#141311;--glow:rgba(212,162,74,.12);--bg:#1c1b18;--ink:#f1ede5;--ink2:#d9d3c7;--muted:#a8a295;--faint:#716c62;--line:#33302a;--line2:#443f36;--ok:#5bb38a;--attn:#d4a24a;--shadow:0 12px 36px rgba(0,0,0,.5)}}
 *{box-sizing:border-box;margin:0;padding:0}
 button{font:inherit;color:inherit;background:none;border:0;cursor:pointer}
 a{color:var(--ink);text-decoration:underline;text-decoration-color:var(--line2);text-underline-offset:3px}
@@ -41,7 +53,9 @@ a:hover{text-decoration-color:var(--ink)}
 .seg.done,.mini i.done{background:var(--ok)}.seg.current,.mini i.current{background:var(--attn)}.seg.current{animation:pulse 2.4s ease-in-out infinite}
 .seg.unseen{background:transparent;border:1px solid var(--line2)}
 @keyframes pulse{50%{opacity:.45}}@media (prefers-reduced-motion:reduce){.seg.current,.card.enter{animation:none}}
-.names{display:flex;gap:4px;margin-top:6px}.names span{flex:1;min-width:0;font-size:10px;color:var(--faint);white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.names .current{color:var(--ink);font-weight:600}.names .done{color:var(--muted)}
+/* One line under the strip: the phase it is in, whole, and the one after —
+   seven names in 340 px were seven ellipses (13 October 2026). */
+.names{display:flex;gap:8px;align-items:baseline;margin-top:7px;font-size:12px}.names .current{color:var(--ink);font-weight:600}.names .next{color:var(--faint)}
 .say{display:flex;gap:9px;align-items:flex-start;margin-top:12px;font-weight:600;font-size:13.5px;line-height:1.35}.say i{flex:none;width:8px;height:8px;border-radius:999px;background:var(--attn);margin-top:5px}
 .todo{list-style:none;margin:6px 0 0 17px;color:var(--muted);font-size:12.5px}.todo li+li{margin-top:2px}
 .rule{height:1px;background:var(--line);margin:12px 0 10px}
@@ -54,6 +68,35 @@ a:hover{text-decoration-color:var(--ink)}
 .foot{margin-top:10px;color:var(--faint);font-size:11px}
 `;
 
+const STAGE_CSS = `
+.stage{position:fixed;inset:0;z-index:2147482999;display:grid;place-items:center;overflow:auto;padding:32px 20px;
+  background:radial-gradient(1200px 600px at 50% -10%,var(--glow),transparent 60%),var(--paper);color:var(--ink);
+  font:15px/1.5 system-ui,-apple-system,"Segoe UI",Roboto,sans-serif;animation:fade .4s ease both}
+.stage.leaving{animation:out .35s ease both}
+@keyframes fade{from{opacity:0}to{opacity:1}}@keyframes out{to{opacity:0}}
+.wrap{width:min(560px,100%);display:grid;gap:22px}
+.sheet{position:relative;height:210px;border-radius:18px;background:var(--bg);border:1px solid var(--line);box-shadow:var(--shadow);overflow:hidden;padding:18px}
+.bar{height:10px;width:34%;border-radius:999px}
+.row{display:flex;gap:8px;margin-top:22px}.row b{display:block;height:9px;border-radius:999px}
+.hero{height:46px;width:72%;border-radius:12px;margin-top:18px}
+.cards{display:grid;grid-template-columns:repeat(3,1fr);gap:10px;margin-top:18px}.cards b{display:block;height:46px;border-radius:10px}
+.sk{background:linear-gradient(90deg,var(--line) 0%,var(--line2) 50%,var(--line) 100%);background-size:200% 100%;animation:shine 1.8s linear infinite;opacity:0;transform:translateY(6px)}
+.sk{animation:shine 1.8s linear infinite,rise .6s cubic-bezier(.22,.61,.36,1) forwards}
+.d1{animation-delay:0s,.1s}.d2{animation-delay:.1s,.35s}.d3{animation-delay:.2s,.6s}.d4{animation-delay:.3s,.85s}.d5{animation-delay:.4s,1.1s}.d6{animation-delay:.5s,1.35s}
+@keyframes shine{to{background-position:-200% 0}}@keyframes rise{to{opacity:1;transform:none}}
+.caret{position:absolute;right:18px;bottom:16px;display:flex;gap:5px}.caret i{width:6px;height:6px;border-radius:999px;background:var(--attn);animation:dot 1.2s ease-in-out infinite}
+.caret i:nth-child(2){animation-delay:.15s}.caret i:nth-child(3){animation-delay:.3s}@keyframes dot{50%{opacity:.25;transform:translateY(-3px)}}
+.kicker{font-size:12px;font-weight:700;letter-spacing:.12em;text-transform:uppercase;color:var(--faint)}
+.big{font-size:clamp(24px,4vw,32px);line-height:1.15;font-weight:650;letter-spacing:-.01em;margin-top:6px}
+.now{display:flex;gap:10px;align-items:flex-start;margin-top:10px;color:var(--ink2)}.now i{flex:none;width:9px;height:9px;border-radius:999px;background:var(--attn);margin-top:7px;animation:pulse 2.4s ease-in-out infinite}
+.promise{color:var(--muted);font-size:14px}
+.right{margin:6px 0 0 19px;color:var(--muted);font-size:13px}
+.stage .strip{margin-top:0}
+.cols{display:grid;grid-template-columns:1fr 1fr;gap:18px}@media (max-width:560px){.cols{grid-template-columns:1fr}}
+.stage .todo{margin:6px 0 0;padding-left:16px;list-style:disc}
+@media (prefers-reduced-motion:reduce){.stage,.stage.leaving,.sk,.caret i,.now i{animation:none!important}.sk{opacity:1;transform:none}}
+`;
+
 const esc = (s) => String(s).replace(/[&<>"]/g, (c) => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;' })[c]);
 
 function ago(iso) {
@@ -90,7 +133,7 @@ class JtkWriting extends HTMLElement {
   connectedCallback() {
     const root = this.attachShadow({ mode: 'open' });
     const style = document.createElement('style');
-    style.textContent = CSS;
+    style.textContent = CSS + STAGE_CSS;
     this.box = document.createElement('div');
     root.append(style, this.box);
     root.addEventListener('click', (event) => {
@@ -128,6 +171,19 @@ class JtkWriting extends HTMLElement {
     const where = phasesOf(progress, half);
     const n = where.index + 1;
 
+    // The stage, while this page has not one word in it (see the top).
+    const blank = !this.failed && blankHere(progress);
+    if (this.wasBlank && !blank && progress !== null) {
+      // Its first words: let the page be the page.
+      this.leave();
+      return;
+    }
+    this.wasBlank = blank;
+    if (blank) {
+      this.stage(where, progress, half);
+      return;
+    }
+
     if (this.collapsed) {
       this.show(`<button class="pill" data-toggle aria-expanded="false" aria-label="Where the site is: phase ${n} of 7">
         <span class="mini">${where.phases.map((p) => `<i class="${p.state}"></i>`).join('')}</span>
@@ -148,15 +204,18 @@ class JtkWriting extends HTMLElement {
         ? `<p class="note">The platform could not be read: ${esc(platform.error)}</p>`
         : `<p class="note">Not connected to the platform yet — in the working tree: <code>npx jtkit session &lt;session_id&gt; &lt;watch_key&gt;</code>, both from the session's answer.</p>`;
 
+    const last = this.state?.lastChange ?? null;
     const foot = [
-      this.failed ? 'the dev server did not answer' : progress?.changedAt ? `read from the files, changed ${ago(progress.changedAt)}` : 'read from the files',
+      this.failed ? 'the dev server did not answer'
+        : last ? `last change: ${last.path.split('/').slice(-2).join('/')} · ${ago(last.at)}`
+        : progress?.changedAt ? `read from the files, changed ${ago(progress.changedAt)}` : 'read from the files',
       half?.until ? `platform through the session until ${until(half.until)}` : '',
     ].filter(Boolean).join(' · ');
 
     this.show(`<section class="card${this.enter ? ' enter' : ''}" aria-label="Where the site is">
       <div class="head"><span class="title">What the agent is doing</span><span class="count">phase ${n} of 7</span><button class="hide" data-toggle aria-label="Collapse">–</button></div>
       <ol class="strip" aria-label="The seven phases">${where.phases.map((p, i) => `<li class="seg ${p.state}" title="${i + 1}. ${PHASE_NAMES[p.key]}"></li>`).join('')}</ol>
-      <div class="names" aria-hidden="true">${where.phases.map((p, i) => `<span class="${p.state}">${i + 1}. ${PHASE_NAMES[p.key]}</span>`).join('')}</div>
+      <p class="names"><span class="current">${n}. ${esc(PHASE_NAMES[where.current] ?? '')}</span>${where.index < 6 ? `<span class="next">next: ${esc(PHASE_NAMES[where.phases[where.index + 1].key])}</span>` : ''}</p>
       <p class="say"><i></i><span>${esc(say)}</span></p>
       ${todo.length > 0 && where.current !== 'preview'
         ? `<ul class="todo">${todo.slice(0, 4).map((line) => `<li>${esc(line)}</li>`).join('')}${todo.length > 4 ? `<li>+ ${todo.length - 4} more — <code>jtkit progress</code></li>` : ''}</ul>`
@@ -169,6 +228,48 @@ class JtkWriting extends HTMLElement {
     </section>`);
   }
 
+  /** The stage over a page with no words yet: what is happening, and that it will appear. */
+  stage(where, progress, half) {
+    const say = sayPhase(where, progress, half);
+    const todo = (progress?.missing ?? []).slice(0, 4);
+    const steps = meanwhile(half);
+    const open = half ? steps.open : [];
+    document.documentElement.style.overflow = 'hidden';
+    this.show(`<section class="stage" role="status" aria-live="polite" aria-label="The site is being written">
+      <div class="wrap">
+        <div class="sheet" aria-hidden="true">
+          <div class="bar sk d1"></div>
+          <div class="hero sk d2"></div>
+          <div class="row"><b class="sk d3" style="width:58%"></b><b class="sk d3" style="width:24%"></b></div>
+          <div class="cards"><b class="sk d4"></b><b class="sk d5"></b><b class="sk d6"></b></div>
+          <div class="caret"><i></i><i></i><i></i></div>
+        </div>
+        <div>
+          <p class="kicker">Phase ${where.index + 1} of 7 · ${esc(PHASE_NAMES[where.current] ?? '')}</p>
+          <h1 class="big">The site is being written</h1>
+          <p class="now"><i></i><span>${esc(say)}</span></p>
+          ${this.state?.lastChange ? `<p class="right">right now: <code>${esc(this.state.lastChange.path)}</code> · ${esc(ago(this.state.lastChange.at))}</p>` : ''}
+        </div>
+        <ol class="strip" aria-hidden="true">${where.phases.map((p) => `<li class="seg ${p.state}"></li>`).join('')}</ol>
+        <div class="cols">
+          ${todo.length > 0 ? `<div><p class="label">Still to do</p><ul class="todo">${todo.map((line) => `<li>${esc(line)}</li>`).join('')}</ul></div>` : ''}
+          ${open.length > 0
+            ? `<div><p class="label">Meanwhile, in the panel</p><ul class="steps">${open.map((s) => `<li><i class="o"></i><span>${esc(s.name)}</span></li>`).join('')}</ul>${half?.panel ? `<a class="panel" href="${esc(half.panel)}" target="_blank" rel="noopener">Open the panel ↗</a>` : ''}</div>`
+            : ''}
+        </div>
+        <p class="promise">This page appears here by itself the moment it has its first words — leave the tab open.</p>
+      </div>
+    </section>`);
+  }
+
+  /** The page has its words: the stage fades and the page is read again. */
+  leave() {
+    this.wasBlank = false;
+    const stage = this.box.querySelector('.stage');
+    stage?.classList.add('leaving');
+    setTimeout(() => location.reload(), stage ? 350 : 0);
+  }
+
   /** Put this on the page, unless it is what is there already. */
   show(html) {
     const key = html.replace(' enter', '');
@@ -176,6 +277,7 @@ class JtkWriting extends HTMLElement {
     this.shown = key;
     this.box.innerHTML = html;
     this.enter = false;
+    if (!html.includes('class="stage"')) document.documentElement.style.removeProperty('overflow');
   }
 }
 

package/index.mjs

@@ -4,8 +4,7 @@
  *
  * `@jtakeit/astro` is the scaffold: an Astro project with the platform's
  * contract already on it. Everything in it that is not Astro's lives here,
- * so a site on any other generator can take the same pieces (wiki/66,
- * layer B): the booking form, as markup to put on a page at build time and
+ * so a site on any other generator can take the same pieces: the booking form, as markup to put on a page at build time and
  * as an element that makes it work in the browser.
  *
  *   import { renderBookingForm } from '@jtakeit/kit/booking';   // build time

package/lib/booking/render.mjs

@@ -90,7 +90,7 @@ 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). Plain text, not escaped.
+ * beside the time once one is chosen. Plain text, not escaped.
  * @param {Named} one
  * @param {string} currency
  * @param {string} lang
@@ -153,7 +153,7 @@ export function bookingForm(props) {
   const last = new Date(now.getTime() + daysAhead * 86_400_000).toISOString().slice(0, 10);
 
   // An add-on — a price and no length: shoes, a racket — is listed under
-  // its own heading, after the services, and rides on the visit (wiki/70).
+  // its own heading, after the services, and rides on the visit.
   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 */

package/lib/catalogue.mjs

@@ -39,7 +39,7 @@
  * writes it, with a line number, rather than in the admin days later with none.
  *
  * Two hand-written validators of one contract disagree silently, so this one
- * sits the other's exam (wiki/35 §5): every finding carries the same `JTK_E_*`
+ * sits the other's exam: every finding carries the same `JTK_E_*`
  * code the server would give it, and `--judge` posts the emitted catalogue to
  * the real validator and reports every place the two answers differ. Every
  * client project the studio runs through it is one sitting.
@@ -108,8 +108,8 @@ const catalogue = {
    * The version of the catalogue FORMAT, and the tool that wrote this file.
    *
    * A whole number because the question the service asks is binary: can this
-   * parser read this file. Additive changes are compatible by the rule in
-   * wiki/05, so a minor could never change what the validator does — it would
+   * parser read this file. Additive changes are compatible by the platform's
+   * rule, so a minor could never change what the validator does — it would
    * be documentation living in a load-bearing field. Semver belongs to this
    * toolkit instead, and its major names the contract it speaks.
    *
@@ -591,7 +591,7 @@ 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
+   * (12 October 2026). 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.
@@ -662,7 +662,7 @@ 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:
+ * the way a site has categories and tags: `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.
  */
@@ -782,7 +782,7 @@ for (const file of sourceFiles(join(root, 'src'))) {
 /*
  * ── the exam ────────────────────────────────────────────────────────────────
  *
- * wiki/35 §5 settles which of the two validators is right: the Go one is the
+ * Of the two validators the platform's is right: the Go one is the
  * judge, and this one sits its exam. Everything below is that sitting — post the
  * catalogue we just built to `POST /v1/registry/validate`, and compare the two
  * verdicts.
@@ -801,8 +801,7 @@ for (const file of sourceFiles(join(root, 'src'))) {
 /**
  * The working tree's other jtk/ files, sent beside the catalogue so the
  * second judge — the settings, the entries, a price table's gaps, an add-on
- * nobody can take — answers in the same call, before any push (core
- * wiki/71 · §3.2). Everything under jtk/ but the catalogue itself, as
+ * nobody can take — answers in the same call, before any push. Everything under jtk/ but the catalogue itself, as
  * `{path, text}`; a site with no jtk/ yet sends none.
  * @param {string} root
  * @returns {{ path: string, text: string }[]}
@@ -838,7 +837,7 @@ function judgeRequest(text, files) {
         // (auth/authHandler.go): an agent's `jtk_…` token as a bearer, a
         // person's signed-in session as the `sid` cookie. This said once that
         // there were no bearer tokens in the app, which stopped being true
-        // when agents got theirs (wiki/40); a `jtk_…` token sent as a cookie
+        // when agents got theirs; a `jtk_…` token sent as a cookie
         // is not read at all.
         ...(token.startsWith('jtk_') ? { authorization: `Bearer ${token}` } : { cookie: `sid=${token}` }),
         accept: 'application/json',
@@ -970,7 +969,7 @@ catalogue, the settings, the content — before any push, every finding at once.
   }
 
   console.error(`
-The Go validator in the admin's registry package is the judge (wiki/35 §5); the
+The Go validator in the admin's registry package is the judge; the
 checks in this file are a copy that has to work offline. A divergence is this
 file's bug, not the server's — bring the check here into line, or add the one it
 is missing, and note it in the platform's 12 · debt if the contract is what
@@ -1178,8 +1177,7 @@ function hasBodyPicture(document) {
  * Whether this site has any entries at all, for the one message that mentions
  * them.
  *
- * An entry is a page now — a `.json` document of blocks (the platform's
- * wiki/30) — so what makes one an entry is the `collection` inside it, not the
+ * An entry is a page now — a `.json` document of blocks — so what makes one an entry is the `collection` inside it, not the
  * extension. Which also means this check no longer needs the site's own Astro
  * installed to read a body: it used to parse frontmatter with it, and that is
  * gone with the format.
@@ -1414,7 +1412,7 @@ const disagreements = [];
  * `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
+ * is stricter than the judge in exactly the shapes that are 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,
@@ -1440,9 +1438,7 @@ for (const page of pages) {
     // 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).
+    // is the `services` collection's as much as `/services/x` is.
     const bare = basePathOf(page.path, catalogue.locales ?? []);
     const listedOnly = collections.some(
       (c) => c.pages === false && (page.collection === c.name || bare.startsWith(`${c.prefix}/`)),
@@ -1963,7 +1959,7 @@ them data-jtk-fixed, which silences everything inside the element it is on.
 
 Undeclared is not a third answer. It is what "I cannot edit the header" is made
 of, and it arrives as a message and a deploy weeks later. See
-references/catalogue.md.`);
+docs/catalogue.md in @jtakeit/astro.`);
   process.exit(Math.min(loose.length, 100));
 }
 

package/lib/codes.mjs

@@ -23,7 +23,7 @@
  * That flag posts the emitted catalogue to the real validator and reports every
  * place the two answers differ — a code the server raised and we did not, or one
  * we raised and it did not. Every client the studio runs through it is one
- * sitting of that exam (wiki/35 §5, §7), so a code that has been renamed or a
+ * sitting of that exam, so a code that has been renamed or a
  * check that has drifted is found by the next real project rather than by a
  * reviewer noticing. A copy nobody checks rots in a month; a copy that is
  * examined weekly is a cache.

package/lib/kits.mjs

@@ -34,7 +34,7 @@ export function readKit(file) {
 }
 
 /**
- * A kit asked of the platform by its kind (wiki/64 · §4.1): the kit whole,
+ * A kit asked of the platform by its kind: the kit whole,
  * every part written out, and its version — which the site's settings record
  * as `kit_version`, so the platform's judge can say when a fix to the kit has
  * not reached the site (JTK_W_KIT_BEHIND).

package/lib/lint.mjs

@@ -9,8 +9,7 @@
  * so it works with any template, including one an agent wrote this afternoon.
  *
  * The platform's build runs this lint on every demo build. It is here so that
- * a site can run it on its own `dist/` before any push (`jtkit lint`, core
- * wiki/71 · §3.2): the same checks, the same codes, the same sentences, and
+ * a site can run it on its own `dist/` before any push (`jtkit lint`): the same checks, the same codes, the same sentences, and
  * every finding at once rather than one build round each.
  *
  * `lint()` returns findings rather than printing and exiting, so a script, a
@@ -366,7 +365,7 @@ export async function lint(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
+ * rule the platform's upload and edge keep. A directory is said
  * once, with a slash.
  * @param {string} dir
  * @returns {Promise<string[]>}

package/lib/phases.mjs

@@ -1,6 +1,5 @@
 /**
- * The seven phases of a site being written, from two halves (jtakeit-core,
- * wiki/73 · §4 and §7).
+ * The seven phases of a site being written, from two halves.
  *
  * 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
@@ -103,9 +102,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 +142,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/lib/progress.mjs

@@ -1,5 +1,5 @@
 /**
- * Progress is a function of the files (jtakeit-core, wiki/73).
+ * Progress is a function of the files.
  *
  * Between «connect an agent» and the first preview a person sees nothing for
  * an hour while the site is written. What they should see is not what the

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jtakeit/kit",
-  "version": "0.7.0",
+  "version": "0.7.2",
   "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",
@@ -92,7 +92,8 @@
     "types",
     "booking.css",
     "lead.css",
-    "README.md"
+    "README.md",
+    "LICENSE"
   ],
   "engines": {
     "node": ">=22.12.0"
@@ -110,5 +111,9 @@
   ],
   "scripts": {
     "test": "node --test"
-  }
+  },
+  "bugs": {
+    "url": "https://github.com/jtakeit/jtakeit-kit/issues"
+  },
+  "homepage": "https://github.com/jtakeit/jtakeit-kit/tree/main/kit#readme"
 }

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;