@bettercms-ai/kit 0.1.1 → 2.0.0

package/dist/schema/help.js

@@ -0,0 +1,56 @@
+//#region src/schema/help.ts
+var TEXT = ["string", "text"];
+/** Conventions by field name. Each says something the label and the control cannot. */
+var RULES = [
+	{
+		names: ["excerpt", "summary"],
+		types: TEXT,
+		help: "Shown on cards and in search results."
+	},
+	{
+		names: ["alt"],
+		types: TEXT,
+		help: "Read by screen readers and search engines, not shown on the page."
+	},
+	{
+		names: ["anchor"],
+		types: TEXT,
+		help: "Lowercase with no spaces, so links like /about#team can jump here."
+	},
+	{
+		names: ["coverImage", "cover"],
+		types: ["image"],
+		help: "Also used on cards and in link previews."
+	},
+	{
+		names: [
+			"published",
+			"publishedAt",
+			"publishDate"
+		],
+		types: ["date", "datetime"],
+		help: "Also used to sort lists."
+	},
+	{
+		names: ["readingTime"],
+		types: ["number"],
+		help: "In minutes."
+	}
+];
+/** Conventions by field TYPE (any name). Only consequences the editor cannot see; no advice, no restating. */
+var BY_TYPE = { slug: "Once live, changing it offers a redirect from the old address." };
+/** The convention for a field, or undefined. Does not look at `description`; callers decide precedence. */
+/** Every help line the kit itself may print — the tone test's seam, not the rule tables. */
+var HELP_STRINGS = [...RULES.map((r) => r.help), ...Object.values(BY_TYPE)];
+function conventionalHelp(field) {
+	return RULES.find((r) => r.names.includes(field.name) && (!r.types || r.types.includes(field.type)))?.help ?? BY_TYPE[field.type];
+}
+/** Help for a field following D39 precedence. `computed` is the field's own derived line (slug, number range). */
+function resolveHelp(field, computed) {
+	if (field.description !== void 0) return field.description || void 0;
+	return computed ?? conventionalHelp(field);
+}
+//#endregion
+export { HELP_STRINGS, conventionalHelp, resolveHelp };
+
+//# sourceMappingURL=help.js.map

package/dist/schema/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","names":[],"sources":["../../src/schema/help.ts"],"sourcesContent":["/**\n * FIELD HELP — CPO D39, narrowed by D51 \"Help text is the exception\". One place for the grey line under a label.\n *\n * Precedence (first match wins):\n *   1. `field.description` written on the schema. `\"\"` opts out on purpose.\n *   2. A computed line from the field's own settings (slug before publish, number ranges).\n *   3. A convention from this file, matched on field NAME + TYPE. Only facts that are true for that field in every\n *      block live here, and only facts the editor cannot see from the label and the control.\n *\n * The rule (D51, enforced by scripts/brain/check-help.ts):\n *  - Most fields get NO help. Ask: \"Does the editor need this to type the right value?\" If no, no help.\n *  - Allowed: a non-obvious format or unit (\"In minutes.\", \"A .vtt file.\"), where it shows when the canvas can't\n *    show it (\"Shown in search results.\"), a real constraint or consequence (\"Changing it once live breaks links.\"),\n *    a fallback (\"Leave empty to use the page title.\").\n *  - Never: restating the label, writing advice (\"Keep it short\", \"Start with a verb\", \"2–4 words\"), marketing\n *    theory, internal or design-system notes (\"Label and link are one unit\"), examples that belong in `placeholder`.\n *  - Length guidance is a counter (`validation.max` / `recommendedMax`), never a sentence.\n *  - One short sentence, under 90 characters, no em dash. Anything longer goes in `helpMore` (the ⓘ), sparingly.\n *  - No type-wide defaults: a heading, a button or an image gets nothing just for being one.\n */\nimport type { FieldSchema } from \"./types\";\n\ntype Rule = { names: string[]; types?: FieldSchema[\"type\"][]; help: string };\n\nconst TEXT: FieldSchema[\"type\"][] = [\"string\", \"text\"];\n\n/** Conventions by field name. Each says something the label and the control cannot. */\nconst RULES: Rule[] = [\n  { names: [\"excerpt\", \"summary\"], types: TEXT, help: \"Shown on cards and in search results.\" },\n  { names: [\"alt\"], types: TEXT, help: \"Read by screen readers and search engines, not shown on the page.\" },\n  // No SEO conventions (metaTitle, metaDescription, canonical, noindex, schemaType): SEO is native, never a modelled field.\n  { names: [\"anchor\"], types: TEXT, help: \"Lowercase with no spaces, so links like /about#team can jump here.\" },\n  { names: [\"coverImage\", \"cover\"], types: [\"image\"], help: \"Also used on cards and in link previews.\" },\n  { names: [\"published\", \"publishedAt\", \"publishDate\"], types: [\"date\", \"datetime\"], help: \"Also used to sort lists.\" },\n  { names: [\"readingTime\"], types: [\"number\"], help: \"In minutes.\" },\n];\n\n/** Conventions by field TYPE (any name). Only consequences the editor cannot see; no advice, no restating. */\nconst BY_TYPE: Partial<Record<FieldSchema[\"type\"], string>> = {\n  slug: \"Once live, changing it offers a redirect from the old address.\",\n};\n\n/** The convention for a field, or undefined. Does not look at `description`; callers decide precedence. */\n/** Every help line the kit itself may print — the tone test's seam, not the rule tables. */\nexport const HELP_STRINGS: readonly string[] = [...RULES.map((r) => r.help), ...Object.values(BY_TYPE)];\n\nexport function conventionalHelp(field: Pick<FieldSchema, \"name\" | \"type\">): string | undefined {\n  const rule = RULES.find((r) => r.names.includes(field.name) && (!r.types || r.types.includes(field.type)));\n  return rule?.help ?? BY_TYPE[field.type];\n}\n\n/** Help for a field following D39 precedence. `computed` is the field's own derived line (slug, number range). */\nexport function resolveHelp(field: FieldSchema, computed?: string): string | undefined {\n  if (field.description !== undefined) return field.description || undefined; // \"\" = deliberately none\n  return computed ?? conventionalHelp(field);\n}\n"],"mappings":";AAwBA,IAAM,OAA8B,CAAC,UAAU,MAAM;;AAGrD,IAAM,QAAgB;CACpB;EAAE,OAAO,CAAC,WAAW,SAAS;EAAG,OAAO;EAAM,MAAM;CAAwC;CAC5F;EAAE,OAAO,CAAC,KAAK;EAAG,OAAO;EAAM,MAAM;CAAoE;CAEzG;EAAE,OAAO,CAAC,QAAQ;EAAG,OAAO;EAAM,MAAM;CAAqE;CAC7G;EAAE,OAAO,CAAC,cAAc,OAAO;EAAG,OAAO,CAAC,OAAO;EAAG,MAAM;CAA2C;CACrG;EAAE,OAAO;GAAC;GAAa;GAAe;EAAa;EAAG,OAAO,CAAC,QAAQ,UAAU;EAAG,MAAM;CAA2B;CACpH;EAAE,OAAO,CAAC,aAAa;EAAG,OAAO,CAAC,QAAQ;EAAG,MAAM;CAAc;AACnE;;AAGA,IAAM,UAAwD,EAC5D,MAAM,iEACR;;;AAIA,IAAa,eAAkC,CAAC,GAAG,MAAM,KAAK,MAAM,EAAE,IAAI,GAAG,GAAG,OAAO,OAAO,OAAO,CAAC;AAEtG,SAAgB,iBAAiB,OAA+D;CAE9F,OADa,MAAM,MAAM,MAAM,EAAE,MAAM,SAAS,MAAM,IAAI,MAAM,CAAC,EAAE,SAAS,EAAE,MAAM,SAAS,MAAM,IAAI,EAChG,CAAA,EAAM,QAAQ,QAAQ,MAAM;AACrC;;AAGA,SAAgB,YAAY,OAAoB,UAAuC;CACrF,IAAI,MAAM,gBAAgB,KAAA,GAAW,OAAO,MAAM,eAAe,KAAA;CACjE,OAAO,YAAY,iBAAiB,KAAK;AAC3C"}

package/dist/schema/scale.d.ts

@@ -0,0 +1,69 @@
+/**
+ * SCALES (CPO D41) — the logic behind "fixed steps, with an optional custom escape hatch".
+ * Pure functions: the Block Kit control, the Visuals Design tab and site renderers all read values through here,
+ * so a token, a stepped number and a custom size resolve the same way everywhere.
+ *
+ * Stored shapes (see `ScaleValue` in ./types):
+ *   "xl"                       → token   (developers map it to their design system)
+ *   15                         → number on a stepped range, in the scale's default unit
+ *   { value: 200, unit: "px" } → custom  (only when the field allows custom)
+ */
+import type { FieldSchema, ScaleCustomValue, ScaleRange, ScaleSchema, ScaleStep, ScaleUnit, ScaleValue } from "./types";
+export declare const SCALE_UNITS: ScaleUnit[];
+export declare const UNIT_NAMES: Record<ScaleUnit, string>;
+export declare const isCustomValue: (v: unknown) => v is ScaleCustomValue;
+export declare const isTokenScale: (s: ScaleSchema) => s is ScaleSchema & {
+    steps: ScaleStep[];
+};
+export declare const rangeOf: (s: ScaleSchema) => ScaleRange | null;
+/** Back-compat: `layout: "slider"` + `numeric: { min, max, step, unit }` → a fixed-only range scale. */
+export declare function fieldScale(field: Pick<FieldSchema, "scale" | "layout" | "numeric">): ScaleSchema | null;
+export declare const defaultUnit: (s: ScaleSchema) => ScaleUnit | undefined;
+/** The custom rules, or null when the field is fixed only. */
+export declare function customRules(s: ScaleSchema): {
+    units: ScaleUnit[];
+    step: number;
+    min: (u: ScaleUnit) => number | undefined;
+    max: (u: ScaleUnit) => number | undefined;
+} | null;
+export declare function roundTo(n: number, step: number): number;
+/** Readable number + unit: "200px", "15%", "1.5rem", "4.9". */
+export declare function formatNumber(n: number, unit?: string): string;
+/** px for a custom value when it can be known without layout (px, rem/em at 16). */
+export declare function customPx(v: ScaleCustomValue): number | undefined;
+export interface ResolvedScale {
+    kind: "token" | "number" | "custom" | "empty";
+    /** short readout: "XL", "15%", "200px" */
+    label: string;
+    /** long name: "Extra large", "15%", "Custom" */
+    title: string;
+    /** CSS to emit ("48px", "15%", "200px", or a step's css) */
+    css?: string;
+    px?: number;
+    /** token index (token scales) */
+    index?: number;
+    /** spoken value for aria-valuetext: "Extra large, 48 pixels" */
+    spoken: string;
+}
+/** Resolve any stored value against its scale. Unknown tokens fall back to "empty" (never throws). */
+export declare function resolveScale(s: ScaleSchema, v: unknown, legacyUnit?: string): ResolvedScale;
+/** CSS for a stored value — what a site renderer emits. */
+export declare const scaleCss: (s: ScaleSchema, v: unknown) => string | undefined;
+/** "XL · 48px" — the hint shown for a token. */
+export declare function scaleHint(r: ResolvedScale): string;
+/** Index of the token nearest to a custom value (by px), or -1 when it can't be placed. */
+export declare function nearestTokenIndex(s: ScaleSchema, v: ScaleCustomValue): number;
+export type ParseResult = {
+    ok: true;
+    value: ScaleValue;
+} | {
+    ok: false;
+    error: string;
+};
+/** Validate a custom value against the field's custom rules. Returns a plain-words error or null. */
+export declare function validateCustom(s: ScaleSchema, v: ScaleCustomValue): string | null;
+/**
+ * Parse what an editor typed: a token ("xl", "XL", "Extra large"), a number ("240" → default unit) or a number with
+ * a unit ("200px", "75 %", "1.5rem"). Exact px matches of a token snap to the token, so the design system wins.
+ */
+export declare function parseScaleInput(s: ScaleSchema, text: string, unitHint?: ScaleUnit): ParseResult;

package/dist/schema/scale.js

@@ -0,0 +1,250 @@
+//#region src/schema/scale.ts
+var SCALE_UNITS = [
+	"px",
+	"%",
+	"rem",
+	"em",
+	"vw",
+	"vh"
+];
+var isUnit = (u) => typeof u === "string" && SCALE_UNITS.includes(u);
+/** Spoken unit names for aria-valuetext ("48 pixels"). */
+var UNIT_WORDS = {
+	px: ["pixel", "pixels"],
+	"%": ["percent", "percent"],
+	rem: ["rem", "rem"],
+	em: ["em", "em"],
+	vw: ["percent of the screen width", "percent of the screen width"],
+	vh: ["percent of the screen height", "percent of the screen height"]
+};
+var UNIT_NAMES = {
+	px: "Pixels",
+	"%": "Percent",
+	rem: "Root em",
+	em: "Em",
+	vw: "Screen width",
+	vh: "Screen height"
+};
+var isCustomValue = (v) => !!v && typeof v === "object" && typeof v.value === "number" && isUnit(v.unit);
+var isTokenScale = (s) => Array.isArray(s.steps);
+var rangeOf = (s) => Array.isArray(s.steps) ? null : s.steps;
+/** Back-compat: `layout: "slider"` + `numeric: { min, max, step, unit }` → a fixed-only range scale. */
+function fieldScale(field) {
+	if (field.scale) return field.scale;
+	const n = field.numeric;
+	if (field.layout === "slider" && n?.min != null && n?.max != null) return {
+		steps: {
+			min: n.min,
+			max: n.max,
+			step: n.step ?? 1
+		},
+		units: isUnit(n.unit) ? [n.unit] : void 0
+	};
+	return null;
+}
+var defaultUnit = (s) => s.defaultUnit ?? s.units?.[0];
+/** The custom rules, or null when the field is fixed only. */
+function customRules(s) {
+	if (!s.allowCustom) return null;
+	const c = s.allowCustom === true ? {} : s.allowCustom;
+	const units = c.units ?? s.units ?? ["px"];
+	const pick = (b, u) => typeof b === "number" ? b : b?.[u];
+	return {
+		units,
+		step: c.step ?? 1,
+		min: (u) => pick(c.min, u),
+		max: (u) => pick(c.max, u)
+	};
+}
+var decimals = (n) => (String(n).split(".")[1] ?? "").length;
+function roundTo(n, step) {
+	return Number((Math.round(n / step) * step).toFixed(Math.max(decimals(step), 0)));
+}
+/** Readable number + unit: "200px", "15%", "1.5rem", "4.9". */
+function formatNumber(n, unit) {
+	const t = Number.isInteger(n) ? String(n) : String(Number(n.toFixed(3)));
+	if (!unit) return t;
+	return isUnit(unit) ? `${t}${unit}` : `${t} ${unit}`;
+}
+/** px for a custom value when it can be known without layout (px, rem/em at 16). */
+function customPx(v) {
+	if (v.unit === "px") return v.value;
+	if (v.unit === "rem" || v.unit === "em") return v.value * 16;
+}
+function spokenNumber(n, unit) {
+	if (!unit) return String(n);
+	if (!isUnit(unit)) return `${n} ${unit}`;
+	const [one, many] = UNIT_WORDS[unit];
+	return `${n} ${n === 1 ? one : many}`;
+}
+/** Resolve any stored value against its scale. Unknown tokens fall back to "empty" (never throws). */
+function resolveScale(s, v, legacyUnit) {
+	if (isCustomValue(v)) {
+		const px = customPx(v);
+		return {
+			kind: "custom",
+			label: formatNumber(v.value, v.unit),
+			title: "Custom",
+			css: `${v.value}${v.unit}`,
+			px,
+			spoken: `Custom, ${spokenNumber(v.value, v.unit)}`
+		};
+	}
+	if (isTokenScale(s)) {
+		const i = s.steps.findIndex((st) => st.value === v);
+		if (i < 0) return {
+			kind: "empty",
+			label: "—",
+			title: "Not set",
+			spoken: "Not set"
+		};
+		const st = s.steps[i];
+		const title = st.title ?? st.label;
+		const css = st.css ?? (st.px != null ? `${st.px}px` : void 0);
+		return {
+			kind: "token",
+			label: st.label,
+			title,
+			css,
+			px: st.px,
+			index: i,
+			spoken: st.px != null ? `${title}, ${spokenNumber(st.px, "px")}` : st.css ? `${title}, ${st.css}` : title
+		};
+	}
+	const unit = defaultUnit(s) ?? legacyUnit;
+	const n = typeof v === "number" ? v : typeof v === "string" && v.trim() !== "" && !Number.isNaN(Number(v)) ? Number(v) : null;
+	if (n == null) return {
+		kind: "empty",
+		label: "—",
+		title: "Not set",
+		spoken: "Not set"
+	};
+	const css = isUnit(unit) ? `${n}${unit}` : String(n);
+	return {
+		kind: "number",
+		label: formatNumber(n, unit),
+		title: formatNumber(n, unit),
+		css,
+		px: unit === "px" ? n : void 0,
+		spoken: spokenNumber(n, unit)
+	};
+}
+/** CSS for a stored value — what a site renderer emits. */
+var scaleCss = (s, v) => resolveScale(s, v).css;
+/** "XL · 48px" — the hint shown for a token. */
+function scaleHint(r) {
+	if (r.kind === "token") return r.css ? `${r.title} · ${r.css}` : r.title;
+	if (r.kind === "custom") return `Custom · ${r.label}`;
+	return r.title;
+}
+/** Index of the token nearest to a custom value (by px), or -1 when it can't be placed. */
+function nearestTokenIndex(s, v) {
+	if (!isTokenScale(s)) return -1;
+	const px = customPx(v);
+	if (px == null) return -1;
+	let best = -1;
+	let d = Infinity;
+	s.steps.forEach((st, i) => {
+		if (st.px == null) return;
+		const dd = Math.abs(st.px - px);
+		if (dd < d) d = dd, best = i;
+	});
+	return best;
+}
+/** Validate a custom value against the field's custom rules. Returns a plain-words error or null. */
+function validateCustom(s, v) {
+	const c = customRules(s);
+	if (!c) return "Pick a value on the scale.";
+	if (!c.units.includes(v.unit)) return `Use ${listUnits(c.units)}.`;
+	const lo = c.min(v.unit);
+	const hi = c.max(v.unit);
+	if (lo != null && v.value < lo || hi != null && v.value > hi) {
+		if (lo != null && hi != null) return `Use ${formatNumber(lo)}–${formatNumber(hi, v.unit)}.`;
+		if (lo != null) return `Use ${formatNumber(lo, v.unit)} or more.`;
+		return `Use ${formatNumber(hi, v.unit)} or less.`;
+	}
+	return null;
+}
+var listUnits = (u) => u.length === 1 ? u[0] : `${u.slice(0, -1).join(", ")} or ${u[u.length - 1]}`;
+/**
+* Parse what an editor typed: a token ("xl", "XL", "Extra large"), a number ("240" → default unit) or a number with
+* a unit ("200px", "75 %", "1.5rem"). Exact px matches of a token snap to the token, so the design system wins.
+*/
+function parseScaleInput(s, text, unitHint) {
+	const t = text.trim();
+	if (!t) return {
+		ok: false,
+		error: "Type a value, like 240px."
+	};
+	const low = t.toLowerCase();
+	if (isTokenScale(s)) {
+		const st = s.steps.find((x) => x.value.toLowerCase() === low || x.label.toLowerCase() === low || x.title?.toLowerCase() === low);
+		if (st) return {
+			ok: true,
+			value: st.value
+		};
+	}
+	const m = /^(-?(?:\d+(?:\.\d+)?|\.\d+))\s*(px|%|rem|em|vw|vh)?$/i.exec(t);
+	if (!m) return {
+		ok: false,
+		error: `Type a number like 240px${isTokenScale(s) ? ` or a size like ${s.steps[Math.min(2, s.steps.length - 1)].label}` : ""}.`
+	};
+	const n = Number(m[1]);
+	const typedUnit = m[2]?.toLowerCase();
+	const c = customRules(s);
+	const range = rangeOf(s);
+	if (range) {
+		const base = defaultUnit(s);
+		const sameUnit = !typedUnit || typedUnit === base;
+		const step = range.step ?? 1;
+		const onGrid = Math.abs((n - range.min) / step - Math.round((n - range.min) / step)) < 1e-9;
+		if (sameUnit && n >= range.min && n <= range.max && (onGrid || !c)) return {
+			ok: true,
+			value: onGrid ? n : roundTo(n, step)
+		};
+		if (!c) return {
+			ok: false,
+			error: `Use ${formatNumber(range.min)}–${formatNumber(range.max, base)}.`
+		};
+		const cv = {
+			value: n,
+			unit: typedUnit ?? unitHint ?? base ?? c.units[0]
+		};
+		const err = validateCustom(s, cv);
+		return err ? {
+			ok: false,
+			error: err
+		} : {
+			ok: true,
+			value: cv
+		};
+	}
+	if (!c) return {
+		ok: false,
+		error: "Pick a value on the scale."
+	};
+	const unit = typedUnit ?? unitHint ?? c.units[0];
+	const cv = {
+		value: n,
+		unit
+	};
+	if (isTokenScale(s) && unit === "px") {
+		const exact = s.steps.find((st) => st.px === n && !st.css);
+		if (exact) return {
+			ok: true,
+			value: exact.value
+		};
+	}
+	const err = validateCustom(s, cv);
+	return err ? {
+		ok: false,
+		error: err
+	} : {
+		ok: true,
+		value: cv
+	};
+}
+//#endregion
+export { SCALE_UNITS, UNIT_NAMES, customPx, customRules, defaultUnit, fieldScale, formatNumber, isCustomValue, isTokenScale, nearestTokenIndex, parseScaleInput, rangeOf, resolveScale, roundTo, scaleCss, scaleHint, validateCustom };
+
+//# sourceMappingURL=scale.js.map

package/dist/schema/scale.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scale.js","names":[],"sources":["../../src/schema/scale.ts"],"sourcesContent":["/**\n * SCALES (CPO D41) — the logic behind \"fixed steps, with an optional custom escape hatch\".\n * Pure functions: the Block Kit control, the Visuals Design tab and site renderers all read values through here,\n * so a token, a stepped number and a custom size resolve the same way everywhere.\n *\n * Stored shapes (see `ScaleValue` in ./types):\n *   \"xl\"                       → token   (developers map it to their design system)\n *   15                         → number on a stepped range, in the scale's default unit\n *   { value: 200, unit: \"px\" } → custom  (only when the field allows custom)\n */\nimport type { FieldSchema, ScaleCustomValue, ScaleRange, ScaleSchema, ScaleStep, ScaleUnit, ScaleValue } from \"./types\";\n\nexport const SCALE_UNITS: ScaleUnit[] = [\"px\", \"%\", \"rem\", \"em\", \"vw\", \"vh\"];\nconst isUnit = (u: unknown): u is ScaleUnit => typeof u === \"string\" && (SCALE_UNITS as string[]).includes(u);\n\n/** Spoken unit names for aria-valuetext (\"48 pixels\"). */\nconst UNIT_WORDS: Record<ScaleUnit, [one: string, many: string]> = {\n  px: [\"pixel\", \"pixels\"],\n  \"%\": [\"percent\", \"percent\"],\n  rem: [\"rem\", \"rem\"],\n  em: [\"em\", \"em\"],\n  vw: [\"percent of the screen width\", \"percent of the screen width\"],\n  vh: [\"percent of the screen height\", \"percent of the screen height\"],\n};\nexport const UNIT_NAMES: Record<ScaleUnit, string> = { px: \"Pixels\", \"%\": \"Percent\", rem: \"Root em\", em: \"Em\", vw: \"Screen width\", vh: \"Screen height\" };\n\nexport const isCustomValue = (v: unknown): v is ScaleCustomValue =>\n  !!v && typeof v === \"object\" && typeof (v as ScaleCustomValue).value === \"number\" && isUnit((v as ScaleCustomValue).unit);\nexport const isTokenScale = (s: ScaleSchema): s is ScaleSchema & { steps: ScaleStep[] } => Array.isArray(s.steps);\nexport const rangeOf = (s: ScaleSchema): ScaleRange | null => (Array.isArray(s.steps) ? null : s.steps);\n\n/** Back-compat: `layout: \"slider\"` + `numeric: { min, max, step, unit }` → a fixed-only range scale. */\nexport function fieldScale(field: Pick<FieldSchema, \"scale\" | \"layout\" | \"numeric\">): ScaleSchema | null {\n  if (field.scale) return field.scale;\n  const n = field.numeric;\n  if (field.layout === \"slider\" && n?.min != null && n?.max != null) {\n    return { steps: { min: n.min, max: n.max, step: n.step ?? 1 }, units: isUnit(n.unit) ? [n.unit] : undefined };\n  }\n  return null;\n}\n\nexport const defaultUnit = (s: ScaleSchema): ScaleUnit | undefined => s.defaultUnit ?? s.units?.[0];\n\n/** The custom rules, or null when the field is fixed only. */\nexport function customRules(s: ScaleSchema) {\n  if (!s.allowCustom) return null;\n  const c = s.allowCustom === true ? {} : s.allowCustom;\n  const units = c.units ?? s.units ?? [\"px\"];\n  const pick = (b: typeof c.min, u: ScaleUnit) => (typeof b === \"number\" ? b : b?.[u]);\n  return {\n    units,\n    step: c.step ?? 1,\n    min: (u: ScaleUnit) => pick(c.min, u),\n    max: (u: ScaleUnit) => pick(c.max, u),\n  };\n}\n\nconst decimals = (n: number) => (String(n).split(\".\")[1] ?? \"\").length;\nexport function roundTo(n: number, step: number) {\n  return Number((Math.round(n / step) * step).toFixed(Math.max(decimals(step), 0)));\n}\n\n/** Readable number + unit: \"200px\", \"15%\", \"1.5rem\", \"4.9\". */\nexport function formatNumber(n: number, unit?: string) {\n  const t = Number.isInteger(n) ? String(n) : String(Number(n.toFixed(3)));\n  if (!unit) return t;\n  return isUnit(unit) ? `${t}${unit}` : `${t} ${unit}`;\n}\n\n/** px for a custom value when it can be known without layout (px, rem/em at 16). */\nexport function customPx(v: ScaleCustomValue): number | undefined {\n  if (v.unit === \"px\") return v.value;\n  if (v.unit === \"rem\" || v.unit === \"em\") return v.value * 16;\n  return undefined;\n}\n\nexport interface ResolvedScale {\n  kind: \"token\" | \"number\" | \"custom\" | \"empty\";\n  /** short readout: \"XL\", \"15%\", \"200px\" */\n  label: string;\n  /** long name: \"Extra large\", \"15%\", \"Custom\" */\n  title: string;\n  /** CSS to emit (\"48px\", \"15%\", \"200px\", or a step's css) */\n  css?: string;\n  px?: number;\n  /** token index (token scales) */\n  index?: number;\n  /** spoken value for aria-valuetext: \"Extra large, 48 pixels\" */\n  spoken: string;\n}\n\nfunction spokenNumber(n: number, unit?: string) {\n  if (!unit) return String(n);\n  if (!isUnit(unit)) return `${n} ${unit}`;\n  const [one, many] = UNIT_WORDS[unit];\n  return `${n} ${n === 1 ? one : many}`;\n}\n\n/** Resolve any stored value against its scale. Unknown tokens fall back to \"empty\" (never throws). */\nexport function resolveScale(s: ScaleSchema, v: unknown, legacyUnit?: string): ResolvedScale {\n  if (isCustomValue(v)) {\n    const px = customPx(v);\n    return { kind: \"custom\", label: formatNumber(v.value, v.unit), title: \"Custom\", css: `${v.value}${v.unit}`, px, spoken: `Custom, ${spokenNumber(v.value, v.unit)}` };\n  }\n  if (isTokenScale(s)) {\n    const i = s.steps.findIndex((st) => st.value === v);\n    if (i < 0) return { kind: \"empty\", label: \"—\", title: \"Not set\", spoken: \"Not set\" };\n    const st = s.steps[i];\n    const title = st.title ?? st.label;\n    const css = st.css ?? (st.px != null ? `${st.px}px` : undefined);\n    return { kind: \"token\", label: st.label, title, css, px: st.px, index: i, spoken: st.px != null ? `${title}, ${spokenNumber(st.px, \"px\")}` : st.css ? `${title}, ${st.css}` : title };\n  }\n  const unit = defaultUnit(s) ?? legacyUnit;\n  const n = typeof v === \"number\" ? v : typeof v === \"string\" && v.trim() !== \"\" && !Number.isNaN(Number(v)) ? Number(v) : null;\n  if (n == null) return { kind: \"empty\", label: \"—\", title: \"Not set\", spoken: \"Not set\" };\n  const css = isUnit(unit) ? `${n}${unit}` : String(n);\n  return { kind: \"number\", label: formatNumber(n, unit), title: formatNumber(n, unit), css, px: unit === \"px\" ? n : undefined, spoken: spokenNumber(n, unit) };\n}\n\n/** CSS for a stored value — what a site renderer emits. */\nexport const scaleCss = (s: ScaleSchema, v: unknown) => resolveScale(s, v).css;\n\n/** \"XL · 48px\" — the hint shown for a token. */\nexport function scaleHint(r: ResolvedScale) {\n  if (r.kind === \"token\") return r.css ? `${r.title} · ${r.css}` : r.title;\n  if (r.kind === \"custom\") return `Custom · ${r.label}`;\n  return r.title;\n}\n\n/** Index of the token nearest to a custom value (by px), or -1 when it can't be placed. */\nexport function nearestTokenIndex(s: ScaleSchema, v: ScaleCustomValue): number {\n  if (!isTokenScale(s)) return -1;\n  const px = customPx(v);\n  if (px == null) return -1;\n  let best = -1;\n  let d = Infinity;\n  s.steps.forEach((st, i) => {\n    if (st.px == null) return;\n    const dd = Math.abs(st.px - px);\n    if (dd < d) (d = dd), (best = i);\n  });\n  return best;\n}\n\nexport type ParseResult = { ok: true; value: ScaleValue } | { ok: false; error: string };\n\n/** Validate a custom value against the field's custom rules. Returns a plain-words error or null. */\nexport function validateCustom(s: ScaleSchema, v: ScaleCustomValue): string | null {\n  const c = customRules(s);\n  if (!c) return \"Pick a value on the scale.\";\n  if (!c.units.includes(v.unit)) return `Use ${listUnits(c.units)}.`;\n  const lo = c.min(v.unit);\n  const hi = c.max(v.unit);\n  if ((lo != null && v.value < lo) || (hi != null && v.value > hi)) {\n    if (lo != null && hi != null) return `Use ${formatNumber(lo)}–${formatNumber(hi, v.unit)}.`;\n    if (lo != null) return `Use ${formatNumber(lo, v.unit)} or more.`;\n    return `Use ${formatNumber(hi!, v.unit)} or less.`;\n  }\n  return null;\n}\n\nconst listUnits = (u: ScaleUnit[]) => (u.length === 1 ? u[0] : `${u.slice(0, -1).join(\", \")} or ${u[u.length - 1]}`);\n\n/**\n * Parse what an editor typed: a token (\"xl\", \"XL\", \"Extra large\"), a number (\"240\" → default unit) or a number with\n * a unit (\"200px\", \"75 %\", \"1.5rem\"). Exact px matches of a token snap to the token, so the design system wins.\n */\nexport function parseScaleInput(s: ScaleSchema, text: string, unitHint?: ScaleUnit): ParseResult {\n  const t = text.trim();\n  if (!t) return { ok: false, error: \"Type a value, like 240px.\" };\n  const low = t.toLowerCase();\n  if (isTokenScale(s)) {\n    const st = s.steps.find((x) => x.value.toLowerCase() === low || x.label.toLowerCase() === low || x.title?.toLowerCase() === low);\n    if (st) return { ok: true, value: st.value };\n  }\n  const m = /^(-?(?:\\d+(?:\\.\\d+)?|\\.\\d+))\\s*(px|%|rem|em|vw|vh)?$/i.exec(t);\n  if (!m) {\n    const tokens = isTokenScale(s) ? ` or a size like ${s.steps[Math.min(2, s.steps.length - 1)].label}` : \"\";\n    return { ok: false, error: `Type a number like 240px${tokens}.` };\n  }\n  const n = Number(m[1]);\n  const typedUnit = m[2]?.toLowerCase() as ScaleUnit | undefined;\n  const c = customRules(s);\n  const range = rangeOf(s);\n  if (range) {\n    const base = defaultUnit(s);\n    const sameUnit = !typedUnit || typedUnit === base;\n    const step = range.step ?? 1;\n    const onGrid = Math.abs((n - range.min) / step - Math.round((n - range.min) / step)) < 1e-9;\n    if (sameUnit && n >= range.min && n <= range.max && (onGrid || !c)) return { ok: true, value: onGrid ? n : roundTo(n, step) };\n    if (!c) return { ok: false, error: `Use ${formatNumber(range.min)}–${formatNumber(range.max, base)}.` };\n    const unit = typedUnit ?? unitHint ?? base ?? c.units[0];\n    const cv = { value: n, unit };\n    const err = validateCustom(s, cv);\n    return err ? { ok: false, error: err } : { ok: true, value: cv };\n  }\n  if (!c) return { ok: false, error: \"Pick a value on the scale.\" };\n  const unit = typedUnit ?? unitHint ?? c.units[0];\n  const cv: ScaleCustomValue = { value: n, unit };\n  if (isTokenScale(s) && unit === \"px\") {\n    const exact = s.steps.find((st) => st.px === n && !st.css);\n    if (exact) return { ok: true, value: exact.value };\n  }\n  const err = validateCustom(s, cv);\n  return err ? { ok: false, error: err } : { ok: true, value: cv };\n}\n"],"mappings":";AAYA,IAAa,cAA2B;CAAC;CAAM;CAAK;CAAO;CAAM;CAAM;AAAI;AAC3E,IAAM,UAAU,MAA+B,OAAO,MAAM,YAAa,YAAyB,SAAS,CAAC;;AAG5G,IAAM,aAA6D;CACjE,IAAI,CAAC,SAAS,QAAQ;CACtB,KAAK,CAAC,WAAW,SAAS;CAC1B,KAAK,CAAC,OAAO,KAAK;CAClB,IAAI,CAAC,MAAM,IAAI;CACf,IAAI,CAAC,+BAA+B,6BAA6B;CACjE,IAAI,CAAC,gCAAgC,8BAA8B;AACrE;AACA,IAAa,aAAwC;CAAE,IAAI;CAAU,KAAK;CAAW,KAAK;CAAW,IAAI;CAAM,IAAI;CAAgB,IAAI;AAAgB;AAEvJ,IAAa,iBAAiB,MAC5B,CAAC,CAAC,KAAK,OAAO,MAAM,YAAY,OAAQ,EAAuB,UAAU,YAAY,OAAQ,EAAuB,IAAI;AAC1H,IAAa,gBAAgB,MAA8D,MAAM,QAAQ,EAAE,KAAK;AAChH,IAAa,WAAW,MAAuC,MAAM,QAAQ,EAAE,KAAK,IAAI,OAAO,EAAE;;AAGjG,SAAgB,WAAW,OAA8E;CACvG,IAAI,MAAM,OAAO,OAAO,MAAM;CAC9B,MAAM,IAAI,MAAM;CAChB,IAAI,MAAM,WAAW,YAAY,GAAG,OAAO,QAAQ,GAAG,OAAO,MAC3D,OAAO;EAAE,OAAO;GAAE,KAAK,EAAE;GAAK,KAAK,EAAE;GAAK,MAAM,EAAE,QAAQ;EAAE;EAAG,OAAO,OAAO,EAAE,IAAI,IAAI,CAAC,EAAE,IAAI,IAAI,KAAA;CAAU;CAE9G,OAAO;AACT;AAEA,IAAa,eAAe,MAA0C,EAAE,eAAe,EAAE,QAAQ;;AAGjG,SAAgB,YAAY,GAAgB;CAC1C,IAAI,CAAC,EAAE,aAAa,OAAO;CAC3B,MAAM,IAAI,EAAE,gBAAgB,OAAO,CAAC,IAAI,EAAE;CAC1C,MAAM,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC,IAAI;CACzC,MAAM,QAAQ,GAAiB,MAAkB,OAAO,MAAM,WAAW,IAAI,IAAI;CACjF,OAAO;EACL;EACA,MAAM,EAAE,QAAQ;EAChB,MAAM,MAAiB,KAAK,EAAE,KAAK,CAAC;EACpC,MAAM,MAAiB,KAAK,EAAE,KAAK,CAAC;CACtC;AACF;AAEA,IAAM,YAAY,OAAe,OAAO,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,GAAA,CAAI;AAChE,SAAgB,QAAQ,GAAW,MAAc;CAC/C,OAAO,QAAQ,KAAK,MAAM,IAAI,IAAI,IAAI,KAAA,CAAM,QAAQ,KAAK,IAAI,SAAS,IAAI,GAAG,CAAC,CAAC,CAAC;AAClF;;AAGA,SAAgB,aAAa,GAAW,MAAe;CACrD,MAAM,IAAI,OAAO,UAAU,CAAC,IAAI,OAAO,CAAC,IAAI,OAAO,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;CACvE,IAAI,CAAC,MAAM,OAAO;CAClB,OAAO,OAAO,IAAI,IAAI,GAAG,IAAI,SAAS,GAAG,EAAE,GAAG;AAChD;;AAGA,SAAgB,SAAS,GAAyC;CAChE,IAAI,EAAE,SAAS,MAAM,OAAO,EAAE;CAC9B,IAAI,EAAE,SAAS,SAAS,EAAE,SAAS,MAAM,OAAO,EAAE,QAAQ;AAE5D;AAiBA,SAAS,aAAa,GAAW,MAAe;CAC9C,IAAI,CAAC,MAAM,OAAO,OAAO,CAAC;CAC1B,IAAI,CAAC,OAAO,IAAI,GAAG,OAAO,GAAG,EAAE,GAAG;CAClC,MAAM,CAAC,KAAK,QAAQ,WAAW;CAC/B,OAAO,GAAG,EAAE,GAAG,MAAM,IAAI,MAAM;AACjC;;AAGA,SAAgB,aAAa,GAAgB,GAAY,YAAoC;CAC3F,IAAI,cAAc,CAAC,GAAG;EACpB,MAAM,KAAK,SAAS,CAAC;EACrB,OAAO;GAAE,MAAM;GAAU,OAAO,aAAa,EAAE,OAAO,EAAE,IAAI;GAAG,OAAO;GAAU,KAAK,GAAG,EAAE,QAAQ,EAAE;GAAQ;GAAI,QAAQ,WAAW,aAAa,EAAE,OAAO,EAAE,IAAI;EAAI;CACrK;CACA,IAAI,aAAa,CAAC,GAAG;EACnB,MAAM,IAAI,EAAE,MAAM,WAAW,OAAO,GAAG,UAAU,CAAC;EAClD,IAAI,IAAI,GAAG,OAAO;GAAE,MAAM;GAAS,OAAO;GAAK,OAAO;GAAW,QAAQ;EAAU;EACnF,MAAM,KAAK,EAAE,MAAM;EACnB,MAAM,QAAQ,GAAG,SAAS,GAAG;EAC7B,MAAM,MAAM,GAAG,QAAQ,GAAG,MAAM,OAAO,GAAG,GAAG,GAAG,MAAM,KAAA;EACtD,OAAO;GAAE,MAAM;GAAS,OAAO,GAAG;GAAO;GAAO;GAAK,IAAI,GAAG;GAAI,OAAO;GAAG,QAAQ,GAAG,MAAM,OAAO,GAAG,MAAM,IAAI,aAAa,GAAG,IAAI,IAAI,MAAM,GAAG,MAAM,GAAG,MAAM,IAAI,GAAG,QAAQ;EAAM;CACtL;CACA,MAAM,OAAO,YAAY,CAAC,KAAK;CAC/B,MAAM,IAAI,OAAO,MAAM,WAAW,IAAI,OAAO,MAAM,YAAY,EAAE,KAAK,MAAM,MAAM,CAAC,OAAO,MAAM,OAAO,CAAC,CAAC,IAAI,OAAO,CAAC,IAAI;CACzH,IAAI,KAAK,MAAM,OAAO;EAAE,MAAM;EAAS,OAAO;EAAK,OAAO;EAAW,QAAQ;CAAU;CACvF,MAAM,MAAM,OAAO,IAAI,IAAI,GAAG,IAAI,SAAS,OAAO,CAAC;CACnD,OAAO;EAAE,MAAM;EAAU,OAAO,aAAa,GAAG,IAAI;EAAG,OAAO,aAAa,GAAG,IAAI;EAAG;EAAK,IAAI,SAAS,OAAO,IAAI,KAAA;EAAW,QAAQ,aAAa,GAAG,IAAI;CAAE;AAC7J;;AAGA,IAAa,YAAY,GAAgB,MAAe,aAAa,GAAG,CAAC,CAAC,CAAC;;AAG3E,SAAgB,UAAU,GAAkB;CAC1C,IAAI,EAAE,SAAS,SAAS,OAAO,EAAE,MAAM,GAAG,EAAE,MAAM,KAAK,EAAE,QAAQ,EAAE;CACnE,IAAI,EAAE,SAAS,UAAU,OAAO,YAAY,EAAE;CAC9C,OAAO,EAAE;AACX;;AAGA,SAAgB,kBAAkB,GAAgB,GAA6B;CAC7E,IAAI,CAAC,aAAa,CAAC,GAAG,OAAO;CAC7B,MAAM,KAAK,SAAS,CAAC;CACrB,IAAI,MAAM,MAAM,OAAO;CACvB,IAAI,OAAO;CACX,IAAI,IAAI;CACR,EAAE,MAAM,SAAS,IAAI,MAAM;EACzB,IAAI,GAAG,MAAM,MAAM;EACnB,MAAM,KAAK,KAAK,IAAI,GAAG,KAAK,EAAE;EAC9B,IAAI,KAAK,GAAG,IAAK,IAAM,OAAO;CAChC,CAAC;CACD,OAAO;AACT;;AAKA,SAAgB,eAAe,GAAgB,GAAoC;CACjF,MAAM,IAAI,YAAY,CAAC;CACvB,IAAI,CAAC,GAAG,OAAO;CACf,IAAI,CAAC,EAAE,MAAM,SAAS,EAAE,IAAI,GAAG,OAAO,OAAO,UAAU,EAAE,KAAK,EAAE;CAChE,MAAM,KAAK,EAAE,IAAI,EAAE,IAAI;CACvB,MAAM,KAAK,EAAE,IAAI,EAAE,IAAI;CACvB,IAAK,MAAM,QAAQ,EAAE,QAAQ,MAAQ,MAAM,QAAQ,EAAE,QAAQ,IAAK;EAChE,IAAI,MAAM,QAAQ,MAAM,MAAM,OAAO,OAAO,aAAa,EAAE,EAAE,GAAG,aAAa,IAAI,EAAE,IAAI,EAAE;EACzF,IAAI,MAAM,MAAM,OAAO,OAAO,aAAa,IAAI,EAAE,IAAI,EAAE;EACvD,OAAO,OAAO,aAAa,IAAK,EAAE,IAAI,EAAE;CAC1C;CACA,OAAO;AACT;AAEA,IAAM,aAAa,MAAoB,EAAE,WAAW,IAAI,EAAE,KAAK,GAAG,EAAE,MAAM,GAAG,EAAE,CAAC,CAAC,KAAK,IAAI,EAAE,MAAM,EAAE,EAAE,SAAS;;;;;AAM/G,SAAgB,gBAAgB,GAAgB,MAAc,UAAmC;CAC/F,MAAM,IAAI,KAAK,KAAK;CACpB,IAAI,CAAC,GAAG,OAAO;EAAE,IAAI;EAAO,OAAO;CAA4B;CAC/D,MAAM,MAAM,EAAE,YAAY;CAC1B,IAAI,aAAa,CAAC,GAAG;EACnB,MAAM,KAAK,EAAE,MAAM,MAAM,MAAM,EAAE,MAAM,YAAY,MAAM,OAAO,EAAE,MAAM,YAAY,MAAM,OAAO,EAAE,OAAO,YAAY,MAAM,GAAG;EAC/H,IAAI,IAAI,OAAO;GAAE,IAAI;GAAM,OAAO,GAAG;EAAM;CAC7C;CACA,MAAM,IAAI,wDAAwD,KAAK,CAAC;CACxE,IAAI,CAAC,GAEH,OAAO;EAAE,IAAI;EAAO,OAAO,2BADZ,aAAa,CAAC,IAAI,mBAAmB,EAAE,MAAM,KAAK,IAAI,GAAG,EAAE,MAAM,SAAS,CAAC,EAAE,CAAC,UAAU,GAC1C;CAAG;CAElE,MAAM,IAAI,OAAO,EAAE,EAAE;CACrB,MAAM,YAAY,EAAE,EAAE,EAAE,YAAY;CACpC,MAAM,IAAI,YAAY,CAAC;CACvB,MAAM,QAAQ,QAAQ,CAAC;CACvB,IAAI,OAAO;EACT,MAAM,OAAO,YAAY,CAAC;EAC1B,MAAM,WAAW,CAAC,aAAa,cAAc;EAC7C,MAAM,OAAO,MAAM,QAAQ;EAC3B,MAAM,SAAS,KAAK,KAAK,IAAI,MAAM,OAAO,OAAO,KAAK,OAAO,IAAI,MAAM,OAAO,IAAI,CAAC,IAAI;EACvF,IAAI,YAAY,KAAK,MAAM,OAAO,KAAK,MAAM,QAAQ,UAAU,CAAC,IAAI,OAAO;GAAE,IAAI;GAAM,OAAO,SAAS,IAAI,QAAQ,GAAG,IAAI;EAAE;EAC5H,IAAI,CAAC,GAAG,OAAO;GAAE,IAAI;GAAO,OAAO,OAAO,aAAa,MAAM,GAAG,EAAE,GAAG,aAAa,MAAM,KAAK,IAAI,EAAE;EAAG;EAEtG,MAAM,KAAK;GAAE,OAAO;GAAG,MADV,aAAa,YAAY,QAAQ,EAAE,MAAM;EAC1B;EAC5B,MAAM,MAAM,eAAe,GAAG,EAAE;EAChC,OAAO,MAAM;GAAE,IAAI;GAAO,OAAO;EAAI,IAAI;GAAE,IAAI;GAAM,OAAO;EAAG;CACjE;CACA,IAAI,CAAC,GAAG,OAAO;EAAE,IAAI;EAAO,OAAO;CAA6B;CAChE,MAAM,OAAO,aAAa,YAAY,EAAE,MAAM;CAC9C,MAAM,KAAuB;EAAE,OAAO;EAAG;CAAK;CAC9C,IAAI,aAAa,CAAC,KAAK,SAAS,MAAM;EACpC,MAAM,QAAQ,EAAE,MAAM,MAAM,OAAO,GAAG,OAAO,KAAK,CAAC,GAAG,GAAG;EACzD,IAAI,OAAO,OAAO;GAAE,IAAI;GAAM,OAAO,MAAM;EAAM;CACnD;CACA,MAAM,MAAM,eAAe,GAAG,EAAE;CAChC,OAAO,MAAM;EAAE,IAAI;EAAO,OAAO;CAAI,IAAI;EAAE,IAAI;EAAM,OAAO;CAAG;AACjE"}

package/dist/schema/sources.d.ts

@@ -0,0 +1,103 @@
+/**
+ * The V2 shapes the schema layer reads, copied type for type so @/kit owns them and imports nothing from
+ * the app. Sources at V2 HEAD 9829bf1:
+ *  - Cap: src/lib/access/registry.ts (CAP_IDS, the permission keys a field's `access` names)
+ *  - FieldType, FieldDef: src/data/types.ts (content collection fields)
+ *  - BlockCategory, PropType, PropDef, BlockFieldset, BlockDef: src/features/visuals/model/catalog.ts
+ * The production adapters (src/kit/adapters) map production models onto these; nothing here is wired yet.
+ */
+export declare const CAP_IDS: readonly ["content.view", "content.create", "content.edit", "content.delete", "content.review", "content.publish", "pages.organize", "collections.manage", "schema.view", "schema.manage", "components.use", "components.manage", "media.upload", "media.manage", "seo.edit", "seo.manage", "forms.view", "forms.manage", "forms.submissions", "analytics.view", "visuals.edit", "design.edit", "design.manage", "publish.deploy", "publish.workflow", "branches.create", "branches.merge", "agents.run", "agents.build", "agents.manage", "ai.use", "ai.manage", "comments.create", "comments.moderate", "settings.project", "settings.workspace", "settings.security", "audit.view", "members.view", "members.invite", "members.manage", "members.viewAs", "billing.view", "billing.manage", "domains.manage", "api.view", "api.manage", "integrations.manage", "projects.create", "projects.delete"];
+export type Cap = (typeof CAP_IDS)[number];
+export type FieldType = "text" | "textarea" | "richtext" | "slug" | "number" | "boolean" | "date" | "datetime" | "select" | "multiselect" | "image" | "gallery" | "file" | "video" | "link" | "button" | "reference" | "references" | "color" | "json" | "code" | "repeater" | "group" | "email" | "url" | "location" | "rating" | "tags" | "table";
+export interface FieldDef {
+    id: string;
+    name: string;
+    type: FieldType;
+    required?: boolean;
+    /** Help under the label (CPO D39). Unset → house convention by id/type; "" = none. */
+    help?: string;
+    /** Longer explanation behind the ⓘ next to the label. */
+    helpMore?: string;
+    options?: string[];
+    reference?: string;
+    max?: number;
+    localized?: boolean;
+    fields?: FieldDef[];
+}
+export type BlockCategory = "Navigation" | "Hero" | "Content" | "Social proof" | "Commerce" | "Conversion" | "Collection" | "Media" | "Footer" | "Basic" | "Blog";
+/**
+ * Prop types: every FieldType, plus two shapes only blocks need — "list" (an array of one-line strings: bullets,
+ * features, "what's included"; never tags, D47) and "icon" (a Tabler icon name, picked from the icon picker).
+ */
+export type PropType = FieldType | "list" | "icon";
+export interface PropDef {
+    key: string;
+    label: string;
+    type: PropType;
+    /** Help under the label (CPO D39). Unset → house convention by key/type; "" = none. */
+    help?: string;
+    /** Longer explanation behind the ⓘ next to the label. */
+    helpMore?: string;
+    options?: string[];
+    max?: number;
+    item?: PropDef[];
+    group?: "Content" | "Media" | "Links" | "Data";
+    /** reference props: the collection id the picker lists (e.g. "col_journal"); default = pages */
+    reference?: string;
+    /** D45: the fieldset (BlockDef.fieldsets) this prop sits in. */
+    fieldset?: string;
+    /** Show only when a sibling prop equals one of these values (the form hides it otherwise). */
+    showIf?: {
+        key: string;
+        equals: unknown;
+    };
+    /** Arrays: the noun for "Add {noun}". */
+    itemNoun?: string;
+    placeholder?: string;
+    /** Arrays: the most and fewest items. */
+    min?: number;
+}
+/** D45 fieldset: siblings with one purpose ("Buttons", "Newsletter"), optionally collapsed. */
+export interface BlockFieldset {
+    name: string;
+    title: string;
+    collapsed?: boolean;
+    columns?: 1 | 2;
+}
+export interface BlockDef {
+    type: string;
+    name: string;
+    category: BlockCategory;
+    description: string;
+    icon: string;
+    variants: {
+        id: string;
+        name: string;
+        description?: string;
+    }[];
+    content: PropDef[];
+    /** D45 fieldsets the content props sit in (PropDef.fieldset). */
+    fieldsets?: BlockFieldset[];
+    defaults: Record<string, unknown>;
+    /** Global blocks (nav, footer, announcement) are synced across every page. */
+    global?: boolean;
+    /**
+     * PLACEMENT (CPO D55): where the block fits. "inline" = it fits a text column, so a rich-text body offers it in the
+     * Insert menu's Article group. "section" (the default) = page-width; a body reaches it only through More components.
+     * "page" = a whole page or a feed of other content (Blog post, Recipe, Journal grid, Rich text); never inside a body.
+     */
+    placement?: "inline" | "section" | "page";
+    /** Developer-only lock: marketers can edit content but not swap/remove. */
+    tags?: string[];
+    /**
+     * SLOTS (CPO D8, added by the canvas team) — named areas that hold nested blocks (Tabs panels, Bento cells…).
+     * Instances keep them in `BlockInstance.children[slot]`. `accepts` limits which block types can be dropped in.
+     */
+    slots?: {
+        name: string;
+        label: string;
+        accepts?: string[];
+    }[];
+    /** Nested blocks created with a fresh instance: slot → [type, variant?, props override?][] */
+    childDefaults?: Record<string, [string, string?, Record<string, unknown>?][]>;
+}

package/dist/schema/sources.js

@@ -0,0 +1,65 @@
+//#region src/schema/sources.ts
+/**
+* The V2 shapes the schema layer reads, copied type for type so @/kit owns them and imports nothing from
+* the app. Sources at V2 HEAD 9829bf1:
+*  - Cap: src/lib/access/registry.ts (CAP_IDS, the permission keys a field's `access` names)
+*  - FieldType, FieldDef: src/data/types.ts (content collection fields)
+*  - BlockCategory, PropType, PropDef, BlockFieldset, BlockDef: src/features/visuals/model/catalog.ts
+* The production adapters (src/kit/adapters) map production models onto these; nothing here is wired yet.
+*/
+var CAP_IDS = [
+	"content.view",
+	"content.create",
+	"content.edit",
+	"content.delete",
+	"content.review",
+	"content.publish",
+	"pages.organize",
+	"collections.manage",
+	"schema.view",
+	"schema.manage",
+	"components.use",
+	"components.manage",
+	"media.upload",
+	"media.manage",
+	"seo.edit",
+	"seo.manage",
+	"forms.view",
+	"forms.manage",
+	"forms.submissions",
+	"analytics.view",
+	"visuals.edit",
+	"design.edit",
+	"design.manage",
+	"publish.deploy",
+	"publish.workflow",
+	"branches.create",
+	"branches.merge",
+	"agents.run",
+	"agents.build",
+	"agents.manage",
+	"ai.use",
+	"ai.manage",
+	"comments.create",
+	"comments.moderate",
+	"settings.project",
+	"settings.workspace",
+	"settings.security",
+	"audit.view",
+	"members.view",
+	"members.invite",
+	"members.manage",
+	"members.viewAs",
+	"billing.view",
+	"billing.manage",
+	"domains.manage",
+	"api.view",
+	"api.manage",
+	"integrations.manage",
+	"projects.create",
+	"projects.delete"
+];
+//#endregion
+export { CAP_IDS };
+
+//# sourceMappingURL=sources.js.map

package/dist/schema/sources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sources.js","names":[],"sources":["../../src/schema/sources.ts"],"sourcesContent":["/**\n * The V2 shapes the schema layer reads, copied type for type so @/kit owns them and imports nothing from\n * the app. Sources at V2 HEAD 9829bf1:\n *  - Cap: src/lib/access/registry.ts (CAP_IDS, the permission keys a field's `access` names)\n *  - FieldType, FieldDef: src/data/types.ts (content collection fields)\n *  - BlockCategory, PropType, PropDef, BlockFieldset, BlockDef: src/features/visuals/model/catalog.ts\n * The production adapters (src/kit/adapters) map production models onto these; nothing here is wired yet.\n */\n\nexport const CAP_IDS = [\n  // content\n  \"content.view\",\n  \"content.create\",\n  \"content.edit\",\n  \"content.delete\",\n  \"content.review\",\n  \"content.publish\",\n  // pages and collections\n  \"pages.organize\",\n  \"collections.manage\",\n  // schema\n  \"schema.view\",\n  \"schema.manage\",\n  // components\n  \"components.use\",\n  \"components.manage\",\n  // media\n  \"media.upload\",\n  \"media.manage\",\n  // seo\n  \"seo.edit\",\n  \"seo.manage\",\n  // forms\n  \"forms.view\",\n  \"forms.manage\",\n  \"forms.submissions\",\n  // analytics\n  \"analytics.view\",\n  // visuals and design\n  \"visuals.edit\",\n  \"design.edit\",\n  \"design.manage\",\n  // publish and branches\n  \"publish.deploy\",\n  \"publish.workflow\",\n  \"branches.create\",\n  \"branches.merge\",\n  // agents and AI\n  \"agents.run\",\n  \"agents.build\",\n  \"agents.manage\",\n  \"ai.use\",\n  \"ai.manage\",\n  // comments\n  \"comments.create\",\n  \"comments.moderate\",\n  // settings and audit\n  \"settings.project\",\n  \"settings.workspace\",\n  \"settings.security\",\n  \"audit.view\",\n  // members\n  \"members.view\",\n  \"members.invite\",\n  \"members.manage\",\n  \"members.viewAs\",\n  // billing and domains\n  \"billing.view\",\n  \"billing.manage\",\n  \"domains.manage\",\n  // api, integrations, projects\n  \"api.view\",\n  \"api.manage\",\n  \"integrations.manage\",\n  \"projects.create\",\n  \"projects.delete\",\n] as const;\n\nexport type Cap = (typeof CAP_IDS)[number];\n\nexport type FieldType =\n  | \"text\"\n  | \"textarea\"\n  | \"richtext\"\n  | \"slug\"\n  | \"number\"\n  | \"boolean\"\n  | \"date\"\n  | \"datetime\"\n  | \"select\"\n  | \"multiselect\"\n  | \"image\"\n  | \"gallery\"\n  | \"file\"\n  | \"video\"\n  | \"link\"\n  | \"button\"\n  | \"reference\"\n  | \"references\"\n  | \"color\"\n  | \"json\"\n  | \"code\"\n  | \"repeater\"\n  | \"group\"\n  | \"email\"\n  | \"url\"\n  | \"location\"\n  | \"rating\"\n  | \"tags\"\n  | \"table\";\n\nexport interface FieldDef {\n  id: string;\n  name: string;\n  type: FieldType;\n  required?: boolean;\n  /** Help under the label (CPO D39). Unset → house convention by id/type; \"\" = none. */\n  help?: string;\n  /** Longer explanation behind the ⓘ next to the label. */\n  helpMore?: string;\n  options?: string[];\n  reference?: string;\n  max?: number;\n  localized?: boolean;\n  fields?: FieldDef[];\n}\n\n\nexport type BlockCategory = \"Navigation\" | \"Hero\" | \"Content\" | \"Social proof\" | \"Commerce\" | \"Conversion\" | \"Collection\" | \"Media\" | \"Footer\" | \"Basic\" | \"Blog\";\n\n/**\n * Prop types: every FieldType, plus two shapes only blocks need — \"list\" (an array of one-line strings: bullets,\n * features, \"what's included\"; never tags, D47) and \"icon\" (a Tabler icon name, picked from the icon picker).\n */\nexport type PropType = FieldType | \"list\" | \"icon\";\n\nexport interface PropDef {\n  key: string;\n  label: string;\n  type: PropType;\n  /** Help under the label (CPO D39). Unset → house convention by key/type; \"\" = none. */\n  help?: string;\n  /** Longer explanation behind the ⓘ next to the label. */\n  helpMore?: string;\n  options?: string[];\n  max?: number;\n  item?: PropDef[]; // for repeater\n  group?: \"Content\" | \"Media\" | \"Links\" | \"Data\";\n  /** reference props: the collection id the picker lists (e.g. \"col_journal\"); default = pages */\n  reference?: string;\n  /** D45: the fieldset (BlockDef.fieldsets) this prop sits in. */\n  fieldset?: string;\n  /** Show only when a sibling prop equals one of these values (the form hides it otherwise). */\n  showIf?: { key: string; equals: unknown };\n  /** Arrays: the noun for \"Add {noun}\". */\n  itemNoun?: string;\n  placeholder?: string;\n  /** Arrays: the most and fewest items. */\n  min?: number;\n}\n\n/** D45 fieldset: siblings with one purpose (\"Buttons\", \"Newsletter\"), optionally collapsed. */\nexport interface BlockFieldset {\n  name: string;\n  title: string;\n  collapsed?: boolean;\n  columns?: 1 | 2;\n}\n\nexport interface BlockDef {\n  type: string;\n  name: string;\n  category: BlockCategory;\n  description: string;\n  icon: string; // lucide icon name\n  variants: { id: string; name: string; description?: string }[];\n  content: PropDef[];\n  /** D45 fieldsets the content props sit in (PropDef.fieldset). */\n  fieldsets?: BlockFieldset[];\n  defaults: Record<string, unknown>;\n  /** Global blocks (nav, footer, announcement) are synced across every page. */\n  global?: boolean;\n  /**\n   * PLACEMENT (CPO D55): where the block fits. \"inline\" = it fits a text column, so a rich-text body offers it in the\n   * Insert menu's Article group. \"section\" (the default) = page-width; a body reaches it only through More components.\n   * \"page\" = a whole page or a feed of other content (Blog post, Recipe, Journal grid, Rich text); never inside a body.\n   */\n  placement?: \"inline\" | \"section\" | \"page\";\n  /** Developer-only lock: marketers can edit content but not swap/remove. */\n  tags?: string[];\n  /**\n   * SLOTS (CPO D8, added by the canvas team) — named areas that hold nested blocks (Tabs panels, Bento cells…).\n   * Instances keep them in `BlockInstance.children[slot]`. `accepts` limits which block types can be dropped in.\n   */\n  slots?: { name: string; label: string; accepts?: string[] }[];\n  /** Nested blocks created with a fresh instance: slot → [type, variant?, props override?][] */\n  childDefaults?: Record<string, [string, string?, Record<string, unknown>?][]>;\n}\n"],"mappings":";;;;;;;;;AASA,IAAa,UAAU;CAErB;CACA;CACA;CACA;CACA;CACA;CAEA;CACA;CAEA;CACA;CAEA;CACA;CAEA;CACA;CAEA;CACA;CAEA;CACA;CACA;CAEA;CAEA;CACA;CACA;CAEA;CACA;CACA;CACA;CAEA;CACA;CACA;CACA;CACA;CAEA;CACA;CAEA;CACA;CACA;CACA;CAEA;CACA;CACA;CACA;CAEA;CACA;CACA;CAEA;CACA;CACA;CACA;CACA;AACF"}