@caltho/site-kit 0.2.10 → 0.3.0

package/dist/preview-match.js

@@ -1,10 +1,12 @@
 // Which field of the content a click in CalOS's preview landed on, with no markers in the site's
 // components: the words clicked are matched against the content's text, a picture by its address.
 // Pure, so it's tested here and runs in the preview in the browser.
+import { PREFIX } from "./built/theme.js";
+import { splitVariants } from "./tree/classes.js";
 /** The preview page's list of the pictures its build made (by path), as a JSON script with this id (../finish.ts). */
 export const BUILT_IMAGES = "calos-built-images";
 /** Keys that hold no words a visitor reads: never what a click on words means. */
-const SKIP = new Set(["type", "id", "href", "path", "style", "menuStyle", "footer", "ratio", "tone"]);
+const SKIP = new Set(["type", "id", "href", "url", "path", "style", "menuStyle", "footer", "ratio", "tone"]);
 /** Words as they read on the page: Markdown's marks gone, a link's address gone, spacing and case evened. */
 export function readable(text) {
     return text
@@ -78,3 +80,58 @@ export function fieldForImage(value, base, url, images) {
     // The picture's group (its src and alt together) is what's edited.
     return hit.path.slice(0, -1).length > base.length ? hit.path.slice(0, -1) : hit.path;
 }
+/**
+ * Which block drew each of `main`'s drawn children, by the block's index (null: not known). `drawn`:
+ * each child's words, its pictures' alt text included. One drawn for each block pairs them in order.
+ * Otherwise they're found by their words, in order: a block may draw nothing (a list with nothing in
+ * it yet) or more than one (a hero above its rows), and a child without the words to say is left
+ * unknown, never guessed, unless the next block has no words to find it by.
+ */
+export function matchBlocks(blocks, drawn) {
+    if (drawn.length === blocks.length)
+        return blocks.map((_, i) => i);
+    const page = drawn.map(readable);
+    const words = blocks.map((b) => textsIn(b).map((t) => readable(t.text)).filter((t) => t.length >= 4));
+    const out = [];
+    let last = -1;
+    for (const text of page) {
+        // A later block whose words are here, else more of the block before (its words here too), else
+        // the next one when it has no words to be found by.
+        const shows = (i) => words[i].some((w) => text.includes(w));
+        let at = null;
+        for (let i = last + 1; i < blocks.length && at === null; i++)
+            if (shows(i))
+                at = i;
+        if (at === null && last >= 0 && shows(last))
+            at = last;
+        if (at === null && last + 1 < blocks.length && !words[last + 1].length)
+            at = last + 1;
+        out.push(at);
+        if (at !== null)
+            last = at;
+    }
+    return out;
+}
+/**
+ * Whether an element is one a person sees, from it and each element it's in (itself first): not in
+ * something hidden from them (a carousel's other slides, stacked in the same place and faded out,
+ * aria-hidden or inert) and not faded out to nothing. A click is matched only against what's seen,
+ * so the slide showing is the one a click on it opens, not one faded out on top of it.
+ */
+export function isShown(chain) {
+    return chain.every((c) => c.ariaHidden !== "true" && !c.inert && c.visibility !== "hidden" && c.display !== "none" && !(Number(c.opacity) < 0.05));
+}
+/**
+ * A built section's class (as drawn, prefixed) without the state variants given: `kit:md:hover:bg-ink`
+ * without hover is `kit:md:bg-ink`, which the preview adds to draw an element as hovered while its
+ * hover classes are edited. Null for a class without any of them.
+ */
+export function withoutVariant(cls, variants) {
+    if (!cls.startsWith(`${PREFIX}:`))
+        return null;
+    const { variants: vs, utility } = splitVariants(cls.slice(PREFIX.length + 1));
+    const kept = vs.filter((v) => !variants.includes(v));
+    if (kept.length === vs.length)
+        return null;
+    return [PREFIX, ...kept, utility].join(":");
+}

package/dist/schema.d.ts

@@ -58,3 +58,13 @@ export declare function checkStructure(site: {
 export declare function describePath(raw: unknown, path: PropertyKey[]): string;
 /** The last named field in a path, for a short label. */
 export declare const fieldOf: (path: (string | number)[]) => string | undefined;
+/**
+ * What a block is called where a person sees a list of them (CalOS's sections, Cal's changes): a
+ * section of the business's own by its heading, else its first heading part; any other by its
+ * `heading`, `title` or the first line of its `headline`; else what its kind is called
+ * (`kindTitle`). At most 60 characters.
+ */
+export declare function blockLabel(block: {
+    type?: unknown;
+    [field: string]: unknown;
+}, kindTitle: string): string;

package/dist/schema.js

@@ -3,6 +3,7 @@
 // check content with messages a person can act on, make a blank new item (a block, a list entry),
 // and find the kinds of block a site has. Also the checks that need no schema at all (pages, home,
 // links), and readable places in the content.
+import { allPages } from "./content/lists.js";
 const unions = (s) => s.anyOf ?? s.oneOf;
 /** Follows a `$ref` to its definition in the same document. */
 export function resolve(s, root) {
@@ -191,7 +192,8 @@ export function checkStructure(site) {
 /** Every link to a page of the site must land on one, and every link to a part of a page must have that part. */
 function linkIssues(site) {
     const issues = [];
-    const ids = new Map(site.pages.map((p) => [p.path, new Set(p.blocks.map((b) => b.id).filter(Boolean))]));
+    // A list's item pages are pages too (a link to /products/walnut-desk/ lands).
+    const ids = new Map(allPages(site).map((p) => [p.path, new Set(p.blocks.map((b) => b.id).filter(Boolean))]));
     const visit = (value, path, pagePath) => {
         if (Array.isArray(value))
             value.forEach((v, i) => visit(v, [...path, i], pagePath));
@@ -235,3 +237,29 @@ export function describePath(raw, path) {
 }
 /** The last named field in a path, for a short label. */
 export const fieldOf = words;
+/**
+ * What a block is called where a person sees a list of them (CalOS's sections, Cal's changes): a
+ * section of the business's own by its heading, else its first heading part; any other by its
+ * `heading`, `title` or the first line of its `headline`; else what its kind is called
+ * (`kindTitle`). At most 60 characters.
+ */
+export function blockLabel(block, kindTitle) {
+    const str = (v) => (typeof v === "string" && v.trim() ? v.trim().split("\n")[0].trim() : undefined);
+    let label;
+    if (block.type === "own") {
+        label = str(block.heading);
+        if (!label && Array.isArray(block.columns)) {
+            for (const c of block.columns) {
+                const h = Array.isArray(c?.parts) ? c.parts.find((p) => p?.type === "heading" && str(p.text)) : undefined;
+                if (h) {
+                    label = str(h.text);
+                    break;
+                }
+            }
+        }
+    }
+    else
+        label = str(block.heading) ?? str(block.title) ?? str(block.headline);
+    const out = label ?? kindTitle;
+    return out.length > 60 ? `${out.slice(0, 59).trimEnd()}…` : out;
+}

package/dist/sections/icons.d.ts

@@ -0,0 +1,49 @@
+/** Each icon's strokes, as SVG path data (stroke 2, round ends and joins, no fill). */
+export declare const ICONS: {
+    readonly check: readonly ["M20 6 9 17l-5-5"];
+    readonly calendar: readonly ["M5 4h14a2 2 0 0 1 2 2v14a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V6a2 2 0 0 1 2-2z", "M16 2v4M8 2v4M3 10h18"];
+    readonly clock: readonly ["M12 22a10 10 0 1 0 0-20 10 10 0 0 0 0 20z", "M12 6v6l4 2"];
+    readonly users: readonly ["M17 21v-2a4 4 0 0 0-4-4H5a4 4 0 0 0-4 4v2", "M9 11a4 4 0 1 0 0-8 4 4 0 0 0 0 8z", "M23 21v-2a4 4 0 0 0-3-3.87M16 3.13a4 4 0 0 1 0 7.75"];
+    readonly user: readonly ["M20 21v-2a4 4 0 0 0-4-4H8a4 4 0 0 0-4 4v2", "M12 11a4 4 0 1 0 0-8 4 4 0 0 0 0 8z"];
+    readonly chat: readonly ["M21 15a2 2 0 0 1-2 2H7l-4 4V5a2 2 0 0 1 2-2h14a2 2 0 0 1 2 2z"];
+    readonly mail: readonly ["M4 4h16a2 2 0 0 1 2 2v12a2 2 0 0 1-2 2H4a2 2 0 0 1-2-2V6a2 2 0 0 1 2-2z", "m22 6-10 7L2 6"];
+    readonly phone: readonly ["M22 16.9v3a2 2 0 0 1-2.2 2 19.8 19.8 0 0 1-8.6-3.1 19.5 19.5 0 0 1-6-6A19.8 19.8 0 0 1 2.1 4.2 2 2 0 0 1 4.1 2h3a2 2 0 0 1 2 1.7c.1 1 .4 1.9.7 2.8a2 2 0 0 1-.5 2.1L8 9.9a16 16 0 0 0 6 6l1.3-1.3a2 2 0 0 1 2.1-.4c.9.3 1.8.6 2.8.7a2 2 0 0 1 1.7 2z"];
+    readonly "map-pin": readonly ["M21 10c0 7-9 13-9 13s-9-6-9-13a9 9 0 0 1 18 0z", "M12 13a3 3 0 1 0 0-6 3 3 0 0 0 0 6z"];
+    readonly chart: readonly ["M18 20V10M12 20V4M6 20v-6"];
+    readonly file: readonly ["M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z", "M14 2v6h6M16 13H8M16 17H8M10 9H8"];
+    readonly folder: readonly ["M22 19a2 2 0 0 1-2 2H4a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h5l2 3h9a2 2 0 0 1 2 2z"];
+    readonly invoice: readonly ["M5 2h14v20l-3-2-2 2-2-2-2 2-2-2-3 2z", "M9 7h6M9 11h6M9 15h4"];
+    readonly card: readonly ["M3 5h18a2 2 0 0 1 2 2v10a2 2 0 0 1-2 2H3a2 2 0 0 1-2-2V7a2 2 0 0 1 2-2z", "M1 10h22"];
+    readonly shield: readonly ["M12 22s8-4 8-10V5l-8-3-8 3v7c0 6 8 10 8 10z"];
+    readonly lock: readonly ["M5 11h14a2 2 0 0 1 2 2v7a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-7a2 2 0 0 1 2-2z", "M7 11V7a5 5 0 0 1 10 0v4"];
+    readonly star: readonly ["m12 2 3.09 6.26L22 9.27l-5 4.87 1.18 6.88L12 17.77l-6.18 3.25L7 14.14 2 9.27l6.91-1.01z"];
+    readonly heart: readonly ["M20.84 4.61a5.5 5.5 0 0 0-7.78 0L12 5.67l-1.06-1.06a5.5 5.5 0 0 0-7.78 7.78l1.06 1.06L12 21.23l7.78-7.78 1.06-1.06a5.5 5.5 0 0 0 0-7.78z"];
+    readonly bolt: readonly ["M13 2 3 14h9l-1 8 10-12h-9z"];
+    readonly gear: readonly ["M12 15a3 3 0 1 0 0-6 3 3 0 0 0 0 6z", "M12 19a7 7 0 1 0 0-14 7 7 0 0 0 0 14z", "M12 1v4M12 19v4M1 12h4M19 12h4M4.2 4.2l2.85 2.85M16.95 16.95l2.85 2.85M4.2 19.8l2.85-2.85M16.95 7.05l2.85-2.85"];
+    readonly search: readonly ["M11 19a8 8 0 1 0 0-16 8 8 0 0 0 0 16z", "m21 21-4.35-4.35"];
+    readonly home: readonly ["m3 9 9-7 9 7v11a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2z", "M9 22V12h6v10"];
+    readonly building: readonly ["M4 22V4a2 2 0 0 1 2-2h12a2 2 0 0 1 2 2v18", "M2 22h20", "M9 6h1M14 6h1M9 10h1M14 10h1M9 14h1M14 14h1", "M10 22v-4h4v4"];
+    readonly truck: readonly ["M1 3h15v13H1z", "M16 8h4l3 3v5h-7z", "M5.5 21a2.5 2.5 0 1 0 0-5 2.5 2.5 0 0 0 0 5z", "M18.5 21a2.5 2.5 0 1 0 0-5 2.5 2.5 0 0 0 0 5z"];
+    readonly wrench: readonly ["M14.7 6.3a1 1 0 0 0 0 1.4l1.6 1.6a1 1 0 0 0 1.4 0l3.77-3.77a6 6 0 0 1-7.94 7.94l-6.91 6.91a2.12 2.12 0 0 1-3-3l6.91-6.91a6 6 0 0 1 7.94-7.94l-3.76 3.76z"];
+    readonly leaf: readonly ["M11 20A7 7 0 0 1 9.8 6.1C15.5 5 17 4.48 19 2c1 2 2 4.18 2 8 0 5.5-4.78 10-10 10z", "M2 21c0-3 1.85-5.36 5.08-6C9.5 14.52 12 13 13 12"];
+    readonly sun: readonly ["M12 17a5 5 0 1 0 0-10 5 5 0 0 0 0 10z", "M12 1v2M12 21v2M4.22 4.22l1.42 1.42M18.36 18.36l1.42 1.42M1 12h2M21 12h2M4.22 19.78l1.42-1.42M18.36 5.64l1.42-1.42"];
+    readonly globe: readonly ["M12 22a10 10 0 1 0 0-20 10 10 0 0 0 0 20z", "M2 12h20", "M12 2a15.3 15.3 0 0 1 4 10 15.3 15.3 0 0 1-4 10 15.3 15.3 0 0 1-4-10 15.3 15.3 0 0 1 4-10z"];
+    readonly link: readonly ["M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71", "M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71"];
+    readonly camera: readonly ["M23 19a2 2 0 0 1-2 2H3a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h4l2-3h6l2 3h4a2 2 0 0 1 2 2z", "M12 17a4 4 0 1 0 0-8 4 4 0 0 0 0 8z"];
+    readonly play: readonly ["M12 22a10 10 0 1 0 0-20 10 10 0 0 0 0 20z", "m10 8 6 4-6 4z"];
+    readonly "arrow-right": readonly ["M5 12h14M12 5l7 7-7 7"];
+    readonly menu: readonly ["M4 6h16M4 12h16M4 18h16"];
+    readonly "star-four": readonly ["M12 2C13.03 7.97 16.03 10.97 22 12C16.03 13.03 13.03 16.03 12 22C10.97 16.03 7.97 13.03 2 12C7.97 10.97 10.97 7.97 12 2Z"];
+    readonly plus: readonly ["M12 5v14M5 12h14"];
+    readonly minus: readonly ["M5 12h14"];
+    readonly x: readonly ["M18 6 6 18M6 6l12 12"];
+    readonly info: readonly ["M12 22a10 10 0 1 0 0-20 10 10 0 0 0 0 20z", "M12 16v-4M12 8h.01"];
+    readonly warning: readonly ["M10.29 3.86 1.82 18a2 2 0 0 0 1.71 3h16.94a2 2 0 0 0 1.71-3L13.71 3.86a2 2 0 0 0-3.42 0z", "M12 9v4M12 17h.01"];
+    readonly list: readonly ["M8 6h13M8 12h13M8 18h13M3 6h.01M3 12h.01M3 18h.01"];
+    readonly grid: readonly ["M3 3h7v7H3zM14 3h7v7h-7zM14 14h7v7h-7zM3 14h7v7H3z"];
+    readonly tag: readonly ["M20.59 13.41 13.42 20.58a2 2 0 0 1-2.83 0L2 12V2h10l8.59 8.59a2 2 0 0 1 0 2.82z", "M7 7h.01"];
+    readonly award: readonly ["M12 15a7 7 0 1 0 0-14 7 7 0 0 0 0 14z", "M8.21 13.89 7 23l5-3 5 3-1.21-9.12"];
+};
+export type IconName = keyof typeof ICONS;
+/** Every icon's name, in the order CalOS offers them. */
+export declare const ICON_NAMES: [IconName, ...IconName[]];

package/dist/sections/icons.js

@@ -0,0 +1,55 @@
+// The kit's icons: plain line drawings on a 24-unit grid, drawn inline (an `own` section's icon part,
+// a table's yes and no) so they need nothing fetched and take the colour of what they're in. No
+// sparkles: an icon says what something is, not that it's new or clever.
+/** Each icon's strokes, as SVG path data (stroke 2, round ends and joins, no fill). */
+export const ICONS = {
+    check: ["M20 6 9 17l-5-5"],
+    calendar: ["M5 4h14a2 2 0 0 1 2 2v14a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V6a2 2 0 0 1 2-2z", "M16 2v4M8 2v4M3 10h18"],
+    clock: ["M12 22a10 10 0 1 0 0-20 10 10 0 0 0 0 20z", "M12 6v6l4 2"],
+    users: ["M17 21v-2a4 4 0 0 0-4-4H5a4 4 0 0 0-4 4v2", "M9 11a4 4 0 1 0 0-8 4 4 0 0 0 0 8z", "M23 21v-2a4 4 0 0 0-3-3.87M16 3.13a4 4 0 0 1 0 7.75"],
+    user: ["M20 21v-2a4 4 0 0 0-4-4H8a4 4 0 0 0-4 4v2", "M12 11a4 4 0 1 0 0-8 4 4 0 0 0 0 8z"],
+    chat: ["M21 15a2 2 0 0 1-2 2H7l-4 4V5a2 2 0 0 1 2-2h14a2 2 0 0 1 2 2z"],
+    mail: ["M4 4h16a2 2 0 0 1 2 2v12a2 2 0 0 1-2 2H4a2 2 0 0 1-2-2V6a2 2 0 0 1 2-2z", "m22 6-10 7L2 6"],
+    phone: [
+        "M22 16.9v3a2 2 0 0 1-2.2 2 19.8 19.8 0 0 1-8.6-3.1 19.5 19.5 0 0 1-6-6A19.8 19.8 0 0 1 2.1 4.2 2 2 0 0 1 4.1 2h3a2 2 0 0 1 2 1.7c.1 1 .4 1.9.7 2.8a2 2 0 0 1-.5 2.1L8 9.9a16 16 0 0 0 6 6l1.3-1.3a2 2 0 0 1 2.1-.4c.9.3 1.8.6 2.8.7a2 2 0 0 1 1.7 2z",
+    ],
+    "map-pin": ["M21 10c0 7-9 13-9 13s-9-6-9-13a9 9 0 0 1 18 0z", "M12 13a3 3 0 1 0 0-6 3 3 0 0 0 0 6z"],
+    chart: ["M18 20V10M12 20V4M6 20v-6"],
+    file: ["M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z", "M14 2v6h6M16 13H8M16 17H8M10 9H8"],
+    folder: ["M22 19a2 2 0 0 1-2 2H4a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h5l2 3h9a2 2 0 0 1 2 2z"],
+    invoice: ["M5 2h14v20l-3-2-2 2-2-2-2 2-2-2-3 2z", "M9 7h6M9 11h6M9 15h4"],
+    card: ["M3 5h18a2 2 0 0 1 2 2v10a2 2 0 0 1-2 2H3a2 2 0 0 1-2-2V7a2 2 0 0 1 2-2z", "M1 10h22"],
+    shield: ["M12 22s8-4 8-10V5l-8-3-8 3v7c0 6 8 10 8 10z"],
+    lock: ["M5 11h14a2 2 0 0 1 2 2v7a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-7a2 2 0 0 1 2-2z", "M7 11V7a5 5 0 0 1 10 0v4"],
+    star: ["m12 2 3.09 6.26L22 9.27l-5 4.87 1.18 6.88L12 17.77l-6.18 3.25L7 14.14 2 9.27l6.91-1.01z"],
+    heart: ["M20.84 4.61a5.5 5.5 0 0 0-7.78 0L12 5.67l-1.06-1.06a5.5 5.5 0 0 0-7.78 7.78l1.06 1.06L12 21.23l7.78-7.78 1.06-1.06a5.5 5.5 0 0 0 0-7.78z"],
+    bolt: ["M13 2 3 14h9l-1 8 10-12h-9z"],
+    gear: ["M12 15a3 3 0 1 0 0-6 3 3 0 0 0 0 6z", "M12 19a7 7 0 1 0 0-14 7 7 0 0 0 0 14z", "M12 1v4M12 19v4M1 12h4M19 12h4M4.2 4.2l2.85 2.85M16.95 16.95l2.85 2.85M4.2 19.8l2.85-2.85M16.95 7.05l2.85-2.85"],
+    search: ["M11 19a8 8 0 1 0 0-16 8 8 0 0 0 0 16z", "m21 21-4.35-4.35"],
+    home: ["m3 9 9-7 9 7v11a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2z", "M9 22V12h6v10"],
+    building: ["M4 22V4a2 2 0 0 1 2-2h12a2 2 0 0 1 2 2v18", "M2 22h20", "M9 6h1M14 6h1M9 10h1M14 10h1M9 14h1M14 14h1", "M10 22v-4h4v4"],
+    truck: ["M1 3h15v13H1z", "M16 8h4l3 3v5h-7z", "M5.5 21a2.5 2.5 0 1 0 0-5 2.5 2.5 0 0 0 0 5z", "M18.5 21a2.5 2.5 0 1 0 0-5 2.5 2.5 0 0 0 0 5z"],
+    wrench: ["M14.7 6.3a1 1 0 0 0 0 1.4l1.6 1.6a1 1 0 0 0 1.4 0l3.77-3.77a6 6 0 0 1-7.94 7.94l-6.91 6.91a2.12 2.12 0 0 1-3-3l6.91-6.91a6 6 0 0 1 7.94-7.94l-3.76 3.76z"],
+    leaf: ["M11 20A7 7 0 0 1 9.8 6.1C15.5 5 17 4.48 19 2c1 2 2 4.18 2 8 0 5.5-4.78 10-10 10z", "M2 21c0-3 1.85-5.36 5.08-6C9.5 14.52 12 13 13 12"],
+    sun: ["M12 17a5 5 0 1 0 0-10 5 5 0 0 0 0 10z", "M12 1v2M12 21v2M4.22 4.22l1.42 1.42M18.36 18.36l1.42 1.42M1 12h2M21 12h2M4.22 19.78l1.42-1.42M18.36 5.64l1.42-1.42"],
+    globe: ["M12 22a10 10 0 1 0 0-20 10 10 0 0 0 0 20z", "M2 12h20", "M12 2a15.3 15.3 0 0 1 4 10 15.3 15.3 0 0 1-4 10 15.3 15.3 0 0 1-4-10 15.3 15.3 0 0 1 4-10z"],
+    link: ["M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71", "M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71"],
+    camera: ["M23 19a2 2 0 0 1-2 2H3a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h4l2-3h6l2 3h4a2 2 0 0 1 2 2z", "M12 17a4 4 0 1 0 0-8 4 4 0 0 0 0 8z"],
+    play: ["M12 22a10 10 0 1 0 0-20 10 10 0 0 0 0 20z", "m10 8 6 4-6 4z"],
+    "arrow-right": ["M5 12h14M12 5l7 7-7 7"],
+    // A phone's menu button: three lines.
+    menu: ["M4 6h16M4 12h16M4 18h16"],
+    // A four-point star (a mark beside a link, a divider): drawn as a line like the others, solid with fill-current.
+    "star-four": ["M12 2C13.03 7.97 16.03 10.97 22 12C16.03 13.03 13.03 16.03 12 22C10.97 16.03 7.97 13.03 2 12C7.97 10.97 10.97 7.97 12 2Z"],
+    plus: ["M12 5v14M5 12h14"],
+    minus: ["M5 12h14"],
+    x: ["M18 6 6 18M6 6l12 12"],
+    info: ["M12 22a10 10 0 1 0 0-20 10 10 0 0 0 0 20z", "M12 16v-4M12 8h.01"],
+    warning: ["M10.29 3.86 1.82 18a2 2 0 0 0 1.71 3h16.94a2 2 0 0 0 1.71-3L13.71 3.86a2 2 0 0 0-3.42 0z", "M12 9v4M12 17h.01"],
+    list: ["M8 6h13M8 12h13M8 18h13M3 6h.01M3 12h.01M3 18h.01"],
+    grid: ["M3 3h7v7H3zM14 3h7v7h-7zM14 14h7v7h-7zM3 14h7v7H3z"],
+    tag: ["M20.59 13.41 13.42 20.58a2 2 0 0 1-2.83 0L2 12V2h10l8.59 8.59a2 2 0 0 1 0 2.82z", "M7 7h.01"],
+    award: ["M12 15a7 7 0 1 0 0-14 7 7 0 0 0 0 14z", "M8.21 13.89 7 23l5-3 5 3-1.21-9.12"],
+};
+/** Every icon's name, in the order CalOS offers them. */
+export const ICON_NAMES = Object.keys(ICONS);

package/dist/sections/index.d.ts

@@ -1,4 +1,5 @@
 import { z } from "zod";
+export { ICON_NAMES, ICONS, type IconName } from "./icons.ts";
 /** Photos in a grid, each with a caption if it has one: their work, the place, the team at it. */
 export declare const gallery: z.ZodObject<{
     heading: z.ZodOptional<z.ZodString>;
@@ -30,29 +31,50 @@ export declare const slideshow: z.ZodObject<{
     }, z.core.$strip>>;
     shape: z.ZodDefault<z.ZodEnum<{
         square: "square";
-        wide: "wide";
         landscape: "landscape";
+        wide: "wide";
     }>>;
     seconds: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strip>;
+/**
+ * A YouTube or Vimeo address as the privacy-friendly player it's shown in (YouTube's no-cookie one,
+ * Vimeo's with tracking off), or null for any other address. Watch, share, Shorts and embed
+ * addresses all work.
+ */
+export declare function videoEmbed(url: string): {
+    src: string;
+    origin: string;
+} | null;
+/** Where a video part's players come from: a page showing one allows them in its frame-src. */
+export declare const VIDEO_ORIGINS: readonly ["https://www.youtube-nocookie.com", "https://player.vimeo.com"];
 export declare const parts: {
     readonly heading: z.ZodObject<{
         text: z.ZodString;
         size: z.ZodDefault<z.ZodEnum<{
             small: "small";
-            large: "large";
+            display: "display";
             medium: "medium";
+            large: "large";
+            page: "page";
+        }>>;
+        font: z.ZodOptional<z.ZodEnum<{
+            text: "text";
+            heading: "heading";
         }>>;
     }, z.core.$strip>;
     readonly text: z.ZodObject<{
         text: z.ZodString;
+        font: z.ZodOptional<z.ZodEnum<{
+            text: "text";
+            heading: "heading";
+        }>>;
     }, z.core.$strip>;
     readonly photo: z.ZodObject<{
-        image: z.ZodObject<{
+        image: z.ZodOptional<z.ZodObject<{
             src: z.ZodString;
             alt: z.ZodString;
             caption: z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>;
+        }, z.core.$strip>>;
         shape: z.ZodDefault<z.ZodEnum<{
             square: "square";
             landscape: "landscape";
@@ -63,10 +85,7 @@ export declare const parts: {
     readonly button: z.ZodObject<{
         label: z.ZodString;
         href: z.ZodString;
-        style: z.ZodDefault<z.ZodEnum<{
-            main: "main";
-            quiet: "quiet";
-        }>>;
+        style: z.ZodDefault<z.ZodString>;
     }, z.core.$strip>;
     readonly list: z.ZodObject<{
         items: z.ZodArray<z.ZodString>;
@@ -76,9 +95,25 @@ export declare const parts: {
             numbers: "numbers";
         }>>;
     }, z.core.$strip>;
+    readonly items: z.ZodObject<{
+        items: z.ZodArray<z.ZodObject<{
+            title: z.ZodString;
+            text: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        font: z.ZodOptional<z.ZodEnum<{
+            text: "text";
+            heading: "heading";
+        }>>;
+        numbered: z.ZodDefault<z.ZodBoolean>;
+        lines: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>;
     readonly quote: z.ZodObject<{
         text: z.ZodString;
         who: z.ZodOptional<z.ZodString>;
+        font: z.ZodOptional<z.ZodEnum<{
+            text: "text";
+            heading: "heading";
+        }>>;
     }, z.core.$strip>;
     readonly stats: z.ZodObject<{
         items: z.ZodArray<z.ZodObject<{
@@ -114,14 +149,87 @@ export declare const parts: {
     readonly space: z.ZodObject<{
         size: z.ZodDefault<z.ZodEnum<{
             small: "small";
+            medium: "medium";
             large: "large";
+        }>>;
+    }, z.core.$strip>;
+    readonly table: z.ZodObject<{
+        columns: z.ZodArray<z.ZodString>;
+        rows: z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            cells: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>>;
+        highlight: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+    readonly icon: z.ZodObject<{
+        name: z.ZodEnum<{
+            file: "file";
+            check: "check";
+            search: "search";
+            link: "link";
+            tag: "tag";
+            menu: "menu";
+            play: "play";
+            x: "x";
+            card: "card";
+            phone: "phone";
+            home: "home";
+            list: "list";
+            calendar: "calendar";
+            clock: "clock";
+            users: "users";
+            user: "user";
+            chat: "chat";
+            mail: "mail";
+            "map-pin": "map-pin";
+            chart: "chart";
+            folder: "folder";
+            invoice: "invoice";
+            shield: "shield";
+            lock: "lock";
+            star: "star";
+            heart: "heart";
+            bolt: "bolt";
+            gear: "gear";
+            building: "building";
+            truck: "truck";
+            wrench: "wrench";
+            leaf: "leaf";
+            sun: "sun";
+            globe: "globe";
+            camera: "camera";
+            "arrow-right": "arrow-right";
+            "star-four": "star-four";
+            plus: "plus";
+            minus: "minus";
+            info: "info";
+            warning: "warning";
+            grid: "grid";
+            award: "award";
+        }>;
+        size: z.ZodDefault<z.ZodEnum<{
+            small: "small";
             medium: "medium";
+            large: "large";
         }>>;
     }, z.core.$strip>;
+    readonly logos: z.ZodObject<{
+        title: z.ZodOptional<z.ZodString>;
+        images: z.ZodArray<z.ZodObject<{
+            src: z.ZodString;
+            alt: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    readonly video: z.ZodObject<{
+        url: z.ZodOptional<z.ZodString>;
+        title: z.ZodString;
+    }, z.core.$strip>;
 };
 export type PartType = keyof typeof parts;
 /** A section of the business's own: columns of parts, laid out as chosen, in the site's design. */
 export declare const own: z.ZodObject<{
+    heading: z.ZodOptional<z.ZodString>;
+    intro: z.ZodOptional<z.ZodString>;
     layout: z.ZodDefault<z.ZodEnum<{
         one: "one";
         two: "two";
@@ -135,14 +243,40 @@ export declare const own: z.ZodObject<{
         center: "center";
     }>>;
     tone: z.ZodDefault<z.ZodEnum<{
-        brand: "brand";
+        dark: "dark";
+        soft: "soft";
         plain: "plain";
+        brand: "brand";
+    }>>;
+    shape: z.ZodDefault<z.ZodEnum<{
+        card: "card";
+        band: "band";
+    }>>;
+    spacing: z.ZodDefault<z.ZodEnum<{
+        normal: "normal";
+        roomy: "roomy";
+        tight: "tight";
     }>>;
+    background: z.ZodOptional<z.ZodObject<{
+        src: z.ZodString;
+        alt: z.ZodString;
+    }, z.core.$strip>>;
     columns: z.ZodArray<z.ZodObject<{
+        card: z.ZodOptional<z.ZodBoolean>;
+        end: z.ZodOptional<z.ZodBoolean>;
+        place: z.ZodOptional<z.ZodEnum<{
+            top: "top";
+            middle: "middle";
+            bottom: "bottom";
+        }>>;
         parts: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<z.core.$ZodLooseShape, z.core.$strip>, ...z.ZodObject<z.core.$ZodLooseShape, z.core.$strip>[]], "type">>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
-/** Every section the kit draws, by the type a block names. */
+/**
+ * Every section the kit draws, by the type a block names. `built`: a tree of elements styled with
+ * Tailwind, made in CalOS's editor or by Cal (../tree, cal-os docs/design/site-builder.md); `use`:
+ * one of the site's components (a tree kept once in the content's `components`) with its slots filled.
+ */
 export declare const sections: {
     readonly gallery: z.ZodObject<{
         heading: z.ZodOptional<z.ZodString>;
@@ -173,12 +307,14 @@ export declare const sections: {
         }, z.core.$strip>>;
         shape: z.ZodDefault<z.ZodEnum<{
             square: "square";
-            wide: "wide";
             landscape: "landscape";
+            wide: "wide";
         }>>;
         seconds: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strip>;
     readonly own: z.ZodObject<{
+        heading: z.ZodOptional<z.ZodString>;
+        intro: z.ZodOptional<z.ZodString>;
         layout: z.ZodDefault<z.ZodEnum<{
             one: "one";
             two: "two";
@@ -192,13 +328,53 @@ export declare const sections: {
             center: "center";
         }>>;
         tone: z.ZodDefault<z.ZodEnum<{
-            brand: "brand";
+            dark: "dark";
+            soft: "soft";
             plain: "plain";
+            brand: "brand";
+        }>>;
+        shape: z.ZodDefault<z.ZodEnum<{
+            card: "card";
+            band: "band";
         }>>;
+        spacing: z.ZodDefault<z.ZodEnum<{
+            normal: "normal";
+            roomy: "roomy";
+            tight: "tight";
+        }>>;
+        background: z.ZodOptional<z.ZodObject<{
+            src: z.ZodString;
+            alt: z.ZodString;
+        }, z.core.$strip>>;
         columns: z.ZodArray<z.ZodObject<{
+            card: z.ZodOptional<z.ZodBoolean>;
+            end: z.ZodOptional<z.ZodBoolean>;
+            place: z.ZodOptional<z.ZodEnum<{
+                top: "top";
+                middle: "middle";
+                bottom: "bottom";
+            }>>;
             parts: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<z.core.$ZodLooseShape, z.core.$strip>, ...z.ZodObject<z.core.$ZodLooseShape, z.core.$strip>[]], "type">>;
         }, z.core.$strip>>;
     }, z.core.$strip>;
+    readonly built: z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        root: z.ZodType<import("../tree/index.ts").Node, unknown, z.core.$ZodTypeInternals<import("../tree/index.ts").Node, unknown>>;
+    }, z.core.$strip>;
+    readonly use: z.ZodObject<{
+        component: z.ZodString;
+        slots: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+            text: z.ZodOptional<z.ZodString>;
+            href: z.ZodOptional<z.ZodString>;
+            image: z.ZodOptional<z.ZodObject<{
+                src: z.ZodString;
+                alt: z.ZodDefault<z.ZodString>;
+                phoneSrc: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>;
 };
 export type KitSectionType = keyof typeof sections;
 export declare const isKitSection: (type: string) => type is KitSectionType;
+/** Ready-made sections of the business's own, to add and then edit like any other (./presets.ts). */
+export { presets, type OwnBlock, type Preset } from "./presets.ts";