@bettercms-ai/kit 0.1.1 → 2.0.0

package/dist/library/entries/listings.entries.js

@@ -0,0 +1,2976 @@
+//#region src/library/entries/listings.entries.ts
+var pic = (seed, w = 1600, h = 1e3) => `https://picsum.photos/seed/${seed}/${w}/${h}`;
+var image = (seed, alt, w = 1600, h = 1e3) => ({
+	url: pic(seed, w, h),
+	alt,
+	name: `${seed}.jpg`,
+	width: w * 2,
+	height: h * 2
+});
+var CONTENT = {
+	name: "content",
+	title: "Content",
+	icon: "file-text",
+	default: true
+};
+var QUERY = {
+	name: "query",
+	title: "Items",
+	icon: "database"
+};
+var DESIGN = {
+	name: "design",
+	title: "Design",
+	icon: "palette"
+};
+/** The collection a listing reads from. Wired in code — marketers see it, can't change it. */
+var collectionField = (id, label) => ({
+	name: "collection",
+	title: "Collection",
+	type: "select",
+	access: { edit: "schema.manage" },
+	lockReason: "The collection is wired to the page template in code.",
+	initialValue: id,
+	options: [{
+		value: id,
+		label
+	}],
+	description: ""
+});
+var ENTRIES = [
+	{
+		id: "blog-index",
+		label: "Blog index",
+		category: "Listings & feeds",
+		brand: "Caldera",
+		previewLayout: "grid-3",
+		tags: [
+			"dynamic-query",
+			"references",
+			"conditional",
+			"variants",
+			"validation"
+		],
+		proves: "A listing stores a query, not copies · featured pick as a conditional reference · pagination modes",
+		docTitle: "Journal",
+		urlPrefix: "caldera.bettercms.site/",
+		schema: {
+			name: "blogIndex",
+			title: "Blog index",
+			kind: "block",
+			icon: "news",
+			category: "Listings & feeds",
+			description: "A featured story, then a paged grid of Journal posts",
+			variants: [
+				{
+					id: "featured-grid",
+					name: "Featured + grid",
+					description: "One large card, then a 3-column grid"
+				},
+				{
+					id: "list",
+					name: "List",
+					description: "Rows with a thumbnail on the left"
+				},
+				{
+					id: "magazine",
+					name: "Magazine",
+					description: "Two large cards, then a dense grid"
+				}
+			],
+			groups: [
+				CONTENT,
+				QUERY,
+				DESIGN
+			],
+			fieldsets: [{
+				name: "featured",
+				title: "Featured story",
+				description: "The large card above the grid."
+			}, {
+				name: "empty",
+				title: "When nothing matches",
+				collapsed: true
+			}],
+			preview: {
+				title: "heading",
+				subtitle: "intro",
+				icon: "layout-grid"
+			},
+			fields: [
+				{
+					name: "eyebrow",
+					title: "Eyebrow",
+					type: "string",
+					group: "content",
+					validation: { max: 40 },
+					placeholder: "The Journal"
+				},
+				{
+					name: "heading",
+					title: "Heading",
+					type: "string",
+					group: "content",
+					validation: {
+						required: true,
+						recommendedMax: 48
+					},
+					ai: true,
+					localized: true
+				},
+				{
+					name: "intro",
+					title: "Intro",
+					type: "text",
+					rows: 2,
+					group: "content",
+					validation: { recommendedMax: 200 },
+					ai: true,
+					localized: true
+				},
+				{
+					name: "featuredMode",
+					title: "Featured story",
+					type: "select",
+					group: "content",
+					fieldset: "featured",
+					layout: "segmented",
+					initialValue: "latest",
+					options: [
+						{
+							value: "latest",
+							label: "Newest featured",
+							description: "The newest post marked Featured"
+						},
+						{
+							value: "pick",
+							label: "Pick one"
+						},
+						{
+							value: "none",
+							label: "None"
+						}
+					],
+					description: "Newest featured updates itself when a new featured post goes live."
+				},
+				{
+					name: "featuredPost",
+					title: "Post to feature",
+					type: "reference",
+					group: "content",
+					fieldset: "featured",
+					reference: { to: ["col_journal"] },
+					hidden: {
+						field: "featuredMode",
+						equals: "pick"
+					},
+					validation: { required: true }
+				},
+				{
+					name: "posts",
+					title: "Posts to list",
+					type: "object",
+					group: "query",
+					icon: "database",
+					description: "New posts that match appear on their own.",
+					fields: [
+						collectionField("col_journal", "Journal"),
+						{
+							name: "topics",
+							title: "Only these topics",
+							type: "array",
+							validation: { max: 6 },
+							description: "Leave empty for every post.",
+							of: [{
+								name: "topic",
+								title: "Topic",
+								type: "reference",
+								reference: { to: ["col_topics"] }
+							}]
+						},
+						{
+							name: "authors",
+							title: "Only these authors",
+							type: "array",
+							validation: { max: 6 },
+							description: "Leave empty for every author.",
+							of: [{
+								name: "author",
+								title: "Author",
+								type: "reference",
+								reference: { to: ["col_authors"] }
+							}]
+						},
+						{
+							name: "hideFeatured",
+							title: "Skip the featured post",
+							type: "boolean",
+							initialValue: true
+						},
+						{
+							name: "sort",
+							title: "Order",
+							type: "select",
+							initialValue: "newest",
+							options: [
+								{
+									value: "newest",
+									label: "Newest first"
+								},
+								{
+									value: "oldest",
+									label: "Oldest first"
+								},
+								{
+									value: "updated",
+									label: "Recently updated",
+									description: "Uses the Updated date, then the publish date"
+								},
+								{
+									value: "title",
+									label: "A to Z"
+								}
+							],
+							description: ""
+						},
+						{
+							name: "pageSize",
+							title: "Posts per page",
+							type: "number",
+							layout: "slider",
+							numeric: {
+								min: 3,
+								max: 24,
+								step: 3
+							},
+							initialValue: 9
+						}
+					]
+				},
+				{
+					name: "pagination",
+					title: "More posts",
+					type: "select",
+					group: "query",
+					layout: "radio",
+					initialValue: "numbered",
+					options: [
+						{
+							value: "numbered",
+							label: "Numbered pages",
+							description: "Each page gets its own address, /journal/page/2"
+						},
+						{
+							value: "loadMore",
+							label: "Load more button"
+						},
+						{
+							value: "infinite",
+							label: "Infinite scroll"
+						},
+						{
+							value: "none",
+							label: "First page only"
+						}
+					],
+					description: ""
+				},
+				{
+					name: "loadMoreLabel",
+					title: "Button label",
+					type: "string",
+					group: "query",
+					hidden: {
+						field: "pagination",
+						equals: "loadMore"
+					},
+					initialValue: "Load more stories",
+					validation: { max: 32 },
+					description: ""
+				},
+				{
+					name: "emptyHeading",
+					title: "Empty heading",
+					type: "string",
+					group: "query",
+					fieldset: "empty",
+					initialValue: "Nothing here yet",
+					validation: { max: 60 },
+					description: "Shown when the filters match no posts."
+				},
+				{
+					name: "emptyButton",
+					title: "Empty button",
+					type: "button",
+					group: "query",
+					fieldset: "empty"
+				},
+				{
+					name: "columns",
+					title: "Columns on desktop",
+					type: "number",
+					group: "design",
+					layout: "slider",
+					numeric: {
+						min: 2,
+						max: 4,
+						step: 1
+					},
+					initialValue: 3,
+					description: ""
+				},
+				{
+					name: "imageRatio",
+					title: "Card image",
+					type: "select",
+					group: "design",
+					layout: "segmented",
+					initialValue: "4:3",
+					options: [
+						{
+							value: "16:9",
+							label: "16:9"
+						},
+						{
+							value: "4:3",
+							label: "4:3"
+						},
+						{
+							value: "1:1",
+							label: "Square"
+						},
+						{
+							value: "none",
+							label: "No image"
+						}
+					]
+				},
+				{
+					name: "cardShows",
+					title: "Card shows",
+					type: "multiselect",
+					group: "design",
+					layout: "checkbox",
+					initialValue: [
+						"excerpt",
+						"date",
+						"topic"
+					],
+					options: [
+						{
+							value: "excerpt",
+							label: "Excerpt"
+						},
+						{
+							value: "date",
+							label: "Date"
+						},
+						{
+							value: "author",
+							label: "Author"
+						},
+						{
+							value: "readingTime",
+							label: "Reading time"
+						},
+						{
+							value: "topic",
+							label: "First topic"
+						}
+					],
+					description: ""
+				},
+				{
+					name: "anchor",
+					title: "Anchor",
+					type: "string",
+					group: "design",
+					advanced: true,
+					validation: {
+						pattern: "^[a-z0-9-]+$",
+						patternMessage: "Use lowercase letters, numbers and hyphens, like our-story."
+					}
+				}
+			]
+		},
+		value: {
+			_variant: "featured-grid",
+			eyebrow: "The Journal",
+			heading: "Notes from the fire",
+			intro: "Field tests, recipes and the long way round to a well-seasoned pan. New stories every Thursday.",
+			featuredMode: "pick",
+			featuredPost: "en_1",
+			posts: {
+				collection: "col_journal",
+				topics: ["tp_cast-iron", "tp_camp"],
+				authors: [],
+				hideFeatured: true,
+				sort: "newest",
+				pageSize: 9
+			},
+			pagination: "numbered",
+			loadMoreLabel: "Load more stories",
+			emptyHeading: "No stories in this topic yet",
+			emptyButton: {
+				label: "Browse every story",
+				href: "/journal",
+				type: "page",
+				title: "Journal",
+				style: "secondary"
+			},
+			columns: 3,
+			imageRatio: "4:3",
+			cardShows: [
+				"excerpt",
+				"date",
+				"topic",
+				"readingTime"
+			],
+			anchor: "stories"
+		},
+		notes: {
+			why: "Posts are Journal entries; the index is a section on the Journal static page that holds only a query (topics, authors, order, page size), so a new post appears without anyone editing the page. The collection is developer-locked because the card template is wired to that collection's fields. The editorial pick is the one exception — a single optional reference shown only when Featured story = Pick one — and excludeFeatured stops it showing twice. Card visibility and image ratio are design, so they live in the Design group, not on each post.",
+			sanity: "object `blogIndex` { featuredPost: reference→post, topics: array<reference→category>, pageSize: number }. The query itself is GROQ in the frontend (`*[_type=='post' && count((categories[]._ref)[@ in $topics])>0] | order(publishedAt desc)[$from...$to]`) — Sanity has no field type for it. Ours keeps the query in the content so editors can see and change it.",
+			htmlSignals: [
+				"Three or more sibling <article> cards with the same shape: image, h2/h3 link, <time>, short paragraph",
+				"Card hrefs share a prefix (/blog/, /journal/, /news/) — that prefix names the collection",
+				"One card visibly larger or first in its own row before the grid (featured)",
+				"<nav aria-label=\"Pagination\"> with numbered links or rel=\"next\", or a 'Load more' button",
+				"Category chips or a 'Filed under' label on each card (topics reference)"
+			],
+			mcp: "1) Find or create the collection from the card shape: title (card heading), slug (last href segment), excerpt (card paragraph), coverImage (card image + alt), publishedAt (<time datetime>), author, topics. 2) Import each card as an entry; follow the href for the body. 3) Create ONE blogIndex section with posts.collection = that collection. Set topics only when the page URL or heading scopes it (/blog/category/camp → topic 'camp'). 4) featuredMode: 'pick' + featuredPost when the first card is larger, else 'latest'. 5) pagination from the DOM (numbered nav → numbered; 'Load more' → loadMore; none visible → none). pageSize = cards on page 1 minus the featured card, rounded to columns. Never write card titles into the section.",
+			pitfalls: [
+				"Copying the 9 visible cards into an inline array freezes the list — new posts never appear.",
+				"Featured post listed again in the grid when excludeFeatured is off.",
+				"Infinite scroll with no numbered fallback leaves old posts unreachable for crawlers.",
+				"pageSize that isn't a multiple of columns leaves a ragged last row.",
+				"A topic-scoped index (/journal/topic/camp) is a page template on the Topics collection, not a copy of this section per topic."
+			]
+		}
+	},
+	{
+		id: "category-filter-bar",
+		label: "Category filter bar",
+		category: "Listings & feeds",
+		brand: "Caldera",
+		previewLayout: "nav",
+		tags: [
+			"references",
+			"dynamic-query",
+			"conditional",
+			"variants",
+			"responsive-layout",
+			"a11y"
+		],
+		proves: "Chips from a taxonomy collection (all or picked) · filters a list on the page or navigates · mobile behavior per breakpoint",
+		schema: {
+			name: "categoryFilter",
+			title: "Category filter bar",
+			kind: "block",
+			icon: "filter",
+			category: "Listings & feeds",
+			description: "Topic chips that filter a list or link to topic pages",
+			variants: [
+				{
+					id: "pills",
+					name: "Pills"
+				},
+				{
+					id: "underline",
+					name: "Underline tabs"
+				},
+				{
+					id: "dropdown",
+					name: "Dropdown",
+					description: "One select, good for 10+ topics"
+				}
+			],
+			groups: [CONTENT, DESIGN],
+			preview: {
+				title: "allLabel",
+				subtitle: "targetList",
+				icon: "filter"
+			},
+			fields: [
+				{
+					name: "source",
+					title: "Chips",
+					type: "select",
+					layout: "segmented",
+					group: "content",
+					initialValue: "all",
+					options: [{
+						value: "all",
+						label: "Every topic"
+					}, {
+						value: "pick",
+						label: "Pick topics"
+					}],
+					description: "Every topic, new ones included, A to Z."
+				},
+				{
+					name: "topics",
+					title: "Topics",
+					type: "array",
+					group: "content",
+					hidden: {
+						field: "source",
+						equals: "pick"
+					},
+					validation: {
+						min: 2,
+						max: 10
+					},
+					of: [{
+						name: "topic",
+						title: "Topic",
+						type: "reference",
+						reference: { to: ["col_topics"] }
+					}]
+				},
+				{
+					name: "allLabel",
+					title: "First chip",
+					type: "string",
+					group: "content",
+					initialValue: "All",
+					validation: { max: 20 },
+					localized: true,
+					description: "Leave empty to drop the chip."
+				},
+				{
+					name: "hideEmpty",
+					title: "Hide empty topics",
+					type: "boolean",
+					group: "content",
+					initialValue: true
+				},
+				{
+					name: "showCounts",
+					title: "Show counts",
+					type: "boolean",
+					group: "content"
+				},
+				{
+					name: "action",
+					title: "Clicking a chip",
+					type: "select",
+					layout: "radio",
+					group: "content",
+					initialValue: "filter",
+					options: [{
+						value: "filter",
+						label: "Filters the list on this page",
+						description: "No page load; the URL keeps the choice"
+					}, {
+						value: "navigate",
+						label: "Opens the topic's page",
+						description: "/journal/topic/camp"
+					}],
+					description: ""
+				},
+				{
+					name: "targetList",
+					title: "List to filter",
+					type: "string",
+					group: "content",
+					hidden: {
+						field: "action",
+						equals: "filter"
+					},
+					validation: {
+						required: true,
+						pattern: "^[a-z0-9-]+$",
+						patternMessage: "Use the list section's anchor, like stories."
+					},
+					description: "The anchor of the list section below, e.g. stories."
+				},
+				{
+					name: "param",
+					title: "URL parameter",
+					type: "string",
+					group: "content",
+					hidden: {
+						field: "action",
+						equals: "filter"
+					},
+					access: {
+						view: "schema.view",
+						edit: "schema.manage"
+					},
+					initialValue: "topic",
+					advanced: true,
+					description: "Keeps the filter in shared links, e.g. ?topic=camp."
+				},
+				{
+					name: "ariaLabel",
+					title: "Name for screen readers",
+					type: "string",
+					group: "content",
+					initialValue: "Filter stories by topic",
+					validation: {
+						required: true,
+						max: 60
+					},
+					description: "Not shown. Read by screen readers before the chips."
+				},
+				{
+					name: "mobile",
+					title: "On phones",
+					type: "select",
+					layout: "segmented",
+					group: "design",
+					initialValue: "scroll",
+					options: [
+						{
+							value: "scroll",
+							label: "Scroll sideways"
+						},
+						{
+							value: "wrap",
+							label: "Wrap"
+						},
+						{
+							value: "dropdown",
+							label: "Dropdown"
+						}
+					]
+				},
+				{
+					name: "isSticky",
+					title: "Stick under the header",
+					type: "boolean",
+					group: "design"
+				},
+				{
+					name: "alignment",
+					title: "Alignment",
+					type: "select",
+					layout: "segmented",
+					group: "design",
+					initialValue: "start",
+					options: [{
+						value: "start",
+						label: "Left"
+					}, {
+						value: "center",
+						label: "Center"
+					}],
+					description: ""
+				}
+			]
+		},
+		value: {
+			_variant: "pills",
+			source: "pick",
+			topics: [
+				"tp_cast-iron",
+				"tp_camp",
+				"tp_recipes",
+				"tp_trips",
+				"tp_care"
+			],
+			allLabel: "All stories",
+			hideEmpty: true,
+			showCounts: false,
+			action: "filter",
+			targetList: "stories",
+			param: "topic",
+			ariaLabel: "Filter stories by topic",
+			mobile: "scroll",
+			isSticky: true,
+			alignment: "start"
+		},
+		notes: {
+			why: "The chips are a projection of the Topics collection, so the section holds either 'every topic' (a query) or an ordered list of topic references — never typed labels, which drift from the real taxonomy. Whether a chip filters in place or navigates is behavior the marketer chooses; the URL parameter is wired in code (locked). It points at the list it filters by anchor because the schema has no 'section on this page' reference. Mobile treatment is per-breakpoint design.",
+			sanity: "object `categoryFilter` { mode: string, categories: array<reference→category> }. Sanity renders the chips from a GROQ `*[_type=='category']`; filtering is pure frontend.",
+			htmlSignals: [
+				"<nav> or role=\"tablist\" of 3–15 short links/buttons just above a card grid",
+				"First item reads 'All' / 'Everything' and has aria-current or an active class",
+				"Hrefs like ?category=x, ?topic=x or /category/x/",
+				"Horizontal overflow-x: auto on small screens (scroll), or a <select> fallback"
+			],
+			mcp: "Map each chip label to an existing taxonomy entry (create Topics if missing; slug from the href). If the chips equal the full taxonomy, set source 'all'; otherwise 'pick' in DOM order. action = 'filter' when hrefs are query strings or buttons, 'navigate' when they are /category/x paths. targetList = anchor of the next listing section (add one to it if missing). Don't store chip labels as strings.",
+			pitfalls: [
+				"Typed chip labels drift from topic names after a rename — always references.",
+				"A filter bar with no targetList silently does nothing.",
+				"Counts that include drafts or future posts — counts must use the published query.",
+				"Wrapping 12 chips on a phone pushes the list below the fold."
+			]
+		}
+	},
+	{
+		id: "related-posts",
+		label: "Related posts",
+		category: "Listings & feeds",
+		brand: "Caldera",
+		previewLayout: "grid-3",
+		tags: [
+			"conditional",
+			"references",
+			"dynamic-query",
+			"validation",
+			"variants"
+		],
+		proves: "Automatic, hand-picked or mixed (pins first, then auto) · match rules · fallback when nothing matches",
+		schema: {
+			name: "relatedPosts",
+			title: "Related posts",
+			kind: "block",
+			icon: "arrows-shuffle",
+			category: "Listings & feeds",
+			description: "More stories at the end of a post, matched or picked",
+			variants: [
+				{
+					id: "cards",
+					name: "Cards"
+				},
+				{
+					id: "compact",
+					name: "Compact list"
+				},
+				{
+					id: "carousel",
+					name: "Carousel"
+				}
+			],
+			groups: [CONTENT, DESIGN],
+			preview: {
+				title: "heading",
+				subtitle: "mode",
+				icon: "arrows-shuffle"
+			},
+			fields: [
+				{
+					name: "heading",
+					title: "Heading",
+					type: "string",
+					group: "content",
+					initialValue: "Keep reading",
+					validation: { max: 48 },
+					localized: true
+				},
+				{
+					name: "mode",
+					title: "Which posts",
+					type: "select",
+					layout: "radio",
+					group: "content",
+					initialValue: "auto",
+					options: [
+						{
+							value: "auto",
+							label: "Automatic",
+							description: "Shares topics with this post, newest first"
+						},
+						{
+							value: "manual",
+							label: "Pick them"
+						},
+						{
+							value: "mixed",
+							label: "Pick some, fill the rest",
+							description: "Your picks first, then automatic"
+						}
+					],
+					description: ""
+				},
+				{
+					name: "picks",
+					title: "Posts",
+					type: "array",
+					group: "content",
+					hidden: {
+						field: "mode",
+						equals: ["manual", "mixed"]
+					},
+					validation: {
+						min: 1,
+						max: 4,
+						unique: true
+					},
+					description: "The current post is skipped.",
+					of: [{
+						name: "post",
+						title: "Post",
+						type: "reference",
+						reference: { to: ["col_journal", "col_recipes"] }
+					}]
+				},
+				{
+					name: "matchOn",
+					title: "Match on",
+					type: "multiselect",
+					layout: "checkbox",
+					group: "content",
+					hidden: {
+						field: "mode",
+						equals: ["auto", "mixed"]
+					},
+					initialValue: ["topics"],
+					options: [
+						{
+							value: "topics",
+							label: "Topics"
+						},
+						{
+							value: "authors",
+							label: "Authors"
+						},
+						{
+							value: "product",
+							label: "Reviewed product"
+						}
+					],
+					description: "More shared values rank higher. Ties go to the newest."
+				},
+				{
+					name: "showRecipes",
+					title: "Include recipes",
+					type: "boolean",
+					group: "content",
+					hidden: {
+						field: "mode",
+						equals: ["auto", "mixed"]
+					}
+				},
+				{
+					name: "count",
+					title: "How many",
+					type: "number",
+					group: "content",
+					layout: "slider",
+					numeric: {
+						min: 2,
+						max: 6,
+						step: 1
+					},
+					initialValue: 3,
+					description: ""
+				},
+				{
+					name: "fallback",
+					title: "When nothing matches",
+					type: "select",
+					group: "content",
+					hidden: {
+						field: "mode",
+						equals: ["auto", "mixed"]
+					},
+					initialValue: "newest",
+					options: [{
+						value: "newest",
+						label: "Show the newest posts"
+					}, {
+						value: "hide",
+						label: "Hide the section"
+					}],
+					description: ""
+				},
+				{
+					name: "showImages",
+					title: "Show images",
+					type: "boolean",
+					group: "design",
+					initialValue: true,
+					description: ""
+				},
+				{
+					name: "showDivider",
+					title: "Line above",
+					type: "boolean",
+					group: "design"
+				}
+			]
+		},
+		value: {
+			_variant: "cards",
+			heading: "Keep reading",
+			mode: "mixed",
+			picks: ["en_2"],
+			matchOn: ["topics", "product"],
+			showRecipes: true,
+			count: 3,
+			fallback: "newest",
+			showImages: true,
+			showDivider: true
+		},
+		notes: {
+			why: "Related posts live on the post template (one placement for every post), so the default must work with zero editing: automatic matching on shared topics. Editors who care can pin a few (mixed) or hand-pick all (manual). The three-way mode is the condition that shows picks vs. match rules — the same field never means two things. References carry the picks so a renamed post stays linked; the current post is excluded by the renderer, not by validation.",
+			sanity: "In Sanity this is usually `related: array<reference→post>` on the post document plus a frontend GROQ fallback (`*[_type=='post' && _id != ^._id && count(categories[@._ref in ^.^.categories[]._ref]) > 0]`). Our section makes the rule visible and editable.",
+			htmlSignals: [
+				"Heading like 'Related', 'Keep reading', 'You might also like', 'More from' near the article end",
+				"2–4 small cards after </article> or before the comments/footer",
+				"Cards link to the same URL prefix as the current page",
+				"Sometimes inside <aside> with a smaller heading level (h2/h3)"
+			],
+			mcp: "Place one relatedPosts on the post TEMPLATE, not per post. If the source CMS shows the same cards for posts with the same category, use mode 'auto' with matchOn ['topics']. If a post shows cards that don't share its topics, convert those to picks on that post's instance (mode 'mixed'). count = cards shown.",
+			pitfalls: [
+				"Manual picks on a template apply to every post — picks belong on the post's own instance.",
+				"Auto with no fallback renders an empty heading on a post with a unique topic.",
+				"Picking the current post (self-reference) — the renderer must skip it.",
+				"Unpublished picks: the reference resolves only to published entries on the live site."
+			]
+		}
+	},
+	{
+		id: "resource-library",
+		label: "Resource library",
+		category: "Listings & feeds",
+		brand: "Ledgerline",
+		previewLayout: "grid-3",
+		tags: [
+			"dynamic-query",
+			"repeater",
+			"conditional",
+			"references",
+			"form",
+			"validation",
+			"responsive-layout"
+		],
+		proves: "Multi-facet filters defined as data (field · control · order) · gated downloads by type · pinned items above the query",
+		docTitle: "Resources",
+		urlPrefix: "ledgerline.com/",
+		schema: {
+			name: "resourceLibrary",
+			title: "Resource library",
+			kind: "block",
+			icon: "books",
+			category: "Listings & feeds",
+			description: "Guides, reports and templates with search and filters",
+			variants: [{
+				id: "sidebar",
+				name: "Filters on the left"
+			}, {
+				id: "top",
+				name: "Filters on top"
+			}],
+			groups: [
+				CONTENT,
+				QUERY,
+				{
+					name: "filters",
+					title: "Filters",
+					icon: "adjustments"
+				},
+				DESIGN
+			],
+			preview: {
+				title: "heading",
+				subtitle: "intro",
+				icon: "books"
+			},
+			fields: [
+				{
+					name: "heading",
+					title: "Heading",
+					type: "string",
+					group: "content",
+					validation: {
+						required: true,
+						recommendedMax: 48
+					},
+					ai: true,
+					localized: true
+				},
+				{
+					name: "intro",
+					title: "Intro",
+					type: "text",
+					rows: 2,
+					group: "content",
+					ai: true,
+					localized: true,
+					description: ""
+				},
+				{
+					name: "pinned",
+					title: "Pinned",
+					type: "array",
+					group: "content",
+					validation: {
+						max: 3,
+						unique: true
+					},
+					of: [{
+						name: "resource",
+						title: "Resource",
+						type: "reference",
+						reference: { to: ["col_resources"] }
+					}]
+				},
+				{
+					name: "query",
+					title: "Resources to list",
+					type: "object",
+					group: "query",
+					fields: [
+						collectionField("col_resources", "Resources"),
+						{
+							name: "types",
+							title: "Only these types",
+							type: "multiselect",
+							options: [
+								{
+									value: "guide",
+									label: "Guides"
+								},
+								{
+									value: "report",
+									label: "Reports"
+								},
+								{
+									value: "template",
+									label: "Templates"
+								},
+								{
+									value: "webinar",
+									label: "Webinars"
+								},
+								{
+									value: "case-study",
+									label: "Case studies"
+								}
+							],
+							description: "Leave empty for every type."
+						},
+						{
+							name: "sort",
+							title: "Order",
+							type: "select",
+							initialValue: "newest",
+							options: [
+								{
+									value: "newest",
+									label: "Newest first"
+								},
+								{
+									value: "popular",
+									label: "Most downloaded"
+								},
+								{
+									value: "title",
+									label: "A to Z"
+								}
+							],
+							description: "Most downloaded uses the last 90 days."
+						},
+						{
+							name: "pageSize",
+							title: "Per page",
+							type: "number",
+							layout: "slider",
+							numeric: {
+								min: 6,
+								max: 36,
+								step: 6
+							},
+							initialValue: 12,
+							description: ""
+						}
+					]
+				},
+				{
+					name: "showSearch",
+					title: "Show search box",
+					type: "boolean",
+					group: "filters",
+					initialValue: true
+				},
+				{
+					name: "searchPlaceholder",
+					title: "Search placeholder",
+					type: "string",
+					group: "filters",
+					hidden: {
+						field: "showSearch",
+						equals: true
+					},
+					initialValue: "Search guides, reports and templates",
+					validation: { max: 48 },
+					description: ""
+				},
+				{
+					name: "facets",
+					title: "Filters",
+					type: "array",
+					group: "filters",
+					itemNoun: "filter",
+					validation: { max: 5 },
+					description: "Each filter reads one field of the Resources collection.",
+					of: [{
+						name: "facet",
+						title: "Filter",
+						type: "object",
+						icon: "adjustments",
+						preview: {
+							title: "label",
+							subtitle: "field",
+							fallback: "Untitled filter"
+						},
+						fields: [
+							{
+								name: "label",
+								title: "Label",
+								type: "string",
+								validation: {
+									required: true,
+									max: 24
+								},
+								localized: true
+							},
+							{
+								name: "field",
+								title: "Filters by",
+								type: "select",
+								access: { edit: "schema.manage" },
+								lockReason: "Facets map to indexed fields; the developer adds new ones.",
+								options: [
+									{
+										value: "type",
+										label: "Type"
+									},
+									{
+										value: "topics",
+										label: "Topic"
+									},
+									{
+										value: "industry",
+										label: "Industry"
+									},
+									{
+										value: "role",
+										label: "Role"
+									},
+									{
+										value: "format",
+										label: "Format"
+									}
+								],
+								validation: { required: true },
+								description: ""
+							},
+							{
+								name: "control",
+								title: "Shown as",
+								type: "select",
+								layout: "segmented",
+								initialValue: "checkbox",
+								options: [
+									{
+										value: "checkbox",
+										label: "Checkboxes"
+									},
+									{
+										value: "chips",
+										label: "Chips"
+									},
+									{
+										value: "dropdown",
+										label: "Dropdown"
+									}
+								],
+								description: ""
+							},
+							{
+								name: "allowMultiple",
+								title: "Allow several",
+								type: "boolean",
+								initialValue: true,
+								description: "Results match any of the ticked values."
+							},
+							{
+								name: "order",
+								title: "Value order",
+								type: "select",
+								initialValue: "count",
+								options: [{
+									value: "count",
+									label: "Most results first"
+								}, {
+									value: "alpha",
+									label: "A to Z"
+								}],
+								description: ""
+							},
+							{
+								name: "isCollapsed",
+								title: "Start collapsed",
+								type: "boolean"
+							}
+						]
+					}]
+				},
+				{
+					name: "useUrlSync",
+					title: "Keep filters in the URL",
+					type: "boolean",
+					group: "filters",
+					initialValue: true
+				},
+				{
+					name: "gate",
+					title: "Downloads",
+					type: "select",
+					group: "content",
+					layout: "radio",
+					initialValue: "open",
+					options: [{
+						value: "open",
+						label: "Open to everyone"
+					}, {
+						value: "form",
+						label: "Ask for details first",
+						description: "Shows a form before the file"
+					}],
+					description: ""
+				},
+				{
+					name: "gateForm",
+					title: "Form",
+					type: "reference",
+					group: "content",
+					reference: { to: ["form"] },
+					hidden: {
+						field: "gate",
+						equals: "form"
+					},
+					validation: { required: true },
+					description: "Visitors fill it once; later downloads skip it."
+				},
+				{
+					name: "gateTypes",
+					title: "Ask only for",
+					type: "multiselect",
+					group: "content",
+					hidden: {
+						field: "gate",
+						equals: "form"
+					},
+					options: [
+						{
+							value: "guide",
+							label: "Guides"
+						},
+						{
+							value: "report",
+							label: "Reports"
+						},
+						{
+							value: "template",
+							label: "Templates"
+						}
+					],
+					description: "Leave empty to gate every type."
+				},
+				{
+					name: "columns",
+					title: "Columns on desktop",
+					type: "number",
+					group: "design",
+					layout: "slider",
+					numeric: {
+						min: 2,
+						max: 4,
+						step: 1
+					},
+					initialValue: 3,
+					description: ""
+				},
+				{
+					name: "mobileFilters",
+					title: "Filters on phones",
+					type: "select",
+					group: "design",
+					layout: "segmented",
+					initialValue: "sheet",
+					options: [{
+						value: "sheet",
+						label: "Bottom sheet"
+					}, {
+						value: "inline",
+						label: "Above results"
+					}]
+				}
+			]
+		},
+		value: {
+			_variant: "sidebar",
+			heading: "Guides for finance teams that close fast",
+			intro: "Playbooks, benchmarks and templates from 1,400 finance teams on Ledgerline.",
+			pinned: ["en_res_close-benchmark-2026"],
+			query: {
+				collection: "col_resources",
+				types: [],
+				sort: "newest",
+				pageSize: 12
+			},
+			showSearch: true,
+			searchPlaceholder: "Search guides, reports and templates",
+			facets: [
+				{
+					_key: "f1",
+					label: "Type",
+					field: "type",
+					control: "checkbox",
+					allowMultiple: true,
+					order: "count",
+					isCollapsed: false
+				},
+				{
+					_key: "f2",
+					label: "Topic",
+					field: "topics",
+					control: "chips",
+					allowMultiple: true,
+					order: "alpha",
+					isCollapsed: false
+				},
+				{
+					_key: "f3",
+					label: "Industry",
+					field: "industry",
+					control: "dropdown",
+					allowMultiple: false,
+					order: "alpha",
+					isCollapsed: true
+				}
+			],
+			useUrlSync: true,
+			gate: "form",
+			gateForm: "form_resource-download",
+			gateTypes: ["report", "template"],
+			columns: 3,
+			mobileFilters: "sheet"
+		},
+		notes: {
+			why: "Resources are a collection; the library is a query plus a list of facets. Facets are DATA (label · which field · control · order) so marketers can add 'Industry' without code — but the field each facet reads is developer-locked, because it must be an indexed field. Gating is a page-level decision by resource type, not a flag copied onto every resource, and the form is a reference so submissions land in one place.",
+			sanity: "Sanity would hold `resource` documents and a `resourceLibrary` object with `featured: array<reference>`; facets are almost always hard-coded in the frontend or an Algolia config. Gating is typically a boolean on each resource.",
+			htmlSignals: [
+				"A left column (or top bar) of <fieldset>/<details> groups with checkboxes and counts in parentheses",
+				"A search <input type=search> above a card grid",
+				"Cards with a type badge (Guide, Report, Template) and a 'Download' or 'Read' action",
+				"URL query like ?type=guide&topic=close updating as filters change",
+				"A modal or redirect with a form before a PDF opens (gated)"
+			],
+			mcp: "Create col_resources with fields title, summary, type (select from the badges), topics, industry, file/url, cover. Import every card. Each filter group becomes one facet: label = group legend; field = the collection field whose values match the checkbox labels (create the field if missing, then ask the developer to index it); control from the DOM (checkbox list → checkbox, pill buttons → chips, <select> → dropdown). If downloads open a form, set gate 'form' and create/attach the form; restrict gateTypes to the badges that trigger it.",
+			pitfalls: [
+				"Facet values typed into the section drift from entry values — values always come from the collection.",
+				"A facet on a non-indexed field works in the demo, then times out at 5,000 resources.",
+				"Gating every type (including blog-like guides) hurts organic traffic; gate by type.",
+				"Pinned items that also match the filters appear twice unless the renderer de-duplicates."
+			]
+		}
+	},
+	{
+		id: "podcast-episode-list",
+		label: "Podcast episode list",
+		category: "Listings & feeds",
+		brand: "Caldera",
+		previewLayout: "list",
+		tags: [
+			"dynamic-query",
+			"media-heavy",
+			"references",
+			"conditional",
+			"repeater",
+			"embed",
+			"a11y"
+		],
+		proves: "Show-level details + platform links (repeater) · episodes by query with season filter · inline player vs episode page",
+		docTitle: "Low & Slow — the Caldera podcast",
+		urlPrefix: "caldera.bettercms.site/",
+		schema: {
+			name: "podcastEpisodes",
+			title: "Podcast episodes",
+			kind: "block",
+			icon: "microphone",
+			category: "Listings & feeds",
+			description: "The show, where to listen, and its latest episodes",
+			variants: [{
+				id: "list",
+				name: "List with player"
+			}, {
+				id: "cards",
+				name: "Cards"
+			}],
+			groups: [
+				CONTENT,
+				QUERY,
+				DESIGN
+			],
+			fieldsets: [{
+				name: "show",
+				title: "The show",
+				description: "Shown above the episode list."
+			}],
+			preview: {
+				title: "showTitle",
+				subtitle: "showDescription",
+				media: "showArt"
+			},
+			fields: [
+				{
+					name: "showTitle",
+					title: "Show name",
+					type: "string",
+					group: "content",
+					fieldset: "show",
+					validation: {
+						required: true,
+						max: 60
+					}
+				},
+				{
+					name: "showDescription",
+					title: "About the show",
+					type: "text",
+					rows: 3,
+					group: "content",
+					fieldset: "show",
+					validation: { recommendedMax: 280 },
+					localized: true,
+					description: "Podcast apps show the same text."
+				},
+				{
+					name: "showArt",
+					title: "Show art",
+					type: "image",
+					group: "content",
+					fieldset: "show",
+					validation: { required: true },
+					description: "Square, 3000 × 3000. Apps reject anything under 1400."
+				},
+				{
+					name: "hosts",
+					title: "Hosts",
+					type: "array",
+					group: "content",
+					fieldset: "show",
+					validation: { max: 3 },
+					description: "",
+					of: [{
+						name: "host",
+						title: "Host",
+						type: "reference",
+						reference: { to: ["col_authors"] }
+					}]
+				},
+				{
+					name: "platforms",
+					title: "Listen on",
+					type: "array",
+					group: "content",
+					itemNoun: "platform",
+					openMode: "inline",
+					validation: { max: 7 },
+					of: [{
+						name: "platform",
+						title: "Platform",
+						type: "object",
+						icon: "headphones",
+						preview: {
+							title: "service",
+							subtitle: "link.href"
+						},
+						fields: [{
+							name: "service",
+							title: "Service",
+							type: "select",
+							validation: { required: true },
+							options: [
+								{
+									value: "apple",
+									label: "Apple Podcasts"
+								},
+								{
+									value: "spotify",
+									label: "Spotify"
+								},
+								{
+									value: "youtube",
+									label: "YouTube"
+								},
+								{
+									value: "overcast",
+									label: "Overcast"
+								},
+								{
+									value: "pocketcasts",
+									label: "Pocket Casts"
+								},
+								{
+									value: "rss",
+									label: "RSS feed"
+								}
+							],
+							description: ""
+						}, {
+							name: "link",
+							title: "Link",
+							type: "link",
+							validation: { required: true }
+						}]
+					}]
+				},
+				{
+					name: "episodes",
+					title: "Episodes to list",
+					type: "object",
+					group: "query",
+					fields: [
+						collectionField("col_episodes", "Podcast episodes"),
+						{
+							name: "season",
+							title: "Season",
+							type: "number",
+							numeric: {
+								min: 1,
+								step: 1
+							},
+							description: "Leave empty for every season."
+						},
+						{
+							name: "types",
+							title: "Episode types",
+							type: "multiselect",
+							initialValue: ["full", "bonus"],
+							options: [
+								{
+									value: "full",
+									label: "Full"
+								},
+								{
+									value: "bonus",
+									label: "Bonus"
+								},
+								{
+									value: "trailer",
+									label: "Trailer"
+								}
+							],
+							description: ""
+						},
+						{
+							name: "sort",
+							title: "Order",
+							type: "select",
+							initialValue: "newest",
+							options: [{
+								value: "newest",
+								label: "Newest first"
+							}, {
+								value: "episode",
+								label: "Episode number"
+							}]
+						},
+						{
+							name: "limit",
+							title: "How many",
+							type: "number",
+							layout: "slider",
+							numeric: {
+								min: 3,
+								max: 30,
+								step: 1
+							},
+							initialValue: 10,
+							description: ""
+						}
+					]
+				},
+				{
+					name: "highlight",
+					title: "Highlight",
+					type: "select",
+					group: "query",
+					layout: "segmented",
+					initialValue: "latest",
+					options: [
+						{
+							value: "latest",
+							label: "Latest episode"
+						},
+						{
+							value: "pick",
+							label: "Pick one"
+						},
+						{
+							value: "none",
+							label: "None"
+						}
+					]
+				},
+				{
+					name: "featuredEpisode",
+					title: "Episode",
+					type: "reference",
+					group: "query",
+					reference: { to: ["col_episodes"] },
+					hidden: {
+						field: "highlight",
+						equals: "pick"
+					},
+					validation: { required: true }
+				},
+				{
+					name: "play",
+					title: "Play button",
+					type: "select",
+					group: "design",
+					layout: "radio",
+					initialValue: "inline",
+					options: [{
+						value: "inline",
+						label: "Plays here",
+						description: "A sticky mini player keeps playing across pages"
+					}, {
+						value: "page",
+						label: "Opens the episode page"
+					}],
+					description: ""
+				},
+				{
+					name: "showNotesPreview",
+					title: "Show notes preview",
+					type: "boolean",
+					group: "design",
+					initialValue: true
+				},
+				{
+					name: "showDuration",
+					title: "Show length",
+					type: "boolean",
+					group: "design",
+					initialValue: true,
+					description: ""
+				},
+				{
+					name: "subscribeButton",
+					title: "Subscribe button",
+					type: "button",
+					group: "content"
+				}
+			]
+		},
+		value: {
+			_variant: "list",
+			showTitle: "Low & Slow",
+			showDescription: "Conversations with the people who cook outside for a living — guides, pitmasters, foragers and the occasional blacksmith. Every other Tuesday.",
+			showArt: image("lowandslow-art", "Low & Slow podcast cover: a skillet over embers with the show name in cream type", 1500, 1500),
+			hosts: ["au_mei", "en_a1"],
+			platforms: [
+				{
+					_key: "p1",
+					service: "apple",
+					link: {
+						type: "url",
+						href: "https://podcasts.apple.com/us/podcast/low-slow/id1742210981",
+						newTab: true
+					}
+				},
+				{
+					_key: "p2",
+					service: "spotify",
+					link: {
+						type: "url",
+						href: "https://open.spotify.com/show/4kT9pQvZ2mRuLowSlow",
+						newTab: true
+					}
+				},
+				{
+					_key: "p3",
+					service: "youtube",
+					link: {
+						type: "url",
+						href: "https://www.youtube.com/@calderacooks/podcasts",
+						newTab: true
+					}
+				},
+				{
+					_key: "p4",
+					service: "rss",
+					link: {
+						type: "url",
+						href: "https://caldera.bettercms.site/podcast/feed.xml"
+					}
+				}
+			],
+			episodes: {
+				collection: "col_episodes",
+				types: ["full", "bonus"],
+				sort: "newest",
+				limit: 10
+			},
+			highlight: "latest",
+			play: "inline",
+			showNotesPreview: true,
+			showDuration: true,
+			subscribeButton: {
+				label: "Subscribe free",
+				href: "https://podcasts.apple.com/us/podcast/low-slow/id1742210981",
+				type: "url",
+				style: "primary",
+				newTab: true
+			}
+		},
+		notes: {
+			why: "Episodes are entries (they have their own page, audio file, show notes, transcript — see the Podcast episode entry), so the list is a query with a season and type filter. Show-level facts (name, art, hosts, platforms) are said once on the section because there is one show per page; if a brand runs several shows, promote them to a Shows collection and swap these fields for a show reference. Platform links are a small repeater of service + link so badges render with the right logo and order.",
+			sanity: "Sanity: `podcastShow` document + `episode` documents (`audio: file`, `season: number`); the listing is GROQ `*[_type=='episode' && show._ref==$show] | order(publishedAt desc)`. Platforms usually an array of {platform, url} objects.",
+			htmlSignals: [
+				"A square cover image next to 'Listen on' badges (Apple Podcasts, Spotify, YouTube logos)",
+				"Repeated rows with episode number, date, duration (e.g. 48 min) and a play button",
+				"<audio> elements or an embedded player iframe (Transistor, Buzzsprout, Simplecast, Spotify)",
+				"A link to an RSS feed (application/rss+xml) or 'Subscribe' button"
+			],
+			mcp: "Read the show's RSS feed if linked — it is the cleanest source: channel → show fields; each <item> → an episode entry (enclosure url → audio, itunes:duration, itunes:episode/season, content:encoded → show notes). Badges → platforms (match by logo alt/href host). Place one podcastEpisodes section with the collection query; set featured 'latest' when the top episode is larger.",
+			pitfalls: [
+				"Copying the embed iframe as the 'episode' loses the audio file and show notes — import from RSS.",
+				"Show art under 1400 px is rejected by Apple Podcasts.",
+				"Two players playing at once when several inline players exist — the renderer must use one shared player.",
+				"Trailers at the top of a 'newest' list unless types excludes them."
+			]
+		}
+	},
+	{
+		id: "changelog",
+		label: "Changelog",
+		category: "Listings & feeds",
+		brand: "Ledgerline",
+		previewLayout: "timeline",
+		tags: [
+			"deep-nesting",
+			"repeater",
+			"conditional",
+			"rich-text",
+			"validation",
+			"dynamic-query",
+			"variants"
+		],
+		proves: "Releases → changes → type tags · breaking/deprecated changes reveal a migration note · collection or written-here source",
+		docTitle: "Changelog",
+		urlPrefix: "ledgerline.com/",
+		schema: {
+			name: "changelog",
+			title: "Changelog",
+			kind: "block",
+			icon: "history",
+			category: "Listings & feeds",
+			description: "Versions and what changed in each",
+			variants: [{
+				id: "timeline",
+				name: "Timeline"
+			}, {
+				id: "compact",
+				name: "Compact"
+			}],
+			groups: [CONTENT, DESIGN],
+			preview: {
+				title: "heading",
+				subtitle: "intro",
+				icon: "history"
+			},
+			fields: [
+				{
+					name: "heading",
+					title: "Heading",
+					type: "string",
+					group: "content",
+					validation: {
+						required: true,
+						max: 48
+					},
+					localized: true
+				},
+				{
+					name: "intro",
+					title: "Intro",
+					type: "text",
+					rows: 2,
+					group: "content",
+					description: ""
+				},
+				{
+					name: "source",
+					title: "Releases come from",
+					type: "select",
+					group: "content",
+					layout: "segmented",
+					initialValue: "collection",
+					options: [{
+						value: "collection",
+						label: "Releases collection"
+					}, {
+						value: "inline",
+						label: "Written here"
+					}]
+				},
+				{
+					name: "query",
+					title: "Releases to list",
+					type: "object",
+					group: "content",
+					openMode: "inline",
+					hidden: {
+						field: "source",
+						equals: "collection"
+					},
+					fields: [
+						collectionField("col_releases", "Releases"),
+						{
+							name: "products",
+							title: "Products",
+							type: "multiselect",
+							options: [
+								{
+									value: "api",
+									label: "API"
+								},
+								{
+									value: "dashboard",
+									label: "Dashboard"
+								},
+								{
+									value: "sdk",
+									label: "SDKs"
+								}
+							],
+							description: "Leave empty for every product."
+						},
+						{
+							name: "limit",
+							title: "How many",
+							type: "number",
+							layout: "slider",
+							numeric: {
+								min: 5,
+								max: 50,
+								step: 5
+							},
+							initialValue: 10,
+							description: ""
+						}
+					]
+				},
+				{
+					name: "releases",
+					title: "Releases",
+					type: "array",
+					group: "content",
+					itemNoun: "release",
+					hidden: {
+						field: "source",
+						equals: "inline"
+					},
+					validation: { max: 60 },
+					of: [{
+						name: "release",
+						title: "Release",
+						type: "object",
+						icon: "tag",
+						preview: {
+							title: "version",
+							subtitle: "title",
+							fallback: "Untitled release"
+						},
+						fields: [
+							{
+								name: "version",
+								title: "Version",
+								type: "string",
+								validation: {
+									required: true,
+									pattern: "^v?\\d+\\.\\d+(\\.\\d+)?(-[a-z0-9.]+)?$",
+									patternMessage: "Use a version like 2.14.0 or v2.14.0-beta.1.",
+									unique: true
+								},
+								placeholder: "2.14.0",
+								description: "Also becomes the anchor, e.g. #v2-14-0."
+							},
+							{
+								name: "date",
+								title: "Release date",
+								type: "date",
+								validation: { required: true },
+								description: ""
+							},
+							{
+								name: "title",
+								title: "Headline",
+								type: "string",
+								validation: { recommendedMax: 70 }
+							},
+							{
+								name: "screenshot",
+								title: "Screenshot",
+								type: "image"
+							},
+							{
+								name: "changes",
+								title: "Changes",
+								type: "array",
+								itemNoun: "change",
+								validation: {
+									min: 1,
+									max: 40
+								},
+								of: [{
+									name: "change",
+									title: "Change",
+									type: "object",
+									icon: "point",
+									preview: {
+										title: "title",
+										subtitle: "type",
+										fallback: "Untitled change"
+									},
+									fields: [
+										{
+											name: "type",
+											title: "Type",
+											type: "select",
+											layout: "segmented",
+											validation: { required: true },
+											options: [
+												{
+													value: "new",
+													label: "New"
+												},
+												{
+													value: "improved",
+													label: "Improved"
+												},
+												{
+													value: "fixed",
+													label: "Fixed"
+												},
+												{
+													value: "deprecated",
+													label: "Deprecated"
+												},
+												{
+													value: "breaking",
+													label: "Breaking"
+												},
+												{
+													value: "security",
+													label: "Security"
+												}
+											],
+											description: ""
+										},
+										{
+											name: "title",
+											title: "What changed",
+											type: "string",
+											validation: {
+												required: true,
+												recommendedMax: 90
+											}
+										},
+										{
+											name: "details",
+											title: "Details",
+											type: "richtext"
+										},
+										{
+											name: "areas",
+											title: "Areas",
+											type: "multiselect",
+											options: [
+												{
+													value: "payments",
+													label: "Payments"
+												},
+												{
+													value: "ledger",
+													label: "Ledger"
+												},
+												{
+													value: "reports",
+													label: "Reports"
+												},
+												{
+													value: "auth",
+													label: "Auth"
+												},
+												{
+													value: "webhooks",
+													label: "Webhooks"
+												}
+											],
+											description: ""
+										},
+										{
+											name: "migration",
+											title: "How to migrate",
+											type: "richtext",
+											hidden: {
+												field: "type",
+												equals: ["breaking", "deprecated"]
+											},
+											validation: { required: true }
+										},
+										{
+											name: "removalDate",
+											title: "Removed on",
+											type: "date",
+											hidden: {
+												field: "type",
+												equals: "deprecated"
+											},
+											description: "When the deprecated behavior stops working."
+										},
+										{
+											name: "docs",
+											title: "Docs link",
+											type: "link"
+										}
+									]
+								}]
+							}
+						]
+					}]
+				},
+				{
+					name: "hasRssFeed",
+					title: "Publish an RSS feed",
+					type: "boolean",
+					group: "content",
+					initialValue: true,
+					description: "Publishes /changelog/feed.xml."
+				},
+				{
+					name: "subscribeForm",
+					title: "Email updates",
+					type: "reference",
+					group: "content",
+					reference: { to: ["form"] }
+				},
+				{
+					name: "showTypeFilter",
+					title: "Show type filter",
+					type: "boolean",
+					group: "design",
+					initialValue: true
+				},
+				{
+					name: "groupBy",
+					title: "Group by",
+					type: "select",
+					group: "design",
+					layout: "segmented",
+					initialValue: "release",
+					options: [{
+						value: "release",
+						label: "Release"
+					}, {
+						value: "month",
+						label: "Month"
+					}],
+					description: ""
+				}
+			]
+		},
+		value: {
+			_variant: "timeline",
+			heading: "Changelog",
+			intro: "Every change to the Ledgerline API, dashboard and SDKs. Breaking changes come with 90 days' notice.",
+			source: "inline",
+			query: {
+				collection: "col_releases",
+				products: [],
+				limit: 10
+			},
+			releases: [{
+				_key: "r1",
+				version: "2.14.0",
+				date: "2026-09-29",
+				title: "Multi-entity close and faster ledger exports",
+				screenshot: image("ledgerline-multientity", "The close checklist showing three entities side by side", 1600, 1e3),
+				changes: [
+					{
+						_key: "c1",
+						type: "new",
+						title: "Close several entities in one checklist",
+						details: "<p>Group subsidiaries under a parent and close them together. Intercompany eliminations post automatically.</p>",
+						areas: ["ledger", "reports"],
+						docs: {
+							type: "url",
+							href: "https://docs.ledgerline.com/guides/multi-entity-close"
+						}
+					},
+					{
+						_key: "c2",
+						type: "improved",
+						title: "Ledger CSV exports are 6× faster on books over 1M lines",
+						areas: ["reports"]
+					},
+					{
+						_key: "c3",
+						type: "fixed",
+						title: "Webhook retries no longer duplicate journal.posted events",
+						areas: ["webhooks"]
+					}
+				]
+			}, {
+				_key: "r2",
+				version: "2.13.0",
+				date: "2026-09-08",
+				title: "API versioning by date",
+				changes: [{
+					_key: "c4",
+					type: "deprecated",
+					title: "The /v1/transactions list endpoint",
+					details: "<p>Replaced by <code>GET /v2/journal-lines</code>, which paginates with cursors.</p>",
+					areas: ["ledger"],
+					migration: "<p>Switch to <code>GET /v2/journal-lines</code>. Replace <code>page</code> with the <code>cursor</code> from the previous response. Field names are unchanged.</p>",
+					removalDate: "2026-12-08",
+					docs: {
+						type: "url",
+						href: "https://docs.ledgerline.com/api/journal-lines"
+					}
+				}, {
+					_key: "c5",
+					type: "security",
+					title: "API keys can now be scoped to read-only",
+					areas: ["auth"]
+				}]
+			}],
+			hasRssFeed: true,
+			subscribeForm: "form_changelog-updates",
+			showTypeFilter: true,
+			groupBy: "release"
+		},
+		notes: {
+			why: "A changelog is releases → changes, and each change carries a TYPE that drives its badge, the type filter and — for Breaking/Deprecated only — a required migration note and removal date (conditional on the change's own type). Small products write releases right in the section; once releases need their own URLs, an RSS feed or reuse in the dashboard, switch the source to the Releases collection (same item shape) and the section becomes a query. Version is validated and unique because it doubles as the anchor.",
+			sanity: "Sanity: `release` document { version, date, changes: array<object change{type, title, body: portableText}> }; a listing GROQ orders by date. Conditional migration fields use `hidden: ({parent}) => !['breaking','deprecated'].includes(parent.type)`.",
+			htmlSignals: [
+				"Repeated date + version headings (h2/h3 like 'v2.14.0' or 'September 29, 2026')",
+				"Colored badges per line: New, Improved, Fixed, Deprecated, Breaking",
+				"A vertical line/timeline down the left with dots per release",
+				"Links to an RSS/Atom feed or 'Subscribe to updates'",
+				"Anchors per version (#v2-14-0) for deep links"
+			],
+			mcp: "Split on version/date headings → releases. Within each, every list item or sub-heading → a change; type from its badge text (map 'Added'→new, 'Changed'→improved, 'Removed'→breaking); the first sentence → title, the rest → details. If a change says 'deprecated'/'breaking' and names a replacement, put that sentence in migration. Use source 'collection' when the old site gives each release its own URL; otherwise 'inline'.",
+			pitfalls: [
+				"Free-text badges ('Bugfix', 'Fix', 'Fixed') break the type filter — always map to the select.",
+				"Breaking changes without a migration note — validation must block publish.",
+				"Version strings with spaces or dates as versions collide as anchors.",
+				"60+ releases inline makes the section slow to edit — move to the collection."
+			]
+		}
+	},
+	{
+		id: "public-roadmap",
+		label: "Public roadmap",
+		category: "Listings & feeds",
+		brand: "Ledgerline",
+		previewLayout: "grid-3",
+		tags: [
+			"deep-nesting",
+			"repeater",
+			"conditional",
+			"references",
+			"form",
+			"validation"
+		],
+		proves: "Columns → items with status, quarter and read-only vote counts · shipped items link to a release · voting + suggestion form",
+		schema: {
+			name: "roadmap",
+			title: "Public roadmap",
+			kind: "block",
+			icon: "map-2",
+			category: "Listings & feeds",
+			description: "What's planned, in progress and shipped, with votes",
+			variants: [{
+				id: "board",
+				name: "Board"
+			}, {
+				id: "list",
+				name: "Grouped list"
+			}],
+			groups: [
+				CONTENT,
+				{
+					name: "feedback",
+					title: "Feedback",
+					icon: "message-plus"
+				},
+				DESIGN
+			],
+			preview: {
+				title: "heading",
+				subtitle: "intro",
+				icon: "map-2"
+			},
+			fields: [
+				{
+					name: "heading",
+					title: "Heading",
+					type: "string",
+					group: "content",
+					validation: {
+						required: true,
+						max: 48
+					}
+				},
+				{
+					name: "intro",
+					title: "Intro",
+					type: "text",
+					rows: 2,
+					group: "content",
+					description: ""
+				},
+				{
+					name: "columns",
+					title: "Columns",
+					type: "array",
+					group: "content",
+					itemNoun: "column",
+					validation: {
+						min: 2,
+						max: 5
+					},
+					of: [{
+						name: "column",
+						title: "Column",
+						type: "object",
+						icon: "layout-columns",
+						preview: {
+							title: "title",
+							subtitle: "stage"
+						},
+						fields: [
+							{
+								name: "title",
+								title: "Title",
+								type: "string",
+								validation: {
+									required: true,
+									max: 24
+								}
+							},
+							{
+								name: "stage",
+								title: "Stage",
+								type: "select",
+								validation: { required: true },
+								options: [
+									{
+										value: "considering",
+										label: "Considering"
+									},
+									{
+										value: "planned",
+										label: "Planned"
+									},
+									{
+										value: "building",
+										label: "In progress"
+									},
+									{
+										value: "beta",
+										label: "In beta"
+									},
+									{
+										value: "shipped",
+										label: "Shipped"
+									}
+								]
+							},
+							{
+								name: "description",
+								title: "Description",
+								type: "string",
+								validation: { max: 90 }
+							},
+							{
+								name: "items",
+								title: "Items",
+								type: "array",
+								itemNoun: "item",
+								validation: { max: 25 },
+								of: [{
+									name: "item",
+									title: "Item",
+									type: "object",
+									icon: "point",
+									preview: {
+										title: "title",
+										subtitle: "quarter",
+										fallback: "Untitled item"
+									},
+									fields: [
+										{
+											name: "title",
+											title: "Title",
+											type: "string",
+											validation: {
+												required: true,
+												recommendedMax: 60
+											}
+										},
+										{
+											name: "summary",
+											title: "Summary",
+											type: "text",
+											rows: 3,
+											validation: { recommendedMax: 240 }
+										},
+										{
+											name: "area",
+											title: "Area",
+											type: "select",
+											options: [
+												{
+													value: "payments",
+													label: "Payments"
+												},
+												{
+													value: "ledger",
+													label: "Ledger"
+												},
+												{
+													value: "reports",
+													label: "Reports"
+												},
+												{
+													value: "integrations",
+													label: "Integrations"
+												}
+											],
+											description: ""
+										},
+										{
+											name: "quarter",
+											title: "Target",
+											type: "string",
+											validation: {
+												pattern: "^(Q[1-4] 20\\d\\d|H[12] 20\\d\\d|Later)$",
+												patternMessage: "Use a quarter or half, like Q3 2026, H1 2027 or Later."
+											},
+											placeholder: "Q1 2027",
+											description: "Shown as a rough target, never a promise."
+										},
+										{
+											name: "isShipped",
+											title: "Shipped",
+											type: "boolean",
+											description: "Links the card to its release notes."
+										},
+										{
+											name: "release",
+											title: "Release",
+											type: "reference",
+											reference: { to: ["col_releases"] },
+											hidden: {
+												field: "isShipped",
+												equals: true
+											},
+											validation: { required: true }
+										},
+										{
+											name: "votes",
+											title: "Votes",
+											type: "number",
+											readOnly: true,
+											description: "Counted from visitor votes. Not editable."
+										},
+										{
+											name: "discussion",
+											title: "Discussion link",
+											type: "link"
+										}
+									]
+								}]
+							}
+						]
+					}]
+				},
+				{
+					name: "allowVoting",
+					title: "Let visitors vote",
+					type: "boolean",
+					group: "feedback",
+					initialValue: true
+				},
+				{
+					name: "useEmailToVote",
+					title: "Ask for an email to vote",
+					type: "boolean",
+					group: "feedback",
+					hidden: {
+						field: "allowVoting",
+						equals: true
+					},
+					description: "One vote per email."
+				},
+				{
+					name: "suggest",
+					title: "Suggestion form",
+					type: "reference",
+					group: "feedback",
+					reference: { to: ["form"] }
+				},
+				{
+					name: "suggestButton",
+					title: "Suggestion button",
+					type: "button",
+					group: "feedback",
+					hidden: {
+						field: "suggest",
+						notEmpty: true
+					}
+				},
+				{
+					name: "sortItems",
+					title: "Sort items by",
+					type: "select",
+					group: "design",
+					layout: "segmented",
+					initialValue: "votes",
+					options: [{
+						value: "votes",
+						label: "Votes"
+					}, {
+						value: "manual",
+						label: "Your order"
+					}],
+					description: ""
+				},
+				{
+					name: "showVotes",
+					title: "Show vote counts",
+					type: "boolean",
+					group: "design",
+					initialValue: true,
+					description: "Off still lets people vote; the number stays private."
+				}
+			]
+		},
+		value: {
+			_variant: "board",
+			heading: "Roadmap",
+			intro: "What we're building next. Vote for what matters to your team — the top items shape every quarter.",
+			columns: [
+				{
+					_key: "col1",
+					title: "Planned",
+					stage: "planned",
+					description: "Scoped and scheduled.",
+					items: [{
+						_key: "i1",
+						title: "NetSuite two-way sync",
+						summary: "Push journal entries to NetSuite and pull back vendor bills without CSVs.",
+						area: "integrations",
+						quarter: "Q1 2027",
+						isShipped: false,
+						votes: 412,
+						discussion: {
+							type: "url",
+							href: "https://community.ledgerline.com/t/netsuite-two-way/1882"
+						}
+					}, {
+						_key: "i2",
+						title: "Accrual schedules",
+						summary: "Spread prepaid expenses and deferred revenue over months automatically.",
+						area: "ledger",
+						quarter: "Q1 2027",
+						isShipped: false,
+						votes: 287
+					}]
+				},
+				{
+					_key: "col2",
+					title: "In progress",
+					stage: "building",
+					items: [{
+						_key: "i3",
+						title: "Bank rules with AI suggestions",
+						summary: "Rules that learn from how you categorise and propose new ones.",
+						area: "payments",
+						quarter: "Q4 2026",
+						isShipped: false,
+						votes: 655
+					}]
+				},
+				{
+					_key: "col3",
+					title: "Shipped",
+					stage: "shipped",
+					items: [{
+						_key: "i4",
+						title: "Multi-entity close",
+						summary: "Close several entities in one checklist with automatic eliminations.",
+						area: "ledger",
+						quarter: "Q3 2026",
+						isShipped: true,
+						release: "en_rel_2-14-0",
+						votes: 903
+					}]
+				}
+			],
+			allowVoting: true,
+			useEmailToVote: true,
+			suggest: "form_roadmap-idea",
+			suggestButton: {
+				label: "Suggest a feature",
+				href: "#suggest",
+				type: "section",
+				style: "secondary"
+			},
+			sortItems: "votes",
+			showVotes: true
+		},
+		notes: {
+			why: "A board is columns → items, three levels deep (section → column → item → its release). Each column has a STAGE (a select, not just a title) so styling and filtering don't depend on wording. Votes are read-only data the site writes — editors see them but can't fake them. A shipped item must link to its release, which is a reference so it follows renames. Feedback settings sit in their own group because they are a different job from editing the plan.",
+			sanity: "Sanity: `roadmapItem` documents with `status` string and `votes` (written by a function), listed per status with GROQ. Columns are usually hard-coded. Our inline columns trade queryability for editorial order; at 100+ items move items to a collection and make each column a query by stage.",
+			htmlSignals: [
+				"3–5 side-by-side columns headed Planned / In progress / Shipped (kanban)",
+				"Cards with an upvote arrow and a number",
+				"Quarter labels like 'Q1 2027' or 'Later'",
+				"A 'Suggest a feature' / 'Submit an idea' button opening a form",
+				"Often an embedded Canny / Productboard / Featurebase widget (iframe) — import its items as data"
+			],
+			mcp: "Columns from the board headers (stage from the header text). Each card → item: title, summary (first paragraph), area (tag), quarter, votes (read-only — import the number once, then the site owns it). Cards in a 'Done/Shipped' column get shipped=true; try to match them to a release by name, else leave release empty and flag it. A Canny-style iframe: fetch its public JSON if available, otherwise keep it as an embed and say so.",
+			pitfalls: [
+				"Item stage inferred from column title text ('Now', 'Next', 'Later') — map it to the stage select explicitly.",
+				"The release condition lives on the item (shipped flag) because a field can't see its parent column's stage.",
+				"Editable vote counts invite fake numbers — keep votes read-only.",
+				"Dates as promises ('Ships Oct 3') — use quarters."
+			]
+		}
+	},
+	{
+		id: "search-results-page",
+		label: "Search results page",
+		category: "Listings & feeds",
+		brand: "Caldera",
+		previewLayout: "list",
+		tags: [
+			"dynamic-query",
+			"references",
+			"conditional",
+			"repeater",
+			"validation",
+			"a11y"
+		],
+		proves: "Configure search, don't store results · sources with weights · pinned results per keyword · empty states",
+		docTitle: "Search",
+		urlPrefix: "caldera.bettercms.site/",
+		schema: {
+			name: "searchResults",
+			title: "Search results",
+			kind: "block",
+			icon: "search",
+			category: "Listings & feeds",
+			description: "The /search page: what's searched, how results look, what shows when nothing matches",
+			variants: [{
+				id: "tabs",
+				name: "Tabs per type"
+			}, {
+				id: "mixed",
+				name: "One mixed list"
+			}],
+			groups: [
+				CONTENT,
+				{
+					name: "ranking",
+					title: "Ranking",
+					icon: "sort-descending"
+				},
+				{
+					name: "empty",
+					title: "No results",
+					icon: "mood-empty"
+				},
+				DESIGN
+			],
+			preview: {
+				title: "placeholder",
+				icon: "search"
+			},
+			fields: [
+				{
+					name: "placeholder",
+					title: "Search placeholder",
+					type: "string",
+					group: "content",
+					initialValue: "Search recipes, gear and stories",
+					validation: { max: 48 },
+					localized: true,
+					description: ""
+				},
+				{
+					name: "label",
+					title: "Name for screen readers",
+					type: "string",
+					group: "content",
+					initialValue: "Search Caldera",
+					validation: {
+						required: true,
+						max: 40
+					},
+					description: "Not shown. Read by screen readers."
+				},
+				{
+					name: "popularSearches",
+					title: "Popular searches",
+					type: "array",
+					itemNoun: "search",
+					of: [{
+						name: "search",
+						title: "Search",
+						type: "string"
+					}],
+					group: "content",
+					validation: { max: 8 }
+				},
+				{
+					name: "sources",
+					title: "What's searched",
+					type: "array",
+					group: "ranking",
+					itemNoun: "source",
+					validation: {
+						min: 1,
+						max: 6
+					},
+					of: [{
+						name: "source",
+						title: "Source",
+						type: "object",
+						icon: "database",
+						preview: {
+							title: "tabLabel",
+							subtitle: "collection"
+						},
+						fields: [
+							{
+								name: "collection",
+								title: "Collection",
+								type: "select",
+								access: { edit: "schema.manage" },
+								lockReason: "Search indexes are built per collection in code.",
+								options: [
+									{
+										value: "shopify",
+										label: "Products"
+									},
+									{
+										value: "col_recipes",
+										label: "Recipes"
+									},
+									{
+										value: "col_journal",
+										label: "Journal"
+									},
+									{
+										value: "col_faq",
+										label: "FAQs"
+									},
+									{
+										value: "page",
+										label: "Pages"
+									}
+								],
+								validation: { required: true },
+								description: ""
+							},
+							{
+								name: "tabLabel",
+								title: "Tab label",
+								type: "string",
+								validation: {
+									required: true,
+									max: 20
+								},
+								localized: true
+							},
+							{
+								name: "weight",
+								title: "Boost",
+								type: "number",
+								layout: "slider",
+								numeric: {
+									min: 1,
+									max: 5,
+									step: 1
+								},
+								initialValue: 3,
+								description: "Higher ranks this source's matches first."
+							},
+							{
+								name: "perPage",
+								title: "Results per page",
+								type: "number",
+								numeric: {
+									min: 4,
+									max: 40,
+									step: 4
+								},
+								initialValue: 12,
+								description: ""
+							}
+						]
+					}]
+				},
+				{
+					name: "pinned",
+					title: "Pinned results",
+					type: "array",
+					group: "ranking",
+					itemNoun: "pin",
+					validation: { max: 20 },
+					of: [{
+						name: "pin",
+						title: "Pin",
+						type: "object",
+						icon: "pin",
+						preview: {
+							title: "keywords",
+							subtitle: "result"
+						},
+						fields: [
+							{
+								name: "keywords",
+								title: "When someone searches",
+								type: "tags",
+								validation: {
+									required: true,
+									min: 1,
+									max: 10
+								},
+								description: "Exact searches, any case. Add plurals and misspellings."
+							},
+							{
+								name: "result",
+								title: "Show first",
+								type: "reference",
+								reference: { to: [
+									"shopify",
+									"col_recipes",
+									"col_journal",
+									"page"
+								] },
+								validation: { required: true }
+							},
+							{
+								name: "until",
+								title: "Until",
+								type: "date",
+								description: "The pin stops after this date."
+							}
+						]
+					}]
+				},
+				{
+					name: "typos",
+					title: "Forgive typos",
+					type: "select",
+					group: "ranking",
+					layout: "segmented",
+					initialValue: "1",
+					options: [
+						{
+							value: "0",
+							label: "Off"
+						},
+						{
+							value: "1",
+							label: "1 letter"
+						},
+						{
+							value: "2",
+							label: "2 letters"
+						}
+					],
+					description: "Lets \"skilet\" find skillet."
+				},
+				{
+					name: "emptyHeading",
+					title: "Heading",
+					type: "string",
+					group: "empty",
+					initialValue: "Nothing for “{query}”",
+					validation: { max: 60 },
+					description: "{query} becomes what they typed."
+				},
+				{
+					name: "emptyBody",
+					title: "Text",
+					type: "text",
+					rows: 2,
+					group: "empty",
+					description: ""
+				},
+				{
+					name: "emptyShow",
+					title: "Suggest instead",
+					type: "select",
+					group: "empty",
+					layout: "radio",
+					initialValue: "popular",
+					options: [
+						{
+							value: "popular",
+							label: "Popular searches"
+						},
+						{
+							value: "links",
+							label: "Links you choose"
+						},
+						{
+							value: "none",
+							label: "Nothing"
+						}
+					],
+					description: ""
+				},
+				{
+					name: "emptyLinks",
+					title: "Links",
+					type: "array",
+					group: "empty",
+					hidden: {
+						field: "emptyShow",
+						equals: "links"
+					},
+					validation: { max: 4 },
+					of: [{
+						name: "link",
+						title: "Link",
+						type: "link"
+					}]
+				},
+				{
+					name: "emptyButton",
+					title: "Empty button",
+					type: "button",
+					group: "empty"
+				},
+				{
+					name: "showMatchHighlights",
+					title: "Highlight matches",
+					type: "boolean",
+					group: "design",
+					initialValue: true
+				},
+				{
+					name: "showCounts",
+					title: "Count on tabs",
+					type: "boolean",
+					group: "design",
+					initialValue: true,
+					description: ""
+				}
+			]
+		},
+		value: {
+			_variant: "tabs",
+			placeholder: "Search recipes, gear and stories",
+			label: "Search Caldera",
+			popularSearches: [
+				"dutch oven",
+				"seasoning",
+				"cable fold",
+				"campfire paella",
+				"warranty"
+			],
+			sources: [
+				{
+					_key: "s1",
+					collection: "shopify",
+					tabLabel: "Gear",
+					weight: 5,
+					perPage: 12
+				},
+				{
+					_key: "s2",
+					collection: "col_recipes",
+					tabLabel: "Recipes",
+					weight: 4,
+					perPage: 12
+				},
+				{
+					_key: "s3",
+					collection: "col_journal",
+					tabLabel: "Stories",
+					weight: 3,
+					perPage: 8
+				},
+				{
+					_key: "s4",
+					collection: "col_faq",
+					tabLabel: "Help",
+					weight: 2,
+					perPage: 8
+				}
+			],
+			pinned: [
+				{
+					_key: "pn1",
+					keywords: [
+						"seasoning",
+						"season",
+						"how to season"
+					],
+					result: "en_1"
+				},
+				{
+					_key: "pn2",
+					keywords: [
+						"grill grate",
+						"grate",
+						"cable fold"
+					],
+					result: "gid://shopify/Product/8812"
+				},
+				{
+					_key: "pn3",
+					keywords: ["spring sale", "spring"],
+					result: "pg_spring",
+					until: "2027-05-31"
+				}
+			],
+			typos: "1",
+			emptyHeading: "Nothing for “{query}”",
+			emptyBody: "Check the spelling, or try a broader word like “skillet” or “bread”.",
+			emptyShow: "popular",
+			emptyLinks: [],
+			emptyButton: {
+				label: "Ask our cooks",
+				href: "/contact",
+				type: "page",
+				pageId: "pg_contact",
+				title: "Contact",
+				style: "secondary"
+			},
+			showMatchHighlights: true,
+			showCounts: true
+		},
+		notes: {
+			why: "A results page never stores results; it stores how search behaves on this site. Sources map to indexes that are built in code, so the collection is locked while the label, boost and page size are editorial. Pinned results are the one hand-curated part — keyword tags → a reference — with an optional end date so seasonal pins don't rot. The empty state is its own group because it is what most people judge search by.",
+			sanity: "No Sanity equivalent in-schema: search config usually lives in Algolia/Typesense dashboards. A `searchSettings` singleton with `promoted: array<{terms: array<string>, doc: reference}>` is the closest pattern.",
+			htmlSignals: [
+				"A page at /search with ?q= or ?query= in the URL and a prominent <input type=search>",
+				"Result tabs or filters by type (All, Products, Recipes, Articles) with counts",
+				"Highlighted <mark> or <em> around matching words in snippets",
+				"A 'No results for …' message with suggestions"
+			],
+			mcp: "Don't import results. Create one searchResults section on the /search page. Tabs → sources (match each tab to a collection; ask the developer to index any that aren't). Popular or suggested chips → popularSearches. Visible 'Featured' or 'Top result' cards for a query you can reproduce → pinned. Copy the no-results text into the empty group with {query} for the echoed term.",
+			pitfalls: [
+				"Pins pointing at unpublished items show nothing — validate on publish.",
+				"Typo tolerance 2 on short words (≤4 letters) returns noise.",
+				"A label-less search input fails WCAG 1.3.1 / 4.1.2 — label is required.",
+				"Search pages must be noindex — the platform does it natively; never add a field for it."
+			]
+		}
+	}
+];
+//#endregion
+export { ENTRIES };
+
+//# sourceMappingURL=listings.entries.js.map