@caltho/site-kit 0.2.11 → 0.3.0

package/dist/built/theme.js

@@ -0,0 +1,86 @@
+// How a built section's Tailwind classes reach a page, on any site, whatever its own CSS
+// (cal-os docs/design/site-builder.md, "Tailwind"). Pure: the build (./css.ts) and the preview
+// (../next/preview.tsx, with Tailwind's browser build) compile the same input, so what's typed in
+// CalOS's preview is what's published.
+//
+// - Prefixed: a tree's `p-4` is drawn as `kit:p-4`, so only elements the kit drew from a tree ever
+//   carry one of these classes. A site's own markup with a class called `flex` or `hidden` (its own
+//   CSS's) is never restyled by them, and the kit's never by its.
+// - No preflight (Tailwind's reset): the rest of the site looks as it did.
+// - Not in a cascade layer: a site's own plain CSS (unlayered) would otherwise beat every utility,
+//   whatever its specificity.
+// - The site's Look as the theme: `bg-brand`, `text-ink`, `font-display`, `rounded-card`, read from
+//   the Look's CSS variables (--look-*, content/look.ts), so a change of Look in CalOS reaches built
+//   sections with nothing compiled again.
+import { KIT_TYPE, TYPE_ROLES } from "../content/look.js";
+/** What every built section's class carries on the page (the tree keeps it without). */
+export const PREFIX = "kit";
+/** A class of a tree as it's drawn: `md:p-4` → `kit:md:p-4`. */
+export const prefixed = (token) => `${PREFIX}:${token}`;
+/** The Look's colours by role, as Tailwind colours (`bg-brand`, `text-on-brand`, `border-line`), with what they fall back to on a site without a Look. */
+export const THEME_COLOURS = {
+    brand: "var(--look-brand, #111)",
+    "on-brand": "var(--look-on-brand, #fff)",
+    accent: "var(--look-accent, currentColor)",
+    "on-accent": "var(--look-on-accent, #111)",
+    page: "var(--look-page, #fff)",
+    ink: "var(--look-ink, #111)",
+    muted: "var(--look-muted, #666)",
+    line: "var(--look-line, #ddd)",
+    soft: "var(--look-soft, #f3f3f3)",
+    light: "var(--look-light, #fff)",
+    dark: "var(--look-dark, #111)",
+};
+/** The Look's fonts: `font-display` and `font-heading` its headings', `font-body` and `font-text` its text's. */
+export const THEME_FONTS = {
+    display: "var(--look-heading-font, inherit)",
+    heading: "var(--look-heading-font, inherit)",
+    body: "var(--look-body-font, inherit)",
+    text: "var(--look-body-font, inherit)",
+};
+/** The Look's type scale as text sizes (`text-h1`, `text-body`), each with its line height, tracking and weight. */
+export const THEME_TYPE = TYPE_ROLES;
+/** Its corners, width and spacing: `rounded-card`, `rounded-button`, `max-w-content`, `px-gutter`, `py-section`. */
+export const THEME_OTHER = {
+    "--radius-card": "var(--look-radius, 8px)",
+    "--radius-button": "var(--look-button-radius, 6px)",
+    "--container-content": "var(--look-width, 1200px)",
+    "--spacing-gutter": "var(--look-gutter, 20px)",
+    "--spacing-section": "var(--look-section-pad, clamp(56px, 8vw, 96px))",
+};
+/** Names a site's own colour can't take as a Tailwind colour: they're Tailwind's own words, or the roles. */
+const RESERVED = new Set(["inherit", "current", "transparent", ...Object.keys(THEME_COLOURS)]);
+/**
+ * The site's own colours' slugs, from the Look's values (lookVars: `--look-swatch-dark-sand`), each
+ * one a Tailwind colour by its slug (`bg-dark-sand`).
+ */
+export function swatchSlugs(look) {
+    return Object.keys(look ?? {})
+        .map((k) => /^--look-swatch-([a-z][a-z0-9-]*)$/.exec(k)?.[1])
+        .filter((s) => !!s && !RESERVED.has(s));
+}
+/** The Tailwind input for built sections: the theme and utilities only, prefixed, and the site's Look as tokens. */
+export function tailwindInput(swatches = []) {
+    const colours = [...Object.entries(THEME_COLOURS).map(([k, v]) => `  --color-${k}: ${v};`), ...swatches.map((s) => `  --color-${s}: var(--look-swatch-${s});`)];
+    const fonts = Object.entries(THEME_FONTS).map(([k, v]) => `  --font-${k}: ${v};`);
+    const type = THEME_TYPE.flatMap((r) => [
+        `  --text-${r}: var(--look-type-${r}-size, ${KIT_TYPE[r].size}px);`,
+        `  --text-${r}--line-height: var(--look-type-${r}-leading, ${KIT_TYPE[r].leading});`,
+        `  --text-${r}--letter-spacing: var(--look-type-${r}-tracking, ${KIT_TYPE[r].tracking}em);`,
+        `  --text-${r}--font-weight: var(--look-type-${r}-weight, ${KIT_TYPE[r].weight});`,
+    ]);
+    const other = Object.entries(THEME_OTHER).map(([k, v]) => `  ${k}: ${v};`);
+    return [
+        `@import "tailwindcss/theme.css" prefix(${PREFIX});`,
+        `@import "tailwindcss/utilities.css";`,
+        // A link to the page it's on (the kit marks it: next/built.tsx): aria-current:underline. Tailwind has no such variant of its own.
+        `@custom-variant aria-current (&[aria-current="page"]);`,
+        // inline: a utility reads the Look's variable itself, so nothing new is set on :root.
+        `@theme inline {`,
+        ...colours,
+        ...fonts,
+        ...type,
+        ...other,
+        `}`,
+    ].join("\n");
+}

package/dist/built/tree.d.ts

@@ -0,0 +1,24 @@
+import { type BehaviorName, type Node } from "../tree/index.ts";
+/** A node's classes as drawn: only the allowed ones (a bad one dropped, never drawn), and its behavior's, each prefixed. */
+export declare function nodeClasses(n: Node): string[];
+/** A block's or component's tree, wherever the content keeps one: built sections, saved sections, the site's components. */
+export declare function treesIn(site: {
+    pages?: {
+        blocks?: unknown[];
+    }[];
+    saved?: unknown;
+    components?: unknown;
+}): Generator<Node>;
+/** Every class the site's built sections are drawn with (prefixed): all the build compiles. Hidden nodes too, so showing one again needs no build. */
+export declare function classesIn(site: Parameters<typeof treesIn>[0]): Set<string>;
+/** The behaviors the site's built sections use, whose scripts the build makes. */
+export declare function behaviorsIn(site: Parameters<typeof treesIn>[0]): Set<BehaviorName>;
+/** Whether a page has any built section on it (a `built` or `use` block). */
+export declare const hasBuilt: (blocks: readonly {
+    type?: unknown;
+}[]) => boolean;
+/**
+ * The value at a dotted path: "company.email" in the site's content, "item.name" in the item a
+ * `repeat` is drawing. Only the content's own fields are read, never anything an object inherits.
+ */
+export declare function readPath(path: string, site: unknown, item?: unknown, self?: unknown): unknown;

package/dist/built/tree.js

@@ -0,0 +1,96 @@
+// What drawing a built section needs to know of its tree beyond each node: the classes it's drawn
+// with (its own, checked, and those its behavior adds), what a `bind` or `repeat` reads from the
+// site's content, and every class and behavior a site's built sections use (for the build to
+// compile only those classes and send only those scripts). Pure, for the server, the preview and the
+// build alike.
+import { safeClasses } from "../tree/index.js";
+import { prefixed } from "./theme.js";
+/** A node's classes as drawn: only the allowed ones (a bad one dropped, never drawn), and its behavior's, each prefixed. */
+export function nodeClasses(n) {
+    const own = safeClasses(n.class).split(" ").filter(Boolean);
+    // Sticky is CSS alone: no script for it.
+    const extra = n.behavior?.name === "sticky" ? ["sticky", `top-[${n.behavior.top ?? 0}px]`] : [];
+    return [...own, ...extra].map(prefixed);
+}
+/** A block's or component's tree, wherever the content keeps one: built sections, saved sections, the site's components. */
+export function* treesIn(site) {
+    const fromBlock = (b) => {
+        const o = b;
+        return o && o.type === "built" && o.root && typeof o.root === "object" ? o.root : null;
+    };
+    for (const p of site.pages ?? [])
+        for (const b of p.blocks ?? []) {
+            const r = fromBlock(b);
+            if (r)
+                yield r;
+        }
+    if (Array.isArray(site.saved))
+        for (const s of site.saved) {
+            const r = fromBlock(s?.block);
+            if (r)
+                yield r;
+        }
+    if (Array.isArray(site.components))
+        for (const c of site.components)
+            if (c?.root && typeof c.root === "object")
+                yield c.root;
+    // A header or footer built as a tree (the site's own, in place of the kit's).
+    for (const k of ["ownHeader", "ownFooter"]) {
+        const o = site[k];
+        if (o?.root && typeof o.root === "object")
+            yield o.root;
+    }
+    // A list's page design: drawn for each of its items.
+    const lists = site.lists;
+    if (lists && typeof lists === "object")
+        for (const l of Object.values(lists))
+            for (const b of l?.page?.blocks ?? []) {
+                const r = fromBlock(b);
+                if (r)
+                    yield r;
+            }
+}
+function* nodes(root) {
+    yield root;
+    for (const c of root.children ?? [])
+        yield* nodes(c);
+}
+/** Every class the site's built sections are drawn with (prefixed): all the build compiles. Hidden nodes too, so showing one again needs no build. */
+export function classesIn(site) {
+    const out = new Set();
+    for (const root of treesIn(site))
+        for (const n of nodes(root))
+            for (const c of nodeClasses(n))
+                out.add(c);
+    return out;
+}
+/** The behaviors the site's built sections use, whose scripts the build makes. */
+export function behaviorsIn(site) {
+    const out = new Set();
+    for (const root of treesIn(site))
+        for (const n of nodes(root))
+            if (n.behavior && !n.hidden)
+                out.add(n.behavior.name);
+    return out;
+}
+/** Whether a page has any built section on it (a `built` or `use` block). */
+export const hasBuilt = (blocks) => blocks.some((b) => b?.type === "built" || b?.type === "use");
+/**
+ * The value at a dotted path: "company.email" in the site's content, "item.name" in the item a
+ * `repeat` is drawing. Only the content's own fields are read, never anything an object inherits.
+ */
+export function readPath(path, site, item, self) {
+    const parts = path.split(".");
+    let at = site;
+    // item.: the item a repeat is drawing; this.: the item an item page is drawn for (a list's page).
+    if (parts[0] === "item" || parts[0] === "this") {
+        at = parts[0] === "item" ? item : self;
+        parts.shift();
+    }
+    for (const k of parts) {
+        if (at === null || typeof at !== "object" || !Object.prototype.hasOwnProperty.call(at, k))
+            return undefined;
+        at = at[k];
+    }
+    return at;
+}

package/dist/built.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/built.test.js

@@ -0,0 +1,257 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { describe, expect, it } from "bun:test";
+import { existsSync } from "node:fs";
+import { mkdir, mkdtemp, readFile, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { pathToFileURL } from "node:url";
+import { renderToStaticMarkup } from "react-dom/server";
+import { behaviorScript, BEHAVIOR_RUNS } from "./behaviors/index.js";
+import { builtCss } from "./built/css.js";
+import { swatchSlugs, tailwindInput } from "./built/theme.js";
+import { behaviorsIn, classesIn, nodeClasses, readPath } from "./built/tree.js";
+import { defineSite } from "./content/index.js";
+import { finish } from "./finish.js";
+import { setPrepared } from "./next/data.js";
+import { KitSection } from "./next/sections.js";
+import { prepare } from "./prepare.js";
+import { isShown, withoutVariant } from "./preview-match.js";
+import { isKitSection, sections } from "./sections/index.js";
+// Built sections: a tree of elements styled with Tailwind, drawn by the kit on any site, with the CSS
+// for exactly its classes and the scripts of exactly its behaviors.
+const content = {
+    url: "https://acme.example",
+    business: { name: "Acme" },
+    company: { email: "hello@acme.example", phone: "555 0100" },
+    caseStudies: [
+        { name: "Maple & Oak", summary: "Tax season, **calm**.", photo: { src: "a.jpg", alt: "The office" } },
+        { name: "Harbor Dental", summary: "Booked out.", photo: { src: "b.jpg", alt: "The chair" } },
+    ],
+};
+const images = {
+    "a.jpg": { width: 1600, height: 1000, src: "/_img/a.1600.webp", srcset: [{ url: "/_img/a.640.webp", w: 640 }, { url: "/_img/a.1600.webp", w: 1600 }] },
+    "b.jpg": { width: 800, height: 600, src: "/_img/b.800.webp", srcset: [] },
+};
+/** Draws a block as the published site does (draft: as CalOS's preview does). */
+function draw(block, o = {}) {
+    setPrepared({ site: { ...content, lang: "en", redirects: [], pages: [], ...o.site }, images, csp: {}, ...(o.built ? { built: o.built } : {}) }, o.draft ?? false);
+    return renderToStaticMarkup(_jsx(KitSection, { s: block }));
+}
+const tree = (root) => ({ type: "built", id: "hero", root });
+describe("a built section's tree, drawn", () => {
+    it("draws each node as its tag with its classes prefixed, a class that isn't allowed dropped", () => {
+        const html = draw(tree({ id: "root000001", tag: "section", class: "grid md:grid-cols-2 gap-6 bg-[url(https://evil.example/x.png)]", children: [{ id: "head000001", tag: "h1", class: "font-display text-h1 text-ink", text: "One place to run the **business**." }] }));
+        expect(html).toContain('<section class="kit:grid kit:md:grid-cols-2 kit:gap-6" id="hero" data-kit-built="">');
+        expect(html).toContain('<h1 class="kit:font-display kit:text-h1 kit:text-ink">One place to run the <strong>business</strong>.</h1>');
+        expect(html).not.toContain("evil");
+    });
+    it("leaves out a tag that isn't allowed, hidden nodes, and HTML in words; marks nodes only in the preview", () => {
+        const root = { id: "root000002", tag: "div", children: [{ id: "bad0000001", tag: "script", text: "alert(1)" }, { id: "hid0000001", tag: "p", text: "Draft", hidden: true }, { id: "txt0000001", tag: "p", text: "<img src=x onerror=alert(1)> hi" }] };
+        const html = draw(tree(root));
+        expect(html).not.toContain("<script");
+        expect(html).not.toContain("Draft");
+        expect(html).not.toContain("<img");
+        expect(html).toContain("&lt;img src=x onerror=alert(1)&gt; hi");
+        expect(html).not.toContain("data-node");
+        expect(draw(tree(root), { draft: true })).toContain('data-node="txt0000001"');
+    });
+    it("checks links again, opens outside ones in a new tab safely, and labels what has no words", () => {
+        const html = draw(tree({
+            id: "root000003",
+            tag: "nav",
+            children: [
+                { id: "lnk0000001", tag: "a", text: "Work", href: "/work/" },
+                { id: "lnk0000002", tag: "a", text: "Them", href: "https://them.example", external: true },
+                { id: "lnk0000003", tag: "a", text: "Bad", href: "javascript:alert(1)" },
+                { id: "btn0000001", tag: "button", label: "Next", children: [{ id: "ico0000001", tag: "icon", icon: "arrow-right" }] },
+                { id: "btn0000002", tag: "button", text: "Call", href: "tel:+15550100" },
+            ],
+        }));
+        expect(html).toContain('<a href="/work/">Work</a>');
+        expect(html).toContain('<a href="https://them.example" target="_blank" rel="noopener noreferrer">Them</a>');
+        expect(html).toContain("<a>Bad</a>");
+        expect(html).not.toContain("javascript:");
+        expect(html).toContain('<button aria-label="Next" type="button"><svg class="kit-built-icon" viewBox="0 0 24 24"');
+        expect(html).toContain('<a href="tel:+15550100">Call</a>');
+    });
+    it("draws a picture through the kit's images and a video as the kit's own player", () => {
+        const html = draw(tree({ id: "root000004", tag: "figure", children: [{ id: "pic0000001", tag: "img", class: "rounded-card", image: { src: "a.jpg", alt: "The office" } }, { id: "vid0000001", tag: "video", label: "Our story", video: { provider: "youtube", id: "dQw4w9WgXcQ" } }, { id: "vid0000002", tag: "video", video: { provider: "vimeo", id: "123456789" } }] }));
+        expect(html).toContain('srcSet="/_img/a.640.webp 640w, /_img/a.1600.webp 1600w"');
+        expect(html).toContain('alt="The office"');
+        expect(html).toContain('class="kit:rounded-card"');
+        expect(html).toContain('src="https://www.youtube-nocookie.com/embed/dQw4w9WgXcQ" title="Our story"');
+        expect(html).toContain('src="https://player.vimeo.com/video/123456789?dnt=1"');
+    });
+    it("shows shared values (bind) and one copy for each item of a list (repeat)", () => {
+        const html = draw(tree({
+            id: "root000005",
+            tag: "section",
+            children: [
+                { id: "mail000001", tag: "a", bind: { path: "company.email" }, href: "mailto:hello@acme.example" },
+                { id: "card000001", tag: "article", repeat: { path: "caseStudies" }, children: [{ id: "name000001", tag: "h3", bind: { path: "item.name" } }, { id: "sum0000001", tag: "p", bind: { path: "item.summary" } }, { id: "pic0000002", tag: "img", bind: { path: "item.photo" } }] },
+                { id: "card000002", tag: "p", repeat: { path: "caseStudies", limit: 1 }, bind: { path: "item.name" } },
+                { id: "none000001", tag: "p", bind: { path: "company.__proto__" }, text: "Kept" },
+            ],
+        }));
+        expect(html).toContain('<a href="mailto:hello@acme.example">hello@acme.example</a>');
+        expect(html).toContain("<h3>Maple &amp; Oak</h3>");
+        expect(html).toContain("<h3>Harbor Dental</h3>");
+        expect(html).toContain("Tax season, <strong>calm</strong>.");
+        expect(html).toContain('alt="The chair"');
+        expect(html.match(/<p>Maple &amp; Oak<\/p>/g)).toHaveLength(1);
+        expect(html).not.toContain("<p>Harbor Dental</p>");
+        expect(html).toContain("<p>Kept</p>");
+        expect(readPath("item.name", content, { name: "x" })).toBe("x");
+        expect(readPath("company.toString", content)).toBeUndefined();
+    });
+    it("draws a component used by name with its slots filled, and nothing for one the site hasn't", () => {
+        const components = [{ key: "case-card", name: "Case card", root: { id: "comp000001", tag: "article", class: "p-6 rounded-card", children: [{ id: "tit0000001", tag: "h3", slot: "title", text: "Title" }, { id: "go00000001", tag: "a", slot: "link", text: "View project", href: "/" }] } }];
+        const html = draw({ type: "use", id: "case", component: "case-card", slots: { title: { text: "Maple & Oak" }, link: { href: "/work/maple/" } } }, { site: { components } });
+        expect(html).toContain('<article class="kit:p-6 kit:rounded-card" id="case" data-kit-built=""><h3>Maple &amp; Oak</h3><a href="/work/maple/">View project</a></article>');
+        expect(draw({ type: "use", component: "nope", slots: {} }, { site: { components } })).toBe("");
+        expect(draw({ type: "use", component: "nope", slots: {} }, { site: { components }, draft: true })).toContain("kit-built-missing");
+    });
+    it("links the built sections' CSS and the scripts of the behaviors it uses, on the published page only", () => {
+        const built = { css: "/_kit/built.abc.css", scripts: { carousel: "/_kit/carousel.def.js", tabs: "/_kit/tabs.ghi.js" } };
+        const block = tree({ id: "root000006", tag: "div", behavior: { name: "carousel", transition: "fade", pauseOnHover: true, dots: true, arrows: false }, children: [{ id: "s000000001", tag: "p", text: "One" }, { id: "s000000002", tag: "p", text: "Two" }] });
+        const html = draw(block, { built });
+        expect(html).toContain('href="/_kit/built.abc.css"');
+        expect(html).toContain('src="/_kit/carousel.def.js"');
+        expect(html).not.toContain("tabs.ghi.js");
+        const preview = draw(block, { built, draft: true });
+        expect(preview).not.toContain("/_kit/");
+    });
+});
+describe("behaviors, drawn", () => {
+    it("a carousel: the first slide shown, the rest hidden until its script starts, dots as labelled buttons, and a stop button where it moves by itself", () => {
+        const html = draw(tree({ id: "root000007", tag: "div", class: "relative", label: "Case studies", behavior: { name: "carousel", seconds: 6, transition: "fade", pauseOnHover: true, dots: true, arrows: true }, children: [{ id: "s000000003", tag: "article", text: "One" }, { id: "s000000004", tag: "article", text: "Two" }] }));
+        expect(html).toContain('data-kit-behavior="carousel" data-kit-settings="{&quot;seconds&quot;:6,&quot;transition&quot;:&quot;fade&quot;,&quot;pauseOnHover&quot;:true,&quot;dots&quot;:true,&quot;arrows&quot;:true}" role="region" aria-roledescription="carousel"');
+        expect(html).toContain('<div class="kit-carousel-track" data-kit-track="" data-kit-transition="fade"><article data-kit-slide="" data-active="" role="group" aria-roledescription="slide" aria-label="1 of 2">One</article><article data-kit-slide="" role="group" aria-roledescription="slide" aria-label="2 of 2">Two</article></div>');
+        expect(html).toContain('data-kit-to="0" aria-label="Show slide 1 of 2" aria-current="true"');
+        expect(html).toContain('data-kit-pause="" aria-pressed="false" aria-label="Pause the slides"');
+        expect(html).toContain('data-kit-prev="" aria-label="Previous slide"');
+    });
+    it("a carousel's own designed controls are used in place of the kit's", () => {
+        const html = draw(tree({ id: "root000008", tag: "div", behavior: { name: "carousel", transition: "slide", pauseOnHover: true, dots: true, arrows: false }, children: [{ id: "s000000005", tag: "p", text: "One" }, { id: "s000000006", tag: "p", text: "Two" }, { id: "nxt0000001", tag: "button", slot: "next", children: [{ id: "ico0000002", tag: "icon", icon: "arrow-right" }] }, { id: "dts0000001", tag: "div", slot: "dots", class: "flex gap-2" }] }));
+        expect(html).toContain('<button data-kit-next="" aria-label="Next slide" type="button">');
+        expect(html).toContain('<div class="kit:flex kit:gap-2"><button type="button" class="kit-carousel-dot" data-kit-to="0"');
+        expect(html).not.toContain("kit-carousel-controls");
+    });
+    it("tabs, accordion, marquee, reveal and sticky mark what their scripts and CSS work on", () => {
+        const tabs = draw(tree({ id: "root000009", tag: "div", behavior: { name: "tabs", first: 0 }, children: [{ id: "lst0000001", tag: "div", children: [{ id: "tab0000001", tag: "button", text: "Returns" }, { id: "tab0000002", tag: "button", text: "Payroll" }] }, { id: "pan0000001", tag: "div", text: "We file them." }, { id: "pan0000002", tag: "div", text: "We run it." }] }));
+        expect(tabs).toContain('<div data-kit-tablist=""><button type="button">Returns</button>');
+        expect(tabs).toContain('<div data-kit-panel="">We file them.</div>');
+        const acc = draw(tree({ id: "root000010", tag: "div", behavior: { name: "accordion", single: true }, children: [{ id: "itm0000001", tag: "div", children: [{ id: "q000000001", tag: "h3", text: "How long?" }, { id: "a000000001", tag: "p", text: "Three weeks." }] }] }));
+        expect(acc).toContain('<div data-kit-item=""><h3 data-kit-head="">How long?</h3><p data-kit-body="">Three weeks.</p></div>');
+        const mq = draw(tree({ id: "root000011", tag: "ul", class: "flex gap-8", behavior: { name: "marquee", seconds: 20, reverse: false }, children: [{ id: "li00000001", tag: "li", text: "Acme" }] }));
+        expect(mq).toContain('<div class="kit-marquee-track" data-kit-track=""><div class="kit-marquee-group"><li>Acme</li></div><div class="kit-marquee-group" data-kit-copy="" aria-hidden="true" inert=""><li>Acme</li></div></div>');
+        const rv = draw(tree({ id: "root000012", tag: "div", behavior: { name: "reveal", effect: "left", stagger: 80 } }));
+        expect(rv).toContain('data-kit-behavior="reveal" data-kit-settings="{&quot;effect&quot;:&quot;left&quot;,&quot;stagger&quot;:80}" data-kit-effect="left"');
+        expect(nodeClasses({ id: "stk0000001", tag: "aside", class: "p-4", behavior: { name: "sticky", top: 24 } })).toEqual(["kit:p-4", "kit:sticky", "kit:top-[24px]"]);
+    });
+    it("each behavior with a script is one that can be sent alone, its code and its starter", () => {
+        for (const name of Object.keys(BEHAVIOR_RUNS)) {
+            const js = behaviorScript(name);
+            expect(() => new Function(js)).not.toThrow();
+            expect(js).toContain(`"${name}"`);
+        }
+        expect(behaviorScript("sticky")).toBeNull();
+    });
+});
+describe("the kit's sections, with built ones", () => {
+    const site = defineSite({ ...sections });
+    const page = (blocks, extra = {}) => ({ url: "https://acme.example", business: { name: "Acme" }, ...extra, pages: [{ path: "/", title: "Acme", description: "Acme does things.", blocks }] });
+    it("takes built and use blocks, components, and refuses a tree with an id twice or a component it hasn't", () => {
+        expect(isKitSection("built") && isKitSection("use")).toBe(true);
+        const root = { id: "root000013", tag: "section", children: [{ id: "head000002", tag: "h2", text: "Hi" }] };
+        expect(site.parse(page([{ type: "built", root }])).problems).toBeUndefined();
+        const twice = { ...root, children: [root.children[0], root.children[0]] };
+        expect(site.parse(page([{ type: "built", root: twice }])).problems?.join(" ")).toMatch(/head000002 is used twice/);
+        expect(site.parse(page([{ type: "use", component: "case-card" }])).problems?.join(" ")).toMatch(/no component called case-card/);
+        const withComponent = page([{ type: "use", component: "case-card", slots: { title: { text: "Hi" } } }], { components: [{ key: "case-card", name: "Case card", root }] });
+        expect(site.parse(withComponent).problems).toBeUndefined();
+        expect(site.parse(page([{ type: "built", root: { ...root, class: "bg-[url(x)]" } }])).problems?.join(" ")).toMatch(/Not allowed: bg-\[url\(x\)\]/);
+    });
+    it("says its schema, trees and all, for CalOS", () => {
+        const json = JSON.stringify(site.jsonSchema());
+        expect(json).toContain("Built section");
+        expect(json).toContain('"components"');
+    });
+    it("collects every class and behavior a site's trees use: built sections, saved ones and components", () => {
+        const s = {
+            pages: [{ blocks: [{ type: "built", root: { id: "a000000001", tag: "div", class: "p-4 bg-[url(x)]", behavior: { name: "reveal" }, children: [{ id: "b000000001", tag: "p", class: "md:text-h2", hidden: true }] } }, { type: "hero" }] }],
+            saved: [{ name: "x", block: { type: "built", root: { id: "c000000001", tag: "div", class: "flex" } } }],
+            components: [{ key: "k", name: "K", root: { id: "d000000001", tag: "div", class: "grid", behavior: { name: "carousel" } } }],
+        };
+        expect([...classesIn(s)].sort()).toEqual(["kit:flex", "kit:grid", "kit:md:text-h2", "kit:p-4"]);
+        expect([...behaviorsIn(s)].sort()).toEqual(["carousel", "reveal"]);
+    });
+});
+describe("built sections' CSS", () => {
+    it("is Tailwind's, for those classes only, with no reset, unlayered, and the Look as its theme", async () => {
+        const css = await builtCss(["kit:p-4", "kit:md:hover:bg-brand/90", "kit:text-h1", "kit:bg-dark-sand", "kit:font-display", "kit:rounded-card", "kit:max-w-content"], ["dark-sand"]);
+        expect(css).toContain(".kit\\:p-4 {");
+        expect(css).toContain("var(--look-brand, #111)");
+        expect(css).toContain("font-size: var(--look-type-h1-size, 56px)");
+        expect(css).toContain("background-color: var(--look-swatch-dark-sand)");
+        expect(css).toContain("font-family: var(--look-heading-font, inherit)");
+        expect(css).toContain("border-radius: var(--look-radius, 8px)");
+        expect(css).toContain("max-width: var(--look-width, 1200px)");
+        // Nothing for a class of the site's own, no reset of its elements, no layer the site's CSS would beat.
+        expect(css).not.toMatch(/\n\.flex|box-sizing|@layer (theme|base|utilities)|^\/\*!/);
+        expect(await builtCss([])).toBe("");
+    });
+    it("names the site's own colours by their slugs, never over Tailwind's own words or the roles", () => {
+        expect(swatchSlugs({ "--look-swatch-dark-sand": "#c2a", "--look-swatch-1": "#c2a", "--look-swatch-current": "#000", "--look-swatch-brand": "#111", "--look-brand": "#111" })).toEqual(["dark-sand"]);
+        expect(tailwindInput(["dark-sand"])).toContain("--color-dark-sand: var(--look-swatch-dark-sand);");
+        expect(tailwindInput()).toStartWith('@import "tailwindcss/theme.css" prefix(kit);\n@import "tailwindcss/utilities.css";');
+    });
+    it("is made by prepare into the site's public files, with each behavior's script, and cleared when there are none", async () => {
+        const kit = pathToFileURL(join(import.meta.dir, "content", "index.ts")).href;
+        const kitSections = pathToFileURL(join(import.meta.dir, "sections", "index.ts")).href;
+        const root = await mkdtemp(join(tmpdir(), "site-"));
+        await mkdir(join(root, "content"), { recursive: true });
+        await writeFile(join(root, "content", "schema.ts"), `import { defineSite } from ${JSON.stringify(kit)};\nimport { sections } from ${JSON.stringify(kitSections)};\nexport default defineSite({ ...sections }, { look: { brand: "#2b5f8a", palette: [{ name: "Dark sand", color: "#8a6d3b" }] } });\n`);
+        const site = (blocks) => writeFile(join(root, "content", "site.json"), JSON.stringify({ url: "https://acme.example", business: { name: "Acme" }, pages: [{ path: "/", title: "Acme", description: "Acme does things.", blocks }] }));
+        await site([{ type: "built", root: { id: "root000014", tag: "div", class: "p-4 bg-dark-sand", behavior: { name: "carousel" }, children: [{ id: "s000000007", tag: "p", text: "One" }] } }]);
+        const p = await prepare(root, {}, () => { });
+        expect(p.built?.css).toMatch(/^\/_kit\/built\.[0-9a-f]{10}\.css$/);
+        expect(p.built?.scripts?.carousel).toMatch(/^\/_kit\/carousel\.[0-9a-f]{10}\.js$/);
+        const css = await readFile(join(root, "public", p.built.css), "utf8");
+        expect(css).toContain("background-color: var(--look-swatch-dark-sand)");
+        expect(await readFile(join(root, "public", p.built.scripts.carousel), "utf8")).toContain('"carousel"');
+        await site([{ type: "own", columns: [{ parts: [] }] }]);
+        const again = await prepare(root, {}, () => { });
+        expect(again.built).toBeUndefined();
+        expect(existsSync(join(root, "public", "_kit"))).toBe(false);
+    });
+});
+describe("the preview", () => {
+    it("lets Tailwind's browser build write its styles on the preview page only", async () => {
+        const root = await mkdtemp(join(tmpdir(), "site-"));
+        await mkdir(join(root, ".site"), { recursive: true });
+        await mkdir(join(root, "out"), { recursive: true });
+        await writeFile(join(root, ".site", "prepared.json"), JSON.stringify({ site: { url: "https://acme.example", business: { name: "Acme" }, redirects: [], pages: [{ path: "/", blocks: [] }] }, images: {}, csp: {} }));
+        await writeFile(join(root, "out", "index.html"), "<html><head><style>a{}</style></head><body></body></html>");
+        await writeFile(join(root, "out", "calos-preview.html"), "<html><head><style>a{}</style></head><body></body></html>");
+        await finish(root, join(root, "out"), {}, () => { });
+        expect(await readFile(join(root, "out", "calos-preview.html"), "utf8")).toContain("style-src 'self' 'unsafe-inline';");
+        const page = await readFile(join(root, "out", "index.html"), "utf8");
+        expect(page).toMatch(/style-src 'self' 'sha256-[^']+';/);
+        expect(page).not.toContain("unsafe-inline");
+    });
+    it("matches a click only against what's seen: not a slide faded out over the one showing", () => {
+        const shown = { ariaHidden: null, visibility: "visible", display: "block", opacity: "1" };
+        expect(isShown([shown, shown])).toBe(true);
+        expect(isShown([shown, { ...shown, opacity: "0" }])).toBe(false);
+        expect(isShown([{ ...shown, ariaHidden: "true" }])).toBe(false);
+        expect(isShown([shown, { ...shown, inert: true }])).toBe(false);
+        expect(isShown([{ ...shown, visibility: "hidden" }])).toBe(false);
+    });
+    it("draws a node as hovered by its hover classes without the state", () => {
+        expect(withoutVariant("kit:md:hover:bg-ink", ["hover"])).toBe("kit:md:bg-ink");
+        expect(withoutVariant("kit:group-hover:underline", ["group-hover"])).toBe("kit:underline");
+        expect(withoutVariant("kit:bg-ink", ["hover"])).toBeNull();
+        expect(withoutVariant("hover:bg-ink", ["hover"])).toBeNull();
+    });
+});

package/dist/consent.d.ts

@@ -0,0 +1,33 @@
+import { z } from "zod";
+/** Where the visitor's choice is kept, in their own browser: "yes" or "no". */
+export declare const CONSENT_KEY = "kit-consent";
+/** The setting: whether the site asks, the banner's words and buttons, where it sits, and its design. */
+export declare const consent: z.ZodObject<{
+    on: z.ZodDefault<z.ZodBoolean>;
+    text: z.ZodDefault<z.ZodString>;
+    accept: z.ZodDefault<z.ZodString>;
+    decline: z.ZodDefault<z.ZodString>;
+    policy: z.ZodOptional<z.ZodObject<{
+        label: z.ZodString;
+        href: z.ZodString;
+    }, z.core.$strip>>;
+    place: z.ZodDefault<z.ZodEnum<{
+        top: "top";
+        bottom: "bottom";
+        "bottom-left": "bottom-left";
+        "bottom-right": "bottom-right";
+    }>>;
+    design: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type Consent = z.output<typeof consent>;
+/** Whether the site asks before counting. */
+export declare const asksConsent: (site: {
+    consent?: unknown;
+}) => boolean;
+/**
+ * The banner's script: shows the banner where no choice has been made, keeps the choice when a
+ * button is pressed, tells the page (a `kit:consent` event, "yes" or "no"), and shows the banner
+ * again from anything marked data-kit-consent="change". Without scripting, the banner stays hidden
+ * and nothing is counted.
+ */
+export declare function consentScript(): string;

package/dist/consent.js

@@ -0,0 +1,36 @@
+// A cookie banner as a site's configuration, not its code (the site's `consent` setting). Off by
+// default: a site that counts its visits does it without cookies (the kit's counter, ./finish.ts),
+// which needs no banner. On, the site asks first: a banner in its words and place, in the kit's
+// design or one of the site's components (a built tree with the slots text, accept, decline and
+// policy), and its visits are counted only once a visitor accepts. The choice is kept in the
+// visitor's browser (localStorage, not a cookie), and any element marked data-kit-consent="change"
+// (a footer link) brings the banner back. The privacy policy says which (./policies.ts).
+//
+// Pure: the schema, the scripts finish puts in each page, and whether a site asks.
+import { z } from "zod";
+/** Where the visitor's choice is kept, in their own browser: "yes" or "no". */
+export const CONSENT_KEY = "kit-consent";
+/** The setting: whether the site asks, the banner's words and buttons, where it sits, and its design. */
+export const consent = z
+    .object({
+    on: z.boolean().default(false).meta({ title: "Ask before counting visits" }),
+    text: z.string().trim().min(1).max(600).default("We'd like to count visits to this site, to see what's useful. Is that all right?").meta({ title: "What it says", "x-ui": "markdown" }),
+    accept: z.string().trim().min(1).max(40).default("Accept").meta({ title: "Accept button" }),
+    decline: z.string().trim().min(1).max(40).default("Decline").meta({ title: "Decline button" }),
+    policy: z.object({ label: z.string().trim().min(1).max(60), href: z.string().regex(/^\/[\w\-./#]*$/) }).optional().meta({ title: "Link to the privacy policy" }),
+    place: z.enum(["bottom", "bottom-left", "bottom-right", "top"]).default("bottom").meta({ title: "Where it sits", "x-labels": { bottom: "Along the bottom", "bottom-left": "Bottom left corner", "bottom-right": "Bottom right corner", top: "Along the top" } }),
+    /** One of the site's components drawn as the banner, its slots filled (text, accept, decline, policy); the kit's own design without one. */
+    design: z.string().regex(/^[a-z][a-z0-9-]{0,39}$/).optional().meta({ title: "Design (a component)" }),
+})
+    .meta({ title: "Cookie banner" });
+/** Whether the site asks before counting. */
+export const asksConsent = (site) => !!site.consent?.on;
+/**
+ * The banner's script: shows the banner where no choice has been made, keeps the choice when a
+ * button is pressed, tells the page (a `kit:consent` event, "yes" or "no"), and shows the banner
+ * again from anything marked data-kit-consent="change". Without scripting, the banner stays hidden
+ * and nothing is counted.
+ */
+export function consentScript() {
+    return `(()=>{const K=${JSON.stringify(CONSENT_KEY)};const get=()=>{try{return localStorage.getItem(K)}catch{return null}};const banner=()=>document.querySelector("[data-kit-consent-banner]");const go=()=>{const b=banner();if(b&&!get())b.hidden=false;document.addEventListener("click",(e)=>{const t=e.target.closest&&e.target.closest("[data-kit-consent]");if(!t)return;const v=t.getAttribute("data-kit-consent");if(v==="change"){e.preventDefault();const b=banner();if(b){b.hidden=false;b.querySelector("[data-kit-consent=accept]")?.focus()}return}if(v!=="accept"&&v!=="decline")return;e.preventDefault();const yes=v==="accept"?"yes":"no";try{localStorage.setItem(K,yes)}catch{}const b=banner();if(b)b.hidden=true;dispatchEvent(new CustomEvent("kit:consent",{detail:yes}))})};if(document.readyState==="loading")document.addEventListener("DOMContentLoaded",go,{once:true});else go();})();`;
+}

package/dist/consent.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/consent.test.js

@@ -0,0 +1,61 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { describe, expect, it } from "bun:test";
+import { mkdir, mkdtemp, readFile, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { renderToStaticMarkup } from "react-dom/server";
+import { consentScript } from "./consent.js";
+import { defineSite } from "./content/index.js";
+import { counted, finish } from "./finish.js";
+import { KitConsent } from "./next/consent.js";
+import { setPrepared } from "./next/data.js";
+import { policy } from "./policies.js";
+import { sections } from "./sections/index.js";
+// A cookie banner as configuration: off unless the site turns it on; on, visits are counted only once accepted.
+const base = { url: "https://acme.example", lang: "en", business: { name: "Acme" }, redirects: [], pages: [{ path: "/", title: "Acme", description: "Acme does things.", blocks: [{ type: "gallery", images: [{ src: "a.jpg", alt: "A" }] }] }] };
+const analytics = { client: "5c2bbecb-9956-4f13-a458-9528dd049210", api: "https://analytics-api.caltho.com", script: "https://analytics.caltho.com/op1.js" };
+describe("consent", () => {
+    it("is off unless turned on, with its words and place defaulted, and its design one of the site's components", () => {
+        const site = defineSite({ ...sections });
+        const off = site.parse(base);
+        expect(off.site?.consent).toBeUndefined();
+        const on = site.parse({ ...base, consent: { on: true } });
+        expect(on.site?.consent).toMatchObject({ on: true, accept: "Accept", decline: "Decline", place: "bottom" });
+        expect(site.parse({ ...base, consent: { on: true, design: "banner" } }).problems?.join(" ")).toMatch(/no component called banner/);
+    });
+    it("starts the counter only once accepted, and puts the banner's script in each page", async () => {
+        const gated = counted("<html><head></head><body></body></html>", analytics, true);
+        expect(gated).not.toContain('<script src=');
+        expect(gated).toContain('localStorage.getItem("kit-consent")==="yes"');
+        expect(gated).toContain('addEventListener("kit:consent"');
+        expect(() => new Function(/<script>([\s\S]*?)<\/script>/.exec(gated)[1])).not.toThrow();
+        expect(() => new Function(consentScript())).not.toThrow();
+        const root = await mkdtemp(join(tmpdir(), "finish-"));
+        await mkdir(join(root, ".site"), { recursive: true });
+        await mkdir(join(root, "out"), { recursive: true });
+        await writeFile(join(root, ".site", "prepared.json"), JSON.stringify({ site: { ...base, consent: { on: true } }, images: {}, csp: {}, analytics }));
+        await writeFile(join(root, "out", "index.html"), "<html><head></head><body></body></html>");
+        await finish(root, join(root, "out"), {}, () => { });
+        const html = await readFile(join(root, "out", "index.html"), "utf8");
+        expect(html).toContain("data-kit-consent-banner");
+        expect(html).toContain("script-src 'self' 'sha256-");
+    });
+    it("draws the banner hidden for the script to show, in the kit's design or the site's component, its buttons marked", () => {
+        const components = [{ key: "banner", name: "Banner", root: { id: "ban0000001", tag: "div", class: "p-4 bg-ink", children: [{ id: "txt0000001", tag: "p", slot: "text", text: "x" }, { id: "yes0000001", tag: "button", slot: "accept", text: "x" }, { id: "no00000001", tag: "button", slot: "decline", text: "x" }] } }];
+        setPrepared({ site: { ...base, components }, images: {}, csp: {} }, false);
+        const kit = renderToStaticMarkup(_jsx(KitConsent, { site: { consent: { on: true, text: "Count **visits**?", accept: "OK", decline: "No thanks", place: "bottom-right", policy: { label: "Privacy", href: "/privacy/" } } } }));
+        expect(kit).toContain('class="kit-consent kit-consent-bottom-right" data-kit-consent-banner="" role="region" aria-label="Cookie choices" hidden=""');
+        expect(kit).toContain("Count <strong>visits</strong>?");
+        expect(kit).toContain('data-kit-consent="accept">OK</button>');
+        expect(kit).toContain('<a class="kit-consent-policy" href="/privacy/">Privacy</a>');
+        const own = renderToStaticMarkup(_jsx(KitConsent, { site: { consent: { on: true, text: "Cookies?", accept: "Yes", decline: "No", place: "bottom", design: "banner" } } }));
+        expect(own).toContain('<p>Cookies?</p><button data-kit-consent="accept" type="button">Yes</button><button data-kit-consent="decline" type="button">No</button>');
+        expect(renderToStaticMarkup(_jsx(KitConsent, { site: {} }))).toBe("");
+    });
+    it("says in the privacy policy that visits are counted only with agreement", () => {
+        const asks = policy({ ...base, countsVisits: true, consent: { on: true } }, "privacy").body;
+        expect(asks).toContain("only if you agree when it asks");
+        expect(asks).not.toContain("doesn't use cookies");
+        expect(policy({ ...base, countsVisits: true }, "privacy").body).toContain("This site doesn't use cookies or advertising trackers.");
+    });
+});