@bettercms-ai/kit 0.1.0 → 1.0.0

package/schema/help.d.ts

@@ -0,0 +1,25 @@
+/**
+ * FIELD HELP — CPO D39, narrowed by D51 "Help text is the exception". One place for the grey line under a label.
+ *
+ * Precedence (first match wins):
+ *   1. `field.description` written on the schema. `""` opts out on purpose.
+ *   2. A computed line from the field's own settings (slug before publish, number ranges).
+ *   3. A convention from this file, matched on field NAME + TYPE. Only facts that are true for that field in every
+ *      block live here, and only facts the editor cannot see from the label and the control.
+ *
+ * The rule (D51, enforced by scripts/brain/check-help.ts):
+ *  - Most fields get NO help. Ask: "Does the editor need this to type the right value?" If no, no help.
+ *  - Allowed: a non-obvious format or unit ("In minutes.", "A .vtt file."), where it shows when the canvas can't
+ *    show it ("Shown in search results."), a real constraint or consequence ("Changing it once live breaks links."),
+ *    a fallback ("Leave empty to use the page title.").
+ *  - Never: restating the label, writing advice ("Keep it short", "Start with a verb", "2–4 words"), marketing
+ *    theory, internal or design-system notes ("Label and link are one unit"), examples that belong in `placeholder`.
+ *  - Length guidance is a counter (`validation.max` / `recommendedMax`), never a sentence.
+ *  - One short sentence, under 90 characters, no em dash. Anything longer goes in `helpMore` (the ⓘ), sparingly.
+ *  - No type-wide defaults: a heading, a button or an image gets nothing just for being one.
+ */
+import type { FieldSchema } from "./types";
+/** The convention for a field, or undefined. Does not look at `description`; callers decide precedence. */
+export declare function conventionalHelp(field: Pick<FieldSchema, "name" | "type">): string | undefined;
+/** Help for a field following D39 precedence. `computed` is the field's own derived line (slug, number range). */
+export declare function resolveHelp(field: FieldSchema, computed?: string): string | undefined;

package/schema/help.js

@@ -0,0 +1,54 @@
+//#region src/kit/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: "Not shown. Read by screen readers and search engines."
+	},
+	{
+		names: ["anchor"],
+		types: TEXT,
+		help: "Lowercase, no spaces. Links like /about#team 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. */
+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 { conventionalHelp, resolveHelp };
+
+//# sourceMappingURL=help.js.map

package/schema/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","names":[],"sources":["../../src/kit/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: \"Not shown. Read by screen readers and search engines.\" },\n  // No SEO conventions (metaTitle, metaDescription, canonical, noindex, schemaType): SEO is native, never a modelled field.\n  { names: [\"anchor\"], types: TEXT, help: \"Lowercase, no spaces. Links like /about#team 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. */\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,OAAO;;AAGtD,IAAM,QAAgB;CACpB;EAAE,OAAO,CAAC,WAAW,UAAU;EAAE,OAAO;EAAM,MAAM;EAAyC;CAC7F;EAAE,OAAO,CAAC,MAAM;EAAE,OAAO;EAAM,MAAM;EAAyD;CAE9F;EAAE,OAAO,CAAC,SAAS;EAAE,OAAO;EAAM,MAAM;EAA2D;CACnG;EAAE,OAAO,CAAC,cAAc,QAAQ;EAAE,OAAO,CAAC,QAAQ;EAAE,MAAM;EAA4C;CACtG;EAAE,OAAO;GAAC;GAAa;GAAe;GAAc;EAAE,OAAO,CAAC,QAAQ,WAAW;EAAE,MAAM;EAA4B;CACrH;EAAE,OAAO,CAAC,cAAc;EAAE,OAAO,CAAC,SAAS;EAAE,MAAM;EAAe;CACnE;;AAGD,IAAM,UAAwD,EAC5D,MAAM,kEACP;;AAGD,SAAgB,iBAAiB,OAA+D;AAE9F,QADa,MAAM,MAAM,MAAM,EAAE,MAAM,SAAS,MAAM,KAAK,KAAK,CAAC,EAAE,SAAS,EAAE,MAAM,SAAS,MAAM,KAAK,EAAE,EAC7F,QAAQ,QAAQ,MAAM;;;AAIrC,SAAgB,YAAY,OAAoB,UAAuC;AACrF,KAAI,MAAM,gBAAgB,KAAA,EAAW,QAAO,MAAM,eAAe,KAAA;AACjE,QAAO,YAAY,iBAAiB,MAAM"}

package/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/schema/scale.js

@@ -0,0 +1,250 @@
+//#region src/kit/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/schema/scale.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scale.js","names":[],"sources":["../../src/kit/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":"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"}

package/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/schema/sources.js

@@ -0,0 +1,65 @@
+//#region src/kit/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/schema/sources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sources.js","names":[],"sources":["../../src/kit/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;CACD"}