themelia-ui 1.0.0

package/dist/value-inputs-okQ1S7CX.js

@@ -0,0 +1,634 @@
+import "./css/value-inputs.css";
+import { t as e } from "./cx--CBrhWH0.js";
+import { o as t } from "./typography-vC_wwEBm.js";
+import { o as n } from "./structure-es_UqqmD.js";
+import { d as r, l as i } from "./text-inputs-BMW3hP0R.js";
+import { s as a } from "./choice-inputs-B4fseaKf.js";
+import { d as o, l as s } from "./date-pickers-BpGrG0Bf.js";
+import { XIcon as c } from "lucide-react";
+import * as l from "react";
+import { forwardRef as u, useCallback as d, useId as f, useMemo as p, useRef as m, useState as h } from "react";
+import { jsx as g, jsxs as _ } from "react/jsx-runtime";
+import { Slider as v } from "@base-ui/react/slider";
+import { converter as y, formatHsl as b, formatRgb as x, parse as S } from "culori";
+//#region src/components/base/value-inputs/value-inputs.strings.ts
+var C = { thumb: (e) => e === 0 ? "Minimum" : "Maximum" }, w = {
+	...r,
+	picker: "Choose a colour"
+}, T = {
+	...r,
+	prefixPlaceholder: "Code",
+	prefix: "Country dial code"
+}, E = {
+	...r,
+	clearAll: "Clear all",
+	removeTag: (e) => `Remove ${e}`,
+	placeholder: "Add a tag…"
+}, D = {
+	light: "value-inputs-module__light___M1hh5",
+	dark: "value-inputs-module__dark___XkXAu",
+	sliderRoot: "value-inputs-module__sliderRoot___8UVRH",
+	slider: "value-inputs-module__slider___gbJep",
+	sliderControl: "value-inputs-module__sliderControl___QNDs6",
+	sliderThumb: "value-inputs-module__sliderThumb___pF1Ge",
+	sliderTrack: "value-inputs-module__sliderTrack___v5k5z",
+	sliderRange: "value-inputs-module__sliderRange___geP1n",
+	sliderMd: "value-inputs-module__sliderMd___BFHAo",
+	sliderValue: "value-inputs-module__sliderValue___F9dvE",
+	tagsShell: "value-inputs-module__tagsShell___i9O7u",
+	tag: "value-inputs-module__tag___jBDW9",
+	tagRemove: "value-inputs-module__tagRemove___WLOIP",
+	tagsInput: "value-inputs-module__tagsInput___AOelM",
+	tagsFooter: "value-inputs-module__tagsFooter___5ZZpQ",
+	tagsOverLimit: "value-inputs-module__tagsOverLimit___d1j0T",
+	tagsClear: "value-inputs-module__tagsClear___fwGsG",
+	colorRoot: "value-inputs-module__colorRoot___07PzX",
+	colorPicker: "value-inputs-module__colorPicker___ZOUGw",
+	colorSwatch: "value-inputs-module__colorSwatch___r3oy-",
+	colorNative: "value-inputs-module__colorNative___BwAHM",
+	colorText: "value-inputs-module__colorText___nr3lE",
+	phoneRoot: "value-inputs-module__phoneRoot___GWtg-",
+	phonePrefix: "value-inputs-module__phonePrefix___9MwfE",
+	phoneNumber: "value-inputs-module__phoneNumber___Idvj4",
+	phoneIso: "value-inputs-module__phoneIso___ZogpD"
+}, O = u(function({ name: n, id: r, value: i, defaultValue: a, min: o = 0, max: s = 100, step: c = 1, disabled: l = !1, invalid: u = !1, orientation: m = "horizontal", size: h = "sm", onChange: y, onValueChange: b, onValueCommitted: x, showValue: S = !1, formatValue: w, unit: T, className: E, "aria-label": O = "Value", "aria-labelledby": k, "aria-describedby": A, strings: j }, M) {
+	let N = {
+		...C,
+		...j
+	}, P = f(), F = r ?? P, I = n ?? F, L = i ?? a, R = Array.isArray(L), z = (e, t) => e === void 0 ? [t] : Array.isArray(e) ? e : [e], B = p(() => z(L, o), [L, o]), V = (e) => {
+		let t = Array.isArray(e) ? [...e] : [e];
+		return R ? t : t[0];
+	}, H = d((e) => {
+		let t = V(e);
+		b?.(t), y?.({ target: {
+			name: I,
+			value: t
+		} });
+	}, [
+		y,
+		b,
+		I,
+		R
+	]), U = d((e) => x?.(V(e)), [x, R]), W = p(() => S ? B.map((e) => w ? w(e) : T ? `${e}${T}` : String(e)).join("–") : null, [
+		S,
+		B,
+		w,
+		T
+	]);
+	return /* @__PURE__ */ _("div", {
+		"data-size": h,
+		className: e("slider--component", D.sliderRoot, h === "md" && D.sliderMd, E),
+		children: [/* @__PURE__ */ g(v.Root, {
+			ref: M,
+			id: F,
+			"aria-label": k ? void 0 : O,
+			"aria-labelledby": k,
+			"aria-describedby": A,
+			"aria-invalid": u || void 0,
+			value: i === void 0 ? void 0 : z(i, o),
+			defaultValue: z(a, o),
+			min: o,
+			max: s,
+			step: c,
+			disabled: l,
+			orientation: m,
+			onValueChange: H,
+			onValueCommitted: U,
+			className: D.slider,
+			children: /* @__PURE__ */ _(v.Control, {
+				className: D.sliderControl,
+				children: [/* @__PURE__ */ g(v.Track, {
+					className: D.sliderTrack,
+					children: /* @__PURE__ */ g(v.Indicator, { className: D.sliderRange })
+				}), B.map((e, t) => /* @__PURE__ */ g(v.Thumb, {
+					index: t,
+					getAriaLabel: () => R ? N.thumb(t) : O,
+					className: D.sliderThumb
+				}, t))]
+			})
+		}), S && W !== null && /* @__PURE__ */ g(t, {
+			tag: "span",
+			size: "inherit",
+			type: u ? "error" : "secondary",
+			className: D.sliderValue,
+			children: W
+		})]
+	});
+}), k = u(function(e, t) {
+	return /* @__PURE__ */ g(O, {
+		ref: t,
+		...e
+	});
+}), A = [];
+function j({ value: t, defaultValue: n, onValueChange: r, placeholder: i, disabled: a = !1, invalid: o = !1, name: s, maxTags: l, showCount: u = !1, showClearAll: f = !1, strings: v, allowDuplicates: y = !1, caseSensitive: b = !1, sortTags: x = !1, minLength: S = 1, maxLength: C, validate: w, delimiter: T = /[\n,]/, addOnBlur: O = !0, renderTag: k, className: j, id: M, "aria-label": N, "aria-labelledby": P, "aria-describedby": F, "aria-invalid": I }) {
+	let L = {
+		...E,
+		...v
+	}, R = t !== void 0, [z, B] = h(n ?? []), V = R ? t ?? A : z, [H, U] = h(""), W = m(null), G = d((e) => {
+		R || B(e), r?.(e);
+	}, [R, r]), K = d((e, t) => {
+		if (b) return t.includes(e);
+		let n = e.toLowerCase();
+		return t.some((e) => e.toLowerCase() === n);
+	}, [b]), q = d((e) => {
+		let t = [...V];
+		for (let n of e) {
+			let e = n.trim();
+			if (e && !(e.length < S) && !(C !== void 0 && e.length > C)) {
+				if (l !== void 0 && t.length >= l) break;
+				!y && K(e, t) || w && !w(e) || t.push(e);
+			}
+		}
+		return t.length !== V.length && (x && (t = t.sort((e, t) => e.localeCompare(t))), G(t), !0);
+	}, [
+		y,
+		G,
+		K,
+		C,
+		l,
+		S,
+		x,
+		V,
+		w
+	]), J = d((e) => G(V.filter((t, n) => n !== e)), [G, V]), Y = (e) => {
+		if (e.key === "Enter") {
+			e.preventDefault(), q([H]) && U("");
+			return;
+		}
+		e.key === "Backspace" && H === "" && V.length > 0 && (e.preventDefault(), J(V.length - 1));
+	}, X = (e) => {
+		let t = e.clipboardData.getData("text");
+		if (!t) return;
+		let n = t.split(T);
+		n.length <= 1 || (e.preventDefault(), q(n), U(""));
+	}, Z = l !== void 0 && V.length >= l, Q = u && l !== void 0 || f && V.length > 0, $ = p(() => l === void 0 ? null : `${V.length} / ${l}`, [l, V.length]);
+	return /* @__PURE__ */ _("div", {
+		className: e("tags-input--component", j),
+		children: [
+			!!s && V.map((e) => /* @__PURE__ */ g("input", {
+				type: "hidden",
+				name: `${s}[]`,
+				value: e
+			}, e)),
+			/* @__PURE__ */ _("div", {
+				"data-field-shell": "",
+				"aria-invalid": o || I || void 0,
+				className: D.tagsShell,
+				onClick: () => W.current?.focus(),
+				children: [V.map((e, t) => k ? k(e, t, J) : /* @__PURE__ */ _("span", {
+					className: D.tag,
+					children: [e, /* @__PURE__ */ g("button", {
+						type: "button",
+						"data-hit-area": !0,
+						className: D.tagRemove,
+						"aria-label": L.removeTag(e),
+						disabled: a,
+						onClick: (e) => {
+							e.stopPropagation(), J(t);
+						},
+						children: /* @__PURE__ */ g(c, { "aria-hidden": !0 })
+					})]
+				}, `${e}-${t}`)), /* @__PURE__ */ g("input", {
+					ref: W,
+					id: M,
+					"data-field-control": "",
+					className: D.tagsInput,
+					value: H,
+					placeholder: V.length === 0 ? i : void 0,
+					disabled: a || Z,
+					"aria-label": N,
+					"aria-labelledby": P,
+					"aria-describedby": F,
+					"aria-invalid": o || I || void 0,
+					onChange: (e) => U(e.target.value),
+					onKeyDown: Y,
+					onPaste: X,
+					onBlur: () => {
+						O && q([H]) && U("");
+					}
+				})]
+			}),
+			Q && /* @__PURE__ */ _("div", {
+				className: D.tagsFooter,
+				children: [/* @__PURE__ */ g("span", {
+					className: e(Z && D.tagsOverLimit),
+					children: u ? $ : null
+				}), f && V.length > 0 && /* @__PURE__ */ g("button", {
+					type: "button",
+					"data-hit-area": !0,
+					className: D.tagsClear,
+					onClick: () => G([]),
+					disabled: a,
+					children: L.clearAll
+				})]
+			})
+		]
+	});
+}
+//#endregion
+//#region src/components/base/value-inputs/color-input.tsx
+function M(e) {
+	let t = e.trim().toLowerCase();
+	return /^#[0-9a-f]{6}$/.test(t) ? t : /^#[0-9a-f]{3}$/.test(t) ? `#${t.slice(1).split("").map((e) => `${e}${e}`).join("")}` : null;
+}
+function N(e, t) {
+	let n = Number(e.toFixed(t));
+	return Object.is(n, -0) ? 0 : n;
+}
+var P = y("oklch");
+function F(e, t) {
+	if (t === "hex") return e;
+	let n = S(e);
+	if (!n) return e;
+	if (t === "rgb") return x(n) ?? e;
+	if (t === "hsl") return b(n) ?? e;
+	let r = P(n);
+	return r ? `oklch(${N(r.l, 4)} ${N(r.c, 4)} ${N(r.h ?? 0, 2)})` : e;
+}
+function I(e, t) {
+	let n = window.getComputedStyle(e).backgroundColor;
+	if (!n) return t;
+	let r = document.createElement("canvas");
+	r.width = 1, r.height = 1;
+	let i = r.getContext("2d", { willReadFrequently: !0 });
+	if (!i) return t;
+	i.fillStyle = "#000000", i.fillStyle = n;
+	let a = i.fillStyle;
+	if (i.fillStyle = "#ffffff", i.fillStyle = n, a !== i.fillStyle) return t;
+	i.clearRect(0, 0, 1, 1), i.fillRect(0, 0, 1, 1);
+	let [o, s, c, l] = i.getImageData(0, 0, 1, 1).data;
+	if (l === 0) return t;
+	let u = (e) => e.toString(16).padStart(2, "0");
+	return `#${u(o ?? 0)}${u(s ?? 0)}${u(c ?? 0)}`;
+}
+var L = l.forwardRef(function({ className: t, value: n, defaultValue: r, onChange: a, onValueChange: o, previewValue: s, strings: c, format: u, emitHex: d = !1, disabled: f, readOnly: p, ...m }, h) {
+	let v = {
+		...w,
+		...c
+	}, [y, b] = l.useState(String(r ?? "")), x = n === void 0 ? y : String(n), S = s ?? x, C = l.useRef(null), [T, E] = l.useState(() => M(x) ?? "#000000");
+	l.useLayoutEffect(() => {
+		let e = M(S);
+		if (e) {
+			E(e);
+			return;
+		}
+		C.current && E((e) => I(C.current, e));
+	}, [S]);
+	let O = (e) => {
+		n === void 0 && b(e.target.value), a?.(e), o?.(e.target.value);
+	};
+	return /* @__PURE__ */ _("div", {
+		className: e("color-input--component", D.colorRoot, t),
+		children: [/* @__PURE__ */ _("label", {
+			className: D.colorPicker,
+			"data-disabled": f || p || void 0,
+			children: [/* @__PURE__ */ g("span", {
+				ref: C,
+				"aria-hidden": !0,
+				className: D.colorSwatch,
+				style: { background: S || "transparent" }
+			}), /* @__PURE__ */ g("input", {
+				type: "color",
+				className: D.colorNative,
+				value: T,
+				disabled: f || p,
+				"aria-label": v.picker,
+				onInput: (e) => {
+					let t = e.currentTarget.value, r = F(M(t) ?? t, u ?? (d ? "hex" : "oklch"));
+					n === void 0 && b(r), o?.(r);
+				}
+			})]
+		}), /* @__PURE__ */ g(i, {
+			...m,
+			ref: h,
+			value: x,
+			disabled: f,
+			readOnly: p,
+			onChange: O,
+			className: D.colorText
+		})]
+	});
+}), R = {
+	US: {
+		value: "+1",
+		label: "United States",
+		iso: "US"
+	},
+	CA: {
+		value: "+1",
+		label: "Canada",
+		iso: "CA"
+	},
+	AU: {
+		value: "+61",
+		label: "Australia",
+		iso: "AU"
+	},
+	BG: {
+		value: "+359",
+		label: "Bulgaria",
+		iso: "BG"
+	},
+	GR: {
+		value: "+30",
+		label: "Greece",
+		iso: "GR"
+	},
+	GB: {
+		value: "+44",
+		label: "United Kingdom",
+		iso: "GB"
+	},
+	DE: {
+		value: "+49",
+		label: "Germany",
+		iso: "DE"
+	},
+	FR: {
+		value: "+33",
+		label: "France",
+		iso: "FR"
+	},
+	IT: {
+		value: "+39",
+		label: "Italy",
+		iso: "IT"
+	},
+	ES: {
+		value: "+34",
+		label: "Spain",
+		iso: "ES"
+	},
+	NL: {
+		value: "+31",
+		label: "Netherlands",
+		iso: "NL"
+	},
+	BE: {
+		value: "+32",
+		label: "Belgium",
+		iso: "BE"
+	},
+	AT: {
+		value: "+43",
+		label: "Austria",
+		iso: "AT"
+	},
+	CH: {
+		value: "+41",
+		label: "Switzerland",
+		iso: "CH"
+	},
+	PL: {
+		value: "+48",
+		label: "Poland",
+		iso: "PL"
+	},
+	RO: {
+		value: "+40",
+		label: "Romania",
+		iso: "RO"
+	},
+	RS: {
+		value: "+381",
+		label: "Serbia",
+		iso: "RS"
+	},
+	HR: {
+		value: "+385",
+		label: "Croatia",
+		iso: "HR"
+	},
+	SI: {
+		value: "+386",
+		label: "Slovenia",
+		iso: "SI"
+	},
+	MK: {
+		value: "+389",
+		label: "North Macedonia",
+		iso: "MK"
+	},
+	TR: {
+		value: "+90",
+		label: "Turkey",
+		iso: "TR"
+	},
+	RU: {
+		value: "+7",
+		label: "Russia",
+		iso: "RU"
+	},
+	UA: {
+		value: "+380",
+		label: "Ukraine",
+		iso: "UA"
+	},
+	SK: {
+		value: "+421",
+		label: "Slovakia",
+		iso: "SK"
+	},
+	CZ: {
+		value: "+420",
+		label: "Czech Republic",
+		iso: "CZ"
+	},
+	HU: {
+		value: "+36",
+		label: "Hungary",
+		iso: "HU"
+	},
+	PT: {
+		value: "+351",
+		label: "Portugal",
+		iso: "PT"
+	},
+	IE: {
+		value: "+353",
+		label: "Ireland",
+		iso: "IE"
+	},
+	SE: {
+		value: "+46",
+		label: "Sweden",
+		iso: "SE"
+	},
+	NO: {
+		value: "+47",
+		label: "Norway",
+		iso: "NO"
+	},
+	DK: {
+		value: "+45",
+		label: "Denmark",
+		iso: "DK"
+	},
+	FI: {
+		value: "+358",
+		label: "Finland",
+		iso: "FI"
+	},
+	CY: {
+		value: "+357",
+		label: "Cyprus",
+		iso: "CY"
+	},
+	AL: {
+		value: "+355",
+		label: "Albania",
+		iso: "AL"
+	},
+	ME: {
+		value: "+382",
+		label: "Montenegro",
+		iso: "ME"
+	},
+	BA: {
+		value: "+387",
+		label: "Bosnia and Herzegovina",
+		iso: "BA"
+	},
+	XK: {
+		value: "+383",
+		label: "Kosovo",
+		iso: "XK"
+	},
+	MD: {
+		value: "+373",
+		label: "Moldova",
+		iso: "MD"
+	},
+	BY: {
+		value: "+375",
+		label: "Belarus",
+		iso: "BY"
+	},
+	LT: {
+		value: "+370",
+		label: "Lithuania",
+		iso: "LT"
+	},
+	LV: {
+		value: "+371",
+		label: "Latvia",
+		iso: "LV"
+	},
+	EE: {
+		value: "+372",
+		label: "Estonia",
+		iso: "EE"
+	}
+}, z = [
+	"US",
+	"CA",
+	"GB",
+	"DE",
+	"FR",
+	"IT",
+	"ES",
+	"AU"
+];
+function B(e) {
+	return typeof e == "string" ? R[e.toUpperCase()] ?? null : e;
+}
+//#endregion
+//#region src/components/base/value-inputs/phone-input.tsx
+function V(e, t) {
+	let n = e.trim().replace(/\s+/g, " ").replace(/[^\d ()+-]/g, "");
+	return t && n.startsWith(t) && (n = n.slice(t.length).replace(/^[\s-]+/, "")), t && n.startsWith("0") && (n = n.slice(1)), n;
+}
+function H(e, t) {
+	return e ? e.startsWith("+") ? e : R[e.toUpperCase()]?.value ?? e : t[0]?.value ?? "";
+}
+var U = u(function({ prefix: t, defaultPrefix: n, onPrefixChange: r, prefixes: o = z, disablePrefixSelector: s = !1, strings: c, normalizeOnBlur: l = !0, showCountryName: u = !0, value: f, onChange: m, onBlur: v, disabled: y, invalid: b, className: x, ...S }, C) {
+	let w = {
+		...T,
+		...c
+	}, E = p(() => o.map(B).filter((e) => e !== null), [o]), O = t !== void 0, [k, A] = h(() => H(n, E)), j = O ? H(t, E) : k, M = d((e) => {
+		let t = e ?? "";
+		O || A(t), r?.(t);
+	}, [O, r]), N = p(() => E.map((e) => ({
+		value: e.iso,
+		label: e.value,
+		description: u ? e.label : void 0
+	})), [E, u]), P = p(() => E.find((e) => e.value === j)?.iso, [E, j]), F = (e) => {
+		if (l) {
+			let t = V(e.target.value, j);
+			t !== e.target.value && (e.target.value = t, m?.(e));
+		}
+		v?.(e);
+	};
+	return /* @__PURE__ */ _("div", {
+		className: e("phone-input--component", D.phoneRoot, x),
+		children: [!s && /* @__PURE__ */ g("div", {
+			className: D.phonePrefix,
+			children: /* @__PURE__ */ g(a, {
+				options: N,
+				value: P ?? null,
+				onValueChange: (e) => M(e ? R[e]?.value : void 0),
+				placeholder: w.prefixPlaceholder,
+				disabled: y,
+				invalid: b,
+				"aria-label": w.prefix
+			})
+		}), /* @__PURE__ */ g(i, {
+			...S,
+			ref: C,
+			type: "tel",
+			inputMode: "tel",
+			value: f,
+			onChange: m,
+			onBlur: F,
+			disabled: y,
+			"aria-invalid": b || S["aria-invalid"] || void 0,
+			className: D.phoneNumber
+		})]
+	});
+}), W = u(function({ id: t, value: r, onValueChange: i, placeholder: a, displayFormat: c, minuteStep: l = 15, withSeconds: u = !1, disabled: f, invalid: p, className: m }, h) {
+	let v = r ? new Date(r) : void 0, y = v && !Number.isNaN(v.getTime()) ? v : void 0, b = {
+		hours: y?.getHours() ?? 0,
+		minutes: y?.getMinutes() ?? 0,
+		seconds: y?.getSeconds() ?? 0
+	}, x = d((e) => {
+		if (!(e instanceof Date)) {
+			i?.(void 0);
+			return;
+		}
+		let t = new Date(e);
+		t.setHours(b.hours, b.minutes, b.seconds ?? 0, 0), i?.(t.toISOString());
+	}, [
+		i,
+		b.hours,
+		b.minutes,
+		b.seconds
+	]), S = d((e) => {
+		let t = new Date(y ?? /* @__PURE__ */ new Date());
+		t.setHours(e.hours, e.minutes, e.seconds ?? 0, 0), i?.(t.toISOString());
+	}, [i, y]);
+	return /* @__PURE__ */ _(n, {
+		ref: h,
+		direction: "horizontal",
+		gap: "sm",
+		align: "center",
+		className: e("date-time-input--component", m),
+		children: [/* @__PURE__ */ g(o, {
+			id: t,
+			value: y,
+			onValueChange: x,
+			placeholder: a,
+			displayFormat: c,
+			disabled: f,
+			invalid: p
+		}), /* @__PURE__ */ g(s, {
+			value: b,
+			onValueChange: S,
+			minuteStep: l,
+			withSeconds: u,
+			disabled: f,
+			invalid: p
+		})]
+	});
+});
+//#endregion
+export { B as a, k as c, T as d, C as f, z as i, O as l, U as n, L as o, E as p, R as r, j as s, W as t, w as u };

package/docs/README.md

@@ -0,0 +1,46 @@
+# Documentation
+
+Four audiences, kept apart on purpose. A consumer choosing a component and a maintainer
+auditing the token budget want different documents, and mixing them is how the consumer
+ends up reading a porting audit from August.
+
+| Directory | Audience | What belongs there |
+|---|---|---|
+| `learn/` | **Learn** | Installation, composition, framework wiring, provider and scoping, theming, forms, i18n, troubleshooting, verification, and migration policy. |
+| `generated/` | **Components** | The exact public API — imports, props, types, CSS paths, recipes, and choose/avoid guidance. Machine-written, never hand-edited. |
+| `build/` | **Build** | Adaptable live-preview recipes, with surrounding app-owned responsibilities called out. |
+| `maintainers/` | **Maintainer diagnostics** | Architecture reasoning, audits, porting procedure, the state-of-the-kit brief. Evidence, not instructions to consumers. |
+| `adr/` | Decisions | Why an expensive or irreversible choice was made, and what evidence would justify revisiting it. |
+
+`prior-attempt/` and `superpowers/` are archives. Nothing current should link into them.
+
+## The generated surface
+
+```text
+docs/generated/imports.md               every family's exact JS and CSS import
+docs/generated/public-api.md            every public symbol, its subpath, its page
+docs/generated/profiles.md              which families each profile ships
+docs/generated/component-index.json     the machine surface — agent skills read this
+docs/generated/components/              one complete API reference per family
+docs/generated/recipes.json             live-preview recipes, keyed by task
+```
+
+Start with [Installation](./learn/installation.md), then read
+[Composition](./learn/composition.md). Choose a family from the generated
+[component API](./generated/components/INDEX.md), use [Framework wiring](./learn/framework-wiring.md)
+to connect application policy, and finish with the [consumer verification](./learn/verification.md)
+matrix. [Troubleshooting](./learn/troubleshooting.md) covers the common integration failures.
+
+Regenerate with `node scripts/gen-consumer-docs.mjs`. `verify:docs-freshness` fails when a
+committed generated file differs from what its generator produces, when prose names a
+retired directory, or when a document cites an `npm run` script that does not exist.
+
+**Prose may not keep its own copy of a generated fact.** Four statements in this
+documentation were each true when written and false by the time anyone read them again —
+three component layers when there were five, `features/` "not ported" beside twenty-four
+families. A count with its evidence beside it is fine; a count restating a catalogue the
+generator owns is not.
+
+A document that is finished history declares `**Historical.**` in its opening lines. That
+exempts it from the dead-script rule, because a doc whose header says every command below
+was never created has already done the reader's job.