@bettercms-ai/kit 1.0.0 → 2.0.0

package/dist/library/entries/longform.entries.js

@@ -0,0 +1,4227 @@
+//#region src/library/entries/longform.entries.ts
+var pic = (seed, w = 1600, h = 1e3) => `https://picsum.photos/seed/${seed}/${w}/${h}`;
+var image = (seed, alt, w = 1600, h = 1e3) => ({
+	url: pic(seed, w, h),
+	alt,
+	name: `${seed}.jpg`,
+	width: w * 2,
+	height: h * 2
+});
+var CONTENT = {
+	name: "content",
+	title: "Content",
+	icon: "file-text",
+	default: true
+};
+var MEDIA = {
+	name: "media",
+	title: "Media",
+	icon: "photo"
+};
+var SETTINGS = {
+	name: "settings",
+	title: "Settings",
+	icon: "settings"
+};
+var DESIGN = {
+	name: "design",
+	title: "Design",
+	icon: "palette"
+};
+/** Rich-text body islands, in the editor's stored format. */
+var rt = {
+	figure: (seed, alt, caption) => `<figure data-rt="image" data-align="full" data-size="full"><img src="${pic(seed)}" alt="${alt}"><figcaption>${caption}</figcaption></figure>`,
+	callout: (tone, title, body) => `<div data-rt="callout" data-callout="${tone}"><p data-title="true">${title}</p><div data-body="true"><p>${body}</p></div></div>`,
+	video: (url) => `<div data-rt="video" data-embed="video" data-url="${url}"><a href="${url}">${url}</a></div>`,
+	toggle: (q, a) => `<details data-rt="toggle"><summary>${q}</summary><div data-body="true"><p>${a}</p></div></details>`,
+	pullquote: (quote, name, role) => `<figure data-rt="pullquote"><blockquote><p>${quote}</p></blockquote><figcaption><span data-name>${name}</span>, <span data-role>${role}</span></figcaption></figure>`,
+	takeaways: (title, points) => `<aside data-rt="takeaways"><p data-title>${title}</p><ul>${points.map((p) => `<li>${p}</li>`).join("")}</ul></aside>`,
+	fn: (n, note) => `<sup data-rt="fn" id="fnref-${n}" data-note="${note}"><a href="#fn-${n}" aria-label="Footnote ${n}">${n}</a></sup>`,
+	footnotes: (notes) => `<ol class="cs-footnotes" data-rt="footnotes" aria-label="Footnotes">${notes.map((n, i) => `<li id="fn-${i + 1}">${n} <a href="#fnref-${i + 1}" aria-label="Back to reference ${i + 1}">↩</a></li>`).join("")}</ol>`,
+	component: (type, name, id, overrides) => `<div data-rt="component" data-block="${type}" data-ref="${type}" data-id="${id}" data-name="${name}"${overrides ? ` data-overrides="${JSON.stringify(overrides).replace(/&/g, "&amp;").replace(/"/g, "&quot;")}"` : ""}>⧉&nbsp;${name} · component</div>`
+};
+var refs = (name, title, to, extra = {}) => ({
+	name,
+	title,
+	type: "array",
+	of: [{
+		name: name.replace(/s$/, ""),
+		title: title.replace(/s$/, ""),
+		type: "reference",
+		reference: { to }
+	}],
+	...extra
+});
+var post = {
+	id: "rich-blog-post",
+	label: "Rich blog post",
+	category: "Long-form & docs",
+	brand: "Caldera",
+	previewLayout: "article",
+	tags: [
+		"rich-text",
+		"references",
+		"media-heavy",
+		"embed",
+		"conditional",
+		"validation",
+		"seo-structured",
+		"localized"
+	],
+	proves: "One rich-text body holds key takeaways, callouts, tables, code, images, video, pull quotes, toggles, footnotes and linked components · sponsor disclosure is conditional",
+	docTitle: "The 30-minute campfire loaf",
+	urlPrefix: "caldera.bettercms.site/journal/",
+	schema: {
+		name: "journalPost",
+		title: "Journal post",
+		kind: "entry",
+		icon: "news",
+		category: "Long-form & docs",
+		description: "A Journal story with a rich body",
+		preview: {
+			title: "title",
+			subtitle: "dek",
+			media: "coverImage"
+		},
+		groups: [
+			CONTENT,
+			MEDIA,
+			SETTINGS
+		],
+		fieldsets: [
+			{
+				name: "byline",
+				title: "Byline"
+			},
+			{
+				name: "dates",
+				title: "Dates"
+			},
+			{
+				name: "sponsor",
+				title: "Sponsorship",
+				collapsed: true
+			}
+		],
+		fields: [
+			{
+				name: "title",
+				title: "Title",
+				type: "string",
+				group: "content",
+				validation: {
+					required: true,
+					max: 90,
+					recommendedMax: 70
+				},
+				ai: true,
+				localized: true,
+				description: "The page's only H1."
+			},
+			{
+				name: "slug",
+				title: "Slug",
+				type: "slug",
+				group: "content",
+				validation: { required: true }
+			},
+			{
+				name: "dek",
+				title: "Dek",
+				type: "text",
+				rows: 2,
+				group: "content",
+				validation: {
+					required: true,
+					recommendedMax: 160
+				},
+				ai: true,
+				localized: true,
+				description: "Also shown on cards."
+			},
+			refs("authors", "Authors", ["col_authors"], {
+				group: "content",
+				fieldset: "byline",
+				validation: {
+					min: 1,
+					max: 3
+				},
+				description: "The first author leads the byline."
+			}),
+			refs("topics", "Topics", ["col_topics"], {
+				group: "content",
+				fieldset: "byline",
+				validation: {
+					min: 1,
+					max: 4
+				},
+				description: "The first topic is the label on cards."
+			}),
+			{
+				name: "publishedAt",
+				title: "Publish date",
+				type: "datetime",
+				group: "content",
+				fieldset: "dates",
+				validation: { required: true }
+			},
+			{
+				name: "updatedAt",
+				title: "Updated",
+				type: "datetime",
+				group: "content",
+				fieldset: "dates",
+				description: "Only for real corrections or updates."
+			},
+			{
+				name: "readingTime",
+				title: "Reading time",
+				type: "number",
+				group: "content",
+				fieldset: "dates",
+				readOnly: true,
+				numeric: { unit: "min" },
+				description: "Worked out from the body word count."
+			},
+			{
+				name: "body",
+				title: "Body",
+				type: "richtext",
+				group: "content",
+				validation: { required: true },
+				ai: true,
+				localized: true,
+				description: "Type / for images, tables, callouts, code, video and components.",
+				helpMore: "H2 and H3 build the table of contents. Components stay shared with Blocks; a field edited here changes only this place."
+			},
+			{
+				name: "closingButton",
+				title: "Closing button",
+				type: "button",
+				group: "content"
+			},
+			{
+				name: "coverImage",
+				title: "Cover image",
+				type: "image",
+				group: "media",
+				validation: { required: true },
+				description: "1600 × 900 or larger. Used on cards and when shared."
+			},
+			{
+				name: "coverCaption",
+				title: "Cover caption",
+				type: "string",
+				group: "media",
+				validation: { max: 140 }
+			},
+			{
+				name: "isSponsored",
+				title: "Sponsored",
+				type: "boolean",
+				group: "settings",
+				fieldset: "sponsor",
+				description: "Adds a \"Paid partnership\" label and marks partner links sponsored."
+			},
+			{
+				name: "sponsorName",
+				title: "Partner",
+				type: "string",
+				group: "settings",
+				fieldset: "sponsor",
+				hidden: {
+					field: "isSponsored",
+					equals: true
+				},
+				validation: {
+					required: true,
+					max: 40
+				}
+			},
+			{
+				name: "sponsorLink",
+				title: "Partner link",
+				type: "link",
+				group: "settings",
+				fieldset: "sponsor",
+				hidden: {
+					field: "isSponsored",
+					equals: true
+				},
+				initialValue: {
+					type: "url",
+					href: "",
+					rel: "sponsored",
+					newTab: true
+				}
+			},
+			{
+				name: "isFeatured",
+				title: "Featured",
+				type: "boolean",
+				group: "settings"
+			},
+			{
+				name: "showContents",
+				title: "Show table of contents",
+				type: "boolean",
+				group: "settings",
+				initialValue: true
+			},
+			{
+				name: "related",
+				title: "Related stories",
+				type: "select",
+				group: "settings",
+				layout: "radio",
+				initialValue: "auto",
+				options: [
+					{
+						value: "auto",
+						label: "Automatic",
+						description: "Same topics, newest first"
+					},
+					{
+						value: "manual",
+						label: "Pick them"
+					},
+					{
+						value: "none",
+						label: "Don't show"
+					}
+				],
+				description: ""
+			},
+			refs("relatedPosts", "Stories", ["col_journal", "col_recipes"], {
+				group: "settings",
+				hidden: {
+					field: "related",
+					equals: "manual"
+				},
+				validation: {
+					min: 1,
+					max: 3,
+					unique: true
+				}
+			}),
+			{
+				name: "layout",
+				title: "Layout",
+				type: "select",
+				group: "settings",
+				layout: "cards",
+				initialValue: "standard",
+				options: [
+					{
+						value: "standard",
+						label: "Standard",
+						icon: "file-text",
+						description: "Text column, inline images"
+					},
+					{
+						value: "wide",
+						label: "Wide",
+						icon: "layout-columns",
+						description: "Full-width images"
+					},
+					{
+						value: "essay",
+						label: "Photo essay",
+						icon: "library-photo",
+						description: "Images first, short captions"
+					}
+				],
+				description: ""
+			}
+		]
+	},
+	value: {
+		title: "The 30-minute campfire loaf",
+		slug: "30-minute-campfire-loaf",
+		dek: "No starter, no oven, no proofing basket. A Dutch oven, a bag of coals and a dough you mix at lunch.",
+		authors: ["en_a2"],
+		topics: [
+			"tp_recipes",
+			"tp_camp",
+			"tp_cast-iron"
+		],
+		publishedAt: "2026-09-24T09:00:00-07:00[America/Los_Angeles]",
+		updatedAt: "2026-09-30T16:20:00-07:00[America/Los_Angeles]",
+		readingTime: 7,
+		body: [
+			"<p>Bread is the thing people assume you can't make outside. You can, and it's easier over coals than in most home ovens: a cast-iron Dutch oven is a steam oven with a lid.</p>",
+			rt.takeaways("Key takeaways", [
+				"Mix at lunch, bake at dusk: four hours does the proofing for you.",
+				"Two-thirds of the coals go on the lid.",
+				"Lift the lid once, at 20 minutes."
+			]),
+			"<h2>What you need</h2>",
+			`<table data-rt="table" data-header="true"><caption>Gear for one 900 g loaf</caption><thead><tr><th scope="col">Item</th><th scope="col">Why</th></tr></thead><tbody><tr><td>5.5 qt Dutch oven</td><td>Holds steam for the first 15 minutes</td></tr><tr><td>18 charcoal briquettes</td><td>About 220°C with 12 on the lid, 6 under</td></tr><tr><td>Parchment sling</td><td>Lowers the dough in without burnt knuckles</td></tr></tbody></table>`,
+			rt.callout("tip", "Count your coals", "Two-thirds on the lid, one-third underneath. Bread burns from the bottom first."),
+			"<h2>Mix at lunch, bake at dusk</h2>",
+			"<p>Stir 500 g flour, 360 g warm water, 10 g salt and 4 g instant yeast until shaggy. Cover it and forget it for four hours.</p>",
+			rt.figure("campfire-loaf-dough", "A shaggy dough in a steel bowl on a camp table", "Four hours later: doubled and bubbly. Photo: Daniel Okafor"),
+			"<h3>Shaping without a counter</h3>",
+			"<p>Flour the parchment, tip the dough out and fold the four edges into the middle. Flip it seam-down and let it sit while the coals catch.</p>",
+			rt.video("https://www.youtube.com/watch?v=Kc7sqbW3f8Y"),
+			rt.pullquote("Thin coals, patient lid. Lift it once at 20 minutes and never again.", "Priya Nair", "Caldera product engineering"),
+			rt.component("article-cta", "Inline CTA", "ci_loaf_cta", { heading: "Baking this weekend? The Ember Dutch Oven ships in two days." }),
+			"<h2>Bake</h2>",
+			`<p>Lid on for 20 minutes, lid off for 10. Knock the base: hollow means done. A probe should read 96°C.${rt.fn(1, "At the centre of the loaf, with an instant-read probe pushed in from the side.")}</p>`,
+			"<pre><code>Lid on   20 min  ~220°C  12 coals top, 6 under\nLid off  10 min  ~200°C  6 coals under only</code></pre>",
+			rt.callout("warning", "Never on a picnic table", "A loaded Dutch oven over coals scorches wood. Use the Cable Fold grate or bare ground."),
+			rt.toggle("Can I use whole wheat?", "Swap up to 150 g. Add 20 g more water, the bran drinks it."),
+			rt.toggle("What if it rains?", "The lid keeps rain off the dough. Keep the coals under a tarp until you need them."),
+			rt.component("product-card", "Product card", "ci_loaf_dutch", { badge: "Used here" }),
+			rt.footnotes(["At the centre of the loaf, with an instant-read probe pushed in from the side."])
+		].join(""),
+		closingButton: {
+			label: "Shop the Dutch oven",
+			href: "/products/ember-dutch-oven",
+			type: "entry",
+			entryId: "en_p2",
+			title: "Ember Dutch Oven 5.5qt",
+			style: "primary",
+			arrow: true
+		},
+		coverImage: image("campfire-loaf", "A crusty round loaf on a parchment sling beside a smoking Dutch oven"),
+		coverCaption: "Loaf number three of the trip, Deschutes National Forest.",
+		isSponsored: false,
+		isFeatured: true,
+		showContents: true,
+		related: "auto",
+		relatedPosts: [],
+		layout: "standard"
+	},
+	notes: {
+		why: "The post is a Journal ENTRY; the page template around it is fixed sections (post header from title/dek/byline/coverImage → body with optional ToC → closingButton → Author bio → Related posts). Everything readers scan inside the article — tables, callouts, code, video, FAQ toggles, linked components — lives in ONE rich-text body because its order is editorial and different every time. What the site queries (authors, topics, dates, isFeatured) are real fields. Sponsorship is three fields revealed by one toggle so the disclosure label can't be forgotten. Reading time is derived, so it's read-only.",
+		sanity: "Sanity `post` document: `body: array<block | image | table | callout | codeBlock | videoEmbed | reference→ctaBlock>` (Portable Text with custom types), `authors: array<reference>`, `categories: array<reference>`. Our body stores the same islands as data-rt HTML; component instances carry ref + overrides (D28), which Portable Text can only do with a custom object type.",
+		htmlSignals: [
+			"<article> with one <h1>, a byline (rel=author link, <time datetime>) and a large hero <img>",
+			"Body with h2/h3, <figure>/<figcaption>, <table>, <pre><code>, <blockquote>, <details>",
+			"Boxed asides with an icon (Tip / Note / Warning) → callouts",
+			"Mid-article product or newsletter card unlike the prose → component instance",
+			"'Sponsored', 'In partnership with', 'Paid partnership' near the byline"
+		],
+		mcp: "Create the entry: title (h1), slug (URL), dek (subtitle/first <p class=lede>), coverImage (hero img + alt + figcaption), authors/topics (match or create entries), publishedAt (<time datetime> or article:published_time), updatedAt (dateModified). Body: convert the article content to the rich-text format — h2/h3 kept, figure→data-rt=image, table→data-rt=table with thead, aside.note/tip/warning→data-rt=callout with tone, iframes from YouTube/Vimeo→data-rt=video, details→data-rt=toggle; repeated mid-article cards that match a Blocks component→data-rt=component with overrides for the differing text. Strip share bars, author box and related cards (template sections). Never copy <meta> into fields.",
+		pitfalls: [
+			"An H1 inside the body duplicates the title — the renderer demotes it, the converter should too.",
+			"Copying the author box into the body instead of referencing the author.",
+			"Pasting a CTA card as HTML loses the link to the component — use an instance.",
+			"Sponsored links without rel=sponsored — set by the sponsorLink default.",
+			"updatedAt bumped for typo fixes makes every post look fresh and erodes trust."
+		]
+	}
+};
+var authorBio = {
+	id: "author-bio",
+	label: "Author bio",
+	category: "Long-form & docs",
+	brand: "Caldera",
+	previewLayout: "split",
+	tags: [
+		"references",
+		"conditional",
+		"variants",
+		"dynamic-query",
+		"a11y"
+	],
+	proves: "One reference drives photo, name, role, bio and socials · per-placement bio override · latest posts by that author",
+	schema: {
+		name: "authorBio",
+		title: "Author bio",
+		kind: "block",
+		icon: "user-circle",
+		category: "Long-form & docs",
+		description: "Who wrote it, with a link to everything else they wrote",
+		variants: [
+			{
+				id: "card",
+				name: "Card"
+			},
+			{
+				id: "inline",
+				name: "Inline",
+				description: "A slim row under the article"
+			},
+			{
+				id: "profile",
+				name: "Profile",
+				description: "Large photo, for author pages"
+			}
+		],
+		groups: [CONTENT, DESIGN],
+		preview: {
+			title: "heading",
+			subtitle: "author",
+			icon: "user-circle"
+		},
+		fields: [
+			{
+				name: "heading",
+				title: "Heading",
+				type: "string",
+				group: "content",
+				initialValue: "About the author",
+				validation: { max: 40 },
+				description: "Leave empty on author pages."
+			},
+			{
+				name: "author",
+				title: "Author",
+				type: "reference",
+				group: "content",
+				reference: { to: ["col_authors"] },
+				description: "Leave empty on a post to use its first author."
+			},
+			{
+				name: "bioSource",
+				title: "Bio",
+				type: "select",
+				group: "content",
+				layout: "segmented",
+				initialValue: "profile",
+				options: [{
+					value: "profile",
+					label: "From their profile"
+				}, {
+					value: "custom",
+					label: "Written here"
+				}]
+			},
+			{
+				name: "bio",
+				title: "Bio for this placement",
+				type: "richtext",
+				group: "content",
+				hidden: {
+					field: "bioSource",
+					equals: "custom"
+				},
+				validation: { required: true }
+			},
+			{
+				name: "showSocial",
+				title: "Show social links",
+				type: "boolean",
+				group: "content",
+				initialValue: true
+			},
+			{
+				name: "showLatest",
+				title: "Show their latest posts",
+				type: "boolean",
+				group: "content"
+			},
+			{
+				name: "latestCount",
+				title: "How many",
+				type: "number",
+				group: "content",
+				layout: "slider",
+				hidden: {
+					field: "showLatest",
+					equals: true
+				},
+				numeric: {
+					min: 2,
+					max: 6,
+					step: 1
+				},
+				initialValue: 3,
+				description: ""
+			},
+			{
+				name: "button",
+				title: "Button",
+				type: "button",
+				group: "content",
+				placeholder: "All posts by {name}"
+			},
+			{
+				name: "photoShape",
+				title: "Photo",
+				type: "select",
+				group: "design",
+				layout: "segmented",
+				initialValue: "circle",
+				options: [
+					{
+						value: "circle",
+						label: "Circle"
+					},
+					{
+						value: "rounded",
+						label: "Rounded"
+					},
+					{
+						value: "none",
+						label: "No photo"
+					}
+				],
+				description: ""
+			}
+		]
+	},
+	value: {
+		_variant: "card",
+		heading: "About the author",
+		author: "en_a2",
+		bioSource: "profile",
+		bio: "",
+		showSocial: true,
+		showLatest: true,
+		latestCount: 3,
+		button: {
+			label: "All posts by {name}",
+			href: "/authors/priya-nair",
+			type: "entry",
+			entryId: "en_a2",
+			title: "Priya Nair",
+			style: "link",
+			arrow: true
+		},
+		photoShape: "circle"
+	},
+	notes: {
+		why: "Authors are a collection (name, slug, role, photo with alt, short bio, long bio, socials array, expertise topics); the bio box is a thin section that renders one of them, so a new headshot updates every post. The reference can be empty on the post template and fall back to the post's first author. A per-placement bio override is a conditional rich-text field — rare, but guest posts need it — rather than a second 'guest author' type. 'Their latest posts' is a tiny query (author = this, exclude current).",
+		sanity: "Sanity `author` document + an `authorBio` object with `author: reference→author`. Fallback to the post's author is done in GROQ (`coalesce(author->, ^.authors[0]->)`).",
+		htmlSignals: [
+			"A box after the article with a round headshot, name, a one-paragraph bio and social icons",
+			"rel=\"author\" links or links to /author/{slug}",
+			"'Written by', 'About the author', 'More from {name}'",
+			"Person JSON-LD with sameAs social URLs (native output from the author entry)"
+		],
+		mcp: "Create/match the author entry from the box: name, role (line under the name), photo (+ alt 'Portrait of {name}'), bio, socials (each icon link → platform + url). Place ONE authorBio on the post template with author empty (falls back to the post's first author). Only set author + bioSource 'custom' when a specific page shows a different bio.",
+		pitfalls: [
+			"Typing the author's name and photo into each post — they drift on the first rebrand.",
+			"Headshot alt text 'image' or empty — use 'Portrait of {name}'.",
+			"'Latest posts' listing the current post.",
+			"Two authors: the box must render both or say why only the first."
+		]
+	}
+};
+var codeTabs = {
+	name: "codeTabs",
+	title: "Code tabs",
+	kind: "block",
+	icon: "code",
+	category: "Long-form & docs",
+	description: "The same example in several languages",
+	variants: [{
+		id: "tabs",
+		name: "Tabs"
+	}, {
+		id: "stacked",
+		name: "Stacked",
+		description: "Every language visible, one after another"
+	}],
+	groups: [CONTENT, DESIGN],
+	preview: {
+		title: "title",
+		subtitle: "syncKey",
+		icon: "code"
+	},
+	fields: [
+		{
+			name: "title",
+			title: "Title",
+			type: "string",
+			group: "content",
+			validation: { max: 60 },
+			placeholder: "Create a journal entry"
+		},
+		{
+			name: "tabs",
+			title: "Languages",
+			type: "array",
+			group: "content",
+			itemNoun: "language",
+			validation: {
+				min: 1,
+				max: 8
+			},
+			of: [{
+				name: "snippet",
+				title: "Snippet",
+				type: "object",
+				icon: "code",
+				preview: {
+					title: "language",
+					subtitle: "filename"
+				},
+				fields: [
+					{
+						name: "language",
+						title: "Language",
+						type: "select",
+						validation: { required: true },
+						options: [
+							{
+								value: "curl",
+								label: "cURL"
+							},
+							{
+								value: "javascript",
+								label: "JavaScript"
+							},
+							{
+								value: "typescript",
+								label: "TypeScript"
+							},
+							{
+								value: "python",
+								label: "Python"
+							},
+							{
+								value: "ruby",
+								label: "Ruby"
+							},
+							{
+								value: "go",
+								label: "Go"
+							},
+							{
+								value: "java",
+								label: "Java"
+							},
+							{
+								value: "php",
+								label: "PHP"
+							},
+							{
+								value: "json",
+								label: "JSON"
+							}
+						]
+					},
+					{
+						name: "label",
+						title: "Tab name",
+						type: "string",
+						validation: { max: 16 },
+						description: "Leave empty to use the language name."
+					},
+					{
+						name: "filename",
+						title: "File name",
+						type: "string",
+						validation: { max: 40 },
+						placeholder: "create-entry.ts",
+						description: ""
+					},
+					{
+						name: "code",
+						title: "Code",
+						type: "code",
+						validation: { required: true },
+						openMode: "dialog"
+					},
+					{
+						name: "highlight",
+						title: "Highlight lines",
+						type: "string",
+						validation: {
+							pattern: "^\\d+(-\\d+)?(,\\s*\\d+(-\\d+)?)*$",
+							patternMessage: "Use line numbers like 3, 7-9."
+						},
+						placeholder: "3, 7-9",
+						description: ""
+					}
+				]
+			}]
+		},
+		{
+			name: "syncKey",
+			title: "Switch together",
+			type: "string",
+			group: "content",
+			initialValue: "sdk",
+			validation: {
+				pattern: "^[a-z0-9-]+$",
+				patternMessage: "Lowercase letters, numbers and hyphens only."
+			},
+			description: "Code tabs with the same key switch language together."
+		},
+		{
+			name: "showLineNumbers",
+			title: "Show line numbers",
+			type: "boolean",
+			group: "design",
+			description: ""
+		},
+		{
+			name: "showCopyButton",
+			title: "Show copy button",
+			type: "boolean",
+			group: "design",
+			initialValue: true,
+			description: ""
+		},
+		{
+			name: "maxHeight",
+			title: "Max height",
+			type: "number",
+			group: "design",
+			numeric: {
+				unit: "px",
+				min: 160,
+				max: 800,
+				step: 40
+			},
+			description: "Longer code scrolls inside the block."
+		}
+	]
+};
+var codeTabsEntry = {
+	id: "code-tabs",
+	label: "Code tabs",
+	category: "Long-form & docs",
+	brand: "Ledgerline",
+	previewLayout: "tabs",
+	tags: [
+		"embed",
+		"repeater",
+		"validation",
+		"variants"
+	],
+	proves: "One example in N languages · language is a select, not a free label · tabs sync across the page by key",
+	schema: codeTabs,
+	value: {
+		_variant: "tabs",
+		title: "Post a journal entry",
+		tabs: [
+			{
+				_key: "l1",
+				language: "curl",
+				filename: "",
+				code: "curl https://api.ledgerline.com/v2/journal-entries \\\n  -H \"Authorization: Bearer $LEDGERLINE_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"date\": \"2026-09-30\",\n    \"lines\": [\n      { \"account\": \"6100\", \"debit\": 1250.00 },\n      { \"account\": \"2000\", \"credit\": 1250.00 }\n    ]\n  }'",
+				highlight: "5-8"
+			},
+			{
+				_key: "l2",
+				language: "typescript",
+				label: "Node.js",
+				filename: "post-entry.ts",
+				code: "import { Ledgerline } from \"@ledgerline/node\";\n\nconst ll = new Ledgerline(process.env.LEDGERLINE_KEY!);\n\nawait ll.journalEntries.create({\n  date: \"2026-09-30\",\n  lines: [\n    { account: \"6100\", debit: 1250 },\n    { account: \"2000\", credit: 1250 },\n  ],\n});",
+				highlight: "5-11"
+			},
+			{
+				_key: "l3",
+				language: "python",
+				filename: "post_entry.py",
+				code: "from ledgerline import Ledgerline\n\nll = Ledgerline(os.environ[\"LEDGERLINE_KEY\"])\n\nll.journal_entries.create(\n    date=\"2026-09-30\",\n    lines=[\n        {\"account\": \"6100\", \"debit\": 1250},\n        {\"account\": \"2000\", \"credit\": 1250},\n    ],\n)"
+			}
+		],
+		syncKey: "sdk",
+		showLineNumbers: true,
+		showCopyButton: true,
+		maxHeight: 420
+	},
+	notes: {
+		why: "Docs show the same call in several languages; each snippet is an item with a LANGUAGE select (drives highlighting, the default tab name and the sync), an optional label override ('Node.js'), filename and highlight ranges. It is a block so it can sit inside a docs body as a component instance or on its own. syncKey lets every code-tabs block on the page switch together when a reader picks Python once.",
+		sanity: "Sanity's @sanity/code-input gives `code` {language, code, filename, highlightedLines}; tabs are an `array<code>` inside a custom `codeGroup` object in Portable Text.",
+		htmlSignals: [
+			"A tab bar of language names (cURL, Node, Python…) above a <pre><code class=\"language-*\">",
+			"Several <pre> siblings where only one is visible at a time (role=tabpanel)",
+			"A copy-to-clipboard button in the code header",
+			"data-lang / data-language attributes; localStorage keys like 'preferred-language'"
+		],
+		mcp: "One codeTabs per tab group. For each panel: language from class=\"language-x\" / tab text (normalize: 'Node'/'JS'→javascript, 'Shell'/'Bash'→curl if it calls curl), code from <code> textContent (keep indentation, decode entities), filename from the panel header. Lines with a highlight class → highlight ranges. Same tab labels across groups → same syncKey.",
+		pitfalls: [
+			"innerHTML of highlighted code carries <span> soup — store textContent only.",
+			"Free-text language labels ('Node 18') break highlighting — map to the select, keep the label separately.",
+			"API keys in sample code — replace real-looking secrets with $ENV placeholders.",
+			"The `code` field's built-in language list (html/css/js/liquid/json) doesn't cover API languages — the select carries it."
+		]
+	}
+};
+var ENTRIES = [
+	post,
+	authorBio,
+	{
+		id: "docs-page",
+		label: "Docs page",
+		category: "Long-form & docs",
+		brand: "Ledgerline",
+		previewLayout: "article",
+		tags: [
+			"rich-text",
+			"references",
+			"global-synced",
+			"conditional",
+			"embed",
+			"validation"
+		],
+		proves: "Sidebar position by reference to a nav group · auto ToC with depth · prev/next auto or manual · deprecation reveals a notice",
+		docTitle: "Multi-entity close",
+		urlPrefix: "docs.ledgerline.com/guides/",
+		blocks: [codeTabs],
+		schema: {
+			name: "docPage",
+			title: "Docs page",
+			kind: "entry",
+			icon: "book",
+			category: "Long-form & docs",
+			description: "A guide or reference page in the docs",
+			preview: {
+				title: "title",
+				subtitle: "summary",
+				icon: "book"
+			},
+			groups: [
+				CONTENT,
+				{
+					name: "navigation",
+					title: "Navigation",
+					icon: "list-tree"
+				},
+				SETTINGS
+			],
+			fieldsets: [{
+				name: "status",
+				title: "Status",
+				description: "Beta and deprecated pages show a notice at the top."
+			}],
+			fields: [
+				{
+					name: "title",
+					title: "Title",
+					type: "string",
+					group: "content",
+					validation: {
+						required: true,
+						max: 70
+					},
+					localized: true
+				},
+				{
+					name: "slug",
+					title: "Slug",
+					type: "slug",
+					group: "content",
+					validation: { required: true }
+				},
+				{
+					name: "summary",
+					title: "Summary",
+					type: "text",
+					rows: 2,
+					group: "content",
+					validation: {
+						required: true,
+						recommendedMax: 160
+					},
+					localized: true
+				},
+				{
+					name: "body",
+					title: "Body",
+					type: "richtext",
+					group: "content",
+					validation: { required: true },
+					localized: true,
+					description: "Type / for callouts, tables, Code tabs and images.",
+					helpMore: "H2 and H3 build the \"On this page\" list."
+				},
+				{
+					name: "sidebarGroup",
+					title: "Sidebar group",
+					type: "reference",
+					group: "navigation",
+					reference: { to: ["col_doc_groups"] },
+					validation: { required: true },
+					description: "The sidebar itself is shared."
+				},
+				{
+					name: "sidebarLabel",
+					title: "Sidebar label",
+					type: "string",
+					group: "navigation",
+					validation: { max: 28 },
+					description: "Leave empty to use the title."
+				},
+				{
+					name: "sidebarPosition",
+					title: "Position",
+					type: "number",
+					group: "navigation",
+					numeric: {
+						min: 1,
+						step: 1
+					},
+					description: "Lower comes first."
+				},
+				{
+					name: "tocDepth",
+					title: "On this page",
+					type: "select",
+					group: "navigation",
+					layout: "segmented",
+					initialValue: "h3",
+					options: [
+						{
+							value: "off",
+							label: "Off"
+						},
+						{
+							value: "h2",
+							label: "H2 only"
+						},
+						{
+							value: "h3",
+							label: "H2 + H3"
+						}
+					],
+					description: ""
+				},
+				{
+					name: "pager",
+					title: "Previous / next",
+					type: "select",
+					group: "navigation",
+					layout: "radio",
+					initialValue: "auto",
+					options: [
+						{
+							value: "auto",
+							label: "Follow the sidebar order"
+						},
+						{
+							value: "manual",
+							label: "Choose them"
+						},
+						{
+							value: "off",
+							label: "Hide"
+						}
+					],
+					description: ""
+				},
+				{
+					name: "prev",
+					title: "Previous page",
+					type: "reference",
+					group: "navigation",
+					reference: { to: ["col_docs"] },
+					hidden: {
+						field: "pager",
+						equals: "manual"
+					}
+				},
+				{
+					name: "next",
+					title: "Next page",
+					type: "reference",
+					group: "navigation",
+					reference: { to: ["col_docs"] },
+					hidden: {
+						field: "pager",
+						equals: "manual"
+					}
+				},
+				{
+					name: "status",
+					title: "Status",
+					type: "select",
+					group: "settings",
+					fieldset: "status",
+					layout: "segmented",
+					initialValue: "stable",
+					options: [
+						{
+							value: "stable",
+							label: "Stable"
+						},
+						{
+							value: "beta",
+							label: "Beta"
+						},
+						{
+							value: "deprecated",
+							label: "Deprecated"
+						}
+					],
+					description: ""
+				},
+				{
+					name: "statusNote",
+					title: "Notice",
+					type: "richtext",
+					group: "settings",
+					fieldset: "status",
+					hidden: {
+						field: "status",
+						equals: ["beta", "deprecated"]
+					},
+					validation: { required: true }
+				},
+				{
+					name: "replacement",
+					title: "Use instead",
+					type: "reference",
+					group: "settings",
+					fieldset: "status",
+					reference: { to: ["col_docs"] },
+					hidden: {
+						field: "status",
+						equals: "deprecated"
+					}
+				},
+				{
+					name: "apiVersion",
+					title: "API version",
+					type: "select",
+					group: "settings",
+					options: [
+						{
+							value: "2026-09-01",
+							label: "2026-09-01 (latest)"
+						},
+						{
+							value: "2026-03-01",
+							label: "2026-03-01"
+						},
+						{
+							value: "2025-09-01",
+							label: "2025-09-01"
+						}
+					],
+					description: "The version the examples on this page use."
+				},
+				{
+					name: "lastReviewed",
+					title: "Last reviewed",
+					type: "date",
+					group: "settings"
+				},
+				{
+					name: "editUrl",
+					title: "Source file",
+					type: "url",
+					group: "settings",
+					access: {
+						view: "schema.view",
+						edit: "schema.manage"
+					},
+					advanced: true,
+					description: "Powers the \"Edit on GitHub\" link."
+				}
+			]
+		},
+		value: {
+			title: "Close several entities at once",
+			slug: "multi-entity-close",
+			summary: "Group subsidiaries under a parent, run one checklist, and let Ledgerline post intercompany eliminations for you.",
+			body: [
+				"<p>Multi-entity close lets a parent company close every subsidiary from one checklist. Each entity keeps its own ledger; the checklist and eliminations are shared.</p>",
+				rt.callout("info", "Available on Scale and Enterprise", "Multi-entity close needs at least two entities with the same fiscal calendar."),
+				"<h2>Before you start</h2>",
+				"<ul><li>Every entity has a functional currency set.</li><li>Intercompany accounts are mapped in <a href=\"/guides/intercompany-mapping\">Intercompany mapping</a>.</li></ul>",
+				"<h2>Create a close group</h2>",
+				"<p>A close group is the parent and the entities it closes. Create one from the dashboard or the API.</p>",
+				rt.component("code-tabs", "Code tabs", "ci_doc_close_group", { title: "Create a close group" }),
+				"<h3>Order of operations</h3>",
+				`<table data-rt="table" data-header="true"><thead><tr><th scope="col">Step</th><th scope="col">Runs on</th></tr></thead><tbody><tr><td>Bank reconciliation</td><td>Each entity</td></tr><tr><td>Intercompany eliminations</td><td>The parent</td></tr><tr><td>Consolidated reports</td><td>The parent</td></tr></tbody></table>`,
+				rt.callout("warning", "Lock periods last", "Locking an entity before eliminations post blocks them. Lock the parent after every child."),
+				"<h2>Troubleshooting</h2>",
+				rt.toggle("Eliminations didn't post", "Check that both sides of the intercompany pair use mapped accounts. Unmapped lines are skipped and listed in the close report.")
+			].join(""),
+			sidebarGroup: "en_dg_closing",
+			sidebarLabel: "Multi-entity close",
+			sidebarPosition: 3,
+			tocDepth: "h3",
+			pager: "auto",
+			status: "beta",
+			statusNote: "<p>Multi-entity close is in beta. The API shape is stable; the dashboard checklist may change before general availability in Q1 2027.</p>",
+			apiVersion: "2026-09-01",
+			lastReviewed: "2026-09-29",
+			editUrl: "https://github.com/ledgerline/docs/blob/main/guides/multi-entity-close.mdx"
+		},
+		notes: {
+			why: "A docs page is an entry; the template around it is: shared sidebar (a global built from Doc groups — each page only says which group and position), breadcrumbs, the body, an auto 'On this page' list from H2/H3, prev/next, feedback, and the footer. Prev/next defaults to the sidebar order so editors rarely touch it; manual is there for tutorials that jump. Status is a select whose non-stable values reveal a required notice and, for deprecated, a replacement reference — so the warning can't be half-done. Code that readers copy goes in Code tabs instances, not raw <pre> blocks.",
+			sanity: "Sanity docs setups use `article` docs with `section: reference→docSection`, `order: number`, Portable Text with `code` and `callout` types; sidebar from GROQ grouped by section. Prev/next is computed in the frontend.",
+			htmlSignals: [
+				"Three columns: left nav tree, article, right 'On this page' list of anchors",
+				"Breadcrumbs and 'Previous' / 'Next' cards at the bottom",
+				"Admonitions (.admonition, .callout, :::note) and tabbed code blocks",
+				"'Edit this page on GitHub' link; 'Last updated on' date",
+				"A version switcher or 'Beta' / 'Deprecated' banners"
+			],
+			mcp: "Rebuild the sidebar tree as Doc groups (one per top-level nav heading) and record each page's group + position from the nav DOM order. Body: MDX/HTML → rich text; admonitions → callouts (note/info→info, tip→tip, caution/danger/warning→warning); tabbed code → codeTabs component instances (one block per tab group, see code-tabs); plain <pre> stays a code block. Don't import the right-hand ToC — it's derived. 'Beta'/'Deprecated' banners → status + statusNote.",
+			pitfalls: [
+				"Hard-coding prev/next per page — they break when pages are reordered; leave pager on auto.",
+				"Importing the ToC as content duplicates headings.",
+				"Docusaurus/Mintlify tabs flattened into one <pre> lose the other languages.",
+				"Deprecated without a replacement link — the reader is stranded.",
+				"Relative links (../guides/x) must be rewritten to page references on import."
+			]
+		}
+	},
+	codeTabsEntry,
+	{
+		id: "kb-article",
+		label: "Knowledge-base article",
+		category: "Long-form & docs",
+		brand: "Ledgerline",
+		previewLayout: "article",
+		tags: [
+			"rich-text",
+			"form",
+			"conditional",
+			"references",
+			"validation"
+		],
+		proves: "'Was this helpful?' modelled as settings, not markup · 'No' path is quick reasons, a form or a contact button · review ownership",
+		docTitle: "Why is my bank feed missing transactions?",
+		urlPrefix: "help.ledgerline.com/articles/",
+		schema: {
+			name: "kbArticle",
+			title: "Help article",
+			kind: "entry",
+			icon: "lifebuoy",
+			category: "Long-form & docs",
+			description: "A help-center answer with feedback",
+			preview: {
+				title: "title",
+				subtitle: "category",
+				icon: "lifebuoy"
+			},
+			groups: [
+				CONTENT,
+				{
+					name: "feedback",
+					title: "Feedback",
+					icon: "thumb-up"
+				},
+				SETTINGS
+			],
+			fields: [
+				{
+					name: "title",
+					title: "Title",
+					type: "string",
+					group: "content",
+					validation: {
+						required: true,
+						max: 90
+					},
+					localized: true
+				},
+				{
+					name: "slug",
+					title: "Slug",
+					type: "slug",
+					group: "content",
+					validation: { required: true }
+				},
+				{
+					name: "category",
+					title: "Category",
+					type: "reference",
+					group: "content",
+					reference: { to: ["col_kb_categories"] },
+					validation: { required: true }
+				},
+				{
+					name: "summary",
+					title: "Short answer",
+					type: "text",
+					rows: 2,
+					group: "content",
+					validation: { recommendedMax: 200 },
+					localized: true,
+					description: "Shown above the steps."
+				},
+				{
+					name: "body",
+					title: "Body",
+					type: "richtext",
+					group: "content",
+					validation: { required: true },
+					localized: true
+				},
+				{
+					name: "appliesTo",
+					title: "Applies to",
+					type: "multiselect",
+					group: "content",
+					options: [
+						{
+							value: "starter",
+							label: "Starter"
+						},
+						{
+							value: "growth",
+							label: "Growth"
+						},
+						{
+							value: "scale",
+							label: "Scale"
+						},
+						{
+							value: "enterprise",
+							label: "Enterprise"
+						}
+					],
+					description: "Leave empty for every plan."
+				},
+				refs("related", "Related articles", ["col_kb"], {
+					group: "content",
+					validation: {
+						max: 5,
+						unique: true
+					}
+				}),
+				{
+					name: "showFeedback",
+					title: "Ask \"Was this helpful?\"",
+					type: "boolean",
+					group: "feedback",
+					initialValue: true,
+					description: "Answers are counted in Growth › Analytics."
+				},
+				{
+					name: "question",
+					title: "Question",
+					type: "string",
+					group: "feedback",
+					hidden: {
+						field: "showFeedback",
+						equals: true
+					},
+					initialValue: "Was this article helpful?",
+					validation: { max: 48 },
+					description: ""
+				},
+				{
+					name: "thanks",
+					title: "After Yes",
+					type: "string",
+					group: "feedback",
+					hidden: {
+						field: "showFeedback",
+						equals: true
+					},
+					initialValue: "Thanks — glad it helped.",
+					validation: { max: 80 },
+					description: ""
+				},
+				{
+					name: "onNo",
+					title: "After No",
+					type: "select",
+					group: "feedback",
+					layout: "radio",
+					hidden: {
+						field: "showFeedback",
+						equals: true
+					},
+					initialValue: "reasons",
+					options: [
+						{
+							value: "reasons",
+							label: "Ask why, with quick reasons"
+						},
+						{
+							value: "form",
+							label: "Show a form"
+						},
+						{
+							value: "contact",
+							label: "Offer to contact support"
+						}
+					],
+					description: ""
+				},
+				{
+					name: "reasons",
+					title: "Reasons",
+					type: "array",
+					itemNoun: "reason",
+					of: [{
+						name: "reason",
+						title: "Reason",
+						type: "string"
+					}],
+					group: "feedback",
+					hidden: {
+						field: "onNo",
+						equals: "reasons"
+					},
+					validation: {
+						min: 2,
+						max: 5
+					}
+				},
+				{
+					name: "noForm",
+					title: "Form",
+					type: "reference",
+					group: "feedback",
+					reference: { to: ["form"] },
+					hidden: {
+						field: "onNo",
+						equals: "form"
+					},
+					validation: { required: true }
+				},
+				{
+					name: "contactButton",
+					title: "Contact button",
+					type: "button",
+					group: "feedback",
+					hidden: {
+						field: "onNo",
+						equals: "contact"
+					}
+				},
+				{
+					name: "owner",
+					title: "Owner",
+					type: "reference",
+					group: "settings",
+					reference: { to: ["col_people"] },
+					description: "Gets the \"needs review\" reminder and the No answers."
+				},
+				{
+					name: "lastReviewed",
+					title: "Last reviewed",
+					type: "date",
+					group: "settings",
+					validation: { required: true },
+					description: "Articles over 6 months old are flagged."
+				},
+				{
+					name: "internalNotes",
+					title: "Internal notes",
+					type: "text",
+					rows: 3,
+					group: "settings",
+					description: "Never shown on the site."
+				}
+			]
+		},
+		value: {
+			title: "Why is my bank feed missing transactions?",
+			slug: "bank-feed-missing-transactions",
+			category: "en_kbc_bank-feeds",
+			summary: "Most gaps are a pending sync or an expired bank login. Reconnect the account and run a 90-day backfill.",
+			body: "<ol><li>Open <strong>Banking › Connections</strong> and look for a yellow <em>Reconnect</em> badge.</li><li>Click <strong>Reconnect</strong> and sign in to your bank again.</li><li>Choose <strong>Backfill 90 days</strong>. New lines appear within 15 minutes.</li></ol><figure data-rt=\"image\" data-align=\"center\" data-size=\"m\"><img src=\"https://picsum.photos/seed/ledgerline-reconnect/1600/1000\" alt=\"The Connections list with a yellow Reconnect badge on the Chase operating account\"><figcaption>An expired connection shows Reconnect.</figcaption></figure><div data-rt=\"callout\" data-callout=\"info\"><p data-title=\"true\">Pending transactions</p><div data-body=\"true\"><p>Banks send pending card charges only once they settle, usually 1–3 business days later.</p></div></div>",
+			appliesTo: [],
+			related: ["en_kb_reconnect-bank", "en_kb_duplicate-lines"],
+			showFeedback: true,
+			question: "Was this article helpful?",
+			thanks: "Thanks — glad it helped.",
+			onNo: "reasons",
+			reasons: [
+				"Steps didn't work",
+				"My bank isn't listed",
+				"Hard to follow",
+				"Not what I was looking for"
+			],
+			owner: "en_p_rina-das",
+			lastReviewed: "2026-08-18",
+			internalNotes: "Plaid outage on 2026-07-02 caused a spike in tickets; link this article in the macro."
+		},
+		notes: {
+			why: "Help articles are entries in a KB collection with a required category (it drives the help-center tree and breadcrumbs). The feedback widget is part of the template, but its BEHAVIOUR is per-article content — the question, the thanks line and what happens after 'No' (quick reasons, a form reference, or a contact button), each revealed by one select. lastReviewed is required and owner is a reference so stale articles get routed to a person. Internal notes never render.",
+			sanity: "Sanity `article` { category: reference, body: portableText, related: array<reference> }. Feedback is almost always a hard-coded widget; per-article behavior would be an object `showFeedback {enabled, onNo, form: reference}` with hidden callbacks.",
+			htmlSignals: [
+				"'Was this article helpful?' with Yes/No or thumbs buttons at the end",
+				"Breadcrumbs Help Center › Category › Article; 'Updated N days ago'",
+				"Numbered steps with UI screenshots and bolded menu paths",
+				"Zendesk/Intercom/HelpScout markup (article-body, .article-votes)"
+			],
+			mcp: "Category from the breadcrumb (create KB categories). Body: keep ordered lists, bold UI paths and screenshots (alt from the step text). The vote widget → feedback settings; if 'No' opens a reason list, copy the reasons; if it links to a contact form, set onNo 'form' and attach/create the form. 'Updated' date → lastReviewed. Don't import vote counts — they're analytics.",
+			pitfalls: [
+				"Vote buttons copied as HTML into the body (they can't record anything).",
+				"Screenshots with alt 'screenshot' — describe what the reader should look for.",
+				"No owner → stale answers nobody reviews.",
+				"Plan badges as body text drift from pricing — use appliesTo."
+			]
+		}
+	},
+	{
+		id: "glossary",
+		label: "Glossary A–Z",
+		category: "Long-form & docs",
+		brand: "Caldera",
+		previewLayout: "list",
+		tags: [
+			"dynamic-query",
+			"repeater",
+			"conditional",
+			"references",
+			"seo-structured",
+			"a11y",
+			"validation"
+		],
+		proves: "Terms written here or from a Glossary collection · auto letter index · aliases and see-also links · each term deep-linkable",
+		docTitle: "Fire cooking glossary",
+		urlPrefix: "caldera.bettercms.site/learn/",
+		schema: {
+			name: "glossary",
+			title: "Glossary",
+			kind: "block",
+			icon: "abc",
+			category: "Long-form & docs",
+			description: "Terms and definitions, A to Z",
+			variants: [{
+				id: "list",
+				name: "List"
+			}, {
+				id: "columns",
+				name: "Two columns"
+			}],
+			groups: [CONTENT, DESIGN],
+			preview: {
+				title: "heading",
+				subtitle: "intro",
+				icon: "abc"
+			},
+			fields: [
+				{
+					name: "heading",
+					title: "Heading",
+					type: "string",
+					group: "content",
+					validation: {
+						required: true,
+						max: 48
+					},
+					localized: true
+				},
+				{
+					name: "intro",
+					title: "Intro",
+					type: "text",
+					rows: 2,
+					group: "content",
+					localized: true,
+					description: ""
+				},
+				{
+					name: "source",
+					title: "Terms come from",
+					type: "select",
+					group: "content",
+					layout: "segmented",
+					initialValue: "inline",
+					options: [{
+						value: "inline",
+						label: "Written here"
+					}, {
+						value: "collection",
+						label: "Glossary collection"
+					}]
+				},
+				refs("topics", "Only these topics", ["col_topics"], {
+					group: "content",
+					hidden: {
+						field: "source",
+						equals: "collection"
+					},
+					validation: { max: 4 },
+					description: "Leave empty for every term."
+				}),
+				{
+					name: "terms",
+					title: "Terms",
+					type: "array",
+					group: "content",
+					itemNoun: "term",
+					hidden: {
+						field: "source",
+						equals: "inline"
+					},
+					validation: {
+						min: 1,
+						max: 300
+					},
+					description: "Sorted A to Z on the page.",
+					of: [{
+						name: "term",
+						title: "Term",
+						type: "object",
+						icon: "abc",
+						preview: {
+							title: "term",
+							subtitle: "definition",
+							fallback: "Untitled term"
+						},
+						fields: [
+							{
+								name: "term",
+								title: "Term",
+								type: "string",
+								validation: {
+									required: true,
+									max: 48,
+									unique: true
+								},
+								localized: true
+							},
+							{
+								name: "anchor",
+								title: "Anchor",
+								type: "string",
+								validation: {
+									pattern: "^[a-z0-9-]+$",
+									patternMessage: "Use lowercase letters, numbers and hyphens, like camp-kitchen."
+								},
+								description: "Made from the term if empty."
+							},
+							{
+								name: "definition",
+								title: "Definition",
+								type: "richtext",
+								validation: { required: true },
+								localized: true
+							},
+							{
+								name: "aliases",
+								title: "Also called",
+								type: "tags",
+								validation: { max: 5 },
+								description: "Other names people search for."
+							},
+							{
+								name: "seeAlso",
+								title: "See also",
+								type: "tags",
+								validation: { max: 4 },
+								description: "Other terms in this list, spelled exactly as written."
+							},
+							{
+								name: "link",
+								title: "Learn more",
+								type: "link"
+							}
+						]
+					}]
+				},
+				{
+					name: "showLetterNav",
+					title: "Show A to Z bar",
+					type: "boolean",
+					group: "design",
+					initialValue: true
+				},
+				{
+					name: "isNavSticky",
+					title: "Keep the A to Z bar in view",
+					type: "boolean",
+					group: "design",
+					hidden: {
+						field: "showLetterNav",
+						equals: true
+					},
+					description: ""
+				},
+				{
+					name: "showSearch",
+					title: "Show search box",
+					type: "boolean",
+					group: "design",
+					initialValue: true
+				}
+			]
+		},
+		value: {
+			_variant: "list",
+			heading: "Fire cooking glossary",
+			intro: "The words our cooks use, explained without the jargon.",
+			source: "inline",
+			topics: [],
+			terms: [
+				{
+					_key: "g1",
+					term: "Bark",
+					anchor: "bark",
+					definition: "<p>The dark, crusty outer layer that forms on smoked meat as rub, smoke and rendered fat dry on the surface.</p>",
+					aliases: [],
+					seeAlso: ["Maillard reaction", "Stall"]
+				},
+				{
+					_key: "g2",
+					term: "Carryover cooking",
+					anchor: "carryover",
+					definition: "<p>The few degrees food keeps rising after it leaves the heat. Pull a steak 3–5°C before your target.</p>",
+					aliases: ["carry-over"],
+					seeAlso: []
+				},
+				{
+					_key: "g3",
+					term: "Maillard reaction",
+					anchor: "maillard",
+					definition: "<p>The browning of proteins and sugars above about 140°C that gives seared food its flavour.</p>",
+					aliases: ["browning", "maillard"],
+					seeAlso: ["Bark"],
+					link: {
+						type: "entry",
+						href: "/journal/why-dry-meat-sears-better",
+						title: "Why dry meat sears better"
+					}
+				},
+				{
+					_key: "g4",
+					term: "Polymerisation",
+					anchor: "polymerisation",
+					definition: "<p>What happens when a thin coat of oil is heated past its smoke point and bonds into the hard, slick layer we call seasoning.</p>",
+					aliases: ["seasoning layer", "polymerization"],
+					seeAlso: [],
+					link: {
+						type: "entry",
+						href: "/journal/seasoning-cast-iron-open-fire",
+						entryId: "en_1",
+						title: "Seasoning cast iron over an open fire"
+					}
+				},
+				{
+					_key: "g5",
+					term: "Stall",
+					anchor: "stall",
+					definition: "<p>The long plateau around 65–75°C when a large cut stops rising because evaporation cools its surface.</p>",
+					aliases: ["the stall", "plateau"],
+					seeAlso: ["Bark"]
+				}
+			],
+			showLetterNav: true,
+			isNavSticky: true,
+			showSearch: true
+		},
+		notes: {
+			why: "A glossary is a list of term objects sorted by the renderer, with the A–Z bar derived from first letters (never stored). Small sites write terms in the section; once terms should be linked from articles, have their own URLs or be reused, switch the source to the Glossary collection (same item shape) and the section becomes a query. Aliases feed the filter box and search; see-also is plain tags because a reference can't point at a sibling array item — the collection version uses real references.",
+			sanity: "Sanity: `glossaryTerm` documents { term, slug, definition: portableText, synonyms: array<string>, related: array<reference→glossaryTerm> } listed with GROQ ordered by lower(term).",
+			htmlSignals: [
+				"A row of A–Z letter links (#a, #b…) above alphabetised groups",
+				"<dl> with <dt> terms and <dd> definitions, or h3 + p pairs",
+				"Each term has an id for deep links",
+				"DefinedTermSet / DefinedTerm JSON-LD in the source (native output on our side)"
+			],
+			mcp: "Each <dt>/<h3> → term; following <dd>/<p> → definition; element id → anchor. 'Also known as …' lines → aliases. Inline 'See: X' links that point at other terms → seeAlso (by name). Drop the letter bar and letter headings — they're derived. If the site has /glossary/{term} pages, use source 'collection' and import each as an entry.",
+			pitfalls: [
+				"Storing the letter headings ('A', 'B') as terms.",
+				"See-also tags that don't match a term exactly render as dead text.",
+				"300 inline terms is the ceiling — beyond that, use the collection.",
+				"Localised term lists re-sort per language (Ä, Ø, Ł) — sort with the locale's collation."
+			]
+		}
+	},
+	{
+		id: "recipe",
+		label: "Recipe",
+		category: "Long-form & docs",
+		brand: "Caldera",
+		previewLayout: "article",
+		tags: [
+			"deep-nesting",
+			"repeater",
+			"seo-structured",
+			"media-heavy",
+			"conditional",
+			"references",
+			"validation",
+			"localized"
+		],
+		proves: "Ingredient groups → items with amount/unit/prep · steps with images and optional timers · nutrition · Recipe JSON-LD from fields",
+		docTitle: "Cast-iron skillet cornbread",
+		urlPrefix: "caldera.bettercms.site/recipes/",
+		schema: {
+			name: "recipe",
+			title: "Recipe",
+			kind: "entry",
+			icon: "chef-hat",
+			category: "Long-form & docs",
+			description: "A recipe with structured ingredients, steps and nutrition",
+			preview: {
+				title: "title",
+				subtitle: "summary",
+				media: "image"
+			},
+			groups: [
+				{
+					name: "overview",
+					title: "Overview",
+					icon: "file-text",
+					default: true
+				},
+				{
+					name: "ingredients",
+					title: "Ingredients",
+					icon: "list"
+				},
+				{
+					name: "method",
+					title: "Method",
+					icon: "list-numbers"
+				},
+				{
+					name: "nutrition",
+					title: "Nutrition",
+					icon: "apple"
+				}
+			],
+			fieldsets: [
+				{
+					name: "times",
+					title: "Times",
+					columns: 2
+				},
+				{
+					name: "yield",
+					title: "Makes"
+				},
+				{
+					name: "facts",
+					title: "Per serving",
+					columns: 2
+				}
+			],
+			fields: [
+				{
+					name: "title",
+					title: "Title",
+					type: "string",
+					group: "overview",
+					validation: {
+						required: true,
+						max: 80
+					},
+					localized: true
+				},
+				{
+					name: "slug",
+					title: "Slug",
+					type: "slug",
+					group: "overview",
+					validation: { required: true }
+				},
+				{
+					name: "summary",
+					title: "Summary",
+					type: "text",
+					rows: 2,
+					group: "overview",
+					validation: {
+						required: true,
+						recommendedMax: 160
+					},
+					localized: true
+				},
+				{
+					name: "image",
+					title: "Image",
+					type: "image",
+					group: "overview",
+					validation: { required: true },
+					description: "1600 × 1200 or larger. Google shows it in recipe results."
+				},
+				{
+					name: "video",
+					title: "Video",
+					type: "video",
+					group: "overview"
+				},
+				refs("authors", "Authors", ["col_authors"], {
+					group: "overview",
+					validation: {
+						min: 1,
+						max: 2
+					}
+				}),
+				{
+					name: "course",
+					title: "Course",
+					type: "select",
+					group: "overview",
+					validation: { required: true },
+					options: [
+						{
+							value: "breakfast",
+							label: "Breakfast"
+						},
+						{
+							value: "main",
+							label: "Main"
+						},
+						{
+							value: "side",
+							label: "Side"
+						},
+						{
+							value: "bread",
+							label: "Bread"
+						},
+						{
+							value: "dessert",
+							label: "Dessert"
+						}
+					],
+					description: ""
+				},
+				{
+					name: "methods",
+					title: "Cooked on",
+					type: "multiselect",
+					group: "overview",
+					options: [
+						{
+							value: "campfire",
+							label: "Campfire"
+						},
+						{
+							value: "coals",
+							label: "Coals"
+						},
+						{
+							value: "grill",
+							label: "Grill"
+						},
+						{
+							value: "stove",
+							label: "Stovetop"
+						},
+						{
+							value: "oven",
+							label: "Oven"
+						}
+					]
+				},
+				{
+					name: "difficulty",
+					title: "Difficulty",
+					type: "select",
+					group: "overview",
+					layout: "segmented",
+					options: [
+						{
+							value: "easy",
+							label: "Easy"
+						},
+						{
+							value: "medium",
+							label: "Medium"
+						},
+						{
+							value: "hard",
+							label: "Hard"
+						}
+					],
+					description: ""
+				},
+				{
+					name: "dietary",
+					title: "Dietary",
+					type: "multiselect",
+					group: "overview",
+					options: [
+						{
+							value: "vegetarian",
+							label: "Vegetarian"
+						},
+						{
+							value: "vegan",
+							label: "Vegan"
+						},
+						{
+							value: "gluten-free",
+							label: "Gluten-free"
+						},
+						{
+							value: "dairy-free",
+							label: "Dairy-free"
+						}
+					]
+				},
+				{
+					name: "prepMinutes",
+					title: "Prep",
+					type: "number",
+					group: "overview",
+					fieldset: "times",
+					numeric: {
+						unit: "min",
+						min: 0,
+						step: 5
+					},
+					validation: { required: true }
+				},
+				{
+					name: "cookMinutes",
+					title: "Cook",
+					type: "number",
+					group: "overview",
+					fieldset: "times",
+					numeric: {
+						unit: "min",
+						min: 0,
+						step: 5
+					},
+					validation: { required: true }
+				},
+				{
+					name: "restMinutes",
+					title: "Rest",
+					type: "number",
+					group: "overview",
+					fieldset: "times",
+					numeric: {
+						unit: "min",
+						min: 0,
+						step: 5
+					},
+					description: "In minutes. Counts toward the total."
+				},
+				{
+					name: "totalMinutes",
+					title: "Total",
+					type: "number",
+					group: "overview",
+					fieldset: "times",
+					readOnly: true,
+					numeric: { unit: "min" },
+					description: "In minutes: prep + cook + rest."
+				},
+				{
+					name: "servings",
+					title: "Servings",
+					type: "number",
+					group: "overview",
+					fieldset: "yield",
+					numeric: {
+						min: 1,
+						max: 40,
+						step: 1
+					},
+					validation: { required: true },
+					description: "Readers can scale amounts from this."
+				},
+				{
+					name: "yieldLabel",
+					title: "Yield",
+					type: "string",
+					group: "overview",
+					fieldset: "yield",
+					validation: { max: 32 },
+					placeholder: "one 10-inch skillet",
+					description: "Shown instead of \"Serves 8\"."
+				},
+				refs("equipment", "Cooked in", ["shopify"], {
+					group: "overview",
+					validation: { max: 4 },
+					description: "Caldera gear used. Shown with a link to each product."
+				}),
+				{
+					name: "ingredientGroups",
+					title: "Ingredients",
+					type: "array",
+					group: "ingredients",
+					itemNoun: "group",
+					validation: {
+						min: 1,
+						max: 8
+					},
+					of: [{
+						name: "ingredientGroup",
+						title: "Group",
+						type: "object",
+						icon: "list",
+						preview: {
+							title: "title",
+							fallback: "Untitled ingredient group"
+						},
+						fields: [{
+							name: "title",
+							title: "Group name",
+							type: "string",
+							validation: { max: 40 },
+							placeholder: "For the glaze",
+							description: "Leave empty for a single list."
+						}, {
+							name: "items",
+							title: "Items",
+							type: "array",
+							itemNoun: "ingredient",
+							validation: {
+								min: 1,
+								max: 30
+							},
+							of: [{
+								name: "ingredient",
+								title: "Ingredient",
+								type: "object",
+								icon: "point",
+								preview: {
+									title: "name",
+									subtitle: "amount",
+									fallback: "Untitled ingredient"
+								},
+								fields: [
+									{
+										name: "amount",
+										title: "Amount",
+										type: "number",
+										numeric: {
+											min: 0,
+											step: .25
+										},
+										description: "Leave empty for \"to taste\"."
+									},
+									{
+										name: "amountMax",
+										title: "Up to",
+										type: "number",
+										numeric: {
+											min: 0,
+											step: .25
+										},
+										hidden: {
+											field: "amount",
+											notEmpty: true
+										},
+										description: "For ranges like 2–3 cloves."
+									},
+									{
+										name: "unit",
+										title: "Unit",
+										type: "select",
+										initialValue: "",
+										options: [
+											{
+												value: "",
+												label: "None"
+											},
+											{
+												value: "g",
+												label: "g"
+											},
+											{
+												value: "kg",
+												label: "kg"
+											},
+											{
+												value: "ml",
+												label: "ml"
+											},
+											{
+												value: "l",
+												label: "l"
+											},
+											{
+												value: "tsp",
+												label: "tsp"
+											},
+											{
+												value: "tbsp",
+												label: "tbsp"
+											},
+											{
+												value: "cup",
+												label: "cup"
+											},
+											{
+												value: "oz",
+												label: "oz"
+											},
+											{
+												value: "lb",
+												label: "lb"
+											},
+											{
+												value: "clove",
+												label: "clove"
+											},
+											{
+												value: "pinch",
+												label: "pinch"
+											}
+										],
+										description: "Converts for readers who switch between metric and imperial."
+									},
+									{
+										name: "name",
+										title: "Ingredient",
+										type: "string",
+										validation: {
+											required: true,
+											max: 60
+										},
+										localized: true
+									},
+									{
+										name: "prep",
+										title: "Prep",
+										type: "string",
+										validation: { max: 40 },
+										placeholder: "melted and cooled",
+										localized: true,
+										description: ""
+									},
+									{
+										name: "isOptional",
+										title: "Optional",
+										type: "boolean",
+										description: ""
+									},
+									{
+										name: "product",
+										title: "Shop link",
+										type: "reference",
+										reference: { to: ["shopify"] },
+										advanced: true,
+										description: "Caldera pantry items only."
+									}
+								]
+							}]
+						}]
+					}]
+				},
+				{
+					name: "steps",
+					title: "Steps",
+					type: "array",
+					group: "method",
+					itemNoun: "step",
+					validation: {
+						min: 1,
+						max: 20
+					},
+					of: [{
+						name: "step",
+						title: "Step",
+						type: "object",
+						icon: "list-numbers",
+						preview: {
+							title: "title",
+							subtitle: "instruction",
+							media: "image",
+							fallback: "Untitled step"
+						},
+						fields: [
+							{
+								name: "title",
+								title: "Short name",
+								type: "string",
+								validation: { max: 40 }
+							},
+							{
+								name: "instruction",
+								title: "Instruction",
+								type: "richtext",
+								validation: { required: true },
+								localized: true
+							},
+							{
+								name: "image",
+								title: "Image",
+								type: "image"
+							},
+							{
+								name: "hasTimer",
+								title: "Add a timer",
+								type: "boolean"
+							},
+							{
+								name: "timerMinutes",
+								title: "Timer",
+								type: "number",
+								hidden: {
+									field: "hasTimer",
+									equals: true
+								},
+								numeric: {
+									unit: "min",
+									min: 1,
+									max: 720,
+									step: 1
+								},
+								validation: { required: true },
+								description: ""
+							},
+							{
+								name: "timerLabel",
+								title: "Timer label",
+								type: "string",
+								hidden: {
+									field: "hasTimer",
+									equals: true
+								},
+								validation: { max: 20 },
+								placeholder: "Bake",
+								description: ""
+							},
+							{
+								name: "tip",
+								title: "Tip",
+								type: "text",
+								rows: 2,
+								validation: { max: 200 },
+								description: "Shown as a note under the step."
+							}
+						]
+					}]
+				},
+				{
+					name: "notes",
+					title: "Cook's notes",
+					type: "richtext",
+					group: "method"
+				},
+				{
+					name: "showNutrition",
+					title: "Show nutrition",
+					type: "boolean",
+					group: "nutrition",
+					initialValue: true,
+					description: "Shown as estimates, with a disclaimer."
+				},
+				{
+					name: "calories",
+					title: "Calories",
+					type: "number",
+					group: "nutrition",
+					fieldset: "facts",
+					numeric: {
+						unit: "kcal",
+						min: 0
+					},
+					hidden: {
+						field: "showNutrition",
+						equals: true
+					}
+				},
+				{
+					name: "protein",
+					title: "Protein",
+					type: "number",
+					group: "nutrition",
+					fieldset: "facts",
+					numeric: {
+						unit: "g",
+						min: 0
+					},
+					hidden: {
+						field: "showNutrition",
+						equals: true
+					}
+				},
+				{
+					name: "fat",
+					title: "Fat",
+					type: "number",
+					group: "nutrition",
+					fieldset: "facts",
+					numeric: {
+						unit: "g",
+						min: 0
+					},
+					hidden: {
+						field: "showNutrition",
+						equals: true
+					}
+				},
+				{
+					name: "carbs",
+					title: "Carbohydrates",
+					type: "number",
+					group: "nutrition",
+					fieldset: "facts",
+					numeric: {
+						unit: "g",
+						min: 0
+					},
+					hidden: {
+						field: "showNutrition",
+						equals: true
+					}
+				},
+				{
+					name: "fiber",
+					title: "Fibre",
+					type: "number",
+					group: "nutrition",
+					fieldset: "facts",
+					numeric: {
+						unit: "g",
+						min: 0
+					},
+					hidden: {
+						field: "showNutrition",
+						equals: true
+					}
+				},
+				{
+					name: "sodium",
+					title: "Sodium",
+					type: "number",
+					group: "nutrition",
+					fieldset: "facts",
+					numeric: {
+						unit: "mg",
+						min: 0
+					},
+					hidden: {
+						field: "showNutrition",
+						equals: true
+					}
+				},
+				{
+					name: "rating",
+					title: "Reader rating",
+					type: "rating",
+					group: "nutrition",
+					readOnly: true,
+					description: "Average of reader ratings. Not editable."
+				}
+			]
+		},
+		value: {
+			title: "Cast-iron skillet cornbread",
+			slug: "cast-iron-skillet-cornbread",
+			summary: "Crisp-edged, barely sweet cornbread baked in a screaming-hot skillet over coals — or in the oven at home.",
+			image: image("skillet-cornbread", "A golden cornbread in a 10-inch cast iron skillet, one wedge cut out", 1600, 1200),
+			video: { url: "https://www.youtube.com/watch?v=3n1u3pTw1kM" },
+			authors: ["en_a1"],
+			course: "bread",
+			methods: ["coals", "oven"],
+			difficulty: "easy",
+			dietary: ["vegetarian"],
+			prepMinutes: 10,
+			cookMinutes: 25,
+			restMinutes: 10,
+			totalMinutes: 45,
+			servings: 8,
+			yieldLabel: "one 10-inch skillet",
+			equipment: ["gid://shopify/Product/8814"],
+			ingredientGroups: [{
+				_key: "ig1",
+				title: "",
+				items: [
+					{
+						_key: "i1",
+						amount: 240,
+						unit: "g",
+						name: "medium-grind cornmeal"
+					},
+					{
+						_key: "i2",
+						amount: 125,
+						unit: "g",
+						name: "plain flour"
+					},
+					{
+						_key: "i3",
+						amount: 2,
+						unit: "tsp",
+						name: "baking powder"
+					},
+					{
+						_key: "i4",
+						amount: 1,
+						unit: "tsp",
+						name: "fine salt"
+					},
+					{
+						_key: "i5",
+						amount: 2,
+						unit: "tbsp",
+						name: "honey"
+					},
+					{
+						_key: "i6",
+						amount: 480,
+						unit: "ml",
+						name: "buttermilk"
+					},
+					{
+						_key: "i7",
+						amount: 2,
+						unit: "",
+						name: "eggs",
+						prep: "beaten"
+					},
+					{
+						_key: "i8",
+						amount: 60,
+						unit: "g",
+						name: "butter",
+						prep: "melted, plus 1 tbsp for the pan"
+					}
+				]
+			}, {
+				_key: "ig2",
+				title: "To serve",
+				items: [{
+					_key: "i9",
+					amount: 2,
+					unit: "tbsp",
+					name: "hot honey",
+					isOptional: true
+				}, {
+					_key: "i10",
+					unit: "",
+					name: "flaky salt",
+					prep: "to taste"
+				}]
+			}],
+			steps: [
+				{
+					_key: "s1",
+					title: "Heat the pan",
+					instruction: "<p>Set the skillet over medium coals or in a <strong>220°C</strong> oven with 1 tbsp butter inside for <strong>10 minutes</strong>.</p>",
+					hasTimer: true,
+					timerMinutes: 10,
+					timerLabel: "Preheat",
+					image: image("cornbread-pan-heat", "Butter foaming in a hot cast iron skillet", 1200, 900)
+				},
+				{
+					_key: "s2",
+					title: "Mix",
+					instruction: "<p>Whisk the dry ingredients. Stir in the honey, buttermilk, eggs and melted butter until just combined — lumps are fine.</p>"
+				},
+				{
+					_key: "s3",
+					title: "Bake",
+					instruction: "<p>Pour the batter into the sizzling pan. Cover with the lid and pile coals on top, or bake uncovered in the oven, for <strong>25 minutes</strong>.</p>",
+					hasTimer: true,
+					timerMinutes: 25,
+					timerLabel: "Bake",
+					tip: "It's done when a skewer comes out clean and the edges pull away from the pan."
+				},
+				{
+					_key: "s4",
+					title: "Rest",
+					instruction: "<p>Rest 10 minutes in the pan so it slices cleanly. Drizzle with hot honey and flaky salt.</p>",
+					hasTimer: true,
+					timerMinutes: 10,
+					timerLabel: "Rest"
+				}
+			],
+			notes: "<p><strong>No buttermilk?</strong> Stir 1 tbsp lemon juice into 480 ml milk and wait 5 minutes.</p><p>Keeps two days wrapped. Reheat wedges cut-side down in a dry skillet.</p>",
+			showNutrition: true,
+			calories: 290,
+			protein: 7,
+			fat: 10,
+			carbs: 43,
+			fiber: 2,
+			sodium: 420,
+			rating: 4.8
+		},
+		notes: {
+			why: "Recipes are entries because every part is queried or validated: course, method and dietary drive filters; times and servings feed scaling and the Recipe JSON-LD (prepTime, cookTime, totalTime, recipeYield, recipeIngredient, recipeInstructions as HowToStep with image, nutrition, aggregateRating) — all emitted natively from these fields. Ingredients are groups → items (four drill levels: recipe → group → item → product) with numeric amount + unit select, so scaling and unit conversion are possible; typed lines like '2 cups flour' can't scale. Step timers are optional and revealed per step. Template: hero (title, summary, image, times) → ingredients + steps two-column → notes → nutrition → author bio → related recipes.",
+			sanity: "Sanity: `recipe` { ingredients: array<object{title, items: array<object{amount, unit, name, note}>}>, steps: array<object{body: portableText, image, timer}>, nutrition: object }. Same shape; Sanity has no derived/read-only total, it's computed in GROQ.",
+			htmlSignals: [
+				"Recipe JSON-LD in the source (the most reliable signal) or WPRM/Tasty Recipes plugin markup (.wprm-recipe)",
+				"A 'Prep · Cook · Total' strip and 'Serves N' / servings stepper",
+				"<ul> of ingredients with amounts and units; group sub-headings like 'For the glaze'",
+				"<ol> of steps, often with step photos; 'Jump to recipe' / 'Print' buttons",
+				"A nutrition table (Calories, Protein, Fat, Carbs)"
+			],
+			mcp: "Prefer the page's Recipe JSON-LD: recipeIngredient strings → parse into amount (handle ½, 1/2, ranges '2–3' → amount + amountMax), unit (normalize 'tablespoons'→tbsp), name, prep (text after a comma). recipeInstructions → steps (HowToSection → separate steps with the section name as title). ISO-8601 durations PT25M → minutes. Without JSON-LD, use the WPRM/Tasty classes. Group headings inside the ingredient list → ingredientGroups. Never import the 'Jump to recipe'/'Print' buttons.",
+			pitfalls: [
+				"Ingredient lines as plain strings — scaling and unit switches become impossible.",
+				"Unicode fractions (½ ⅓) and ranges parsed as one number.",
+				"Total time typed by hand disagrees with prep + cook — keep it derived.",
+				"Dietary claims set at recipe level while an optional ingredient breaks them.",
+				"Timer fields filled but hasTimer off — hidden values still ship unless cleared on save."
+			]
+		}
+	},
+	{
+		id: "course-curriculum",
+		label: "Course curriculum",
+		category: "Long-form & docs",
+		brand: "Kestrel Academy",
+		previewLayout: "accordion",
+		tags: [
+			"deep-nesting",
+			"repeater",
+			"conditional",
+			"references",
+			"validation",
+			"media-heavy",
+			"seo-structured"
+		],
+		proves: "Modules → lessons → resources → file (4 drill levels) · lesson type reveals video / reading / quiz / live fields · free previews",
+		docTitle: "Brand Identity Systems",
+		urlPrefix: "kestrel.academy/courses/",
+		schema: {
+			name: "curriculum",
+			title: "Course curriculum",
+			kind: "block",
+			icon: "school",
+			category: "Long-form & docs",
+			description: "Modules and lessons, with free previews and resources",
+			variants: [{
+				id: "accordion",
+				name: "Accordion"
+			}, {
+				id: "timeline",
+				name: "Week by week"
+			}],
+			groups: [CONTENT, DESIGN],
+			preview: {
+				title: "heading",
+				subtitle: "course",
+				icon: "school"
+			},
+			fields: [
+				{
+					name: "heading",
+					title: "Heading",
+					type: "string",
+					group: "content",
+					initialValue: "What you'll learn",
+					validation: { max: 48 },
+					localized: true
+				},
+				{
+					name: "course",
+					title: "Course",
+					type: "reference",
+					group: "content",
+					reference: { to: ["col_courses"] },
+					validation: { required: true },
+					description: "Totals, enrolment and the course page come from here."
+				},
+				{
+					name: "modules",
+					title: "Modules",
+					type: "array",
+					group: "content",
+					itemNoun: "module",
+					validation: {
+						min: 1,
+						max: 16
+					},
+					of: [{
+						name: "module",
+						title: "Module",
+						type: "object",
+						icon: "folder",
+						preview: {
+							title: "title",
+							subtitle: "summary",
+							fallback: "Untitled module"
+						},
+						fields: [
+							{
+								name: "title",
+								title: "Title",
+								type: "string",
+								validation: {
+									required: true,
+									max: 60
+								},
+								localized: true
+							},
+							{
+								name: "summary",
+								title: "Summary",
+								type: "text",
+								rows: 2,
+								validation: { recommendedMax: 200 },
+								localized: true
+							},
+							{
+								name: "unlock",
+								title: "Opens",
+								type: "select",
+								layout: "segmented",
+								initialValue: "now",
+								options: [
+									{
+										value: "now",
+										label: "At enrolment"
+									},
+									{
+										value: "previous",
+										label: "After the last module"
+									},
+									{
+										value: "date",
+										label: "On a date"
+									}
+								],
+								description: ""
+							},
+							{
+								name: "unlockDate",
+								title: "Opens on",
+								type: "date",
+								hidden: {
+									field: "unlock",
+									equals: "date"
+								},
+								validation: { required: true }
+							},
+							{
+								name: "lessons",
+								title: "Lessons",
+								type: "array",
+								itemNoun: "lesson",
+								validation: {
+									min: 1,
+									max: 20
+								},
+								of: [{
+									name: "lesson",
+									title: "Lesson",
+									type: "object",
+									icon: "player-play",
+									preview: {
+										title: "title",
+										subtitle: "type",
+										fallback: "Untitled lesson"
+									},
+									fields: [
+										{
+											name: "title",
+											title: "Title",
+											type: "string",
+											validation: {
+												required: true,
+												max: 80
+											},
+											localized: true
+										},
+										{
+											name: "type",
+											title: "Type",
+											type: "select",
+											layout: "segmented",
+											validation: { required: true },
+											initialValue: "video",
+											options: [
+												{
+													value: "video",
+													label: "Video",
+													icon: "player-play"
+												},
+												{
+													value: "reading",
+													label: "Reading",
+													icon: "file-text"
+												},
+												{
+													value: "quiz",
+													label: "Quiz",
+													icon: "checklist"
+												},
+												{
+													value: "assignment",
+													label: "Assignment",
+													icon: "pencil"
+												},
+												{
+													value: "live",
+													label: "Live",
+													icon: "broadcast"
+												}
+											],
+											description: ""
+										},
+										{
+											name: "minutes",
+											title: "Length",
+											type: "number",
+											numeric: {
+												unit: "min",
+												min: 1,
+												max: 240,
+												step: 1
+											},
+											validation: { required: true },
+											description: "In minutes. Adds up to the module and course totals."
+										},
+										{
+											name: "video",
+											title: "Video",
+											type: "video",
+											hidden: {
+												field: "type",
+												equals: "video"
+											},
+											validation: { required: true }
+										},
+										{
+											name: "captions",
+											title: "Captions",
+											type: "file",
+											hidden: {
+												field: "type",
+												equals: "video"
+											},
+											description: "A .vtt file. Required on every video lesson."
+										},
+										{
+											name: "reading",
+											title: "Reading",
+											type: "richtext",
+											hidden: {
+												field: "type",
+												equals: ["reading", "assignment"]
+											},
+											validation: { required: true }
+										},
+										{
+											name: "quiz",
+											title: "Quiz",
+											type: "reference",
+											reference: { to: ["col_quizzes"] },
+											hidden: {
+												field: "type",
+												equals: "quiz"
+											},
+											validation: { required: true }
+										},
+										{
+											name: "liveAt",
+											title: "Starts",
+											type: "datetime",
+											hidden: {
+												field: "type",
+												equals: "live"
+											},
+											validation: { required: true },
+											description: "Shown in each student's own time zone."
+										},
+										{
+											name: "isFreePreview",
+											title: "Free preview",
+											type: "boolean",
+											description: "Visitors can open it before enrolling."
+										},
+										{
+											name: "resources",
+											title: "Resources",
+											type: "array",
+											itemNoun: "resource",
+											openMode: "inline",
+											validation: { max: 8 },
+											of: [{
+												name: "resource",
+												title: "Resource",
+												type: "object",
+												icon: "paperclip",
+												preview: {
+													title: "label",
+													subtitle: "kind"
+												},
+												fields: [
+													{
+														name: "label",
+														title: "Label",
+														type: "string",
+														validation: {
+															required: true,
+															max: 48
+														}
+													},
+													{
+														name: "kind",
+														title: "Kind",
+														type: "select",
+														layout: "segmented",
+														initialValue: "file",
+														options: [{
+															value: "file",
+															label: "File"
+														}, {
+															value: "link",
+															label: "Link"
+														}],
+														description: ""
+													},
+													{
+														name: "file",
+														title: "File",
+														type: "file",
+														hidden: {
+															field: "kind",
+															equals: "file"
+														},
+														validation: { required: true }
+													},
+													{
+														name: "link",
+														title: "Link",
+														type: "link",
+														hidden: {
+															field: "kind",
+															equals: "link"
+														},
+														validation: { required: true }
+													}
+												]
+											}]
+										}
+									]
+								}]
+							}
+						]
+					}]
+				},
+				{
+					name: "isFirstOpen",
+					title: "Open the first module",
+					type: "boolean",
+					group: "design",
+					initialValue: true,
+					description: ""
+				},
+				{
+					name: "showLengths",
+					title: "Show lengths",
+					type: "boolean",
+					group: "design",
+					initialValue: true
+				},
+				{
+					name: "showNumbers",
+					title: "Number lessons",
+					type: "boolean",
+					group: "design",
+					initialValue: true,
+					description: "1.1, 1.2 … restarting each module."
+				}
+			]
+		},
+		value: {
+			_variant: "accordion",
+			heading: "What you'll learn",
+			course: "en_course_brand-identity-systems",
+			modules: [{
+				_key: "m1",
+				title: "Foundations of identity",
+				summary: "Read a brief, audit an existing identity and write a positioning line the system can grow from.",
+				unlock: "now",
+				lessons: [
+					{
+						_key: "l1",
+						title: "What an identity system actually is",
+						type: "video",
+						minutes: 12,
+						video: { url: "https://vimeo.com/912345678" },
+						captions: {
+							url: "https://kestrel.academy/media/captions/bis-1-1.vtt",
+							name: "bis-1-1.vtt",
+							size: 18432
+						},
+						isFreePreview: true,
+						resources: [{
+							_key: "r1",
+							label: "Slides (PDF)",
+							kind: "file",
+							file: {
+								url: "https://kestrel.academy/media/bis-1-1-slides.pdf",
+								name: "bis-1-1-slides.pdf",
+								size: 4194304
+							}
+						}]
+					},
+					{
+						_key: "l2",
+						title: "Auditing an existing brand",
+						type: "reading",
+						minutes: 20,
+						reading: "<p>Before you design anything, inventory what's already out there: every logo lock-up, colour, typeface and template in use.</p>",
+						resources: [{
+							_key: "r2",
+							label: "Audit spreadsheet",
+							kind: "link",
+							link: {
+								type: "url",
+								href: "https://docs.google.com/spreadsheets/d/1kestrel-audit-template/copy",
+								newTab: true
+							}
+						}]
+					},
+					{
+						_key: "l3",
+						title: "Check your understanding",
+						type: "quiz",
+						minutes: 8,
+						quiz: "en_quiz_bis-m1"
+					}
+				]
+			}, {
+				_key: "m2",
+				title: "Marks, type and colour",
+				summary: "Build a logo suite, pair typefaces with a reason, and make a colour system that passes contrast.",
+				unlock: "previous",
+				lessons: [
+					{
+						_key: "l4",
+						title: "Designing a flexible logo suite",
+						type: "video",
+						minutes: 26,
+						video: { url: "https://vimeo.com/912345690" },
+						resources: []
+					},
+					{
+						_key: "l5",
+						title: "Critique with Ana Kovač",
+						type: "live",
+						minutes: 60,
+						liveAt: "2026-11-12T17:00:00+00:00[Europe/London]",
+						resources: []
+					},
+					{
+						_key: "l6",
+						title: "Assignment: a three-colour system",
+						type: "assignment",
+						minutes: 90,
+						reading: "<p>Build primary, secondary and neutral ramps. Every text pairing must reach 4.5:1.</p>",
+						resources: [{
+							_key: "r3",
+							label: "Figma starter file",
+							kind: "link",
+							link: {
+								type: "url",
+								href: "https://www.figma.com/community/file/1300000000000000001",
+								newTab: true
+							}
+						}]
+					}
+				]
+			}],
+			isFirstOpen: true,
+			showLengths: true,
+			showNumbers: true
+		},
+		notes: {
+			why: "The curriculum sits on the course page and references the Course entry (title, price, instructors, enrolment). Modules → lessons → resources is the deepest editorial structure on the site, so every level drills in with clear previews ('Video · 12 min'). The lesson TYPE is a select that reveals exactly the fields that type needs (video + captions, reading, quiz reference, live start) — no lesson carries empty video and quiz fields at once. Lengths are numbers so totals are computed, not typed. Course JSON-LD (syllabusSections, timeRequired) is derived natively.",
+			sanity: "Sanity: `course` document with `modules: array<object{title, lessons: array<reference→lesson>}>` — lessons are usually their own documents. Inline lessons are fine until lessons are shared between courses; then promote them to a Lessons collection and make `lessons` an array of references.",
+			htmlSignals: [
+				"Accordion of 'Module 1 / Week 1' headings with lesson rows inside",
+				"Per-row icons for video / article / quiz and durations like '12 min'",
+				"'Preview' or 'Free' badges on some lessons; lock icons on others",
+				"Totals like '6 modules · 42 lessons · 9h 30m'"
+			],
+			mcp: "Each accordion header → module (title, summary from its subtitle). Each row → lesson: type from the row icon/label, minutes from '12:34' or '12 min' (round up), isFreePreview from a Preview/Free badge. Downloadable attachments under a lesson → resources (kind file); external links → kind link. Ignore the totals line — it's derived. Don't import lock icons; set unlock 'previous' when the source says lessons unlock in order.",
+			pitfalls: [
+				"Durations typed as text ('1h 05m') can't be summed.",
+				"Video lessons without captions — the captions field should be checked before publish (a11y).",
+				"Live lesson times stored in local time without a zone.",
+				"Five levels inline (course → module → lesson → resource → file) — keep resources tiny and inline."
+			]
+		}
+	},
+	{
+		id: "legal-policy",
+		label: "Legal / policy page",
+		category: "Long-form & docs",
+		brand: "Caldera",
+		previewLayout: "article",
+		tags: [
+			"deep-nesting",
+			"repeater",
+			"rich-text",
+			"validation",
+			"conditional",
+			"a11y",
+			"localized"
+		],
+		proves: "Numbered sections → clauses with optional plain-English summaries · effective date + version history with archived copies",
+		docTitle: "Warranty & returns policy",
+		urlPrefix: "caldera.bettercms.site/legal/",
+		schema: {
+			name: "policyPage",
+			title: "Policy page",
+			kind: "page",
+			icon: "scale",
+			category: "Long-form & docs",
+			description: "Terms, privacy, warranty or returns, numbered and versioned",
+			preview: {
+				title: "title",
+				subtitle: "version",
+				icon: "scale"
+			},
+			groups: [
+				CONTENT,
+				{
+					name: "versions",
+					title: "Versions",
+					icon: "history"
+				},
+				SETTINGS
+			],
+			fieldsets: [{
+				name: "dates",
+				title: "Dates"
+			}],
+			fields: [
+				{
+					name: "title",
+					title: "Title",
+					type: "string",
+					group: "content",
+					validation: {
+						required: true,
+						max: 60
+					},
+					localized: true
+				},
+				{
+					name: "slug",
+					title: "Slug",
+					type: "slug",
+					group: "content",
+					validation: { required: true }
+				},
+				{
+					name: "policyType",
+					title: "Policy",
+					type: "select",
+					group: "content",
+					access: { edit: "schema.manage" },
+					lockReason: "Set by the developer. Footer and checkout links depend on it.",
+					options: [
+						{
+							value: "terms",
+							label: "Terms of service"
+						},
+						{
+							value: "privacy",
+							label: "Privacy"
+						},
+						{
+							value: "cookies",
+							label: "Cookies"
+						},
+						{
+							value: "returns",
+							label: "Returns"
+						},
+						{
+							value: "warranty",
+							label: "Warranty"
+						},
+						{
+							value: "accessibility",
+							label: "Accessibility"
+						}
+					],
+					description: "Footer and checkout links use this."
+				},
+				{
+					name: "effectiveDate",
+					title: "Effective from",
+					type: "date",
+					group: "content",
+					fieldset: "dates",
+					validation: { required: true }
+				},
+				{
+					name: "version",
+					title: "Version",
+					type: "string",
+					group: "content",
+					fieldset: "dates",
+					validation: {
+						required: true,
+						pattern: "^\\d+\\.\\d+$",
+						patternMessage: "Use a version like 2.1."
+					},
+					description: "Bump the first number for material changes."
+				},
+				{
+					name: "summary",
+					title: "In short",
+					type: "richtext",
+					group: "content",
+					localized: true
+				},
+				{
+					name: "sections",
+					title: "Sections",
+					type: "array",
+					group: "content",
+					itemNoun: "section",
+					validation: {
+						min: 1,
+						max: 40
+					},
+					description: "Numbered automatically in this order.",
+					of: [{
+						name: "section",
+						title: "Section",
+						type: "object",
+						icon: "section",
+						preview: {
+							title: "heading",
+							subtitle: "anchor",
+							fallback: "Untitled section"
+						},
+						fields: [
+							{
+								name: "heading",
+								title: "Heading",
+								type: "string",
+								validation: {
+									required: true,
+									max: 80
+								},
+								localized: true
+							},
+							{
+								name: "anchor",
+								title: "Anchor",
+								type: "string",
+								validation: {
+									pattern: "^[a-z0-9-]+$",
+									patternMessage: "Use lowercase letters, numbers and hyphens, like camp-kitchen."
+								},
+								description: "Changing it once live breaks existing links."
+							},
+							{
+								name: "clauses",
+								title: "Clauses",
+								type: "array",
+								itemNoun: "clause",
+								validation: {
+									min: 1,
+									max: 30
+								},
+								of: [{
+									name: "clause",
+									title: "Clause",
+									type: "object",
+									icon: "align-left",
+									preview: {
+										title: "heading",
+										subtitle: "body",
+										fallback: "Untitled clause"
+									},
+									fields: [
+										{
+											name: "heading",
+											title: "Heading",
+											type: "string",
+											validation: { max: 80 },
+											localized: true
+										},
+										{
+											name: "body",
+											title: "Body",
+											type: "richtext",
+											validation: { required: true },
+											localized: true
+										},
+										{
+											name: "hasSummary",
+											title: "Add a plain-English note",
+											type: "boolean"
+										},
+										{
+											name: "plain",
+											title: "Plain-English note",
+											type: "text",
+											rows: 2,
+											hidden: {
+												field: "hasSummary",
+												equals: true
+											},
+											validation: {
+												required: true,
+												max: 240
+											},
+											localized: true,
+											description: ""
+										}
+									]
+								}]
+							}
+						]
+					}]
+				},
+				{
+					name: "contactEmail",
+					title: "Questions go to",
+					type: "email",
+					group: "content",
+					validation: { required: true }
+				},
+				{
+					name: "versions",
+					title: "Version history",
+					type: "array",
+					group: "versions",
+					itemNoun: "version",
+					validation: { max: 30 },
+					of: [{
+						name: "pastVersion",
+						title: "Past version",
+						type: "object",
+						icon: "history",
+						preview: {
+							title: "version",
+							subtitle: "effectiveDate"
+						},
+						fields: [
+							{
+								name: "version",
+								title: "Version",
+								type: "string",
+								validation: {
+									required: true,
+									pattern: "^\\d+\\.\\d+$",
+									patternMessage: "Use a version like 2.1."
+								}
+							},
+							{
+								name: "effectiveDate",
+								title: "Effective from",
+								type: "date",
+								validation: { required: true }
+							},
+							{
+								name: "changes",
+								title: "What changed",
+								type: "text",
+								rows: 2,
+								validation: {
+									required: true,
+									max: 300
+								}
+							},
+							{
+								name: "archive",
+								title: "Archived copy",
+								type: "file",
+								description: "A PDF of the full text as it stood."
+							}
+						]
+					}]
+				},
+				{
+					name: "numbering",
+					title: "Numbering",
+					type: "select",
+					group: "settings",
+					layout: "segmented",
+					initialValue: "decimal",
+					options: [
+						{
+							value: "decimal",
+							label: "1. 1.1"
+						},
+						{
+							value: "roman",
+							label: "I, A"
+						},
+						{
+							value: "none",
+							label: "None"
+						}
+					],
+					description: ""
+				},
+				{
+					name: "showContents",
+					title: "Show table of contents",
+					type: "boolean",
+					group: "settings",
+					initialValue: true
+				},
+				{
+					name: "showChangeBanner",
+					title: "Show a banner when it changes",
+					type: "boolean",
+					group: "settings",
+					description: "Shows a site banner for 30 days after a new effective date."
+				}
+			]
+		},
+		value: {
+			title: "Warranty & returns",
+			slug: "warranty-returns",
+			policyType: "warranty",
+			effectiveDate: "2026-10-01",
+			version: "3.0",
+			summary: "<p>Cast iron and carbon steel are covered for life against cracks, warps and failed welds. Unused items can come back within 60 days for a full refund. Seasoning wear isn't a defect.</p>",
+			sections: [{
+				_key: "s1",
+				heading: "Lifetime warranty",
+				anchor: "lifetime-warranty",
+				clauses: [{
+					_key: "c1",
+					heading: "What's covered",
+					body: "<p>Caldera warrants every cast iron and carbon steel product against defects in materials and workmanship, including cracking, warping beyond 1.5 mm and weld failure, for the life of the product.</p>",
+					hasSummary: true,
+					plain: "If it cracks, warps or a weld fails, we replace it. Forever."
+				}, {
+					_key: "c2",
+					heading: "What isn't",
+					body: "<p>Rust, seasoning loss, discolouration and damage from misuse — including thermal shock from cold water on a hot pan — are not defects.</p>",
+					hasSummary: true,
+					plain: "Rust and worn seasoning are fixable, not faults. We'll show you how."
+				}]
+			}, {
+				_key: "s2",
+				heading: "Returns",
+				anchor: "returns",
+				clauses: [{
+					_key: "c3",
+					heading: "60-day window",
+					body: "<p>Unused items in original packaging may be returned within 60 days of delivery for a full refund to the original payment method.</p>",
+					hasSummary: false
+				}, {
+					_key: "c4",
+					heading: "How to start a return",
+					body: "<p>Start a return at <a href=\"/returns\">caldera.bettercms.site/returns</a> with your order number. We email a prepaid label within one business day.</p>",
+					hasSummary: false
+				}]
+			}],
+			contactEmail: "care@caldera.co",
+			versions: [{
+				_key: "h1",
+				version: "2.1",
+				effectiveDate: "2025-03-01",
+				changes: "Returns window extended from 30 to 45 days.",
+				archive: {
+					url: "https://caldera.bettercms.site/media/legal/warranty-returns-v2-1.pdf",
+					name: "warranty-returns-v2-1.pdf",
+					size: 186e3
+				}
+			}, {
+				_key: "h2",
+				version: "2.0",
+				effectiveDate: "2024-01-15",
+				changes: "Carbon steel added to the lifetime warranty.",
+				archive: {
+					url: "https://caldera.bettercms.site/media/legal/warranty-returns-v2-0.pdf",
+					name: "warranty-returns-v2-0.pdf",
+					size: 171e3
+				}
+			}],
+			numbering: "decimal",
+			showContents: true,
+			showChangeBanner: true
+		},
+		notes: {
+			why: "Policies are static PAGES (one per policy, in the System folder), but their text is structured: sections → clauses, so numbering, anchors and the contents list are generated and stay correct when a clause is inserted. Each clause may carry a plain-English note (conditional), the pattern readers trust. The effective date and version are required; past versions are a repeater with an archived PDF so you can prove what a customer agreed to. policyType is developer-locked because footer and checkout links resolve by it.",
+			sanity: "Sanity: `legalPage` { sections: array<object{title, body: portableText}>, effectiveDate, version }. Numbering is usually typed into headings, which breaks on insert. Version history lives in Sanity's history, not in content — not something you can link customers to.",
+			htmlSignals: [
+				"Headings numbered '1.', '1.1', 'Section 4' or roman numerals",
+				"'Effective date', 'Last updated', 'Version' near the title",
+				"A contents list of #anchors at the top",
+				"Two-column 'In plain English' or 'TL;DR' asides beside clauses",
+				"Links to previous versions or PDFs"
+			],
+			mcp: "Strip typed numbers from headings ('4.2 Returns window' → 'Returns window'); top-level numbered headings → sections, sub-numbers → clauses. Keep existing element ids as anchors (links in emails depend on them). Side notes / TL;DR boxes → hasSummary + plain. 'Last updated' → effectiveDate (ask if the page shows both). Older version links → versions items with archive files downloaded.",
+			pitfalls: [
+				"Changing an anchor breaks links in sent emails and order confirmations.",
+				"Typed numbering drifts on insert — numbering is generated.",
+				"'Last updated' bumped for typos implies the terms changed.",
+				"Localized policies must be reviewed per locale, not machine-translated — flag localized fields."
+			]
+		}
+	},
+	{
+		id: "case-study",
+		label: "Case study",
+		category: "Long-form & docs",
+		brand: "Ledgerline",
+		previewLayout: "article",
+		tags: [
+			"rich-text",
+			"repeater",
+			"references",
+			"conditional",
+			"media-heavy",
+			"validation"
+		],
+		proves: "Customer facts as an object · headline metrics repeater · challenge/solution/results as three rich-text bodies · quote written here or referenced",
+		docTitle: "How Northbeam closes its books in 3 days",
+		urlPrefix: "ledgerline.com/customers/",
+		schema: {
+			name: "caseStudy",
+			title: "Case study",
+			kind: "entry",
+			icon: "briefcase",
+			category: "Long-form & docs",
+			description: "A customer story with results",
+			preview: {
+				title: "title",
+				subtitle: "customerName",
+				media: "customerLogo"
+			},
+			groups: [
+				CONTENT,
+				{
+					name: "customer",
+					title: "Customer",
+					icon: "building"
+				},
+				MEDIA
+			],
+			fieldsets: [{
+				name: "quote",
+				title: "Quote"
+			}],
+			fields: [
+				{
+					name: "title",
+					title: "Title",
+					type: "string",
+					group: "content",
+					validation: {
+						required: true,
+						max: 90
+					},
+					localized: true
+				},
+				{
+					name: "slug",
+					title: "Slug",
+					type: "slug",
+					group: "content",
+					validation: { required: true }
+				},
+				{
+					name: "summary",
+					title: "Summary",
+					type: "text",
+					rows: 2,
+					group: "content",
+					validation: {
+						required: true,
+						recommendedMax: 180
+					},
+					localized: true
+				},
+				{
+					name: "metrics",
+					title: "Headline results",
+					type: "array",
+					group: "content",
+					itemNoun: "result",
+					openMode: "inline",
+					validation: {
+						min: 2,
+						max: 4
+					},
+					of: [{
+						name: "metric",
+						title: "Result",
+						type: "object",
+						icon: "chart-bar",
+						preview: {
+							title: "value",
+							subtitle: "label"
+						},
+						fields: [
+							{
+								name: "value",
+								title: "Number",
+								type: "string",
+								validation: {
+									required: true,
+									max: 10
+								},
+								placeholder: "3 days"
+							},
+							{
+								name: "label",
+								title: "Label",
+								type: "string",
+								validation: {
+									required: true,
+									max: 40
+								}
+							},
+							{
+								name: "context",
+								title: "Compared with",
+								type: "string",
+								validation: { max: 40 },
+								placeholder: "down from 11"
+							}
+						]
+					}]
+				},
+				{
+					name: "challenge",
+					title: "The challenge",
+					type: "richtext",
+					group: "content",
+					validation: { required: true },
+					ai: true,
+					localized: true
+				},
+				{
+					name: "solution",
+					title: "The solution",
+					type: "richtext",
+					group: "content",
+					validation: { required: true },
+					ai: true,
+					localized: true
+				},
+				{
+					name: "results",
+					title: "The results",
+					type: "richtext",
+					group: "content",
+					validation: { required: true },
+					ai: true,
+					localized: true
+				},
+				{
+					name: "quoteSource",
+					title: "Quote",
+					type: "select",
+					group: "content",
+					fieldset: "quote",
+					layout: "segmented",
+					initialValue: "written",
+					options: [
+						{
+							value: "written",
+							label: "Write it here"
+						},
+						{
+							value: "testimonial",
+							label: "From Testimonials"
+						},
+						{
+							value: "none",
+							label: "None"
+						}
+					],
+					description: "Testimonials are reused on pricing and the homepage."
+				},
+				{
+					name: "quote",
+					title: "Quote",
+					type: "text",
+					rows: 3,
+					group: "content",
+					fieldset: "quote",
+					hidden: {
+						field: "quoteSource",
+						equals: "written"
+					},
+					validation: {
+						required: true,
+						recommendedMax: 220
+					}
+				},
+				{
+					name: "quoteName",
+					title: "Name",
+					type: "string",
+					group: "content",
+					fieldset: "quote",
+					hidden: {
+						field: "quoteSource",
+						equals: "written"
+					},
+					validation: { required: true }
+				},
+				{
+					name: "quoteRole",
+					title: "Role",
+					type: "string",
+					group: "content",
+					fieldset: "quote",
+					hidden: {
+						field: "quoteSource",
+						equals: "written"
+					}
+				},
+				{
+					name: "quotePhoto",
+					title: "Photo",
+					type: "image",
+					group: "content",
+					fieldset: "quote",
+					hidden: {
+						field: "quoteSource",
+						equals: "written"
+					}
+				},
+				{
+					name: "testimonial",
+					title: "Testimonial",
+					type: "reference",
+					group: "content",
+					fieldset: "quote",
+					reference: { to: ["col_testimonials"] },
+					hidden: {
+						field: "quoteSource",
+						equals: "testimonial"
+					},
+					validation: { required: true }
+				},
+				{
+					name: "productsUsed",
+					title: "Products used",
+					type: "multiselect",
+					group: "content",
+					options: [
+						{
+							value: "close",
+							label: "Close"
+						},
+						{
+							value: "reconcile",
+							label: "Reconcile"
+						},
+						{
+							value: "spend",
+							label: "Spend"
+						},
+						{
+							value: "reports",
+							label: "Reports"
+						}
+					],
+					description: "Also filters the customer list."
+				},
+				{
+					name: "button",
+					title: "Button",
+					type: "button",
+					group: "content"
+				},
+				{
+					name: "customerName",
+					title: "Company",
+					type: "string",
+					group: "customer",
+					validation: {
+						required: true,
+						max: 40
+					}
+				},
+				{
+					name: "customerLogo",
+					title: "Logo",
+					type: "image",
+					group: "customer",
+					validation: { required: true },
+					description: "SVG or a transparent PNG."
+				},
+				{
+					name: "industry",
+					title: "Industry",
+					type: "select",
+					group: "customer",
+					options: [
+						{
+							value: "saas",
+							label: "Software"
+						},
+						{
+							value: "ecommerce",
+							label: "E-commerce"
+						},
+						{
+							value: "marketplace",
+							label: "Marketplace"
+						},
+						{
+							value: "fintech",
+							label: "Fintech"
+						},
+						{
+							value: "healthcare",
+							label: "Healthcare"
+						}
+					],
+					description: ""
+				},
+				{
+					name: "companySize",
+					title: "Company size",
+					type: "select",
+					group: "customer",
+					options: [
+						{
+							value: "1-50",
+							label: "1–50"
+						},
+						{
+							value: "51-200",
+							label: "51–200"
+						},
+						{
+							value: "201-1000",
+							label: "201–1,000"
+						},
+						{
+							value: "1000+",
+							label: "1,000+"
+						}
+					],
+					description: ""
+				},
+				{
+					name: "region",
+					title: "Region",
+					type: "select",
+					group: "customer",
+					options: [
+						{
+							value: "na",
+							label: "North America"
+						},
+						{
+							value: "emea",
+							label: "Europe & Middle East"
+						},
+						{
+							value: "apac",
+							label: "Asia Pacific"
+						}
+					],
+					description: ""
+				},
+				{
+					name: "website",
+					title: "Website",
+					type: "url",
+					group: "customer"
+				},
+				{
+					name: "coverImage",
+					title: "Cover image",
+					type: "image",
+					group: "media",
+					validation: { required: true }
+				},
+				{
+					name: "pdf",
+					title: "PDF version",
+					type: "file",
+					group: "media",
+					description: "Offered as a download on the page."
+				}
+			]
+		},
+		value: {
+			title: "How Northbeam closes its books in 3 days",
+			slug: "northbeam",
+			summary: "Northbeam's four-person finance team cut month-end close from 11 days to 3 while revenue doubled — without adding headcount.",
+			metrics: [
+				{
+					_key: "m1",
+					value: "3 days",
+					label: "Month-end close",
+					context: "down from 11"
+				},
+				{
+					_key: "m2",
+					value: "92%",
+					label: "Transactions auto-matched",
+					context: "up from 40%"
+				},
+				{
+					_key: "m3",
+					value: "0",
+					label: "New finance hires",
+					context: "while revenue doubled"
+				}
+			],
+			challenge: "<p>Northbeam sells to 6,000 Shopify brands across three currencies. Its finance team reconciled Stripe payouts against bank lines in spreadsheets — <strong>11 days</strong> every month, and growing.</p>",
+			solution: "<p>Ledgerline connected Stripe, two banks and NetSuite in an afternoon. Bank rules matched payouts automatically, and the multi-entity checklist replaced a 140-row spreadsheet.</p>",
+			results: "<p>Close now takes three days. The controller spends the rest of the month on forecasting instead of matching, and auditors pull evidence straight from the close report.</p>",
+			quoteSource: "written",
+			quote: "We closed March in three days and nobody stayed late. I didn't think that was possible at our volume.",
+			quoteName: "Dana Whitfield",
+			quoteRole: "Controller, Northbeam",
+			quotePhoto: image("dana-whitfield", "Portrait of Dana Whitfield", 400, 400),
+			productsUsed: ["close", "reconcile"],
+			button: {
+				label: "Book a demo",
+				href: "/demo",
+				type: "page",
+				title: "Book a demo",
+				style: "primary",
+				arrow: true
+			},
+			customerName: "Northbeam",
+			customerLogo: {
+				url: "https://picsum.photos/seed/northbeam-logo/480/160",
+				alt: "Northbeam",
+				name: "northbeam-logo.svg",
+				width: 480,
+				height: 160
+			},
+			industry: "saas",
+			companySize: "201-1000",
+			region: "na",
+			website: "https://www.northbeam.io",
+			coverImage: image("northbeam-team", "Northbeam's finance team at a whiteboard covered in a close calendar"),
+			pdf: {
+				url: "https://ledgerline.com/media/customers/northbeam-one-pager.pdf",
+				name: "northbeam-one-pager.pdf",
+				size: 612e3
+			}
+		},
+		notes: {
+			why: "Case studies are entries in a Customers collection so the customer logo wall, the filterable customer list (industry, size, region, product) and pricing-page proof all query them. Customer facts are real fields in their own group, not prose. The story is three required rich-text bodies — challenge, solution, results — because every case study must answer all three and the template styles each part. Headline metrics are a 2–4 item repeater (value, label, comparison). The quote can be written here or referenced from Testimonials when it's reused elsewhere — one select decides.",
+			sanity: "Sanity: `caseStudy` { customer: reference→company, stats: array<object>, body: portableText, testimonial: reference→testimonial }. Many teams put everything in one body; three bodies make the structure enforceable.",
+			htmlSignals: [
+				"A customer logo and big numbers row near the top ('3 days', '92%')",
+				"Sections headed Challenge / Solution / Results (or Problem / Approach / Outcome)",
+				"A large pull quote with name, title and headshot",
+				"A side panel: Industry, Company size, Location, Products used",
+				"URL under /customers/ or /case-studies/"
+			],
+			mcp: "Side panel facts → customer group fields (map 'Industry: SaaS' to the select). The numbers row → metrics (value as written, label underneath, 'from X' → context). Split the body at Challenge/Solution/Results headings into the three richtext fields (drop the headings themselves). A pull quote that also appears on other pages → create a Testimonial and use quoteSource 'testimonial'. Download links to a PDF → pdf.",
+			pitfalls: [
+				"Metrics without approval — help text says so; numbers are what legal checks.",
+				"One undivided body: the Challenge/Solution/Results layout can't be enforced.",
+				"Customer logos as JPG with a white box — ask for SVG/transparent PNG.",
+				"Duplicate quotes typed in three places drift — reference Testimonials."
+			]
+		}
+	},
+	{
+		id: "podcast-episode",
+		label: "Podcast episode",
+		category: "Long-form & docs",
+		brand: "Caldera",
+		previewLayout: "article",
+		tags: [
+			"media-heavy",
+			"embed",
+			"references",
+			"repeater",
+			"seo-structured",
+			"a11y",
+			"validation",
+			"conditional"
+		],
+		proves: "Audio file + show notes + timestamped chapters + transcript (a11y) · guests by reference · feeds the RSS and PodcastEpisode JSON-LD",
+		docTitle: "Ep. 42 — Cooking at 3,000 metres",
+		urlPrefix: "caldera.bettercms.site/podcast/",
+		schema: {
+			name: "podcastEpisode",
+			title: "Podcast episode",
+			kind: "entry",
+			icon: "microphone",
+			category: "Long-form & docs",
+			description: "One episode of the show, with audio, notes and transcript",
+			preview: {
+				title: "title",
+				subtitle: "episodeNumber",
+				media: "art"
+			},
+			groups: [
+				CONTENT,
+				{
+					name: "audio",
+					title: "Audio",
+					icon: "headphones"
+				},
+				{
+					name: "transcript",
+					title: "Transcript",
+					icon: "file-text"
+				}
+			],
+			fieldsets: [{
+				name: "numbering",
+				title: "Numbering",
+				columns: 2
+			}],
+			fields: [
+				{
+					name: "title",
+					title: "Title",
+					type: "string",
+					group: "content",
+					validation: {
+						required: true,
+						max: 90
+					},
+					description: "Without the episode number. Apps add it."
+				},
+				{
+					name: "slug",
+					title: "Slug",
+					type: "slug",
+					group: "content",
+					validation: { required: true }
+				},
+				{
+					name: "episodeType",
+					title: "Type",
+					type: "select",
+					group: "content",
+					fieldset: "numbering",
+					layout: "segmented",
+					initialValue: "full",
+					options: [
+						{
+							value: "full",
+							label: "Full"
+						},
+						{
+							value: "bonus",
+							label: "Bonus"
+						},
+						{
+							value: "trailer",
+							label: "Trailer"
+						}
+					],
+					description: ""
+				},
+				{
+					name: "season",
+					title: "Season",
+					type: "number",
+					group: "content",
+					fieldset: "numbering",
+					numeric: {
+						min: 1,
+						step: 1
+					}
+				},
+				{
+					name: "episodeNumber",
+					title: "Episode",
+					type: "number",
+					group: "content",
+					fieldset: "numbering",
+					numeric: {
+						min: 1,
+						step: 1
+					},
+					hidden: {
+						field: "episodeType",
+						equals: "full"
+					},
+					validation: { required: true }
+				},
+				{
+					name: "publishedAt",
+					title: "Publish date",
+					type: "datetime",
+					group: "content",
+					validation: { required: true },
+					description: "Also the release time in podcast apps."
+				},
+				{
+					name: "summary",
+					title: "Summary",
+					type: "text",
+					rows: 2,
+					group: "content",
+					validation: {
+						required: true,
+						recommendedMax: 250
+					},
+					description: "The first lines podcast apps show. No links."
+				},
+				{
+					name: "showNotes",
+					title: "Show notes",
+					type: "richtext",
+					group: "content",
+					validation: { required: true },
+					description: "Also goes into the RSS feed."
+				},
+				refs("hosts", "Hosts", ["col_authors"], {
+					group: "content",
+					validation: {
+						min: 1,
+						max: 3
+					}
+				}),
+				refs("guests", "Guests", ["col_people"], {
+					group: "content",
+					validation: { max: 4 },
+					description: "Each guest gets a card and links back from their profile."
+				}),
+				{
+					name: "chapters",
+					title: "Chapters",
+					type: "array",
+					group: "content",
+					itemNoun: "chapter",
+					openMode: "inline",
+					validation: { max: 30 },
+					of: [{
+						name: "chapter",
+						title: "Chapter",
+						type: "object",
+						icon: "clock",
+						preview: {
+							title: "title",
+							subtitle: "start"
+						},
+						fields: [{
+							name: "start",
+							title: "Starts at",
+							type: "string",
+							validation: {
+								required: true,
+								pattern: "^(\\d{1,2}:)?[0-5]?\\d:[0-5]\\d$",
+								patternMessage: "Use mm:ss or h:mm:ss, like 12:40."
+							},
+							placeholder: "12:30"
+						}, {
+							name: "title",
+							title: "Title",
+							type: "string",
+							validation: {
+								required: true,
+								max: 60
+							}
+						}]
+					}]
+				},
+				{
+					name: "audio",
+					title: "Audio file",
+					type: "file",
+					group: "audio",
+					validation: { required: true },
+					description: "MP3 or M4A. The player and the RSS feed both use it."
+				},
+				{
+					name: "durationSeconds",
+					title: "Length",
+					type: "number",
+					group: "audio",
+					readOnly: true,
+					numeric: { unit: "s" },
+					description: "Read from the audio file."
+				},
+				{
+					name: "isExplicit",
+					title: "Explicit content",
+					type: "boolean",
+					group: "audio",
+					description: "Marks it explicit in podcast apps."
+				},
+				{
+					name: "art",
+					title: "Episode art",
+					type: "image",
+					group: "audio",
+					description: "Square, 3000 × 3000. Leave empty to use the show art."
+				},
+				{
+					name: "video",
+					title: "Video version",
+					type: "video",
+					group: "audio"
+				},
+				{
+					name: "transcriptSource",
+					title: "Transcript",
+					type: "select",
+					group: "transcript",
+					layout: "segmented",
+					initialValue: "text",
+					options: [{
+						value: "text",
+						label: "Write or paste"
+					}, {
+						value: "file",
+						label: "Upload file"
+					}]
+				},
+				{
+					name: "transcript",
+					title: "Transcript text",
+					type: "richtext",
+					group: "transcript",
+					hidden: {
+						field: "transcriptSource",
+						equals: "text"
+					},
+					description: "Bold each speaker's name at the start of their turn."
+				},
+				{
+					name: "transcriptFile",
+					title: "Transcript file",
+					type: "file",
+					group: "transcript",
+					hidden: {
+						field: "transcriptSource",
+						equals: "file"
+					},
+					description: "A .vtt or .srt file. Also used as player captions."
+				}
+			]
+		},
+		value: {
+			title: "Cooking at 3,000 metres",
+			slug: "cooking-at-3000-metres",
+			episodeType: "full",
+			season: 3,
+			episodeNumber: 42,
+			publishedAt: "2026-09-29T05:00:00-07:00[America/Los_Angeles]",
+			summary: "Mountain guide Inés Calderón on why water boils at 90°C up high, the one pan she carries up Aconcagua, and dinner for twelve in a snowstorm.",
+			showNotes: "<p>Inés guides on Aconcagua and in the Cordillera Blanca. We talk altitude, fuel and feeding a team at the end of a 14-hour day.</p><h3>Mentioned</h3><ul><li><a href=\"/products/carbon-pan-8\">Carbon Steel Pan 8\"</a></li><li><a href=\"/recipes/one-pot-lentils\">One-pot lentils with chorizo</a></li><li><a href=\"https://www.ineshighaltitude.com\" rel=\"nofollow\">Inés's guiding company</a></li></ul>",
+			hosts: ["au_mei"],
+			guests: ["en_p_ines-calderon"],
+			chapters: [
+				{
+					_key: "ch1",
+					start: "0:00",
+					title: "Intro"
+				},
+				{
+					_key: "ch2",
+					start: "3:12",
+					title: "Why water boils at 90°C"
+				},
+				{
+					_key: "ch3",
+					start: "17:45",
+					title: "The one-pan kit list"
+				},
+				{
+					_key: "ch4",
+					start: "34:20",
+					title: "Dinner for twelve in a storm"
+				}
+			],
+			audio: {
+				url: "https://media.caldera.co/podcast/low-slow-s3e42.mp3",
+				name: "low-slow-s3e42.mp3",
+				size: 61234567
+			},
+			durationSeconds: 2934,
+			isExplicit: false,
+			art: null,
+			video: { url: "https://www.youtube.com/watch?v=Fq3J2xQm8Hk" },
+			transcriptSource: "text",
+			transcript: "<p><strong>Mei:</strong> Inés, you've cooked on more summits than anyone I know. What surprises people first?</p><p><strong>Inés:</strong> That pasta never cooks. Water boils at about ninety degrees up there, so everything takes twice as long and you burn twice the fuel.</p>"
+		},
+		notes: {
+			why: "Episodes are entries: each has a URL, audio, notes and a transcript, and the same entry feeds three outputs — the episode page, the podcast RSS feed (enclosure, itunes:duration, itunes:episode/season/episodeType, content:encoded from show notes) and PodcastEpisode JSON-LD — all native. Duration is read from the file (read-only) so the feed is never wrong. Chapters are a tiny inline repeater with a time pattern. Episode number is required only for full episodes (bonus and trailers aren't numbered). The transcript is either rich text or a caption file — one select reveals one field.",
+			sanity: "Sanity: `episode` { audio: file, duration: number, season, episodeNumber, showNotes: portableText, guests: array<reference→person>, chapters: array<object{start, title}>, transcript: portableText }. RSS is generated by the frontend.",
+			htmlSignals: [
+				"An <audio> player or a Transistor/Buzzsprout/Simplecast iframe as the page's main media",
+				"'Episode 42', 'S3 E42', a duration like '48:54'",
+				"Timestamps (12:30) linking to positions in the player",
+				"'Show notes', 'Mentioned in this episode', 'Transcript' sections",
+				"Guest cards with headshots and links"
+			],
+			mcp: "Pull the episode from the show's RSS <item> when available (enclosure → audio, itunes:* → numbering/type/duration/isExplicit, content:encoded → showNotes, podcast:chapters/podcast:transcript → chapters/transcript). From the page: '12:30 — Topic' lines → chapters; 'Transcript' section → transcript (speaker labels bolded). Guests → people entries. Don't store the embed iframe; store the audio file.",
+			pitfalls: [
+				"Episode number typed into the title ('Ep. 42 —') duplicates in apps.",
+				"Summary with HTML/links — some apps show raw tags.",
+				"Missing transcript fails accessibility and loses search traffic.",
+				"Changing the audio file URL after publish re-downloads in every subscriber's app — replace in place."
+			]
+		}
+	}
+];
+//#endregion
+export { ENTRIES };
+
+//# sourceMappingURL=longform.entries.js.map