@codepress/design-kit 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,11 @@
+Proprietary License
+
+Copyright (c) 2025 Codepress
+
+All rights reserved.
+
+This software and associated documentation files (the "Software") are the proprietary property of Codepress. Use of the Software is governed by the license agreement that you entered into with Codepress.
+
+Unauthorized copying, distribution, modification, public display, public performance, or creation of derivative works of the Software or any part thereof is strictly prohibited. This includes, but is not limited to, integrating or using the Software with third-party services without explicit permission from Codepress.
+
+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

@@ -1,3 +1,229 @@
-# Temporary Holding Version
+# @codepress/design-kit
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Your app's real markup for mockups. `design-kit` renders every Storybook story
+and the pages of your running app to static HTML, with the CSS and fonts they
+loaded. The result is a design kit: a folder of snippets and a small,
+dependency-free tool that finds them and composes self-contained pages from
+them. A mockup built from a kit uses the app's own frame and components, so
+you draw only what is new.
+
+```bash
+npm install --save-dev @codepress/design-kit @playwright/test
+npx playwright install chromium
+npx design-kit capture stories      # every story → ./design-kit (or "out")
+npx design-kit capture pages        # the configured pages of the running app
+node design-kit/kit.mjs find button # the kit's own tool, no install needed
+```
+
+It runs on Node 20 or later. Playwright is a peer dependency, so the capture
+drives the Playwright and Chromium your project already has. The `kit`
+commands need neither.
+
+## Configuration
+
+The commands read `design-kit.config.json` from the working directory or the
+nearest folder above it; `--config <file>` names another. Paths are relative
+to the config's folder. The shipped JSON schema
+([`schema/design-kit.config.schema.json`](./schema/design-kit.config.schema.json),
+also `@codepress/design-kit/schema.json`) documents every field, and
+`design-kit validate` checks a config against it. A config error, such as an
+unknown key or a page without `slots.main`, names the field and exits 2.
+
+```json
+{
+  "$schema": "./node_modules/@codepress/design-kit/schema/design-kit.config.schema.json",
+  "version": 1,
+  "out": "design-kit",
+  "theme": { "attribute": "data-theme", "dark": "dark", "light": "light" },
+  "stories": {
+    "root": ".",
+    "buildCommand": "npx storybook build --quiet -o storybook-static",
+    "staticDir": "storybook-static",
+    "widths": [{ "titles": "^(Pages|Layout)/", "width": 390, "height": 844 }],
+    "gaps": { "componentGlob": "src/components/**/[A-Z]*.tsx" }
+  },
+  "pages": {
+    "startCommand": "npm run preview -- --port 4173",
+    "waitUrl": "http://localhost:4173/",
+    "auth": { "storageState": "e2e/.auth/user.json" },
+    "shellReady": "#app-header",
+    "forbidStrings": ["the test account's API token"],
+    "pages": [
+      {
+        "name": "dashboard",
+        "title": "Dashboard",
+        "path": "/dashboard",
+        "ready": "[data-testid=dashboard-chart]",
+        "sourceFile": "src/routes/dashboard.tsx",
+        "slots": { "main": ["main"], "list": ["aside nav"] }
+      }
+    ]
+  }
+}
+```
+
+### `theme`
+
+How the app switches to dark: a class (`"attribute": "class"`, the default,
+`dark` on `<html>` and `<body>`) or an attribute such as `data-theme` on
+`<html>`. Leave `light` out when light is simply the dark value's absence. The
+captures record the theme in the kit's manifest, so `kit compose --theme dark`
+needs no config.
+
+### `stories`
+
+Captures every story of a Storybook 7 or 8 static build (any renderer). The
+build comes from `--storybook-dir`, `storybookDir`, or `buildCommand`, which
+writes `staticDir`; without `staticDir`, `{out}` in the command names a
+temporary folder that is removed afterwards.
+
+- `viewport`: each story's first capture, unless the story sets
+  `parameters.viewport.defaultViewport` (default 1280×800).
+- `widths`: more captures for stories whose title matches the `titles`
+  regular expression.
+- `fonts`: `{dir, faces: [{family, file, weight?, style?, variable?,
+fallback?}]}` gives every story these faces (`file` is a name glob in `dir`;
+  `variable` sets a CSS variable on `:root` for apps that read their font from
+  one). Without it, the @font-face files the build itself serves are copied
+  into the kit.
+- `fixedTime`: the instant `Date` returns (default `2026-01-01T12:00:00.000Z`).
+- `gaps`: lists the component files no story covers in `gaps.json`.
+  `componentGlob` is relative to `root`; stories, tests and specs never count.
+
+### `pages`
+
+Captures real pages of the running app at `baseUrl`, or starts it with
+`startCommand` (stopped afterwards) once `waitUrl` answers. Each page gets a
+fresh browser context, signed in from `auth.storageState` (a Playwright
+storage state file) or from the state the `auth.setup` module's default
+export returns (`async ({ browser, baseUrl, config }) => state`).
+
+- `pages[]`: `{name, title?, path, ready, sourceFile?, slots, layoutSlots?}`.
+  `ready` is a Playwright selector that shows once the page has its content.
+  `slots` names the regions a mockup replaces: the first selector that matches
+  a visible, non-empty element gets `data-kit-slot="<name>"`, and `main` is
+  required. A page without a `main` slot is a gap, not a frame.
+- `widths`: the sizes every page is captured at (default 1280×800 and 390×844).
+- `shellReady`: a selector the app's frame shows before any page content.
+- `layout`: `{selector, attribute, default?}` reads the layout the app chose,
+  for apps that render a different frame at phone width; `layoutSlots[<that
+value>]` then replaces `slots`.
+- `forbidStrings`: values that must never reach the kit, such as a test
+  account's token. A page whose output contains one, as written, escaped for
+  HTML or JSON, or (for a token) any long segment of it, is not written.
+- `fontsPath`, `copyFonts`: the fonts the pages load are copied into the
+  kit's `fonts/` folder (`copyFonts: false` keeps them out); `fontsPath` says
+  which URL path holds them when not every font file is one.
+- `hooks`: a module exporting `context(context, info)` (may return a cleanup)
+  and `page(page, info)` (may return `{readyFailed, beforeSerialize}`), for
+  routing mock data or adding checks.
+- `timeoutMs`, `startTimeoutMs`, `fixedTime`.
+
+## Commands
+
+```bash
+design-kit capture stories [--config f] [--out dir] [--storybook-dir dir]
+                           [--only id,... | --only-file f] [--base previous-kit]
+design-kit capture pages   [--config f] [--out dir] [--base-url url] [--only name,...]
+                           [--ready name=selector] [--screenshots dir] [--timeout ms]
+design-kit kit info|find|show|compose ...   [--kit dir]
+design-kit validate        [--config f]
+```
+
+`--only` re-captures just those stories (Storybook ids, with or without the
+`story:` prefix and width) and copies every other row from `--base`, byte for
+byte. The two captures share one kit folder and keep each other's files: run
+both with the same `--out`.
+
+Exit codes: 0 done, 1 a capture could not run (no Storybook build, the app
+did not start), 2 a config or usage error. A story or page that fails is a
+`gaps.json` row and does not fail the run.
+
+Operational knobs: `DESIGN_KIT_CONCURRENCY` (browser pages at once, default
+4), `DESIGN_KIT_STORY_TIMEOUT_MS` (render and, separately, settle budget per
+story, default 15000), `DESIGN_KIT_QUIET_MS` (how long the DOM must stay
+unchanged, default 600), `DESIGN_KIT_TIMINGS_FILE` (per-phase capture times),
+`DESIGN_KIT_STOP_TIMEOUT_MS` (how long stopping the app may take).
+
+## Capture rules
+
+- Time is frozen at `fixedTime`, the time zone is UTC, the locale en-US,
+  `Math.random` and `crypto` random values are seeded, and animations,
+  transitions and the caret are off.
+- A story is captured after Storybook's `storyRendered` event (its `play`
+  function has finished), fonts, frame and image loads, no request in flight,
+  and six frames plus `DESIGN_KIT_QUIET_MS` with no DOM change. A story that
+  throws, never renders or never stops changing is a gap.
+- Attributes are serialized in sorted order, and React `useId` values are
+  renumbered in pages, so the markup depends on the final state, not on timing.
+- Story captures only reach the local Storybook server. Same-origin images
+  become data URIs, canvases become images, iframes lose their documents, and
+  form state is written into attributes.
+
+## The kit (`kit_version: 1`)
+
+```
+design-kit/
+  manifest.json   {kit_version, sha, built_at, counts, sources, theme?, css?}
+  index.json      story rows, sorted by id
+  routes.json     page rows
+  html/story--<id>@<w>.html, html/route--<name>@<w>.html
+  css/stories.css every rule the Storybook preview loaded, deduplicated
+  css/routes.css  every rule the captured pages loaded, deduplicated
+  fonts/          the fonts both use
+  gaps.json       [{id|component|route, reason, detail?}]
+  kit.mjs         the tool, copied into every kit so tool and data match
+```
+
+A row is `{id, kind: "story"|"route", title, component?, file, width, height,
+bytes, slots?, source_file?, body_class?, html_attrs?, body_attrs?}`. Ids are
+`story:<storybook-id>@<width>` and `route:<name>@<width>`; file names use `--`
+instead of `:`, so the kit uploads as a CI artifact as it is. Always find a
+row's markup through its `file`. `manifest.css` may name another stylesheet
+per source (`{stories, routes}`).
+
+## `kit.mjs`
+
+The tool needs only Node: no install and no network.
+
+```bash
+node kit.mjs info                    # the manifest
+node kit.mjs find button             # ≤ 30 lines: id, kind, width, bytes, title
+node kit.mjs show <id> [--full]      # path, size and an outline (≤ 2 KB) or the markup
+node kit.mjs compose --frame route:dashboard@1280 --slot main=new.html \
+  [--theme light|dark] [--show-new] --out page.html
+```
+
+`compose` writes one self-contained page: the frame's markup with slots
+filled and every `<kit-snippet id="…">` expanded, its CSS inlined, every
+relative `url()` that names a file in the kit (fonts included) as a data URI,
+and `data-kit-sha`/`data-kit-id` on `<html>`. Scripts, event handlers,
+`<link>`s and SVG animation are removed, and URLs pass an allowlist: only
+relative references, fragments and `data:` survive, read the way the browser
+reads them. `--theme dark` applies the manifest's theme. Elements marked
+`data-kit-new` get a visible outline with `--show-new`. An unknown frame, slot
+or snippet id exits 2, naming near matches. `--kit <dir>` (or
+`DESIGN_KIT_DIR`) points at a kit other than the tool's own folder.
+
+## Programmatic use
+
+```js
+import {
+  capturePages,
+  captureStories,
+  loadConfig,
+} from "@codepress/design-kit";
+
+const config = loadConfig("design-kit.config.json");
+await captureStories(config, { out: "design-kit" });
+await capturePages(config, {
+  out: "design-kit",
+  baseUrl: "http://localhost:4173",
+  storageState: await signIn(),
+  hooks: { context: (context) => context.route("**/api/**", mockApi) },
+});
+```
+
+`capturePages` also takes `forbidStrings` and `stripOrigins` (more origins to
+remove from markup, such as a mock API's) and a `session` object whose
+`interrupted` flag stops it between pages.

package/bin/design-kit.mjs

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { main } from "../src/cli.mjs";
+
+process.exitCode = await main();

package/package.json

@@ -1,6 +1,68 @@
 {
   "name": "@codepress/design-kit",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Capture your Storybook and real app pages as a static design kit, and compose self-contained mockups from it",
+  "type": "module",
+  "bin": {
+    "design-kit": "./bin/design-kit.mjs"
+  },
+  "main": "./src/index.mjs",
+  "types": "./src/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./src/index.d.ts",
+      "default": "./src/index.mjs"
+    },
+    "./kit": "./src/kit.mjs",
+    "./schema.json": "./schema/design-kit.config.schema.json",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "schema/",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "test": "TZ=UTC LC_ALL=en_US.UTF-8 node ../../scripts/test-with-deadline.mjs node --test 'test/*.test.mjs'",
+    "test:browser": "node ../../scripts/capacity-browser.mjs -- \"node --test 'test/browser/*.test.mjs'\"",
+    "lint": "oxlint --ignore-pattern 'test/fixtures/**' .",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "pack:check": "node scripts/check-pack.mjs"
+  },
+  "peerDependencies": {
+    "@playwright/test": ">=1.40.0"
+  },
+  "peerDependenciesMeta": {
+    "@playwright/test": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@playwright/test": "1.58.2",
+    "oxlint": "^1.51.0",
+    "prettier": "^3.8.1"
+  },
+  "keywords": [
+    "design-kit",
+    "storybook",
+    "mockups",
+    "playwright",
+    "design-system"
+  ],
+  "author": "CodePress",
+  "license": "SEE LICENSE IN LICENSE",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/quantfive/codepress.git",
+    "directory": "packages/design-kit"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/schema/design-kit.config.schema.json

@@ -0,0 +1,335 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://unpkg.com/@codepress/design-kit/schema/design-kit.config.schema.json",
+  "title": "design-kit.config.json",
+  "description": "Version 1 of the @codepress/design-kit configuration. Paths are relative to the folder that holds the config file.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["version"],
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "The schema an editor validates this file against."
+    },
+    "version": {
+      "type": "integer",
+      "enum": [1],
+      "description": "The config format version. Always 1."
+    },
+    "out": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Where captures write the kit when --out is not given."
+    },
+    "theme": { "$ref": "#/$defs/theme" },
+    "stories": { "$ref": "#/$defs/stories" },
+    "pages": { "$ref": "#/$defs/pages" }
+  },
+  "$defs": {
+    "size": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["width", "height"],
+      "properties": {
+        "width": { "type": "integer", "minimum": 1 },
+        "height": { "type": "integer", "minimum": 1 }
+      }
+    },
+    "theme": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "How the app switches to its dark theme. Recorded in the kit's manifest, so `kit compose --theme dark` needs no config.",
+      "properties": {
+        "attribute": {
+          "type": "string",
+          "minLength": 1,
+          "description": "\"class\" (default) toggles a class; any other value is an attribute, such as \"data-theme\"."
+        },
+        "dark": {
+          "type": "string",
+          "minLength": 1,
+          "description": "The class or attribute value for dark. Default \"dark\"."
+        },
+        "light": {
+          "type": "string",
+          "minLength": 1,
+          "description": "The class or attribute value for light. Leave it out when light is the dark value's absence."
+        },
+        "targets": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "type": "string", "enum": ["html", "body"] },
+          "description": "The elements that carry the value. Default [\"html\", \"body\"] for a class, [\"html\"] for an attribute."
+        }
+      }
+    },
+    "stories": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "`design-kit capture stories`: every story of a Storybook 7 or 8 static build.",
+      "properties": {
+        "root": {
+          "type": "string",
+          "minLength": 1,
+          "description": "The Storybook project folder (where its .storybook folder is). Default \".\"."
+        },
+        "storybookDir": {
+          "type": "string",
+          "minLength": 1,
+          "description": "An existing static build to capture. --storybook-dir overrides it."
+        },
+        "buildCommand": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Builds the static Storybook, run in `root`. `{out}` is replaced by a temporary folder when `staticDir` is not set."
+        },
+        "staticDir": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Where `buildCommand` writes the build (for example storybook-static)."
+        },
+        "viewport": {
+          "$ref": "#/$defs/size",
+          "description": "Every story's first capture, unless it declares parameters.viewport.defaultViewport. Default 1280x800."
+        },
+        "widths": {
+          "type": "array",
+          "description": "More captures for stories whose title matches `titles`.",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["titles", "width", "height"],
+            "properties": {
+              "titles": {
+                "type": "string",
+                "minLength": 1,
+                "description": "A regular expression tested against the story's title, such as \"^(Pages|Layout)/\"."
+              },
+              "width": { "type": "integer", "minimum": 1 },
+              "height": { "type": "integer", "minimum": 1 }
+            }
+          }
+        },
+        "fonts": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["dir", "faces"],
+          "description": "Faces every story is given. Without it, the @font-face files the Storybook build serves are copied into the kit.",
+          "properties": {
+            "dir": {
+              "type": "string",
+              "minLength": 1,
+              "description": "The folder that holds the font files."
+            },
+            "faces": {
+              "type": "array",
+              "minItems": 1,
+              "items": {
+                "type": "object",
+                "additionalProperties": false,
+                "required": ["family", "file"],
+                "properties": {
+                  "family": { "type": "string", "minLength": 1 },
+                  "file": {
+                    "type": "string",
+                    "minLength": 1,
+                    "description": "A file name glob in `dir`, such as \"inter-latin.*.woff2\"; the first match in sorted order is used."
+                  },
+                  "weight": {
+                    "type": "string",
+                    "minLength": 1,
+                    "description": "The font-weight descriptor, such as \"400\" or \"100 900\"."
+                  },
+                  "style": { "type": "string", "minLength": 1 },
+                  "variable": {
+                    "type": "string",
+                    "pattern": "^--[A-Za-z0-9_-]+$",
+                    "description": "A CSS variable on :root set to this family, for apps that read their font from one."
+                  },
+                  "fallback": {
+                    "type": "string",
+                    "minLength": 1,
+                    "description": "The fallback list after the family in `variable`."
+                  }
+                }
+              }
+            }
+          }
+        },
+        "fixedTime": {
+          "type": "string",
+          "minLength": 1,
+          "description": "The instant every story reads from Date (ISO 8601). Default 2026-01-01T12:00:00.000Z."
+        },
+        "gaps": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["componentGlob"],
+          "description": "Lists component files that no story covers in gaps.json.",
+          "properties": {
+            "sourceRoot": {
+              "type": "string",
+              "minLength": 1,
+              "description": "The folder to scan. Default `root`."
+            },
+            "componentGlob": {
+              "type": "string",
+              "minLength": 1,
+              "description": "Component files, as a glob relative to `root`, such as \"src/**/[A-Z]*.tsx\". Stories, tests and specs never count."
+            }
+          }
+        }
+      }
+    },
+    "slots": {
+      "type": "object",
+      "required": ["main"],
+      "description": "Replaceable regions, by name: the first selector that matches a visible, non-empty element marks it with data-kit-slot. `main` is required.",
+      "properties": {
+        "main": { "$ref": "#/$defs/selectors" }
+      },
+      "additionalProperties": { "$ref": "#/$defs/selectors" }
+    },
+    "selectors": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "page": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name", "path", "ready", "slots"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "pattern": "^[a-z0-9][a-z0-9-]*$",
+          "description": "The page's id in the kit: route:<name>@<width>."
+        },
+        "title": { "type": "string", "minLength": 1 },
+        "path": {
+          "type": "string",
+          "pattern": "^/",
+          "description": "The URL path, from baseUrl."
+        },
+        "ready": {
+          "type": "string",
+          "minLength": 1,
+          "description": "A Playwright selector that is visible once the page has rendered its content."
+        },
+        "sourceFile": {
+          "type": "string",
+          "minLength": 1,
+          "description": "The page's source module, shown by `kit show` and searched by `kit find`."
+        },
+        "slots": { "$ref": "#/$defs/slots" },
+        "layoutSlots": {
+          "type": "object",
+          "description": "Slots for a layout the detector reports, replacing `slots` there.",
+          "additionalProperties": { "$ref": "#/$defs/slots" }
+        }
+      }
+    },
+    "pages": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["pages"],
+      "description": "`design-kit capture pages`: real pages of the running app, through Playwright.",
+      "properties": {
+        "baseUrl": {
+          "type": "string",
+          "pattern": "^https?://",
+          "description": "The running app. Without it, `startCommand` starts the app and `waitUrl` says when it serves."
+        },
+        "startCommand": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Starts the app (run in `cwd`); it is stopped when the capture ends."
+        },
+        "waitUrl": {
+          "type": "string",
+          "pattern": "^https?://",
+          "description": "Polled until it answers; its origin is the base URL unless baseUrl is set."
+        },
+        "cwd": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Where `startCommand` runs. Default the config's folder."
+        },
+        "startTimeoutMs": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "How long `waitUrl` may take to answer. Default 120000."
+        },
+        "auth": {
+          "type": "object",
+          "additionalProperties": false,
+          "description": "Signs the browser in: a Playwright storageState file, or a setup module whose default export returns one.",
+          "properties": {
+            "storageState": { "type": "string", "minLength": 1 },
+            "setup": { "type": "string", "minLength": 1 }
+          }
+        },
+        "hooks": {
+          "type": "string",
+          "minLength": 1,
+          "description": "A module exporting optional `context(context, info)` and `page(page, info)` hooks."
+        },
+        "widths": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "$ref": "#/$defs/size" },
+          "description": "Every page is captured at each size. Default 1280x800 and 390x844."
+        },
+        "fixedTime": {
+          "type": "string",
+          "minLength": 1,
+          "description": "The instant every page reads from Date (ISO 8601). Default 2026-01-01T12:00:00.000Z."
+        },
+        "shellReady": {
+          "type": "string",
+          "minLength": 1,
+          "description": "A selector the app's frame shows before any page content."
+        },
+        "layout": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["selector", "attribute"],
+          "description": "Reads the layout the app chose (an attribute of one element), which picks `layoutSlots`.",
+          "properties": {
+            "selector": { "type": "string", "minLength": 1 },
+            "attribute": { "type": "string", "minLength": 1 },
+            "default": {
+              "type": "string",
+              "minLength": 1,
+              "description": "The layout when the attribute is absent. Default \"default\"."
+            }
+          }
+        },
+        "fontsPath": {
+          "type": "string",
+          "pattern": "^/",
+          "description": "The app's font URL path, such as \"/fonts/\". Without it, any .woff2/.woff/.ttf/.otf URL is a font."
+        },
+        "copyFonts": {
+          "type": "boolean",
+          "description": "Copy the fonts the pages load into the kit's fonts folder. Default true."
+        },
+        "timeoutMs": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "How long a page may take to show its ready selector. Default 30000."
+        },
+        "forbidStrings": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 },
+          "description": "Values that must never reach the kit, such as a test account's token. A page whose output holds one, as written or escaped, is not written."
+        },
+        "pages": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "$ref": "#/$defs/page" }
+        }
+      }
+    }
+  }
+}