@bettercms-ai/kit 1.0.0 → 2.0.0

package/dist/library/entries/navigation.entries.js

@@ -0,0 +1,4011 @@
+//#region src/library/entries/navigation.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 page = (href, title) => ({
+	type: "page",
+	href,
+	title
+});
+var btn = (label, href, style = "primary", extra = {}) => ({
+	label,
+	href,
+	type: href.startsWith("http") ? "url" : "page",
+	style,
+	...extra
+});
+var logoFields = [{
+	name: "logo",
+	title: "Logo",
+	type: "image",
+	fieldset: "brand",
+	description: "SVG, or a PNG at least 64px tall."
+}, {
+	name: "logoText",
+	title: "Logo text",
+	type: "string",
+	fieldset: "brand",
+	validation: {
+		required: true,
+		max: 40
+	},
+	description: "Read by screen readers. Shown if the logo can't load."
+}];
+/** A plain top-level link: label + link, nothing else. Two fields → opens inline. */
+var navLink = (maxLabel = 24) => ({
+	name: "link",
+	title: "Link",
+	type: "object",
+	icon: "link",
+	openMode: "inline",
+	preview: {
+		title: "label",
+		subtitle: "link.href",
+		fallback: "Untitled link"
+	},
+	fields: [{
+		name: "label",
+		title: "Label",
+		type: "string",
+		validation: {
+			required: true,
+			max: maxLabel
+		}
+	}, {
+		name: "link",
+		title: "Links to",
+		type: "link",
+		validation: { required: true }
+	}]
+});
+var socialItem = {
+	name: "socialLink",
+	title: "Social profile",
+	type: "object",
+	icon: "share",
+	openMode: "inline",
+	preview: {
+		title: "platform",
+		subtitle: "url",
+		fallback: "Untitled profile"
+	},
+	fields: [{
+		name: "platform",
+		title: "Platform",
+		type: "select",
+		validation: { required: true },
+		options: [
+			{
+				value: "instagram",
+				label: "Instagram",
+				icon: "brand-instagram"
+			},
+			{
+				value: "youtube",
+				label: "YouTube",
+				icon: "brand-youtube"
+			},
+			{
+				value: "tiktok",
+				label: "TikTok",
+				icon: "brand-tiktok"
+			},
+			{
+				value: "facebook",
+				label: "Facebook",
+				icon: "brand-facebook"
+			},
+			{
+				value: "x",
+				label: "X",
+				icon: "brand-x"
+			},
+			{
+				value: "linkedin",
+				label: "LinkedIn",
+				icon: "brand-linkedin"
+			},
+			{
+				value: "pinterest",
+				label: "Pinterest",
+				icon: "brand-pinterest"
+			},
+			{
+				value: "dribbble",
+				label: "Dribbble",
+				icon: "brand-dribbble"
+			}
+		]
+	}, {
+		name: "url",
+		title: "Profile address",
+		type: "url",
+		validation: {
+			required: true,
+			pattern: "^https://",
+			patternMessage: "Use the full address, like https://your-site.com."
+		}
+	}]
+};
+var linkGroup = (maxLinks = 8) => ({
+	name: "linkGroup",
+	title: "Link group",
+	type: "object",
+	icon: "list",
+	preview: {
+		title: "title",
+		fallback: "Untitled group"
+	},
+	fields: [{
+		name: "title",
+		title: "Group title",
+		type: "string",
+		validation: {
+			required: true,
+			max: 24
+		}
+	}, {
+		name: "links",
+		title: "Links",
+		type: "array",
+		itemNoun: "link",
+		validation: {
+			min: 1,
+			max: maxLinks
+		},
+		of: [navLink(32)]
+	}]
+});
+var themeField = {
+	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 DESIGN_GROUPS = [{
+	name: "content",
+	title: "Content",
+	default: true
+}, {
+	name: "design",
+	title: "Design"
+}];
+var ENTRIES = [
+	{
+		id: "nav-simple-cta",
+		previewLayout: "nav",
+		label: "Simple navbar with CTA",
+		proves: "Smallest global header · inline link rows · one button unit · tap-to-call link · design kept out of content",
+		category: "Navigation & chrome",
+		tags: [
+			"global-synced",
+			"repeater",
+			"validation",
+			"variants"
+		],
+		brand: "Hearth & Ash",
+		syncedFrom: "Header",
+		schema: {
+			name: "header",
+			title: "Header",
+			kind: "global",
+			icon: "layout-navbar",
+			category: "Navigation & chrome",
+			description: "Logo, a few links and one main button. Synced across every page.",
+			variants: [{
+				id: "logo-left",
+				name: "Logo left",
+				description: "Logo left, links and button right"
+			}, {
+				id: "logo-center",
+				name: "Centered logo",
+				description: "Links split either side of the logo"
+			}],
+			preview: {
+				title: "logoText",
+				media: "logo"
+			},
+			groups: DESIGN_GROUPS,
+			fieldsets: [{
+				name: "brand",
+				title: "Brand"
+			}],
+			fields: [
+				...logoFields,
+				{
+					name: "links",
+					title: "Links",
+					type: "array",
+					itemNoun: "link",
+					validation: {
+						min: 1,
+						max: 6
+					},
+					of: [navLink()]
+				},
+				{
+					name: "phone",
+					title: "Phone",
+					type: "link",
+					description: "Leave empty to hide it."
+				},
+				{
+					name: "button",
+					title: "Button",
+					type: "button"
+				},
+				themeField,
+				{
+					name: "isSticky",
+					title: "Stick to the top",
+					type: "boolean",
+					group: "design",
+					initialValue: true
+				},
+				{
+					name: "isTransparent",
+					title: "Transparent over heroes",
+					type: "boolean",
+					group: "design"
+				},
+				{
+					name: "mobileMenu",
+					title: "Mobile menu",
+					type: "select",
+					group: "design",
+					layout: "radio",
+					initialValue: "drawer",
+					options: [{
+						value: "drawer",
+						label: "Drawer",
+						description: "Slides in from the right"
+					}, {
+						value: "fullscreen",
+						label: "Full screen",
+						description: "Covers the page, big type"
+					}]
+				}
+			]
+		},
+		value: {
+			_variant: "logo-left",
+			logo: pic("hearth-ash-mark", "Hearth & Ash", 240, 64),
+			logoText: "Hearth & Ash",
+			links: [
+				{
+					_key: "l1",
+					label: "Menus",
+					link: page("/menus", "Menus")
+				},
+				{
+					_key: "l2",
+					label: "Private dining",
+					link: page("/private-dining", "Private dining")
+				},
+				{
+					_key: "l3",
+					label: "Gift cards",
+					link: page("/gift-cards", "Gift cards")
+				},
+				{
+					_key: "l4",
+					label: "Our story",
+					link: page("/story", "Our story")
+				}
+			],
+			phone: {
+				type: "phone",
+				href: "tel:+15035550142",
+				phone: "+1 503 555 0142",
+				title: "(503) 555-0142"
+			},
+			button: btn("Book a table", "https://resy.com/cities/pdx/hearth-and-ash", "primary", {
+				newTab: true,
+				rel: "follow"
+			}),
+			theme: "dark",
+			isSticky: true,
+			isTransparent: true,
+			mobileMenu: "fullscreen"
+		},
+		notes: {
+			why: "A header is site chrome, so it is ONE global (kind: global) that every page renders — never a block copied onto each page, or a menu change becomes 40 edits. Links are an array of tiny objects (label + link) that open inline because two fields don't deserve a drill-in. The CTA is a `button` (label + link + style as one unit) so the label can never drift from where it goes. Phone is a `link` of type phone, not a string, so the renderer gets a valid tel: href. Theme, sticky, transparency and the mobile menu style live in Design: they change how it looks, not what it says.",
+			sanity: "Singleton document `siteHeader` { logo: image, logoText: string, links: array<object navLink { label: string, link: object { internal: reference<page>, external: url } }>, phone: string, cta: object button { label, link }, theme: string(list) } surfaced through a Structure singleton.",
+			htmlSignals: [
+				"<header> (or role=banner) as the first child of <body>, containing <nav> with a short <ul> of <a>",
+				"A logo <a href=\"/\"> wrapping an <img>/<svg> at the start of the row",
+				"One visually distinct <a>/<button> at the end of the row (filled background) — the CTA",
+				"An <a href=\"tel:…\"> or phone icon; a hamburger <button aria-expanded> hidden on desktop",
+				"position: sticky/fixed on the header; identical markup on every crawled page"
+			],
+			mcp: "Detect on 2+ pages with identical markup → create ONE global `header` and reference it from layouts; never per page. Map logo <img> → logo (alt → logoText if no visible text), each top-level <nav> <a> → links[] { label: textContent, link: internal page if same origin else url }. The last styled anchor/button → button (style from its class: filled → primary, bordered → outline). tel: anchors → phone. position sticky/fixed → isSticky: true; a transparent background over a hero → isTransparent: true. Ignore the hamburger markup — it's the renderer's job.",
+			pitfalls: ["A 'Book a table' widget that opens a third-party modal is still a button with an external link — don't model the widget's script.", "Don't create a link for the logo; it always goes home."]
+		}
+	},
+	{
+		id: "nav-announcement-utility",
+		previewLayout: "nav",
+		label: "Header with announcement + utility row",
+		proves: "Three stacked rows in one global · conditional row content · tab groups per row · design values split from content",
+		category: "Navigation & chrome",
+		tags: [
+			"global-synced",
+			"conditional",
+			"repeater",
+			"localized"
+		],
+		brand: "Caldera",
+		syncedFrom: "Header",
+		schema: {
+			name: "utilityHeader",
+			title: "Utility header",
+			kind: "global",
+			icon: "layout-navbar",
+			category: "Navigation & chrome",
+			description: "An announcement row, a utility row and the main menu. Synced across every page.",
+			preview: {
+				title: "logoText",
+				subtitle: "announcement.message",
+				media: "logo"
+			},
+			groups: [
+				{
+					name: "content",
+					title: "Main row",
+					default: true
+				},
+				{
+					name: "rows",
+					title: "Top rows"
+				},
+				{
+					name: "design",
+					title: "Design"
+				}
+			],
+			fieldsets: [{
+				name: "brand",
+				title: "Brand"
+			}],
+			fields: [
+				...logoFields,
+				{
+					name: "items",
+					title: "Menu items",
+					type: "array",
+					itemNoun: "menu item",
+					validation: {
+						min: 1,
+						max: 7
+					},
+					of: [navLink(20)]
+				},
+				{
+					name: "button",
+					title: "Button",
+					type: "button"
+				},
+				{
+					name: "announcement",
+					title: "Announcement row",
+					type: "object",
+					group: "rows",
+					icon: "speakerphone",
+					openMode: "drill",
+					fields: [
+						{
+							name: "showAnnouncement",
+							title: "Show the announcement",
+							type: "boolean",
+							initialValue: true
+						},
+						{
+							name: "message",
+							title: "Message",
+							type: "string",
+							hidden: {
+								field: "showAnnouncement",
+								equals: true
+							},
+							validation: {
+								required: true,
+								max: 90,
+								recommendedMax: 70
+							},
+							localized: true,
+							ai: true
+						},
+						{
+							name: "link",
+							title: "Links to",
+							type: "link",
+							hidden: {
+								field: "showAnnouncement",
+								equals: true
+							},
+							description: "Leave empty for plain text."
+						}
+					]
+				},
+				{
+					name: "utilityLinks",
+					title: "Utility links",
+					type: "array",
+					group: "rows",
+					itemNoun: "utility link",
+					validation: { max: 4 },
+					description: "Hidden on phones.",
+					of: [{
+						name: "utilityLink",
+						title: "Utility link",
+						type: "object",
+						icon: "link",
+						openMode: "inline",
+						preview: {
+							title: "label",
+							subtitle: "link.href",
+							fallback: "Untitled link"
+						},
+						fields: [
+							{
+								name: "icon",
+								title: "Icon",
+								type: "icon"
+							},
+							{
+								name: "label",
+								title: "Label",
+								type: "string",
+								validation: {
+									required: true,
+									max: 20
+								}
+							},
+							{
+								name: "link",
+								title: "Links to",
+								type: "link",
+								validation: { required: true }
+							}
+						]
+					}]
+				},
+				{
+					name: "announcementTone",
+					title: "Announcement color",
+					type: "select",
+					group: "design",
+					layout: "segmented",
+					initialValue: "brand",
+					options: [
+						{
+							value: "neutral",
+							label: "Neutral"
+						},
+						{
+							value: "brand",
+							label: "Brand"
+						},
+						{
+							value: "sale",
+							label: "Sale"
+						}
+					]
+				},
+				{
+					name: "stick",
+					title: "What stays on scroll",
+					type: "select",
+					group: "design",
+					layout: "radio",
+					initialValue: "main",
+					options: [
+						{
+							value: "none",
+							label: "Nothing",
+							description: "The whole header scrolls away"
+						},
+						{
+							value: "main",
+							label: "Main row only",
+							description: "Top rows scroll away, the menu stays"
+						},
+						{
+							value: "all",
+							label: "All rows"
+						}
+					]
+				}
+			]
+		},
+		value: {
+			logo: pic("caldera-mark", "Caldera", 240, 64),
+			logoText: "Caldera",
+			items: [
+				{
+					_key: "i1",
+					label: "Shop",
+					link: page("/products", "Products")
+				},
+				{
+					_key: "i2",
+					label: "Bundles",
+					link: page("/shop/bundles", "Bundles")
+				},
+				{
+					_key: "i3",
+					label: "Recipes",
+					link: page("/recipes", "Recipes")
+				},
+				{
+					_key: "i4",
+					label: "Journal",
+					link: page("/journal", "Journal")
+				},
+				{
+					_key: "i5",
+					label: "About",
+					link: page("/about", "About")
+				}
+			],
+			button: btn("Shop the Fold", "/products/cable-fold"),
+			announcement: {
+				showAnnouncement: true,
+				message: "Free shipping over $80 · Lifetime warranty on all cast iron",
+				link: page("/shipping", "Shipping & returns")
+			},
+			utilityLinks: [
+				{
+					_key: "u1",
+					icon: "truck",
+					label: "Track an order",
+					link: page("/orders/track", "Track an order")
+				},
+				{
+					_key: "u2",
+					icon: "help-circle",
+					label: "Help centre",
+					link: page("/help", "Help centre")
+				},
+				{
+					_key: "u3",
+					icon: "map-pin",
+					label: "Find a retailer",
+					link: page("/retailers", "Retailers")
+				},
+				{
+					_key: "u4",
+					icon: "building-store",
+					label: "Wholesale",
+					link: page("/wholesale", "Wholesale pricing")
+				}
+			],
+			announcementTone: "brand",
+			stick: "main"
+		},
+		notes: {
+			why: "Three visual rows, ONE global: the rows always ship together and share a sticky behavior, so splitting them into three globals would make 'what stays on scroll' impossible to express. Tab groups mirror the rows (Main row / Top rows / Design) so a marketer changing the shipping message never sees the menu. The announcement is an object with an `showAnnouncement` switch and its fields conditional on it — turning the strip off keeps the copy for next time. Its color is a design choice and lives in Design, not inside the announcement object.",
+			sanity: "Singleton `siteHeader` with `groups: [main, rows, design]`; `announcement: object { showAnnouncement: boolean, message: string, link }` with `hidden: ({parent}) => !parent?.showAnnouncement`; `utilityLinks: array<object { icon: string, label, link }>`.",
+			htmlSignals: [
+				"Two or three stacked rows inside <header>: a full-width colored strip with one sentence, then a row of small links, then the main nav",
+				"The strip text contains shipping/discount wording ('Free shipping', '% off', 'Use code')",
+				"Utility row uses smaller type and icons (truck, help, map pin) and is display:none under ~768px",
+				"Only the bottom row has position: sticky"
+			],
+			mcp: "Treat the stacked rows as ONE global. Colored single-sentence strip → announcement { showAnnouncement: true, message, link: the strip's <a> if any }; its background color → announcementTone (red/orange → sale, brand color → brand, gray → neutral). Small links above the main nav → utilityLinks (keep the icon name if an icon library class is present). Main <nav> anchors → items. If the strip is a separate dismissible element with its own close button and a countdown, use `announcement-countdown` instead and leave this one's announcement disabled.",
+			pitfalls: ["A rotating announcement (several messages cycling) is an array, not one string — switch `message` to an array of {message, link} rather than joining with ·.", "Don't put the account/cart icons in utility links — those are app state; see `nav-ecommerce-header`."]
+		}
+	},
+	{
+		id: "nav-mega-featured-promo",
+		previewLayout: "nav",
+		label: "Mega menu with featured cards + promo slot",
+		proves: "Six levels deep · product references inside a menu · a marketer-owned promo SLOT next to structured columns",
+		category: "Navigation & chrome",
+		tags: [
+			"deep-nesting",
+			"slots",
+			"global-synced",
+			"conditional",
+			"references",
+			"variants",
+			"commerce"
+		],
+		brand: "Caldera",
+		syncedFrom: "Navigation",
+		schema: {
+			name: "megaMenuHeader",
+			title: "Mega menu header",
+			kind: "global",
+			icon: "layout-navbar",
+			category: "Navigation & chrome",
+			description: "Menu items that open wide panels with link columns, product cards and a promo.",
+			variants: [{
+				id: "full",
+				name: "Full-width panel",
+				description: "Panel spans the whole window"
+			}, {
+				id: "card",
+				name: "Dropdown card",
+				description: "Panel is a card under the item"
+			}],
+			preview: {
+				title: "logoText",
+				media: "logo"
+			},
+			groups: DESIGN_GROUPS,
+			fieldsets: [{
+				name: "brand",
+				title: "Brand"
+			}],
+			fields: [
+				...logoFields,
+				{
+					name: "items",
+					title: "Menu items",
+					type: "array",
+					itemNoun: "menu item",
+					validation: {
+						min: 1,
+						max: 6
+					},
+					of: [{
+						name: "menuItem",
+						title: "Menu item",
+						type: "object",
+						icon: "menu",
+						preview: {
+							title: "label",
+							subtitle: "opens",
+							fallback: "Untitled item"
+						},
+						fields: [
+							{
+								name: "label",
+								title: "Label",
+								type: "string",
+								validation: {
+									required: true,
+									max: 20
+								}
+							},
+							{
+								name: "opens",
+								title: "Opens",
+								type: "select",
+								layout: "segmented",
+								initialValue: "link",
+								options: [{
+									value: "link",
+									label: "A page"
+								}, {
+									value: "panel",
+									label: "A panel"
+								}]
+							},
+							{
+								name: "link",
+								title: "Links to",
+								type: "link",
+								hidden: {
+									field: "opens",
+									equals: "link"
+								},
+								validation: { required: true }
+							},
+							{
+								name: "panel",
+								title: "Panel",
+								type: "object",
+								icon: "layout-board",
+								openMode: "drill",
+								hidden: {
+									field: "opens",
+									equals: "panel"
+								},
+								fields: [
+									{
+										name: "columns",
+										title: "Link columns",
+										type: "array",
+										itemNoun: "column",
+										validation: {
+											min: 1,
+											max: 4
+										},
+										of: [{
+											name: "column",
+											title: "Column",
+											type: "object",
+											icon: "columns-3",
+											preview: {
+												title: "title",
+												fallback: "Untitled column"
+											},
+											fields: [
+												{
+													name: "title",
+													title: "Column title",
+													type: "string",
+													validation: {
+														required: true,
+														max: 24
+													}
+												},
+												{
+													name: "viewAll",
+													title: "View all link",
+													type: "link"
+												},
+												{
+													name: "links",
+													title: "Links",
+													type: "array",
+													itemNoun: "link",
+													validation: { max: 8 },
+													of: [{
+														name: "panelLink",
+														title: "Link",
+														type: "object",
+														icon: "link",
+														preview: {
+															title: "label",
+															subtitle: "description",
+															fallback: "Untitled link"
+														},
+														fields: [
+															{
+																name: "label",
+																title: "Label",
+																type: "string",
+																validation: {
+																	required: true,
+																	max: 32
+																}
+															},
+															{
+																name: "link",
+																title: "Links to",
+																type: "link",
+																validation: { required: true }
+															},
+															{
+																name: "description",
+																title: "Description",
+																type: "string",
+																validation: { recommendedMax: 60 }
+															},
+															{
+																name: "badge",
+																title: "Badge",
+																type: "object",
+																icon: "badge",
+																openMode: "popover",
+																fields: [
+																	{
+																		name: "label",
+																		title: "Label",
+																		type: "string",
+																		validation: { max: 12 }
+																	},
+																	{
+																		name: "tone",
+																		title: "Color",
+																		type: "select",
+																		layout: "segmented",
+																		options: [
+																			{
+																				value: "brand",
+																				label: "Brand"
+																			},
+																			{
+																				value: "sale",
+																				label: "Sale"
+																			},
+																			{
+																				value: "neutral",
+																				label: "Neutral"
+																			}
+																		]
+																	},
+																	{
+																		name: "hideAfter",
+																		title: "Hide after",
+																		type: "datetime"
+																	}
+																]
+															}
+														]
+													}]
+												}
+											]
+										}]
+									},
+									{
+										name: "featuredCards",
+										title: "Featured cards",
+										type: "array",
+										itemNoun: "card",
+										validation: { max: 2 },
+										of: [{
+											name: "featuredCard",
+											title: "Card",
+											type: "object",
+											icon: "layout-cards",
+											preview: {
+												title: "title",
+												subtitle: "source",
+												media: "image",
+												fallback: "Untitled product card"
+											},
+											fields: [
+												{
+													name: "source",
+													title: "Shows",
+													type: "select",
+													layout: "segmented",
+													initialValue: "product",
+													options: [{
+														value: "product",
+														label: "A product"
+													}, {
+														value: "custom",
+														label: "Custom card"
+													}]
+												},
+												{
+													name: "product",
+													title: "Product",
+													type: "reference",
+													reference: { to: ["shopify"] },
+													hidden: {
+														field: "source",
+														equals: "product"
+													},
+													validation: { required: true }
+												},
+												{
+													name: "image",
+													title: "Image",
+													type: "image",
+													hidden: {
+														field: "source",
+														equals: "custom"
+													},
+													validation: { required: true }
+												},
+												{
+													name: "title",
+													title: "Title",
+													type: "string",
+													hidden: {
+														field: "source",
+														equals: "custom"
+													},
+													validation: {
+														required: true,
+														recommendedMax: 40
+													},
+													ai: true
+												},
+												{
+													name: "button",
+													title: "Button",
+													type: "button",
+													hidden: {
+														field: "source",
+														equals: "custom"
+													}
+												}
+											]
+										}]
+									},
+									{
+										name: "promo",
+										title: "Promo",
+										type: "slot",
+										validation: { max: 1 },
+										of: {
+											type: "block",
+											allow: [
+												"ctaCard",
+												"imageBlock",
+												"productCard",
+												"videoBlock"
+											]
+										}
+									}
+								]
+							}
+						]
+					}]
+				},
+				{
+					name: "button",
+					title: "Button",
+					type: "button"
+				},
+				{
+					name: "openOn",
+					title: "Panels open on",
+					type: "select",
+					group: "design",
+					layout: "segmented",
+					initialValue: "hover",
+					options: [{
+						value: "hover",
+						label: "Hover"
+					}, {
+						value: "click",
+						label: "Click"
+					}]
+				},
+				{
+					name: "useBackdrop",
+					title: "Dim the page behind",
+					type: "boolean",
+					group: "design",
+					initialValue: true
+				}
+			]
+		},
+		value: {
+			_variant: "full",
+			logo: pic("caldera-mark", "Caldera", 240, 64),
+			logoText: "Caldera",
+			items: [
+				{
+					_key: "m1",
+					label: "Shop",
+					opens: "panel",
+					panel: {
+						columns: [
+							{
+								_key: "c1",
+								title: "Cookware",
+								viewAll: page("/products", "All cookware"),
+								links: [
+									{
+										_key: "a1",
+										label: "Skillets",
+										link: page("/products?type=skillet", "Skillets"),
+										description: "Cast iron and carbon steel, 8 to 14 inches"
+									},
+									{
+										_key: "a2",
+										label: "Dutch ovens",
+										link: {
+											type: "entry",
+											href: "/products/ember-dutch-oven",
+											title: "Ember Dutch Oven 5.5qt",
+											entryId: "en_p2"
+										},
+										description: "Enamelled, 3.5 to 7 quarts",
+										badge: {
+											label: "New",
+											tone: "brand"
+										}
+									},
+									{
+										_key: "a3",
+										label: "Grills",
+										link: {
+											type: "entry",
+											href: "/products/cable-fold",
+											title: "Cable Fold Grill",
+											entryId: "en_p1"
+										},
+										description: "The Cable Fold and the Ridge grate"
+									}
+								]
+							},
+							{
+								_key: "c2",
+								title: "Camp kitchen",
+								links: [{
+									_key: "a4",
+									label: "Kettles",
+									link: {
+										type: "entry",
+										href: "/products/trail-kettle",
+										title: "Trail Kettle 1L",
+										entryId: "en_p4"
+									}
+								}, {
+									_key: "a5",
+									label: "Bundles",
+									link: page("/shop/bundles", "Bundles"),
+									description: "Save 15% on sets",
+									badge: {
+										label: "Sale",
+										tone: "sale",
+										hideAfter: "2026-12-01T23:59:00-08:00[America/Los_Angeles]"
+									}
+								}]
+							},
+							{
+								_key: "c3",
+								title: "Care",
+								links: [{
+									_key: "a6",
+									label: "Seasoning oil",
+									link: page("/products/seasoning-oil", "Seasoning oil")
+								}, {
+									_key: "a7",
+									label: "Chainmail scrubber",
+									link: page("/products/chainmail", "Chainmail scrubber")
+								}]
+							}
+						],
+						featuredCards: [{
+							_key: "f1",
+							source: "product",
+							product: "gid://shopify/Product/8812"
+						}, {
+							_key: "f2",
+							source: "custom",
+							image: pic("caldera-gift-guide", "Cast iron set wrapped in brown paper on a cabin table", 900, 700),
+							title: "The 2026 gift guide",
+							button: btn("Find a gift", "/journal/gift-guide", "link", { arrow: true })
+						}],
+						promo: [{
+							_key: "p1",
+							_type: "ctaCard",
+							_variant: "solid",
+							heading: "Holiday sets ship free",
+							body: "Order by December 18 for delivery before the 24th.",
+							button: btn("Shop sets", "/shop/bundles")
+						}]
+					}
+				},
+				{
+					_key: "m2",
+					label: "Learn",
+					opens: "panel",
+					panel: {
+						columns: [{
+							_key: "c4",
+							title: "Cook",
+							links: [{
+								_key: "b1",
+								label: "Recipes",
+								link: page("/recipes", "Recipes"),
+								description: "Tested over coals and on the stove"
+							}, {
+								_key: "b2",
+								label: "Cast iron care",
+								link: page("/journal/cast-iron-care", "Cast iron care")
+							}]
+						}],
+						featuredCards: [],
+						promo: [{
+							_key: "p2",
+							_type: "imageBlock",
+							_variant: "cover",
+							image: pic("caldera-film-still", "Cook kneeling at a campfire at dusk", 900, 700),
+							caption: "Watch: Fire Lessons, episode 4",
+							link: page("/journal/fire-lessons-4", "Fire Lessons, episode 4")
+						}]
+					}
+				},
+				{
+					_key: "m3",
+					label: "About",
+					opens: "link",
+					link: page("/about", "About")
+				}
+			],
+			button: btn("Shop the Fold", "/products/cable-fold"),
+			openOn: "click",
+			useBackdrop: true
+		},
+		notes: {
+			why: "Same global header shape as the core Mega menu, but the panel separates what is STRUCTURED from what is CAMPAIGN. Link columns and product cards are typed fields (a converter and a validator can reason about them); the promo is a `slot` limited to one block from a short allow-list, so marketing can drop in a card, image or video for a launch without a developer adding fields. Product cards are REFERENCES to Shopify products — photo, name, price and stock flow in, so the menu never shows a stale price. `opens` switches between a plain link and a panel; the panel object only shows when needed. The badge is a popover object because it's 3 small fields edited rarely, and it carries its own expiry.",
+			sanity: "`navigation` singleton → `items: array<object menuItem { label, opens, link, panel: object { columns: array<object { title, viewAll, links: array<object { label, link, description, badge: object }> }>, featuredCards: array<object { source, product: reference<shopify.product>, image, title, button }>, promo: array<ctaCard | imageBlock | productCard | videoBlock> (max 1) } }>` — Sanity has no slot type; it's an array of block types.",
+			htmlSignals: [
+				"Top-level nav <li> containing a <div> panel (often role=menu or [data-mega], display:none until hover/aria-expanded)",
+				"Panel holds 2–4 <ul> lists each preceded by a small heading — the columns",
+				"Image cards inside the panel with a price or 'Shop' link — product cards (look for /products/ hrefs and price text)",
+				"A visually different tile (full-bleed image or colored card) at the panel edge — the promo",
+				"Small pills (<span class=\"badge\">New</span>) next to some links"
+			],
+			mcp: "Per top-level <li>: if it has a panel → opens: 'panel', else opens: 'link'. Panel headings + their <ul> → columns[] (a trailing 'View all/Shop all' anchor → viewAll, not a link). Card with a price and a /products/<handle> href → featuredCards[] { source: 'product', product: resolve handle to the Shopify product id }; card without price → { source: 'custom', image, title, button }. The remaining odd-one-out tile → promo slot as ctaCard (text+button), imageBlock (image+caption) or videoBlock. Pills → badge.label; red/sale colors → tone: 'sale'. Never copy the price text into a field.",
+			pitfalls: [
+				"Product cards that hard-code price text go stale on the next price change — always resolve to a reference.",
+				"If two menu items share the same panel content, that is still two panels in content; don't invent a shared-panel global for it.",
+				"Hover-only panels fail keyboard users — the converter should default `openOn` to click when the source has no aria-expanded handling."
+			]
+		}
+	},
+	{
+		id: "nav-docs-sidebar",
+		previewLayout: "list",
+		label: "Docs sidebar navigation",
+		proves: "Four-level tree at a fixed depth · curated vs auto from the page tree · version switcher · status badges",
+		category: "Navigation & chrome",
+		tags: [
+			"deep-nesting",
+			"repeater",
+			"global-synced",
+			"conditional",
+			"dynamic-query",
+			"references"
+		],
+		brand: "Tideline",
+		syncedFrom: "Docs sidebar",
+		schema: {
+			name: "docsSidebar",
+			title: "Docs sidebar",
+			kind: "global",
+			icon: "layout-sidebar",
+			category: "Navigation & chrome",
+			description: "The left-hand tree on every docs page, with search and a version switcher.",
+			preview: { title: "searchPlaceholder" },
+			groups: [{
+				name: "content",
+				title: "Content",
+				default: true
+			}, {
+				name: "behavior",
+				title: "Behavior"
+			}],
+			fields: [
+				{
+					name: "versions",
+					title: "Versions",
+					type: "array",
+					itemNoun: "version",
+					validation: { max: 6 },
+					description: "Leave empty to hide the switcher.",
+					of: [{
+						name: "version",
+						title: "Version",
+						type: "object",
+						icon: "versions",
+						openMode: "inline",
+						preview: {
+							title: "label",
+							subtitle: "status",
+							fallback: "Untitled version"
+						},
+						fields: [
+							{
+								name: "label",
+								title: "Label",
+								type: "string",
+								validation: {
+									required: true,
+									max: 16
+								},
+								placeholder: "v3"
+							},
+							{
+								name: "link",
+								title: "Docs home",
+								type: "link",
+								validation: { required: true }
+							},
+							{
+								name: "status",
+								title: "Status",
+								type: "select",
+								options: [
+									{
+										value: "current",
+										label: "Current"
+									},
+									{
+										value: "beta",
+										label: "Beta"
+									},
+									{
+										value: "legacy",
+										label: "Legacy",
+										description: "Shows an out-of-date warning on its pages"
+									}
+								]
+							}
+						]
+					}]
+				},
+				{
+					name: "searchPlaceholder",
+					title: "Search placeholder",
+					type: "string",
+					validation: { max: 40 },
+					placeholder: "Search docs"
+				},
+				{
+					name: "source",
+					title: "Tree comes from",
+					type: "select",
+					layout: "cards",
+					initialValue: "curated",
+					options: [{
+						value: "curated",
+						label: "Curated",
+						icon: "list-tree",
+						description: "You order sections and pages here"
+					}, {
+						value: "auto",
+						label: "Page tree",
+						icon: "folders",
+						description: "Follows the docs folder; new pages appear on their own"
+					}]
+				},
+				{
+					name: "root",
+					title: "Docs root page",
+					type: "reference",
+					reference: { to: ["page"] },
+					hidden: {
+						field: "source",
+						equals: "auto"
+					},
+					validation: { required: true },
+					description: "Every page under this one is listed, in folder order."
+				},
+				{
+					name: "sections",
+					title: "Sections",
+					type: "array",
+					itemNoun: "section",
+					hidden: {
+						field: "source",
+						equals: "curated"
+					},
+					validation: {
+						min: 1,
+						max: 12
+					},
+					of: [{
+						name: "section",
+						title: "Section",
+						type: "object",
+						icon: "folder",
+						preview: {
+							title: "title",
+							fallback: "Untitled section"
+						},
+						fields: [
+							{
+								name: "title",
+								title: "Section title",
+								type: "string",
+								validation: {
+									required: true,
+									max: 32
+								}
+							},
+							{
+								name: "icon",
+								title: "Icon",
+								type: "icon"
+							},
+							{
+								name: "isCollapsed",
+								title: "Start collapsed",
+								type: "boolean"
+							},
+							{
+								name: "pages",
+								title: "Pages",
+								type: "array",
+								itemNoun: "page",
+								validation: {
+									min: 1,
+									max: 30
+								},
+								of: [{
+									name: "docLink",
+									title: "Page",
+									type: "object",
+									icon: "file-text",
+									preview: {
+										title: "label",
+										subtitle: "badge",
+										fallback: "Untitled page"
+									},
+									fields: [
+										{
+											name: "label",
+											title: "Label",
+											type: "string",
+											validation: {
+												required: true,
+												max: 40
+											}
+										},
+										{
+											name: "link",
+											title: "Links to",
+											type: "link",
+											validation: { required: true }
+										},
+										{
+											name: "badge",
+											title: "Badge",
+											type: "select",
+											layout: "segmented",
+											options: [
+												{
+													value: "",
+													label: "None"
+												},
+												{
+													value: "new",
+													label: "New"
+												},
+												{
+													value: "beta",
+													label: "Beta"
+												},
+												{
+													value: "deprecated",
+													label: "Deprecated"
+												}
+											]
+										},
+										{
+											name: "children",
+											title: "Sub-pages",
+											type: "array",
+											itemNoun: "sub-page",
+											validation: { max: 15 },
+											description: "One level only.",
+											of: [{
+												name: "docSubLink",
+												title: "Sub-page",
+												type: "object",
+												icon: "file",
+												openMode: "inline",
+												preview: {
+													title: "label",
+													fallback: "Untitled sub-page"
+												},
+												fields: [{
+													name: "label",
+													title: "Label",
+													type: "string",
+													validation: {
+														required: true,
+														max: 40
+													}
+												}, {
+													name: "link",
+													title: "Links to",
+													type: "link",
+													validation: { required: true }
+												}]
+											}]
+										}
+									]
+								}]
+							}
+						]
+					}]
+				},
+				{
+					name: "footerLinks",
+					title: "Footer links",
+					type: "array",
+					itemNoun: "link",
+					validation: { max: 4 },
+					of: [navLink(24)]
+				},
+				{
+					name: "isCurrentOpen",
+					title: "Open the current section",
+					type: "boolean",
+					group: "behavior",
+					initialValue: true
+				},
+				{
+					name: "showPrevNext",
+					title: "Previous and next links",
+					type: "boolean",
+					group: "behavior",
+					initialValue: true
+				}
+			]
+		},
+		value: {
+			versions: [{
+				_key: "v1",
+				label: "v3",
+				link: page("/docs", "Docs"),
+				status: "current"
+			}, {
+				_key: "v2",
+				label: "v2",
+				link: page("/docs/v2", "Docs v2"),
+				status: "legacy"
+			}],
+			searchPlaceholder: "Search docs ⌘K",
+			source: "curated",
+			sections: [{
+				_key: "s1",
+				title: "Get started",
+				icon: "rocket",
+				isCollapsed: false,
+				pages: [{
+					_key: "p1",
+					label: "Quickstart",
+					link: page("/docs/quickstart", "Quickstart"),
+					badge: ""
+				}, {
+					_key: "p2",
+					label: "Install the agent",
+					link: page("/docs/install", "Install the agent"),
+					badge: "",
+					children: [
+						{
+							_key: "k1",
+							label: "Kubernetes",
+							link: page("/docs/install/kubernetes", "Kubernetes")
+						},
+						{
+							_key: "k2",
+							label: "Docker",
+							link: page("/docs/install/docker", "Docker")
+						},
+						{
+							_key: "k3",
+							label: "Bare metal",
+							link: page("/docs/install/linux", "Linux hosts")
+						}
+					]
+				}]
+			}, {
+				_key: "s2",
+				title: "Traces",
+				icon: "route",
+				isCollapsed: true,
+				pages: [
+					{
+						_key: "p3",
+						label: "Sampling rules",
+						link: page("/docs/traces/sampling", "Sampling rules"),
+						badge: "new"
+					},
+					{
+						_key: "p4",
+						label: "Service map",
+						link: page("/docs/traces/service-map", "Service map"),
+						badge: "beta"
+					},
+					{
+						_key: "p5",
+						label: "Legacy span API",
+						link: page("/docs/traces/span-api-v1", "Span API v1"),
+						badge: "deprecated"
+					}
+				]
+			}],
+			footerLinks: [{
+				_key: "f1",
+				label: "Changelog",
+				link: page("/changelog", "Changelog")
+			}, {
+				_key: "f2",
+				label: "Status",
+				link: {
+					type: "url",
+					href: "https://status.tideline.dev",
+					newTab: true
+				}
+			}],
+			isCurrentOpen: true,
+			showPrevNext: true
+		},
+		notes: {
+			why: "A docs sidebar is shared by every docs page, so it is a global. Most teams want BOTH modes: a curated order (what to read first) and an automatic tree (no one forgets to add the new page), so `source` decides which fields show. The tree is modelled to a FIXED depth — Section › Page › Sub-page — because our schema language has no recursive types; three levels is also the usability ceiling for a sidebar. Badges are a select (a fixed vocabulary the renderer can color and the search index can filter), not free text. Versions are a small inline array because each one is just a label, a link and a status.",
+			sanity: "Singleton `docsNav` { versions: array<object>, source: string, root: reference<page>, sections: array<object { title, icon, isCollapsed, pages: array<object { label, link: reference<docPage>, badge, children: array<object> }> }> } — Sanity CAN self-reference (`children: array<docLink>`), which is how it supports unlimited depth.",
+			htmlSignals: [
+				"<aside>/<nav aria-label=\"Docs\"> fixed to the left with a long nested <ul> and collapsible groups (<details>/<button aria-expanded>)",
+				"Group headings in small caps above lists of links whose hrefs share a /docs/ prefix",
+				"A version <select> or dropdown ('v3', 'latest') at the top; a search input with a ⌘K / Ctrl K hint",
+				"Pills like 'New', 'Beta', 'Deprecated' next to links",
+				"The same sidebar on every /docs/* page with the current link marked aria-current=page"
+			],
+			mcp: "Crawl 2+ /docs pages; identical sidebars → ONE global `docsSidebar`. If the tree order matches the URL/folder order exactly and there's no hand-written grouping → source: 'auto' with root = the docs index page; otherwise source: 'curated'. Group headings → sections[].title; links under them → pages[]; nested lists → children[] (flatten anything deeper into the sub-page level and report it). Pills → badge (map unknown text to '' and report). Version dropdown options → versions[] (status 'legacy' for anything not marked latest).",
+			pitfalls: ["Sidebars 4+ levels deep can't be represented — flatten to sub-pages and flag it rather than inventing nested objects.", "Don't import the 'On this page' table of contents — it's generated from each page's headings."]
+		}
+	},
+	{
+		id: "nav-ecommerce-header",
+		previewLayout: "nav",
+		label: "E-commerce header",
+		proves: "Search, account and cart config in one global · product references for search · app state (cart count) NOT modelled",
+		category: "Navigation & chrome",
+		tags: [
+			"global-synced",
+			"commerce",
+			"references",
+			"repeater",
+			"conditional",
+			"media-heavy"
+		],
+		brand: "Caldera",
+		syncedFrom: "Header",
+		schema: {
+			name: "storeHeader",
+			title: "Store header",
+			kind: "global",
+			icon: "layout-navbar",
+			category: "Navigation & chrome",
+			description: "Logo, category bar, search, account and cart. Synced across every page.",
+			variants: [{
+				id: "inline-search",
+				name: "Search in the bar",
+				description: "A wide search field between logo and icons"
+			}, {
+				id: "icon-search",
+				name: "Search icon",
+				description: "A magnifier that opens a full-width search"
+			}],
+			preview: {
+				title: "logoText",
+				media: "logo"
+			},
+			groups: [
+				{
+					name: "content",
+					title: "Content",
+					default: true
+				},
+				{
+					name: "search",
+					title: "Search"
+				},
+				{
+					name: "cart",
+					title: "Account & cart"
+				},
+				{
+					name: "design",
+					title: "Design"
+				}
+			],
+			fieldsets: [{
+				name: "brand",
+				title: "Brand"
+			}],
+			fields: [
+				...logoFields,
+				{
+					name: "categories",
+					title: "Categories",
+					type: "array",
+					itemNoun: "category",
+					validation: {
+						min: 1,
+						max: 8
+					},
+					of: [{
+						name: "category",
+						title: "Category",
+						type: "object",
+						icon: "category",
+						preview: {
+							title: "label",
+							subtitle: "link.href",
+							media: "thumbnail",
+							fallback: "Untitled category"
+						},
+						fields: [
+							{
+								name: "label",
+								title: "Label",
+								type: "string",
+								validation: {
+									required: true,
+									max: 20
+								}
+							},
+							{
+								name: "link",
+								title: "Links to",
+								type: "link",
+								validation: { required: true }
+							},
+							{
+								name: "thumbnail",
+								title: "Thumbnail",
+								type: "image"
+							},
+							{
+								name: "isHighlighted",
+								title: "Show in the sale color",
+								type: "boolean"
+							}
+						]
+					}]
+				},
+				{
+					name: "searchPlaceholder",
+					title: "Placeholder",
+					type: "string",
+					group: "search",
+					validation: { max: 48 }
+				},
+				{
+					name: "suggestions",
+					title: "Suggested searches",
+					type: "array",
+					itemNoun: "suggestion",
+					of: [{
+						name: "suggestion",
+						title: "Suggestion",
+						type: "string"
+					}],
+					group: "search",
+					validation: { max: 6 }
+				},
+				{
+					name: "popularProducts",
+					title: "Popular products",
+					type: "array",
+					group: "search",
+					itemNoun: "product",
+					validation: { max: 4 },
+					of: [{
+						name: "product",
+						title: "Product",
+						type: "reference",
+						reference: { to: ["shopify"] }
+					}]
+				},
+				{
+					name: "noResults",
+					title: "No results message",
+					type: "string",
+					group: "search",
+					validation: { max: 80 },
+					placeholder: "Nothing matched. Try \"skillet\" or \"kettle\"."
+				},
+				{
+					name: "accountLabel",
+					title: "Account label",
+					type: "string",
+					group: "cart",
+					initialValue: "Sign in",
+					validation: { max: 16 },
+					description: "Shown to signed-out visitors only."
+				},
+				{
+					name: "accountLink",
+					title: "Account page",
+					type: "link",
+					group: "cart"
+				},
+				{
+					name: "cartOpens",
+					title: "Cart opens",
+					type: "select",
+					group: "cart",
+					layout: "radio",
+					initialValue: "drawer",
+					options: [{
+						value: "drawer",
+						label: "A drawer",
+						description: "Slides in; people keep their place"
+					}, {
+						value: "page",
+						label: "The cart page"
+					}]
+				},
+				{
+					name: "emptyCart",
+					title: "Empty cart message",
+					type: "string",
+					group: "cart",
+					hidden: {
+						field: "cartOpens",
+						equals: "drawer"
+					},
+					validation: { max: 80 }
+				},
+				{
+					name: "drawerButton",
+					title: "Drawer button",
+					type: "button",
+					group: "cart",
+					hidden: {
+						field: "cartOpens",
+						equals: "drawer"
+					}
+				},
+				{
+					name: "isSticky",
+					title: "Stick to the top",
+					type: "boolean",
+					group: "design",
+					initialValue: true
+				},
+				{
+					name: "categoryBar",
+					title: "Category bar",
+					type: "select",
+					group: "design",
+					layout: "segmented",
+					initialValue: "below",
+					options: [{
+						value: "below",
+						label: "Below the logo"
+					}, {
+						value: "inline",
+						label: "Next to the logo"
+					}]
+				}
+			]
+		},
+		value: {
+			_variant: "inline-search",
+			logo: pic("caldera-mark", "Caldera", 240, 64),
+			logoText: "Caldera",
+			categories: [
+				{
+					_key: "c1",
+					label: "Skillets",
+					link: page("/collections/skillets", "Skillets"),
+					thumbnail: pic("caldera-skillet-thumb", "", 320, 320)
+				},
+				{
+					_key: "c2",
+					label: "Dutch ovens",
+					link: page("/collections/dutch-ovens", "Dutch ovens"),
+					thumbnail: pic("caldera-dutch-thumb", "", 320, 320)
+				},
+				{
+					_key: "c3",
+					label: "Grills",
+					link: page("/collections/grills", "Grills"),
+					thumbnail: pic("caldera-grill-thumb", "", 320, 320)
+				},
+				{
+					_key: "c4",
+					label: "Camp kitchen",
+					link: page("/collections/camp-kitchen", "Camp kitchen")
+				},
+				{
+					_key: "c5",
+					label: "Bundles",
+					link: page("/shop/bundles", "Bundles")
+				},
+				{
+					_key: "c6",
+					label: "Sale",
+					link: page("/collections/sale", "Sale"),
+					isHighlighted: true
+				}
+			],
+			searchPlaceholder: "Search skillets, grills, recipes",
+			suggestions: [
+				"cast iron skillet",
+				"dutch oven",
+				"seasoning",
+				"camp grill"
+			],
+			popularProducts: [
+				"gid://shopify/Product/8812",
+				"gid://shopify/Product/8813",
+				"gid://shopify/Product/8814"
+			],
+			noResults: "Nothing matched. Try “skillet” or “kettle”.",
+			accountLabel: "Sign in",
+			accountLink: page("/account", "Account"),
+			cartOpens: "drawer",
+			emptyCart: "Your cart is empty. The fire's still going.",
+			drawerButton: btn("Shop bestsellers", "/collections/bestsellers"),
+			isSticky: true,
+			categoryBar: "below"
+		},
+		notes: {
+			why: "Everything a store header SAYS is content; everything it COUNTS is app state. The cart count, the signed-in name and search results come from the commerce/session layer at runtime and are deliberately not fields. What remains — categories, search hints, empty states, which way the cart opens — is one global. Popular products are references (photos and prices stay live). Suggested searches are `tags` because they're short strings with no other properties. Groups follow the visitor's mental model (Content / Search / Account & cart) so the merchandiser doesn't wade through cart copy to change a category.",
+			sanity: "Singleton `storeHeader` { categories: array<object { label, link, thumbnail: image, highlight: boolean }>, search: object { placeholder, suggestions: array<string>, popularProducts: array<reference<product>> }, cart: object { opens: string, empty: string, cta } } with fieldset groups.",
+			htmlSignals: [
+				"Header with a search <input type=\"search\"> or <form role=\"search\"> plus account and bag/cart icons on the right",
+				"A cart icon with a numeric badge (e.g. <span class=\"cart-count\">2</span>) — runtime state",
+				"A row of collection links (/collections/…, /shop/…) under or beside the logo",
+				"Search dropdown markup with 'Popular searches' or 'Trending' lists and product tiles",
+				"A hidden cart drawer (<aside aria-label=\"Cart\"> / role=dialog) elsewhere in the DOM"
+			],
+			mcp: "Create ONE global `storeHeader`. Collection links → categories[] (a link colored red / labeled Sale → isHighlighted: true). Search placeholder → searchPlaceholder; 'Popular searches' text items → suggestions; product tiles inside the search dropdown → popularProducts resolved by handle to Shopify ids. A cart drawer element present → cartOpens: 'drawer' and copy its empty-state text/button into emptyCart/drawerButton. NEVER create fields for the cart count, prices, the customer name or currency — report them as runtime.",
+			pitfalls: ["Copying '(2)' from the cart badge into content is the most common converter mistake — it's session state.", "Free-shipping thresholds belong to commerce settings, not the header; reference them from the renderer."]
+		}
+	},
+	{
+		id: "nav-locale-header",
+		previewLayout: "nav",
+		label: "Multi-locale header with switchers",
+		proves: "Localized labels inside a global · switcher config with conditional lists · what belongs to site settings vs content",
+		category: "Navigation & chrome",
+		tags: [
+			"localized",
+			"global-synced",
+			"conditional",
+			"repeater"
+		],
+		brand: "Caldera",
+		syncedFrom: "Header",
+		schema: {
+			name: "multilingualHeader",
+			title: "Multilingual header",
+			kind: "global",
+			icon: "layout-navbar",
+			category: "Navigation & chrome",
+			description: "Main menu plus language and currency switchers. Labels are translated per locale.",
+			preview: {
+				title: "logoText",
+				media: "logo"
+			},
+			groups: [
+				{
+					name: "content",
+					title: "Content",
+					default: true
+				},
+				{
+					name: "switchers",
+					title: "Switchers"
+				},
+				{
+					name: "design",
+					title: "Design"
+				}
+			],
+			fieldsets: [{
+				name: "brand",
+				title: "Brand"
+			}],
+			fields: [
+				...logoFields,
+				{
+					name: "items",
+					title: "Menu items",
+					type: "array",
+					itemNoun: "menu item",
+					validation: {
+						min: 1,
+						max: 6
+					},
+					of: [{
+						name: "localizedLink",
+						title: "Link",
+						type: "object",
+						icon: "link",
+						openMode: "inline",
+						preview: {
+							title: "label",
+							subtitle: "link.href",
+							fallback: "Untitled link"
+						},
+						fields: [{
+							name: "label",
+							title: "Label",
+							type: "string",
+							localized: true,
+							validation: {
+								required: true,
+								max: 20
+							}
+						}, {
+							name: "link",
+							title: "Links to",
+							type: "link",
+							validation: { required: true },
+							description: "Each language opens its own translation."
+						}]
+					}]
+				},
+				{
+					name: "button",
+					title: "Button",
+					type: "button",
+					localized: true
+				},
+				{
+					name: "showLanguage",
+					title: "Language switcher",
+					type: "boolean",
+					group: "switchers",
+					initialValue: true
+				},
+				{
+					name: "languages",
+					title: "Languages",
+					type: "array",
+					group: "switchers",
+					itemNoun: "language",
+					hidden: {
+						field: "showLanguage",
+						equals: true
+					},
+					validation: {
+						min: 2,
+						max: 12
+					},
+					description: "Only languages the site is published in.",
+					of: [{
+						name: "language",
+						title: "Language",
+						type: "object",
+						icon: "language",
+						openMode: "inline",
+						preview: {
+							title: "nativeName",
+							subtitle: "locale",
+							fallback: "Untitled language"
+						},
+						fields: [{
+							name: "locale",
+							title: "Locale",
+							type: "select",
+							validation: {
+								required: true,
+								unique: true
+							},
+							options: [
+								{
+									value: "en-US",
+									label: "English (US)"
+								},
+								{
+									value: "en-GB",
+									label: "English (UK)"
+								},
+								{
+									value: "de-DE",
+									label: "German"
+								},
+								{
+									value: "fr-FR",
+									label: "French"
+								},
+								{
+									value: "ja-JP",
+									label: "Japanese"
+								}
+							]
+						}, {
+							name: "nativeName",
+							title: "Name in the menu",
+							type: "string",
+							validation: {
+								required: true,
+								max: 20
+							},
+							description: "In its own language, e.g. Deutsch."
+						}]
+					}]
+				},
+				{
+					name: "showCurrency",
+					title: "Currency switcher",
+					type: "boolean",
+					group: "switchers",
+					initialValue: true
+				},
+				{
+					name: "currencies",
+					title: "Currencies",
+					type: "multiselect",
+					group: "switchers",
+					hidden: {
+						field: "showCurrency",
+						equals: true
+					},
+					options: [
+						{
+							value: "USD",
+							label: "US dollar · $"
+						},
+						{
+							value: "EUR",
+							label: "Euro · €"
+						},
+						{
+							value: "GBP",
+							label: "Pound sterling · £"
+						},
+						{
+							value: "CAD",
+							label: "Canadian dollar · CA$"
+						},
+						{
+							value: "JPY",
+							label: "Japanese yen · ¥"
+						}
+					]
+				},
+				{
+					name: "firstVisit",
+					title: "On the first visit",
+					type: "select",
+					group: "switchers",
+					layout: "radio",
+					initialValue: "suggest",
+					options: [{
+						value: "suggest",
+						label: "Suggest a locale",
+						description: "A banner offers the visitor's language; nothing changes until they pick"
+					}, {
+						value: "stay",
+						label: "Stay on the address they opened"
+					}]
+				},
+				{
+					name: "suggestMessage",
+					title: "Suggestion message",
+					type: "string",
+					group: "switchers",
+					localized: true,
+					hidden: {
+						field: "firstVisit",
+						equals: "suggest"
+					},
+					validation: { max: 80 },
+					placeholder: "Looks like you're in Germany. Shop in Deutsch · EUR?"
+				},
+				{
+					name: "display",
+					title: "Switcher shows",
+					type: "select",
+					group: "design",
+					layout: "segmented",
+					initialValue: "code",
+					options: [
+						{
+							value: "code",
+							label: "EN · USD"
+						},
+						{
+							value: "name",
+							label: "English · $"
+						},
+						{
+							value: "globe",
+							label: "Globe icon"
+						}
+					]
+				},
+				{
+					name: "placement",
+					title: "Placement",
+					type: "select",
+					group: "design",
+					layout: "segmented",
+					initialValue: "header",
+					options: [
+						{
+							value: "header",
+							label: "Header"
+						},
+						{
+							value: "footer",
+							label: "Footer"
+						},
+						{
+							value: "both",
+							label: "Both"
+						}
+					]
+				}
+			]
+		},
+		value: {
+			logo: pic("caldera-mark", "Caldera", 240, 64),
+			logoText: "Caldera",
+			items: [
+				{
+					_key: "i1",
+					label: "Shop",
+					link: page("/products", "Products")
+				},
+				{
+					_key: "i2",
+					label: "Recipes",
+					link: page("/recipes", "Recipes")
+				},
+				{
+					_key: "i3",
+					label: "Stockists",
+					link: page("/retailers", "Retailers")
+				},
+				{
+					_key: "i4",
+					label: "About",
+					link: page("/about", "About")
+				}
+			],
+			button: btn("Shop the Fold", "/products/cable-fold"),
+			showLanguage: true,
+			languages: [
+				{
+					_key: "g1",
+					locale: "en-US",
+					nativeName: "English"
+				},
+				{
+					_key: "g2",
+					locale: "de-DE",
+					nativeName: "Deutsch"
+				},
+				{
+					_key: "g3",
+					locale: "fr-FR",
+					nativeName: "Français"
+				},
+				{
+					_key: "g4",
+					locale: "ja-JP",
+					nativeName: "日本語"
+				}
+			],
+			showCurrency: true,
+			currencies: [
+				"USD",
+				"EUR",
+				"GBP",
+				"JPY"
+			],
+			firstVisit: "suggest",
+			suggestMessage: "Looks like you're in Germany. Shop in Deutsch · EUR?",
+			display: "code",
+			placement: "header"
+		},
+		notes: {
+			why: "Labels are `localized: true` (one field, a value per locale) instead of one header per language: the menu STRUCTURE is shared, only the words change, so adding a link once adds it everywhere. Links point at pages, and the router resolves each locale's translation — no per-locale URLs typed in. The switcher's lists are content today because the site owner curates order and native names, but they mirror what should be site settings (published locales, enabled currencies) — see the gap note. Display (codes vs names) and placement are Design.",
+			sanity: "Field-level i18n with `sanity-plugin-internationalized-array`: `label: internationalizedArrayString`; locales defined in plugin config, not in the document. Or document-level i18n (one header doc per language via @sanity/document-internationalization).",
+			htmlSignals: [
+				"<html lang> differs across crawled URLs (/de/, /fr/ prefixes or subdomains) while the header markup is identical",
+				"A dropdown listing language names in their own script (Deutsch, Français, 日本語) and/or currency codes/symbols",
+				"<link rel=\"alternate\" hreflang=\"…\"> tags in <head> (native SEO — don't model them)",
+				"A 'Shop in your language?' geo banner or modal"
+			],
+			mcp: "Crawl the same page in each locale. Header with identical structure → ONE global; for each nav label, write the per-locale strings into the localized `label` (match items by href position, not by text). Language dropdown options → languages[] { locale from hreflang/path prefix, nativeName: the option text }. Currency options → currencies (ISO codes). Never model hreflang tags — the platform emits them. If headers differ structurally by locale (different items), report it: that's a per-market header, not a translation.",
+			pitfalls: ["Using flags for languages (🇬🇧 for English) — map to codes and set display: 'code'.", "Translating the link target by typing /de/... URLs — link to the page and let locale routing resolve it."]
+		}
+	},
+	{
+		id: "sticky-mobile-cta-bar",
+		previewLayout: "banner",
+		label: "Sticky bottom CTA bar (mobile)",
+		proves: "A per-template block with breakpoint visibility, scroll triggers and a secondary contact action",
+		category: "Navigation & chrome",
+		tags: [
+			"responsive-layout",
+			"conditional",
+			"validation",
+			"commerce"
+		],
+		brand: "Caldera",
+		schema: {
+			name: "stickyBar",
+			title: "Sticky action bar",
+			kind: "block",
+			icon: "layout-bottombar-expand",
+			category: "Navigation & chrome",
+			description: "A bar pinned to the bottom of the screen with one main action.",
+			preview: {
+				title: "message",
+				subtitle: "button.label"
+			},
+			groups: [
+				{
+					name: "content",
+					title: "Content",
+					default: true
+				},
+				{
+					name: "behavior",
+					title: "Behavior"
+				},
+				{
+					name: "design",
+					title: "Design"
+				}
+			],
+			fields: [
+				{
+					name: "message",
+					title: "Message",
+					type: "string",
+					validation: {
+						recommendedMax: 40,
+						max: 60
+					},
+					ai: true
+				},
+				{
+					name: "showPrice",
+					title: "Show the product price",
+					type: "boolean",
+					description: "Product pages only."
+				},
+				{
+					name: "button",
+					title: "Button",
+					type: "button",
+					validation: { required: true }
+				},
+				{
+					name: "secondaryAction",
+					title: "Second action",
+					type: "select",
+					layout: "segmented",
+					initialValue: "none",
+					options: [
+						{
+							value: "none",
+							label: "None"
+						},
+						{
+							value: "call",
+							label: "Call"
+						},
+						{
+							value: "chat",
+							label: "Chat"
+						}
+					]
+				},
+				{
+					name: "phone",
+					title: "Phone",
+					type: "link",
+					hidden: {
+						field: "secondaryAction",
+						equals: "call"
+					},
+					validation: { required: true }
+				},
+				{
+					name: "showOn",
+					title: "Show on",
+					type: "multiselect",
+					group: "behavior",
+					initialValue: ["mobile"],
+					validation: { min: 1 },
+					options: [
+						{
+							value: "mobile",
+							label: "Phones"
+						},
+						{
+							value: "tablet",
+							label: "Tablets"
+						},
+						{
+							value: "desktop",
+							label: "Desktop"
+						}
+					]
+				},
+				{
+					name: "trigger",
+					title: "Appears",
+					type: "select",
+					group: "behavior",
+					layout: "radio",
+					initialValue: "pastHero",
+					options: [
+						{
+							value: "always",
+							label: "Right away"
+						},
+						{
+							value: "pastHero",
+							label: "After the first section scrolls away",
+							description: "Avoids two identical buttons on screen"
+						},
+						{
+							value: "percent",
+							label: "After part of the page"
+						}
+					]
+				},
+				{
+					name: "percent",
+					title: "Scrolled",
+					type: "number",
+					group: "behavior",
+					layout: "slider",
+					hidden: {
+						field: "trigger",
+						equals: "percent"
+					},
+					numeric: {
+						min: 10,
+						max: 90,
+						step: 5,
+						unit: "%"
+					},
+					initialValue: 30
+				},
+				{
+					name: "hideNearFooter",
+					title: "Hide near the footer",
+					type: "boolean",
+					group: "behavior",
+					initialValue: true
+				},
+				themeField
+			]
+		},
+		value: {
+			message: "Cable Fold Grill · ships in 1–2 days",
+			showPrice: true,
+			button: btn("Add to cart", "#buy", "primary"),
+			secondaryAction: "chat",
+			showOn: ["mobile", "tablet"],
+			trigger: "pastHero",
+			percent: 30,
+			hideNearFooter: true,
+			theme: "dark"
+		},
+		notes: {
+			why: "Unlike the header, this bar is placed per template (product pages, a landing page), so it's an ordinary block, not a global. Breakpoint visibility is a multiselect because our schema has no per-breakpoint value type — this is the honest minimum (see gaps). The price is a switch, not a number: it's read live from the product the page is about. The second action is a select with a conditional phone link, so a chat action doesn't ask for a number it won't use.",
+			sanity: "object `stickyCta` { message: string, showPrice: boolean, button: object, secondary: string(list), phone: string (hidden unless call), showOn: array<string>(list), trigger: string, percent: number }.",
+			htmlSignals: [
+				"A fixed element at bottom: 0 with a single prominent button, often display:none ≥ 768px",
+				"IntersectionObserver / scroll listener toggling a class like is-visible on the bar",
+				"Duplicates the main CTA text from the hero or buy box",
+				"env(safe-area-inset-bottom) padding"
+			],
+			mcp: "position: fixed + bottom: 0 + one button → `stickyBar`, placed on the template it appears on (not global unless it's on every page). Read media queries for showOn. A scroll listener tied to the hero → trigger: 'pastHero'. Copy the price only as showPrice: true; never the number. If the button submits a cart form, keep href '#buy' and report that the renderer must wire it to the product's add-to-cart.",
+			pitfalls: ["'Add to cart' is an ACTION, not a link — our button type only carries links (gap: action buttons).", "A bar covering the cookie banner or chat launcher: the renderer must stack them; nothing to model."]
+		}
+	},
+	{
+		id: "announcement-countdown",
+		previewLayout: "banner",
+		label: "Announcement bar with countdown",
+		proves: "Scheduled global with time zone · countdown with an after-end state · dismiss memory · rotating messages",
+		category: "Navigation & chrome",
+		tags: [
+			"global-synced",
+			"conditional",
+			"validation",
+			"repeater",
+			"localized",
+			"a11y"
+		],
+		brand: "Caldera",
+		syncedFrom: "Announcement bar",
+		schema: {
+			name: "countdownBar",
+			title: "Countdown bar",
+			kind: "global",
+			icon: "alarm",
+			category: "Navigation & chrome",
+			description: "A strip above the header for a sale or launch, with an optional countdown.",
+			preview: {
+				title: "messages.0.text",
+				subtitle: "countdown.endsAt"
+			},
+			groups: [
+				{
+					name: "content",
+					title: "Content",
+					default: true
+				},
+				{
+					name: "schedule",
+					title: "Schedule"
+				},
+				{
+					name: "design",
+					title: "Design"
+				}
+			],
+			fields: [
+				{
+					name: "messages",
+					title: "Messages",
+					type: "array",
+					itemNoun: "message",
+					validation: {
+						min: 1,
+						max: 3
+					},
+					description: "Messages rotate every 5 seconds.",
+					of: [{
+						name: "message",
+						title: "Message",
+						type: "object",
+						icon: "message",
+						openMode: "inline",
+						preview: {
+							title: "text",
+							subtitle: "link.href",
+							fallback: "Untitled message"
+						},
+						fields: [{
+							name: "text",
+							title: "Text",
+							type: "string",
+							localized: true,
+							ai: true,
+							validation: {
+								required: true,
+								max: 80,
+								recommendedMax: 60
+							}
+						}, {
+							name: "link",
+							title: "Links to",
+							type: "link"
+						}]
+					}]
+				},
+				{
+					name: "countdown",
+					title: "Countdown",
+					type: "object",
+					icon: "clock",
+					openMode: "drill",
+					fields: [
+						{
+							name: "showCountdown",
+							title: "Show a countdown",
+							type: "boolean"
+						},
+						{
+							name: "endsAt",
+							title: "Counts down to",
+							type: "datetime",
+							hidden: {
+								field: "showCountdown",
+								equals: true
+							},
+							validation: { required: true },
+							description: "In the sale's time zone. Visitors see their local time."
+						},
+						{
+							name: "label",
+							title: "Label",
+							type: "string",
+							hidden: {
+								field: "showCountdown",
+								equals: true
+							},
+							validation: { max: 20 },
+							placeholder: "Ends in"
+						},
+						{
+							name: "afterEnd",
+							title: "When it reaches zero",
+							type: "select",
+							hidden: {
+								field: "showCountdown",
+								equals: true
+							},
+							layout: "radio",
+							initialValue: "hide",
+							options: [{
+								value: "hide",
+								label: "Hide the bar"
+							}, {
+								value: "message",
+								label: "Show a different message"
+							}]
+						},
+						{
+							name: "endedText",
+							title: "Message after the end",
+							type: "string",
+							localized: true,
+							hidden: {
+								field: "afterEnd",
+								equals: "message"
+							},
+							validation: { max: 80 },
+							placeholder: "The sale has ended. Thanks for shopping."
+						}
+					]
+				},
+				{
+					name: "isDismissible",
+					title: "Visitors can close it",
+					type: "boolean",
+					initialValue: true
+				},
+				{
+					name: "rememberDays",
+					title: "Stay closed for",
+					type: "number",
+					hidden: {
+						field: "isDismissible",
+						equals: true
+					},
+					numeric: {
+						min: 1,
+						max: 90,
+						step: 1,
+						unit: "days"
+					},
+					initialValue: 7,
+					description: "Changing the message shows it again to people who closed it."
+				},
+				{
+					name: "startsAt",
+					title: "Show from",
+					type: "datetime",
+					group: "schedule",
+					description: "Leave empty to show it as soon as it's published."
+				},
+				{
+					name: "endsAt",
+					title: "Hide after",
+					type: "datetime",
+					group: "schedule",
+					description: "Must be on or after the countdown's end."
+				},
+				{
+					name: "tone",
+					title: "Color",
+					type: "select",
+					group: "design",
+					layout: "segmented",
+					initialValue: "brand",
+					options: [
+						{
+							value: "neutral",
+							label: "Neutral"
+						},
+						{
+							value: "brand",
+							label: "Brand"
+						},
+						{
+							value: "sale",
+							label: "Sale"
+						}
+					]
+				},
+				{
+					name: "usePauseOnHover",
+					title: "Pause on hover and focus",
+					type: "boolean",
+					group: "design",
+					initialValue: true,
+					access: { edit: "schema.manage" },
+					lockReason: "Required for accessibility: moving content must be pausable."
+				}
+			]
+		},
+		value: {
+			messages: [{
+				_key: "a1",
+				text: "Black Friday: 25% off every skillet and Dutch oven",
+				link: page("/collections/sale", "Sale")
+			}, {
+				_key: "a2",
+				text: "Free shipping over $80 · Order by Dec 18 for the holidays",
+				link: page("/shipping", "Shipping & returns")
+			}],
+			countdown: {
+				showCountdown: true,
+				endsAt: "2026-11-30T23:59:00-08:00[America/Los_Angeles]",
+				label: "Ends in",
+				afterEnd: "message",
+				endedText: "The sale has ended — thanks for cooking with us."
+			},
+			isDismissible: true,
+			rememberDays: 3,
+			startsAt: "2026-11-26T00:00:00-08:00[America/Los_Angeles]",
+			endsAt: "2026-12-02T23:59:00-08:00[America/Los_Angeles]",
+			tone: "sale",
+			usePauseOnHover: true
+		},
+		notes: {
+			why: "A standalone global (not part of the header) because it has its own lifecycle: scheduled on and off, often swapped weekly while the header stays put. Messages are a small array so rotation is data, not a hack of joined strings. The countdown is an object with an `showCountdown` switch whose fields appear only when it's on, including what happens at zero — the moment most hand-built bars break. Dismissal is behavior that belongs to the content (how long a closed bar stays closed). The pause control is locked on for marketers because WCAG 2.2.2 requires moving content to be pausable.",
+			sanity: "Singleton `countdownBar` { messages: array<object { text, link }>, countdown: object { enabled, endsAt: datetime, label, afterEnd, endedText }, dismissible: boolean, rememberDays: number, startsAt/endsAt: datetime }. Scheduling would usually be Sanity's Scheduled Publishing instead of fields.",
+			htmlSignals: [
+				"A full-width strip above <header> with one sentence and a close (×) <button aria-label=\"Close\">",
+				"Digits ticking every second (setInterval) formatted as 02d 14h 05m, plus an end timestamp in a data attribute",
+				"localStorage/cookie key like announcement_dismissed",
+				"Several messages in a track with translateX/opacity animation — rotation"
+			],
+			mcp: "Separate global `countdownBar`, independent from the header. Each rotating text → messages[] { text, link }. A countdown's target timestamp (data-end, a Date string in the script) → countdown.endsAt WITH its offset; never store the rendered '02d 14h'. A close button → isDismissible: true; a cookie/localStorage max-age → rememberDays. If the script hides the bar at zero → afterEnd: 'hide'. Map red/sale colors to tone: 'sale'.",
+			pitfalls: ["Storing the countdown as text ('2 days left') — it's wrong the next day. Always a datetime with offset.", "Hide-after earlier than the countdown end can't be caught today (gap: cross-field validation)."]
+		}
+	},
+	{
+		id: "cookie-consent",
+		previewLayout: "banner",
+		label: "Cookie consent banner",
+		proves: "Consent categories as data · action labels that are NOT links · developer-locked keys · localized legal copy",
+		category: "Navigation & chrome",
+		tags: [
+			"global-synced",
+			"repeater",
+			"validation",
+			"a11y",
+			"localized",
+			"conditional",
+			"variants"
+		],
+		brand: "Open Water Trust",
+		syncedFrom: "Cookie consent",
+		schema: {
+			name: "cookieBanner",
+			title: "Cookie banner",
+			kind: "global",
+			icon: "cookie",
+			category: "Navigation & chrome",
+			description: "The consent banner and its preferences panel. Shown until a visitor chooses.",
+			variants: [
+				{
+					id: "bar",
+					name: "Bottom bar",
+					description: "Full width, doesn't block the page"
+				},
+				{
+					id: "box",
+					name: "Corner box",
+					description: "Small card in the bottom-left corner"
+				},
+				{
+					id: "modal",
+					name: "Centered modal",
+					description: "Blocks the page until a choice is made"
+				}
+			],
+			preview: {
+				title: "title",
+				subtitle: "body"
+			},
+			groups: [
+				{
+					name: "content",
+					title: "Banner",
+					default: true
+				},
+				{
+					name: "categories",
+					title: "Categories"
+				},
+				{
+					name: "settings",
+					title: "Settings"
+				}
+			],
+			fields: [
+				{
+					name: "title",
+					title: "Title",
+					type: "string",
+					localized: true,
+					validation: { max: 48 },
+					placeholder: "We use cookies"
+				},
+				{
+					name: "body",
+					title: "Body",
+					type: "text",
+					rows: 3,
+					localized: true,
+					validation: {
+						required: true,
+						recommendedMax: 220
+					}
+				},
+				{
+					name: "policyLink",
+					title: "Cookie policy",
+					type: "link",
+					validation: { required: true },
+					description: "Most privacy laws require it."
+				},
+				{
+					name: "labels",
+					title: "Button labels",
+					type: "object",
+					icon: "click",
+					openMode: "drill",
+					fields: [
+						{
+							name: "acceptAll",
+							title: "Accept all",
+							type: "string",
+							localized: true,
+							validation: {
+								required: true,
+								max: 20
+							},
+							initialValue: "Accept all"
+						},
+						{
+							name: "rejectAll",
+							title: "Reject all",
+							type: "string",
+							localized: true,
+							validation: {
+								required: true,
+								max: 20
+							},
+							initialValue: "Reject all"
+						},
+						{
+							name: "customize",
+							title: "Open preferences",
+							type: "string",
+							localized: true,
+							validation: {
+								required: true,
+								max: 24
+							},
+							initialValue: "Choose cookies"
+						},
+						{
+							name: "save",
+							title: "Save preferences",
+							type: "string",
+							localized: true,
+							validation: {
+								required: true,
+								max: 24
+							},
+							initialValue: "Save my choices"
+						}
+					]
+				},
+				{
+					name: "categories",
+					title: "Categories",
+					type: "array",
+					group: "categories",
+					itemNoun: "category",
+					validation: {
+						min: 1,
+						max: 6
+					},
+					of: [{
+						name: "category",
+						title: "Category",
+						type: "object",
+						icon: "toggle-right",
+						preview: {
+							title: "label",
+							subtitle: "key",
+							fallback: "Untitled category"
+						},
+						fields: [
+							{
+								name: "key",
+								title: "Key",
+								type: "string",
+								access: { edit: "schema.manage" },
+								lockReason: "Scripts check this key before they load.",
+								validation: {
+									required: true,
+									unique: true,
+									pattern: "^[a-z][a-z_]*$",
+									patternMessage: "Use lowercase letters and underscores, like analytics_storage."
+								}
+							},
+							{
+								name: "label",
+								title: "Label",
+								type: "string",
+								localized: true,
+								validation: {
+									required: true,
+									max: 32
+								}
+							},
+							{
+								name: "description",
+								title: "What it covers",
+								type: "text",
+								rows: 2,
+								localized: true,
+								validation: {
+									required: true,
+									recommendedMax: 200
+								}
+							},
+							{
+								name: "isRequired",
+								title: "Always on",
+								type: "boolean",
+								description: "Visitors can't switch it off."
+							},
+							{
+								name: "isOnByDefault",
+								title: "On by default",
+								type: "boolean",
+								hidden: {
+									field: "isRequired",
+									equals: false
+								},
+								description: "Must stay off in the EU and UK for anything but essential cookies."
+							}
+						]
+					}]
+				},
+				{
+					name: "showTo",
+					title: "Show the banner to",
+					type: "select",
+					group: "settings",
+					layout: "radio",
+					initialValue: "everyone",
+					options: [{
+						value: "everyone",
+						label: "Everyone"
+					}, {
+						value: "regulated",
+						label: "Visitors in regions that require consent",
+						description: "EU, UK, Switzerland, Brazil, California"
+					}]
+				},
+				{
+					name: "useGpcSignal",
+					title: "Honor Global Privacy Control",
+					type: "boolean",
+					group: "settings",
+					initialValue: true,
+					description: "Browsers that send GPC start with optional cookies off."
+				},
+				{
+					name: "renewMonths",
+					title: "Ask again after",
+					type: "number",
+					group: "settings",
+					numeric: {
+						min: 1,
+						max: 13,
+						step: 1,
+						unit: "months"
+					},
+					initialValue: 12,
+					description: "EU regulators expect 13 months at most."
+				}
+			]
+		},
+		value: {
+			_variant: "bar",
+			title: "Cookies, briefly",
+			body: "We use essential cookies to run this site and, if you agree, analytics to see which stories help rivers most. We never sell your data.",
+			policyLink: page("/privacy/cookies", "Cookie policy"),
+			labels: {
+				acceptAll: "Accept all",
+				rejectAll: "Reject all",
+				customize: "Choose cookies",
+				save: "Save my choices"
+			},
+			categories: [
+				{
+					_key: "c1",
+					key: "essential",
+					label: "Essential",
+					description: "Keeps you signed in and remembers this choice. Always on.",
+					isRequired: true
+				},
+				{
+					_key: "c2",
+					key: "analytics",
+					label: "Analytics",
+					description: "Plausible and Google Analytics, to count visits and see which pages people read.",
+					isRequired: false,
+					isOnByDefault: false
+				},
+				{
+					_key: "c3",
+					key: "marketing",
+					label: "Marketing",
+					description: "Meta Pixel, to show our campaigns to people who visited — and to measure if they work.",
+					isRequired: false,
+					isOnByDefault: false
+				}
+			],
+			showTo: "everyone",
+			useGpcSignal: true,
+			renewMonths: 12
+		},
+		notes: {
+			why: "Consent is legal copy plus a contract with the site's scripts, so the two halves are modelled differently: categories are an array of objects whose `key` is developer-locked (scripts gate on it) while labels and descriptions are localized and editable. 'Accept all' and 'Reject all' are STRINGS, not buttons — our `button` type is label + link and these don't navigate. Layout (bar/box/modal) is a block variant, not a field, because it changes the component not the copy. It's a global: one consent UI for the whole site.",
+			sanity: "Singleton `cookieBanner` { title, body: text, policyLink, labels: object { acceptAll, rejectAll, customize, save: string }, categories: array<object { key: string (readOnly for non-admins), label, description, required, defaultOn }> }.",
+			htmlSignals: [
+				"A fixed bottom/corner element or role=dialog with the words cookie/consent/privacy and 2–3 buttons (Accept / Reject / Preferences)",
+				"A second hidden panel with toggles (<input type=\"checkbox\" role=\"switch\">) per category",
+				"Scripts with type=\"text/plain\" and data-category=\"analytics\" (a consent manager pattern)",
+				"A cookie like cookie_consent / cc_cookie / OptanonConsent"
+			],
+			mcp: "Create ONE global `cookieBanner`. Banner heading/body → title/body; the policy <a> → policyLink. Button TEXTS → labels.* (never buttons). Each toggle in the preferences panel → categories[] { key from data-category/name attribute, label, description, required: disabled+checked toggle }. If the site uses a third-party CMP (OneTrust, Cookiebot) via a script tag, report it instead of modelling — that content lives in the vendor's dashboard.",
+			pitfalls: ["Pre-ticked optional categories are unlawful in the EU — the converter must set isOnByDefault: false and report any source that pre-ticks.", "A 'Reject all' hidden behind 'Preferences' is a dark pattern; flag it, don't replicate it."]
+		}
+	},
+	{
+		id: "breadcrumb-config",
+		previewLayout: "banner",
+		label: "Breadcrumb trail",
+		proves: "A mostly-automatic block: trail from the page tree, manual override only when needed · native JSON-LD",
+		category: "Navigation & chrome",
+		tags: [
+			"conditional",
+			"seo-structured",
+			"a11y",
+			"references",
+			"repeater"
+		],
+		brand: "Caldera",
+		schema: {
+			name: "breadcrumbs",
+			title: "Breadcrumbs",
+			kind: "block",
+			icon: "chevrons-right",
+			category: "Navigation & chrome",
+			description: "The trail of links back up to home. Built from where the page sits.",
+			preview: {
+				title: "source",
+				subtitle: "homeLabel"
+			},
+			groups: DESIGN_GROUPS,
+			fields: [
+				{
+					name: "source",
+					title: "Trail comes from",
+					type: "select",
+					layout: "cards",
+					initialValue: "auto",
+					options: [{
+						value: "auto",
+						label: "Where the page sits",
+						icon: "sitemap",
+						description: "Folders and parent pages, updated on its own"
+					}, {
+						value: "manual",
+						label: "Written here",
+						icon: "pencil",
+						description: "For pages whose address doesn't match the trail"
+					}]
+				},
+				{
+					name: "parent",
+					title: "Treat as a child of",
+					type: "reference",
+					reference: { to: ["page"] },
+					hidden: {
+						field: "source",
+						equals: "auto"
+					}
+				},
+				{
+					name: "crumbs",
+					title: "Crumbs",
+					type: "array",
+					itemNoun: "crumb",
+					hidden: {
+						field: "source",
+						equals: "manual"
+					},
+					validation: {
+						min: 1,
+						max: 5
+					},
+					description: "Home and the current page are added for you.",
+					of: [navLink(32)]
+				},
+				{
+					name: "homeLabel",
+					title: "Home label",
+					type: "string",
+					validation: { max: 16 },
+					initialValue: "Home",
+					description: "Leave empty to show a house icon."
+				},
+				{
+					name: "showCurrent",
+					title: "Show the current page",
+					type: "boolean",
+					initialValue: true
+				},
+				{
+					name: "separator",
+					title: "Separator",
+					type: "select",
+					group: "design",
+					layout: "segmented",
+					initialValue: "chevron",
+					options: [
+						{
+							value: "chevron",
+							label: "›"
+						},
+						{
+							value: "slash",
+							label: "/"
+						},
+						{
+							value: "dot",
+							label: "·"
+						}
+					]
+				},
+				{
+					name: "collapseAfter",
+					title: "Shorten trails longer than",
+					type: "number",
+					group: "design",
+					numeric: {
+						min: 3,
+						max: 6,
+						step: 1,
+						unit: "crumbs"
+					},
+					initialValue: 4,
+					description: "Phones only."
+				}
+			]
+		},
+		value: {
+			source: "auto",
+			parent: "pg_cablefold",
+			homeLabel: "Home",
+			showCurrent: true,
+			separator: "chevron",
+			collapseAfter: 4
+		},
+		notes: {
+			why: "Breadcrumbs are derived data — the right default is 'from the page tree' with zero typing, so the block is mostly settings. A manual `crumbs` array appears only when `source` is manual (campaign pages whose URL doesn't match their place in the IA). `parent` is a reference so a product can sit under its collection even when the URL is flat. The BreadcrumbList JSON-LD is emitted natively from the SAME resolved trail, so there is no schema/SEO field here — modelling one would create a second truth.",
+			sanity: "Usually not modelled in Sanity — computed in the frontend from slugs; when overridden: `breadcrumbs: array<object { label, link: reference }>` on the page document.",
+			htmlSignals: [
+				"<nav aria-label=\"Breadcrumb\"> with an <ol> of <a> separated by › or /",
+				"The last item has aria-current=\"page\" and isn't a link",
+				"JSON-LD script with \"@type\": \"BreadcrumbList\" (native — read it to verify, don't model it)",
+				"Appears directly above the H1 on inner pages, absent on home"
+			],
+			mcp: "If every crumb's href is a prefix of the current URL path → source: 'auto' and model nothing else. Otherwise → source: 'manual', crumbs = the middle crumbs (drop Home and the current page). Read separator glyph → separator. Never create JSON-LD fields; verify the platform output matches the source's BreadcrumbList instead.",
+			pitfalls: ["Importing the full trail per page as manual data — it rots the first time a page moves. Prefer auto.", "A breadcrumb that's really a 'Back to results' link is navigation state, not a trail."]
+		}
+	},
+	{
+		id: "footer-multi-column",
+		previewLayout: "footer",
+		label: "Multi-column footer",
+		proves: "Link groups · newsletter as a form reference · social profiles · legal row with a year token · payment badges as a fixed set",
+		category: "Navigation & chrome",
+		tags: [
+			"global-synced",
+			"repeater",
+			"references",
+			"form",
+			"validation",
+			"commerce"
+		],
+		brand: "Caldera",
+		syncedFrom: "Footer",
+		schema: {
+			name: "footer",
+			title: "Footer",
+			kind: "global",
+			icon: "layout-bottombar",
+			category: "Navigation & chrome",
+			description: "Link columns, newsletter sign-up, social links and the legal row. Synced across every page.",
+			variants: [{
+				id: "columns",
+				name: "Columns",
+				description: "Brand and newsletter left, link columns right"
+			}, {
+				id: "stacked",
+				name: "Newsletter on top",
+				description: "A full-width sign-up band above the columns"
+			}],
+			preview: {
+				title: "tagline",
+				media: "logo"
+			},
+			groups: [
+				{
+					name: "content",
+					title: "Links",
+					default: true
+				},
+				{
+					name: "newsletter",
+					title: "Newsletter"
+				},
+				{
+					name: "legal",
+					title: "Legal"
+				},
+				{
+					name: "design",
+					title: "Design"
+				}
+			],
+			fields: [
+				{
+					name: "logo",
+					title: "Logo",
+					type: "image"
+				},
+				{
+					name: "tagline",
+					title: "Tagline",
+					type: "text",
+					rows: 2,
+					validation: { recommendedMax: 120 },
+					ai: true
+				},
+				{
+					name: "groups",
+					title: "Link groups",
+					type: "array",
+					itemNoun: "group",
+					validation: {
+						min: 1,
+						max: 5
+					},
+					of: [linkGroup(8)]
+				},
+				{
+					name: "socialLinks",
+					title: "Social profiles",
+					type: "array",
+					itemNoun: "profile",
+					validation: { max: 6 },
+					of: [socialItem]
+				},
+				{
+					name: "newsletterHeading",
+					title: "Heading",
+					type: "string",
+					group: "newsletter",
+					validation: { max: 48 }
+				},
+				{
+					name: "newsletterBody",
+					title: "Body",
+					type: "text",
+					group: "newsletter",
+					rows: 2,
+					validation: { recommendedMax: 140 }
+				},
+				{
+					name: "newsletterForm",
+					title: "Form",
+					type: "reference",
+					group: "newsletter",
+					reference: { to: ["form"] }
+				},
+				{
+					name: "legalLinks",
+					title: "Legal links",
+					type: "array",
+					group: "legal",
+					itemNoun: "link",
+					validation: { max: 6 },
+					of: [navLink(28)]
+				},
+				{
+					name: "copyright",
+					title: "Copyright line",
+					type: "string",
+					group: "legal",
+					validation: { max: 80 },
+					description: "{year} becomes the current year.",
+					placeholder: "© {year} Caldera Cookware Co."
+				},
+				{
+					name: "payments",
+					title: "Payment badges",
+					type: "multiselect",
+					group: "legal",
+					options: [
+						{
+							value: "visa",
+							label: "Visa"
+						},
+						{
+							value: "mastercard",
+							label: "Mastercard"
+						},
+						{
+							value: "amex",
+							label: "American Express"
+						},
+						{
+							value: "apple-pay",
+							label: "Apple Pay"
+						},
+						{
+							value: "google-pay",
+							label: "Google Pay"
+						},
+						{
+							value: "shop-pay",
+							label: "Shop Pay"
+						},
+						{
+							value: "paypal",
+							label: "PayPal"
+						},
+						{
+							value: "klarna",
+							label: "Klarna"
+						}
+					]
+				},
+				themeField
+			]
+		},
+		value: {
+			_variant: "columns",
+			logo: pic("caldera-mark-light", "Caldera", 240, 64),
+			tagline: "Cookware built for the open fire. Forged in Bend, Oregon, and guaranteed for life.",
+			groups: [
+				{
+					_key: "g1",
+					title: "Shop",
+					links: [
+						{
+							_key: "a1",
+							label: "Skillets",
+							link: page("/collections/skillets", "Skillets")
+						},
+						{
+							_key: "a2",
+							label: "Dutch ovens",
+							link: page("/collections/dutch-ovens", "Dutch ovens")
+						},
+						{
+							_key: "a3",
+							label: "Grills",
+							link: page("/collections/grills", "Grills")
+						},
+						{
+							_key: "a4",
+							label: "Gift cards",
+							link: page("/gift-cards", "Gift cards")
+						}
+					]
+				},
+				{
+					_key: "g2",
+					title: "Help",
+					links: [
+						{
+							_key: "b1",
+							label: "Shipping & returns",
+							link: page("/shipping", "Shipping & returns")
+						},
+						{
+							_key: "b2",
+							label: "Lifetime warranty",
+							link: page("/warranty", "Warranty")
+						},
+						{
+							_key: "b3",
+							label: "Care guides",
+							link: page("/journal/cast-iron-care", "Cast iron care")
+						},
+						{
+							_key: "b4",
+							label: "Contact",
+							link: page("/contact", "Contact")
+						}
+					]
+				},
+				{
+					_key: "g3",
+					title: "Company",
+					links: [
+						{
+							_key: "c1",
+							label: "About",
+							link: page("/about", "About")
+						},
+						{
+							_key: "c2",
+							label: "Journal",
+							link: page("/journal", "Journal")
+						},
+						{
+							_key: "c3",
+							label: "Wholesale",
+							link: page("/wholesale", "Wholesale pricing")
+						},
+						{
+							_key: "c4",
+							label: "Careers",
+							link: page("/careers", "Careers")
+						}
+					]
+				}
+			],
+			socialLinks: [
+				{
+					_key: "s1",
+					platform: "instagram",
+					url: "https://instagram.com/caldera.cookware"
+				},
+				{
+					_key: "s2",
+					platform: "youtube",
+					url: "https://youtube.com/@calderacookware"
+				},
+				{
+					_key: "s3",
+					platform: "pinterest",
+					url: "https://pinterest.com/calderacookware"
+				}
+			],
+			newsletterHeading: "Recipes from the fire, monthly",
+			newsletterBody: "One email a month: a new recipe, a care tip and first word on launches. No spam.",
+			newsletterForm: "form_newsletter",
+			legalLinks: [
+				{
+					_key: "l1",
+					label: "Privacy",
+					link: page("/privacy", "Privacy policy")
+				},
+				{
+					_key: "l2",
+					label: "Terms",
+					link: page("/terms", "Terms of service")
+				},
+				{
+					_key: "l3",
+					label: "Accessibility",
+					link: page("/accessibility", "Accessibility")
+				}
+			],
+			copyright: "© {year} Caldera Cookware Co.",
+			payments: [
+				"visa",
+				"mastercard",
+				"amex",
+				"apple-pay",
+				"shop-pay"
+			],
+			theme: "dark"
+		},
+		notes: {
+			why: "One global, grouped by what people change together: Links, Newsletter, Legal. Link groups are an array of objects each holding an array of links — two levels, so the converter never flattens columns into one list. The newsletter is a REFERENCE to a form in Forms: fields, consent text, double opt-in and the destination (Mailchimp, Klaviyo) live in Forms, so the footer can't silently drop the consent checkbox. Payment badges are a multiselect from a fixed set because the renderer owns the official logos — authors pick, never upload. `{year}` keeps the copyright from going stale every January.",
+			sanity: "Singleton `footer` { tagline, groups: array<object { title, links: array<link> }>, social: array<object { platform, url }>, newsletter: object { heading, body, form: reference<form> }, legalLinks: array<link>, copyright: string, payments: array<string>(list) }.",
+			htmlSignals: [
+				"<footer> (role=contentinfo) with 3–5 lists of links, each under a small heading",
+				"A newsletter <form> with a single email input and a submit button",
+				"A row of social icons linking to instagram.com / youtube.com etc.",
+				"A bottom row with © year, Privacy/Terms links and a strip of card logos (svg titled Visa, Mastercard…)"
+			],
+			mcp: "ONE global `footer`. Each heading + <ul> → groups[] { title, links }. Social anchors → socialLinks[] { platform from the hostname, url }. A form with one email input → create/reuse a newsletter form and set newsletterForm to its id; its heading/paragraph → newsletterHeading/Body. © text → copyright with the 4-digit year replaced by {year}. Card logo <svg>/<img> titles → payments (unknown brands → report). Never model the form's inputs or hidden list ids in the footer.",
+			pitfalls: ["Flattening columns into one long links array loses the headings — keep groups.", "Uploading payment logos as images: they go stale and break brand rules. Use the fixed set."]
+		}
+	},
+	{
+		id: "footer-minimal",
+		previewLayout: "footer",
+		label: "Minimal footer",
+		proves: "The smallest useful global: one line of links, an email, socials, the year token — nothing invented",
+		category: "Navigation & chrome",
+		tags: [
+			"global-synced",
+			"repeater",
+			"validation"
+		],
+		brand: "Northbound Studio",
+		syncedFrom: "Footer",
+		schema: {
+			name: "compactFooter",
+			title: "Compact footer",
+			kind: "global",
+			icon: "layout-bottombar",
+			category: "Navigation & chrome",
+			description: "One row: a line of links, a contact email, social icons and the copyright.",
+			preview: { title: "copyright" },
+			groups: DESIGN_GROUPS,
+			fields: [
+				{
+					name: "statement",
+					title: "Sign-off",
+					type: "string",
+					validation: { max: 60 },
+					ai: true
+				},
+				{
+					name: "email",
+					title: "Contact email",
+					type: "link"
+				},
+				{
+					name: "links",
+					title: "Links",
+					type: "array",
+					itemNoun: "link",
+					validation: { max: 5 },
+					of: [navLink(20)]
+				},
+				{
+					name: "socialLinks",
+					title: "Social profiles",
+					type: "array",
+					itemNoun: "profile",
+					validation: { max: 4 },
+					of: [socialItem]
+				},
+				{
+					name: "copyright",
+					title: "Copyright line",
+					type: "string",
+					validation: { max: 60 },
+					description: "{year} becomes the current year."
+				},
+				{
+					name: "alignment",
+					title: "Alignment",
+					type: "select",
+					group: "design",
+					layout: "segmented",
+					initialValue: "between",
+					options: [{
+						value: "between",
+						label: "Spread"
+					}, {
+						value: "center",
+						label: "Centered"
+					}]
+				},
+				themeField
+			]
+		},
+		value: {
+			statement: "Let's make something worth keeping.",
+			email: {
+				type: "email",
+				href: "mailto:hello@northbound.studio",
+				email: "hello@northbound.studio",
+				subject: "New project"
+			},
+			links: [
+				{
+					_key: "l1",
+					label: "Work",
+					link: page("/work", "Work")
+				},
+				{
+					_key: "l2",
+					label: "Studio",
+					link: page("/studio", "Studio")
+				},
+				{
+					_key: "l3",
+					label: "Careers",
+					link: page("/careers", "Careers")
+				},
+				{
+					_key: "l4",
+					label: "Privacy",
+					link: page("/privacy", "Privacy")
+				}
+			],
+			socialLinks: [
+				{
+					_key: "s1",
+					platform: "instagram",
+					url: "https://instagram.com/northbound.studio"
+				},
+				{
+					_key: "s2",
+					platform: "linkedin",
+					url: "https://linkedin.com/company/northbound-studio"
+				},
+				{
+					_key: "s3",
+					platform: "dribbble",
+					url: "https://dribbble.com/northbound"
+				}
+			],
+			copyright: "© {year} Northbound Studio, Lisbon",
+			alignment: "between",
+			theme: "light"
+		},
+		notes: {
+			why: "Restraint is the point: a minimal footer still has structure (links, socials, email are three different things) but no groups and no form. Email is a `link` of type email so the renderer gets mailto: plus a subject line; storing a bare string would lose that. Same `{year}` token as the big footer. It's a global so a studio with 30 case-study pages edits it once.",
+			sanity: "Singleton `footer` { statement, email: string, links: array<link>, social: array<object>, copyright }.",
+			htmlSignals: [
+				"A single-row <footer> under 120px tall with a few inline links and © text",
+				"A visible mailto: link with the address as its text",
+				"2–4 icon-only social links (aria-label or <title> naming the network)",
+				"Optionally a large display-type sentence above the row"
+			],
+			mcp: "Footer with no headings and fewer than ~8 links → `compactFooter` (else use `footer-multi-column`). mailto: anchor → email { type: 'email', email, subject from ?subject= }. Inline anchors → links; icon anchors → socialLinks by hostname. © line → copyright with the year replaced by {year}.",
+			pitfalls: ["Don't promote a minimal footer to the multi-column model just to have one footer type — the editor gets empty groups to ignore."]
+		}
+	},
+	{
+		id: "footer-mega-locations",
+		previewLayout: "footer",
+		label: "Mega footer with locations + app badges",
+		proves: "Locations → opening hours at four levels · geopoints · store badges with URL patterns · LocalBusiness data from content",
+		category: "Navigation & chrome",
+		tags: [
+			"global-synced",
+			"deep-nesting",
+			"repeater",
+			"seo-structured",
+			"validation",
+			"media-heavy"
+		],
+		brand: "Hearth & Ash",
+		syncedFrom: "Footer",
+		schema: {
+			name: "locationsFooter",
+			title: "Locations footer",
+			kind: "global",
+			icon: "layout-bottombar",
+			category: "Navigation & chrome",
+			description: "Every location with its hours, app download badges, link columns and the legal row.",
+			preview: {
+				title: "tagline",
+				media: "logo"
+			},
+			groups: [
+				{
+					name: "content",
+					title: "Locations",
+					default: true
+				},
+				{
+					name: "links",
+					title: "Links & app"
+				},
+				{
+					name: "design",
+					title: "Design"
+				}
+			],
+			fields: [
+				{
+					name: "logo",
+					title: "Logo",
+					type: "image",
+					group: "links"
+				},
+				{
+					name: "tagline",
+					title: "Tagline",
+					type: "string",
+					group: "links",
+					validation: { max: 80 }
+				},
+				{
+					name: "locations",
+					title: "Locations",
+					type: "array",
+					itemNoun: "location",
+					validation: {
+						min: 1,
+						max: 8
+					},
+					description: "Also feeds the details search engines show.",
+					of: [{
+						name: "location",
+						title: "Location",
+						type: "object",
+						icon: "map-pin",
+						preview: {
+							title: "name",
+							subtitle: "address",
+							media: "photo",
+							fallback: "Untitled location"
+						},
+						fields: [
+							{
+								name: "name",
+								title: "Name",
+								type: "string",
+								validation: {
+									required: true,
+									max: 32
+								},
+								placeholder: "Pearl District"
+							},
+							{
+								name: "photo",
+								title: "Photo",
+								type: "image"
+							},
+							{
+								name: "address",
+								title: "Address",
+								type: "text",
+								rows: 2,
+								validation: { required: true }
+							},
+							{
+								name: "geo",
+								title: "Map pin",
+								type: "geopoint",
+								description: "Drop it on the entrance. Directions use it."
+							},
+							{
+								name: "phone",
+								title: "Phone",
+								type: "link"
+							},
+							{
+								name: "hours",
+								title: "Opening hours",
+								type: "array",
+								itemNoun: "row",
+								validation: {
+									min: 1,
+									max: 7
+								},
+								description: "One row per set of days with the same hours.",
+								of: [{
+									name: "hoursRow",
+									title: "Hours",
+									type: "object",
+									icon: "clock",
+									preview: {
+										title: "days",
+										subtitle: "opens",
+										fallback: "Untitled row"
+									},
+									fields: [
+										{
+											name: "days",
+											title: "Days",
+											type: "multiselect",
+											validation: { required: true },
+											options: [
+												{
+													value: "mon",
+													label: "Mon"
+												},
+												{
+													value: "tue",
+													label: "Tue"
+												},
+												{
+													value: "wed",
+													label: "Wed"
+												},
+												{
+													value: "thu",
+													label: "Thu"
+												},
+												{
+													value: "fri",
+													label: "Fri"
+												},
+												{
+													value: "sat",
+													label: "Sat"
+												},
+												{
+													value: "sun",
+													label: "Sun"
+												}
+											]
+										},
+										{
+											name: "isClosed",
+											title: "Closed",
+											type: "boolean"
+										},
+										{
+											name: "opens",
+											title: "Opens",
+											type: "string",
+											hidden: {
+												field: "isClosed",
+												equals: false
+											},
+											validation: {
+												pattern: "^([01]\\d|2[0-3]):[0-5]\\d$",
+												patternMessage: "Use 24-hour time, like 17:00."
+											},
+											placeholder: "17:00"
+										},
+										{
+											name: "closes",
+											title: "Closes",
+											type: "string",
+											hidden: {
+												field: "isClosed",
+												equals: false
+											},
+											validation: {
+												pattern: "^([01]\\d|2[0-3]):[0-5]\\d$",
+												patternMessage: "Use 24-hour time, like 22:30."
+											},
+											placeholder: "22:30"
+										}
+									]
+								}]
+							},
+							{
+								name: "reserveButton",
+								title: "Reserve button",
+								type: "button"
+							}
+						]
+					}]
+				},
+				{
+					name: "appBadges",
+					title: "App badges",
+					type: "array",
+					group: "links",
+					itemNoun: "badge",
+					validation: { max: 2 },
+					of: [{
+						name: "appBadge",
+						title: "Badge",
+						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: "groups",
+					title: "Link groups",
+					type: "array",
+					group: "links",
+					itemNoun: "group",
+					validation: { max: 3 },
+					of: [linkGroup(6)]
+				},
+				{
+					name: "socialLinks",
+					title: "Social profiles",
+					type: "array",
+					group: "links",
+					itemNoun: "profile",
+					validation: { max: 5 },
+					of: [socialItem]
+				},
+				{
+					name: "copyright",
+					title: "Copyright line",
+					type: "string",
+					group: "links",
+					validation: { max: 80 },
+					description: "{year} becomes the current year."
+				},
+				{
+					name: "locationLayout",
+					title: "Locations shown as",
+					type: "select",
+					group: "design",
+					layout: "segmented",
+					initialValue: "cards",
+					options: [{
+						value: "cards",
+						label: "Photo cards"
+					}, {
+						value: "list",
+						label: "Compact list"
+					}]
+				},
+				themeField
+			]
+		},
+		value: {
+			logo: pic("hearth-ash-mark", "Hearth & Ash", 240, 64),
+			tagline: "Wood-fired cooking in three Portland neighbourhoods.",
+			locations: [{
+				_key: "loc1",
+				name: "Pearl District",
+				photo: pic("hearth-pearl", "Long wooden bar lit by the open hearth", 1200, 900),
+				address: "1120 NW Couch St\nPortland, OR 97209",
+				geo: {
+					label: "Hearth & Ash Pearl",
+					address: "1120 NW Couch St, Portland, OR 97209",
+					lat: 45.5236,
+					lng: -122.6833
+				},
+				phone: {
+					type: "phone",
+					href: "tel:+15035550142",
+					phone: "+1 503 555 0142",
+					title: "(503) 555-0142"
+				},
+				hours: [
+					{
+						_key: "h1",
+						days: [
+							"tue",
+							"wed",
+							"thu"
+						],
+						isClosed: false,
+						opens: "17:00",
+						closes: "22:00"
+					},
+					{
+						_key: "h2",
+						days: ["fri", "sat"],
+						isClosed: false,
+						opens: "17:00",
+						closes: "23:00"
+					},
+					{
+						_key: "h3",
+						days: ["sun"],
+						isClosed: false,
+						opens: "10:00",
+						closes: "14:30"
+					},
+					{
+						_key: "h4",
+						days: ["mon"],
+						isClosed: true
+					}
+				],
+				reserveButton: btn("Reserve", "https://resy.com/cities/pdx/hearth-and-ash-pearl", "outline", { newTab: true })
+			}, {
+				_key: "loc2",
+				name: "Alberta Arts",
+				photo: pic("hearth-alberta", "Patio tables under string lights", 1200, 900),
+				address: "2940 NE Alberta St\nPortland, OR 97211",
+				geo: {
+					label: "Hearth & Ash Alberta",
+					address: "2940 NE Alberta St, Portland, OR 97211",
+					lat: 45.559,
+					lng: -122.6365
+				},
+				phone: {
+					type: "phone",
+					href: "tel:+15035550178",
+					phone: "+1 503 555 0178",
+					title: "(503) 555-0178"
+				},
+				hours: [{
+					_key: "h5",
+					days: [
+						"wed",
+						"thu",
+						"fri",
+						"sat",
+						"sun"
+					],
+					isClosed: false,
+					opens: "16:30",
+					closes: "22:00"
+				}, {
+					_key: "h6",
+					days: ["mon", "tue"],
+					isClosed: true
+				}],
+				reserveButton: btn("Reserve", "https://resy.com/cities/pdx/hearth-and-ash-alberta", "outline", { newTab: true })
+			}],
+			appBadges: [{
+				_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"
+			}],
+			groups: [{
+				_key: "g1",
+				title: "Visit",
+				links: [
+					{
+						_key: "a1",
+						label: "Menus",
+						link: page("/menus", "Menus")
+					},
+					{
+						_key: "a2",
+						label: "Private dining",
+						link: page("/private-dining", "Private dining")
+					},
+					{
+						_key: "a3",
+						label: "Gift cards",
+						link: page("/gift-cards", "Gift cards")
+					}
+				]
+			}, {
+				_key: "g2",
+				title: "Company",
+				links: [
+					{
+						_key: "a4",
+						label: "Our story",
+						link: page("/story", "Our story")
+					},
+					{
+						_key: "a5",
+						label: "Jobs",
+						link: page("/jobs", "Jobs")
+					},
+					{
+						_key: "a6",
+						label: "Press",
+						link: page("/press", "Press")
+					}
+				]
+			}],
+			socialLinks: [{
+				_key: "s1",
+				platform: "instagram",
+				url: "https://instagram.com/hearthandash.pdx"
+			}],
+			copyright: "© {year} Hearth & Ash Restaurant Group",
+			locationLayout: "cards",
+			theme: "dark"
+		},
+		notes: {
+			why: "Locations are the deep part: Footer › Locations › Location › Hours › Row is four drill levels, which is exactly what real multi-site restaurants and retailers need (split hours, brunch-only Sundays, closed Mondays). Hours are structured rows (days multiselect + 24-hour times), never a free-text 'Tue–Thu 5–10', because the same data feeds LocalBusiness/Restaurant JSON-LD and 'Open now' — natively, without SEO fields. `geo` is a geopoint so directions and maps never geocode a typo. App badges are a select + URL with a pattern, rendered with official artwork. If the site also has a Locations collection, this array should become `array<reference>` to it (see pitfalls).",
+			sanity: "Singleton `footer` { locations: array<reference<location>> } where `location` is a document { name, address, geo: geopoint, phone, hours: array<object { days: array<string>, opens, closes, closed }> }; appBadges: array<object { store, url }>.",
+			htmlSignals: [
+				"Footer columns each with a place name, a street address, a phone link and a small hours table",
+				"Google Maps links (maps.google.com/?q=… or /maps/place/) or embedded map iframes per location",
+				"App Store / Google Play badge images linking to apps.apple.com and play.google.com",
+				"JSON-LD with @type Restaurant/LocalBusiness and openingHoursSpecification"
+			],
+			mcp: "Per location block: name, address (keep line breaks), tel: → phone, maps link coordinates (@lat,lng or ?ll=) → geo, the hours table → hours[] (group days with identical times; 'Closed' → isClosed: true; convert 5pm → 17:00). If a /locations/* page exists per place, create a Locations collection and store references here instead. Badge <a> by hostname → appBadges { store, url }; never import the badge images. Verify the platform's JSON-LD matches the source's openingHoursSpecification.",
+			pitfalls: [
+				"Free-text hours ('Tue–Thu 5–10ish') can't power Open now or structured data — always normalize to rows.",
+				"Duplicating locations in the footer AND a Locations collection — two truths; use references once a collection exists.",
+				"Times without a zone are read in the site's time zone; a chain spanning zones needs a zone per location (not modelled)."
+			]
+		}
+	}
+];
+//#endregion
+export { ENTRIES };
+
+//# sourceMappingURL=navigation.entries.js.map