@bettercms-ai/kit 0.1.1 → 2.0.0

package/dist/library/types.d.ts

@@ -0,0 +1,42 @@
+/**
+ * KIT LIBRARY — the benchmark set of website sections, modelled in our schema language.
+ * Every entry is: a real-world section → the schema we'd generate for it → realistic values → why it's modelled that way.
+ * The MCP/CLI uses these as the reference for "HTML section → schema + component" conversion (phase 2 exports them to Markdown).
+ */
+import type { KitExample } from "./examples";
+import type { TypeSchema } from "../schema/types";
+export type KitCategory = "Navigation & chrome" | "Heroes" | "Features & storytelling" | "Social proof" | "Media & galleries" | "Commerce" | "Pricing & plans" | "Conversion & forms" | "Listings & feeds" | "Long-form & docs" | "Company & people" | "Events & places" | "Data & interactive" | "Advanced patterns";
+/** Edge cases an entry exercises — the filter chips on the kit page. */
+export type EdgeTag = "deep-nesting" | "polymorphic-array" | "slots" | "conditional" | "references" | "global-synced" | "localized" | "rich-text" | "media-heavy" | "variants" | "repeater" | "validation" | "dynamic-query" | "personalization" | "embed" | "form" | "commerce" | "seo-structured" | "a11y" | "responsive-layout";
+export interface KitModelNotes {
+    /** One paragraph: why the schema is shaped this way (what's an object vs array vs reference, what's global, what's design). */
+    why: string;
+    /** How Sanity would model the same thing (type names), so the team can compare. */
+    sanity?: string;
+    /** What in raw HTML tells the converter this is this section (DOM/visual signals). */
+    htmlSignals: string[];
+    /** Instructions for the MCP/CLI converter: field mapping, what to extract, what to leave as design. */
+    mcp: string;
+    /** Known pitfalls / edge cases this entry exists to catch. */
+    pitfalls?: string[];
+}
+/**
+ * How the Kit Library's schematic preview arranges the section (optional — it infers from the variant, the
+ * schema name and the field shapes when unset). Set it when the inference would be wrong.
+ */
+export type KitPreviewLayout = "split" | "split-reverse" | "centered" | "grid-2" | "grid-3" | "grid-4" | "list" | "carousel" | "table" | "form" | "nav" | "footer" | "banner" | "accordion" | "tabs" | "bento" | "stats" | "logos" | "gallery" | "media" | "article" | "timeline";
+export interface KitEntry extends KitExample {
+    category: KitCategory;
+    tags: EdgeTag[];
+    notes: KitModelNotes;
+    /** Brand of the realistic sample (Caldera by default; others allowed for variety). */
+    brand?: string;
+    /** Optional preview arrangement hint for the Kit Library (inferred when unset). */
+    previewLayout?: KitPreviewLayout;
+    /**
+     * Entry-local block types that this entry's SLOTS may hold (e.g. a Columns or Accordion block that is not in
+     * the example BLOCK_LIBRARY). The kit page must resolve slot children against these first, then the library —
+     * otherwise drill-in stops at the first unknown `_type`.
+     */
+    blocks?: TypeSchema[];
+}

package/dist/schema/adapters.d.ts

@@ -0,0 +1,28 @@
+/**
+ * ADAPTERS — today's field definitions → the Block Kit schema, so each editor switches to <SchemaForm> in one line.
+ *
+ *   Visuals inspector:  <SchemaForm schema={blockDefToSchema(def)} value={block.props} onChange={…} />
+ *   Content editor:     <SchemaForm schema={fieldDefsToSchema(collection.fields, { values })} … />
+ *
+ * Both catalogs are loose (repeaters without item fields, links stored as strings); the adapters infer item
+ * fields from sample values and mark legacy string values with `valueShape: "string"` so data round-trips
+ * unchanged.
+ */
+import type { BlockDef, FieldDef, PropDef } from "./sources";
+import type { FieldSchema, TypeSchema } from "./types";
+type Obj = Record<string, unknown>;
+export declare const titleFromKey: (k: string) => string;
+/** Infer a field from a sample value (used for repeaters/groups without declared fields). */
+export declare function inferField(key: string, sample: unknown): FieldSchema;
+export declare function propDefToField(p: PropDef, sample?: unknown): FieldSchema;
+/** A visual-editor block definition → TypeSchema. Groups appear only when props use more than one group. */
+export declare function blockDefToSchema(def: BlockDef): TypeSchema;
+export declare function fieldDefToSchema(def: FieldDef, sample?: unknown): FieldSchema;
+/** A collection's (or page's) field list → TypeSchema for the document editor. */
+export declare function fieldDefsToSchema(fields: FieldDef[], opts?: {
+    name?: string;
+    title?: string;
+    values?: Obj;
+    kind?: TypeSchema["kind"];
+}): TypeSchema;
+export {};

package/dist/schema/adapters.js

@@ -0,0 +1,492 @@
+//#region src/schema/adapters.ts
+var isObj = (v) => !!v && typeof v === "object" && !Array.isArray(v);
+var options = (o) => o?.map((x) => ({
+	value: x,
+	label: x
+}));
+/** Nice titles for inferred keys ("q" → "Question"). */
+var TITLES = {
+	q: "Question",
+	a: "Answer",
+	href: "Link",
+	url: "Link",
+	cta: "Button",
+	img: "Image",
+	desc: "Description",
+	qty: "Amount",
+	featured: "Highlighted",
+	note: "Note",
+	links: "Links",
+	price: "Price",
+	name: "Name",
+	title: "Title",
+	label: "Label"
+};
+var titleFromKey = (k) => TITLES[k] ?? (k.charAt(0).toUpperCase() + k.slice(1)).replace(/([a-z])([A-Z])/g, "$1 $2").replace(/[_-]/g, " ").replace(/ (\w)/g, (m) => m.toLowerCase());
+var looksLikeImage = (k, v) => typeof v === "string" && (/\b(image|img|photo|cover|avatar|logo)\b/i.test(k) || /picsum|\.(jpe?g|png|webp|avif|svg)(\?|$)/.test(v));
+/** Infer a field from a sample value (used for repeaters/groups without declared fields). */
+function inferField(key, sample) {
+	const title = titleFromKey(key);
+	if (Array.isArray(sample)) {
+		const first = sample[0];
+		if (isObj(first)) return {
+			name: key,
+			title,
+			type: "array",
+			of: [inferItem(key, first)]
+		};
+		if (typeof first === "string" && sample.every((x) => looksLikeImage(key, x)) && sample.length) return {
+			name: key,
+			title,
+			type: "array",
+			of: [{
+				name: "image",
+				title: "Image",
+				type: "image",
+				valueShape: "string"
+			}]
+		};
+		return {
+			name: key,
+			title,
+			type: "array",
+			layout: "list",
+			of: [{
+				name: "value",
+				title: singular(title),
+				type: "string"
+			}]
+		};
+	}
+	if (typeof sample === "boolean") return {
+		name: key,
+		title,
+		type: "boolean"
+	};
+	if (typeof sample === "number") return {
+		name: key,
+		title,
+		type: "number"
+	};
+	if (looksLikeImage(key, sample)) return {
+		name: key,
+		title,
+		type: "image",
+		valueShape: "string"
+	};
+	if (isObj(sample)) {
+		if ("href" in sample && "label" in sample) return {
+			name: key,
+			title,
+			type: "button"
+		};
+		if ("href" in sample) return {
+			name: key,
+			title,
+			type: "link"
+		};
+		if ("url" in sample) return {
+			name: key,
+			title,
+			type: "image"
+		};
+		return {
+			name: key,
+			title,
+			type: "object",
+			fields: Object.entries(sample).filter(([k]) => !k.startsWith("_")).map(([k, v]) => inferField(k, v))
+		};
+	}
+	if (key === "href" || key === "link") return {
+		name: key,
+		title,
+		type: "link",
+		valueShape: "string"
+	};
+	if (typeof sample === "string" && /<\/?(p|h\d|ul|ol|strong|em)\b/.test(sample)) return {
+		name: key,
+		title,
+		type: "richtext"
+	};
+	if (typeof sample === "string" && sample.length > 60) return {
+		name: key,
+		title,
+		type: "text"
+	};
+	return {
+		name: key,
+		title,
+		type: "string"
+	};
+}
+function inferItem(arrayKey, sample) {
+	const fields = Object.entries(sample).filter(([k]) => !k.startsWith("_")).map(([k, v]) => inferField(k, v));
+	const first = fields.find((f) => f.type === "string" || f.type === "text");
+	const second = fields.find((f) => f !== first && (f.type === "string" || f.type === "text" || f.type === "richtext"));
+	const media = fields.find((f) => f.type === "image");
+	return {
+		name: `${arrayKey}Item`,
+		title: singular(titleFromKey(arrayKey)),
+		type: "object",
+		fields,
+		preview: {
+			title: first?.name,
+			subtitle: second?.name,
+			media: media?.name
+		}
+	};
+}
+var cap = (t) => t.charAt(0).toUpperCase() + t.slice(1);
+var singular = (t) => t.endsWith("ies") ? `${t.slice(0, -3)}y` : t.endsWith("s") && !t.endsWith("ss") ? t.slice(0, -1) : t;
+function propDefToField(p, sample) {
+	const f = propDefToFieldBase(p, sample);
+	return {
+		...f,
+		...p.fieldset ? { fieldset: p.fieldset } : {},
+		...p.showIf ? { hidden: {
+			field: p.showIf.key,
+			equals: p.showIf.equals
+		} } : {},
+		...p.itemNoun ? { itemNoun: p.itemNoun } : {},
+		...p.placeholder ? { placeholder: p.placeholder } : {},
+		...p.min != null && f.type === "array" ? { validation: {
+			...f.validation,
+			min: p.min
+		} } : {},
+		...p.max != null && f.type === "array" ? { validation: {
+			...f.validation,
+			max: p.max
+		} } : {}
+	};
+}
+function propDefToFieldBase(p, sample) {
+	const base = {
+		name: p.key,
+		title: p.label,
+		description: p.help,
+		helpMore: p.helpMore,
+		group: p.group?.toLowerCase()
+	};
+	const max = p.max ? { max: p.max } : void 0;
+	switch (p.type) {
+		case "list": return {
+			...base,
+			type: "array",
+			layout: "list",
+			of: [{
+				name: "value",
+				title: p.itemNoun ? cap(p.itemNoun) : singular(p.label),
+				type: "string"
+			}]
+		};
+		case "icon": return {
+			...base,
+			type: "icon"
+		};
+		case "boolean": return {
+			...base,
+			type: "boolean"
+		};
+		case "references": return {
+			...base,
+			type: "array",
+			validation: { unique: true },
+			of: [{
+				name: `${p.key}Ref`,
+				title: singular(p.label),
+				type: "reference",
+				reference: { to: [p.reference ?? "page"] }
+			}]
+		};
+		case "group": {
+			const first = isObj(sample) ? sample : void 0;
+			if (!p.item?.length) break;
+			return {
+				...base,
+				type: "object",
+				fields: p.item.map((x) => propDefToField(x, first?.[x.key]))
+			};
+		}
+		case "text": return {
+			...base,
+			type: "string",
+			validation: max,
+			ai: true
+		};
+		case "textarea": return {
+			...base,
+			type: "text",
+			validation: max,
+			ai: true
+		};
+		case "richtext": return {
+			...base,
+			type: "richtext",
+			ai: true
+		};
+		case "image": return {
+			...base,
+			type: "image",
+			valueShape: typeof sample === "string" ? "string" : void 0
+		};
+		case "gallery": return {
+			...base,
+			type: "array",
+			of: [{
+				name: "image",
+				title: "Image",
+				type: "image",
+				valueShape: "string"
+			}]
+		};
+		case "link": return {
+			...base,
+			type: "link",
+			valueShape: typeof sample === "string" ? "string" : void 0
+		};
+		case "button": return {
+			...base,
+			type: "button"
+		};
+		case "tags": return {
+			...base,
+			type: "tags"
+		};
+		case "select": return {
+			...base,
+			type: "select",
+			options: options(p.options)
+		};
+		case "number": return {
+			...base,
+			type: "number"
+		};
+		case "table": return {
+			...base,
+			type: "table",
+			validation: { required: true }
+		};
+		case "reference": return {
+			...base,
+			type: "reference",
+			reference: { to: [p.reference ?? (p.key === "form" ? "form" : p.key === "collection" ? "collection" : "page")] }
+		};
+		case "repeater": {
+			const first = (Array.isArray(sample) ? sample : []).find(isObj);
+			const fields = p.item?.length ? p.item.map((x) => propDefToField(x, first?.[x.key])) : first ? inferItem(p.key, first).fields : [{
+				name: "label",
+				title: "Label",
+				type: "string"
+			}];
+			const t = fields.find((f) => f.type === "string" || f.type === "text");
+			const s = fields.find((f) => f !== t && (f.type === "string" || f.type === "text" || f.type === "richtext"));
+			return {
+				...base,
+				type: "array",
+				of: [{
+					name: `${p.key}Item`,
+					title: p.itemNoun ? cap(p.itemNoun) : singular(p.label),
+					type: "object",
+					fields,
+					icon: void 0,
+					preview: {
+						title: t?.name,
+						subtitle: s?.name,
+						media: fields.find((f) => f.type === "image")?.name
+					}
+				}]
+			};
+		}
+	}
+	return {
+		...base,
+		...inferField(p.key, sample),
+		title: p.label
+	};
+}
+/** A visual-editor block definition → TypeSchema. Groups appear only when props use more than one group. */
+function blockDefToSchema(def) {
+	const fields = def.content.map((p) => propDefToField(p, def.defaults[p.key]));
+	const used = Array.from(new Set(fields.map((f) => f.group ?? "content")));
+	const groups = used.length > 1 ? used.map((g, i) => ({
+		name: g,
+		title: g.charAt(0).toUpperCase() + g.slice(1),
+		default: g === "content" || i === 0
+	})) : void 0;
+	return {
+		name: def.type,
+		title: def.name,
+		kind: def.global ? "global" : "block",
+		icon: def.icon,
+		category: def.category,
+		...def.placement ? { placement: def.placement } : {},
+		description: def.description,
+		variants: def.variants,
+		initialValue: def.defaults,
+		groups,
+		...def.fieldsets?.length ? { fieldsets: def.fieldsets.map((f) => ({
+			name: f.name,
+			title: f.title,
+			collapsed: f.collapsed,
+			columns: f.columns
+		})) } : {},
+		fields: groups ? fields.map((f) => ({
+			...f,
+			group: f.group ?? "content"
+		})) : fields.map(({ group: _g, ...f }) => f)
+	};
+}
+var SIMPLE = {
+	text: "string",
+	textarea: "text",
+	richtext: "richtext",
+	slug: "slug",
+	boolean: "boolean",
+	date: "date",
+	datetime: "datetime",
+	image: "image",
+	file: "file",
+	video: "video",
+	link: "link",
+	button: "button",
+	color: "color",
+	json: "json",
+	code: "code",
+	email: "email",
+	url: "url",
+	location: "geopoint",
+	rating: "rating",
+	tags: "tags",
+	table: "table"
+};
+function fieldDefToSchema(def, sample) {
+	const base = {
+		name: def.id,
+		title: def.name,
+		type: "string",
+		description: def.help,
+		helpMore: def.helpMore,
+		localized: def.localized,
+		validation: def.required || def.max ? {
+			required: def.required,
+			max: def.max
+		} : void 0
+	};
+	const simple = SIMPLE[def.type];
+	if (simple) {
+		const f = {
+			...base,
+			type: simple
+		};
+		if (simple === "string" || simple === "text" || simple === "richtext") f.ai = true;
+		if (simple === "image" && typeof sample === "string") f.valueShape = "string";
+		if (simple === "link" && typeof sample === "string") f.valueShape = "string";
+		return f;
+	}
+	switch (def.type) {
+		case "number": {
+			const unit = def.help && def.help.length < 14 ? def.help : def.id === "price" ? "USD" : void 0;
+			return {
+				...base,
+				type: "number",
+				description: unit ? void 0 : def.help,
+				numeric: unit ? { unit } : void 0
+			};
+		}
+		case "select": return {
+			...base,
+			type: "select",
+			options: options(def.options)
+		};
+		case "multiselect": return {
+			...base,
+			type: "multiselect",
+			options: options(def.options)
+		};
+		case "reference": return {
+			...base,
+			type: "reference",
+			reference: { to: [def.id === "form" ? "form" : def.id === "collection" && !def.reference ? "collection" : def.reference ?? "page"] }
+		};
+		case "references": return {
+			...base,
+			type: "array",
+			of: [{
+				name: `${def.id}Ref`,
+				title: singular(def.name),
+				type: "reference",
+				reference: { to: [def.reference ?? "page"] }
+			}]
+		};
+		case "gallery": return {
+			...base,
+			type: "array",
+			arrayLayout: "grid",
+			of: [{
+				name: "image",
+				title: "Image",
+				type: "image"
+			}]
+		};
+		case "group": return {
+			...base,
+			type: "object",
+			fields: (def.fields ?? []).map((f) => fieldDefToSchema(f, isObj(sample) ? sample[f.id] : void 0))
+		};
+		case "repeater": {
+			const first = (Array.isArray(sample) ? sample : []).find(isObj);
+			const fields = def.fields?.length ? def.fields.map((f) => fieldDefToSchema(f, first?.[f.id])) : first ? inferItem(def.id, first).fields : def.id === "ingredients" ? [{
+				name: "item",
+				title: "Ingredient",
+				type: "string"
+			}, {
+				name: "qty",
+				title: "Amount",
+				type: "string"
+			}] : [{
+				name: "label",
+				title: "Label",
+				type: "string"
+			}, {
+				name: "value",
+				title: "Value",
+				type: "string"
+			}];
+			const t = fields.find((f) => f.type === "string" || f.type === "text");
+			const s = fields.find((f) => f !== t && (f.type === "string" || f.type === "text"));
+			return {
+				...base,
+				type: "array",
+				validation: def.required ? { required: true } : void 0,
+				of: [{
+					name: `${def.id}Item`,
+					title: singular(def.name),
+					type: "object",
+					fields,
+					preview: {
+						title: t?.name,
+						subtitle: s?.name
+					}
+				}]
+			};
+		}
+		default: return {
+			...base,
+			...inferField(def.id, sample),
+			title: def.name
+		};
+	}
+}
+/** A collection's (or page's) field list → TypeSchema for the document editor. */
+function fieldDefsToSchema(fields, opts = {}) {
+	return {
+		name: opts.name ?? "document",
+		title: opts.title ?? "Fields",
+		kind: opts.kind ?? "entry",
+		fields: fields.map((f) => fieldDefToSchema(f, opts.values?.[f.id]))
+	};
+}
+//#endregion
+export { blockDefToSchema, fieldDefToSchema, fieldDefsToSchema, inferField, propDefToField, titleFromKey };
+
+//# sourceMappingURL=adapters.js.map

package/dist/schema/adapters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.js","names":[],"sources":["../../src/schema/adapters.ts"],"sourcesContent":["/**\n * ADAPTERS — today's field definitions → the Block Kit schema, so each editor switches to <SchemaForm> in one line.\n *\n *   Visuals inspector:  <SchemaForm schema={blockDefToSchema(def)} value={block.props} onChange={…} />\n *   Content editor:     <SchemaForm schema={fieldDefsToSchema(collection.fields, { values })} … />\n *\n * Both catalogs are loose (repeaters without item fields, links stored as strings); the adapters infer item\n * fields from sample values and mark legacy string values with `valueShape: \"string\"` so data round-trips\n * unchanged.\n */\nimport type { BlockDef, FieldDef, FieldType, PropDef } from \"./sources\";\nimport type { FieldGroup, FieldSchema, Option, TypeSchema } from \"./types\";\n\ntype Obj = Record<string, unknown>;\nconst isObj = (v: unknown): v is Obj => !!v && typeof v === \"object\" && !Array.isArray(v);\nconst options = (o?: string[]): Option[] | undefined => o?.map((x) => ({ value: x, label: x }));\n\n/** Nice titles for inferred keys (\"q\" → \"Question\"). */\nconst TITLES: Record<string, string> = {\n  q: \"Question\", a: \"Answer\", href: \"Link\", url: \"Link\", cta: \"Button\", img: \"Image\", desc: \"Description\", qty: \"Amount\",\n  featured: \"Highlighted\", note: \"Note\", links: \"Links\", price: \"Price\", name: \"Name\", title: \"Title\", label: \"Label\",\n};\nexport const titleFromKey = (k: string) => TITLES[k] ?? (k.charAt(0).toUpperCase() + k.slice(1)).replace(/([a-z])([A-Z])/g, \"$1 $2\").replace(/[_-]/g, \" \").replace(/ (\\w)/g, (m) => m.toLowerCase());\nconst looksLikeImage = (k: string, v: unknown) => typeof v === \"string\" && (/\\b(image|img|photo|cover|avatar|logo)\\b/i.test(k) || /picsum|\\.(jpe?g|png|webp|avif|svg)(\\?|$)/.test(v));\n\n/** Infer a field from a sample value (used for repeaters/groups without declared fields). */\nexport function inferField(key: string, sample: unknown): FieldSchema {\n  const title = titleFromKey(key);\n  if (Array.isArray(sample)) {\n    const first = sample[0];\n    if (isObj(first)) return { name: key, title, type: \"array\", of: [inferItem(key, first)] };\n    if (typeof first === \"string\" && sample.every((x) => looksLikeImage(key, x)) && sample.length)\n      return { name: key, title, type: \"array\", of: [{ name: \"image\", title: \"Image\", type: \"image\", valueShape: \"string\" }] };\n    return { name: key, title, type: \"array\", layout: \"list\", of: [{ name: \"value\", title: singular(title), type: \"string\" }] };\n  }\n  if (typeof sample === \"boolean\") return { name: key, title, type: \"boolean\" };\n  if (typeof sample === \"number\") return { name: key, title, type: \"number\" };\n  if (looksLikeImage(key, sample)) return { name: key, title, type: \"image\", valueShape: \"string\" };\n  if (isObj(sample)) {\n    if (\"href\" in sample && \"label\" in sample) return { name: key, title, type: \"button\" };\n    if (\"href\" in sample) return { name: key, title, type: \"link\" };\n    if (\"url\" in sample) return { name: key, title, type: \"image\" };\n    return { name: key, title, type: \"object\", fields: Object.entries(sample).filter(([k]) => !k.startsWith(\"_\")).map(([k, v]) => inferField(k, v)) };\n  }\n  if (key === \"href\" || key === \"link\") return { name: key, title, type: \"link\", valueShape: \"string\" };\n  if (typeof sample === \"string\" && /<\\/?(p|h\\d|ul|ol|strong|em)\\b/.test(sample)) return { name: key, title, type: \"richtext\" };\n  if (typeof sample === \"string\" && sample.length > 60) return { name: key, title, type: \"text\" };\n  return { name: key, title, type: \"string\" };\n}\nfunction inferItem(arrayKey: string, sample: Obj): FieldSchema {\n  const fields = Object.entries(sample).filter(([k]) => !k.startsWith(\"_\")).map(([k, v]) => inferField(k, v));\n  const first = fields.find((f) => f.type === \"string\" || f.type === \"text\");\n  const second = fields.find((f) => f !== first && (f.type === \"string\" || f.type === \"text\" || f.type === \"richtext\"));\n  const media = fields.find((f) => f.type === \"image\");\n  return {\n    name: `${arrayKey}Item`,\n    title: singular(titleFromKey(arrayKey)),\n    type: \"object\",\n    fields,\n    preview: { title: first?.name, subtitle: second?.name, media: media?.name },\n  };\n}\nconst cap = (t: string) => t.charAt(0).toUpperCase() + t.slice(1);\nconst singular = (t: string) => (t.endsWith(\"ies\") ? `${t.slice(0, -3)}y` : t.endsWith(\"s\") && !t.endsWith(\"ss\") ? t.slice(0, -1) : t);\n\n/* ── Visuals catalog (PropDef) → FieldSchema ─────────────────────────── */\nexport function propDefToField(p: PropDef, sample?: unknown): FieldSchema {\n  const f = propDefToFieldBase(p, sample);\n  // D45 organisation + conditions + array nouns ride along on every type\n  return {\n    ...f,\n    ...(p.fieldset ? { fieldset: p.fieldset } : {}),\n    ...(p.showIf ? { hidden: { field: p.showIf.key, equals: p.showIf.equals } } : {}),\n    ...(p.itemNoun ? { itemNoun: p.itemNoun } : {}),\n    ...(p.placeholder ? { placeholder: p.placeholder } : {}),\n    ...(p.min != null && f.type === \"array\" ? { validation: { ...f.validation, min: p.min } } : {}),\n    ...(p.max != null && f.type === \"array\" ? { validation: { ...f.validation, max: p.max } } : {}),\n  };\n}\n\nfunction propDefToFieldBase(p: PropDef, sample?: unknown): FieldSchema {\n  const base = { name: p.key, title: p.label, description: p.help, helpMore: p.helpMore, group: p.group?.toLowerCase() } satisfies Partial<FieldSchema>;\n  const max = p.max ? { max: p.max } : undefined;\n  switch (p.type) {\n    case \"list\":\n      // D47: one-line items are an array of strings, never tags\n      return { ...base, type: \"array\", layout: \"list\", of: [{ name: \"value\", title: p.itemNoun ? cap(p.itemNoun) : singular(p.label), type: \"string\" }] };\n    case \"icon\":\n      return { ...base, type: \"icon\" };\n    case \"boolean\":\n      return { ...base, type: \"boolean\" };\n    case \"references\":\n      return { ...base, type: \"array\", validation: { unique: true }, of: [{ name: `${p.key}Ref`, title: singular(p.label), type: \"reference\", reference: { to: [p.reference ?? \"page\"] } }] };\n    case \"group\": {\n      const first = isObj(sample) ? sample : undefined;\n      if (!p.item?.length) break;\n      return { ...base, type: \"object\", fields: p.item.map((x) => propDefToField(x, first?.[x.key])) };\n    }\n    case \"text\":\n      return { ...base, type: \"string\", validation: max, ai: true };\n    case \"textarea\":\n      return { ...base, type: \"text\", validation: max, ai: true };\n    case \"richtext\":\n      return { ...base, type: \"richtext\", ai: true };\n    case \"image\":\n      return { ...base, type: \"image\", valueShape: typeof sample === \"string\" ? \"string\" : undefined };\n    case \"gallery\":\n      return { ...base, type: \"array\", of: [{ name: \"image\", title: \"Image\", type: \"image\", valueShape: \"string\" }] };\n    case \"link\":\n      return { ...base, type: \"link\", valueShape: typeof sample === \"string\" ? \"string\" : undefined };\n    case \"button\":\n      return { ...base, type: \"button\" };\n    case \"tags\":\n      return { ...base, type: \"tags\" };\n    case \"select\":\n      return { ...base, type: \"select\", options: options(p.options) };\n    case \"number\":\n      return { ...base, type: \"number\" };\n    case \"table\":\n      return { ...base, type: \"table\", validation: { required: true } };\n    case \"reference\":\n      return { ...base, type: \"reference\", reference: { to: [p.reference ?? (p.key === \"form\" ? \"form\" : p.key === \"collection\" ? \"collection\" : \"page\")] } };\n    case \"repeater\": {\n      const items = Array.isArray(sample) ? sample : [];\n      const first = items.find(isObj);\n      const fields = p.item?.length ? p.item.map((x) => propDefToField(x, first?.[x.key])) : first ? inferItem(p.key, first).fields! : [{ name: \"label\", title: \"Label\", type: \"string\" as const }];\n      const t = fields.find((f) => f.type === \"string\" || f.type === \"text\");\n      const s = fields.find((f) => f !== t && (f.type === \"string\" || f.type === \"text\" || f.type === \"richtext\"));\n      return {\n        ...base,\n        type: \"array\",\n        of: [{ name: `${p.key}Item`, title: p.itemNoun ? cap(p.itemNoun) : singular(p.label), type: \"object\", fields, icon: undefined, preview: { title: t?.name, subtitle: s?.name, media: fields.find((f) => f.type === \"image\")?.name } }],\n      };\n    }\n    default:\n      break;\n  }\n  return { ...base, ...inferField(p.key, sample), title: p.label };\n}\n\n/** A visual-editor block definition → TypeSchema. Groups appear only when props use more than one group. */\nexport function blockDefToSchema(def: BlockDef): TypeSchema {\n  const fields = def.content.map((p) => propDefToField(p, def.defaults[p.key]));\n  const used = Array.from(new Set(fields.map((f) => f.group ?? \"content\")));\n  const groups: FieldGroup[] | undefined =\n    used.length > 1 ? used.map((g, i) => ({ name: g, title: g.charAt(0).toUpperCase() + g.slice(1), default: g === \"content\" || i === 0 })) : undefined;\n  return {\n    name: def.type,\n    title: def.name,\n    kind: def.global ? \"global\" : \"block\",\n    icon: def.icon,\n    category: def.category,\n    ...(def.placement ? { placement: def.placement } : {}),\n    description: def.description,\n    variants: def.variants,\n    initialValue: def.defaults,\n    groups,\n    ...(def.fieldsets?.length ? { fieldsets: def.fieldsets.map((f) => ({ name: f.name, title: f.title, collapsed: f.collapsed, columns: f.columns })) } : {}),\n    fields: groups ? fields.map((f) => ({ ...f, group: f.group ?? \"content\" })) : fields.map(({ group: _g, ...f }) => f),\n  };\n}\n\n/* ── Content collections (FieldDef) → FieldSchema ────────────────────── */\nconst SIMPLE: Partial<Record<FieldType, FieldSchema[\"type\"]>> = {\n  text: \"string\", textarea: \"text\", richtext: \"richtext\", slug: \"slug\", boolean: \"boolean\", date: \"date\", datetime: \"datetime\",\n  image: \"image\", file: \"file\", video: \"video\", link: \"link\", button: \"button\", color: \"color\", json: \"json\", code: \"code\",\n  email: \"email\", url: \"url\", location: \"geopoint\", rating: \"rating\", tags: \"tags\", table: \"table\",\n};\n\nexport function fieldDefToSchema(def: FieldDef, sample?: unknown): FieldSchema {\n  const base: FieldSchema = {\n    name: def.id,\n    title: def.name,\n    type: \"string\",\n    description: def.help,\n    helpMore: def.helpMore,\n    localized: def.localized,\n    validation: def.required || def.max ? { required: def.required, max: def.max } : undefined,\n  };\n  const simple = SIMPLE[def.type];\n  if (simple) {\n    const f: FieldSchema = { ...base, type: simple };\n    if (simple === \"string\" || simple === \"text\" || simple === \"richtext\") f.ai = true;\n    if (simple === \"image\" && typeof sample === \"string\") f.valueShape = \"string\";\n    if (simple === \"link\" && typeof sample === \"string\") f.valueShape = \"string\";\n    return f;\n  }\n  switch (def.type) {\n    case \"number\": {\n      const unit = def.help && def.help.length < 14 ? def.help : def.id === \"price\" ? \"USD\" : undefined;\n      return { ...base, type: \"number\", description: unit ? undefined : def.help, numeric: unit ? { unit } : undefined };\n    }\n    case \"select\":\n      return { ...base, type: \"select\", options: options(def.options) };\n    case \"multiselect\":\n      return { ...base, type: \"multiselect\", options: options(def.options) };\n    case \"reference\":\n      return { ...base, type: \"reference\", reference: { to: [def.id === \"form\" ? \"form\" : def.id === \"collection\" && !def.reference ? \"collection\" : def.reference ?? \"page\"] } };\n    case \"references\":\n      return { ...base, type: \"array\", of: [{ name: `${def.id}Ref`, title: singular(def.name), type: \"reference\", reference: { to: [def.reference ?? \"page\"] } }] };\n    case \"gallery\":\n      return { ...base, type: \"array\", arrayLayout: \"grid\", of: [{ name: \"image\", title: \"Image\", type: \"image\" }] };\n    case \"group\":\n      return { ...base, type: \"object\", fields: (def.fields ?? []).map((f) => fieldDefToSchema(f, isObj(sample) ? sample[f.id] : undefined)) };\n    case \"repeater\": {\n      const items = Array.isArray(sample) ? sample : [];\n      const first = items.find(isObj);\n      const fields = def.fields?.length\n        ? def.fields.map((f) => fieldDefToSchema(f, first?.[f.id]))\n        : first\n          ? inferItem(def.id, first).fields!\n          : def.id === \"ingredients\"\n            ? [{ name: \"item\", title: \"Ingredient\", type: \"string\" as const }, { name: \"qty\", title: \"Amount\", type: \"string\" as const }]\n            : [{ name: \"label\", title: \"Label\", type: \"string\" as const }, { name: \"value\", title: \"Value\", type: \"string\" as const }];\n      const t = fields.find((f) => f.type === \"string\" || f.type === \"text\");\n      const s = fields.find((f) => f !== t && (f.type === \"string\" || f.type === \"text\"));\n      return { ...base, type: \"array\", validation: def.required ? { required: true } : undefined, of: [{ name: `${def.id}Item`, title: singular(def.name), type: \"object\", fields, preview: { title: t?.name, subtitle: s?.name } }] };\n    }\n    default:\n      return { ...base, ...inferField(def.id, sample), title: def.name };\n  }\n}\n\n/** A collection's (or page's) field list → TypeSchema for the document editor. */\nexport function fieldDefsToSchema(fields: FieldDef[], opts: { name?: string; title?: string; values?: Obj; kind?: TypeSchema[\"kind\"] } = {}): TypeSchema {\n  return {\n    name: opts.name ?? \"document\",\n    title: opts.title ?? \"Fields\",\n    kind: opts.kind ?? \"entry\",\n    fields: fields.map((f) => fieldDefToSchema(f, opts.values?.[f.id])),\n  };\n}\n"],"mappings":"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"}

package/dist/schema/help.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 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. */
+/** Every help line the kit itself may print — the tone test's seam, not the rule tables. */
+export declare const HELP_STRINGS: readonly string[];
+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;