@bettercms-ai/kit 0.1.1 → 2.0.0

package/dist/library/entries/media.entries.js

@@ -0,0 +1,2781 @@
+//#region src/library/entries/media.entries.ts
+var img = (seed, alt, w = 1600, h = 1067, focal) => ({
+	url: `https://picsum.photos/seed/${seed}/${w}/${h}`,
+	alt,
+	name: `${seed}.jpg`,
+	width: w * 2,
+	height: h * 2,
+	...focal ? { focal } : {}
+});
+var GROUPS = [
+	{
+		name: "content",
+		title: "Content",
+		default: true
+	},
+	{
+		name: "media",
+		title: "Media"
+	},
+	{
+		name: "design",
+		title: "Design"
+	}
+];
+var theme = {
+	name: "theme",
+	title: "Theme",
+	type: "select",
+	group: "design",
+	layout: "segmented",
+	initialValue: "light",
+	options: [
+		{
+			value: "light",
+			label: "Light"
+		},
+		{
+			value: "dark",
+			label: "Dark"
+		},
+		{
+			value: "brand",
+			label: "Brand"
+		}
+	]
+};
+var credit = {
+	name: "credit",
+	title: "Credit",
+	type: "object",
+	icon: "camera",
+	openMode: "inline",
+	fields: [{
+		name: "name",
+		title: "Name",
+		type: "string",
+		validation: { max: 48 }
+	}, {
+		name: "link",
+		title: "Link",
+		type: "link"
+	}]
+};
+var masonry = {
+	name: "masonryGallery",
+	title: "Masonry gallery",
+	kind: "block",
+	icon: "layout-board",
+	category: "Media & galleries",
+	description: "Photos at their natural shapes, packed in columns, with captions and credits",
+	variants: [{
+		id: "masonry",
+		name: "Masonry",
+		description: "Natural heights, columns"
+	}, {
+		id: "justified",
+		name: "Justified rows",
+		description: "Equal row heights, natural widths"
+	}],
+	preview: {
+		title: "heading",
+		media: "images.0.image",
+		icon: "layout-board"
+	},
+	groups: GROUPS,
+	fields: [
+		{
+			name: "heading",
+			title: "Heading",
+			type: "string",
+			validation: { recommendedMax: 60 },
+			localized: true
+		},
+		{
+			name: "intro",
+			title: "Intro",
+			type: "text",
+			rows: 2,
+			localized: true
+		},
+		{
+			name: "images",
+			title: "Photos",
+			type: "array",
+			group: "media",
+			itemNoun: "photo",
+			arrayLayout: "grid",
+			validation: {
+				min: 3,
+				max: 60
+			},
+			of: [{
+				name: "photo",
+				title: "Photo",
+				type: "object",
+				icon: "photo",
+				preview: {
+					title: "caption",
+					subtitle: "credit.name",
+					media: "image",
+					fallback: "Untitled photo"
+				},
+				fields: [
+					{
+						name: "image",
+						title: "Image",
+						type: "image",
+						validation: { required: true },
+						description: "At least 1600px on the long side."
+					},
+					{
+						name: "caption",
+						title: "Caption",
+						type: "text",
+						rows: 2,
+						validation: { max: 200 },
+						localized: true,
+						description: "Shown on hover and in the lightbox."
+					},
+					credit,
+					{
+						name: "link",
+						title: "Link",
+						type: "link",
+						description: "Opens this instead of the lightbox."
+					}
+				]
+			}]
+		},
+		{
+			name: "useLightbox",
+			title: "Open in a lightbox",
+			type: "boolean",
+			group: "design",
+			initialValue: true
+		},
+		{
+			name: "captionDisplay",
+			title: "Captions",
+			type: "select",
+			group: "design",
+			layout: "segmented",
+			initialValue: "hover",
+			options: [
+				{
+					value: "below",
+					label: "Below"
+				},
+				{
+					value: "hover",
+					label: "On hover"
+				},
+				{
+					value: "lightbox",
+					label: "Lightbox only"
+				}
+			]
+		},
+		{
+			name: "desktopColumns",
+			title: "Columns on desktop",
+			type: "number",
+			group: "design",
+			layout: "slider",
+			initialValue: 3,
+			numeric: {
+				min: 2,
+				max: 5,
+				step: 1
+			}
+		},
+		{
+			name: "tabletColumns",
+			title: "Columns on tablet",
+			type: "number",
+			group: "design",
+			layout: "slider",
+			initialValue: 2,
+			numeric: {
+				min: 1,
+				max: 3,
+				step: 1
+			}
+		},
+		{
+			name: "phoneColumns",
+			title: "Columns on phones",
+			type: "number",
+			group: "design",
+			layout: "slider",
+			initialValue: 1,
+			numeric: {
+				min: 1,
+				max: 2,
+				step: 1
+			}
+		},
+		{
+			name: "gap",
+			title: "Gap",
+			type: "select",
+			group: "design",
+			layout: "segmented",
+			initialValue: "md",
+			options: [
+				{
+					value: "none",
+					label: "None"
+				},
+				{
+					value: "sm",
+					label: "S"
+				},
+				{
+					value: "md",
+					label: "M"
+				},
+				{
+					value: "lg",
+					label: "L"
+				}
+			]
+		},
+		theme
+	]
+};
+var filterGallery = {
+	name: "filterGallery",
+	title: "Gallery with filters",
+	kind: "block",
+	icon: "photo-search",
+	category: "Media & galleries",
+	description: "A uniform grid filtered by category chips; every photo opens in a lightbox",
+	variants: [{
+		id: "square",
+		name: "Square tiles"
+	}, {
+		id: "landscape",
+		name: "Landscape tiles",
+		description: "4:3"
+	}],
+	preview: {
+		title: "heading",
+		media: "images.0.image",
+		icon: "photo-search"
+	},
+	groups: GROUPS,
+	fields: [
+		{
+			name: "heading",
+			title: "Heading",
+			type: "string",
+			validation: { recommendedMax: 60 },
+			localized: true
+		},
+		{
+			name: "categories",
+			title: "Filters",
+			type: "array",
+			itemNoun: "filter",
+			validation: {
+				min: 2,
+				max: 8
+			},
+			of: [{
+				name: "category",
+				title: "Filter",
+				type: "object",
+				icon: "filter",
+				openMode: "inline",
+				preview: {
+					title: "label",
+					subtitle: "key"
+				},
+				fields: [{
+					name: "label",
+					title: "Label",
+					type: "string",
+					validation: {
+						required: true,
+						max: 20
+					},
+					localized: true
+				}, {
+					name: "key",
+					title: "Key",
+					type: "slug",
+					validation: {
+						required: true,
+						unique: true
+					},
+					description: "Changing it unlinks the photos that use it."
+				}]
+			}]
+		},
+		{
+			name: "allLabel",
+			title: "\"All\" chip label",
+			type: "string",
+			initialValue: "All",
+			validation: { max: 16 },
+			localized: true,
+			description: "Leave empty to hide the All chip."
+		},
+		{
+			name: "images",
+			title: "Photos",
+			type: "array",
+			group: "media",
+			itemNoun: "photo",
+			arrayLayout: "grid",
+			validation: {
+				min: 4,
+				max: 120
+			},
+			of: [{
+				name: "photo",
+				title: "Photo",
+				type: "object",
+				icon: "photo",
+				preview: {
+					title: "caption",
+					subtitle: "categories",
+					media: "image",
+					fallback: "Untitled photo"
+				},
+				fields: [
+					{
+						name: "image",
+						title: "Image",
+						type: "image",
+						validation: { required: true }
+					},
+					{
+						name: "categories",
+						title: "Filters",
+						type: "tags",
+						validation: { min: 1 },
+						description: "Filter keys, e.g. rooms, dining."
+					},
+					{
+						name: "caption",
+						title: "Caption",
+						type: "text",
+						rows: 2,
+						validation: { max: 160 },
+						localized: true,
+						description: "Shown in the lightbox."
+					}
+				]
+			}]
+		},
+		{
+			name: "useUrlFilter",
+			title: "Remember filter in the URL",
+			type: "boolean",
+			group: "design",
+			advanced: true
+		},
+		{
+			name: "columns",
+			title: "Columns on desktop",
+			type: "number",
+			group: "design",
+			layout: "slider",
+			initialValue: 4,
+			numeric: {
+				min: 2,
+				max: 6,
+				step: 1
+			}
+		},
+		{
+			name: "initialCount",
+			title: "Show before \"Load more\"",
+			type: "number",
+			group: "design",
+			initialValue: 12,
+			numeric: {
+				min: 4,
+				max: 48,
+				step: 4
+			}
+		},
+		theme
+	]
+};
+var videoSection = {
+	name: "videoSection",
+	title: "Video",
+	kind: "block",
+	icon: "player-play",
+	category: "Media & galleries",
+	description: "A featured video from YouTube, Vimeo or your own host, with captions, chapters and a transcript",
+	variants: [
+		{
+			id: "contained",
+			name: "Contained",
+			description: "Inside the page width with a title above"
+		},
+		{
+			id: "fullbleed",
+			name: "Full width"
+		},
+		{
+			id: "split",
+			name: "Split",
+			description: "Video beside the text and chapter list"
+		}
+	],
+	preview: {
+		title: "title",
+		media: "poster",
+		icon: "player-play"
+	},
+	groups: [
+		{
+			name: "content",
+			title: "Content",
+			default: true
+		},
+		{
+			name: "access",
+			title: "Captions & chapters"
+		},
+		{
+			name: "design",
+			title: "Playback"
+		}
+	],
+	fields: [
+		{
+			name: "eyebrow",
+			title: "Eyebrow",
+			type: "string",
+			validation: { max: 32 }
+		},
+		{
+			name: "title",
+			title: "Title",
+			type: "string",
+			validation: {
+				required: true,
+				recommendedMax: 70
+			},
+			localized: true,
+			description: "Also the video's name for search engines."
+		},
+		{
+			name: "description",
+			title: "Description",
+			type: "text",
+			rows: 3,
+			validation: { recommendedMax: 300 },
+			localized: true,
+			description: "Also sent to search engines."
+		},
+		{
+			name: "source",
+			title: "Hosted on",
+			type: "select",
+			layout: "segmented",
+			initialValue: "youtube",
+			options: [
+				{
+					value: "youtube",
+					label: "YouTube"
+				},
+				{
+					value: "vimeo",
+					label: "Vimeo"
+				},
+				{
+					value: "hosted",
+					label: "Our media library"
+				}
+			]
+		},
+		{
+			name: "video",
+			title: "Video link",
+			type: "video",
+			hidden: {
+				field: "source",
+				equals: ["youtube", "vimeo"]
+			},
+			validation: { required: true },
+			description: "Paste the watch link."
+		},
+		{
+			name: "file",
+			title: "Video file",
+			type: "file",
+			hidden: {
+				field: "source",
+				equals: "hosted"
+			},
+			validation: { required: true },
+			description: "MP4 (H.264) up to 500 MB."
+		},
+		{
+			name: "poster",
+			title: "Poster",
+			type: "image",
+			validation: { required: true },
+			description: "At 16:9."
+		},
+		{
+			name: "duration",
+			title: "Length",
+			type: "string",
+			placeholder: "4:32",
+			validation: {
+				required: true,
+				pattern: "^(\\d{1,2}:)?\\d{1,2}:\\d{2}$",
+				patternMessage: "Use m:ss or h:mm:ss, like 4:05."
+			},
+			description: "Also sent to search engines."
+		},
+		{
+			name: "uploadDate",
+			title: "Published",
+			type: "date",
+			validation: { required: true },
+			description: "The date the video first went public."
+		},
+		{
+			name: "captions",
+			title: "Caption tracks",
+			type: "array",
+			group: "access",
+			itemNoun: "caption track",
+			hidden: {
+				field: "source",
+				equals: "hosted"
+			},
+			validation: {
+				min: 1,
+				max: 12
+			},
+			description: "One WebVTT file per language.",
+			of: [{
+				name: "track",
+				title: "Caption track",
+				type: "object",
+				icon: "badge-cc",
+				preview: {
+					title: "label",
+					subtitle: "language"
+				},
+				fields: [
+					{
+						name: "language",
+						title: "Language",
+						type: "string",
+						validation: {
+							required: true,
+							pattern: "^[a-z]{2}(-[A-Z]{2})?$",
+							patternMessage: "Use a language code, like en or es-MX."
+						},
+						placeholder: "en"
+					},
+					{
+						name: "label",
+						title: "Label",
+						type: "string",
+						validation: {
+							required: true,
+							max: 24
+						},
+						placeholder: "English",
+						description: "Shown in the captions menu."
+					},
+					{
+						name: "file",
+						title: "WebVTT file",
+						type: "file",
+						validation: { required: true }
+					},
+					{
+						name: "kind",
+						title: "Kind",
+						type: "select",
+						layout: "segmented",
+						initialValue: "captions",
+						options: [{
+							value: "captions",
+							label: "Captions",
+							description: "Speech plus sounds"
+						}, {
+							value: "subtitles",
+							label: "Subtitles",
+							description: "Translated speech only"
+						}]
+					},
+					{
+						name: "isOnByDefault",
+						title: "On by default",
+						type: "boolean",
+						description: "One track at most."
+					}
+				]
+			}]
+		},
+		{
+			name: "chapters",
+			title: "Chapters",
+			type: "array",
+			group: "access",
+			itemNoun: "chapter",
+			validation: { max: 30 },
+			description: "The first one must start at 0:00.",
+			of: [{
+				name: "chapter",
+				title: "Chapter",
+				type: "object",
+				icon: "list",
+				openMode: "inline",
+				preview: {
+					title: "title",
+					subtitle: "start"
+				},
+				fields: [{
+					name: "start",
+					title: "Starts at",
+					type: "string",
+					placeholder: "1:05",
+					validation: {
+						required: true,
+						pattern: "^(\\d{1,2}:)?\\d{1,2}:\\d{2}$",
+						patternMessage: "Use m:ss or h:mm:ss, like 4:05."
+					}
+				}, {
+					name: "title",
+					title: "Title",
+					type: "string",
+					validation: {
+						required: true,
+						max: 60
+					},
+					localized: true
+				}]
+			}]
+		},
+		{
+			name: "transcript",
+			title: "Transcript",
+			type: "richtext",
+			group: "access",
+			localized: true
+		},
+		{
+			name: "button",
+			title: "Button",
+			type: "button"
+		},
+		{
+			name: "autoplay",
+			title: "Play automatically",
+			type: "boolean",
+			group: "design"
+		},
+		{
+			name: "loop",
+			title: "Loop the video",
+			type: "boolean",
+			group: "design",
+			hidden: {
+				field: "autoplay",
+				equals: true
+			}
+		},
+		{
+			name: "controls",
+			title: "Show player controls",
+			type: "boolean",
+			group: "design",
+			initialValue: true
+		},
+		{
+			name: "startAt",
+			title: "Start at",
+			type: "string",
+			group: "design",
+			advanced: true,
+			placeholder: "0:30",
+			validation: {
+				pattern: "^((\\d{1,2}:)?\\d{1,2}:\\d{2})?$",
+				patternMessage: "Use m:ss, like 1:24."
+			}
+		},
+		{
+			name: "usePrivacyMode",
+			title: "Privacy-enhanced embed",
+			type: "boolean",
+			group: "design",
+			initialValue: true,
+			hidden: {
+				field: "source",
+				equals: "youtube"
+			},
+			description: "No tracking cookies until play."
+		},
+		theme
+	]
+};
+var beforeAfter = {
+	name: "beforeAfter",
+	title: "Before and after",
+	kind: "block",
+	icon: "arrows-horizontal",
+	category: "Media & galleries",
+	description: "A draggable divider comparing two photos of the same view",
+	variants: [{
+		id: "single",
+		name: "Single comparison"
+	}, {
+		id: "tabs",
+		name: "Several comparisons",
+		description: "Tabs switch between projects"
+	}],
+	preview: {
+		title: "heading",
+		media: "comparisons.0.after",
+		icon: "arrows-horizontal"
+	},
+	groups: GROUPS,
+	fields: [
+		{
+			name: "eyebrow",
+			title: "Eyebrow",
+			type: "string",
+			validation: { max: 32 }
+		},
+		{
+			name: "heading",
+			title: "Heading",
+			type: "string",
+			validation: { recommendedMax: 60 },
+			localized: true
+		},
+		{
+			name: "comparisons",
+			title: "Comparisons",
+			type: "array",
+			group: "media",
+			itemNoun: "comparison",
+			validation: {
+				min: 1,
+				max: 6
+			},
+			description: "Add more than one to show tabs.",
+			of: [{
+				name: "comparison",
+				title: "Comparison",
+				type: "object",
+				icon: "arrows-horizontal",
+				preview: {
+					title: "label",
+					subtitle: "caption",
+					media: "after",
+					fallback: "Untitled comparison"
+				},
+				fields: [
+					{
+						name: "label",
+						title: "Tab label",
+						type: "string",
+						validation: { max: 24 },
+						localized: true,
+						description: "Only shown when there are several."
+					},
+					{
+						name: "before",
+						title: "Before",
+						type: "image",
+						validation: { required: true },
+						description: "Same position, size and crop as After."
+					},
+					{
+						name: "after",
+						title: "After",
+						type: "image",
+						validation: { required: true }
+					},
+					{
+						name: "beforeLabel",
+						title: "Before label",
+						type: "string",
+						initialValue: "Before",
+						validation: { max: 16 },
+						localized: true
+					},
+					{
+						name: "afterLabel",
+						title: "After label",
+						type: "string",
+						initialValue: "After",
+						validation: { max: 16 },
+						localized: true
+					},
+					{
+						name: "caption",
+						title: "Caption",
+						type: "text",
+						rows: 2,
+						validation: { max: 200 },
+						localized: true
+					},
+					credit
+				]
+			}]
+		},
+		{
+			name: "start",
+			title: "Divider starts at",
+			type: "number",
+			group: "design",
+			layout: "slider",
+			initialValue: 50,
+			numeric: {
+				min: 10,
+				max: 90,
+				step: 5,
+				unit: "%"
+			}
+		},
+		{
+			name: "orientation",
+			title: "Direction",
+			type: "select",
+			group: "design",
+			layout: "segmented",
+			initialValue: "horizontal",
+			options: [{
+				value: "horizontal",
+				label: "Side by side"
+			}, {
+				value: "vertical",
+				label: "Top and bottom"
+			}]
+		},
+		{
+			name: "showHint",
+			title: "Nudge on first view",
+			type: "boolean",
+			group: "design",
+			initialValue: true
+		},
+		theme
+	]
+};
+var hotspots = {
+	name: "imageHotspots",
+	title: "Image with hotspots",
+	kind: "block",
+	icon: "focus-2",
+	category: "Media & galleries",
+	description: "Pins on a photo that open a product card or a note: shop the look, label the parts",
+	variants: [{
+		id: "pins",
+		name: "Pins",
+		description: "Numbered dots with pop-up cards"
+	}, {
+		id: "sidebar",
+		name: "Pins + list",
+		description: "A list beside the photo highlights each pin"
+	}],
+	preview: {
+		title: "heading",
+		media: "image",
+		icon: "focus-2"
+	},
+	groups: GROUPS,
+	fields: [
+		{
+			name: "eyebrow",
+			title: "Eyebrow",
+			type: "string",
+			validation: { max: 32 }
+		},
+		{
+			name: "heading",
+			title: "Heading",
+			type: "string",
+			validation: { recommendedMax: 60 },
+			localized: true
+		},
+		{
+			name: "image",
+			title: "Image",
+			type: "image",
+			group: "media",
+			validation: { required: true },
+			description: "Pins are placed in % of this photo. Changing the crop moves them."
+		},
+		{
+			name: "mobileImage",
+			title: "Phone photo",
+			type: "image",
+			group: "media",
+			advanced: true,
+			description: "Pins show as a list on this crop."
+		},
+		{
+			name: "hotspots",
+			title: "Hotspots",
+			type: "array",
+			itemNoun: "hotspot",
+			validation: {
+				min: 1,
+				max: 12
+			},
+			of: [{
+				name: "hotspot",
+				title: "Hotspot",
+				type: "object",
+				icon: "point",
+				preview: {
+					title: "label",
+					subtitle: "kind",
+					fallback: "Untitled hotspot"
+				},
+				fields: [
+					{
+						name: "label",
+						title: "Label",
+						type: "string",
+						validation: {
+							required: true,
+							max: 48
+						},
+						localized: true,
+						description: "Not shown. Read by screen readers."
+					},
+					{
+						name: "x",
+						title: "Across",
+						type: "number",
+						layout: "slider",
+						validation: { required: true },
+						numeric: {
+							min: 0,
+							max: 100,
+							step: .5,
+							unit: "%"
+						},
+						description: "0 is the left edge, 100 the right."
+					},
+					{
+						name: "y",
+						title: "Down",
+						type: "number",
+						layout: "slider",
+						validation: { required: true },
+						numeric: {
+							min: 0,
+							max: 100,
+							step: .5,
+							unit: "%"
+						},
+						description: "0 is the top edge, 100 the bottom."
+					},
+					{
+						name: "kind",
+						title: "Opens",
+						type: "select",
+						layout: "segmented",
+						initialValue: "product",
+						options: [{
+							value: "product",
+							label: "Product"
+						}, {
+							value: "note",
+							label: "Note"
+						}]
+					},
+					{
+						name: "product",
+						title: "Product",
+						type: "reference",
+						reference: { to: ["shopify"] },
+						hidden: {
+							field: "kind",
+							equals: "product"
+						},
+						validation: { required: true }
+					},
+					{
+						name: "title",
+						title: "Title",
+						type: "string",
+						hidden: {
+							field: "kind",
+							equals: "note"
+						},
+						validation: {
+							required: true,
+							max: 48
+						},
+						localized: true
+					},
+					{
+						name: "body",
+						title: "Body",
+						type: "text",
+						rows: 3,
+						hidden: {
+							field: "kind",
+							equals: "note"
+						},
+						validation: { max: 240 },
+						localized: true
+					},
+					{
+						name: "link",
+						title: "Link",
+						type: "link",
+						hidden: {
+							field: "kind",
+							equals: "note"
+						}
+					},
+					{
+						name: "cardSide",
+						title: "Card opens",
+						type: "select",
+						layout: "segmented",
+						initialValue: "auto",
+						advanced: true,
+						options: [
+							{
+								value: "auto",
+								label: "Auto"
+							},
+							{
+								value: "left",
+								label: "Left"
+							},
+							{
+								value: "right",
+								label: "Right"
+							},
+							{
+								value: "top",
+								label: "Above"
+							}
+						]
+					}
+				]
+			}]
+		},
+		{
+			name: "pinStyle",
+			title: "Pin style",
+			type: "select",
+			group: "design",
+			layout: "segmented",
+			initialValue: "number",
+			options: [
+				{
+					value: "dot",
+					label: "Dot"
+				},
+				{
+					value: "plus",
+					label: "Plus"
+				},
+				{
+					value: "number",
+					label: "Number"
+				}
+			]
+		},
+		{
+			name: "usePulse",
+			title: "Pulse pins",
+			type: "boolean",
+			group: "design",
+			initialValue: true
+		},
+		theme
+	]
+};
+var interactiveEmbed = {
+	name: "interactiveEmbed",
+	title: "Interactive embed",
+	kind: "block",
+	icon: "box",
+	category: "Media & galleries",
+	description: "A spinnable 3D model, a Lottie animation or a hosted 360°/Spline scene, with a still fallback",
+	variants: [{
+		id: "contained",
+		name: "Contained"
+	}, {
+		id: "split",
+		name: "Split",
+		description: "Viewer beside heading and copy"
+	}],
+	preview: {
+		title: "heading",
+		media: "fallback",
+		icon: "box"
+	},
+	groups: GROUPS,
+	fields: [
+		{
+			name: "eyebrow",
+			title: "Eyebrow",
+			type: "string",
+			validation: { max: 32 }
+		},
+		{
+			name: "heading",
+			title: "Heading",
+			type: "string",
+			validation: { recommendedMax: 60 },
+			localized: true
+		},
+		{
+			name: "body",
+			title: "Body",
+			type: "richtext",
+			localized: true
+		},
+		{
+			name: "kind",
+			title: "Type",
+			type: "select",
+			layout: "cards",
+			group: "media",
+			initialValue: "model",
+			options: [
+				{
+					value: "model",
+					label: "3D model",
+					icon: "box",
+					description: "A .glb file people can spin and view in AR"
+				},
+				{
+					value: "lottie",
+					label: "Lottie animation",
+					icon: "sparkles",
+					description: "A .json or .lottie file"
+				},
+				{
+					value: "iframe",
+					label: "Hosted scene",
+					icon: "world",
+					description: "Spline, Sketchfab, Matterport or a 360° tour"
+				}
+			]
+		},
+		{
+			name: "model",
+			title: "Model file",
+			type: "file",
+			group: "media",
+			hidden: {
+				field: "kind",
+				equals: "model"
+			},
+			validation: { required: true },
+			description: "GLB under 8 MB."
+		},
+		{
+			name: "iosModel",
+			title: "iPhone AR file",
+			type: "file",
+			group: "media",
+			hidden: {
+				field: "kind",
+				equals: "model"
+			},
+			description: "USDZ, so iPhones can place it in the room."
+		},
+		{
+			name: "cameraOrbit",
+			title: "Starting angle",
+			type: "string",
+			group: "media",
+			hidden: {
+				field: "kind",
+				equals: "model"
+			},
+			placeholder: "30deg 75deg 2m",
+			advanced: true,
+			description: "Rotation, tilt and distance, e.g. 45deg 60deg 2m."
+		},
+		{
+			name: "useAutoRotate",
+			title: "Rotate slowly",
+			type: "boolean",
+			group: "design",
+			hidden: {
+				field: "kind",
+				equals: "model"
+			},
+			initialValue: true
+		},
+		{
+			name: "lottie",
+			title: "Animation file",
+			type: "file",
+			group: "media",
+			hidden: {
+				field: "kind",
+				equals: "lottie"
+			},
+			validation: { required: true },
+			description: "Lottie .json or .lottie, under 500 KB."
+		},
+		{
+			name: "loop",
+			title: "Loop the animation",
+			type: "boolean",
+			group: "design",
+			hidden: {
+				field: "kind",
+				equals: "lottie"
+			},
+			initialValue: true
+		},
+		{
+			name: "playOn",
+			title: "Play",
+			type: "select",
+			group: "design",
+			hidden: {
+				field: "kind",
+				equals: "lottie"
+			},
+			layout: "segmented",
+			initialValue: "view",
+			options: [
+				{
+					value: "view",
+					label: "In view"
+				},
+				{
+					value: "hover",
+					label: "On hover"
+				},
+				{
+					value: "scroll",
+					label: "With scroll"
+				}
+			]
+		},
+		{
+			name: "embedUrl",
+			title: "Scene link",
+			type: "url",
+			group: "media",
+			hidden: {
+				field: "kind",
+				equals: "iframe"
+			},
+			validation: {
+				required: true,
+				pattern: "^https://(my\\.spline\\.design|prod\\.spline\\.design|sketchfab\\.com|my\\.matterport\\.com|kuula\\.co)/",
+				patternMessage: "Use a Spline, Sketchfab, Matterport or Kuula link, like https://my.spline.design/caldera."
+			},
+			description: "The share or embed link from the host.",
+			helpMore: "Only allow-listed hosts load. Ask a developer to add another."
+		},
+		{
+			name: "fallback",
+			title: "Still image",
+			type: "image",
+			group: "media",
+			validation: { required: true }
+		},
+		{
+			name: "label",
+			title: "Accessible name",
+			type: "string",
+			validation: {
+				required: true,
+				max: 120
+			},
+			localized: true,
+			description: "Not shown. Read by screen readers."
+		},
+		{
+			name: "aspect",
+			title: "Shape",
+			type: "select",
+			group: "design",
+			layout: "segmented",
+			initialValue: "4:3",
+			options: [
+				{
+					value: "1:1",
+					label: "Square"
+				},
+				{
+					value: "4:3",
+					label: "4:3"
+				},
+				{
+					value: "16:9",
+					label: "16:9"
+				}
+			]
+		},
+		{
+			name: "loadOn",
+			title: "Load",
+			type: "select",
+			group: "design",
+			layout: "segmented",
+			initialValue: "click",
+			options: [{
+				value: "view",
+				label: "In view"
+			}, {
+				value: "click",
+				label: "On click"
+			}]
+		},
+		theme
+	]
+};
+var carousel = {
+	name: "mediaCarousel",
+	title: "Mixed-media carousel",
+	kind: "block",
+	icon: "carousel-horizontal",
+	category: "Media & galleries",
+	description: "Slides of different kinds (photo, video, quote, product) in one swipeable row",
+	variants: [
+		{
+			id: "peek",
+			name: "Peek",
+			description: "Shows a slice of the next slide"
+		},
+		{
+			id: "full",
+			name: "One at a time"
+		},
+		{
+			id: "cards",
+			name: "Cards",
+			description: "Several slides visible"
+		}
+	],
+	preview: {
+		title: "heading",
+		icon: "carousel-horizontal"
+	},
+	groups: GROUPS,
+	fields: [
+		{
+			name: "eyebrow",
+			title: "Eyebrow",
+			type: "string",
+			validation: { max: 32 }
+		},
+		{
+			name: "heading",
+			title: "Heading",
+			type: "string",
+			validation: { recommendedMax: 60 },
+			localized: true
+		},
+		{
+			name: "slides",
+			title: "Slides",
+			type: "array",
+			itemNoun: "slide",
+			validation: {
+				min: 2,
+				max: 16
+			},
+			of: [
+				{
+					name: "imageSlide",
+					title: "Photo",
+					type: "object",
+					icon: "photo",
+					preview: {
+						title: "caption",
+						media: "image",
+						fallback: "Untitled photo slide"
+					},
+					fields: [
+						{
+							name: "image",
+							title: "Image",
+							type: "image",
+							validation: { required: true }
+						},
+						{
+							name: "caption",
+							title: "Caption",
+							type: "string",
+							validation: { max: 120 },
+							localized: true
+						},
+						{
+							name: "link",
+							title: "Link",
+							type: "link"
+						}
+					]
+				},
+				{
+					name: "videoSlide",
+					title: "Video",
+					type: "object",
+					icon: "player-play",
+					preview: {
+						title: "caption",
+						media: "poster",
+						fallback: "Untitled video slide"
+					},
+					fields: [
+						{
+							name: "video",
+							title: "Video",
+							type: "video",
+							validation: { required: true }
+						},
+						{
+							name: "poster",
+							title: "Poster",
+							type: "image",
+							validation: { required: true }
+						},
+						{
+							name: "captions",
+							title: "Captions",
+							type: "file",
+							description: "WebVTT. Required if the clip has speech."
+						},
+						{
+							name: "caption",
+							title: "Caption",
+							type: "string",
+							validation: { max: 120 },
+							localized: true
+						},
+						{
+							name: "muted",
+							title: "Start muted",
+							type: "boolean",
+							initialValue: true
+						}
+					]
+				},
+				{
+					name: "quoteSlide",
+					title: "Quote",
+					type: "object",
+					icon: "quote",
+					preview: {
+						title: "author",
+						subtitle: "quote",
+						media: "photo",
+						fallback: "Untitled quote slide"
+					},
+					fields: [
+						{
+							name: "quote",
+							title: "Quote",
+							type: "text",
+							rows: 3,
+							validation: {
+								required: true,
+								recommendedMax: 180
+							},
+							localized: true
+						},
+						{
+							name: "author",
+							title: "Name",
+							type: "string",
+							validation: { required: true }
+						},
+						{
+							name: "role",
+							title: "Role",
+							type: "string",
+							localized: true
+						},
+						{
+							name: "photo",
+							title: "Photo",
+							type: "image"
+						},
+						{
+							name: "background",
+							title: "Background image",
+							type: "image"
+						}
+					]
+				},
+				{
+					name: "productSlide",
+					title: "Product",
+					type: "object",
+					icon: "shopping-bag",
+					preview: {
+						title: "badge",
+						subtitle: "product",
+						media: "image",
+						fallback: "Untitled product slide"
+					},
+					fields: [
+						{
+							name: "product",
+							title: "Product",
+							type: "reference",
+							reference: { to: ["shopify"] },
+							validation: { required: true }
+						},
+						{
+							name: "image",
+							title: "Image",
+							type: "image",
+							description: "Leave empty to use the product photo."
+						},
+						{
+							name: "badge",
+							title: "Badge",
+							type: "string",
+							validation: { max: 16 },
+							placeholder: "New"
+						}
+					]
+				}
+			]
+		},
+		{
+			name: "autoplay",
+			title: "Play automatically",
+			type: "boolean",
+			group: "design"
+		},
+		{
+			name: "interval",
+			title: "Seconds per slide",
+			type: "number",
+			group: "design",
+			layout: "slider",
+			hidden: {
+				field: "autoplay",
+				equals: true
+			},
+			initialValue: 6,
+			numeric: {
+				min: 3,
+				max: 15,
+				step: 1,
+				unit: "s"
+			}
+		},
+		{
+			name: "loop",
+			title: "Loop back to the start",
+			type: "boolean",
+			group: "design",
+			initialValue: true
+		},
+		{
+			name: "perViewDesktop",
+			title: "Slides visible on desktop",
+			type: "number",
+			group: "design",
+			layout: "slider",
+			initialValue: 3,
+			numeric: {
+				min: 1,
+				max: 5,
+				step: .5
+			},
+			description: "Halves show a peek of the next slide."
+		},
+		{
+			name: "perViewMobile",
+			title: "Slides visible on phones",
+			type: "number",
+			group: "design",
+			layout: "slider",
+			initialValue: 1.2,
+			numeric: {
+				min: 1,
+				max: 2,
+				step: .1
+			}
+		},
+		{
+			name: "controls",
+			title: "Controls",
+			type: "multiselect",
+			group: "design",
+			initialValue: ["arrows", "dots"],
+			options: [
+				{
+					value: "arrows",
+					label: "Arrows"
+				},
+				{
+					value: "dots",
+					label: "Dots"
+				},
+				{
+					value: "progress",
+					label: "Progress bar"
+				}
+			]
+		},
+		theme
+	]
+};
+var parallax = {
+	name: "parallaxImage",
+	title: "Full-bleed image",
+	kind: "block",
+	icon: "photo-scan",
+	category: "Media & galleries",
+	description: "An edge-to-edge photo with optional parallax and text over it",
+	variants: [
+		{
+			id: "parallax",
+			name: "Parallax",
+			description: "The photo moves slower than the page"
+		},
+		{
+			id: "fixed",
+			name: "Fixed",
+			description: "The page scrolls over a still photo"
+		},
+		{
+			id: "static",
+			name: "Static"
+		}
+	],
+	preview: {
+		title: "heading",
+		media: "image",
+		icon: "photo-scan"
+	},
+	groups: GROUPS,
+	fields: [
+		{
+			name: "eyebrow",
+			title: "Eyebrow",
+			type: "string",
+			validation: { max: 32 }
+		},
+		{
+			name: "heading",
+			title: "Heading",
+			type: "string",
+			validation: { recommendedMax: 60 },
+			ai: true,
+			localized: true
+		},
+		{
+			name: "body",
+			title: "Body",
+			type: "text",
+			rows: 2,
+			validation: { recommendedMax: 160 },
+			localized: true
+		},
+		{
+			name: "button",
+			title: "Button",
+			type: "button"
+		},
+		{
+			name: "image",
+			title: "Image",
+			type: "image",
+			group: "media",
+			validation: { required: true },
+			description: "At least 2400px wide."
+		},
+		{
+			name: "mobileImage",
+			title: "Phone photo",
+			type: "image",
+			group: "media"
+		},
+		{
+			name: "isDecorative",
+			title: "Decorative only",
+			type: "boolean",
+			group: "media",
+			description: "Screen readers skip the photo."
+		},
+		{
+			name: "credit",
+			title: "Photo credit",
+			type: "string",
+			group: "media",
+			validation: { max: 64 }
+		},
+		{
+			name: "position",
+			title: "Text position",
+			type: "select",
+			group: "design",
+			layout: "grid",
+			initialValue: "bottom-left",
+			hidden: {
+				field: "heading",
+				notEmpty: true
+			},
+			options: [
+				{
+					value: "top-left",
+					label: "Top left"
+				},
+				{
+					value: "top-center",
+					label: "Top"
+				},
+				{
+					value: "top-right",
+					label: "Top right"
+				},
+				{
+					value: "middle-left",
+					label: "Left"
+				},
+				{
+					value: "center",
+					label: "Center"
+				},
+				{
+					value: "middle-right",
+					label: "Right"
+				},
+				{
+					value: "bottom-left",
+					label: "Bottom left"
+				},
+				{
+					value: "bottom-center",
+					label: "Bottom"
+				},
+				{
+					value: "bottom-right",
+					label: "Bottom right"
+				}
+			]
+		},
+		{
+			name: "overlay",
+			title: "Overlay",
+			type: "number",
+			group: "design",
+			layout: "slider",
+			initialValue: 40,
+			numeric: {
+				min: 0,
+				max: 80,
+				step: 5,
+				unit: "%"
+			}
+		},
+		{
+			name: "overlayStyle",
+			title: "Overlay shape",
+			type: "select",
+			group: "design",
+			layout: "segmented",
+			initialValue: "gradient",
+			options: [{
+				value: "flat",
+				label: "Flat"
+			}, {
+				value: "gradient",
+				label: "Gradient"
+			}]
+		},
+		{
+			name: "height",
+			title: "Height",
+			type: "select",
+			group: "design",
+			layout: "segmented",
+			initialValue: "tall",
+			options: [
+				{
+					value: "medium",
+					label: "60%"
+				},
+				{
+					value: "tall",
+					label: "80%"
+				},
+				{
+					value: "screen",
+					label: "Full screen"
+				}
+			],
+			description: "Share of the browser window's height."
+		},
+		{
+			name: "intensity",
+			title: "Parallax strength",
+			type: "number",
+			group: "design",
+			layout: "slider",
+			hidden: {
+				field: "_variant",
+				equals: "parallax"
+			},
+			initialValue: 20,
+			numeric: {
+				min: 5,
+				max: 40,
+				step: 5,
+				unit: "%"
+			}
+		}
+	]
+};
+var ugcFeed = {
+	name: "ugcFeed",
+	title: "Social photo feed",
+	kind: "block",
+	icon: "brand-instagram",
+	category: "Media & galleries",
+	description: "A grid of customer photos from a connected Instagram account or hashtag, or picked by hand",
+	variants: [{
+		id: "grid",
+		name: "Grid"
+	}, {
+		id: "strip",
+		name: "Strip",
+		description: "One scrolling row"
+	}],
+	preview: {
+		title: "heading",
+		icon: "brand-instagram"
+	},
+	groups: GROUPS,
+	fields: [
+		{
+			name: "heading",
+			title: "Heading",
+			type: "string",
+			validation: { recommendedMax: 48 },
+			localized: true
+		},
+		{
+			name: "followButton",
+			title: "Follow button",
+			type: "button"
+		},
+		{
+			name: "source",
+			title: "Photos from",
+			type: "select",
+			layout: "radio",
+			initialValue: "account",
+			options: [
+				{
+					value: "account",
+					label: "Our account",
+					description: "Newest posts from the connected profile"
+				},
+				{
+					value: "hashtag",
+					label: "A hashtag",
+					description: "Only posts you approve in Media › Social"
+				},
+				{
+					value: "manual",
+					label: "Picked photos"
+				}
+			]
+		},
+		{
+			name: "account",
+			title: "Account",
+			type: "string",
+			access: { edit: "schema.manage" },
+			lockReason: "Connected in Settings › Integrations.",
+			hidden: {
+				field: "source",
+				equals: "account"
+			},
+			placeholder: "@calderaoutside"
+		},
+		{
+			name: "hashtag",
+			title: "Hashtag",
+			type: "string",
+			hidden: {
+				field: "source",
+				equals: "hashtag"
+			},
+			validation: {
+				required: true,
+				pattern: "^#?[A-Za-z0-9_]+$",
+				patternMessage: "Use letters, numbers and underscores, like utm_source."
+			},
+			placeholder: "#cookedoncaldera"
+		},
+		{
+			name: "limit",
+			title: "How many",
+			type: "number",
+			hidden: {
+				field: "source",
+				equals: ["account", "hashtag"]
+			},
+			initialValue: 8,
+			numeric: {
+				min: 4,
+				max: 24,
+				step: 4
+			}
+		},
+		{
+			name: "posts",
+			title: "Photos",
+			type: "array",
+			group: "media",
+			itemNoun: "photo",
+			arrayLayout: "grid",
+			hidden: {
+				field: "source",
+				equals: "manual"
+			},
+			validation: {
+				min: 4,
+				max: 24
+			},
+			of: [{
+				name: "post",
+				title: "Photo",
+				type: "object",
+				icon: "photo",
+				preview: {
+					title: "handle",
+					subtitle: "permalink",
+					media: "image",
+					fallback: "Untitled photo"
+				},
+				fields: [
+					{
+						name: "image",
+						title: "Image",
+						type: "image",
+						validation: { required: true }
+					},
+					{
+						name: "handle",
+						title: "Creator",
+						type: "string",
+						validation: { required: true },
+						placeholder: "@trailkitchen"
+					},
+					{
+						name: "permalink",
+						title: "Original post",
+						type: "url",
+						validation: { required: true }
+					},
+					{
+						name: "hasRights",
+						title: "Creator gave permission",
+						type: "boolean",
+						validation: { required: true },
+						description: "Required before it can be published."
+					},
+					{
+						name: "products",
+						title: "Products shown",
+						type: "array",
+						of: [{
+							name: "product",
+							title: "Product",
+							type: "reference",
+							reference: { to: ["shopify"] }
+						}]
+					}
+				]
+			}]
+		},
+		{
+			name: "columns",
+			title: "Columns on desktop",
+			type: "number",
+			group: "design",
+			layout: "slider",
+			initialValue: 4,
+			numeric: {
+				min: 3,
+				max: 6,
+				step: 1
+			}
+		},
+		theme
+	]
+};
+var ENTRIES = [
+	{
+		id: "masonry-gallery",
+		label: "Masonry gallery",
+		proves: "Bulk image array as tiles · caption + structured credit per photo · columns per breakpoint as design",
+		category: "Media & galleries",
+		tags: [
+			"media-heavy",
+			"a11y",
+			"responsive-layout",
+			"repeater",
+			"validation",
+			"localized"
+		],
+		brand: "Halden Studio",
+		previewLayout: "gallery",
+		schema: masonry,
+		value: {
+			_variant: "masonry",
+			heading: "Cedar House, Whidbey Island",
+			intro: "A 1,400 sq ft retreat built around three old-growth cedars. Completed 2025.",
+			images: [
+				{
+					_key: "i1",
+					image: img("halden-cedar-exterior", "Timber house with floor-to-ceiling glass among cedar trunks at dusk", 1200, 1600, {
+						x: 50,
+						y: 45
+					}),
+					caption: "The north façade, glazed full height so the cedars read as part of the room.",
+					credit: {
+						name: "Lina Okafor",
+						link: {
+							type: "url",
+							href: "https://linaokafor.photo",
+							newTab: true
+						}
+					}
+				},
+				{
+					_key: "i2",
+					image: img("halden-cedar-kitchen", "Kitchen with charred-oak cabinets and a concrete island", 1600, 1067),
+					caption: "Charred oak and board-formed concrete in the kitchen.",
+					credit: { name: "Lina Okafor" }
+				},
+				{
+					_key: "i3",
+					image: img("halden-cedar-stair", "A floating timber stair lit from a skylight", 1200, 1800),
+					caption: "The stair hangs from a single steel spine.",
+					credit: { name: "Lina Okafor" }
+				},
+				{
+					_key: "i4",
+					image: img("halden-cedar-bath", "Soaking tub facing a forest view", 1600, 1067),
+					caption: "",
+					credit: { name: "Lina Okafor" }
+				},
+				{
+					_key: "i5",
+					image: img("halden-cedar-detail", "Close-up of a hand-cut cedar shingle wall", 1200, 1200),
+					caption: "Hand-split shingles from fallen site trees.",
+					credit: { name: "Halden Studio" }
+				},
+				{
+					_key: "i6",
+					image: img("halden-cedar-deck", "Deck wrapped around a cedar trunk at sunrise", 1600, 1067, {
+						x: 35,
+						y: 60
+					}),
+					caption: "The deck steps around the oldest cedar rather than through it.",
+					credit: { name: "Lina Okafor" }
+				}
+			],
+			useLightbox: true,
+			captionDisplay: "hover",
+			desktopColumns: 3,
+			tabletColumns: 2,
+			phoneColumns: 1,
+			gap: "sm",
+			theme: "light"
+		},
+		notes: {
+			why: "Photos are an array of small objects (image + caption + credit + optional link) shown as a GRID of tiles because galleries are managed visually and in bulk. Caption and credit are separate: the caption is localised content, the credit is attribution (name + link) that must survive translation and appear in the lightbox. Alt text lives on the image value itself. Column counts per breakpoint are DESIGN in the Design group — never per-photo sizes, because masonry keeps each photo's natural aspect ratio from its stored width/height.",
+			sanity: "`masonryGallery` with `images: array<object{image (hotspot: true), caption, credit: object{name, url}}>` and `options.layout: 'grid'`; Sanity stores alt as a custom field on the image object.",
+			htmlSignals: [
+				"Many `<img>` (6+) inside a container with `column-count`, `columns-3`, `grid-template-rows: masonry`, or Masonry.js / `data-masonry`",
+				"Images of differing aspect ratios with no fixed height",
+				"`<figure>` + `<figcaption>` per image, often with “Photo: Name” or © text",
+				"Links to full-size images (`href` ending .jpg) or useLightbox libraries (PhotoSwipe, GLightbox, fancybox) via `data-pswp-*`, `data-fancybox`"
+			],
+			mcp: "Each figure → a photo: highest-resolution source (`srcset` largest, or the useLightbox `href`) → image.url, intrinsic width/height from `data-pswp-width`/natural size, `alt` → image.alt. Split `<figcaption>`: text after “Photo:”, “©”, “Credit:” or in a `<small>`/`<cite>` → credit.name (+ any link), the rest → caption. Count CSS columns at 1280/768/375px → desktopColumns/tabletColumns/phoneColumns. Lightbox library present → useLightbox true.",
+			pitfalls: [
+				"Importing the thumbnail instead of the full-size file — always prefer the lightbox href or the largest srcset entry.",
+				"Credits pasted into captions get translated; keep them in the credit object.",
+				"Empty alt is right for decorative photos but wrong for a portfolio — flag empties for review."
+			]
+		}
+	},
+	{
+		id: "lightbox-gallery-filters",
+		label: "Gallery with category filters",
+		proves: "Filters defined once as key/label objects · photos tag themselves by key · URL-synced filter state",
+		category: "Media & galleries",
+		tags: [
+			"media-heavy",
+			"a11y",
+			"repeater",
+			"validation",
+			"localized"
+		],
+		brand: "Tidewater Hotel",
+		previewLayout: "gallery",
+		schema: filterGallery,
+		value: {
+			_variant: "landscape",
+			heading: "Inside Tidewater",
+			categories: [
+				{
+					_key: "c1",
+					label: "Rooms",
+					key: "rooms"
+				},
+				{
+					_key: "c2",
+					label: "Dining",
+					key: "dining"
+				},
+				{
+					_key: "c3",
+					label: "Spa",
+					key: "spa"
+				},
+				{
+					_key: "c4",
+					label: "The beach",
+					key: "beach"
+				}
+			],
+			allLabel: "All",
+			images: [
+				{
+					_key: "g1",
+					image: img("tidewater-king-suite", "King suite with linen bedding and a balcony over the bay", 1600, 1200),
+					categories: ["rooms"],
+					caption: "Bay King Suite — every suite faces the water."
+				},
+				{
+					_key: "g2",
+					image: img("tidewater-oyster-bar", "Oyster bar counter with a chef shucking oysters", 1600, 1200),
+					categories: ["dining"],
+					caption: "The Shell Bar opens at 4pm daily."
+				},
+				{
+					_key: "g3",
+					image: img("tidewater-steam-room", "Cedar steam room with soft light", 1600, 1200),
+					categories: ["spa"],
+					caption: ""
+				},
+				{
+					_key: "g4",
+					image: img("tidewater-dunes", "Boardwalk through dunes to the beach at sunset", 1600, 1200),
+					categories: ["beach"],
+					caption: "A two-minute walk from the lobby."
+				},
+				{
+					_key: "g5",
+					image: img("tidewater-terrace-breakfast", "Breakfast on a terrace above the beach", 1600, 1200),
+					categories: ["dining", "beach"],
+					caption: "Breakfast on the Dune Terrace."
+				},
+				{
+					_key: "g6",
+					image: img("tidewater-twin-room", "Twin room with two double beds and a reading nook", 1600, 1200),
+					categories: ["rooms"],
+					caption: "Harbour Twin."
+				}
+			],
+			useUrlFilter: true,
+			columns: 3,
+			initialCount: 12,
+			theme: "light"
+		},
+		notes: {
+			why: "Filter categories are defined ONCE on the section (label + stable key, localised labels) and each photo tags itself with keys, so renaming “Dining” to “Restaurant” never touches the photos and a photo can sit in two filters. The keys are a `tags` field today because our schema can't populate a select's options from a sibling array — a real gap (see notes). If the same photos are reused across pages, move them into the media library with media tags and switch the section to a query.",
+			sanity: "`categories: array<object{title, value: slug}>` + `images: array<object{image, categories: array<string>}>` with a custom input listing the parent's categories (Sanity also can't do this without a custom component).",
+			htmlSignals: [
+				"Filter buttons above a grid (`data-filter`, `aria-pressed`, Isotope/MixItUp/`data-category`) and tiles carrying category classes (`.dining`, `data-groups='[\"spa\"]'`)",
+				"A uniform tile grid (fixed aspect ratio, `object-fit: cover`)",
+				"A lightbox on click; sometimes a “Load more” button"
+			],
+			mcp: "Filter button labels → categories (skip the “All”/“Everything” chip → allLabel; key from `data-filter` minus `.`/`*` or slugified label). For each tile, read its category classes/data attributes → categories (keys). Image from the lightbox href or largest srcset, alt → alt, lightbox caption → caption. Tile aspect → variant (1:1 square, else landscape). Visible count before “Load more” → initialCount. `?filter=`/hash usage in links → useUrlFilter.",
+			pitfalls: ["A photo tagged with a key that no filter defines is invisible under every filter except All — validate keys against the filters.", "Free-typed keys are error-prone; a select fed by the section's filters is the right control (schema gap)."]
+		}
+	},
+	{
+		id: "video-section",
+		label: "Video section (YouTube · Vimeo · hosted)",
+		proves: "Source select switches link vs file · captions per language required for hosted · chapters with timestamp validation · VideoObject JSON-LD",
+		category: "Media & galleries",
+		tags: [
+			"media-heavy",
+			"a11y",
+			"seo-structured",
+			"conditional",
+			"validation",
+			"embed",
+			"localized",
+			"variants"
+		],
+		brand: "Caldera",
+		previewLayout: "media",
+		schema: videoSection,
+		value: {
+			_variant: "split",
+			eyebrow: "The film",
+			title: "How we pour a skillet: a day at the Bend foundry",
+			description: "Follow one Ridge Skillet from scrap iron to seasoned pan — the pour, the machining and the three-coat seasoning.",
+			source: "hosted",
+			file: {
+				name: "foundry-day-1080p.mp4",
+				size: 412e6,
+				url: "https://cdn.caldera.co/film/foundry-day-1080p.mp4"
+			},
+			poster: img("caldera-foundry-film-poster", "Caster in a leather apron pouring molten iron", 1920, 1080),
+			duration: "6:48",
+			uploadDate: "2026-03-02",
+			captions: [{
+				_key: "cc1",
+				language: "en",
+				label: "English",
+				file: {
+					name: "foundry-day.en.vtt",
+					size: 18400,
+					url: "https://cdn.caldera.co/film/foundry-day.en.vtt"
+				},
+				kind: "captions",
+				isOnByDefault: true
+			}, {
+				_key: "cc2",
+				language: "es",
+				label: "Español",
+				file: {
+					name: "foundry-day.es.vtt",
+					size: 19100,
+					url: "https://cdn.caldera.co/film/foundry-day.es.vtt"
+				},
+				kind: "subtitles"
+			}],
+			chapters: [
+				{
+					_key: "ch1",
+					start: "0:00",
+					title: "Scrap iron in"
+				},
+				{
+					_key: "ch2",
+					start: "1:12",
+					title: "Making the sand moulds"
+				},
+				{
+					_key: "ch3",
+					start: "2:40",
+					title: "The pour at 2,600°F"
+				},
+				{
+					_key: "ch4",
+					start: "4:05",
+					title: "Machining the surface"
+				},
+				{
+					_key: "ch5",
+					start: "5:30",
+					title: "Three coats of seasoning"
+				}
+			],
+			transcript: "<p><strong>Ana Ruiz:</strong> Every pan starts as something else — an engine block, a radiator, a fence post. We melt it down at about 2,600 degrees…</p>",
+			button: {
+				label: "Shop the Ridge Skillet",
+				href: "/products/ridge-skillet",
+				type: "entry",
+				title: "Ridge Skillet 10\"",
+				style: "primary"
+			},
+			autoplay: false,
+			controls: true,
+			usePrivacyMode: true,
+			theme: "dark"
+		},
+		notes: {
+			why: "One block covers all three hosts with a `source` select: YouTube/Vimeo store a link (the renderer lazy-loads a facade until play), hosted stores a FILE so we can transcode and serve renditions. Captions are a per-language array required for hosted video (WCAG 1.2.2) — YouTube/Vimeo carry their own. Chapters are validated timestamps so the renderer can seek and emit `Clip` markup. Title, description, poster, duration and upload date are REQUIRED because they feed VideoObject JSON-LD — that is native SEO generated from content the section already needs, not modelled meta fields. Playback settings are design; loop only shows with autoplay.",
+			sanity: "`videoSection` with `source: string`, `url: url`, `file: mux.video` (Mux plugin) or `file`, `captions: array<object{lang, file}>`, `chapters: array<object{start: string, title}>`; JSON-LD built in the frontend.",
+			htmlSignals: [
+				"`<iframe src=\"https://www.youtube(-nocookie).com/embed/…\">`, `player.vimeo.com/video/…`, `lite-youtube` / `lite-vimeo` facades",
+				"`<video>` with `<source type=\"video/mp4\">`, `poster=` and `<track kind=\"captions\" srclang=…>`",
+				"A list of timestamps (“1:12 Making the moulds”) next to or under the player",
+				"`application/ld+json` with `VideoObject`, `duration` (ISO 8601 like PT6M48S), `uploadDate`"
+			],
+			mcp: "Host from the iframe/src domain → source; canonicalise YouTube/Vimeo to watch URLs (`youtube.com/watch?v=ID`, `vimeo.com/ID`) and keep `?start=`/`#t=` as startAt. `<video><source>` → source hosted + file (download the MP4); every `<track>` → captions (srclang → language, label → label, kind). Read title/description/duration/uploadDate from VideoObject JSON-LD first (convert PT6M48S → 6:48), else from visible text. Timestamp list → chapters (first must be 0:00 — prepend “Intro” if missing). `autoplay muted loop` attributes → design flags.",
+			pitfalls: [
+				"Autoplay with sound is blocked by browsers; autoplay always means muted here.",
+				"Missing uploadDate/duration silently drops the video from rich results — they are required for that reason.",
+				"Embedding raw YouTube iframes costs ~1 MB of JS per video; the renderer uses a facade until play."
+			]
+		}
+	},
+	{
+		id: "before-after-slider",
+		label: "Before / after slider",
+		proves: "Paired required images per comparison · localised labels with defaults · single vs tabs via one array",
+		category: "Media & galleries",
+		tags: [
+			"media-heavy",
+			"a11y",
+			"repeater",
+			"validation",
+			"variants",
+			"localized"
+		],
+		brand: "Halden Studio",
+		previewLayout: "media",
+		schema: beforeAfter,
+		value: {
+			_variant: "tabs",
+			eyebrow: "Renovations",
+			heading: "Same walls, a different house.",
+			comparisons: [
+				{
+					_key: "b1",
+					label: "Kitchen",
+					before: img("halden-reno-kitchen-before", "Dated kitchen with oak cabinets and a dropped ceiling", 1600, 1067),
+					after: img("halden-reno-kitchen-after", "The same kitchen opened to the rafters with white oak and a skylight", 1600, 1067),
+					beforeLabel: "1987",
+					afterLabel: "2025",
+					caption: "We removed the dropped ceiling and found the original fir rafters.",
+					credit: { name: "Lina Okafor" }
+				},
+				{
+					_key: "b2",
+					label: "Living room",
+					before: img("halden-reno-living-before", "Living room with carpet and a small window", 1600, 1067),
+					after: img("halden-reno-living-after", "Living room with polished concrete and a wide picture window", 1600, 1067),
+					beforeLabel: "Before",
+					afterLabel: "After",
+					caption: "",
+					credit: { name: "Lina Okafor" }
+				},
+				{
+					_key: "b3",
+					label: "Façade",
+					before: img("halden-reno-facade-before", "Vinyl-sided house front", 1600, 1067),
+					after: img("halden-reno-facade-after", "The same house clad in charred cedar", 1600, 1067),
+					beforeLabel: "Before",
+					afterLabel: "After",
+					caption: "Shou sugi ban cedar over the original frame.",
+					credit: { name: "Halden Studio" }
+				}
+			],
+			start: 50,
+			orientation: "horizontal",
+			showHint: true,
+			theme: "light"
+		},
+		notes: {
+			why: "A comparison is a PAIR of required images plus labels, so it's an object; an array of comparisons covers both the single and tabbed layouts without two blocks. Labels default to “Before/After” but are editable and localised (“1987 / 2025” is stronger). Divider start, orientation and the first-view nudge are design. Both images keep their own alt — screen readers get “Before: …, After: …” and a keyboard-operable slider from the renderer.",
+			sanity: "array of `comparison` objects {before: image, after: image, labels}; Sanity can't validate matching dimensions without `Rule.custom` reading asset metadata.",
+			htmlSignals: [
+				"Two stacked images in one container where the top one is clipped (`clip-path: inset(0 50% 0 0)` or a width %) with a draggable handle",
+				"`<input type=\"range\">` overlaid on images, or libraries `img-comparison-slider`, `twentytwenty`, `juxtapose`, `beer-slider`",
+				"Labels “Before” / “After” pinned in the corners"
+			],
+			mcp: "Find the two images inside the comparison container: the clipped/overlay one is usually AFTER (check the label nearest each image rather than assuming). Labels → beforeLabel/afterLabel. Initial clip/range value → start. Vertical clip (inset top/bottom) → orientation vertical. Multiple comparisons under tabs → one block with several comparisons and variant tabs. Compare the two images' natural sizes; if they differ by more than 2%, flag it.",
+			pitfalls: ["Before and after with different crops make the slider useless — dimensions should match (not enforceable in our schema yet).", "A slider built from a div with mouse events only is not keyboard accessible; the renderer must use a real range input."]
+		}
+	},
+	{
+		id: "image-hotspots",
+		label: "Image with hotspots (shop the look)",
+		proves: "Points stored as % coordinates · each pin opens a live product reference OR a note (conditional) · required pin labels",
+		category: "Media & galleries",
+		tags: [
+			"media-heavy",
+			"conditional",
+			"references",
+			"commerce",
+			"a11y",
+			"validation",
+			"variants"
+		],
+		brand: "Caldera",
+		previewLayout: "media",
+		schema: hotspots,
+		value: {
+			_variant: "sidebar",
+			eyebrow: "Shop the camp kitchen",
+			heading: "Everything on the tailgate, ready by sundown.",
+			image: img("caldera-camp-kitchen", "A tailgate camp kitchen with a Dutch oven, folding grill, skillet and kettle", 2e3, 1250, {
+				x: 50,
+				y: 55
+			}),
+			hotspots: [
+				{
+					_key: "h1",
+					label: "Ember Dutch Oven",
+					x: 24,
+					y: 58,
+					kind: "product",
+					product: "gid://shopify/Product/8813",
+					cardSide: "auto"
+				},
+				{
+					_key: "h2",
+					label: "Cable Fold Grill",
+					x: 52.5,
+					y: 66,
+					kind: "product",
+					product: "gid://shopify/Product/8812",
+					cardSide: "auto"
+				},
+				{
+					_key: "h3",
+					label: "Ridge Skillet 10 inch",
+					x: 71,
+					y: 49,
+					kind: "product",
+					product: "gid://shopify/Product/8814",
+					cardSide: "left"
+				},
+				{
+					_key: "h4",
+					label: "Why the tailgate height matters",
+					x: 88,
+					y: 30,
+					kind: "note",
+					title: "Cook at hip height",
+					body: "A tailgate puts the grate at 34 inches — the same as a kitchen counter. Your back will thank you on day three.",
+					link: {
+						type: "page",
+						href: "/journal/tailgate-kitchen",
+						label: "Set up a tailgate kitchen",
+						title: "Tailgate kitchen"
+					},
+					cardSide: "left"
+				}
+			],
+			pinStyle: "number",
+			usePulse: true,
+			theme: "light"
+		},
+		notes: {
+			why: "Each hotspot stores its position as PERCENTAGES of the image (x, y 0–100), not pixels, so pins stay put at every screen size — which is why the image's crop must not change after pins are placed. A pin opens either a PRODUCT (a Shopify reference — name, price and stock stay live, never copied) or a NOTE (title/body/link); the `kind` select shows only the relevant fields. Every pin needs a text label because pins are tiny buttons with no visible text. The phone image is optional and shows the hotspots as a list, since pins on a small crop are unusable.",
+			sanity: "`sanity-plugin-hotspot-array` gives a visual point picker storing `x`/`y` %; items `{x, y, kind, product: reference, title, body}`.",
+			htmlSignals: [
+				"A relatively-positioned image wrapper containing absolutely-positioned buttons with `style=\"left: 24%; top: 58%\"`",
+				"Small circular buttons (“+”, numbers, pulsing dots) that open popovers with a product name, price and Add-to-cart",
+				"Shopify product handles/IDs in `data-product-id`, `data-handle` or links to `/products/…` inside the popovers"
+			],
+			mcp: "For each positioned pin: parse `left`/`top` (or `inset`, `transform: translate`) as percentages of the wrapper → x/y (convert px using the wrapper's rendered size if needed, round to 0.5). Popover with a product link/handle → kind product + reference (resolve handle → Shopify GID); else kind note with heading → title, text → body, link → link. Label from the pin's `aria-label`, else the product title or note title. Keep the base image at its original crop.",
+			pitfalls: [
+				"Pixel positions break on every other screen size — always convert to %.",
+				"Copying product price into the note text goes stale; reference the product.",
+				"Re-cropping the image after placing pins moves every pin. A visual point picker would prevent this (schema gap)."
+			]
+		}
+	},
+	{
+		id: "interactive-3d-lottie-embed",
+		label: "3D model / Lottie / 360° embed",
+		proves: "Embed kind decides file vs allow-listed URL · required still fallback + accessible name · load-on-click for performance",
+		category: "Media & galleries",
+		tags: [
+			"embed",
+			"conditional",
+			"media-heavy",
+			"a11y",
+			"validation",
+			"variants"
+		],
+		brand: "Caldera",
+		previewLayout: "split",
+		schema: interactiveEmbed,
+		value: {
+			_variant: "split",
+			eyebrow: "Spin it",
+			heading: "See how the Cable Fold folds.",
+			body: "<p>Drag to turn it. On an iPhone, tap <strong>View in your space</strong> to put it on your own table.</p>",
+			kind: "model",
+			model: {
+				name: "cable-fold.glb",
+				size: 58e5,
+				url: "https://cdn.caldera.co/3d/cable-fold.glb"
+			},
+			iosModel: {
+				name: "cable-fold.usdz",
+				size: 72e5,
+				url: "https://cdn.caldera.co/3d/cable-fold.usdz"
+			},
+			cameraOrbit: "35deg 70deg 1.6m",
+			useAutoRotate: true,
+			fallback: img("cable-fold-3d-still", "The Cable Fold Grill half unfolded on a white background", 1600, 1200),
+			label: "Interactive 3D model of the Cable Fold Grill, shown half unfolded",
+			aspect: "4:3",
+			loadOn: "click",
+			theme: "light"
+		},
+		notes: {
+			why: "Three very different embeds share one block because they share the hard parts: a REQUIRED still fallback (loading, slow networks, reduced motion), a REQUIRED accessible name, and a load strategy. `kind` decides what is stored — uploaded files for 3D (GLB + optional USDZ for iOS AR) and Lottie, or an iframe URL for hosted scenes. The URL is pattern-validated against an allow-list of hosts so a marketer can't paste an arbitrary site into an iframe; raw HTML/script embeds are deliberately NOT offered here (that's a developer-only code block).",
+			sanity: "object with `kind: string`, `model: file` (accept .glb), `lottie: file`, `embedUrl: url` with `Rule.uri({scheme:['https']})` + custom host check; rendering via `<model-viewer>` / `lottie-web` in the frontend.",
+			htmlSignals: [
+				"`<model-viewer src=\"….glb\" ios-src=\"….usdz\" camera-orbit=… auto-rotate ar>`",
+				"`<lottie-player>`, `<dotlottie-player>`, `lottie.loadAnimation({ path: '….json' })` or `data-animation-path`",
+				"Iframes from `my.spline.design`, `sketchfab.com/models/…/embed`, `my.matterport.com/show`, `kuula.co/share`",
+				"A canvas element (`<canvas>` from three.js/Spline runtime) with a poster image fallback"
+			],
+			mcp: "`<model-viewer>` → kind model: src → model (download the GLB), ios-src → iosModel, camera-orbit → cameraOrbit, auto-rotate → useAutoRotate, poster → fallback, alt → label. Lottie players → kind lottie: src/path → lottie file, loop/autoplay/hover/scroll triggers → loop/playOn. Allow-listed iframes → kind iframe + embedUrl; any other iframe host → do NOT import into this block — emit a developer task instead. If no poster exists, capture a screenshot of the first frame as fallback and flag it.",
+			pitfalls: [
+				"A 40 MB GLB will tank the page — validate size and recommend Draco/meshopt compression.",
+				"Iframe embeds from un-vetted hosts are a security hole — the host allow-list is intentional.",
+				"Lottie animations that loop forever must stop for reduced-motion users; the renderer shows the fallback instead."
+			]
+		}
+	},
+	{
+		id: "mixed-media-carousel",
+		label: "Mixed-media carousel",
+		proves: "Polymorphic slides (photo · video · quote · product) · per-breakpoint slides visible · interval shown only with autoplay",
+		category: "Media & galleries",
+		tags: [
+			"polymorphic-array",
+			"media-heavy",
+			"a11y",
+			"responsive-layout",
+			"references",
+			"conditional",
+			"commerce"
+		],
+		brand: "Caldera",
+		previewLayout: "carousel",
+		schema: carousel,
+		value: {
+			_variant: "peek",
+			eyebrow: "Field notes",
+			heading: "A weekend on the Deschutes.",
+			slides: [
+				{
+					_key: "s1",
+					_type: "imageSlide",
+					image: img("deschutes-camp-dawn", "Tent and campfire on a riverbank at dawn", 1600, 1067, {
+						x: 40,
+						y: 55
+					}),
+					caption: "Dawn at Mile 12 camp."
+				},
+				{
+					_key: "s2",
+					_type: "videoSlide",
+					video: { url: "https://cdn.caldera.co/film/deschutes-sear-loop.mp4" },
+					poster: img("deschutes-sear-poster", "Trout searing in a skillet over coals", 1600, 1067),
+					caption: "Trout, butter, coals. That's the recipe.",
+					muted: true
+				},
+				{
+					_key: "s3",
+					_type: "quoteSlide",
+					quote: "We packed one skillet for four people and three days. It was the only pan we needed.",
+					author: "Maya Reyes",
+					role: "Backcountry guide, Montana",
+					photo: {
+						url: "https://i.pravatar.cc/192?img=47",
+						alt: "",
+						name: "maya.jpg"
+					},
+					background: img("deschutes-river-dusk", "River canyon at dusk", 1600, 1067)
+				},
+				{
+					_key: "s4",
+					_type: "productSlide",
+					product: "gid://shopify/Product/8814",
+					image: img("deschutes-skillet-rock", "Ridge Skillet resting on a river stone", 1600, 1067),
+					badge: "In this trip"
+				},
+				{
+					_key: "s5",
+					_type: "imageSlide",
+					image: img("deschutes-raft", "Two rafts pulled up on a gravel bar", 1600, 1067),
+					caption: "Lunch stop at Whitehorse Rapids.",
+					link: {
+						type: "page",
+						href: "/journal/deschutes-float",
+						label: "Read the trip",
+						title: "Three days on the Deschutes"
+					}
+				}
+			],
+			autoplay: false,
+			interval: 6,
+			loop: true,
+			perViewDesktop: 2.5,
+			perViewMobile: 1.15,
+			controls: ["arrows", "progress"],
+			theme: "light"
+		},
+		notes: {
+			why: "Slides are a POLYMORPHIC ARRAY (`imageSlide`, `videoSlide`, `quoteSlide`, `productSlide`) because each kind needs different required fields — a video needs a poster, a product needs a live Shopify reference, a quote needs an author. Using small object types (not a slot of full blocks) keeps slides lightweight and the carousel's rendering predictable. Products are REFERENCES so price/stock stay live. Slides-per-view per breakpoint, autoplay, interval (hidden unless autoplay) and controls are design.",
+			sanity: "`array` with `of: [{type:'imageSlide'},{type:'videoSlide'},{type:'quoteSlide'},{type:'productSlide'}]`; same polymorphic `_type` approach.",
+			htmlSignals: [
+				"Carousel libraries: `swiper-slide`, `splide__slide`, `embla__slide`, `glide__slide`, `keen-slider__slide`, or `scroll-snap-type: x mandatory`",
+				"Slides with different internal structures (one `<img>`, one `<video>`, one `<blockquote>`, one product card with price)",
+				"`slidesPerView`/`perPage` options in inline JS or `data-*` attributes; prev/next buttons, pagination dots"
+			],
+			mcp: "Classify each slide by content: `<video>`/video iframe → videoSlide (poster required; extract or generate one), `<blockquote>`/quote marks + name → quoteSlide, price + add-to-cart or `/products/` link → productSlide (resolve to a Shopify GID), otherwise imageSlide. Read the library config (`slidesPerView`, breakpoints, `autoplay.delay`, `loop`) → perViewDesktop/perViewMobile, autoplay + interval (ms → s), loop. Pagination/arrows/progress elements → controls. Ignore cloned slides (`swiper-slide-duplicate`, `aria-hidden` clones).",
+			pitfalls: ["Loop mode clones slides in the DOM — import only originals.", "Autoplaying carousels need a pause control and must stop on focus (WCAG 2.2.2); the renderer adds both."]
+		}
+	},
+	{
+		id: "parallax-image-overlay",
+		label: "Full-bleed parallax image with overlay text",
+		proves: "Art-directed phone image · decorative flag · 9-position text grid shown only when there is text · parallax strength only for the parallax variant",
+		category: "Media & galleries",
+		tags: [
+			"media-heavy",
+			"a11y",
+			"responsive-layout",
+			"variants",
+			"conditional"
+		],
+		brand: "Tidewater Hotel",
+		previewLayout: "media",
+		schema: parallax,
+		value: {
+			_variant: "parallax",
+			eyebrow: "The coast",
+			heading: "Where the tide sets the schedule.",
+			body: "Ninety rooms on a quiet stretch of the Oregon coast. No resort fee, no wristbands.",
+			button: {
+				label: "Check availability",
+				href: "/book",
+				type: "page",
+				title: "Book",
+				style: "primary",
+				arrow: true
+			},
+			image: img("tidewater-coast-aerial", "Aerial view of the hotel above a long empty beach at low tide", 2400, 1200, {
+				x: 62,
+				y: 48
+			}),
+			mobileImage: img("tidewater-coast-portrait", "The hotel's dune boardwalk leading to the beach", 1080, 1600, {
+				x: 50,
+				y: 60
+			}),
+			isDecorative: false,
+			credit: "Photo: Jonah Reyes",
+			position: "bottom-left",
+			overlay: 45,
+			overlayStyle: "gradient",
+			height: "tall",
+			intensity: 20
+		},
+		notes: {
+			why: "A full-bleed image is mostly DESIGN with a little content: the photo, an optional art-directed phone crop (a 2:1 landscape becomes a sliver on phones), and optional overlay text. Focal points live on the image values so automatic crops keep the subject. `isDecorative` is explicit because empty alt must be a decision, not an accident. Text position, overlay (with a recommended 35–55% range in the help), height and parallax strength are design; position only shows when there is a heading, and parallax strength only for the parallax variant. The renderer disables parallax for reduced motion and on iOS where `background-attachment: fixed` is unsupported.",
+			sanity: "object with `image` (hotspot: true), `mobileImage`, `isDecorative: boolean`, `overlay: number`, `position: string`; parallax is a frontend concern.",
+			htmlSignals: [
+				"A full-viewport-width section with `background-image` and `background-attachment: fixed`, or an `<img>` translated on scroll (`data-speed`, `data-parallax`, Rellax, GSAP ScrollTrigger)",
+				"A gradient/scrim overlay (`linear-gradient(rgba(0,0,0,.5)…)`, an absolutely positioned dark `div`)",
+				"`<picture>` with `<source media=\"(max-width: …)\">` providing a different crop for phones",
+				"Little or no text — a heading and maybe one button — positioned in a corner"
+			],
+			mcp: "Background image or `<img>` → image (largest source); a `<picture><source media>` for small screens → mobileImage. Empty `alt=\"\"` or `role=\"presentation\"` → isDecorative true. Scrim opacity → overlay (gradient vs flat from the background value). Text block alignment (flex justify/alignment) → position. Section height in vh → height (≥95 → screen, ≥75 → tall, else medium). `background-attachment: fixed` → variant fixed; scroll-linked transforms → parallax with intensity from the speed factor; none → static. Photo credit text → credit.",
+			pitfalls: [
+				"`background-attachment: fixed` doesn't work on iOS Safari — the renderer falls back to static.",
+				"Text over a busy photo fails contrast; the overlay help gives a range and the renderer checks contrast.",
+				"A background-image has no alt — converting to an `<img>` with alt (or decorative) is part of the import."
+			]
+		}
+	},
+	{
+		id: "ugc-social-feed",
+		label: "Social photo feed (UGC)",
+		proves: "Connected account vs approved hashtag vs hand-picked · developer-locked connection · rights + permalink required per photo",
+		category: "Media & galleries",
+		tags: [
+			"dynamic-query",
+			"embed",
+			"conditional",
+			"media-heavy",
+			"references",
+			"commerce",
+			"validation"
+		],
+		brand: "Caldera",
+		previewLayout: "gallery",
+		schema: ugcFeed,
+		value: {
+			_variant: "grid",
+			heading: "#cookedoncaldera",
+			followButton: {
+				label: "Follow @calderaoutside",
+				href: "https://www.instagram.com/calderaoutside",
+				type: "url",
+				style: "outline",
+				newTab: true
+			},
+			source: "manual",
+			account: "@calderaoutside",
+			limit: 8,
+			posts: [
+				{
+					_key: "u1",
+					image: img("ugc-dutch-oven-snow", "Dutch oven on coals in fresh snow", 1080, 1080),
+					handle: "@wintercamper",
+					permalink: "https://www.instagram.com/p/C8wq1LzS0aB/",
+					hasRights: true,
+					products: ["gid://shopify/Product/8813"]
+				},
+				{
+					_key: "u2",
+					image: img("ugc-skillet-pancakes", "Blueberry pancakes in a skillet on a camp stove", 1080, 1080),
+					handle: "@sierrasunday",
+					permalink: "https://www.instagram.com/p/C8zT4mGJ9kQ/",
+					hasRights: true,
+					products: ["gid://shopify/Product/8814"]
+				},
+				{
+					_key: "u3",
+					image: img("ugc-grill-beach", "Cable Fold grill on a beach fire at sunset", 1080, 1080),
+					handle: "@coastcooks",
+					permalink: "https://www.instagram.com/p/C90bR2nLx4e/",
+					hasRights: true,
+					products: ["gid://shopify/Product/8812"]
+				},
+				{
+					_key: "u4",
+					image: img("ugc-kettle-summit", "Trail Kettle steaming on a summit rock", 1080, 1080),
+					handle: "@theohikes",
+					permalink: "https://www.instagram.com/p/C92XvQ8Ln1s/",
+					hasRights: true,
+					products: []
+				}
+			],
+			columns: 4,
+			theme: "light"
+		},
+		notes: {
+			why: "A social feed is a DYNAMIC source, not content: the connected account is developer-locked (credentials live in Integrations), hashtag mode only shows posts approved in the media library, and manual mode stores hand-picked photos. Picked photos carry a required permalink and a required rights flag because UGC reposting needs the creator's permission. Products shown in a photo are references so “Shop this photo” stays live. We never store an embed script — the renderer fetches through the integration and caches.",
+			sanity: "usually not modelled in Sanity at all (a third-party widget); a manual version is `array<object{image, handle, permalink, hasRights, products: array<reference>}>`.",
+			htmlSignals: [
+				"Instagram widget scripts/markup: `elfsight`, `snapwidget`, `curator.io`, `taggbox`, `behold.so`, `juicer.io`, `instafeed`",
+				"A grid of square images linking to `instagram.com/p/…` or `tiktok.com/@…/video/…`",
+				"A heading with a hashtag or @handle and a “Follow us” button"
+			],
+			mcp: "If a feed widget script is present: source account (or hashtag if the widget config names one), copy the handle into the developer task to connect the integration — do NOT copy the widget script. If the grid is static images linking to posts: source manual, each tile → a post with permalink from the link, handle from the alt/caption, hasRights false + flag for review. Products tagged in a tile (shop-the-look overlays) → products references.",
+			pitfalls: ["Widget scripts from UGC vendors add 200–500 KB and third-party cookies — replace, don't import.", "Never mark rightsGranted true on import; only a person can confirm permission."]
+		}
+	}
+];
+//#endregion
+export { ENTRIES };
+
+//# sourceMappingURL=media.entries.js.map