@bettercms-ai/kit 0.1.1 → 2.0.0

package/dist/library/entries/heroes.entries.js

@@ -0,0 +1,3401 @@
+//#region src/library/entries/heroes.entries.ts
+var pic = (seed, alt, w = 1600, h = 1e3) => ({
+	url: `https://picsum.photos/seed/${seed}/${w}/${h}`,
+	alt,
+	name: `${seed}.jpg`,
+	width: w,
+	height: h
+});
+var btn = (label, href, style = "primary", extra = {}) => ({
+	label,
+	href,
+	type: href.startsWith("http") ? "url" : href.startsWith("#") ? "section" : "page",
+	style,
+	...extra
+});
+var eyebrow = {
+	name: "eyebrow",
+	title: "Eyebrow",
+	type: "string",
+	validation: { max: 40 }
+};
+var heading = (rec = 60) => ({
+	name: "heading",
+	title: "Heading",
+	type: "string",
+	validation: {
+		required: true,
+		max: 100,
+		recommendedMax: rec
+	},
+	ai: true,
+	localized: true
+});
+var body = (rec = 180) => ({
+	name: "body",
+	title: "Body",
+	type: "text",
+	rows: 3,
+	validation: { recommendedMax: rec },
+	ai: true,
+	localized: true
+});
+var primary = {
+	name: "primaryButton",
+	title: "Primary button",
+	type: "button"
+};
+var secondary = {
+	name: "secondaryButton",
+	title: "Secondary button",
+	type: "button"
+};
+var GROUPS = [
+	{
+		name: "content",
+		title: "Content",
+		default: true
+	},
+	{
+		name: "media",
+		title: "Media"
+	},
+	{
+		name: "design",
+		title: "Design"
+	}
+];
+var theme = {
+	name: "theme",
+	title: "Theme",
+	type: "select",
+	group: "design",
+	layout: "segmented",
+	initialValue: "light",
+	options: [
+		{
+			value: "light",
+			label: "Light"
+		},
+		{
+			value: "dark",
+			label: "Dark"
+		},
+		{
+			value: "brand",
+			label: "Brand"
+		}
+	]
+};
+var overlay = {
+	name: "overlay",
+	title: "Image overlay",
+	type: "number",
+	group: "design",
+	layout: "slider",
+	numeric: {
+		min: 0,
+		max: 80,
+		step: 5,
+		unit: "%"
+	},
+	initialValue: 35
+};
+var spacing = {
+	name: "spacing",
+	title: "Spacing",
+	type: "select",
+	group: "design",
+	layout: "segmented",
+	initialValue: "default",
+	options: [
+		{
+			value: "compact",
+			label: "Compact"
+		},
+		{
+			value: "default",
+			label: "Default"
+		},
+		{
+			value: "spacious",
+			label: "Spacious"
+		}
+	]
+};
+var align = {
+	name: "alignment",
+	title: "Alignment",
+	type: "select",
+	group: "design",
+	layout: "segmented",
+	initialValue: "left",
+	options: [{
+		value: "left",
+		label: "Left"
+	}, {
+		value: "center",
+		label: "Centered"
+	}]
+};
+var ENTRIES = [
+	{
+		id: "hero-split-media",
+		previewLayout: "split",
+		label: "Split hero with media switch",
+		proves: "One media slot that can be an image, a video or a small gallery · a phone crop · benefit list as plain strings",
+		category: "Heroes",
+		tags: [
+			"variants",
+			"conditional",
+			"media-heavy",
+			"a11y",
+			"repeater"
+		],
+		brand: "Caldera",
+		schema: {
+			name: "mediaHero",
+			title: "Media hero",
+			kind: "block",
+			icon: "layout-columns",
+			category: "Heroes",
+			description: "Copy on one side, an image, video or gallery on the other.",
+			variants: [
+				{
+					id: "media-right",
+					name: "Media right"
+				},
+				{
+					id: "media-left",
+					name: "Media left"
+				},
+				{
+					id: "overlap",
+					name: "Overlapping card",
+					description: "Copy sits on a card over the media edge"
+				}
+			],
+			preview: {
+				title: "heading",
+				subtitle: "eyebrow",
+				media: "image"
+			},
+			groups: GROUPS,
+			fields: [
+				eyebrow,
+				heading(),
+				body(),
+				{
+					name: "points",
+					title: "Key points",
+					type: "array",
+					itemNoun: "point",
+					validation: { max: 3 },
+					of: [{
+						name: "point",
+						title: "Point",
+						type: "string",
+						validation: { max: 48 }
+					}]
+				},
+				primary,
+				secondary,
+				{
+					name: "mediaType",
+					title: "Media",
+					type: "select",
+					group: "media",
+					layout: "segmented",
+					initialValue: "image",
+					options: [
+						{
+							value: "image",
+							label: "Image"
+						},
+						{
+							value: "video",
+							label: "Video"
+						},
+						{
+							value: "gallery",
+							label: "Gallery"
+						}
+					]
+				},
+				{
+					name: "image",
+					title: "Image",
+					type: "image",
+					group: "media",
+					hidden: {
+						field: "mediaType",
+						equals: "image"
+					},
+					validation: { required: true },
+					description: "At least 1600px wide."
+				},
+				{
+					name: "video",
+					title: "Video",
+					type: "video",
+					group: "media",
+					hidden: {
+						field: "mediaType",
+						equals: "video"
+					},
+					validation: { required: true },
+					description: "Plays muted and loops."
+				},
+				{
+					name: "poster",
+					title: "Poster",
+					type: "image",
+					group: "media",
+					hidden: {
+						field: "mediaType",
+						equals: "video"
+					},
+					validation: { required: true }
+				},
+				{
+					name: "gallery",
+					title: "Gallery",
+					type: "array",
+					group: "media",
+					arrayLayout: "grid",
+					itemNoun: "image",
+					hidden: {
+						field: "mediaType",
+						equals: "gallery"
+					},
+					validation: {
+						min: 2,
+						max: 4
+					},
+					of: [{
+						name: "image",
+						title: "Image",
+						type: "image"
+					}]
+				},
+				{
+					name: "mobileImage",
+					title: "Phone image",
+					type: "image",
+					group: "media",
+					description: "Leave empty to reuse the main image."
+				},
+				{
+					name: "fit",
+					title: "Image fit",
+					type: "select",
+					group: "design",
+					layout: "segmented",
+					initialValue: "cover",
+					options: [{
+						value: "cover",
+						label: "Fill"
+					}, {
+						value: "contain",
+						label: "Fit",
+						description: "For product cut-outs on a plain background"
+					}]
+				},
+				theme,
+				spacing
+			]
+		},
+		value: {
+			_variant: "media-right",
+			eyebrow: "The Ridge Skillet",
+			heading: "Sears like a steakhouse. Weighs a third less.",
+			body: "Spun carbon steel, pre-seasoned with flaxseed in Bend and ready for coals, gas or induction on day one.",
+			points: [
+				"Ready for induction and open fire",
+				"Pre-seasoned three times",
+				"Lifetime warranty"
+			],
+			primaryButton: btn("Shop the skillet", "/products/ridge-skillet-10", "primary", { arrow: true }),
+			secondaryButton: btn("How we season it", "/journal/seasoning", "link"),
+			mediaType: "image",
+			image: pic("caldera-ridge-skillet", "Ridge skillet searing two steaks over a bed of coals", 1600, 2e3),
+			mobileImage: pic("caldera-ridge-mobile", "Ridge skillet searing two steaks, close crop", 1080, 1350),
+			fit: "cover",
+			theme: "light",
+			spacing: "default"
+		},
+		notes: {
+			why: "The core Hero has one image; real split heroes swap between an image, a muted video and a 2–4 image gallery. One `mediaType` select drives which media fields show, so the content model never holds an image AND a video that disagree. The poster is its own required field because the video type can't require one. The phone crop is a separate optional image, not a crop setting, because art direction on phones is often a different photo. Key points are an array of strings — no icon, no link — so the converter doesn't invent features. Side (left/right/overlap) is a variant; fit, theme and spacing are Design.",
+			sanity: "object `mediaHero` { eyebrow, heading, body, points: array<string>, primaryButton/secondaryButton: object button, mediaType: string(list), image: image{hotspot}, video: file|mux.video, poster: image, gallery: array<image>, mobileImage: image } with `hidden: ({parent}) => parent.mediaType !== 'image'`.",
+			htmlSignals: [
+				"First <section> after the header with a two-column grid: text column (h1, p, 1–2 links) + media column",
+				"Media column contains <img>, <picture> with a different mobile <source>, or <video autoplay muted loop playsinline poster>",
+				"A short <ul> of 2–3 items with check icons under the paragraph",
+				"Column order flipped via flex-direction: row-reverse or order — the media-left variant"
+			],
+			mcp: "One H1 + paragraph + buttons + a single media column → `mediaHero`. <video> → mediaType 'video', video = src, poster = poster attribute (create an asset from it). Several <img> in the media column → mediaType 'gallery'. <picture> with a (max-width) <source> of a different image → mobileImage. Check-mark list items → points (text only). Media column first in the DOM or row-reverse → variant 'media-left'. object-fit: contain → fit 'contain'.",
+			pitfalls: ["A hero with BOTH a background video and a side image is a different section (full-bleed video) — don't merge.", "Alt text on a decorative hero photo should still describe it when it shows the product."]
+		}
+	},
+	{
+		id: "hero-centered-gradient",
+		previewLayout: "centered",
+		label: "Centered hero with gradient + screenshot",
+		proves: "Announcement chip as a link unit · highlighted phrase in a plain string · gradient as design data, not CSS in content",
+		category: "Heroes",
+		tags: [
+			"variants",
+			"conditional",
+			"validation",
+			"media-heavy"
+		],
+		brand: "Tideline",
+		schema: {
+			name: "launchHero",
+			title: "Launch hero",
+			kind: "block",
+			icon: "layout-align-center",
+			category: "Heroes",
+			description: "A centered headline over a gradient, with an optional product screenshot below.",
+			variants: [{
+				id: "screenshot",
+				name: "With screenshot",
+				description: "Product UI rises out of the bottom edge"
+			}, {
+				id: "text",
+				name: "Text only"
+			}],
+			preview: {
+				title: "heading",
+				subtitle: "chip.label",
+				media: "screenshot"
+			},
+			groups: GROUPS,
+			fields: [
+				{
+					name: "chip",
+					title: "Announcement chip",
+					type: "object",
+					icon: "sparkles",
+					openMode: "inline",
+					fields: [{
+						name: "label",
+						title: "Label",
+						type: "string",
+						validation: { max: 48 },
+						placeholder: "New: Traces for Kubernetes"
+					}, {
+						name: "link",
+						title: "Links to",
+						type: "link"
+					}]
+				},
+				heading(56),
+				{
+					name: "highlightedWords",
+					title: "Highlighted words",
+					type: "string",
+					validation: { max: 32 },
+					description: "Must match words in the headline exactly. Leave empty for none."
+				},
+				{
+					name: "subheading",
+					title: "Subheading",
+					type: "text",
+					rows: 2,
+					validation: { recommendedMax: 160 },
+					ai: true,
+					localized: true
+				},
+				primary,
+				secondary,
+				{
+					name: "note",
+					title: "Small print",
+					type: "string",
+					validation: { max: 64 },
+					placeholder: "No credit card required"
+				},
+				{
+					name: "screenshot",
+					title: "Screenshot",
+					type: "image",
+					group: "media",
+					description: "At least 2400px wide."
+				},
+				{
+					name: "background",
+					title: "Background",
+					type: "object",
+					group: "design",
+					icon: "palette",
+					openMode: "drill",
+					fields: [
+						{
+							name: "style",
+							title: "Style",
+							type: "select",
+							layout: "cards",
+							initialValue: "radial",
+							options: [
+								{
+									value: "none",
+									label: "Plain",
+									icon: "square"
+								},
+								{
+									value: "linear",
+									label: "Linear",
+									icon: "arrows-diagonal"
+								},
+								{
+									value: "radial",
+									label: "Glow",
+									icon: "circle-dot",
+									description: "A soft light from the top"
+								},
+								{
+									value: "mesh",
+									label: "Mesh",
+									icon: "grid-dots",
+									description: "Blended color blobs"
+								}
+							]
+						},
+						{
+							name: "from",
+							title: "Color 1",
+							type: "color",
+							hidden: {
+								field: "style",
+								equals: [
+									"linear",
+									"radial",
+									"mesh"
+								]
+							}
+						},
+						{
+							name: "to",
+							title: "Color 2",
+							type: "color",
+							hidden: {
+								field: "style",
+								equals: [
+									"linear",
+									"radial",
+									"mesh"
+								]
+							}
+						},
+						{
+							name: "via",
+							title: "Color 3",
+							type: "color",
+							hidden: {
+								field: "style",
+								equals: "mesh"
+							}
+						},
+						{
+							name: "angle",
+							title: "Angle",
+							type: "number",
+							layout: "slider",
+							hidden: {
+								field: "style",
+								equals: "linear"
+							},
+							numeric: {
+								min: 0,
+								max: 360,
+								step: 15,
+								unit: "°"
+							},
+							initialValue: 180
+						}
+					]
+				},
+				{
+					...theme,
+					initialValue: "dark"
+				},
+				{
+					name: "width",
+					title: "Text width",
+					type: "select",
+					group: "design",
+					layout: "segmented",
+					initialValue: "narrow",
+					options: [{
+						value: "narrow",
+						label: "Narrow"
+					}, {
+						value: "wide",
+						label: "Wide"
+					}]
+				}
+			]
+		},
+		value: {
+			_variant: "screenshot",
+			chip: {
+				label: "New: Traces for Kubernetes",
+				link: {
+					type: "page",
+					href: "/changelog/kubernetes-traces",
+					title: "Kubernetes traces"
+				}
+			},
+			heading: "Find the slow service before your customers do.",
+			highlightedWords: "slow service",
+			subheading: "Tideline links every trace, log and deploy so on-call engineers see the cause in one view — not twelve tabs.",
+			primaryButton: btn("Start free", "https://app.tideline.dev/signup", "primary"),
+			secondaryButton: btn("Book a demo", "/demo", "outline"),
+			note: "Free for 3 engineers · No credit card required",
+			screenshot: pic("tideline-service-map", "Tideline service map with the checkout service highlighted in red at 1.8 seconds", 2400, 1500),
+			background: {
+				style: "radial",
+				from: "#1B2A4A",
+				to: "#0B1020",
+				angle: 180
+			},
+			theme: "dark",
+			width: "narrow"
+		},
+		notes: {
+			why: "The gradient is DESIGN data: a style select plus colors in the Design group, so a rebrand changes three values instead of rewriting CSS strings pasted into content. Which color fields show depends on the style (mesh needs three, plain needs none). The highlighted phrase is a separate string that must match part of the headline — a pragmatic stand-in for inline marks in a single-line field (richtext would let authors add bold, links and line breaks we don't want in an H1). The announcement chip is an inline object of label + link because it's a link with its own copy, not a button.",
+			sanity: "object `launchHero` { chip: object { label, link }, heading: string, highlight: string, subheading: text, primary/secondary, note, screenshot: image, background: object { style, from/via/to: color (sanity-plugin-color-input), angle: number } }. Many Sanity teams model the heading as a tiny Portable Text with a single 'highlight' decorator instead.",
+			htmlSignals: [
+				"A centered <section> (text-align:center, max-width ~720px) with a pill-shaped <a> above the H1",
+				"A <span> inside the H1 with a gradient/color class — the highlighted phrase",
+				"background-image: linear-gradient/radial-gradient on the section, or absolutely positioned blurred blobs (mesh)",
+				"A large <img> of app UI below the buttons, often with a perspective transform or bottom fade",
+				"A small muted line under the buttons ('No credit card required')"
+			],
+			mcp: "Centered H1 + optional pill link → `launchHero`. Pill → chip { label: text, link: href }. A <span>/<em> inside the H1 → highlightedWords = its text; heading = the H1's full plain text. Parse the section's gradient: linear-gradient(angle, a, b) → { style: 'linear', angle, from: a, to: b }; radial-gradient → 'radial'; blurred absolutely-positioned blobs → 'mesh' with up to three colors. Snap colors to the nearest brand token when one is within ΔE 5 (report the rest). Screenshot <img> → screenshot; variant 'screenshot' when present else 'text'.",
+			pitfalls: ["Editing the headline can orphan the highlight — the renderer must ignore a highlight that no longer matches (no cross-field validation yet).", "Don't store raw CSS gradient strings — they can't be re-themed or validated."]
+		}
+	},
+	{
+		id: "hero-video-fullbleed",
+		previewLayout: "media",
+		label: "Full-bleed video hero with captions",
+		proves: "An Accessibility tab: caption tracks, transcript, text alternative · poster required · pause control locked on",
+		category: "Heroes",
+		tags: [
+			"media-heavy",
+			"a11y",
+			"conditional",
+			"repeater",
+			"validation"
+		],
+		brand: "Open Water Trust",
+		schema: {
+			name: "videoHero",
+			title: "Video hero",
+			kind: "block",
+			icon: "movie",
+			category: "Heroes",
+			description: "A muted background film behind a headline, with captions and a transcript.",
+			preview: {
+				title: "heading",
+				subtitle: "eyebrow",
+				media: "poster"
+			},
+			groups: [
+				{
+					name: "content",
+					title: "Content",
+					default: true
+				},
+				{
+					name: "media",
+					title: "Media"
+				},
+				{
+					name: "a11y",
+					title: "Accessibility"
+				},
+				{
+					name: "design",
+					title: "Design"
+				}
+			],
+			fields: [
+				eyebrow,
+				heading(56),
+				body(140),
+				primary,
+				{
+					...secondary,
+					description: "Often links to the full film with sound, e.g. Watch the 4-minute film."
+				},
+				{
+					name: "video",
+					title: "Background video",
+					type: "video",
+					group: "media",
+					validation: { required: true },
+					description: "MP4 or a Vimeo link, under 10 MB."
+				},
+				{
+					name: "mobileVideo",
+					title: "Phone video",
+					type: "video",
+					group: "media",
+					description: "Leave empty to show the poster on phones."
+				},
+				{
+					name: "poster",
+					title: "Poster",
+					type: "image",
+					group: "media",
+					validation: { required: true }
+				},
+				{
+					name: "captions",
+					title: "Caption tracks",
+					type: "array",
+					group: "a11y",
+					itemNoun: "track",
+					validation: { max: 6 },
+					description: "Required when the video has speech.",
+					of: [{
+						name: "track",
+						title: "Track",
+						type: "object",
+						icon: "subtask",
+						openMode: "inline",
+						preview: {
+							title: "label",
+							subtitle: "language",
+							fallback: "Untitled track"
+						},
+						fields: [
+							{
+								name: "language",
+								title: "Language",
+								type: "select",
+								validation: {
+									required: true,
+									unique: true
+								},
+								options: [
+									{
+										value: "en",
+										label: "English"
+									},
+									{
+										value: "es",
+										label: "Spanish"
+									},
+									{
+										value: "fr",
+										label: "French"
+									}
+								]
+							},
+							{
+								name: "label",
+								title: "Menu label",
+								type: "string",
+								validation: {
+									required: true,
+									max: 24
+								},
+								placeholder: "English (CC)"
+							},
+							{
+								name: "file",
+								title: "Caption file",
+								type: "file",
+								validation: { required: true },
+								description: "A .vtt file."
+							}
+						]
+					}]
+				},
+				{
+					name: "textAlternative",
+					title: "What the video shows",
+					type: "text",
+					group: "a11y",
+					rows: 2,
+					validation: {
+						required: true,
+						recommendedMax: 200
+					},
+					description: "Not shown. Read by screen readers instead of the video."
+				},
+				{
+					name: "transcript",
+					title: "Transcript",
+					type: "link",
+					group: "a11y"
+				},
+				{
+					name: "showPauseButton",
+					title: "Show pause button",
+					type: "boolean",
+					group: "a11y",
+					initialValue: true,
+					access: { edit: "schema.manage" },
+					lockReason: "Moving video over 5 seconds must be pausable (WCAG 2.2.2)."
+				},
+				{
+					name: "autoplay",
+					title: "Play automatically",
+					type: "boolean",
+					group: "design",
+					initialValue: true
+				},
+				{
+					name: "loop",
+					title: "Loop the video",
+					type: "boolean",
+					group: "design",
+					hidden: {
+						field: "autoplay",
+						equals: true
+					},
+					initialValue: true
+				},
+				overlay,
+				{
+					name: "height",
+					title: "Height",
+					type: "select",
+					group: "design",
+					layout: "segmented",
+					initialValue: "screen",
+					options: [
+						{
+							value: "screen",
+							label: "Full screen"
+						},
+						{
+							value: "large",
+							label: "Large"
+						},
+						{
+							value: "medium",
+							label: "Medium"
+						}
+					]
+				},
+				{
+					...theme,
+					initialValue: "dark"
+				}
+			]
+		},
+		value: {
+			eyebrow: "Klamath River · 2026",
+			heading: "The dams came down. The salmon came back.",
+			body: "Four dams removed, 400 river miles reopened. Your gift keeps the Klamath running free.",
+			primaryButton: btn("Donate", "/donate", "primary"),
+			secondaryButton: btn("Watch the 4-minute film", "/stories/klamath-film", "outline", { icon: "player-play" }),
+			video: {
+				url: "https://vimeo.com/883441207",
+				poster: "https://picsum.photos/seed/owt-klamath-poster/1920/1080"
+			},
+			poster: pic("owt-klamath-poster", "Chinook salmon swimming upstream through clear water over red gravel", 1920, 1080),
+			captions: [{
+				_key: "t1",
+				language: "en",
+				label: "English (CC)",
+				file: {
+					name: "klamath-hero-en.vtt",
+					size: 2140,
+					url: "https://cdn.bettercms.site/owt/klamath-hero-en.vtt"
+				}
+			}, {
+				_key: "t2",
+				language: "es",
+				label: "Español",
+				file: {
+					name: "klamath-hero-es.vtt",
+					size: 2296,
+					url: "https://cdn.bettercms.site/owt/klamath-hero-es.vtt"
+				}
+			}],
+			textAlternative: "Salmon swim upstream past the old Iron Gate dam site, now a free-flowing river lined with new willows.",
+			transcript: {
+				type: "page",
+				href: "/stories/klamath-film/transcript",
+				title: "Klamath film transcript"
+			},
+			showPauseButton: true,
+			autoplay: true,
+			loop: true,
+			overlay: 45,
+			height: "screen",
+			theme: "dark"
+		},
+		notes: {
+			why: "Video heroes fail accessibility more than any other section, so accessibility gets its own tab instead of being buried. Caption tracks are an array (one per language: language + menu label + .vtt file) because the `video` type can't carry tracks itself. A text alternative is required — a muted background film still communicates. The pause control is locked on for marketers with the WCAG reason shown. The poster is required: it's what people with reduced motion and slow connections actually see. Autoplay/loop/overlay/height are Design; loop only appears when autoplay is on.",
+			sanity: "object `videoHero` { video: mux.video | file, poster: image (required), captions: array<object { language, label, file: file{accept:'.vtt'} }>, textAlternative: text, transcript: link } — Mux stores text tracks on the asset itself, which Sanity surfaces via the Mux plugin.",
+			htmlSignals: [
+				"<video autoplay muted loop playsinline poster=…> absolutely positioned behind the H1 (object-fit: cover)",
+				"<track kind=\"captions\" srclang=… src=….vtt> children (often missing — report it)",
+				"A pause/play <button aria-label=\"Pause video\"> overlaid in a corner",
+				"@media (prefers-reduced-motion) rule hiding the video or pausing it",
+				"A gradient/black overlay div between video and text"
+			],
+			mcp: "Background <video> behind text → `videoHero`. src (or the highest-quality <source>) → video.url; poster attribute → poster (upload as an asset; if missing, grab the first frame and report). Each <track> → captions[] { language: srclang, label, file }. If there is no <track> and the film has speech, report an a11y gap — don't invent captions. aria-label/description near the video → textAlternative; else draft one with AI and mark it for review. Overlay opacity → overlay %.",
+			pitfalls: ["A YouTube iframe can't autoplay muted reliably as a background — prefer MP4/Vimeo background mode; flag YouTube sources.", "Captions and transcript are different things: captions sync to the film, a transcript is a page. Model both."]
+		}
+	},
+	{
+		id: "hero-slider",
+		previewLayout: "carousel",
+		label: "Slider hero",
+		proves: "Slides array with per-slide schedule and art direction · autoplay settings only when autoplay is on · carousel a11y name",
+		category: "Heroes",
+		tags: [
+			"repeater",
+			"media-heavy",
+			"conditional",
+			"validation",
+			"a11y"
+		],
+		brand: "Caldera",
+		schema: {
+			name: "heroCarousel",
+			title: "Hero carousel",
+			kind: "block",
+			icon: "slideshow",
+			category: "Heroes",
+			description: "Two to five full-width slides, each with its own message and button.",
+			preview: {
+				title: "slides.0.heading",
+				subtitle: "label",
+				media: "slides.0.image"
+			},
+			groups: [
+				{
+					name: "content",
+					title: "Slides",
+					default: true
+				},
+				{
+					name: "behavior",
+					title: "Behavior"
+				},
+				{
+					name: "design",
+					title: "Design"
+				}
+			],
+			fields: [
+				{
+					name: "slides",
+					title: "Slides",
+					type: "array",
+					itemNoun: "slide",
+					validation: {
+						min: 2,
+						max: 5
+					},
+					of: [{
+						name: "slide",
+						title: "Slide",
+						type: "object",
+						icon: "photo",
+						preview: {
+							title: "heading",
+							subtitle: "eyebrow",
+							media: "image",
+							fallback: "Untitled slide"
+						},
+						fields: [
+							eyebrow,
+							{
+								name: "heading",
+								title: "Heading",
+								type: "string",
+								validation: {
+									required: true,
+									max: 80,
+									recommendedMax: 50
+								},
+								ai: true,
+								localized: true
+							},
+							{
+								name: "body",
+								title: "Body",
+								type: "text",
+								rows: 2,
+								validation: { recommendedMax: 120 },
+								localized: true
+							},
+							{
+								name: "button",
+								title: "Button",
+								type: "button",
+								validation: { required: true }
+							},
+							{
+								name: "image",
+								title: "Image",
+								type: "image",
+								validation: { required: true },
+								description: "At least 2400 × 1200."
+							},
+							{
+								name: "mobileImage",
+								title: "Phone image",
+								type: "image",
+								description: "Leave empty to reuse the main image."
+							},
+							{
+								name: "textPosition",
+								title: "Text position",
+								type: "select",
+								layout: "segmented",
+								initialValue: "left",
+								options: [
+									{
+										value: "left",
+										label: "Left"
+									},
+									{
+										value: "center",
+										label: "Center"
+									},
+									{
+										value: "right",
+										label: "Right"
+									}
+								]
+							},
+							{
+								name: "tone",
+								title: "Text color",
+								type: "select",
+								layout: "segmented",
+								initialValue: "light",
+								options: [{
+									value: "light",
+									label: "Light text"
+								}, {
+									value: "dark",
+									label: "Dark text"
+								}]
+							},
+							{
+								name: "showFrom",
+								title: "Show from",
+								type: "datetime",
+								fieldset: "Schedule"
+							},
+							{
+								name: "hideAfter",
+								title: "Hide after",
+								type: "datetime",
+								fieldset: "Schedule"
+							}
+						]
+					}]
+				},
+				{
+					name: "label",
+					title: "Carousel name",
+					type: "string",
+					validation: {
+						required: true,
+						max: 40
+					},
+					description: "Not shown. Read by screen readers."
+				},
+				{
+					name: "autoplay",
+					title: "Play automatically",
+					type: "boolean",
+					group: "behavior",
+					initialValue: true
+				},
+				{
+					name: "interval",
+					title: "Each slide shows for",
+					type: "number",
+					group: "behavior",
+					hidden: {
+						field: "autoplay",
+						equals: true
+					},
+					numeric: {
+						min: 4,
+						max: 12,
+						step: 1,
+						unit: "s"
+					},
+					initialValue: 6
+				},
+				{
+					name: "transition",
+					title: "Transition",
+					type: "select",
+					group: "design",
+					layout: "segmented",
+					initialValue: "fade",
+					options: [{
+						value: "fade",
+						label: "Fade"
+					}, {
+						value: "slide",
+						label: "Slide"
+					}]
+				},
+				{
+					name: "controls",
+					title: "Controls",
+					type: "multiselect",
+					group: "design",
+					initialValue: ["dots", "arrows"],
+					options: [
+						{
+							value: "dots",
+							label: "Dots"
+						},
+						{
+							value: "arrows",
+							label: "Arrows"
+						},
+						{
+							value: "progress",
+							label: "Progress bar"
+						}
+					]
+				},
+				{
+					name: "height",
+					title: "Height",
+					type: "select",
+					group: "design",
+					layout: "segmented",
+					initialValue: "large",
+					options: [
+						{
+							value: "screen",
+							label: "Full screen"
+						},
+						{
+							value: "large",
+							label: "Large"
+						},
+						{
+							value: "medium",
+							label: "Medium"
+						}
+					]
+				}
+			]
+		},
+		value: {
+			label: "This season at Caldera",
+			slides: [
+				{
+					_key: "s1",
+					eyebrow: "New",
+					heading: "The Cable Fold Grill folds to 2 cm.",
+					body: "A full grill grate that rides in a backpack and holds a 25 kg Dutch oven.",
+					button: btn("Shop the Fold", "/products/cable-fold", "primary", { arrow: true }),
+					image: pic("caldera-slide-fold", "Cable Fold Grill over a riverside fire at dusk", 2400, 1200),
+					mobileImage: pic("caldera-slide-fold-m", "Cable Fold Grill over coals, close crop", 1080, 1350),
+					textPosition: "left",
+					tone: "light"
+				},
+				{
+					_key: "s2",
+					eyebrow: "Black Friday",
+					heading: "25% off every Dutch oven.",
+					button: btn("Shop the sale", "/collections/sale", "primary"),
+					image: pic("caldera-slide-sale", "Three enamelled Dutch ovens in rust, sage and slate", 2400, 1200),
+					textPosition: "center",
+					tone: "dark",
+					showFrom: "2026-11-26T00:00:00-08:00[America/Los_Angeles]",
+					hideAfter: "2026-11-30T23:59:00-08:00[America/Los_Angeles]"
+				},
+				{
+					_key: "s3",
+					eyebrow: "Recipes",
+					heading: "Skillet cornbread, over coals.",
+					body: "Twenty minutes, one pan, and a crust you only get from cast iron.",
+					button: btn("Get the recipe", "/recipes/skillet-cornbread", "outline"),
+					image: pic("caldera-slide-cornbread", "Golden cornbread in a cast iron skillet on a camp table", 2400, 1200),
+					textPosition: "right",
+					tone: "light"
+				}
+			],
+			autoplay: true,
+			interval: 6,
+			transition: "fade",
+			controls: ["dots", "arrows"],
+			height: "large"
+		},
+		notes: {
+			why: "Slides are an array of objects with the same shape (each with ONE button — a slide with two CTAs is a sign it should be its own hero). Per-slide text position and text color live on the slide because they depend on that photo; section-level behavior lives in Behavior/Design. Each slide carries an optional schedule so a sale slide can appear and vanish without a republish. `interval` only shows when autoplay is on. The carousel name is required content because screen readers announce it ('Featured collections, carousel').",
+			sanity: "object `heroCarousel` { slides: array<object slide { eyebrow, heading, body, button, image, mobileImage, textPosition, tone, showFrom, hideAfter }> (min 2, max 5), label: string, autoplay: boolean, interval: number (hidden unless autoplay) }.",
+			htmlSignals: [
+				"Swiper/Splide/Slick/Flickity class names (swiper-slide, splide__slide, slick-slide) or [aria-roledescription=\"carousel\"]",
+				"2+ full-width slides, each with its own H2/H1, paragraph, button and background image",
+				"Dots (<button aria-label=\"Go to slide 2\">) and prev/next arrows",
+				"data-autoplay / autoplay: { delay: 6000 } in the init script"
+			],
+			mcp: "Carousel library markup at the top of the page → `heroCarousel`. Each non-cloned slide → slides[] (skip duplicates the library clones for looping: .swiper-slide-duplicate, .slick-cloned). Only the first slide's heading should be an H1 in the renderer. Read autoplay delay (ms → s) into interval; fade effect → transition 'fade'. Background images per slide → image; mobile <source> → mobileImage. Missing aria-label on the carousel → draft label from the slides' theme and report.",
+			pitfalls: ["Cloned slides doubling the count — dedupe by image URL + heading.", "Slide schedules that leave fewer than 2 live slides: the renderer should fall back to a static hero (min can't be enforced over time)."]
+		}
+	},
+	{
+		id: "hero-product",
+		previewLayout: "split",
+		label: "Product hero with variant picker",
+		proves: "Live commerce data through a reference · overrides that fall back to the product · Add to cart is an action label",
+		category: "Heroes",
+		tags: [
+			"references",
+			"commerce",
+			"media-heavy",
+			"conditional",
+			"repeater"
+		],
+		brand: "Caldera",
+		schema: {
+			name: "productHero",
+			title: "Product hero",
+			kind: "block",
+			icon: "shopping-bag",
+			category: "Heroes",
+			description: "One product with its gallery, options, live price and an add-to-cart button.",
+			variants: [
+				{
+					id: "gallery-left",
+					name: "Gallery left"
+				},
+				{
+					id: "gallery-right",
+					name: "Gallery right"
+				},
+				{
+					id: "stacked",
+					name: "Stacked",
+					description: "Large image on top, buy box below"
+				}
+			],
+			preview: {
+				title: "heading",
+				subtitle: "badge",
+				media: "gallery.0"
+			},
+			groups: [
+				{
+					name: "content",
+					title: "Content",
+					default: true
+				},
+				{
+					name: "buy",
+					title: "Buy box"
+				},
+				{
+					name: "media",
+					title: "Media"
+				},
+				{
+					name: "design",
+					title: "Design"
+				}
+			],
+			fields: [
+				{
+					name: "product",
+					title: "Product",
+					type: "reference",
+					reference: { to: ["shopify"] },
+					validation: { required: true }
+				},
+				{
+					name: "heading",
+					title: "Heading",
+					type: "string",
+					validation: { max: 80 },
+					ai: true,
+					description: "Leave empty to use the product name."
+				},
+				{
+					name: "tagline",
+					title: "Tagline",
+					type: "text",
+					rows: 2,
+					validation: { recommendedMax: 140 },
+					ai: true
+				},
+				{
+					name: "badge",
+					title: "Badge",
+					type: "string",
+					validation: { max: 16 },
+					placeholder: "New color"
+				},
+				{
+					name: "highlights",
+					title: "Highlights",
+					type: "array",
+					itemNoun: "highlight",
+					openMode: "inline",
+					validation: { max: 4 },
+					of: [{
+						name: "highlight",
+						title: "Highlight",
+						type: "object",
+						icon: "circle-check",
+						preview: {
+							title: "label",
+							fallback: "Untitled highlight"
+						},
+						fields: [{
+							name: "icon",
+							title: "Icon",
+							type: "icon"
+						}, {
+							name: "label",
+							title: "Label",
+							type: "string",
+							validation: {
+								required: true,
+								max: 40
+							}
+						}]
+					}]
+				},
+				{
+					name: "pickers",
+					title: "Option pickers",
+					type: "multiselect",
+					group: "buy",
+					description: "Options left out use their default.",
+					options: [
+						{
+							value: "color",
+							label: "Color"
+						},
+						{
+							value: "size",
+							label: "Size"
+						},
+						{
+							value: "finish",
+							label: "Finish"
+						}
+					]
+				},
+				{
+					name: "swatchStyle",
+					title: "Color picker",
+					type: "select",
+					group: "buy",
+					layout: "segmented",
+					initialValue: "swatch",
+					options: [{
+						value: "swatch",
+						label: "Swatches"
+					}, {
+						value: "dropdown",
+						label: "Dropdown"
+					}]
+				},
+				{
+					name: "price",
+					title: "Price",
+					type: "select",
+					group: "buy",
+					layout: "segmented",
+					initialValue: "full",
+					options: [
+						{
+							value: "full",
+							label: "Show price"
+						},
+						{
+							value: "from",
+							label: "From $…"
+						},
+						{
+							value: "hidden",
+							label: "Hide"
+						}
+					]
+				},
+				{
+					name: "showCompareAtPrice",
+					title: "Show compare-at price",
+					type: "boolean",
+					group: "buy",
+					hidden: {
+						field: "price",
+						equals: "full"
+					}
+				},
+				{
+					name: "showInstallments",
+					title: "Show pay-later line",
+					type: "boolean",
+					group: "buy",
+					hidden: {
+						field: "price",
+						equals: "full"
+					}
+				},
+				{
+					name: "addLabel",
+					title: "Add to cart label",
+					type: "string",
+					group: "buy",
+					initialValue: "Add to cart",
+					validation: {
+						required: true,
+						max: 24
+					}
+				},
+				{
+					name: "soldOutLabel",
+					title: "Sold out label",
+					type: "string",
+					group: "buy",
+					initialValue: "Notify me",
+					validation: { max: 24 }
+				},
+				{
+					name: "detailsButton",
+					title: "Details button",
+					type: "button",
+					group: "buy"
+				},
+				{
+					name: "showRating",
+					title: "Show rating",
+					type: "boolean",
+					group: "buy",
+					initialValue: true
+				},
+				{
+					name: "gallery",
+					title: "Gallery",
+					type: "array",
+					group: "media",
+					arrayLayout: "grid",
+					itemNoun: "image",
+					validation: { max: 8 },
+					description: "Leave empty to use the product's photos.",
+					of: [{
+						name: "image",
+						title: "Image",
+						type: "image"
+					}]
+				},
+				{
+					name: "video",
+					title: "Video",
+					type: "video",
+					group: "media"
+				},
+				{
+					name: "isBuyBoxSticky",
+					title: "Keep the buy box in view",
+					type: "boolean",
+					group: "design",
+					initialValue: true
+				},
+				theme
+			]
+		},
+		value: {
+			_variant: "gallery-left",
+			product: "gid://shopify/Product/8813",
+			heading: "",
+			tagline: "Enamelled cast iron that goes from coals to table. Holds heat for an hour after it leaves the fire.",
+			badge: "New colour",
+			highlights: [
+				{
+					_key: "h1",
+					icon: "flame",
+					label: "Safe to 500°F, lid knob included"
+				},
+				{
+					_key: "h2",
+					icon: "scale",
+					label: "5.5 quarts · feeds 6"
+				},
+				{
+					_key: "h3",
+					icon: "shield-check",
+					label: "Lifetime warranty"
+				}
+			],
+			pickers: ["color", "size"],
+			swatchStyle: "swatch",
+			price: "full",
+			showCompareAtPrice: true,
+			showInstallments: true,
+			addLabel: "Add to cart",
+			soldOutLabel: "Notify me",
+			detailsButton: btn("See full details", "/products/ember-dutch-oven", "link", { arrow: true }),
+			showRating: true,
+			gallery: [
+				pic("caldera-ember-rust", "Ember Dutch Oven in rust enamel, lid on", 1600, 1600),
+				pic("caldera-ember-coals", "Ember Dutch Oven sitting in campfire coals with stew bubbling", 1600, 1600),
+				pic("caldera-ember-sage", "Ember Dutch Oven in sage enamel on a wooden table", 1600, 1600)
+			],
+			isBuyBoxSticky: true,
+			theme: "light"
+		},
+		notes: {
+			why: "Everything that changes with stock and price is a REFERENCE to the commerce product — the hero stores only editorial choices: an optional headline override, tagline, badge, highlights, and HOW to present the buy box (which option pickers, price style). Override fields say 'leave empty to use the product …' because the schema can't yet declare fallback semantics. Add to cart is a string label, not a `button`: it performs an action, it doesn't navigate. The gallery is optional and only overrides the store photos when set.",
+			sanity: "object `productHero` { product: reference<product> (Sanity Connect for Shopify syncs product docs), headline: string, tagline, badge, highlights: array<object>, pickers: array<string>, price: string, compareAt: boolean, addLabel: string, gallery: array<image> } — Sanity also can't infer the picker list from the referenced product.",
+			htmlSignals: [
+				"A product form: <form action=\"/cart/add\"> with <select name=\"id\"> or radio swatches and a submit button",
+				"Price markup with a <s>/<del> compare-at price and currency symbol; Klarna/Afterpay/Shop Pay installment widgets",
+				"Product JSON (<script type=\"application/json\" data-product-json> or ShopifyAnalytics.meta.product)",
+				"A thumbnail strip + main image (gallery) beside the buy box",
+				"JSON-LD @type Product with offers (native — derived from the reference)"
+			],
+			mcp: "Product form at the top of a landing/product page → `productHero`. Resolve the product by its handle/id from the product JSON → product reference. NEVER copy price, compare-at, SKU, stock or option values into fields. If the visible H1 differs from the product title → heading override; else leave empty. Option groups shown as pickers → pickers (by option name: Color/Color → color). Submit button text → addLabel. Gallery images that equal the store's product media → leave gallery empty.",
+			pitfalls: ["Hard-coding the price in the tagline ('Just $165!') — it goes stale; flag any currency in copy.", "Picker options are a fixed list here; a product with a 'Handle wrap' option can't be picked until options come from the reference (gap)."]
+		}
+	},
+	{
+		id: "hero-search",
+		previewLayout: "centered",
+		label: "Search hero",
+		proves: "Search box config · manual vs automatic suggestions · topic chips as references · scope and results page",
+		category: "Heroes",
+		tags: [
+			"references",
+			"conditional",
+			"dynamic-query",
+			"media-heavy"
+		],
+		brand: "Caldera",
+		schema: {
+			name: "searchHero",
+			title: "Search hero",
+			kind: "block",
+			icon: "input-search",
+			category: "Heroes",
+			description: "A headline with a big search box, suggested searches and topic chips.",
+			preview: {
+				title: "heading",
+				subtitle: "placeholder",
+				media: "backgroundImage"
+			},
+			groups: [
+				{
+					name: "content",
+					title: "Content",
+					default: true
+				},
+				{
+					name: "search",
+					title: "Search"
+				},
+				{
+					name: "media",
+					title: "Media"
+				},
+				{
+					name: "design",
+					title: "Design"
+				}
+			],
+			fields: [
+				eyebrow,
+				heading(48),
+				{
+					name: "subheading",
+					title: "Subheading",
+					type: "text",
+					rows: 2,
+					validation: { recommendedMax: 120 },
+					localized: true
+				},
+				{
+					name: "placeholder",
+					title: "Placeholder",
+					type: "string",
+					group: "search",
+					validation: {
+						required: true,
+						max: 60
+					},
+					localized: true,
+					placeholder: "Try dutch oven bread"
+				},
+				{
+					name: "buttonLabel",
+					title: "Search button label",
+					type: "string",
+					group: "search",
+					initialValue: "Search",
+					validation: { max: 16 },
+					description: "Read by screen readers when the button shows only an icon."
+				},
+				{
+					name: "scope",
+					title: "Searches",
+					type: "select",
+					group: "search",
+					layout: "radio",
+					initialValue: "recipes",
+					options: [
+						{
+							value: "recipes",
+							label: "Recipes"
+						},
+						{
+							value: "journal",
+							label: "Journal stories"
+						},
+						{
+							value: "products",
+							label: "Products"
+						},
+						{
+							value: "all",
+							label: "The whole site"
+						}
+					]
+				},
+				{
+					name: "suggestionSource",
+					title: "Suggested searches",
+					type: "select",
+					group: "search",
+					layout: "segmented",
+					initialValue: "manual",
+					options: [
+						{
+							value: "manual",
+							label: "Written here"
+						},
+						{
+							value: "popular",
+							label: "Most searched"
+						},
+						{
+							value: "none",
+							label: "None"
+						}
+					]
+				},
+				{
+					name: "suggestions",
+					title: "Suggestions",
+					type: "array",
+					itemNoun: "suggestion",
+					of: [{
+						name: "suggestion",
+						title: "Suggestion",
+						type: "string"
+					}],
+					group: "search",
+					hidden: {
+						field: "suggestionSource",
+						equals: "manual"
+					},
+					validation: { max: 6 }
+				},
+				{
+					name: "popularDays",
+					title: "Count searches from the last",
+					type: "number",
+					group: "search",
+					hidden: {
+						field: "suggestionSource",
+						equals: "popular"
+					},
+					numeric: {
+						min: 7,
+						max: 90,
+						step: 1,
+						unit: "days"
+					},
+					initialValue: 30
+				},
+				{
+					name: "topics",
+					title: "Topic chips",
+					type: "array",
+					itemNoun: "topic",
+					validation: { max: 6 },
+					of: [{
+						name: "topic",
+						title: "Topic",
+						type: "reference",
+						reference: { to: ["col_topics"] }
+					}]
+				},
+				{
+					name: "backgroundImage",
+					title: "Background image",
+					type: "image",
+					group: "media"
+				},
+				overlay,
+				{
+					...align,
+					initialValue: "center"
+				},
+				theme
+			]
+		},
+		value: {
+			eyebrow: "400+ tested recipes",
+			heading: "What are you cooking tonight?",
+			subheading: "Every recipe is tested over coals and on a stovetop, with notes for both.",
+			placeholder: "Try “dutch oven bread”",
+			buttonLabel: "Search",
+			scope: "recipes",
+			suggestionSource: "manual",
+			suggestions: [
+				"dutch oven bread",
+				"skillet cornbread",
+				"one-pot chili",
+				"campfire breakfast"
+			],
+			popularDays: 30,
+			topics: [
+				"tp_camp",
+				"tp_recipes",
+				"tp_cast-iron",
+				"tp_care"
+			],
+			backgroundImage: pic("caldera-recipes-hero", "Overhead view of a camp table with chili, cornbread and a cast iron pan", 2400, 1200),
+			overlay: 50,
+			alignment: "center",
+			theme: "dark"
+		},
+		notes: {
+			why: "The search box itself is behavior, so the block stores its CONFIG: what it searches (scope), what it says (placeholder, an accessible button label) and where suggestions come from. `suggestionSource` switches between hand-written tags and a dynamic 'most searched' query (with its window), so a converter can mark a site's trending list as dynamic instead of freezing it. Topic chips are references to the Topics collection, so a renamed topic updates here. Results render on the site's search page — no results UI is modelled.",
+			sanity: "object `searchHero` { heading, placeholder, scope: string, suggestionSource: string, suggestions: array<string>, topics: array<reference<topic>>, image } — the 'popular' mode would be a GROQ/Algolia query in the frontend, not data.",
+			htmlSignals: [
+				"A hero whose main control is <form role=\"search\"> / <input type=\"search\"> with a large placeholder",
+				"Links below the input like /search?q=… ('Popular: …') — suggestions",
+				"Pill links to /topics/*, /tags/* or /category/* — topic chips",
+				"Form action pointing to /search, /recipes or an Algolia/Typesense endpoint (scope)"
+			],
+			mcp: "Hero containing a search form → `searchHero`. placeholder attribute → placeholder; the form action path → scope (/recipes → 'recipes', /search → 'all'). Links with ?q= → suggestions (the q values, decoded) and suggestionSource 'manual'; if they change between two crawls a day apart → 'popular'. Pills linking to taxonomy pages → topics, resolved to Topics entries by slug (create missing ones and report).",
+			pitfalls: ["Don't model the autocomplete dropdown's results — they come from the search index."]
+		}
+	},
+	{
+		id: "hero-lead-form",
+		previewLayout: "form",
+		label: "Lead-form hero",
+		proves: "A form REFERENCE plus per-placement settings: hidden source fields, label override, message vs redirect",
+		category: "Heroes",
+		tags: [
+			"form",
+			"references",
+			"conditional",
+			"validation",
+			"repeater"
+		],
+		brand: "Northbound Studio",
+		schema: {
+			name: "leadFormHero",
+			title: "Lead form hero",
+			kind: "block",
+			icon: "clipboard-text",
+			category: "Heroes",
+			description: "A pitch on one side and a short form on the other.",
+			variants: [
+				{
+					id: "form-right",
+					name: "Form right"
+				},
+				{
+					id: "form-left",
+					name: "Form left"
+				},
+				{
+					id: "form-below",
+					name: "Form below",
+					description: "Centered pitch with the form underneath"
+				}
+			],
+			preview: {
+				title: "heading",
+				subtitle: "formHeading",
+				media: "image"
+			},
+			groups: [
+				{
+					name: "content",
+					title: "Pitch",
+					default: true
+				},
+				{
+					name: "form",
+					title: "Form"
+				},
+				{
+					name: "design",
+					title: "Design"
+				}
+			],
+			fields: [
+				eyebrow,
+				heading(64),
+				body(200),
+				{
+					name: "points",
+					title: "What they get",
+					type: "array",
+					itemNoun: "point",
+					validation: { max: 4 },
+					of: [{
+						name: "point",
+						title: "Point",
+						type: "string",
+						validation: { max: 60 }
+					}]
+				},
+				{
+					name: "trustLine",
+					title: "Trust line",
+					type: "string",
+					validation: { max: 90 }
+				},
+				{
+					name: "image",
+					title: "Image",
+					type: "image"
+				},
+				{
+					name: "form",
+					title: "Form",
+					type: "reference",
+					group: "form",
+					reference: { to: ["form"] },
+					validation: { required: true }
+				},
+				{
+					name: "formHeading",
+					title: "Form heading",
+					type: "string",
+					group: "form",
+					validation: { max: 48 }
+				},
+				{
+					name: "submitLabel",
+					title: "Submit label",
+					type: "string",
+					group: "form",
+					validation: { max: 24 },
+					description: "Leave empty to use the label set on the form."
+				},
+				{
+					name: "afterSubmit",
+					title: "After sending",
+					type: "select",
+					group: "form",
+					layout: "radio",
+					initialValue: "message",
+					options: [{
+						value: "message",
+						label: "Show a message",
+						description: "The form is replaced by your thank-you note"
+					}, {
+						value: "redirect",
+						label: "Go to a page",
+						description: "Best when you track conversions on a thank-you page"
+					}]
+				},
+				{
+					name: "successMessage",
+					title: "Thank-you message",
+					type: "text",
+					group: "form",
+					rows: 2,
+					hidden: {
+						field: "afterSubmit",
+						equals: "message"
+					},
+					validation: {
+						required: true,
+						max: 240
+					}
+				},
+				{
+					name: "redirect",
+					title: "Thank-you page",
+					type: "link",
+					group: "form",
+					hidden: {
+						field: "afterSubmit",
+						equals: "redirect"
+					},
+					validation: { required: true }
+				},
+				{
+					name: "hiddenFields",
+					title: "Hidden values",
+					type: "array",
+					group: "form",
+					itemNoun: "value",
+					validation: { max: 6 },
+					description: "Not shown. Sent with every submission from this section.",
+					of: [{
+						name: "hiddenField",
+						title: "Hidden value",
+						type: "object",
+						icon: "eye-off",
+						openMode: "inline",
+						preview: {
+							title: "key",
+							subtitle: "value",
+							fallback: "Untitled value"
+						},
+						fields: [{
+							name: "key",
+							title: "Key",
+							type: "string",
+							validation: {
+								required: true,
+								unique: true,
+								pattern: "^[a-z][a-z0-9_]*$",
+								patternMessage: "Use lowercase letters, numbers and underscores, like page_view."
+							},
+							placeholder: "source"
+						}, {
+							name: "value",
+							title: "Value",
+							type: "string",
+							validation: {
+								required: true,
+								max: 80
+							},
+							placeholder: "homepage-hero"
+						}]
+					}]
+				},
+				{
+					name: "privacyNote",
+					title: "Privacy note",
+					type: "string",
+					group: "form",
+					validation: { max: 120 }
+				},
+				theme
+			]
+		},
+		value: {
+			_variant: "form-right",
+			eyebrow: "Brand & web for outdoor companies",
+			heading: "Your next site should sell as hard as your product works.",
+			body: "We design and build brand-led commerce sites for outdoor and food companies — strategy, identity and a CMS your team actually enjoys.",
+			points: [
+				"A 30-minute call with a founder, not a salesperson",
+				"A written plan within three working days",
+				"Fixed quotes, no hourly surprises"
+			],
+			trustLine: "Trusted by teams at Caldera, Tideline and Open Water Trust.",
+			image: pic("northbound-studio-desk", "Two designers reviewing printed brand boards on a studio wall", 1600, 1200),
+			form: "form_contact",
+			formHeading: "Book a strategy call",
+			submitLabel: "Request a call",
+			afterSubmit: "redirect",
+			successMessage: "Thanks — we'll reply within one working day with a few times to talk.",
+			redirect: {
+				type: "page",
+				href: "/thanks",
+				title: "Thanks"
+			},
+			hiddenFields: [{
+				_key: "k1",
+				key: "source",
+				value: "homepage-hero"
+			}, {
+				_key: "k2",
+				key: "service",
+				value: "brand-and-web"
+			}],
+			privacyNote: "We'll only use your details to reply. No newsletters unless you ask.",
+			theme: "light"
+		},
+		notes: {
+			why: "The form is a separate form in Forms referenced by the hero — its inputs, validation, spam protection and where submissions go belong to Forms and are reused across the site. What's specific to THIS placement stays here: a heading, a submit-label override, what happens after sending (message vs redirect, with the right field shown for each) and hidden values that tag where leads came from. Modelling the inputs as hero fields would fork the form every time it's placed.",
+			sanity: "object `leadFormHero` { heading, body, points: array<string>, form: reference<form> (or an external Hubspot/Formspark id string), submitLabel, afterSubmit: string, successMessage: text (hidden unless message), redirect: link, hiddenFields: array<object { key, value }> }.",
+			htmlSignals: [
+				"A hero section that contains a <form> with 3–6 inputs (name, email, company, message) beside or below the pitch copy",
+				"<input type=\"hidden\" name=\"source\" value=\"…\"> or utm_* hidden inputs",
+				"HubSpot/Typeform/Formspark embeds (hbspt.forms.create, data-tf-widget) — a third-party form",
+				"A small privacy sentence under the submit button"
+			],
+			mcp: "Hero + <form> → `leadFormHero`. Create (or match by its input set) a BetterCMS form from the inputs — labels, types, required — and set `form` to its id. Hidden inputs with static values → hiddenFields (skip ones filled by script, e.g. utm_* read from the URL — those are automatic). Submit text → submitLabel only if it differs from the form's default. A JS redirect after submit or form action to /thanks → afterSubmit 'redirect'. For HubSpot/Typeform embeds, report the provider and form id instead of recreating it.",
+			pitfalls: ["Copying inputs into the hero's schema — the form then can't be reused or receive submissions properly.", "Hidden values that contain personal data (an email from the URL) must not be stored in content."]
+		}
+	},
+	{
+		id: "hero-app-download",
+		previewLayout: "split",
+		label: "App download hero",
+		proves: "A field synced from a global (store links) inside a normal block · QR code derived from a link · device screens",
+		category: "Heroes",
+		tags: [
+			"media-heavy",
+			"conditional",
+			"validation",
+			"global-synced",
+			"repeater"
+		],
+		brand: "Hearth & Ash",
+		schema: {
+			name: "appDownloadHero",
+			title: "App download hero",
+			kind: "block",
+			icon: "device-mobile",
+			category: "Heroes",
+			description: "Pitch the app with store badges, a QR code for desktop visitors and phone screenshots.",
+			preview: {
+				title: "heading",
+				subtitle: "eyebrow",
+				media: "screens.0"
+			},
+			groups: GROUPS,
+			fields: [
+				eyebrow,
+				heading(56),
+				body(160),
+				{
+					name: "badges",
+					title: "Store links",
+					type: "array",
+					itemNoun: "store",
+					synced: { from: "App links" },
+					validation: {
+						min: 1,
+						max: 2
+					},
+					description: "Shared: changes apply to every badge on the site.",
+					of: [{
+						name: "storeLink",
+						title: "Store",
+						type: "object",
+						icon: "device-mobile",
+						openMode: "inline",
+						preview: {
+							title: "store",
+							subtitle: "url"
+						},
+						fields: [{
+							name: "store",
+							title: "Store",
+							type: "select",
+							validation: {
+								required: true,
+								unique: true
+							},
+							options: [{
+								value: "app-store",
+								label: "App Store"
+							}, {
+								value: "google-play",
+								label: "Google Play"
+							}]
+						}, {
+							name: "url",
+							title: "Store address",
+							type: "url",
+							validation: {
+								required: true,
+								pattern: "^https://(apps\\.apple\\.com|play\\.google\\.com)/",
+								patternMessage: "Use an apps.apple.com or play.google.com address, like https://apps.apple.com/app/id123."
+							}
+						}]
+					}]
+				},
+				{
+					name: "qr",
+					title: "QR code",
+					type: "object",
+					icon: "qrcode",
+					openMode: "drill",
+					fields: [
+						{
+							name: "showQrCode",
+							title: "Show a QR code",
+							type: "boolean",
+							initialValue: true,
+							description: "Desktop only. Phones see the badges."
+						},
+						{
+							name: "target",
+							title: "QR opens",
+							type: "url",
+							hidden: {
+								field: "showQrCode",
+								equals: true
+							},
+							validation: { required: true },
+							description: "One link that sends iPhones and Androids to the right store."
+						},
+						{
+							name: "caption",
+							title: "Caption",
+							type: "string",
+							hidden: {
+								field: "showQrCode",
+								equals: true
+							},
+							validation: { max: 32 },
+							placeholder: "Scan to download"
+						}
+					]
+				},
+				{
+					name: "rating",
+					title: "Store rating",
+					type: "object",
+					icon: "star",
+					fields: [{
+						name: "value",
+						title: "Rating",
+						type: "number",
+						numeric: {
+							min: 0,
+							max: 5,
+							step: .1
+						}
+					}, {
+						name: "label",
+						title: "Label",
+						type: "string",
+						validation: { max: 32 },
+						placeholder: "12,400 ratings"
+					}]
+				},
+				{
+					name: "screens",
+					title: "Screenshots",
+					type: "array",
+					group: "media",
+					arrayLayout: "grid",
+					itemNoun: "screenshot",
+					validation: {
+						min: 1,
+						max: 3
+					},
+					description: "Phone screens at 1170 × 2532.",
+					of: [{
+						name: "screen",
+						title: "Screenshot",
+						type: "image"
+					}]
+				},
+				{
+					name: "device",
+					title: "Device frame",
+					type: "select",
+					group: "design",
+					layout: "segmented",
+					initialValue: "iphone",
+					options: [
+						{
+							value: "iphone",
+							label: "iPhone"
+						},
+						{
+							value: "android",
+							label: "Android"
+						},
+						{
+							value: "none",
+							label: "No frame"
+						}
+					]
+				},
+				{
+					name: "background",
+					title: "Background color",
+					type: "color",
+					group: "design"
+				},
+				theme
+			]
+		},
+		value: {
+			eyebrow: "The Hearth & Ash app",
+			heading: "Skip the line. Your table is waiting.",
+			body: "Book in two taps, order from the bar while you wait, and pay at the table without hunting down the check.",
+			badges: [{
+				_key: "b1",
+				store: "app-store",
+				url: "https://apps.apple.com/us/app/hearth-ash/id6450012345"
+			}, {
+				_key: "b2",
+				store: "google-play",
+				url: "https://play.google.com/store/apps/details?id=com.hearthandash.order"
+			}],
+			qr: {
+				showQrCode: true,
+				target: "https://hearthandash.com/app",
+				caption: "Scan to download"
+			},
+			rating: {
+				value: 4.8,
+				label: "2,140 ratings"
+			},
+			screens: [pic("hearth-app-book", "App screen: choose a time for a table for four at Pearl District", 1170, 2532), pic("hearth-app-order", "App screen: ordering two cocktails from the bar menu", 1170, 2532)],
+			device: "iphone",
+			background: "#2A1A14",
+			theme: "dark"
+		},
+		notes: {
+			why: "Store links appear in the hero, the footer and emails, so the badges field is SYNCED from an 'App links' global (field-level `synced`) — one App Store URL change updates every badge, while the rest of the hero stays local. The QR code is DERIVED from a URL (we store the target, never an uploaded QR image that can't be updated); its fields only show when it's on. Badges are a select + URL with a pattern because the renderer draws the official artwork. Screenshots are a small image array; the device frame and background are Design.",
+			sanity: "object `appHero` { badges: reference<appLinks> (a singleton), qr: object { show, target: url, caption }, rating: object { value, label }, screens: array<image>, device: string }. Sanity has no field-level sync; it's a reference to a singleton.",
+			htmlSignals: [
+				"Official App Store / Google Play badge images linking to apps.apple.com and play.google.com",
+				"A QR code <img>/<svg>/<canvas> near the badges, often desktop-only",
+				"Phone mockup frames (rounded rect with notch) around screenshots, sometimes overlapping",
+				"Smart-banner or apple-itunes-app meta tag in <head> (an app exists)"
+			],
+			mcp: "Hero with store badges → `appDownloadHero`. Badge hrefs → badges[] { store by hostname, url }; also create/update the 'App links' global with them. A QR image: decode it if possible and set qr.target to the decoded URL (never store the QR image); else ask. Screenshots inside device frames → screens (crop to the screen area if the frame is baked into the image, and report). Star rating text → rating.",
+			pitfalls: ["Uploading badge or QR images — they can't be updated and the QR silently breaks when the link changes.", "Ratings copied from the store go stale; the help text says so because there's no live source."]
+		}
+	},
+	{
+		id: "hero-stats",
+		previewLayout: "stats",
+		label: "Stats hero",
+		proves: "Numbers stored as numbers with prefix/suffix (count-up safe) · footnoted sources · an 'as of' date",
+		category: "Heroes",
+		tags: [
+			"repeater",
+			"validation",
+			"variants",
+			"media-heavy"
+		],
+		brand: "Open Water Trust",
+		schema: {
+			name: "statsHero",
+			title: "Stats hero",
+			kind: "block",
+			icon: "chart-arrows",
+			category: "Heroes",
+			description: "A headline backed by a row of two to four numbers.",
+			variants: [{
+				id: "below",
+				name: "Stats below",
+				description: "A row of numbers under the buttons"
+			}, {
+				id: "side",
+				name: "Stats beside",
+				description: "Copy left, a stacked column of numbers right"
+			}],
+			preview: {
+				title: "heading",
+				subtitle: "eyebrow",
+				media: "image"
+			},
+			groups: GROUPS,
+			fields: [
+				eyebrow,
+				heading(64),
+				body(180),
+				primary,
+				secondary,
+				{
+					name: "stats",
+					title: "Stats",
+					type: "array",
+					itemNoun: "stat",
+					validation: {
+						min: 2,
+						max: 4
+					},
+					of: [{
+						name: "stat",
+						title: "Stat",
+						type: "object",
+						icon: "chart-bar",
+						preview: {
+							title: "label",
+							subtitle: "value",
+							fallback: "Untitled stat"
+						},
+						fields: [
+							{
+								name: "prefix",
+								title: "Before",
+								type: "string",
+								fieldset: "Number",
+								validation: { max: 3 },
+								placeholder: "$"
+							},
+							{
+								name: "value",
+								title: "Number",
+								type: "number",
+								fieldset: "Number",
+								validation: { required: true },
+								numeric: {
+									min: 0,
+									step: .1
+								}
+							},
+							{
+								name: "suffix",
+								title: "After",
+								type: "string",
+								fieldset: "Number",
+								validation: { max: 6 },
+								placeholder: "M, %, +"
+							},
+							{
+								name: "decimals",
+								title: "Decimals",
+								type: "number",
+								fieldset: "Number",
+								numeric: {
+									min: 0,
+									max: 2,
+									step: 1
+								},
+								initialValue: 0
+							},
+							{
+								name: "label",
+								title: "Label",
+								type: "string",
+								validation: {
+									required: true,
+									max: 40
+								},
+								placeholder: "river miles reopened"
+							},
+							{
+								name: "source",
+								title: "Source",
+								type: "string",
+								validation: { max: 120 }
+							}
+						]
+					}]
+				},
+				{
+					name: "asOf",
+					title: "Figures as of",
+					type: "date"
+				},
+				{
+					name: "image",
+					title: "Image",
+					type: "image",
+					group: "media"
+				},
+				{
+					name: "useCountUp",
+					title: "Count up on scroll",
+					type: "boolean",
+					group: "design",
+					initialValue: true
+				},
+				theme,
+				spacing
+			]
+		},
+		value: {
+			_variant: "below",
+			eyebrow: "2025 impact",
+			heading: "Rivers recover fast when we get out of their way.",
+			body: "Since 2009 we've removed dams, replanted banks and bought back water rights so rivers can run the way they used to.",
+			primaryButton: btn("Give monthly", "/donate?frequency=monthly", "primary"),
+			secondaryButton: btn("Read the 2025 report", "https://cdn.bettercms.site/owt/impact-report-2025.pdf", "outline", {
+				type: "file",
+				newTab: true
+			}),
+			stats: [
+				{
+					_key: "s1",
+					value: 1240,
+					suffix: "",
+					decimals: 0,
+					label: "river miles reopened",
+					source: "OWT field surveys, 2009–2025"
+				},
+				{
+					_key: "s2",
+					value: 38,
+					decimals: 0,
+					label: "dams removed"
+				},
+				{
+					_key: "s3",
+					prefix: "$",
+					value: 4.2,
+					suffix: "M",
+					decimals: 1,
+					label: "raised from 31,000 donors",
+					source: "Audited accounts, FY2025"
+				},
+				{
+					_key: "s4",
+					value: 96,
+					suffix: "%",
+					decimals: 0,
+					label: "of returning salmon runs monitored"
+				}
+			],
+			asOf: "2026-03-31",
+			image: pic("owt-river-restored", "A braided river winding through a green valley where a reservoir used to be", 2400, 1400),
+			useCountUp: true,
+			theme: "light",
+			spacing: "spacious"
+		},
+		notes: {
+			why: "Each stat stores the NUMBER as a number with separate prefix/suffix/decimals, not '$4.2M' as text — the renderer can count up, format per locale (4,2 M in German) and a validator can check it. Labels are short and required. `source` per stat plus an `asOf` date make claims auditable, which nonprofits and regulated industries need. Two layouts are variants; count-up is Design. The shared Stat block in the core library uses a string value — this entry exists to show when the number must stay a number.",
+			sanity: "object `statsHero` { stats: array<object { prefix: string, value: number, suffix: string, decimals: number, label: string, source: string }> (min 2, max 4), asOf: date }.",
+			htmlSignals: [
+				"Large numerals (font-size ≥ 40px) in a row of 2–4 items, each with a short caption under it",
+				"data-count / data-target attributes or a countUp.js/odometer script",
+				"Footnote markers (¹ ² or *) next to numbers with sources at the bottom",
+				"Text like 'as of March 2026' or 'FY2025' near the row"
+			],
+			mcp: "Hero + 2–4 big numerals → `statsHero`. Parse each numeral: leading non-digits → prefix, trailing letters/% /+ → suffix, the number → value (use data-target when present — the visible text may be mid-animation, e.g. '0'), decimals from the fraction part. Caption → label. Footnotes → source on the matching stat. A date near the row → asOf (ISO).",
+			pitfalls: ["Reading '0' from a count-up that hasn't run — always prefer data-target/data-count.", "'1.2k' style abbreviations: store 1.2 with suffix 'k', not 1200, so the copy stays as written."]
+		}
+	},
+	{
+		id: "hero-logo-wall",
+		previewLayout: "logos",
+		label: "Hero with logo wall",
+		proves: "Logos as a grid array with the company name as the accessible text · monochrome treatment and marquee as design",
+		category: "Heroes",
+		tags: [
+			"repeater",
+			"media-heavy",
+			"a11y",
+			"conditional",
+			"variants"
+		],
+		brand: "Tideline",
+		schema: {
+			name: "logoWallHero",
+			title: "Logo wall hero",
+			kind: "block",
+			icon: "badges",
+			category: "Heroes",
+			description: "A headline with a strip of customer logos under it.",
+			variants: [{
+				id: "strip",
+				name: "Single strip"
+			}, {
+				id: "grid",
+				name: "Grid",
+				description: "Two or three rows of logos"
+			}],
+			preview: {
+				title: "heading",
+				subtitle: "logosLabel"
+			},
+			groups: GROUPS,
+			fields: [
+				heading(56),
+				{
+					name: "subheading",
+					title: "Subheading",
+					type: "text",
+					rows: 2,
+					validation: { recommendedMax: 160 },
+					ai: true,
+					localized: true
+				},
+				primary,
+				secondary,
+				{
+					name: "logosLabel",
+					title: "Logo row label",
+					type: "string",
+					validation: { max: 60 },
+					placeholder: "Trusted by 4,000 engineering teams"
+				},
+				{
+					name: "logos",
+					title: "Logos",
+					type: "array",
+					group: "media",
+					itemNoun: "logo",
+					arrayLayout: "grid",
+					validation: {
+						min: 4,
+						max: 18
+					},
+					of: [{
+						name: "customerLogo",
+						title: "Logo",
+						type: "object",
+						icon: "building",
+						preview: {
+							title: "name",
+							media: "logo",
+							fallback: "Untitled logo"
+						},
+						fields: [
+							{
+								name: "name",
+								title: "Company",
+								type: "string",
+								validation: {
+									required: true,
+									max: 40
+								},
+								description: "Not shown. Read by screen readers in place of the logo."
+							},
+							{
+								name: "logo",
+								title: "Logo",
+								type: "image",
+								validation: { required: true },
+								description: ""
+							},
+							{
+								name: "link",
+								title: "Case study",
+								type: "link"
+							}
+						]
+					}]
+				},
+				{
+					name: "treatment",
+					title: "Logo color",
+					type: "select",
+					group: "design",
+					layout: "segmented",
+					initialValue: "mono",
+					options: [{
+						value: "mono",
+						label: "One color"
+					}, {
+						value: "original",
+						label: "Original"
+					}]
+				},
+				{
+					name: "motion",
+					title: "Motion",
+					type: "select",
+					group: "design",
+					layout: "segmented",
+					initialValue: "static",
+					options: [{
+						value: "static",
+						label: "Still"
+					}, {
+						value: "marquee",
+						label: "Scrolling"
+					}]
+				},
+				{
+					name: "speed",
+					title: "Scroll speed",
+					type: "number",
+					group: "design",
+					layout: "slider",
+					hidden: {
+						field: "motion",
+						equals: "marquee"
+					},
+					numeric: {
+						min: 10,
+						max: 60,
+						step: 5,
+						unit: "s per loop"
+					},
+					initialValue: 30
+				},
+				{
+					...theme,
+					initialValue: "dark"
+				}
+			]
+		},
+		value: {
+			_variant: "strip",
+			heading: "Observability your on-call rotation will thank you for.",
+			subheading: "Traces, logs and deploys in one timeline, with alerts that say what broke — not just that something did.",
+			primaryButton: btn("Start free", "https://app.tideline.dev/signup", "primary"),
+			secondaryButton: btn("See pricing", "/pricing", "link", { arrow: true }),
+			logosLabel: "Trusted by 4,000 engineering teams",
+			logos: [
+				{
+					_key: "l1",
+					name: "Caldera",
+					logo: pic("logo-caldera", "Caldera", 320, 120),
+					link: {
+						type: "page",
+						href: "/customers/caldera",
+						title: "Caldera case study"
+					}
+				},
+				{
+					_key: "l2",
+					name: "Hearth & Ash",
+					logo: pic("logo-hearth", "Hearth & Ash", 320, 120)
+				},
+				{
+					_key: "l3",
+					name: "Open Water Trust",
+					logo: pic("logo-owt", "Open Water Trust", 320, 120)
+				},
+				{
+					_key: "l4",
+					name: "Northbound Studio",
+					logo: pic("logo-northbound", "Northbound Studio", 320, 120)
+				},
+				{
+					_key: "l5",
+					name: "Ferrous Labs",
+					logo: pic("logo-ferrous", "Ferrous Labs", 320, 120)
+				},
+				{
+					_key: "l6",
+					name: "Kestrel Freight",
+					logo: pic("logo-kestrel", "Kestrel Freight", 320, 120),
+					link: {
+						type: "page",
+						href: "/customers/kestrel",
+						title: "Kestrel Freight case study"
+					}
+				}
+			],
+			treatment: "mono",
+			motion: "marquee",
+			speed: 30,
+			theme: "dark"
+		},
+		notes: {
+			why: "Each logo is an object whose REQUIRED `name` is the accessible text; the image's alt help line is turned off (description: '') and the name is copied into alt, so authors aren't asked twice. That's the a11y rule converters most often break: logos with alt='logo'. Logos are an array in a grid layout so they read as tiles. One-color treatment and the marquee are Design — the same content can be still or scrolling. Speed only appears for the marquee. At scale (the same logos on pricing, about and case studies) this array should become references to a Customers collection.",
+			sanity: "object `logoHero` { logos: array<object { name: string, logo: image, link }> or array<reference<customer>> }, treatment: string, motion: string, speed: number (hidden unless marquee).",
+			htmlSignals: [
+				"A row/grid of 4–18 small <img>/<svg> elements with similar heights and grayscale filters (filter: grayscale(1) / opacity)",
+				"A small label above them ('Trusted by…', 'Used by teams at…')",
+				"A duplicated track with @keyframes translateX — the marquee (logos appear twice in the DOM)",
+				"Alt texts like 'logo', 'client-1' (weak) or company names (good)"
+			],
+			mcp: "Hero + a strip of logos → `logoWallHero`. Dedupe logos duplicated for the marquee (same src) and set motion 'marquee'. For each logo: name = alt if it's a real name, else the file name or <title> cleaned up, else ask — never 'logo'. grayscale filter or single-fill SVGs → treatment 'mono'. If the same set appears on 3+ pages, create a Customers collection and switch to references (report it).",
+			pitfalls: ["Alt text 'logo' x12 — screen readers hear nothing useful. Name is required for that reason.", "Marquee without a pause control is a WCAG 2.2.2 problem; the renderer pauses on hover/focus and reduced motion."]
+		}
+	},
+	{
+		id: "hero-split-testimonial",
+		previewLayout: "split",
+		label: "Split hero with testimonial card",
+		proves: "Pick from the Testimonials collection OR write one here — a conditional reference/inline pair inside an object",
+		category: "Heroes",
+		tags: [
+			"references",
+			"conditional",
+			"variants",
+			"media-heavy"
+		],
+		brand: "Caldera",
+		schema: {
+			name: "testimonialHero",
+			title: "Testimonial hero",
+			kind: "block",
+			icon: "message-circle-2",
+			category: "Heroes",
+			description: "Copy and buttons beside a photo, with a customer quote card overlapping it.",
+			variants: [{
+				id: "overlap",
+				name: "Card over photo"
+			}, {
+				id: "under-copy",
+				name: "Card under the copy"
+			}],
+			preview: {
+				title: "heading",
+				subtitle: "eyebrow",
+				media: "image"
+			},
+			groups: GROUPS,
+			fields: [
+				eyebrow,
+				heading(),
+				body(),
+				primary,
+				secondary,
+				{
+					name: "testimonial",
+					title: "Testimonial",
+					type: "object",
+					icon: "quote",
+					openMode: "drill",
+					fields: [
+						{
+							name: "source",
+							title: "Quote from",
+							type: "select",
+							layout: "segmented",
+							initialValue: "collection",
+							options: [{
+								value: "collection",
+								label: "Testimonials"
+							}, {
+								value: "custom",
+								label: "Write one here"
+							}]
+						},
+						{
+							name: "entry",
+							title: "Testimonial",
+							type: "reference",
+							reference: { to: ["col_testimonials"] },
+							hidden: {
+								field: "source",
+								equals: "collection"
+							},
+							validation: { required: true }
+						},
+						{
+							name: "quote",
+							title: "Quote",
+							type: "text",
+							rows: 3,
+							hidden: {
+								field: "source",
+								equals: "custom"
+							},
+							validation: {
+								required: true,
+								recommendedMax: 160
+							}
+						},
+						{
+							name: "name",
+							title: "Name",
+							type: "string",
+							hidden: {
+								field: "source",
+								equals: "custom"
+							},
+							validation: {
+								required: true,
+								max: 40
+							}
+						},
+						{
+							name: "role",
+							title: "Role",
+							type: "string",
+							hidden: {
+								field: "source",
+								equals: "custom"
+							},
+							validation: { max: 60 },
+							placeholder: "Backcountry guide, Montana"
+						},
+						{
+							name: "photo",
+							title: "Photo",
+							type: "image",
+							hidden: {
+								field: "source",
+								equals: "custom"
+							}
+						},
+						{
+							name: "rating",
+							title: "Rating",
+							type: "rating",
+							hidden: {
+								field: "source",
+								equals: "custom"
+							}
+						}
+					]
+				},
+				{
+					name: "image",
+					title: "Image",
+					type: "image",
+					group: "media",
+					validation: { required: true }
+				},
+				theme
+			]
+		},
+		value: {
+			_variant: "overlap",
+			eyebrow: "Made in Bend, Oregon",
+			heading: "Cookware that gets better every time it meets a fire.",
+			body: "Every Caldera pan is cast, machined and seasoned by twelve people in one workshop — and guaranteed for life.",
+			primaryButton: btn("Shop cookware", "/products", "primary", { arrow: true }),
+			secondaryButton: btn("Visit the workshop", "/about#workshop", "link"),
+			testimonial: {
+				source: "collection",
+				entry: "ts_maya"
+			},
+			image: pic("caldera-workshop", "A worker pouring molten iron into a skillet mould in the Bend workshop", 1600, 2e3),
+			theme: "light"
+		},
+		notes: {
+			why: "Social proof should usually come from ONE place (the Testimonials collection) so a quote that's withdrawn disappears everywhere. But landing pages often need a one-off quote, so `source` toggles between a reference and inline fields — never both visible, never both stored as the truth. The card is an object so the whole quote travels together when the variant changes from 'over the photo' to 'under the copy'.",
+			sanity: "object `testimonialHero` { testimonial: object { source: string, entry: reference<testimonial> (hidden unless collection), quote, name, role, photo, rating (hidden unless custom) } } — Sanity's conditional `hidden` callback is identical in spirit.",
+			htmlSignals: [
+				"A <figure>/<blockquote> card with a photo, name and role positioned absolutely over the hero image",
+				"Star icons or '★★★★★' next to the quote",
+				"The same quote text appearing on a /reviews or /testimonials page — collection candidate"
+			],
+			mcp: "Hero with a quote card → `testimonialHero`. Search the Testimonials collection for the quote text (normalized, ≥ 90% match): found → source 'collection', entry = its id; not found → create the testimonial entry if the site has a testimonials page, else source 'custom' and fill quote/name/role/photo/rating. Card positioned over the image → variant 'overlap'.",
+			pitfalls: ["Quotes typed inline on every landing page drift from the approved wording — prefer the collection."]
+		}
+	},
+	{
+		id: "hero-event",
+		previewLayout: "split",
+		label: "Event hero",
+		proves: "Date/time with zone · in-person/online/hybrid venue with conditional map or stream · sold-out swap · Event data from content",
+		category: "Heroes",
+		tags: [
+			"conditional",
+			"seo-structured",
+			"validation",
+			"media-heavy"
+		],
+		brand: "Open Water Trust",
+		schema: {
+			name: "eventHero",
+			title: "Event hero",
+			kind: "block",
+			icon: "calendar-event",
+			category: "Heroes",
+			description: "Event name, date, place, a countdown and the register button.",
+			preview: {
+				title: "heading",
+				subtitle: "startsAt",
+				media: "image"
+			},
+			groups: [
+				{
+					name: "content",
+					title: "Content",
+					default: true
+				},
+				{
+					name: "when",
+					title: "When & where"
+				},
+				{
+					name: "tickets",
+					title: "Tickets"
+				},
+				{
+					name: "design",
+					title: "Design"
+				}
+			],
+			fields: [
+				eyebrow,
+				{
+					...heading(48),
+					title: "Event name"
+				},
+				body(160),
+				{
+					name: "image",
+					title: "Image",
+					type: "image",
+					validation: { required: true }
+				},
+				{
+					name: "startsAt",
+					title: "Starts",
+					type: "datetime",
+					group: "when",
+					validation: { required: true },
+					description: "In the event's own time zone. Visitors see it converted."
+				},
+				{
+					name: "endsAt",
+					title: "Ends",
+					type: "datetime",
+					group: "when"
+				},
+				{
+					name: "format",
+					title: "Format",
+					type: "select",
+					group: "when",
+					layout: "segmented",
+					initialValue: "in-person",
+					options: [
+						{
+							value: "in-person",
+							label: "In person"
+						},
+						{
+							value: "online",
+							label: "Online"
+						},
+						{
+							value: "hybrid",
+							label: "Hybrid"
+						}
+					]
+				},
+				{
+					name: "venue",
+					title: "Venue",
+					type: "string",
+					group: "when",
+					hidden: {
+						field: "format",
+						equals: ["in-person", "hybrid"]
+					},
+					validation: {
+						required: true,
+						max: 60
+					}
+				},
+				{
+					name: "address",
+					title: "Address",
+					type: "text",
+					group: "when",
+					rows: 2,
+					hidden: {
+						field: "format",
+						equals: ["in-person", "hybrid"]
+					}
+				},
+				{
+					name: "location",
+					title: "Map pin",
+					type: "geopoint",
+					group: "when",
+					hidden: {
+						field: "format",
+						equals: ["in-person", "hybrid"]
+					}
+				},
+				{
+					name: "stream",
+					title: "Stream link",
+					type: "link",
+					group: "when",
+					hidden: {
+						field: "format",
+						equals: ["online", "hybrid"]
+					},
+					description: "Shown on the page only once the event starts."
+				},
+				{
+					name: "showCountdown",
+					title: "Show a countdown",
+					type: "boolean",
+					group: "when",
+					initialValue: true
+				},
+				{
+					name: "status",
+					title: "Ticket status",
+					type: "select",
+					group: "tickets",
+					layout: "radio",
+					initialValue: "on-sale",
+					options: [
+						{
+							value: "on-sale",
+							label: "On sale"
+						},
+						{
+							value: "few-left",
+							label: "Few left",
+							description: "Adds a ‘Few tickets left’ note"
+						},
+						{
+							value: "sold-out",
+							label: "Sold out",
+							description: "Swaps the button for a waitlist"
+						},
+						{
+							value: "cancelled",
+							label: "Cancelled"
+						}
+					]
+				},
+				{
+					name: "registerButton",
+					title: "Register button",
+					type: "button",
+					group: "tickets",
+					hidden: {
+						field: "status",
+						equals: ["on-sale", "few-left"]
+					},
+					validation: { required: true }
+				},
+				{
+					name: "price",
+					title: "Price line",
+					type: "string",
+					group: "tickets",
+					hidden: {
+						field: "status",
+						equals: ["on-sale", "few-left"]
+					},
+					validation: { max: 48 },
+					placeholder: "From $150 · Tables of 8 available"
+				},
+				{
+					name: "waitlistButton",
+					title: "Waitlist button",
+					type: "button",
+					group: "tickets",
+					hidden: {
+						field: "status",
+						equals: "sold-out"
+					},
+					validation: { required: true }
+				},
+				{
+					name: "cancelNote",
+					title: "Cancellation note",
+					type: "text",
+					group: "tickets",
+					rows: 2,
+					hidden: {
+						field: "status",
+						equals: "cancelled"
+					},
+					validation: {
+						required: true,
+						max: 200
+					}
+				},
+				overlay,
+				{
+					...theme,
+					initialValue: "dark"
+				}
+			]
+		},
+		value: {
+			eyebrow: "Annual benefit",
+			heading: "Headwaters Gala 2026",
+			body: "An evening on the river for the people who keep it running — dinner by Hearth & Ash, a film premiere and a live auction.",
+			image: pic("owt-gala", "Long tables set on a riverbank at sunset with lanterns", 2400, 1400),
+			startsAt: "2026-11-14T18:00:00-08:00[America/Los_Angeles]",
+			endsAt: "2026-11-14T22:30:00-08:00[America/Los_Angeles]",
+			format: "hybrid",
+			venue: "The Old Mill at Iron Gate",
+			address: "5000 Copco Rd\nHornbrook, CA 96044",
+			location: {
+				label: "The Old Mill at Iron Gate",
+				address: "5000 Copco Rd, Hornbrook, CA 96044",
+				lat: 41.931,
+				lng: -122.437
+			},
+			stream: {
+				type: "url",
+				href: "https://live.openwatertrust.org/gala-2026",
+				newTab: true
+			},
+			showCountdown: true,
+			status: "few-left",
+			registerButton: btn("Get tickets", "https://openwatertrust.org/gala/tickets", "primary"),
+			price: "From $150 · Tables of 8 available",
+			waitlistButton: btn("Join the waitlist", "/gala/waitlist", "outline"),
+			overlay: 50,
+			theme: "dark"
+		},
+		notes: {
+			why: "The event's FACTS (start/end with time zone, format, venue, map pin, stream) are structured because the same values drive the countdown, the add-to-calendar file and native Event JSON-LD — no separate SEO fields. Format decides which place fields show (venue/address/pin for in-person, stream for online, both for hybrid). Ticket status is one select that swaps the button: on sale → registerButton, sold out → waitlistButton, cancelled → a required note. If the site lists many events, these fields belong on an Events collection entry and the hero becomes a single reference (see pitfalls).",
+			sanity: "object `eventHero` { startsAt/endsAt: datetime (Sanity stores UTC; zone needs a separate field), format: string, venue, address, location: geopoint, stream: url, status: string, registerButton/waitlistButton: object button, cancelNote: text } — with custom validation `Rule.custom` for endsAt > startsAt.",
+			htmlSignals: [
+				"A hero with a date/time line (<time datetime=…>), a place line and a 'Register'/'Get tickets' button",
+				"A ticking countdown (days/hours/minutes) bound to a data-date attribute",
+				"Ticketing links (eventbrite.com, tito.io, lu.ma) or a 'Sold out' badge",
+				"JSON-LD @type Event with eventAttendanceMode (Offline/Online/Mixed) and location/VirtualLocation",
+				"An 'Add to calendar' link or .ics download"
+			],
+			mcp: "Hero with a date + place + ticket button → `eventHero`. <time datetime> or the countdown's data-date → startsAt with its offset (ask for the zone if the source has none). JSON-LD eventAttendanceMode → format (Offline → in-person, Online → online, Mixed → hybrid); location.name/address/geo → venue/address/location. Ticket link → registerButton; 'Sold out' text → status 'sold-out'. Never model the add-to-calendar link — it's generated. If the page is one of many event pages, create an Events collection and report it.",
+			pitfalls: ["Dates stored as text ('Nov 14, 6pm') can't drive the countdown or JSON-LD — always a datetime with offset.", "End before start isn't caught today (gap: cross-field validation)."]
+		}
+	},
+	{
+		id: "hero-personalized",
+		previewLayout: "split",
+		label: "Personalized hero (audiences + A/B)",
+		proves: "Default content + audience versions that override only what they set · rule types with conditional inputs · an experiment split",
+		category: "Heroes",
+		tags: [
+			"personalization",
+			"conditional",
+			"repeater",
+			"validation",
+			"deep-nesting"
+		],
+		brand: "Tideline",
+		schema: {
+			name: "audienceHero",
+			title: "Audience hero",
+			kind: "block",
+			icon: "target",
+			category: "Heroes",
+			description: "One hero with versions for different audiences, and an optional A/B test.",
+			preview: {
+				title: "heading",
+				subtitle: "eyebrow",
+				media: "image"
+			},
+			groups: [
+				{
+					name: "content",
+					title: "Everyone",
+					default: true
+				},
+				{
+					name: "audiences",
+					title: "Audiences"
+				},
+				{
+					name: "experiment",
+					title: "Experiment"
+				},
+				{
+					name: "design",
+					title: "Design"
+				}
+			],
+			fields: [
+				eyebrow,
+				heading(),
+				body(),
+				primary,
+				{
+					name: "image",
+					title: "Image",
+					type: "image",
+					group: "content"
+				},
+				{
+					name: "audiences",
+					title: "Audience versions",
+					type: "array",
+					group: "audiences",
+					itemNoun: "audience",
+					validation: { max: 5 },
+					description: "Checked top to bottom; the first match wins.",
+					of: [{
+						name: "audience",
+						title: "Audience",
+						type: "object",
+						icon: "user-search",
+						preview: {
+							title: "name",
+							subtitle: "rule.type",
+							fallback: "Untitled audience"
+						},
+						fields: [
+							{
+								name: "name",
+								title: "Name",
+								type: "string",
+								validation: {
+									required: true,
+									max: 40
+								},
+								description: "Only editors see this."
+							},
+							{
+								name: "rule",
+								title: "Who sees it",
+								type: "object",
+								icon: "filter",
+								openMode: "drill",
+								fields: [
+									{
+										name: "type",
+										title: "Match by",
+										type: "select",
+										validation: { required: true },
+										options: [
+											{
+												value: "utm_campaign",
+												label: "Ad campaign (utm_campaign)"
+											},
+											{
+												value: "referrer",
+												label: "Came from a site"
+											},
+											{
+												value: "country",
+												label: "Country"
+											},
+											{
+												value: "returning",
+												label: "Returning visitor",
+												description: "Visited in the last 30 days"
+											},
+											{
+												value: "segment",
+												label: "CRM segment"
+											}
+										]
+									},
+									{
+										name: "match",
+										title: "Contains",
+										type: "string",
+										hidden: {
+											field: "type",
+											equals: ["utm_campaign", "referrer"]
+										},
+										validation: {
+											required: true,
+											max: 80
+										},
+										placeholder: "k8s-launch"
+									},
+									{
+										name: "countries",
+										title: "Countries",
+										type: "multiselect",
+										hidden: {
+											field: "type",
+											equals: "country"
+										},
+										validation: { min: 1 },
+										options: [
+											{
+												value: "US",
+												label: "United States"
+											},
+											{
+												value: "GB",
+												label: "United Kingdom"
+											},
+											{
+												value: "DE",
+												label: "Germany"
+											},
+											{
+												value: "IN",
+												label: "India"
+											},
+											{
+												value: "JP",
+												label: "Japan"
+											}
+										]
+									},
+									{
+										name: "segment",
+										title: "Segment",
+										type: "select",
+										hidden: {
+											field: "type",
+											equals: "segment"
+										},
+										validation: { required: true },
+										options: [
+											{
+												value: "enterprise",
+												label: "Enterprise accounts (1,000+ staff)"
+											},
+											{
+												value: "trial",
+												label: "Active trials"
+											},
+											{
+												value: "churned",
+												label: "Cancelled in the last 90 days"
+											}
+										]
+									}
+								]
+							},
+							{
+								name: "eyebrow",
+								title: "Eyebrow",
+								type: "string",
+								validation: { max: 40 },
+								description: "Leave empty to keep the Everyone version."
+							},
+							{
+								name: "heading",
+								title: "Heading",
+								type: "string",
+								validation: {
+									max: 100,
+									recommendedMax: 60
+								},
+								ai: true,
+								description: "Leave empty to keep the Everyone version."
+							},
+							{
+								name: "body",
+								title: "Body",
+								type: "text",
+								rows: 3,
+								validation: { recommendedMax: 180 },
+								ai: true,
+								description: "Leave empty to keep the Everyone version."
+							},
+							{
+								name: "primaryButton",
+								title: "Primary button",
+								type: "button",
+								description: "Leave empty to keep the Everyone version."
+							},
+							{
+								name: "image",
+								title: "Image",
+								type: "image",
+								description: "Leave empty to keep the Everyone version."
+							}
+						]
+					}]
+				},
+				{
+					name: "test",
+					title: "A/B test",
+					type: "object",
+					group: "experiment",
+					icon: "flask",
+					openMode: "drill",
+					fields: [
+						{
+							name: "isRunning",
+							title: "Run a test",
+							type: "boolean"
+						},
+						{
+							name: "share",
+							title: "Share seeing the new version",
+							type: "number",
+							layout: "slider",
+							hidden: {
+								field: "isRunning",
+								equals: true
+							},
+							numeric: {
+								min: 10,
+								max: 90,
+								step: 5,
+								unit: "%"
+							},
+							initialValue: 50
+						},
+						{
+							name: "goal",
+							title: "Success means",
+							type: "select",
+							hidden: {
+								field: "isRunning",
+								equals: true
+							},
+							validation: { required: true },
+							options: [
+								{
+									value: "primary-click",
+									label: "Clicked the primary button"
+								},
+								{
+									value: "signup",
+									label: "Started a trial"
+								},
+								{
+									value: "demo",
+									label: "Booked a demo"
+								}
+							]
+						},
+						{
+							name: "endsOn",
+							title: "Stop on",
+							type: "date",
+							hidden: {
+								field: "isRunning",
+								equals: true
+							}
+						}
+					]
+				},
+				theme
+			]
+		},
+		value: {
+			eyebrow: "Observability for on-call teams",
+			heading: "See why production is slow in one view, not twelve tabs.",
+			body: "Tideline links traces, logs and deploys so the person holding the pager finds the cause in minutes.",
+			primaryButton: btn("Start free", "https://app.tideline.dev/signup", "primary"),
+			image: pic("tideline-timeline", "Tideline timeline showing a latency spike right after a deploy", 2400, 1500),
+			audiences: [
+				{
+					_key: "a1",
+					name: "Kubernetes ad campaign",
+					rule: {
+						type: "utm_campaign",
+						match: "k8s-launch"
+					},
+					eyebrow: "New: Kubernetes traces",
+					heading: "Every pod, every span, one timeline.",
+					primaryButton: btn("Try it on your cluster", "https://app.tideline.dev/signup?template=k8s", "primary")
+				},
+				{
+					_key: "a2",
+					name: "Enterprise visitors",
+					rule: {
+						type: "segment",
+						segment: "enterprise"
+					},
+					heading: "Observability that passes your security review.",
+					body: "SOC 2 Type II, SSO and SCIM, EU data residency and a named engineer from day one.",
+					primaryButton: btn("Talk to sales", "/contact-sales", "primary")
+				},
+				{
+					_key: "a3",
+					name: "Returning visitors",
+					rule: { type: "returning" },
+					eyebrow: "Welcome back",
+					primaryButton: btn("Pick up your trial", "https://app.tideline.dev/login", "primary")
+				}
+			],
+			test: {
+				isRunning: true,
+				share: 50,
+				goal: "signup",
+				endsOn: "2026-11-01"
+			},
+			theme: "dark"
+		},
+		notes: {
+			why: "Personalization is modelled as ONE hero with a default ('Everyone') and an ordered array of audience versions that override only the fields they fill — so a returning-visitor version can change just the button. Each audience holds a rule object whose inputs depend on the rule type (a string for UTM/referrer, countries for geo, a segment select for CRM), making Hero › Audiences › Audience › Rule a four-level drill. The A/B test is a separate object in its own tab; its settings only appear when it's on. Overrides are plain optional fields with 'leave empty to keep' help, because the schema can't yet express inherit-from-default.",
+			sanity: "object `audienceHero` { default: object hero, audiences: array<object { name, rule: object { type, match, countries, segment }, overrides: object hero (all optional) }>, test: object { enabled, share, goal, endsOn } } — teams often hand this to Sanity's Personalization/experiments plugins or an external tool (LaunchDarkly, Ninetailed) and store only variant ids.",
+			htmlSignals: [
+				"Server-rendered HTML differs between crawls with different ?utm_campaign= or Accept-Language/geo — compare responses",
+				"Multiple hidden hero variants in the DOM with data-variant / data-audience attributes",
+				"Experiment SDKs: Optimizely, VWO, Google Optimize remnants, LaunchDarkly, Ninetailed, Statsig (window.optimizely, _vwo_code)",
+				"Flicker-prevention snippets (async-hide, opacity:0 on body until the SDK decides)"
+			],
+			mcp: "Only mark a hero personalized with evidence: hidden variants in the DOM or different responses for different UTM/geo requests. The variant shown with no parameters → the Everyone fields. Each other variant → audiences[] with ONLY the fields that differ (leave the rest empty), rule from the parameter that triggered it. Experiment SDK config (traffic allocation, goal event) → test. Never import third-party experiment ids as content; report the SDK so the team can decide whether BetterCMS replaces it.",
+			pitfalls: [
+				"Copying the whole hero into every audience — later edits to Everyone no longer reach them. Store only the differences.",
+				"Two audiences that both match: order decides; the converter must preserve the source's precedence.",
+				"Personalized copy must not be indexed as the canonical content — crawlers see Everyone."
+			]
+		}
+	}
+];
+//#endregion
+export { ENTRIES };
+
+//# sourceMappingURL=heroes.entries.js.map