@jtakeit/kit 0.7.1 → 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

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

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.1",
+  "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"
 }