@bettercms-ai/kit 2.0.11 → 3.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +1 -2
- package/dist/adapters/schema.js +45 -5
- package/dist/adapters/schema.js.map +1 -1
- package/dist/brand/logo.js.map +1 -1
- package/dist/context.d.ts +7 -0
- package/dist/context.js +6 -1
- package/dist/context.js.map +1 -1
- package/dist/controls/button.js +1 -1
- package/dist/controls/code.d.ts +24 -1
- package/dist/controls/code.js +36 -20
- package/dist/controls/code.js.map +1 -1
- package/dist/controls/icon.d.ts +28 -0
- package/dist/controls/icon.js +205 -61
- package/dist/controls/icon.js.map +1 -1
- package/dist/controls/index.d.ts +20 -2
- package/dist/controls/index.js +21 -20
- package/dist/controls/index.js.map +1 -1
- package/dist/controls/link.js +4 -4
- package/dist/controls/link.js.map +1 -1
- package/dist/controls/location.js +1 -1
- package/dist/controls/media.js +2 -2
- package/dist/controls/reference.js +3 -2
- package/dist/controls/reference.js.map +1 -1
- package/dist/controls/rich-text/blocks.js +2 -2
- package/dist/controls/rich-text/control.js +1 -1
- package/dist/controls/rich-text/editor.js +5 -5
- package/dist/controls/rich-text/embed.js +1 -1
- package/dist/controls/rich-text/toc.js +1 -1
- package/dist/controls/slot-register.js +1 -1
- package/dist/controls/table/table.js +1 -1
- package/dist/controls/text.js +5 -4
- package/dist/controls/text.js.map +1 -1
- package/dist/core/core.js +1 -1
- package/dist/engine/array.js +58 -13
- package/dist/engine/array.js.map +1 -1
- package/dist/engine/bits.js +1 -1
- package/dist/engine/breadcrumb.js +1 -1
- package/dist/engine/expand.js +1 -1
- package/dist/engine/field-shell.js +8 -7
- package/dist/engine/field-shell.js.map +1 -1
- package/dist/engine/frame.d.ts +1 -12
- package/dist/engine/frame.js +7 -149
- package/dist/engine/frame.js.map +1 -1
- package/dist/engine/group-summary.js +7 -4
- package/dist/engine/group-summary.js.map +1 -1
- package/dist/engine/grouping.js +2 -2
- package/dist/engine/item-list.js +2 -2
- package/dist/engine/kit-field.js +3 -7
- package/dist/engine/kit-field.js.map +1 -1
- package/dist/engine/schema-form.d.ts +10 -5
- package/dist/engine/schema-form.js +18 -10
- package/dist/engine/schema-form.js.map +1 -1
- package/dist/engine/slot.js +2 -2
- package/dist/index.d.ts +9 -9
- package/dist/index.js +32 -6
- package/dist/index.js.map +1 -1
- package/dist/kit.css +3 -11
- package/dist/lib/cn.js.map +1 -1
- package/dist/lib/frames.js +1 -1
- package/dist/lib/schema.d.ts +8 -1
- package/dist/lib/schema.js +18 -2
- package/dist/lib/schema.js.map +1 -1
- package/dist/lib/utils.d.ts +1 -4
- package/dist/lib/utils.js +4 -14
- package/dist/lib/utils.js.map +1 -1
- package/dist/lib/validate.d.ts +14 -1
- package/dist/lib/validate.js +26 -10
- package/dist/lib/validate.js.map +1 -1
- package/dist/library/coreNotes.d.ts +1 -1
- package/dist/library/coreNotes.js.map +1 -1
- package/dist/library/entries/conversion.entries.js +8 -0
- package/dist/library/entries/conversion.entries.js.map +1 -1
- package/dist/library/entries/features.entries.js +5 -0
- package/dist/library/entries/features.entries.js.map +1 -1
- package/dist/library/examples/faq.js +1 -0
- package/dist/library/examples/faq.js.map +1 -1
- package/dist/library/examples/journalStory.js +1 -2
- package/dist/library/examples/journalStory.js.map +1 -1
- package/dist/library/kit-catalog.json +4 -4
- package/dist/schema/adapters.js +17 -3
- package/dist/schema/adapters.js.map +1 -1
- package/dist/schema/sources.d.ts +9 -1
- package/dist/schema/sources.js +1 -1
- package/dist/schema/sources.js.map +1 -1
- package/dist/schema/types.d.ts +31 -3
- package/dist/schema/types.js.map +1 -1
- package/dist/styles.css +1 -1
- package/dist/table/table.css +1 -1
- package/dist/theme.css +18 -9
- package/dist/tokens.css +32 -60
- package/dist/ui/action-tray.d.ts +1 -3
- package/dist/ui/action-tray.js +3 -20
- package/dist/ui/action-tray.js.map +1 -1
- package/dist/ui/display.d.ts +1 -4
- package/dist/ui/display.js +4 -6
- package/dist/ui/display.js.map +1 -1
- package/dist/ui/index.js +3 -3
- package/dist/ui/overlay.d.ts +2 -5
- package/dist/ui/overlay.js +3 -4
- package/dist/ui/overlay.js.map +1 -1
- package/dist/ui/path-crumbs.d.ts +0 -2
- package/dist/ui/path-crumbs.js.map +1 -1
- package/dist/ui/surfaces.d.ts +2 -18
- package/dist/ui/surfaces.js +3 -19
- package/dist/ui/surfaces.js.map +1 -1
- package/dist/ui/toast.js +1 -1
- package/dist/ui/toast.js.map +1 -1
- package/package.json +2 -2
|
@@ -1387,7 +1387,7 @@
|
|
|
1387
1387
|
{"id":"hero-split-testimonial","name":"Split hero with testimonial card","category":"Heroes","kind":"block","tags":["references","conditional","variants","media-heavy"],"proves":"Pick from the Testimonials collection OR write one here — a conditional reference/inline pair inside an object","why":"Social proof should usually come from ONE place (the Testimonials collection) so a quote that's withdrawn disappears everywhere. But landing pages often need a one-off quote, so `source` toggles between a reference and inline fields — never both visible, never both stored as the truth. The card is an object so the whole quote travels together when the variant changes from 'over the photo' to 'under the copy'.","htmlSignals":["A <figure>/<blockquote> card with a photo, name and role positioned absolutely over the hero image","Star icons or '★★★★★' next to the quote","The same quote text appearing on a /reviews or /testimonials page — collection candidate"],"mcp":"Hero with a quote card → `testimonialHero`. Search the Testimonials collection for the quote text (normalized, ≥ 90% match): found → source 'collection', entry = its id; not found → create the testimonial entry if the site has a testimonials page, else source 'custom' and fill quote/name/role/photo/rating. Card positioned over the image → variant 'overlap'.","pitfalls":["Quotes typed inline on every landing page drift from the approved wording — prefer the collection."],"notCarried":["variants"],"component":{"name":"Testimonial hero","slug":"testimonial-hero","props":[{"key":"eyebrow","label":"Eyebrow","type":"text","config":{"maxLength":40},"ui":{"tab":{"id":"content","label":"Content"}}},{"key":"heading","label":"Heading","type":"text","required":true,"ai":true,"recommendedMax":60,"localized":true,"config":{"maxLength":100},"ui":{"tab":{"id":"content"}}},{"key":"body","label":"Body","type":"longtext","ai":true,"recommendedMax":180,"localized":true,"ui":{"rows":3,"tab":{"id":"content"}}},{"key":"primaryButton","label":"Primary button","type":"button","ui":{"tab":{"id":"content"}}},{"key":"secondaryButton","label":"Secondary button","type":"button","ui":{"tab":{"id":"content"}}},{"key":"testimonial","label":"Testimonial","type":"object","openMode":"drill","config":{"fields":[{"key":"source","label":"Quote from","type":"select","defaultValue":"collection","options":[{"label":"Testimonials","value":"collection"},{"label":"Write one here","value":"custom"}],"ui":{"control":"segmented"}},{"key":"entry","label":"Testimonial","type":"reference","required":true,"showIf":{"match":"all","rules":[{"field":"source","op":"eq","value":"collection"}]},"config":{"contentModelId":"col_testimonials"}},{"key":"quote","label":"Quote","type":"longtext","required":true,"showIf":{"match":"all","rules":[{"field":"source","op":"eq","value":"custom"}]},"recommendedMax":160,"ui":{"rows":3}},{"key":"name","label":"Name","type":"text","required":true,"showIf":{"match":"all","rules":[{"field":"source","op":"eq","value":"custom"}]},"config":{"maxLength":40}},{"key":"role","label":"Role","type":"text","showIf":{"match":"all","rules":[{"field":"source","op":"eq","value":"custom"}]},"placeholder":"Backcountry guide, Montana","config":{"maxLength":60}},{"key":"photo","label":"Photo","type":"image","showIf":{"match":"all","rules":[{"field":"source","op":"eq","value":"custom"}]}},{"key":"rating","label":"Rating","type":"rating","showIf":{"match":"all","rules":[{"field":"source","op":"eq","value":"custom"}]},"config":{"step":0.1}}]},"ui":{"icon":"quote","tab":{"id":"content"}}},{"key":"image","label":"Image","type":"image","required":true,"ui":{"tab":{"id":"media","label":"Media"}}},{"key":"theme","label":"Theme","type":"select","defaultValue":"light","config":{"options":[{"label":"Light","value":"light"},{"label":"Dark","value":"dark"},{"label":"Brand","value":"brand"}]},"ui":{"control":"segmented","tab":{"id":"design","label":"Design"}}}],"description":"Copy and buttons beside a photo, with a customer quote card overlapping it.","category":"Heroes","icon":"message-circle-2","preview":{"title":"heading","subtitle":"eyebrow","media":"image"}}},
|
|
1388
1388
|
{"id":"hero-event","name":"Event hero","category":"Heroes","kind":"block","tags":["conditional","seo-structured","validation","media-heavy"],"proves":"Date/time with zone · in-person/online/hybrid venue with conditional map or stream · sold-out swap · Event data from content","why":"The event's FACTS (start/end with time zone, format, venue, map pin, stream) are structured because the same values drive the countdown, the add-to-calendar file and native Event JSON-LD — no separate SEO fields. Format decides which place fields show (venue/address/pin for in-person, stream for online, both for hybrid). Ticket status is one select that swaps the button: on sale → registerButton, sold out → waitlistButton, cancelled → a required note. If the site lists many events, these fields belong on an Events collection entry and the hero becomes a single reference (see pitfalls).","htmlSignals":["A hero with a date/time line (<time datetime=…>), a place line and a 'Register'/'Get tickets' button","A ticking countdown (days/hours/minutes) bound to a data-date attribute","Ticketing links (eventbrite.com, tito.io, lu.ma) or a 'Sold out' badge","JSON-LD @type Event with eventAttendanceMode (Offline/Online/Mixed) and location/VirtualLocation","An 'Add to calendar' link or .ics download"],"mcp":"Hero with a date + place + ticket button → `eventHero`. <time datetime> or the countdown's data-date → startsAt with its offset (ask for the zone if the source has none). JSON-LD eventAttendanceMode → format (Offline → in-person, Online → online, Mixed → hybrid); location.name/address/geo → venue/address/location. Ticket link → registerButton; 'Sold out' text → status 'sold-out'. Never model the add-to-calendar link — it's generated. If the page is one of many event pages, create an Events collection and report it.","pitfalls":["Dates stored as text ('Nov 14, 6pm') can't drive the countdown or JSON-LD — always a datetime with offset.","End before start isn't caught today (gap: cross-field validation)."],"notCarried":[],"component":{"name":"Event hero","slug":"event-hero","props":[{"key":"eyebrow","label":"Eyebrow","type":"text","config":{"maxLength":40},"ui":{"tab":{"id":"content","label":"Content"}}},{"key":"heading","label":"Event name","type":"text","required":true,"ai":true,"recommendedMax":48,"localized":true,"config":{"maxLength":100},"ui":{"tab":{"id":"content"}}},{"key":"body","label":"Body","type":"longtext","ai":true,"recommendedMax":160,"localized":true,"ui":{"rows":3,"tab":{"id":"content"}}},{"key":"image","label":"Image","type":"image","required":true,"ui":{"tab":{"id":"content"}}},{"key":"startsAt","label":"Starts","type":"datetime","helpText":"In the event's own time zone. Visitors see it converted.","required":true,"ui":{"tab":{"id":"when","label":"When & where"}}},{"key":"endsAt","label":"Ends","type":"datetime","ui":{"tab":{"id":"when"}}},{"key":"format","label":"Format","type":"select","defaultValue":"in-person","config":{"options":[{"label":"In person","value":"in-person"},{"label":"Online","value":"online"},{"label":"Hybrid","value":"hybrid"}]},"ui":{"control":"segmented","tab":{"id":"when"}}},{"key":"venue","label":"Venue","type":"text","required":true,"showIf":{"match":"all","rules":[{"field":"format","op":"in","value":["in-person","hybrid"]}]},"config":{"maxLength":60},"ui":{"tab":{"id":"when"}}},{"key":"address","label":"Address","type":"longtext","showIf":{"match":"all","rules":[{"field":"format","op":"in","value":["in-person","hybrid"]}]},"ui":{"rows":2,"tab":{"id":"when"}}},{"key":"location","label":"Map pin","type":"location","showIf":{"match":"all","rules":[{"field":"format","op":"in","value":["in-person","hybrid"]}]},"ui":{"tab":{"id":"when"}}},{"key":"stream","label":"Stream link","type":"link","helpText":"Shown on the page only once the event starts.","showIf":{"match":"all","rules":[{"field":"format","op":"in","value":["online","hybrid"]}]},"ui":{"tab":{"id":"when"}}},{"key":"showCountdown","label":"Show a countdown","type":"boolean","defaultValue":true,"ui":{"tab":{"id":"when"}}},{"key":"status","label":"Ticket status","type":"select","defaultValue":"on-sale","config":{"options":[{"label":"On sale","value":"on-sale"},{"label":"Few left","value":"few-left","description":"Adds a ‘Few tickets left’ note"},{"label":"Sold out","value":"sold-out","description":"Swaps the button for a waitlist"},{"label":"Cancelled","value":"cancelled"}]},"ui":{"control":"radio","tab":{"id":"tickets","label":"Tickets"}}},{"key":"registerButton","label":"Register button","type":"button","required":true,"showIf":{"match":"all","rules":[{"field":"status","op":"in","value":["on-sale","few-left"]}]},"ui":{"tab":{"id":"tickets"}}},{"key":"price","label":"Price line","type":"text","showIf":{"match":"all","rules":[{"field":"status","op":"in","value":["on-sale","few-left"]}]},"placeholder":"From $150 · Tables of 8 available","config":{"maxLength":48},"ui":{"tab":{"id":"tickets"}}},{"key":"waitlistButton","label":"Waitlist button","type":"button","required":true,"showIf":{"match":"all","rules":[{"field":"status","op":"eq","value":"sold-out"}]},"ui":{"tab":{"id":"tickets"}}},{"key":"cancelNote","label":"Cancellation note","type":"longtext","required":true,"showIf":{"match":"all","rules":[{"field":"status","op":"eq","value":"cancelled"}]},"config":{"maxLength":200},"ui":{"rows":2,"tab":{"id":"tickets"}}},{"key":"overlay","label":"Image overlay","type":"number","defaultValue":35,"config":{"min":0,"max":80,"step":5,"unit":"%"},"ui":{"control":"slider","tab":{"id":"design","label":"Design"}}},{"key":"theme","label":"Theme","type":"select","defaultValue":"dark","config":{"options":[{"label":"Light","value":"light"},{"label":"Dark","value":"dark"},{"label":"Brand","value":"brand"}]},"ui":{"control":"segmented","tab":{"id":"design"}}}],"description":"Event name, date, place, a countdown and the register button.","category":"Heroes","icon":"calendar-event","preview":{"title":"heading","subtitle":"startsAt","media":"image"}}},
|
|
1389
1389
|
{"id":"hero-personalized","name":"Personalized hero (audiences + A/B)","category":"Heroes","kind":"block","tags":["personalization","conditional","repeater","validation","deep-nesting"],"proves":"Default content + audience versions that override only what they set · rule types with conditional inputs · an experiment split","why":"Personalization is modelled as ONE hero with a default ('Everyone') and an ordered array of audience versions that override only the fields they fill — so a returning-visitor version can change just the button. Each audience holds a rule object whose inputs depend on the rule type (a string for UTM/referrer, countries for geo, a segment select for CRM), making Hero › Audiences › Audience › Rule a four-level drill. The A/B test is a separate object in its own tab; its settings only appear when it's on. Overrides are plain optional fields with 'leave empty to keep' help, because the schema can't yet express inherit-from-default.","htmlSignals":["Server-rendered HTML differs between crawls with different ?utm_campaign= or Accept-Language/geo — compare responses","Multiple hidden hero variants in the DOM with data-variant / data-audience attributes","Experiment SDKs: Optimizely, VWO, Google Optimize remnants, LaunchDarkly, Ninetailed, Statsig (window.optimizely, _vwo_code)","Flicker-prevention snippets (async-hide, opacity:0 on body until the SDK decides)"],"mcp":"Only mark a hero personalized with evidence: hidden variants in the DOM or different responses for different UTM/geo requests. The variant shown with no parameters → the Everyone fields. Each other variant → audiences[] with ONLY the fields that differ (leave the rest empty), rule from the parameter that triggered it. Experiment SDK config (traffic allocation, goal event) → test. Never import third-party experiment ids as content; report the SDK so the team can decide whether BetterCMS replaces it.","pitfalls":["Copying the whole hero into every audience — later edits to Everyone no longer reach them. Store only the differences.","Two audiences that both match: order decides; the converter must preserve the source's precedence.","Personalized copy must not be indexed as the canonical content — crawlers see Everyone."],"notCarried":[],"component":{"name":"Audience hero","slug":"audience-hero","props":[{"key":"eyebrow","label":"Eyebrow","type":"text","config":{"maxLength":40},"ui":{"tab":{"id":"content","label":"Everyone"}}},{"key":"heading","label":"Heading","type":"text","required":true,"ai":true,"recommendedMax":60,"localized":true,"config":{"maxLength":100},"ui":{"tab":{"id":"content"}}},{"key":"body","label":"Body","type":"longtext","ai":true,"recommendedMax":180,"localized":true,"ui":{"rows":3,"tab":{"id":"content"}}},{"key":"primaryButton","label":"Primary button","type":"button","ui":{"tab":{"id":"content"}}},{"key":"image","label":"Image","type":"image","ui":{"tab":{"id":"content"}}},{"key":"audiences","label":"Audience versions","type":"table","helpText":"Checked top to bottom; the first match wins.","config":{"maxItems":5,"fields":[{"key":"name","label":"Name","type":"text","helpText":"Only editors see this.","required":true,"config":{"maxLength":40}},{"key":"rule","label":"Who sees it","type":"object","openMode":"drill","fields":[{"key":"type","label":"Match by","type":"select","required":true,"options":[{"label":"Ad campaign (utm_campaign)","value":"utm_campaign"},{"label":"Came from a site","value":"referrer"},{"label":"Country","value":"country"},{"label":"Returning visitor","value":"returning","description":"Visited in the last 30 days"},{"label":"CRM segment","value":"segment"}]},{"key":"match","label":"Contains","type":"text","required":true,"showIf":{"match":"all","rules":[{"field":"type","op":"in","value":["utm_campaign","referrer"]}]},"placeholder":"k8s-launch","config":{"maxLength":80}},{"key":"countries","label":"Countries","type":"multiselect","showIf":{"match":"all","rules":[{"field":"type","op":"eq","value":"country"}]},"options":[{"label":"United States","value":"US"},{"label":"United Kingdom","value":"GB"},{"label":"Germany","value":"DE"},{"label":"India","value":"IN"},{"label":"Japan","value":"JP"}],"config":{"min":1}},{"key":"segment","label":"Segment","type":"select","required":true,"showIf":{"match":"all","rules":[{"field":"type","op":"eq","value":"segment"}]},"options":[{"label":"Enterprise accounts (1,000+ staff)","value":"enterprise"},{"label":"Active trials","value":"trial"},{"label":"Cancelled in the last 90 days","value":"churned"}]}],"ui":{"icon":"filter"}},{"key":"eyebrow","label":"Eyebrow","type":"text","helpText":"Leave empty to keep the Everyone version.","config":{"maxLength":40}},{"key":"heading","label":"Heading","type":"text","helpText":"Leave empty to keep the Everyone version.","ai":true,"recommendedMax":60,"config":{"maxLength":100}},{"key":"body","label":"Body","type":"longtext","helpText":"Leave empty to keep the Everyone version.","ai":true,"recommendedMax":180,"ui":{"rows":3}},{"key":"primaryButton","label":"Primary button","type":"button","helpText":"Leave empty to keep the Everyone version."},{"key":"image","label":"Image","type":"image","helpText":"Leave empty to keep the Everyone version."}]},"ui":{"itemLabel":"Audience","icon":"user-search","preview":{"title":"name","subtitle":"rule.type","fallback":"Untitled audience"},"tab":{"id":"audiences","label":"Audiences"}}},{"key":"test","label":"A/B test","type":"object","openMode":"drill","config":{"fields":[{"key":"isRunning","label":"Run a test","type":"boolean"},{"key":"share","label":"Share seeing the new version","type":"number","defaultValue":50,"showIf":{"match":"all","rules":[{"field":"isRunning","op":"eq","value":"true"}]},"config":{"min":10,"max":90,"step":5,"unit":"%"},"ui":{"control":"slider"}},{"key":"goal","label":"Success means","type":"select","required":true,"showIf":{"match":"all","rules":[{"field":"isRunning","op":"eq","value":"true"}]},"options":[{"label":"Clicked the primary button","value":"primary-click"},{"label":"Started a trial","value":"signup"},{"label":"Booked a demo","value":"demo"}]},{"key":"endsOn","label":"Stop on","type":"date","showIf":{"match":"all","rules":[{"field":"isRunning","op":"eq","value":"true"}]}}]},"ui":{"icon":"flask","tab":{"id":"experiment","label":"Experiment"}}},{"key":"theme","label":"Theme","type":"select","defaultValue":"light","config":{"options":[{"label":"Light","value":"light"},{"label":"Dark","value":"dark"},{"label":"Brand","value":"brand"}]},"ui":{"control":"segmented","tab":{"id":"design","label":"Design"}}}],"description":"One hero with versions for different audiences, and an optional A/B test.","category":"Heroes","icon":"target","preview":{"title":"heading","subtitle":"eyebrow","media":"image"}}},
|
|
1390
|
-
{"id":"feature-icon-grid","name":"Icon feature grid","category":"Features & storytelling","kind":"block","tags":["repeater","variants","validation","localized"],"proves":"Bounded repeater · per-item optional link · column count as a variant, not a number field","why":"Features are an ARRAY OF OBJECTS because they are owned by this section and never reused elsewhere — if the same benefits appear on five product pages, promote them to a `col_features` collection and switch the array to references. Column count is a VARIANT (3/4/list), not a number, because the layout changes (icon beside vs above text), and variants swap without losing content. The per-feature link is a `link` (not a button) because it is a quiet text link; the section CTA is a `button`. Icon style and dividers are design and live in the Design group.","htmlSignals":["A heading followed by a grid (`display:grid` / `grid-cols-3|4`) of 3–12 sibling cards with identical structure","Each card starts with an `<svg>` or icon font `<i>` (24–48px) before an `<h3>`/`<h4>` and one `<p>`","No images larger than 64px inside the cards (that would be a card grid, not a feature grid)","Optional trailing `<a>` per card with text like “Learn more” / “Read more”"],"mcp":"Map the section `<h2>` → heading, the small uppercase text above it → eyebrow, the first `<p>` after it → intro. For each repeated card: SVG/icon → `icon` (match to the nearest Tabler name by the icon's `aria-label`, class name like `ti-flame`/`lucide-flame`, or path similarity; fall back to `sparkles`), `<h3>` → title, `<p>` → body, trailing anchor → link (`type: \"url\"` for absolute hrefs, `page` when the href resolves to a known page). Pick the variant from the computed column count at desktop width (3 → three, 4 → four, 2 with icon beside text → list). Do not create fields for card background, padding or icon color — they are theme tokens.","pitfalls":["Do not invent a `columns` number field — column count is the variant; a free number lets editors break the layout.","Feature cards with large photos are an image card grid, not this block.","Icon fonts with ligatures (Material Symbols) store the icon as TEXT content — read the text, not the class."],"notCarried":["variants"],"component":{"name":"Feature grid","slug":"feature-grid","props":[{"key":"eyebrow","label":"Eyebrow","type":"text","config":{"maxLength":32},"ui":{"tab":{"id":"content","label":"Content"}}},{"key":"heading","label":"Heading","type":"text","required":true,"ai":true,"recommendedMax":60,"localized":true,"ui":{"tab":{"id":"content"}}},{"key":"intro","label":"Intro","type":"longtext","ai":true,"recommendedMax":200,"localized":true,"ui":{"rows":2,"tab":{"id":"content"}}},{"key":"features","label":"Features","type":"table","config":{"minItems":2,"maxItems":12,"fields":[{"key":"icon","label":"Icon","type":"icon","helpText":"Leave empty to show a number instead."},{"key":"title","label":"Title","type":"text","required":true,"ai":true,"localized":true,"config":{"maxLength":48}},{"key":"body","label":"Body","type":"longtext","ai":true,"recommendedMax":140,"localized":true,"ui":{"rows":2}},{"key":"link","label":"Learn more link","type":"link"}]},"ui":{"itemLabel":"Feature","icon":"sparkles","preview":{"title":"title","subtitle":"body","fallback":"Untitled feature"},"tab":{"id":"content"}}},{"key":"button","label":"Button","type":"button","ui":{"tab":{"id":"content"}}},{"key":"iconStyle","label":"Icon style","type":"select","defaultValue":"tile","config":{"options":[{"label":"Plain","value":"plain","icon":"point","description":"Icon only"},{"label":"Tile","value":"tile","icon":"square","description":"Icon on a soft square"},{"label":"Circle","value":"circle","icon":"circle","description":"Icon on a soft circle"}]},"ui":{"control":"cards","tab":{"id":"design","label":"Design"}}},{"key":"alignment","label":"Alignment","type":"select","defaultValue":"left","config":{"options":[{"label":"Left","value":"left"},{"label":"Center","value":"center"}]},"ui":{"control":"segmented","tab":{"id":"design"}}},{"key":"showDividers","label":"Show dividers","type":"boolean","ui":{"tab":{"id":"design"}}},{"key":"theme","label":"Theme","type":"select","defaultValue":"light","config":{"options":[{"label":"Light","value":"light"},{"label":"Dark","value":"dark"},{"label":"Brand","value":"brand"}]},"ui":{"control":"segmented","tab":{"id":"design"}}},{"key":"anchor","label":"Anchor","type":"text","advanced":true,"config":{"pattern":"^[a-z0-9-]*$","patternMessage":"Use lowercase letters, numbers and hyphens, like our-story."},"ui":{"tab":{"id":"design"}}}],"description":"Icon, title and a short line for each benefit, in 2–4 columns","category":"Features & storytelling","icon":"layout-grid","preview":{"title":"heading","subtitle":"eyebrow","icon":"layout-grid"}}},
|
|
1390
|
+
{"id":"feature-icon-grid","name":"Icon feature grid","category":"Features & storytelling","kind":"block","tags":["repeater","variants","validation","localized"],"proves":"Bounded repeater · per-item optional link · column count as a variant, not a number field","why":"Features are an ARRAY OF OBJECTS because they are owned by this section and never reused elsewhere — if the same benefits appear on five product pages, promote them to a `col_features` collection and switch the array to references. Column count is a VARIANT (3/4/list), not a number, because the layout changes (icon beside vs above text), and variants swap without losing content. The per-feature link is a `link` (not a button) because it is a quiet text link; the section CTA is a `button`. Icon style and dividers are design and live in the Design group.","htmlSignals":["A heading followed by a grid (`display:grid` / `grid-cols-3|4`) of 3–12 sibling cards with identical structure","Each card starts with an `<svg>` or icon font `<i>` (24–48px) before an `<h3>`/`<h4>` and one `<p>`","No images larger than 64px inside the cards (that would be a card grid, not a feature grid)","Optional trailing `<a>` per card with text like “Learn more” / “Read more”"],"mcp":"Map the section `<h2>` → heading, the small uppercase text above it → eyebrow, the first `<p>` after it → intro. For each repeated card: SVG/icon → `icon` (match to the nearest Tabler name by the icon's `aria-label`, class name like `ti-flame`/`lucide-flame`, or path similarity; fall back to `sparkles`), `<h3>` → title, `<p>` → body, trailing anchor → link (`type: \"url\"` for absolute hrefs, `page` when the href resolves to a known page). Pick the variant from the computed column count at desktop width (3 → three, 4 → four, 2 with icon beside text → list). Do not create fields for card background, padding or icon color — they are theme tokens.","pitfalls":["Do not invent a `columns` number field — column count is the variant; a free number lets editors break the layout.","Feature cards with large photos are an image card grid, not this block.","Icon fonts with ligatures (Material Symbols) store the icon as TEXT content — read the text, not the class."],"notCarried":["variants"],"component":{"name":"Feature grid","slug":"feature-grid","props":[{"key":"eyebrow","label":"Eyebrow","type":"text","config":{"maxLength":32},"ui":{"tab":{"id":"content","label":"Content"}}},{"key":"heading","label":"Heading","type":"text","required":true,"ai":true,"recommendedMax":60,"localized":true,"ui":{"tab":{"id":"content"}}},{"key":"intro","label":"Intro","type":"longtext","ai":true,"recommendedMax":200,"localized":true,"ui":{"rows":2,"tab":{"id":"content"}}},{"key":"features","label":"Features","type":"table","config":{"minItems":2,"maxItems":12,"fields":[{"key":"icon","label":"Icon","type":"icon","helpText":"Leave empty to show a number instead.","config":{"icons":{"sources":["pack","library","upload"]}}},{"key":"title","label":"Title","type":"text","required":true,"ai":true,"localized":true,"config":{"maxLength":48}},{"key":"body","label":"Body","type":"longtext","ai":true,"recommendedMax":140,"localized":true,"ui":{"rows":2}},{"key":"link","label":"Learn more link","type":"link"}]},"ui":{"itemLabel":"Feature","icon":"sparkles","preview":{"title":"title","subtitle":"body","fallback":"Untitled feature"},"tab":{"id":"content"}}},{"key":"button","label":"Button","type":"button","ui":{"tab":{"id":"content"}}},{"key":"iconStyle","label":"Icon style","type":"select","defaultValue":"tile","config":{"options":[{"label":"Plain","value":"plain","icon":"point","description":"Icon only"},{"label":"Tile","value":"tile","icon":"square","description":"Icon on a soft square"},{"label":"Circle","value":"circle","icon":"circle","description":"Icon on a soft circle"}]},"ui":{"control":"cards","tab":{"id":"design","label":"Design"}}},{"key":"alignment","label":"Alignment","type":"select","defaultValue":"left","config":{"options":[{"label":"Left","value":"left"},{"label":"Center","value":"center"}]},"ui":{"control":"segmented","tab":{"id":"design"}}},{"key":"showDividers","label":"Show dividers","type":"boolean","ui":{"tab":{"id":"design"}}},{"key":"theme","label":"Theme","type":"select","defaultValue":"light","config":{"options":[{"label":"Light","value":"light"},{"label":"Dark","value":"dark"},{"label":"Brand","value":"brand"}]},"ui":{"control":"segmented","tab":{"id":"design"}}},{"key":"anchor","label":"Anchor","type":"text","advanced":true,"config":{"pattern":"^[a-z0-9-]*$","patternMessage":"Use lowercase letters, numbers and hyphens, like our-story."},"ui":{"tab":{"id":"design"}}}],"description":"Icon, title and a short line for each benefit, in 2–4 columns","category":"Features & storytelling","icon":"layout-grid","preview":{"title":"heading","subtitle":"eyebrow","icon":"layout-grid"}}},
|
|
1391
1391
|
{"id":"feature-alternating-rows","name":"Alternating feature rows","category":"Features & storytelling","kind":"block","tags":["repeater","conditional","media-heavy","variants","rich-text"],"proves":"Per-row media type (image or video) via conditional fields · auto-alternating side with per-row override","why":"Rows are an ARRAY OF OBJECTS — each row is a mini-section with its own media, so a slot would be overkill and would let editors drop unrelated blocks in. The image side is DERIVED (section `startSide` + row index) and only stored when an editor overrides it (`side: auto|left|right`), so reordering rows keeps the zigzag intact. Image vs video is a `mediaType` select with conditional fields rather than two optional fields, so exactly one is required and validation is honest. Bullet points are a primitive string array, not rich text, so the checkmark list renders consistently.","htmlSignals":["Two or more consecutive blocks each with a 2-column layout (text + media) where the DOM order or `flex-direction: row-reverse` / `order-last` flips on alternating rows","Each block has its own `<h2>`/`<h3>`, a `<p>` and often a `<ul>` with check icons","Media is an `<img>`/`<picture>` or a muted `<video autoplay loop playsinline>`","Class names like `feature-row`, `zigzag`, `media-text`, `lg:flex-row-reverse` on every second row"],"mcp":"Group consecutive text+media rows into ONE featureRows block (not one block per row). Per row: `<h2|h3>` → title, small text above → eyebrow, paragraphs → body (keep `<strong>`, `<em>`, `<a>`; drop wrappers), `<ul>` items → points (strip icons), anchor/button → button. `<video>` → mediaType video + video.url from `<source src>` and poster from `poster=`; else image with `alt` from the img. Detect `startSide` from where the FIRST row's media sits; only set a row's `side` when it breaks the alternation. Media aspect ratio → mediaRatio (round to the nearest option).","pitfalls":["Storing `side` on every row breaks the zigzag the moment rows are reordered — store `auto` unless the source deliberately breaks the pattern.","Autoplay videos without a poster flash black; always extract or generate a poster."],"notCarried":["variants"],"component":{"name":"Feature rows","slug":"feature-rows","props":[{"key":"heading","label":"Heading","type":"text","ai":true,"recommendedMax":60,"localized":true,"ui":{"tab":{"id":"content","label":"Content","order":0}}},{"key":"rows","label":"Rows","type":"table","config":{"minItems":1,"maxItems":6,"fields":[{"key":"eyebrow","label":"Eyebrow","type":"text","config":{"maxLength":32}},{"key":"title","label":"Title","type":"text","required":true,"ai":true,"recommendedMax":60,"localized":true},{"key":"body","label":"Body","type":"richtext","ai":true,"localized":true,"config":{"features":["bold","italic","underline","strikethrough","code","highlight","blockquote","horizontalRule","orderedList","unorderedList","checklist","link","internalLink","inlineImage","videoEmbed","codeBlock","table","columns","h1","h2","h3","h4","h5","h6","gallery","embed","tableOfContents","relatedPosts","authorBio","footnotes","button"]}},{"key":"points","label":"Points","type":"array","config":{"maxItems":5,"itemType":"text","item":{"maxLength":80,"localized":true}},"ui":{"itemLabel":"Point"}},{"key":"button","label":"Button","type":"button"},{"key":"mediaType","label":"Media","type":"select","defaultValue":"image","options":[{"label":"Image","value":"image"},{"label":"Video","value":"video"}],"ui":{"control":"segmented","tab":{"id":"media"}}},{"key":"image","label":"Image","type":"image","required":true,"showIf":{"match":"all","rules":[{"field":"mediaType","op":"eq","value":"image"}]},"ui":{"tab":{"id":"media"}}},{"key":"video","label":"Video","type":"video","helpText":"Plays muted and loops.","required":true,"showIf":{"match":"all","rules":[{"field":"mediaType","op":"eq","value":"video"}]},"ui":{"tab":{"id":"media"}}},{"key":"side","label":"Image side","type":"select","helpText":"Auto alternates from the section's first side.","defaultValue":"auto","options":[{"label":"Auto","value":"auto"},{"label":"Left","value":"left"},{"label":"Right","value":"right"}],"ui":{"control":"segmented","tab":{"id":"design"}}}]},"ui":{"itemLabel":"Row","icon":"layout-rows","preview":{"title":"title","subtitle":"eyebrow","media":"image","fallback":"Untitled row"},"tab":{"id":"content"}}},{"key":"startSide","label":"First image on","type":"select","helpText":"Later rows alternate from here.","defaultValue":"right","config":{"options":[{"label":"Left","value":"left"},{"label":"Right","value":"right"}]},"ui":{"control":"segmented","tab":{"id":"design","label":"Design","order":2}}},{"key":"mediaRatio","label":"Media shape","type":"select","defaultValue":"4:3","config":{"options":[{"label":"Square","value":"1:1"},{"label":"4:3","value":"4:3"},{"label":"Portrait","value":"3:4"}]},"ui":{"control":"segmented","tab":{"id":"design"}}},{"key":"theme","label":"Theme","type":"select","defaultValue":"light","config":{"options":[{"label":"Light","value":"light"},{"label":"Dark","value":"dark"},{"label":"Brand","value":"brand"}]},"ui":{"control":"segmented","tab":{"id":"design"}}},{"key":"anchor","label":"Anchor","type":"text","advanced":true,"config":{"pattern":"^[a-z0-9-]*$","patternMessage":"Use lowercase letters, numbers and hyphens, like our-story."},"ui":{"tab":{"id":"design"}}}],"description":"Image and text side by side, swapping sides row after row","category":"Features & storytelling","icon":"layout-rows","preview":{"title":"heading","icon":"layout-rows"},"tabs":[{"id":"media","label":"Media","order":1}]}},
|
|
1392
1392
|
{"id":"bento-feature-showcase","name":"Feature bento (responsive spans)","category":"Features & storytelling","kind":"block","tags":["slots","responsive-layout","conditional","media-heavy","variants"],"proves":"Slot of blocks with per-breakpoint span, phone order and conditional background in slotSettings","why":"The cells are a SLOT (blocks inside a block) because bento cells are genuinely heterogeneous — a screenshot, a stat, a quote, a clip — and each needs its own schema. Unlike the core bento (one `span` preset), sizing here is RESPONSIVE: desktop column/row spans, a tablet width and a phone order are stored in `_settings` on each child, so the cell's CONTENT stays clean and the layout data travels with the cell when it is reordered. The background image is a slot setting (layout/surface), not cell content, and only appears when surface = image.","htmlSignals":["A CSS grid container with children using different `grid-column: span N` / `col-span-2` / `row-span-2` classes","Children of different internal shapes (one has a big image, one a giant number, one a blockquote)","Breakpoint-prefixed span classes (`md:col-span-2 lg:col-span-3`) or `order-*` classes for mobile","Rounded tiles with differing backgrounds (dark, brand color, photo)"],"mcp":"Treat each grid child as a slot child; classify by content: big number + short label → statBlock, img/video dominant → imageBlock/videoBlock, blockquote/quote marks → quoteBlock, icon+h3+p → featureBlock, heading+button → ctaCard, else textBlock. Read spans from computed `grid-column-end`/`grid-row-end` at 1280px → desktopWidth/rowsDesktop, at 768px → tabletWidth (full when it spans every column). DOM order vs visual order on a 375px viewport → mobileOrder only when they differ. Background color → surface (match to brand tokens; photo backgrounds → surface image + background).","pitfalls":["Do not put span values on the child block's own fields — reusing that block elsewhere would carry a meaningless span.","Phones stack cells; if the source reorders them with CSS `order`, capture it or the story reads out of order.","6-column variants need spans up to 6; validate spans against the variant's column count."],"notCarried":["variants"],"component":{"name":"Feature bento","slug":"feature-bento","props":[{"key":"eyebrow","label":"Eyebrow","type":"text","config":{"maxLength":32},"ui":{"tab":{"id":"content","label":"Content"}}},{"key":"heading","label":"Heading","type":"text","required":true,"ai":true,"recommendedMax":60,"localized":true,"ui":{"tab":{"id":"content"}}},{"key":"subheading","label":"Subheading","type":"longtext","ai":true,"recommendedMax":180,"localized":true,"ui":{"rows":2,"tab":{"id":"content"}}},{"key":"cells","label":"Cells","type":"slot","config":{"multiple":true,"minItems":3,"maxItems":10,"allow":["featureBlock","statBlock","imageBlock","videoBlock","quoteBlock","ctaCard","textBlock"],"slotSettings":[{"key":"desktopWidth","label":"Width on desktop","type":"number","helpText":"In grid columns.","defaultValue":2,"config":{"min":1,"max":6,"step":1,"unit":"cols"},"ui":{"control":"slider"}},{"key":"rowsDesktop","label":"Height on desktop","type":"number","defaultValue":1,"config":{"min":1,"max":3,"step":1,"unit":"rows"},"ui":{"control":"slider"}},{"key":"tabletWidth","label":"Width on tablet","type":"select","defaultValue":"half","options":[{"label":"Half","value":"half"},{"label":"Full","value":"full"}],"ui":{"control":"segmented"}},{"key":"mobileOrder","label":"Order on phones","type":"number","helpText":"Lower numbers go first. Leave empty to keep the desktop order.","config":{"min":1,"max":10,"step":1}},{"key":"surface","label":"Surface","type":"select","defaultValue":"muted","options":[{"label":"Muted","value":"muted"},{"label":"Dark","value":"dark"},{"label":"Brand","value":"brand"},{"label":"Image","value":"image"}],"ui":{"control":"segmented"}},{"key":"background","label":"Background image","type":"image","showIf":{"match":"all","rules":[{"field":"surface","op":"eq","value":"image"}]}}]},"ui":{"tab":{"id":"content"}}},{"key":"button","label":"Button","type":"button","ui":{"tab":{"id":"content"}}},{"key":"gap","label":"Gap","type":"select","defaultValue":"md","config":{"options":[{"label":"S","value":"sm"},{"label":"M","value":"md"},{"label":"L","value":"lg"}]},"ui":{"control":"segmented","tab":{"id":"design","label":"Design"}}},{"key":"radius","label":"Corner radius","type":"select","defaultValue":"lg","config":{"options":[{"label":"None","value":"none"},{"label":"M","value":"md"},{"label":"L","value":"lg"}]},"ui":{"control":"segmented","tab":{"id":"design"}}},{"key":"theme","label":"Theme","type":"select","defaultValue":"light","config":{"options":[{"label":"Light","value":"light"},{"label":"Dark","value":"dark"},{"label":"Brand","value":"brand"}]},"ui":{"control":"segmented","tab":{"id":"design"}}}],"description":"Product capabilities as a mosaic of cells, each its own block, sized per screen","category":"Features & storytelling","icon":"layout-dashboard","preview":{"title":"heading","subtitle":"eyebrow","icon":"layout-dashboard"}}},
|
|
1393
1393
|
{"id":"steps-how-it-works","name":"Steps / how it works","category":"Features & storytelling","kind":"block","tags":["repeater","variants","validation"],"proves":"Order is the number (never stored) · optional per-step image used by one variant only","why":"Steps are an ORDERED ARRAY; the step number is computed from the index so drag-to-reorder can never desync it. `duration` is a short string (\"10 days\", \"Day 3\") rather than a number+unit pair because it is display copy, not data anyone filters on. The per-step image is optional and only rendered by the Vertical variant — keeping it on the item (instead of a separate array) means switching variants never loses content.","htmlSignals":["An `<ol>` (or divs) of 2–6 items each starting with a large number (“1”, “01”, “Step 1”) or a numbered circle","Connector lines between items (`::before`/`::after` borders, SVG dashes)","Headings like “How it works”, “Getting started”, “What happens next”"],"mcp":"Strip the visible number from each step's title (“01 — Start a claim” → “Start a claim”) and set numberStyle from its format (1 → digits, 01 → padded, none visible → none). Per step: heading → title, paragraph → body, small pill/meta text (“2 min”) → duration, icon → icon. Pick the variant from the layout direction (horizontal → row, vertical with images → stack, bordered tiles → cards). A dashed line/border between numbers → showConnector true.","pitfalls":["Never store the number as content — the converter must strip it, otherwise reordering shows “3, 1, 2”.","HowTo rich results were retired by Google; do not emit HowTo JSON-LD for this block."],"notCarried":["variants"],"component":{"name":"Steps","slug":"how-it-works","props":[{"key":"eyebrow","label":"Eyebrow","type":"text","config":{"maxLength":32},"ui":{"tab":{"id":"content","label":"Content"}}},{"key":"heading","label":"Heading","type":"text","required":true,"ai":true,"recommendedMax":60,"localized":true,"ui":{"tab":{"id":"content"}}},{"key":"steps","label":"Steps","type":"table","helpText":"Numbers come from the order.","config":{"minItems":2,"maxItems":6,"fields":[{"key":"title","label":"Title","type":"text","required":true,"ai":true,"localized":true,"config":{"maxLength":48}},{"key":"body","label":"Body","type":"longtext","ai":true,"recommendedMax":160,"localized":true,"ui":{"rows":2}},{"key":"icon","label":"Icon","type":"icon","helpText":"Cards layout only. Replaces the number."},{"key":"duration","label":"Time it takes","type":"text","placeholder":"2 minutes","config":{"maxLength":20}},{"key":"image","label":"Image","type":"image","helpText":"Vertical layout only."},{"key":"link","label":"Link","type":"link"}]},"ui":{"itemLabel":"Step","icon":"circle-number-1","preview":{"title":"title","subtitle":"body","media":"image","fallback":"Untitled step"},"tab":{"id":"content"}}},{"key":"button","label":"Button","type":"button","ui":{"tab":{"id":"content"}}},{"key":"numberStyle","label":"Numbering","type":"select","defaultValue":"digits","config":{"options":[{"label":"1 2 3","value":"digits"},{"label":"01 02 03","value":"padded"},{"label":"None","value":"none"}]},"ui":{"control":"segmented","tab":{"id":"design","label":"Design"}}},{"key":"showConnector","label":"Connect the steps","type":"boolean","defaultValue":true,"ui":{"tab":{"id":"design"}}},{"key":"theme","label":"Theme","type":"select","defaultValue":"light","config":{"options":[{"label":"Light","value":"light"},{"label":"Dark","value":"dark"},{"label":"Brand","value":"brand"}]},"ui":{"control":"segmented","tab":{"id":"design"}}}],"description":"A numbered process: how it works, getting started, what happens next","category":"Features & storytelling","icon":"list-numbers","preview":{"title":"heading","icon":"list-numbers"}}},
|
|
@@ -1443,7 +1443,7 @@
|
|
|
1443
1443
|
{"id":"conversion-contact-section","name":"Contact section","category":"Conversion & forms","kind":"block","tags":["form","references","repeater","conditional","embed","variants","a11y"],"proves":"Channel cards with typed links (email / phone / chat / visit) · form reference · optional map pin + address · layout variants","why":"A contact section is a directory, a form and a place. Channels are an array of small objects with a typed `link` (email, phone, section, page — the link unit already knows mailto/tel), plus hours and an honest reply time. The form is a reference (topic routing and notifications belong to the form in Forms, not to this block, so no `topics` field here) and is optional for the channels-only layout. The map is an opt-in cluster: a geopoint for the pin and a written address, because a map alone is inaccessible.","htmlSignals":["mailto: and tel: links grouped with labels like 'Customer service', 'Press', 'Wholesale'","a contact <form> with name/email/message (often a topic select)","an embedded map iframe (google.com/maps/embed) or static map image with an address block","opening hours and 'we reply within…' copy"],"mcp":"Each mailto:/tel:/chat trigger → one channel (kind from the scheme, label from the nearest heading, detail = visible text). The <form> → match/create a form in Forms and reference it; a topic <select> becomes a field ON that form (with routing set in Forms), not a section field. Map iframes → showMap:true, parse lat/lng from the embed URL (q= or !3d!4d) into location, and copy the address text.","pitfalls":["Email addresses and phone numbers duplicated across header, footer and contact drift apart — prefer site settings + references (gap: global values referenced from sections).","Address must be text as well as a pin; maps aren't accessible on their own."],"notCarried":["variants"],"component":{"name":"Contact","slug":"contact-section","props":[{"key":"heading","label":"Heading","type":"text","required":true,"recommendedMax":48,"ui":{"tab":{"id":"content","label":"Content"}}},{"key":"intro","label":"Intro","type":"longtext","recommendedMax":160,"ui":{"rows":2,"tab":{"id":"content"}}},{"key":"channels","label":"Channels","type":"table","config":{"minItems":1,"maxItems":5,"fields":[{"key":"kind","label":"Type","type":"select","defaultValue":"email","options":[{"label":"Email","value":"email","icon":"mail"},{"label":"Phone","value":"phone","icon":"phone"},{"label":"Chat","value":"chat","icon":"message"},{"label":"Visit","value":"visit","icon":"map-pin"}],"ui":{"control":"segmented"}},{"key":"label","label":"Label","type":"text","required":true,"placeholder":"Orders and returns","config":{"maxLength":32}},{"key":"link","label":"Link","type":"link","helpText":"An email, phone number or page. #chat opens the chat widget.","required":true},{"key":"detail","label":"Detail","type":"text","config":{"maxLength":60}},{"key":"hours","label":"Hours","type":"text","placeholder":"Mon–Fri, 8am–5pm PT","config":{"maxLength":48}},{"key":"replyTime","label":"Reply time","type":"text","placeholder":"Within a day","config":{"maxLength":32}}]},"ui":{"itemLabel":"Channel","icon":"message-circle","preview":{"title":"label","subtitle":"detail","fallback":"Untitled channel"},"tab":{"id":"channels","label":"Channels"}}},{"key":"form","label":"Form","type":"form","helpText":"Edit its fields and who gets notified in Forms.","ui":{"tab":{"id":"content"}}},{"key":"showMap","label":"Show a map","type":"boolean","ui":{"tab":{"id":"visit","label":"Visit us"}}},{"key":"location","label":"Map pin","type":"location","required":true,"showIf":{"match":"all","rules":[{"field":"showMap","op":"eq","value":"true"}]},"ui":{"tab":{"id":"visit"}}},{"key":"address","label":"Address","type":"longtext","showIf":{"match":"all","rules":[{"field":"showMap","op":"eq","value":"true"}]},"ui":{"rows":3,"tab":{"id":"visit"}}}],"description":"Ways to reach you, a form and where to find you","category":"Conversion & forms","icon":"address-book","preview":{"title":"heading","subtitle":"intro","icon":"address-book"}}},
|
|
1444
1444
|
{"id":"conversion-quiz-product-finder","name":"Quiz / product finder","category":"Conversion & forms","kind":"block","tags":["deep-nesting","conditional","references","repeater","validation","form","personalization","media-heavy","commerce"],"proves":"Six drill levels: questions › answers › scores › product refs · visitor-side branching (showIf) · results mapped to products with a fallback · optional email gate","why":"The deepest conversion pattern: section › questions › question › answers › answer › scores › score (+ a product reference inside). Scoring beats decision trees for product finders because answers can push several products up or rule one out (negative points), and it survives adding a product without rewriting branches. Branching is still possible with a visitor-side `showIf` on a question. Results are COPY keyed by product (products without copy fall back to their tagline) plus a required fallback, so the quiz never ends empty. The email gate is optional and never blocks results.","htmlSignals":["a 'Take the quiz' / 'Find your…' start screen, then one question per screen with large answer buttons or picture cards","a progress indicator (Question 2 of 4) and Back button","a results screen with 1–3 recommended products and 'why it suits you' copy","scripts from Octane AI, RevenueHunt, Typeform, Jebbit, or a JSON config with questions/answers/weights"],"mcp":"If a quiz config is reachable (Octane/RevenueHunt JSON, inline script), map it directly: questions → questions with generated keys, answer weights/tags → scores with product references (resolve product handles to Products entries). If only markup is visible, import questions and answers and leave scores EMPTY for a merchandiser to fill — never guess weights. Result screens → results (copy per product). Email steps → useEmailGate + a Forms reference.","pitfalls":["`showIf.field` and answer keys are strings, not references; renaming a key silently breaks branching (gap: references within the same entry, with rename-tracking).","Picture-card images can't be shown/hidden by the PARENT question's style (gap: parent-scoped conditions), so the image field is always visible with an explaining hint.","A gate that hides results until an email is given is a dark pattern; results always show."],"notCarried":[],"component":{"name":"Product finder quiz","slug":"product-quiz","props":[{"key":"heading","label":"Heading","type":"text","required":true,"ai":true,"recommendedMax":48,"ui":{"tab":{"id":"content","label":"Intro"}}},{"key":"intro","label":"Intro","type":"longtext","recommendedMax":160,"ui":{"rows":2,"tab":{"id":"content"}}},{"key":"image","label":"Image","type":"image","ui":{"tab":{"id":"content"}}},{"key":"startLabel","label":"Start button label","type":"text","required":true,"placeholder":"Find my pan","config":{"maxLength":24},"ui":{"tab":{"id":"content"}}},{"key":"questions","label":"Questions","type":"table","config":{"minItems":2,"maxItems":8,"fields":[{"key":"key","label":"Key","type":"text","helpText":"Used by \"Only show if\" on later questions.","required":true,"unique":true,"config":{"pattern":"^[a-z_]+$","patternMessage":"Use lowercase letters and underscores, like analytics_storage."}},{"key":"question","label":"Question","type":"text","required":true,"ai":true,"config":{"maxLength":90}},{"key":"help","label":"Hint","type":"text","config":{"maxLength":90}},{"key":"style","label":"Answers look like","type":"select","defaultValue":"buttons","options":[{"label":"Buttons","value":"buttons"},{"label":"Picture cards","value":"images"}],"ui":{"control":"segmented"}},{"key":"allowMultiple","label":"Allow several answers","type":"boolean"},{"key":"answers","label":"Answers","type":"table","fields":[{"key":"key","label":"Key","type":"text","required":true,"config":{"pattern":"^[a-z0-9-]+$","patternMessage":"Use lowercase letters, numbers and hyphens, like camp-kitchen."}},{"key":"label","label":"Label","type":"text","required":true,"config":{"maxLength":48}},{"key":"image","label":"Image","type":"image","helpText":"Used when answers show as picture cards."},{"key":"scores","label":"Points","type":"table","helpText":"The highest total wins.","openMode":"inline","fields":[{"key":"product","label":"Product","type":"reference","required":true,"config":{"contentModelId":"col_products"}},{"key":"points","label":"Points","type":"number","helpText":"Negative points rule a product out.","defaultValue":1,"config":{"min":-5,"max":5,"step":1}}],"config":{"maxItems":6},"ui":{"itemLabel":"Score","icon":"plus-minus","preview":{"title":"product","subtitle":"points","fallback":"Untitled score"}}}],"config":{"minItems":2,"maxItems":6},"ui":{"itemLabel":"Answer","icon":"point","preview":{"title":"label","subtitle":"key","media":"image","fallback":"Untitled answer"}}},{"key":"showIf","label":"Only show if","type":"object","helpText":"Leave empty to always show it.","openMode":"popover","fields":[{"key":"field","label":"Answer to","type":"text","helpText":"The key of an earlier question or field.","config":{"maxLength":32}},{"key":"operator","label":"Condition","type":"select","defaultValue":"equals","options":[{"label":"Is","value":"equals"},{"label":"Is not","value":"not"},{"label":"Has any answer","value":"answered"}]},{"key":"value","label":"Value","type":"text","helpText":"The answer's key, e.g. self-pay.","showIf":{"match":"all","rules":[{"field":"operator","op":"in","value":["equals","not"]}]},"config":{"maxLength":48}}],"ui":{"icon":"git-branch"}}]},"ui":{"itemLabel":"Question","icon":"help-circle","preview":{"title":"question","subtitle":"key","fallback":"Untitled question"},"tab":{"id":"questions","label":"Questions"}}},{"key":"resultsHeading","label":"Results heading","type":"text","placeholder":"Your match","config":{"maxLength":48},"ui":{"tab":{"id":"results","label":"Results"}}},{"key":"showTop","label":"Products to show","type":"number","defaultValue":1,"config":{"min":1,"max":3,"step":1},"ui":{"control":"slider","tab":{"id":"results"}}},{"key":"results","label":"Result copy","type":"table","config":{"maxItems":12,"fields":[{"key":"product","label":"Product","type":"reference","required":true,"config":{"contentModelId":"col_products"}},{"key":"heading","label":"Heading","type":"text","ai":true,"config":{"maxLength":60}},{"key":"why","label":"Why it fits","type":"richtext","ai":true,"config":{"features":["bold","italic","underline","strikethrough","code","highlight","blockquote","horizontalRule","orderedList","unorderedList","checklist","link","internalLink","inlineImage","videoEmbed","codeBlock","table","columns","h1","h2","h3","h4","h5","h6","gallery","embed","tableOfContents","relatedPosts","authorBio","footnotes","button"]}}]},"ui":{"itemLabel":"Result","icon":"award","preview":{"title":"heading","subtitle":"product","fallback":"Untitled result"},"tab":{"id":"results"}}},{"key":"fallback","label":"If nothing scores","type":"reference","helpText":"Recommended when every product scores zero or less.","required":true,"config":{"contentModelId":"col_products"},"ui":{"tab":{"id":"results"}}},{"key":"retakeLabel","label":"Retake label","type":"text","placeholder":"Start over","config":{"maxLength":24},"ui":{"tab":{"id":"results"}}},{"key":"useEmailGate","label":"Ask for an email before results","type":"boolean","helpText":"Results are always shown, even if they skip.","ui":{"tab":{"id":"capture","label":"Email"}}},{"key":"form","label":"Form","type":"form","helpText":"Answers are saved with the email on this form.","required":true,"showIf":{"match":"all","rules":[{"field":"useEmailGate","op":"eq","value":"true"}]},"ui":{"tab":{"id":"capture"}}},{"key":"emailPrompt","label":"Prompt","type":"text","showIf":{"match":"all","rules":[{"field":"useEmailGate","op":"eq","value":"true"}]},"placeholder":"Want your results and a care guide by email?","config":{"maxLength":90},"ui":{"tab":{"id":"capture"}}}],"description":"A few questions that recommend the right product","category":"Conversion & forms","icon":"zoom-question","preview":{"title":"heading","subtitle":"intro","media":"image"}}},
|
|
1445
1445
|
{"id":"conversion-exit-intent-popup","name":"Exit-intent popup","category":"Conversion & forms","kind":"global","tags":["conditional","personalization","form","references","validation","a11y","media-heavy"],"proves":"Trigger rules (exit / delay / scroll / click) with per-trigger inputs · page targeting · frequency capping · offer as code / form / link","why":"A popup isn't a page section — it's a site-wide GLOBAL with rules, so `kind: 'global'`. Three rule clusters, each a select with conditional inputs: the trigger (exit / delay / scroll / click — the click selector is developer-locked), targeting (included and excluded paths as string lists, audience, devices; checkout excluded by default), and frequency capping (per visit / every N days / once). The offer is a conditional trio — email-for-a-code (a Forms reference + the code revealed after sign-up), a bare code, or a button. The decline text is required and its help bans confirmshaming.","htmlSignals":["a hidden role=dialog / aria-modal element with an overlay, revealed by a script on mouseleave/visibilitychange/scroll/timeout","copy like 'Wait!', 'Before you go', 'Get 10% off your first order'","an email input + a code reveal after submit","a decline link ('No thanks') and a close button","scripts from Klaviyo forms, Privy, Justuno, OptinMonster, Sumo"],"mcp":"Create ONE popup global per dialog. Read trigger settings from the script/app config (exitIntent, delay ms → seconds, scroll %) and targeting from its URL rules; frequency from cookie/localStorage expiry (days). Email forms → match the form in Forms and reference it. Confirmshaming decline copy should be imported as-is but flagged with a suggested neutral rewrite.","pitfalls":["Full-screen popups on phones count as intrusive interstitials for Google; the size help says so.","Never show on /checkout — it's in the default excludes.","Focus must move into the dialog and return on close; that's the renderer's job, so there's no field for it."],"notCarried":[],"component":{"name":"Popup","slug":"popup","props":[{"key":"name","label":"Popup name","type":"text","helpText":"Only your team sees this.","required":true,"config":{"maxLength":48},"ui":{"tab":{"id":"content","label":"Content"}}},{"key":"image","label":"Image","type":"image","ui":{"tab":{"id":"content"}}},{"key":"heading","label":"Heading","type":"text","required":true,"ai":true,"recommendedMax":40,"ui":{"tab":{"id":"content"}}},{"key":"body","label":"Body","type":"longtext","ai":true,"recommendedMax":140,"ui":{"rows":2,"tab":{"id":"content"}}},{"key":"offer","label":"Offer","type":"select","defaultValue":"form","config":{"options":[{"label":"Email for a code","value":"form"},{"label":"Show a code","value":"code"},{"label":"A button","value":"link"}]},"ui":{"control":"segmented","tab":{"id":"content"}}},{"key":"form","label":"Form","type":"form","helpText":"They get the code after signing up through this form.","required":true,"showIf":{"match":"all","rules":[{"field":"offer","op":"eq","value":"form"}]},"ui":{"tab":{"id":"content"}}},{"key":"code","label":"Discount code","type":"text","helpText":"Must exist in Shopify. With a form, it's shown after sign-up.","required":true,"showIf":{"match":"all","rules":[{"field":"offer","op":"in","value":["form","code"]}]},"config":{"pattern":"^[A-Z0-9]{3,20}$","patternMessage":"Use capital letters and numbers, like SAVE20."},"ui":{"tab":{"id":"content"}}},{"key":"button","label":"Button","type":"button","showIf":{"match":"all","rules":[{"field":"offer","op":"eq","value":"link"}]},"ui":{"tab":{"id":"content"}}},{"key":"declineLabel","label":"Close link text","type":"text","required":true,"defaultValue":"No thanks","config":{"maxLength":24},"ui":{"tab":{"id":"content"}}},{"key":"trigger","label":"Show when","type":"select","defaultValue":"exit","config":{"options":[{"label":"They're about to leave","value":"exit","icon":"door-exit","description":"Mouse heads for the tab bar; on phones, a fast scroll up"},{"label":"After some time","value":"delay","icon":"clock"},{"label":"After scrolling","value":"scroll","icon":"arrow-down"},{"label":"They click something","value":"click","icon":"click"}]},"ui":{"control":"cards","tab":{"id":"trigger","label":"When"}}},{"key":"delaySeconds","label":"After","type":"number","required":true,"showIf":{"match":"all","rules":[{"field":"trigger","op":"eq","value":"delay"}]},"config":{"min":5,"max":120,"step":5,"unit":"seconds"},"ui":{"tab":{"id":"trigger"}}},{"key":"scrollPercent","label":"After scrolling","type":"number","required":true,"showIf":{"match":"all","rules":[{"field":"trigger","op":"eq","value":"scroll"}]},"config":{"min":10,"max":90,"step":10,"unit":"%"},"ui":{"control":"slider","tab":{"id":"trigger"}}},{"key":"clickSelector","label":"Opens from","type":"text","required":true,"showIf":{"match":"all","rules":[{"field":"trigger","op":"eq","value":"click"}]},"readOnly":"developer","lockReason":"A CSS selector set by the developer","ui":{"access":{"view":"schema.view","edit":"schema.manage"},"tab":{"id":"trigger"}}},{"key":"includedPages","label":"Only on pages","type":"array","helpText":"Paths like /products/*. Leave empty for every page.","config":{"itemType":"text"},"ui":{"itemLabel":"Path","itemName":"path","itemTitle":"Path","tab":{"id":"targeting","label":"Where and who"}}},{"key":"excludedPages","label":"Never on pages","type":"array","helpText":"Paths like /checkout/*.","defaultValue":["/cart","/checkout/*"],"config":{"itemType":"text"},"ui":{"itemLabel":"Path","itemName":"path","itemTitle":"Path","tab":{"id":"targeting"}}},{"key":"audience","label":"Who sees it","type":"select","defaultValue":"not-subscribed","config":{"options":[{"label":"Everyone","value":"everyone"},{"label":"First-time visitors","value":"new"},{"label":"People not on the list yet","value":"not-subscribed"},{"label":"People who haven't ordered","value":"no-orders"}]},"ui":{"tab":{"id":"targeting"}}},{"key":"devices","label":"Devices","type":"multiselect","config":{"min":1,"options":[{"label":"Desktop","value":"desktop"},{"label":"Tablet","value":"tablet"},{"label":"Phone","value":"phone"}]},"ui":{"control":"checkbox","tab":{"id":"targeting"}}},{"key":"frequency","label":"How often","type":"select","defaultValue":"days","config":{"options":[{"label":"Once per visit","value":"session"},{"label":"Once every few days","value":"days"},{"label":"Only once, ever","value":"once"}]},"ui":{"tab":{"id":"targeting"}}},{"key":"everyDays","label":"Every","type":"number","required":true,"showIf":{"match":"all","rules":[{"field":"frequency","op":"eq","value":"days"}]},"config":{"min":1,"max":90,"step":1,"unit":"days"},"ui":{"tab":{"id":"targeting"}}},{"key":"size","label":"Size","type":"select","helpText":"Full screen on phones can hurt search rankings.","defaultValue":"medium","config":{"options":[{"label":"Corner card","value":"small"},{"label":"Centered","value":"medium"},{"label":"Full screen","value":"full"}]},"ui":{"control":"segmented","tab":{"id":"design","label":"Design"}}},{"key":"theme","label":"Theme","type":"select","defaultValue":"light","config":{"options":[{"label":"Light","value":"light"},{"label":"Dark","value":"dark"},{"label":"Brand","value":"brand"}]},"ui":{"control":"segmented","tab":{"id":"design"}}}],"description":"A modal shown by a trigger, to the right people, not too often","category":"Conversion & forms","v2":{"shape":"global"},"icon":"app-window","preview":{"title":"heading","subtitle":"trigger","media":"image"}}},
|
|
1446
|
-
{"id":"conversion-trust-badges","name":"Trust badges & guarantees row","category":"Conversion & forms","kind":"block","tags":["repeater","a11y","variants","conditional","validation","media-heavy"],"proves":"Typed badges (guarantee / shipping / certification…) with logo only when certified · payment icons as a multiselect · a synced review score that can't be typed","why":"Trust rows are claims, so the schema keeps them honest and accessible. Each badge is TYPED: guarantees, shipping, returns and origin use an icon, while certifications require the official logo (with alt text naming it) — the condition swaps icon for logo. Payment methods are a multiselect of known marks (the renderer owns the correct SVGs; nobody uploads a blurry Visa logo). The review score is a toggle that pulls a live number from the connected app — there is no field to type 4.9.","htmlSignals":["a row of 3–6 small icon + short text items near the buy button or above the footer ('Free shipping', '30-day returns', 'Lifetime warranty')","payment brand SVGs (Visa, Mastercard, Amex, Apple Pay, Shop Pay, PayPal) in a list","certification marks (B Corp, 1% for the Planet, Climate Neutral) as images","a star rating with '4.9 from 2,400 reviews' text, often from a reviews widget"],"mcp":"Each icon+text item → badge (kind from keywords: ship → shipping, return/refund → returns, warranty/guarantee → guarantee, 'made in'/'poured in' → origin; known certification marks → certification with the image as logo). Payment SVGs → payments by brand (match file names/titles/aria-labels). A star rating from a reviews widget → showRating:true; never import the number. Text-only certifications without a logo stay 'certification' and are flagged for a logo.","pitfalls":["Typed review numbers go stale and can mislead; only the live score is allowed.","Payment icons for methods not enabled at checkout are a common trust-breaker.","Icon-only badges need text; the title is required."],"notCarried":["variants"],"component":{"name":"Trust row","slug":"trust-row","props":[{"key":"badges","label":"Badges","type":"table","config":{"minItems":2,"maxItems":6,"fields":[{"key":"kind","label":"Type","type":"select","defaultValue":"guarantee","options":[{"label":"Guarantee","value":"guarantee"},{"label":"Shipping","value":"shipping"},{"label":"Returns","value":"returns"},{"label":"Certification","value":"certification","description":"B Corp, 1% for the Planet…"},{"label":"Made in","value":"origin"}]},{"key":"icon","label":"Icon","type":"icon","showIf":{"match":"all","rules":[{"field":"kind","op":"in","value":["guarantee","shipping","returns","origin"]}]}},{"key":"logo","label":"Certification logo","type":"image","required":true,"showIf":{"match":"all","rules":[{"field":"kind","op":"eq","value":"certification"}]}},{"key":"title","label":"Title","type":"text","required":true,"config":{"maxLength":28}},{"key":"detail","label":"Detail","type":"text","helpText":"Shown on the Cards layout and as a tooltip elsewhere.","config":{"maxLength":80}},{"key":"link","label":"Link","type":"link"}]},"ui":{"itemLabel":"Badge","icon":"rosette","preview":{"title":"title","subtitle":"detail","media":"logo","fallback":"Untitled badge"},"tab":{"id":"content","label":"Content"}}},{"key":"payments","label":"Payment icons","type":"multiselect","config":{"options":[{"label":"Visa","value":"visa"},{"label":"Mastercard","value":"mastercard"},{"label":"American Express","value":"amex"},{"label":"Apple Pay","value":"apple-pay"},{"label":"Google Pay","value":"google-pay"},{"label":"Shop Pay","value":"shop-pay"},{"label":"PayPal","value":"paypal"},{"label":"Afterpay","value":"afterpay"}]},"ui":{"control":"checkbox","tab":{"id":"content"}}},{"key":"showRating","label":"Show rating","type":"boolean","ui":{"tab":{"id":"content"}}},{"key":"ratingSource","label":"Reviews from","type":"select","showIf":{"match":"all","rules":[{"field":"showRating","op":"eq","value":"true"}]},"readOnly":"developer","lockReason":"Connected in Settings › Integrations","config":{"options":[{"label":"Okendo","value":"okendo"},{"label":"Judge.me","value":"judgeme"},{"label":"Google reviews","value":"google"}]},"ui":{"access":{"edit":"schema.manage"},"tab":{"id":"content"}}},{"key":"alignment","label":"Alignment","type":"select","defaultValue":"center","config":{"options":[{"label":"Left","value":"left"},{"label":"Center","value":"center"}]},"ui":{"control":"segmented","tab":{"id":"design","label":"Design"}}},{"key":"showDivider","label":"Lines above and below","type":"boolean","ui":{"tab":{"id":"design"}}}],"description":"Guarantees, shipping promises, certifications and how people pay","category":"Conversion & forms","icon":"shield-check","preview":{"title":"badges.0.title","subtitle":"badges.1.title","icon":"shield-check"}}},
|
|
1446
|
+
{"id":"conversion-trust-badges","name":"Trust badges & guarantees row","category":"Conversion & forms","kind":"block","tags":["repeater","a11y","variants","conditional","validation","media-heavy"],"proves":"Typed badges (guarantee / shipping / certification…) with logo only when certified · payment icons as a multiselect · a synced review score that can't be typed","why":"Trust rows are claims, so the schema keeps them honest and accessible. Each badge is TYPED: guarantees, shipping, returns and origin use an icon, while certifications require the official logo (with alt text naming it) — the condition swaps icon for logo. Payment methods are a multiselect of known marks (the renderer owns the correct SVGs; nobody uploads a blurry Visa logo). The review score is a toggle that pulls a live number from the connected app — there is no field to type 4.9.","htmlSignals":["a row of 3–6 small icon + short text items near the buy button or above the footer ('Free shipping', '30-day returns', 'Lifetime warranty')","payment brand SVGs (Visa, Mastercard, Amex, Apple Pay, Shop Pay, PayPal) in a list","certification marks (B Corp, 1% for the Planet, Climate Neutral) as images","a star rating with '4.9 from 2,400 reviews' text, often from a reviews widget"],"mcp":"Each icon+text item → badge (kind from keywords: ship → shipping, return/refund → returns, warranty/guarantee → guarantee, 'made in'/'poured in' → origin; known certification marks → certification with the image as logo). Payment SVGs → payments by brand (match file names/titles/aria-labels). A star rating from a reviews widget → showRating:true; never import the number. Text-only certifications without a logo stay 'certification' and are flagged for a logo.","pitfalls":["Typed review numbers go stale and can mislead; only the live score is allowed.","Payment icons for methods not enabled at checkout are a common trust-breaker.","Icon-only badges need text; the title is required."],"notCarried":["variants"],"component":{"name":"Trust row","slug":"trust-row","props":[{"key":"badges","label":"Badges","type":"table","config":{"minItems":2,"maxItems":6,"fields":[{"key":"kind","label":"Type","type":"select","defaultValue":"guarantee","options":[{"label":"Guarantee","value":"guarantee"},{"label":"Shipping","value":"shipping"},{"label":"Returns","value":"returns"},{"label":"Certification","value":"certification","description":"B Corp, 1% for the Planet…"},{"label":"Made in","value":"origin"}]},{"key":"icon","label":"Icon","type":"icon","showIf":{"match":"all","rules":[{"field":"kind","op":"in","value":["guarantee","shipping","returns","origin"]}]},"config":{"icons":{"sources":["pack","library","upload"],"decorative":"ask"}}},{"key":"logo","label":"Certification logo","type":"image","required":true,"showIf":{"match":"all","rules":[{"field":"kind","op":"eq","value":"certification"}]}},{"key":"title","label":"Title","type":"text","required":true,"config":{"maxLength":28}},{"key":"detail","label":"Detail","type":"text","helpText":"Shown on the Cards layout and as a tooltip elsewhere.","config":{"maxLength":80}},{"key":"link","label":"Link","type":"link"}]},"ui":{"itemLabel":"Badge","icon":"rosette","preview":{"title":"title","subtitle":"detail","media":"logo","fallback":"Untitled badge"},"tab":{"id":"content","label":"Content"}}},{"key":"payments","label":"Payment icons","type":"multiselect","config":{"options":[{"label":"Visa","value":"visa"},{"label":"Mastercard","value":"mastercard"},{"label":"American Express","value":"amex"},{"label":"Apple Pay","value":"apple-pay"},{"label":"Google Pay","value":"google-pay"},{"label":"Shop Pay","value":"shop-pay"},{"label":"PayPal","value":"paypal"},{"label":"Afterpay","value":"afterpay"}]},"ui":{"control":"checkbox","tab":{"id":"content"}}},{"key":"showRating","label":"Show rating","type":"boolean","ui":{"tab":{"id":"content"}}},{"key":"ratingSource","label":"Reviews from","type":"select","showIf":{"match":"all","rules":[{"field":"showRating","op":"eq","value":"true"}]},"readOnly":"developer","lockReason":"Connected in Settings › Integrations","config":{"options":[{"label":"Okendo","value":"okendo"},{"label":"Judge.me","value":"judgeme"},{"label":"Google reviews","value":"google"}]},"ui":{"access":{"edit":"schema.manage"},"tab":{"id":"content"}}},{"key":"alignment","label":"Alignment","type":"select","defaultValue":"center","config":{"options":[{"label":"Left","value":"left"},{"label":"Center","value":"center"}]},"ui":{"control":"segmented","tab":{"id":"design","label":"Design"}}},{"key":"showDivider","label":"Lines above and below","type":"boolean","ui":{"tab":{"id":"design"}}}],"description":"Guarantees, shipping promises, certifications and how people pay","category":"Conversion & forms","icon":"shield-check","preview":{"title":"badges.0.title","subtitle":"badges.1.title","icon":"shield-check"}}},
|
|
1447
1447
|
{"id":"blog-index","name":"Blog index","category":"Listings & feeds","kind":"block","tags":["dynamic-query","references","conditional","variants","validation"],"proves":"A listing stores a query, not copies · featured pick as a conditional reference · pagination modes","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.","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."],"notCarried":["variants"],"component":{"name":"Blog index","slug":"blog-index","props":[{"key":"eyebrow","label":"Eyebrow","type":"text","placeholder":"The Journal","config":{"maxLength":40},"ui":{"tab":{"id":"content","label":"Content","icon":"file-text"}}},{"key":"heading","label":"Heading","type":"text","required":true,"ai":true,"recommendedMax":48,"localized":true,"ui":{"tab":{"id":"content"}}},{"key":"intro","label":"Intro","type":"longtext","ai":true,"recommendedMax":200,"localized":true,"ui":{"rows":2,"tab":{"id":"content"}}},{"key":"featuredMode","label":"Featured story","type":"select","helpText":"Newest featured updates itself when a new featured post goes live.","defaultValue":"latest","config":{"options":[{"label":"Newest featured","value":"latest","description":"The newest post marked Featured"},{"label":"Pick one","value":"pick"},{"label":"None","value":"none"}]},"ui":{"control":"segmented","tab":{"id":"content"},"group":{"id":"featured","label":"Featured story","kind":"group","description":"The large card above the grid."}}},{"key":"featuredPost","label":"Post to feature","type":"reference","required":true,"showIf":{"match":"all","rules":[{"field":"featuredMode","op":"eq","value":"pick"}]},"config":{"contentModelId":"col_journal"},"ui":{"tab":{"id":"content"},"group":{"id":"featured"}}},{"key":"posts","label":"Posts to list","type":"object","helpText":"New posts that match appear on their own.","config":{"fields":[{"key":"collection","label":"Collection","type":"select","helpText":"","defaultValue":"col_journal","readOnly":"developer","lockReason":"The collection is wired to the page template in code.","options":[{"label":"Journal","value":"col_journal"}],"ui":{"access":{"edit":"schema.manage"}}},{"key":"topics","label":"Only these topics","type":"multi-reference","helpText":"Leave empty for every post.","config":{"max":6,"contentModelId":"col_topics"},"ui":{"itemTitle":"Topic"}},{"key":"authors","label":"Only these authors","type":"multi-reference","helpText":"Leave empty for every author.","config":{"max":6,"contentModelId":"col_authors"},"ui":{"itemTitle":"Author"}},{"key":"hideFeatured","label":"Skip the featured post","type":"boolean","defaultValue":true},{"key":"sort","label":"Order","type":"select","helpText":"","defaultValue":"newest","options":[{"label":"Newest first","value":"newest"},{"label":"Oldest first","value":"oldest"},{"label":"Recently updated","value":"updated","description":"Uses the Updated date, then the publish date"},{"label":"A to Z","value":"title"}]},{"key":"pageSize","label":"Posts per page","type":"number","defaultValue":9,"config":{"min":3,"max":24,"step":3},"ui":{"control":"slider"}}]},"ui":{"icon":"database","tab":{"id":"query","label":"Items","icon":"database"}}},{"key":"pagination","label":"More posts","type":"select","helpText":"","defaultValue":"numbered","config":{"options":[{"label":"Numbered pages","value":"numbered","description":"Each page gets its own address, /journal/page/2"},{"label":"Load more button","value":"loadMore"},{"label":"Infinite scroll","value":"infinite"},{"label":"First page only","value":"none"}]},"ui":{"control":"radio","tab":{"id":"query"}}},{"key":"loadMoreLabel","label":"Button label","type":"text","helpText":"","defaultValue":"Load more stories","showIf":{"match":"all","rules":[{"field":"pagination","op":"eq","value":"loadMore"}]},"config":{"maxLength":32},"ui":{"tab":{"id":"query"}}},{"key":"emptyHeading","label":"Empty heading","type":"text","helpText":"Shown when the filters match no posts.","defaultValue":"Nothing here yet","config":{"maxLength":60},"ui":{"tab":{"id":"query"},"group":{"id":"empty","label":"When nothing matches","kind":"group","collapsed":true}}},{"key":"emptyButton","label":"Empty button","type":"button","ui":{"tab":{"id":"query"},"group":{"id":"empty"}}},{"key":"columns","label":"Columns on desktop","type":"number","helpText":"","defaultValue":3,"config":{"min":2,"max":4,"step":1},"ui":{"control":"slider","tab":{"id":"design","label":"Design","icon":"palette"}}},{"key":"imageRatio","label":"Card image","type":"select","defaultValue":"4:3","config":{"options":[{"label":"16:9","value":"16:9"},{"label":"4:3","value":"4:3"},{"label":"Square","value":"1:1"},{"label":"No image","value":"none"}]},"ui":{"control":"segmented","tab":{"id":"design"}}},{"key":"cardShows","label":"Card shows","type":"multiselect","helpText":"","defaultValue":["excerpt","date","topic"],"config":{"options":[{"label":"Excerpt","value":"excerpt"},{"label":"Date","value":"date"},{"label":"Author","value":"author"},{"label":"Reading time","value":"readingTime"},{"label":"First topic","value":"topic"}]},"ui":{"control":"checkbox","tab":{"id":"design"}}},{"key":"anchor","label":"Anchor","type":"text","advanced":true,"config":{"pattern":"^[a-z0-9-]+$","patternMessage":"Use lowercase letters, numbers and hyphens, like our-story."},"ui":{"tab":{"id":"design"}}}],"description":"A featured story, then a paged grid of Journal posts","category":"Listings & feeds","icon":"news","preview":{"title":"heading","subtitle":"intro","icon":"layout-grid"}}},
|
|
1448
1448
|
{"id":"category-filter-bar","name":"Category filter bar","category":"Listings & feeds","kind":"block","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","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.","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."],"notCarried":["variants"],"component":{"name":"Category filter bar","slug":"category-filter","props":[{"key":"source","label":"Chips","type":"select","helpText":"Every topic, new ones included, A to Z.","defaultValue":"all","config":{"options":[{"label":"Every topic","value":"all"},{"label":"Pick topics","value":"pick"}]},"ui":{"control":"segmented","tab":{"id":"content","label":"Content","icon":"file-text"}}},{"key":"topics","label":"Topics","type":"multi-reference","showIf":{"match":"all","rules":[{"field":"source","op":"eq","value":"pick"}]},"config":{"min":2,"max":10,"contentModelId":"col_topics"},"ui":{"tab":{"id":"content"}}},{"key":"allLabel","label":"First chip","type":"text","helpText":"Leave empty to drop the chip.","defaultValue":"All","localized":true,"config":{"maxLength":20},"ui":{"tab":{"id":"content"}}},{"key":"hideEmpty","label":"Hide empty topics","type":"boolean","defaultValue":true,"ui":{"tab":{"id":"content"}}},{"key":"showCounts","label":"Show counts","type":"boolean","ui":{"tab":{"id":"content"}}},{"key":"action","label":"Clicking a chip","type":"select","helpText":"","defaultValue":"filter","config":{"options":[{"label":"Filters the list on this page","value":"filter","description":"No page load; the URL keeps the choice"},{"label":"Opens the topic's page","value":"navigate","description":"/journal/topic/camp"}]},"ui":{"control":"radio","tab":{"id":"content"}}},{"key":"targetList","label":"List to filter","type":"text","helpText":"The anchor of the list section below, e.g. stories.","required":true,"showIf":{"match":"all","rules":[{"field":"action","op":"eq","value":"filter"}]},"config":{"pattern":"^[a-z0-9-]+$","patternMessage":"Use the list section's anchor, like stories."},"ui":{"tab":{"id":"content"}}},{"key":"param","label":"URL parameter","type":"text","helpText":"Keeps the filter in shared links, e.g. ?topic=camp.","defaultValue":"topic","showIf":{"match":"all","rules":[{"field":"action","op":"eq","value":"filter"}]},"advanced":true,"ui":{"access":{"view":"schema.view","edit":"schema.manage"},"tab":{"id":"content"}}},{"key":"ariaLabel","label":"Name for screen readers","type":"text","helpText":"Not shown. Read by screen readers before the chips.","required":true,"defaultValue":"Filter stories by topic","config":{"maxLength":60},"ui":{"tab":{"id":"content"}}},{"key":"mobile","label":"On phones","type":"select","defaultValue":"scroll","config":{"options":[{"label":"Scroll sideways","value":"scroll"},{"label":"Wrap","value":"wrap"},{"label":"Dropdown","value":"dropdown"}]},"ui":{"control":"segmented","tab":{"id":"design","label":"Design","icon":"palette"}}},{"key":"isSticky","label":"Stick under the header","type":"boolean","ui":{"tab":{"id":"design"}}},{"key":"alignment","label":"Alignment","type":"select","helpText":"","defaultValue":"start","config":{"options":[{"label":"Left","value":"start"},{"label":"Center","value":"center"}]},"ui":{"control":"segmented","tab":{"id":"design"}}}],"description":"Topic chips that filter a list or link to topic pages","category":"Listings & feeds","icon":"filter","preview":{"title":"allLabel","subtitle":"targetList","icon":"filter"}}},
|
|
1449
1449
|
{"id":"related-posts","name":"Related posts","category":"Listings & feeds","kind":"block","tags":["conditional","references","dynamic-query","validation","variants"],"proves":"Automatic, hand-picked or mixed (pins first, then auto) · match rules · fallback when nothing matches","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.","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."],"notCarried":["variants"],"component":{"name":"Related posts","slug":"related-posts","props":[{"key":"heading","label":"Heading","type":"text","defaultValue":"Keep reading","localized":true,"config":{"maxLength":48},"ui":{"tab":{"id":"content","label":"Content","icon":"file-text"}}},{"key":"mode","label":"Which posts","type":"select","helpText":"","defaultValue":"auto","config":{"options":[{"label":"Automatic","value":"auto","description":"Shares topics with this post, newest first"},{"label":"Pick them","value":"manual"},{"label":"Pick some, fill the rest","value":"mixed","description":"Your picks first, then automatic"}]},"ui":{"control":"radio","tab":{"id":"content"}}},{"key":"picks","label":"Posts","type":"multi-reference","helpText":"The current post is skipped.","showIf":{"match":"all","rules":[{"field":"mode","op":"in","value":["manual","mixed"]}]},"unique":true,"config":{"min":1,"max":4,"polymorphic":true,"allowedModelSlugs":["col_journal","col_recipes"]},"ui":{"itemName":"post","tab":{"id":"content"}}},{"key":"matchOn","label":"Match on","type":"multiselect","helpText":"More shared values rank higher. Ties go to the newest.","defaultValue":["topics"],"showIf":{"match":"all","rules":[{"field":"mode","op":"in","value":["auto","mixed"]}]},"config":{"options":[{"label":"Topics","value":"topics"},{"label":"Authors","value":"authors"},{"label":"Reviewed product","value":"product"}]},"ui":{"control":"checkbox","tab":{"id":"content"}}},{"key":"showRecipes","label":"Include recipes","type":"boolean","showIf":{"match":"all","rules":[{"field":"mode","op":"in","value":["auto","mixed"]}]},"ui":{"tab":{"id":"content"}}},{"key":"count","label":"How many","type":"number","helpText":"","defaultValue":3,"config":{"min":2,"max":6,"step":1},"ui":{"control":"slider","tab":{"id":"content"}}},{"key":"fallback","label":"When nothing matches","type":"select","helpText":"","defaultValue":"newest","showIf":{"match":"all","rules":[{"field":"mode","op":"in","value":["auto","mixed"]}]},"config":{"options":[{"label":"Show the newest posts","value":"newest"},{"label":"Hide the section","value":"hide"}]},"ui":{"tab":{"id":"content"}}},{"key":"showImages","label":"Show images","type":"boolean","helpText":"","defaultValue":true,"ui":{"tab":{"id":"design","label":"Design","icon":"palette"}}},{"key":"showDivider","label":"Line above","type":"boolean","ui":{"tab":{"id":"design"}}}],"description":"More stories at the end of a post, matched or picked","category":"Listings & feeds","icon":"arrows-shuffle","preview":{"title":"heading","subtitle":"mode","icon":"arrows-shuffle"}}},
|
|
@@ -1503,12 +1503,12 @@
|
|
|
1503
1503
|
{"id":"scrollytelling","name":"Sticky scroll story","category":"Advanced patterns","kind":"block","tags":["media-heavy","repeater","conditional","a11y","variants"],"proves":"Steps synced to scroll with media swaps (image / video / stat) · trigger offset · reduced-motion and phone fallbacks","why":"Scrollytelling pairs each step's text with what the sticky panel shows, so media is a drill-in object ON the step (not a parallel array that can drift out of sync). The media kind is a conditional switch (image / video + poster / big number / keep previous). Motion settings are a separate tab, and both fallbacks — reduced motion and phones — are required choices, because a sticky scroll story is unusable for many people without them.","htmlSignals":["position: sticky media container beside a column of tall text blocks (min-height: 80–100vh each)","Scrollama / GSAP ScrollTrigger / IntersectionObserver code toggling an active step class","Media elements with data-step attributes swapped via opacity","prefers-reduced-motion media queries around the transitions"],"mcp":"Each text step → `scrollStep`; find the media shown while it's active (data-step mapping, or the media element index) and put it in that step's `media` — never in a separate list. Steps that don't change the media → kind 'same'. Read the trigger offset from the library config (ScrollTrigger start: 'top center' → 50). If there's no reduced-motion handling in the source, default reducedMotion: stack and note it. Over 8 steps → split into two stories; each scroll story should make one point.","pitfalls":["SCHEMA GAP: 'keep previous' media depends on the previous array item; the schema can't validate that the first step doesn't use it (position-dependent rules).","SCHEMA GAP: no animation/timeline type — transitions are a select of presets; anything choreographed (scrubbed video, SVG path drawing) stays in code with copy fields only.","Videos in sticky panels must be muted and short; there's no duration validation on the video type.","Preview `media: \"media.image\"` is empty for stat/video steps — preview can't fall back across paths."],"notCarried":["variants"],"component":{"name":"Scroll story","slug":"scroll-story","props":[{"key":"eyebrow","label":"Eyebrow","type":"text","config":{"maxLength":32},"ui":{"tab":{"id":"content","label":"Content"}}},{"key":"heading","label":"Heading","type":"text","required":true,"ai":true,"recommendedMax":60,"ui":{"tab":{"id":"content"}}},{"key":"intro","label":"Intro","type":"longtext","ui":{"rows":2,"tab":{"id":"content"}}},{"key":"steps","label":"Steps","type":"table","config":{"minItems":2,"maxItems":8,"fields":[{"key":"heading","label":"Heading","type":"text","required":true,"config":{"maxLength":60}},{"key":"body","label":"Body","type":"longtext","recommendedMax":240,"ui":{"rows":3}},{"key":"media","label":"Media","type":"object","openMode":"drill","fields":[{"key":"kind","label":"Show","type":"select","defaultValue":"image","options":[{"label":"Image","value":"image"},{"label":"Video","value":"video"},{"label":"Big number","value":"stat"},{"label":"Keep previous","value":"same"}],"ui":{"control":"segmented"}},{"key":"image","label":"Image","type":"image","required":true,"showIf":{"match":"all","rules":[{"field":"kind","op":"eq","value":"image"}]}},{"key":"video","label":"Video","type":"video","required":true,"showIf":{"match":"all","rules":[{"field":"kind","op":"eq","value":"video"}]}},{"key":"poster","label":"Poster","type":"image","showIf":{"match":"all","rules":[{"field":"kind","op":"eq","value":"video"}]}},{"key":"stat","label":"Number","type":"text","required":true,"showIf":{"match":"all","rules":[{"field":"kind","op":"eq","value":"stat"}]},"config":{"maxLength":10}},{"key":"statLabel","label":"Number label","type":"text","showIf":{"match":"all","rules":[{"field":"kind","op":"eq","value":"stat"}]},"config":{"maxLength":40}},{"key":"transition","label":"Change with","type":"select","defaultValue":"fade","options":[{"label":"Fade","value":"fade"},{"label":"Slide","value":"slide"},{"label":"Zoom","value":"zoom"}],"ui":{"control":"segmented"}}],"ui":{"icon":"photo"}}]},"ui":{"itemLabel":"Step","itemName":"scrollStep","icon":"list-numbers","preview":{"title":"heading","subtitle":"body","media":"media.image","fallback":"Untitled step"},"tab":{"id":"content"}}},{"key":"triggerAt","label":"Switch when the step reaches","type":"number","defaultValue":50,"config":{"min":20,"max":80,"step":5,"unit":"% of screen"},"ui":{"control":"slider","tab":{"id":"motion","label":"Motion","icon":"player-track-next"}}},{"key":"progress","label":"Progress","type":"select","defaultValue":"dots","config":{"options":[{"label":"None","value":"none"},{"label":"Dots","value":"dots"},{"label":"Bar","value":"bar"}]},"ui":{"control":"segmented","tab":{"id":"motion"}}},{"key":"reducedMotion","label":"When motion is reduced","type":"select","defaultValue":"stack","config":{"options":[{"label":"Stack each step with its media","value":"stack","description":"No sticky panel, no transitions"},{"label":"Keep sticky, switch without animation","value":"cut"}]},"ui":{"control":"radio","tab":{"id":"motion"}}},{"key":"phone","label":"On phones","type":"select","defaultValue":"stack","config":{"options":[{"label":"Stack steps with their media","value":"stack"},{"label":"Sticky media on top, text scrolls under","value":"sticky"}]},"ui":{"control":"radio","tab":{"id":"motion"}}}],"description":"Text scrolls past while the media beside it stays put and changes","category":"Features & storytelling","icon":"arrows-down","preview":{"title":"heading","subtitle":"intro"}}},
|
|
1504
1504
|
{"id":"a11y-critical-media-form","name":"Accessibility-critical media and form","category":"Advanced patterns","kind":"block","tags":["a11y","media-heavy","form","validation","conditional"],"proves":"Captions per language, transcript, audio-described version · decorative vs informative images · labels, hints and error messages","why":"Accessibility needs are content, so they're fields with rules, not afterthoughts: caption tracks are an array (one per language and kind) with at least one required; the transcript is required rich text; the audio-described cut is its own video. Images declare their ROLE because alt text depends on it — informative needs alt, complex needs alt plus a long description (conditional + required), decorative must have EMPTY alt. Form fields carry a visible label, autocomplete purpose, a hint and a fix-it error message (required only when the field is required).","htmlSignals":["<video> with <track kind=\"captions|subtitles|descriptions\" srclang label>","Transcript sections (details/summary 'Transcript', or a heading 'Transcript' after a video)","<img alt=\"\"> / role=\"presentation\" (decorative) vs descriptive alt; aria-describedby / longdesc links for charts","<label for>, aria-describedby hints, aria-invalid + error text, autocomplete attributes on inputs"],"mcp":"Copy every <track> into `tracks` (kind, srclang → language, label, src → file). Never auto-generate captions during conversion — if none exist, leave tracks empty so validation flags it. A transcript on the page → `transcript`; if absent, flag (it's required). For each image: alt=\"\" or role=presentation → role decorative (keep alt empty); an image of a chart/diagram → complex and pull the long description from aria-describedby/longdesc/adjacent text; otherwise informative with the existing alt (rewrite 'image of…' phrasing). For forms: labels from <label> (if only placeholders exist, convert placeholder → label and flag), autocomplete from attributes, error messages from the validation script or aria-errormessage.","pitfalls":["SCHEMA GAP: alt text lives INSIDE the image value; conditions and validation can't reach a sub-key, so 'alt required unless decorative' and 'alt must be empty when decorative' can't be expressed. The image type needs a built-in `decorative` flag and an alt rule. Proof: the kit validator flags this entry's own decorative image (figures.1) with \"No alt text\" — a false positive the schema can't prevent.","SCHEMA GAP: no file-type constraint on `file` (accept: .vtt) and no way to validate a caption track's language matches the video's.","SCHEMA GAP: 'at least one track of kind captions' is a rule about item VALUES in an array; only item counts can be validated.","SCHEMA GAP: the sign-up form is modelled inline because forms are a separate system; ideally the block only references the form and the form owns labels/errors.","Autoplay over 5 seconds without a pause control fails WCAG 2.2.2; the help warns, nothing blocks it."],"notCarried":[],"component":{"name":"Video explainer","slug":"explainer","props":[{"key":"heading","label":"Heading","type":"text","required":true,"recommendedMax":70,"ui":{"tab":{"id":"video","label":"Video","icon":"player-play"}}},{"key":"video","label":"Video","type":"object","openMode":"drill","config":{"fields":[{"key":"file","label":"Video","type":"video","required":true},{"key":"title","label":"Accessible name","type":"text","helpText":"Not shown. Read by screen readers.","required":true,"config":{"maxLength":100}},{"key":"poster","label":"Poster","type":"image"},{"key":"tracks","label":"Captions and subtitles","type":"table","helpText":".vtt files. At least captions in the video's own language.","fields":[{"key":"kind","label":"Kind","type":"select","defaultValue":"captions","options":[{"label":"Captions","value":"captions","description":"Dialogue plus sounds, for deaf viewers"},{"label":"Subtitles","value":"subtitles","description":"Dialogue translated"},{"label":"Descriptions","value":"descriptions","description":"Text descriptions of what's on screen"}],"ui":{"control":"segmented"}},{"key":"language","label":"Language","type":"select","required":true,"options":[{"label":"English","value":"en"},{"label":"Spanish","value":"es"},{"label":"Portuguese","value":"pt"},{"label":"French","value":"fr"}]},{"key":"label","label":"Menu label","type":"text","required":true,"placeholder":"English (CC)","config":{"maxLength":32}},{"key":"file","label":"WebVTT file","type":"file","required":true},{"key":"isOnByDefault","label":"On by default","type":"boolean"}],"config":{"minItems":1,"maxItems":8},"ui":{"itemLabel":"Track","icon":"badge-cc","preview":{"title":"label","subtitle":"kind","fallback":"Untitled track"}}},{"key":"transcript","label":"Transcript","type":"richtext","required":true,"config":{"features":["bold","italic","underline","strikethrough","code","highlight","blockquote","horizontalRule","orderedList","unorderedList","checklist","link","internalLink","inlineImage","videoEmbed","codeBlock","table","columns","h1","h2","h3","h4","h5","h6","gallery","embed","tableOfContents","relatedPosts","authorBio","footnotes","button"]}},{"key":"described","label":"Audio-described version","type":"video"},{"key":"autoplay","label":"Play automatically","type":"boolean"}]},"ui":{"icon":"player-play","tab":{"id":"video"}}},{"key":"figures","label":"Images","type":"table","config":{"maxItems":6,"fields":[{"key":"image","label":"Image","type":"image","helpText":"Leave alt text empty only if the image is decorative.","required":true},{"key":"role","label":"This image","type":"select","defaultValue":"informative","options":[{"label":"Carries information","value":"informative","description":"Needs alt text"},{"label":"Is a chart or diagram","value":"complex","description":"Needs alt text and a long description"},{"label":"Is decoration only","value":"decorative","description":"Hidden from screen readers"}],"ui":{"control":"radio"}},{"key":"longDescription","label":"Long description","type":"longtext","helpText":"Linked under the image.","required":true,"showIf":{"match":"all","rules":[{"field":"role","op":"eq","value":"complex"}]},"config":{"maxLength":1200},"ui":{"rows":4}},{"key":"caption","label":"Caption","type":"text","config":{"maxLength":160}}]},"ui":{"itemLabel":"Image","icon":"photo","preview":{"title":"caption","subtitle":"role","media":"image","fallback":"Untitled image"},"tab":{"id":"images","label":"Images","icon":"photo"}}},{"key":"signup","label":"Sign-up form","type":"object","openMode":"drill","config":{"fields":[{"key":"heading","label":"Heading","type":"text","required":true,"config":{"maxLength":60}},{"key":"fields","label":"Fields","type":"table","fields":[{"key":"label","label":"Label","type":"text","required":true,"config":{"maxLength":40}},{"key":"name","label":"Field name","type":"text","required":true,"config":{"pattern":"^[a-z][a-zA-Z0-9]*$","patternMessage":"Use a field key, like email or firstName."}},{"key":"type","label":"Type","type":"select","defaultValue":"text","options":[{"label":"Text","value":"text"},{"label":"Email","value":"email"},{"label":"Dropdown","value":"select"},{"label":"Checkbox","value":"checkbox"}]},{"key":"autocomplete","label":"Autofill as","type":"select","helpText":"Lets browsers fill it in. Required for personal details.","options":[{"label":"Nothing","value":"off"},{"label":"Email","value":"email"},{"label":"First name","value":"given-name"},{"label":"Last name","value":"family-name"},{"label":"Postcode","value":"postal-code"}]},{"key":"hint","label":"Hint","type":"text","helpText":"Read out with the label.","config":{"maxLength":90}},{"key":"isRequired","label":"Required","type":"boolean"},{"key":"errorMessage","label":"Error message","type":"text","required":true,"showIf":{"match":"all","rules":[{"field":"isRequired","op":"eq","value":"true"}]},"config":{"maxLength":90}}],"config":{"minItems":1,"maxItems":5},"ui":{"itemLabel":"Field","itemName":"formField","icon":"forms","preview":{"title":"label","subtitle":"type","fallback":"Untitled field"}}},{"key":"submitButton","label":"Submit button","type":"button"},{"key":"privacy","label":"Privacy note","type":"text","config":{"maxLength":140}},{"key":"form","label":"Send to form","type":"reference","required":true,"config":{"targets":["form"]}}]},"ui":{"icon":"forms","tab":{"id":"form","label":"Sign-up","icon":"forms"}}}],"description":"A video with captions and a transcript, supporting images, and a sign-up form","category":"Media & galleries","icon":"player-play","preview":{"title":"heading","media":"video.poster"}}},
|
|
1505
1505
|
{"id":"section-theme-tokens","name":"Section theme tokens","category":"Advanced patterns","kind":"block","tags":["variants","conditional","a11y","validation","media-heavy"],"proves":"Dark section inside a light page · surface + accent override from brand tokens · spacing tokens · all in the Design group","why":"Everything about how the section LOOKS sits in the Design tab and is expressed as tokens (scheme, surface, accent, spacing, width) — never raw hex or pixels — so the brand kit stays the single source and dark sections flip every color consistently. Conditionals keep the tab calm: the photo and overlay appear only for the Photo surface, the accent choice only when overriding. Content (quote, name, photo, button) is untouched by any design choice, so switching variant or scheme never loses copy.","htmlSignals":["A section with its own data-theme=\"dark\" / .dark / .theme-inverse class inside a light page","Background image with a semi-transparent overlay layer (::before with rgba/opacity)","CSS custom properties redefined on the section (--accent, --surface) or utility classes like bg-neutral-900 text-white","Section-specific padding utilities (py-24) differing from neighbours"],"mcp":"Map computed styles to the nearest TOKEN, never copy values: background luminance < 0.2 → scheme dark (+ surface inverse unless it's a photo); a background-image with an overlay → surface image + overlay % from the overlay's alpha; accent = the button color matched to the brand kit's accents (if no match within ΔE 5, keep the default and flag); padding → nearest spacing token; max-width → width token. If the source uses a color the brand kit doesn't have, propose adding it to the brand kit rather than storing a hex in the block.","pitfalls":["SCHEMA GAP: no token-reference type — `accent` is a hard-coded select that must be kept in sync with the brand kit by hand; it should be a dynamic option list from the brand kit (and `color` fields should be restrictable to tokens).","SCHEMA GAP: no contrast validation between surface/overlay and text color (WCAG 1.4.3); 'overlay below 35% on a bright photo' can't be flagged.","SCHEMA GAP: no responsive values for spacing (see responsive-layout-settings).","SCHEMA GAP: design fields are repeated per block; a shared, named object type (sectionTheme) can't be referenced by name, only copied."],"notCarried":["variants"],"component":{"name":"Quote band","slug":"quote-band","props":[{"key":"quote","label":"Quote","type":"longtext","required":true,"recommendedMax":200,"ui":{"rows":3,"tab":{"id":"content","label":"Content"}}},{"key":"author","label":"Name","type":"text","required":true,"config":{"maxLength":48},"ui":{"tab":{"id":"content"}}},{"key":"role","label":"Role","type":"text","config":{"maxLength":60},"ui":{"tab":{"id":"content"}}},{"key":"photo","label":"Photo","type":"image","ui":{"tab":{"id":"content"}}},{"key":"button","label":"Button","type":"button","ui":{"tab":{"id":"content"}}},{"key":"scheme","label":"Color scheme","type":"select","defaultValue":"inherit","config":{"options":[{"label":"Page","value":"inherit"},{"label":"Light","value":"light"},{"label":"Dark","value":"dark"}]},"ui":{"control":"segmented","tab":{"id":"design","label":"Design","icon":"palette"}}},{"key":"surface","label":"Background","type":"select","defaultValue":"default","config":{"options":[{"label":"Default","value":"default","description":"Page background"},{"label":"Raised","value":"raised","description":"One step lighter"},{"label":"Inverse","value":"inverse","description":"Charcoal in light mode"},{"label":"Brand","value":"brand","description":"Ember orange"},{"label":"Photo","value":"image","description":"With an overlay"}]},"ui":{"control":"cards","tab":{"id":"design"}}},{"key":"background","label":"Background photo","type":"image","required":true,"showIf":{"match":"all","rules":[{"field":"surface","op":"eq","value":"image"}]},"ui":{"tab":{"id":"design"}}},{"key":"overlay","label":"Overlay","type":"number","defaultValue":45,"showIf":{"match":"all","rules":[{"field":"surface","op":"eq","value":"image"}]},"config":{"min":0,"max":90,"step":5,"unit":"%"},"ui":{"control":"slider","tab":{"id":"design"}}},{"key":"useCustomAccent","label":"Use a different accent color","type":"boolean","ui":{"tab":{"id":"design"}}},{"key":"accent","label":"Accent","type":"select","defaultValue":"ember","showIf":{"match":"all","rules":[{"field":"useCustomAccent","op":"eq","value":"true"}]},"config":{"options":[{"label":"Ember","value":"ember"},{"label":"Moss","value":"moss"},{"label":"Sand","value":"sand"}]},"ui":{"control":"segmented","tab":{"id":"design"}}},{"key":"spacing","label":"Spacing","type":"object","config":{"fields":[{"key":"top","label":"Top","type":"select","defaultValue":"lg","options":[{"label":"None","value":"none"},{"label":"M","value":"md"},{"label":"L","value":"lg"},{"label":"XL","value":"xl"}],"ui":{"control":"segmented"}},{"key":"bottom","label":"Bottom","type":"select","defaultValue":"lg","options":[{"label":"None","value":"none"},{"label":"M","value":"md"},{"label":"L","value":"lg"},{"label":"XL","value":"xl"}],"ui":{"control":"segmented"}}]},"ui":{"icon":"spacing-vertical","tab":{"id":"design"}}},{"key":"width","label":"Content width","type":"select","defaultValue":"narrow","config":{"options":[{"label":"Narrow","value":"narrow"},{"label":"Default","value":"default"},{"label":"Wide","value":"wide"}]},"ui":{"control":"segmented","tab":{"id":"design"}}},{"key":"isFullBleed","label":"Edge to edge","type":"boolean","defaultValue":true,"ui":{"tab":{"id":"design"}}}],"description":"A full-width quote with its own color scheme","category":"Social proof","icon":"quote","preview":{"title":"author","subtitle":"quote","media":"photo"}}},
|
|
1506
|
-
{"id":"core-faq","name":"FAQ","category":"Core examples","kind":"block","tags":["repeater","conditional","validation","dynamic-query"],"proves":"Small items still drill in · conditional source · developer lock · presence in a row","why":"Questions are same-shaped rows, so `items` is one list whose row holds a plain-string question and a rich-text answer (bold, links and lists live in answers). `source` switches between questions written here and references into a FAQs collection; each list shows only for its own choice, so the two never disagree. Search, rich results, columns and the anchor are Settings, not copy, and the anchor is locked to people who manage the schema.","htmlSignals":["Repeated <details> with a <summary> holding the question (often an <h3> plus a chevron <svg>) and a body <div> holding the answer","The first <details> carries `open`","A hand-written <script type=\"application/ld+json\"> with \"@type\":\"FAQPage\" beside the band","A closing line with a support link under the list (\"Still stuck? Talk to support\")"],"mcp":"create_component with sectionType 'FAQ'; each prop needs a `target` into your own blockJson (a root `section` with `style`). eyebrow/heading/intro → text props on heading/text blocks. items → ONE `table` prop: config.fields question (text, required) + answer (richtext, required), plus category (select) and open (boolean); ui { preview: { title: 'question' }, itemLabel: 'Question', icon: 'help-circle' }. source → a select with ui.control 'segmented'; give items and collection a `showIf` on source ('inline' / 'collection'), placed after source. collection → multi-reference with config.contentModelId of the FAQs model. showSearch/richResults/columns/anchor → ui.tab 'Settings'. Accordion and Two columns are two components sharing sectionType 'FAQ' with the same prop keys.","pitfalls":["richResults does nothing by itself: FAQPage markup comes from update_page schemaType 'FAQPage', and the builder finds the first list whose rows have keys containing `question` and `answer`. Delete the hand-written JSON-LD.","`open` on the first item is behaviour in the worked example and stays in the template; keep the per-item boolean only if the template reads it.","Bind the question on the <h3>, not the <summary>, or a save erases the chevron."],"notCarried":["variants"],"component":{"name":"FAQ","slug":"faq","props":[{"key":"eyebrow","label":"Eyebrow","type":"text","placeholder":"Support","config":{"maxLength":40},"ui":{"tab":{"id":"content","label":"Content"}}},{"key":"heading","label":"Heading","type":"text","required":true,"ai":true,"recommendedMax":48,"localized":true,"ui":{"tab":{"id":"content"}}},{"key":"intro","label":"Intro","type":"longtext","ai":true,"ui":{"rows":2,"tab":{"id":"content"}}},{"key":"source","label":"Questions come from","type":"select","defaultValue":"inline","config":{"options":[{"label":"Written here","value":"inline"},{"label":"FAQs collection","value":"collection"}]},"ui":{"control":"segmented","tab":{"id":"content"}}},{"key":"items","label":"Questions","type":"table","showIf":{"match":"all","rules":[{"field":"source","op":"eq","value":"inline"}]},"config":{"minItems":1,"maxItems":12,"fields":[{"key":"question","label":"Question","type":"text","required":true,"ai":true,"config":{"maxLength":120}},{"key":"answer","label":"Answer","type":"richtext","required":true,"ai":true,"config":{"features":["bold","italic","underline","strikethrough","code","highlight","blockquote","horizontalRule","orderedList","unorderedList","checklist","link","internalLink","inlineImage","videoEmbed","codeBlock","table","columns","h1","h2","h3","h4","h5","h6","gallery","embed","tableOfContents","relatedPosts","authorBio","footnotes","button"]}},{"key":"category","label":"Category","type":"select","options":[{"label":"Orders","value":"orders"},{"label":"Shipping","value":"shipping"},{"label":"Care","value":"care"},{"label":"Warranty","value":"warranty"}]},{"key":"open","label":"Open by default","type":"boolean"}]},"ui":{"itemLabel":"Question","itemName":"faqItem","icon":"help-circle","preview":{"title":"question","subtitle":"answer","fallback":"Untitled question"},"tab":{"id":"content"}}},{"key":"collection","label":"FAQs to show","type":"multi-reference","showIf":{"match":"all","rules":[{"field":"source","op":"eq","value":"collection"}]},"config":{"max":8,"contentModelId":"col_faq"},"ui":{"itemName":"faqRef","itemTitle":"FAQ","tab":{"id":"content"}}},{"key":"showSearch","label":"Show search","type":"boolean","ui":{"tab":{"id":"settings","label":"Settings"}}},{"key":"richResults","label":"FAQ rich results","type":"boolean","defaultValue":true,"ui":{"tab":{"id":"settings"}}},{"key":"columns","label":"Columns on desktop","type":"number","config":{"scale":{"steps":{"min":1,"max":3,"step":1}}},"ui":{"tab":{"id":"settings"}}},{"key":"anchor","label":"Anchor","type":"text","helpText":"For #links to this block.","advanced":true,"ui":{"access":{"edit":"schema.manage"},"tab":{"id":"settings"}}}],"description":"Questions and answers, written here or from the FAQs collection","category":"content","icon":"help-circle","preview":{"title":"heading"}}},
|
|
1506
|
+
{"id":"core-faq","name":"FAQ","category":"Core examples","kind":"block","tags":["repeater","conditional","validation","dynamic-query"],"proves":"Small items still drill in · conditional source · developer lock · presence in a row","why":"Questions are same-shaped rows, so `items` is one list whose row holds a plain-string question and a rich-text answer (bold, links and lists live in answers). `source` switches between questions written here and references into a FAQs collection; each list shows only for its own choice, so the two never disagree. Search, rich results, columns and the anchor are Settings, not copy, and the anchor is locked to people who manage the schema.","htmlSignals":["Repeated <details> with a <summary> holding the question (often an <h3> plus a chevron <svg>) and a body <div> holding the answer","The first <details> carries `open`","A hand-written <script type=\"application/ld+json\"> with \"@type\":\"FAQPage\" beside the band","A closing line with a support link under the list (\"Still stuck? Talk to support\")"],"mcp":"create_component with sectionType 'FAQ'; each prop needs a `target` into your own blockJson (a root `section` with `style`). eyebrow/heading/intro → text props on heading/text blocks. items → ONE `table` prop: config.fields question (text, required) + answer (richtext, required), plus category (select) and open (boolean); ui { preview: { title: 'question' }, itemLabel: 'Question', icon: 'help-circle' }. source → a select with ui.control 'segmented'; give items and collection a `showIf` on source ('inline' / 'collection'), placed after source. collection → multi-reference with config.contentModelId of the FAQs model. showSearch/richResults/columns/anchor → ui.tab 'Settings'. Accordion and Two columns are two components sharing sectionType 'FAQ' with the same prop keys.","pitfalls":["richResults does nothing by itself: FAQPage markup comes from update_page schemaType 'FAQPage', and the builder finds the first list whose rows have keys containing `question` and `answer`. Delete the hand-written JSON-LD.","`open` on the first item is behaviour in the worked example and stays in the template; keep the per-item boolean only if the template reads it.","Bind the question on the <h3>, not the <summary>, or a save erases the chevron."],"notCarried":["variants"],"component":{"name":"FAQ","slug":"faq","props":[{"key":"eyebrow","label":"Eyebrow","type":"text","placeholder":"Support","config":{"maxLength":40},"ui":{"tab":{"id":"content","label":"Content"}}},{"key":"heading","label":"Heading","type":"text","required":true,"ai":true,"recommendedMax":48,"localized":true,"ui":{"tab":{"id":"content"}}},{"key":"intro","label":"Intro","type":"longtext","ai":true,"ui":{"rows":2,"tab":{"id":"content"}}},{"key":"source","label":"Questions come from","type":"select","defaultValue":"inline","config":{"options":[{"label":"Written here","value":"inline"},{"label":"FAQs collection","value":"collection"}]},"ui":{"control":"segmented","tab":{"id":"content"}}},{"key":"items","label":"Questions","type":"table","showIf":{"match":"all","rules":[{"field":"source","op":"eq","value":"inline"}]},"config":{"minItems":1,"maxItems":12,"fields":[{"key":"question","label":"Question","type":"text","required":true,"ai":true,"config":{"maxLength":120}},{"key":"answer","label":"Answer","type":"richtext","required":true,"ai":true,"config":{"features":["bold","italic","underline","strikethrough","code","highlight","blockquote","horizontalRule","orderedList","unorderedList","checklist","link","internalLink","inlineImage","videoEmbed","codeBlock","table","columns","h1","h2","h3","h4","h5","h6","gallery","embed","tableOfContents","relatedPosts","authorBio","footnotes","button"]}},{"key":"category","label":"Category","type":"select","options":[{"label":"Orders","value":"orders"},{"label":"Shipping","value":"shipping"},{"label":"Care","value":"care"},{"label":"Warranty","value":"warranty"}]},{"key":"open","label":"Open by default","type":"boolean"}]},"ui":{"itemLabel":"Question","itemName":"faqItem","icon":"help-circle","preview":{"title":"question","subtitle":"answer","fallback":"Untitled question"},"tab":{"id":"content"}}},{"key":"collection","label":"FAQs to show","type":"multi-reference","showIf":{"match":"all","rules":[{"field":"source","op":"eq","value":"collection"}]},"config":{"max":8,"contentModelId":"col_faq"},"ui":{"itemName":"faqRef","itemTitle":"FAQ","tab":{"id":"content"}}},{"key":"showSearch","label":"Show search","type":"boolean","ui":{"tab":{"id":"settings","label":"Settings"}}},{"key":"richResults","label":"FAQ rich results","type":"boolean","defaultValue":true,"ui":{"tab":{"id":"settings"}}},{"key":"columns","label":"Columns on desktop","type":"number","config":{"scale":{"steps":{"min":1,"max":3,"step":1}}},"ui":{"tab":{"id":"settings"}}},{"key":"anchor","label":"Anchor","type":"text","helpText":"For #links to this block.","advanced":true,"readOnly":"developer","lockReason":"Set by the developer. Links to this block use it.","ui":{"access":{"edit":"schema.manage"},"tab":{"id":"settings"}}}],"description":"Questions and answers, written here or from the FAQs collection","category":"content","icon":"help-circle","preview":{"title":"heading"}}},
|
|
1507
1507
|
{"id":"core-megaMenu","name":"Mega menu","category":"Core examples","kind":"global","tags":["deep-nesting","repeater","global-synced","validation"],"proves":"Five levels deep · breadcrumb truncation · global block (synced) · link + button units","why":"The navigation is a GLOBAL block: one copy synced across every page, edited once. Its menu is five levels deep (Navigation › menu item › column › link › badge) to prove drill-in and breadcrumb truncation. A menu item `kind` decides whether it is a plain link or opens a mega panel of columns plus a featured card, so a link row never carries panel data. Sticky, transparent and the mobile style sit in a Behaviour tab; the logo and its screen-reader text share a Brand fieldset.","htmlSignals":["A <header> on every page holding <nav aria-label=\"Main\"> with a logo <a><img></a> and a <ul> of menu items","A <button aria-expanded aria-controls> that opens a hidden panel, beside plain <a> items that just link","Panel columns: a title <p> over a <ul> of links, each link a label <span>, an optional description <span> and an optional badge (\"New\")","Sign-in link and a primary button at the end of the bar"],"mcp":"Site chrome is the Layout, never a page section: get_layout, then update_layout scope 'global' with `add-field` commands on the reserved `navigation` Section (ifMatch from get_layout), set-field-value for the rows, publish_layout. Read the Section's existing logo, link and button fields first and add only what is missing. If the header is a component placed with `add-component`, each prop needs a `target` into your own blockJson: items → a `table` prop (ui { itemLabel: 'Menu item', preview: { title: 'label' } }) whose rows hold label, link (a `link` value), kind (select) and ONE nested `table` of links with `column` as a text sub-field; cta → a `button` prop on a button block's `props`. logo/logoText → ui.group 'brand'; sticky/transparent/mobile → ui.tab 'Behaviour'.","pitfalls":["Two list levels is the cap for a component's props and the depth chrome is proven to bind at: store menu → links and put the column title on each link row. The kit's third level (columns) and the badge object do not fit; flatten the badge to a scalar on the link row.","A nav placed on a page as a section renders nowhere, and a page that draws its own header gets no Layout copy on top: remove page-level copies.","The worked example keeps `sticky`, colours and height in code; expose the Behaviour props only if the template reads them."],"notCarried":["category","variants"],"component":{"name":"Navigation","slug":"navigation","props":[{"key":"logo","label":"Logo","type":"image","ui":{"tab":{"id":"content","label":"Content"},"group":{"id":"brand","label":"Brand","kind":"group","columns":1}}},{"key":"logoText","label":"Logo text","type":"text","helpText":"Read by screen readers. Shown if the logo can't load.","ui":{"tab":{"id":"content"},"group":{"id":"brand"}}},{"key":"items","label":"Menu items","type":"table","config":{"minItems":1,"maxItems":7,"fields":[{"key":"label","label":"Label","type":"text","required":true,"config":{"maxLength":20}},{"key":"kind","label":"Opens","type":"select","defaultValue":"link","options":[{"label":"A page","value":"link"},{"label":"Mega menu","value":"mega"}],"ui":{"control":"segmented"}},{"key":"link","label":"Links to","type":"link","showIf":{"match":"all","rules":[{"field":"kind","op":"eq","value":"link"}]}},{"key":"columns","label":"Columns","type":"table","showIf":{"match":"all","rules":[{"field":"kind","op":"eq","value":"mega"}]},"fields":[{"key":"title","label":"Column title","type":"text","required":true,"config":{"maxLength":24}},{"key":"links","label":"Links","type":"table","fields":[{"key":"label","label":"Label","type":"text","required":true,"config":{"maxLength":32}},{"key":"link","label":"Links to","type":"link","required":true},{"key":"description","label":"Description","type":"text","recommendedMax":60},{"key":"icon","label":"Icon","type":"icon"},{"key":"badge","label":"Badge","type":"object","openMode":"drill","fields":[{"key":"label","label":"Label","type":"text","placeholder":"New","config":{"maxLength":14}},{"key":"color","label":"Colour","type":"color"},{"key":"startsAt","label":"Show from","type":"datetime"},{"key":"endsAt","label":"Hide after","type":"datetime"}],"ui":{"icon":"badge"}}],"config":{"maxItems":8},"ui":{"itemLabel":"Link","itemName":"subLink","icon":"link","preview":{"title":"label","subtitle":"description","fallback":"Untitled link"}}}],"config":{"maxItems":4},"ui":{"itemLabel":"Column","icon":"columns-3","preview":{"title":"title","fallback":"Untitled column"}}},{"key":"featured","label":"Featured card","type":"object","showIf":{"match":"all","rules":[{"field":"kind","op":"eq","value":"mega"}]},"openMode":"drill","fields":[{"key":"image","label":"Image","type":"image","required":true},{"key":"eyebrow","label":"Eyebrow","type":"text","config":{"maxLength":24}},{"key":"title","label":"Title","type":"text","required":true,"ai":true,"recommendedMax":40},{"key":"body","label":"Body","type":"longtext","recommendedMax":110,"ui":{"rows":2}},{"key":"cta","label":"Button","type":"button"}],"ui":{"icon":"layout-cards"}}]},"ui":{"itemLabel":"Menu item","itemName":"menuItem","icon":"menu","preview":{"title":"label","subtitle":"kind","fallback":"Untitled item"},"tab":{"id":"content"}}},{"key":"cta","label":"Main button","type":"button","ui":{"tab":{"id":"content"}}},{"key":"sticky","label":"Stick to the top","type":"boolean","ui":{"tab":{"id":"behaviour","label":"Behaviour"}}},{"key":"transparent","label":"Transparent over heroes","type":"boolean","ui":{"tab":{"id":"behaviour"}}},{"key":"mobile","label":"Mobile menu","type":"select","config":{"options":[{"label":"Drawer","value":"drawer","description":"Slides in from the right"},{"label":"Full screen","value":"fullscreen","description":"Covers the page, big type"}]},"ui":{"control":"radio","tab":{"id":"behaviour"}}}],"description":"Logo, menu, mega panels and the main button. Synced across every page.","category":"navbar","v2":{"shape":"global"},"icon":"layout-navbar"}},
|
|
1508
1508
|
{"id":"core-tabs","name":"Tabs","category":"Core examples","kind":"block","tags":["slots","polymorphic-array","repeater","variants"],"proves":"Array of tabs, each a slot of blocks · block picker · drilling into a nested block","why":"Tabs are a list (2–6), and each tab is a label, an optional icon and a SLOT of blocks, so a panel can hold text, images, features, stats, quotes, CTA cards, product cards or video in any order. The allow list keeps panels to small content blocks. Which tab opens first and whether the URL remembers it are settings; underline, pills and side tabs are layout variants.","htmlSignals":["A role=\"tablist\" of <button role=\"tab\" aria-controls aria-selected>, often each with an icon <i>","One role=\"tabpanel\" per tab, all but the first `hidden`","Panels that hold their own rows of cards, images and stats rather than one paragraph"],"mcp":"A band one page owns can stay a `section` block holding a `tabs` block {tabs:[{id,label,children}]} (worked example 8). As a component: create_component with a sectionType naming the family (e.g. 'Tabs'); each prop needs a `target` into your own blockJson. tabs → ONE `table` prop (ui { itemLabel: 'Tab', preview: { title: 'label' }, icon: 'layout-list' }) with config.fields label (text, required), icon (`icon`) and content: a `slot` sub-field with config.multiple, maxItems 6 and config.componentIds; point the table at your tabs block the way §14's slider table targets props.slides. heading → text prop; defaultTab → number with config.min 1, max 6. Underline, Pills and Side tabs are three components sharing sectionType 'Tabs' with the same prop keys.","pitfalls":["The kit's slot allow list names kit blocks, not components: config.componentIds must list published components of this project.","Slot children are `{ componentId, overrides? }` with no `_variant`: a variant is its own component.","Give every block, tab and instance a stable `id`; changing one orphans the edits made against it."],"notCarried":["category","variants"],"component":{"name":"Tabs","slug":"tabs","props":[{"key":"heading","label":"Heading","type":"text","ai":true,"recommendedMax":56},{"key":"tabs","label":"Tabs","type":"table","config":{"minItems":2,"maxItems":6,"fields":[{"key":"label","label":"Tab label","type":"text","required":true,"config":{"maxLength":24}},{"key":"icon","label":"Icon","type":"icon"},{"key":"content","label":"Content","type":"slot","config":{"multiple":true,"maxItems":6,"allow":["textBlock","imageBlock","featureBlock","statBlock","quoteBlock","ctaCard","productCard","videoBlock"]}}]},"ui":{"itemLabel":"Tab","icon":"layout-list","preview":{"title":"label","fallback":"Untitled tab"}}},{"key":"defaultTab","label":"Open first","type":"number","config":{"min":1,"max":6,"step":1}},{"key":"syncUrl","label":"Remember tab in the URL","type":"boolean","advanced":true}],"description":"Tabbed panels, each holding its own blocks","category":"section","icon":"layout-list","preview":{"title":"heading"}}},
|
|
1509
1509
|
{"id":"core-pricing","name":"Pricing","category":"Core examples","kind":"block","tags":["repeater","conditional","commerce","variants","validation"],"proves":"Tiers → features · conditional Contact sales when price is custom · inline small items","why":"Tiers are same-shaped rows (1–4). A tier's priceType decides what shows: a fixed tier shows the amount and billing interval, a custom tier swaps in a Contact sales button, so a tier never shows a price and 'Contact sales' at once. Features are tiny rows (label, included, tooltip) that open inline. The comparison table, currency, the monthly/yearly switch and its discount are Display settings; Three tiers, Two tiers and Comparison table are variants.","htmlSignals":["A grid of plan <article>s, each with an <h3> name, a short audience line, a price, a <ul class=\"checks\"> and one CTA <a>","One card flagged with a ribbon or modifier class (\"Most popular\")","A price <span> with data-monthly / data-yearly next to a role=\"radiogroup\" billing toggle (\"Save 20%\")","A price in words (\"Let's talk\") linking to contact sales instead of an amount","A <table class=\"compare\"> with one column per plan and check / cross icons labelled by aria-label"],"mcp":"create_component with sectionType 'Pricing' and category 'conversion'; it lands as a draft, then publish_component. Each prop needs a `target` into your own blockJson: tiers → ONE `table` prop targeting props.rows of a `section` block whose children mirror one row, ui { itemLabel: 'Tier', preview: { title: 'name' }, icon: 'tiers' }; its config.fields hold name, tagline, priceType (select, ui.control 'segmented'), price (number) and interval with `showIf` priceType eq 'fixed', contactSales and cta as `button` sub-fields, featured (boolean) and features as a nested `table` of scalars. comparison → a second `table` prop, one row per feature and one key per tier. currency/toggle/discount → ui.tab 'Display'. Variants are sibling components sharing sectionType 'Pricing' and the same prop keys.","pitfalls":["Store numbers, never '$24/mo'. A price in words is its own text key, shown when the numbers are empty.","The nested features table is the deepest a prop goes: its rows take scalars only.","A tier added to the comparison is a new sub-field, a schema change. No Offer JSON-LD is built from prices; paste it as `schema` on update_page when needed."],"notCarried":["variants"],"component":{"name":"Pricing","slug":"pricing","props":[{"key":"heading","label":"Heading","type":"text","required":true,"ai":true,"recommendedMax":48,"ui":{"tab":{"id":"content","label":"Content"}}},{"key":"intro","label":"Intro","type":"longtext","ui":{"rows":2,"tab":{"id":"content"}}},{"key":"tiers","label":"Tiers","type":"table","config":{"minItems":1,"maxItems":4,"fields":[{"key":"name","label":"Name","type":"text","required":true,"config":{"maxLength":24}},{"key":"tagline","label":"Tagline","type":"text","recommendedMax":60},{"key":"priceType","label":"Price","type":"select","defaultValue":"fixed","options":[{"label":"Fixed","value":"fixed"},{"label":"Free","value":"free"},{"label":"Custom","value":"custom"}],"ui":{"control":"segmented"}},{"key":"price","label":"Amount","type":"number","required":true,"showIf":{"match":"all","rules":[{"field":"priceType","op":"eq","value":"fixed"}]},"config":{"unit":"USD","min":0,"step":1},"ui":{"group":{"id":"amount","label":"Amount","kind":"group","columns":2}}},{"key":"interval","label":"Billed","type":"select","showIf":{"match":"all","rules":[{"field":"priceType","op":"eq","value":"fixed"}]},"options":[{"label":"Once","value":"once"},{"label":"Per month","value":"month"},{"label":"Per year","value":"year"}],"ui":{"group":{"id":"amount"}}},{"key":"contactSales","label":"Contact sales button","type":"button","showIf":{"match":"all","rules":[{"field":"priceType","op":"eq","value":"custom"}]}},{"key":"cta","label":"Button","type":"button","showIf":{"match":"all","rules":[{"field":"priceType","op":"in","value":["fixed","free"]}]}},{"key":"features","label":"Features","type":"table","openMode":"inline","fields":[{"key":"label","label":"Feature","type":"text","required":true,"config":{"maxLength":48}},{"key":"included","label":"Included","type":"boolean","defaultValue":true},{"key":"note","label":"Tooltip","type":"text","config":{"maxLength":80}}],"config":{"maxItems":10},"ui":{"itemLabel":"Feature","icon":"circle-check","preview":{"title":"label","subtitle":"note","fallback":"Untitled feature"}}},{"key":"featured","label":"Most popular","type":"boolean"}]},"ui":{"itemLabel":"Tier","icon":"badge","preview":{"title":"name","subtitle":"tagline","fallback":"Untitled tier"},"tab":{"id":"content"}}},{"key":"comparison","label":"Comparison table","type":"object","openMode":"dialog","config":{"fields":[{"key":"title","label":"Table title","type":"text","config":{"maxLength":48}},{"key":"rows","label":"Rows","type":"table","fields":[{"key":"feature","label":"Feature","type":"text","required":true,"config":{"maxLength":48}},{"key":"note","label":"Footnote","type":"text"},{"key":"starter","label":"In Starter","type":"boolean"},{"key":"stockist","label":"In Stockist","type":"boolean"},{"key":"flagship","label":"In Flagship","type":"boolean"}],"config":{"maxItems":20},"ui":{"itemLabel":"Row","icon":"table","preview":{"title":"feature","subtitle":"note","fallback":"Untitled row"}}}]},"ui":{"icon":"table","tab":{"id":"display","label":"Display"}}},{"key":"currency","label":"Currency","type":"select","config":{"options":[{"label":"US dollar","value":"USD"},{"label":"Euro","value":"EUR"},{"label":"Pound sterling","value":"GBP"}]},"ui":{"tab":{"id":"display"}}},{"key":"toggle","label":"Monthly / yearly switch","type":"boolean","ui":{"tab":{"id":"display"}}},{"key":"discount","label":"Yearly discount","type":"number","helpText":"Steps of 5%. Type a value like 17% for anything in between.","showIf":{"match":"all","rules":[{"field":"toggle","op":"eq","value":"true"}]},"config":{"scale":{"steps":{"min":0,"max":40,"step":5},"units":["%"],"allowCustom":{"min":0,"max":90,"units":["%"]}}},"ui":{"tab":{"id":"display"}}}],"description":"Plans or bundles side by side","category":"Commerce","icon":"currency-dollar","preview":{"title":"heading"}}},
|
|
1510
1510
|
{"id":"core-bento","name":"Bento grid","category":"Core examples","kind":"block","tags":["slots","polymorphic-array","variants","responsive-layout","media-heavy"],"proves":"Slot with per-cell layout settings (size, surface) · variants","why":"A bento is a SLOT of 3–9 cells, and each cell is any allowed block (image, stat, quote, text, CTA card, product card, video). Size (1×1, 2×1, 1×2, 2×2) and surface (light, dark, brand) belong to the cell's place in this grid, not to the block, so they are per-slot settings rather than fields on every block. The gap is a design select; four and three columns are variants.","htmlSignals":["A grid section whose cells span different column/row counts (wide, tall and large tiles beside small ones)","Cells of mixed kinds in one grid: a photo, a big number with a label, a quote, a product card, a CTA card, a video","Some cells on a dark or brand-coloured surface while their neighbours are light"],"mcp":"create_component with a sectionType naming the family (e.g. 'Bento'); each prop needs a `target` into your own blockJson. cells → a `slot` prop with config.multiple, minItems 3, maxItems 9, config.componentIds of your published cell components, and config.slotSettings span (select 1x1/2x1/1x2/2x2, ui.control 'cards') and tone (select light/dark/brand, ui.control 'segmented'); target a container's child list (props.children on a section, props.columns.<n> on a columns block). Each child is `{ componentId, overrides? }` and its settings sit in `_settings`. eyebrow/heading → text props; gap → select with ui.control 'segmented'. 4 columns and 3 columns are two components sharing sectionType 'Bento' with the same prop keys.","pitfalls":["The kit's allow list names kit blocks; config.componentIds must name this project's published components, and the renderer needs their definitions or every cell draws empty.","A slot child has no `_variant`: a variant is its own component.","slotSettings are leaf fields only; a cell's own copy stays in the cell component's props."],"notCarried":["category","variants"],"component":{"name":"Bento grid","slug":"bento","props":[{"key":"eyebrow","label":"Eyebrow","type":"text","config":{"maxLength":32}},{"key":"heading","label":"Heading","type":"text","ai":true,"recommendedMax":56},{"key":"cells","label":"Cells","type":"slot","config":{"multiple":true,"minItems":3,"maxItems":9,"allow":["imageBlock","statBlock","quoteBlock","textBlock","ctaCard","productCard","videoBlock"],"slotSettings":[{"key":"span","label":"Size","type":"select","defaultValue":"1x1","options":[{"label":"Small","value":"1x1","icon":"layout-grid","description":"1 × 1"},{"label":"Wide","value":"2x1","icon":"columns-2","description":"2 × 1"},{"label":"Tall","value":"1x2","icon":"layout-sidebar","description":"1 × 2"},{"label":"Large","value":"2x2","icon":"layout-cards","description":"2 × 2"}],"ui":{"control":"cards"}},{"key":"tone","label":"Surface","type":"select","defaultValue":"light","options":[{"label":"Light","value":"light"},{"label":"Dark","value":"dark"},{"label":"Brand","value":"brand"}],"ui":{"control":"segmented"}}]}},{"key":"gap","label":"Gap","type":"select","defaultValue":"md","config":{"options":[{"label":"S","value":"sm"},{"label":"M","value":"md"},{"label":"L","value":"lg"}]},"ui":{"control":"segmented"}}],"description":"A mosaic of cells — images, stats, quotes, products","category":"section","icon":"layout-dashboard","preview":{"title":"heading"}}},
|
|
1511
|
-
{"id":"core-journalStory","name":"Journal story","category":"Core examples","kind":"entry","tags":["rich-text","references","media-heavy","seo-structured","localized","validation","embed"],"proves":"An entry: groups, fieldsets, references, rich text, SEO limits, changed-since-publish","why":"A story is an ENTRY, one of many, with its own URL: content in groups (Content, Media, Settings) and fieldsets (Byline, a collapsed Gear review, Publishing). Authors and topics are references to their own collections, not copied names; the reviewed product is a reference to commerce. The body is the one long rich-text field. Layout, accent, internal tags, related stories and developer-only custom CSS are Settings. It proves references, rich text, SEO-friendly limits (title, excerpt) and changed-since-publish.","htmlSignals":["An <article> (often itemtype BlogPosting) with an <h1>, a dek <p>, a byline with <a rel=\"author\"> and <time datetime>","A cover <figure> with <img> and <figcaption> above a prose body of <h2>, <p>, lists, figures, tables and code","A topic link above the title and a reading time (\"7 min read\") in the byline","One of many pages under a shared route such as /blog/<slug>"],"mcp":"Not a component: create_content_model for the stories (a collection with urlPattern '/blog/:slug' and one dynamic page), and create_content_entry per story. Find or create the author and topic entries first and reference them by id. title, slug, excerpt, cover, gallery and film are fields; body is the ONE `document` field (top level, at most one per schema); dates are ISO 8601 with their offset. Publish authors and topics, then the post, then the template page. The `component` shape below is props-shaped only for comparison; if you place a story teaser as a component, each prop needs a `target` into your own blockJson.","pitfalls":["Never model SEO fields: entry meta (metaTitle, metaDescription, og, canonical) goes in update_content_entry `meta`, and BlogPosting markup is automatic for a collection with a body, a date and an author.","Reading time is computed by the template; no field stores it today, so don't copy \"7 min read\" into readingTime.","Bind the body wrapper as kind `document`, never `richtext`, or a save repaints the article from plain text."],"notCarried":["shopify reference"],"component":{"name":"Story","slug":"journal-story","props":[{"key":"title","label":"Title","type":"text","required":true,"ai":true,"recommendedMax":70,"localized":true,"config":{"maxLength":90},"ui":{"tab":{"id":"content","label":"Content","icon":"file-text"}}},{"key":"slug","label":"Slug","type":"slug","required":true,"ui":{"tab":{"id":"content"}}},{"key":"excerpt","label":"Excerpt","type":"longtext","ai":true,"recommendedMax":160,"localized":true,"ui":{"rows":2,"tab":{"id":"content"}}},{"key":"authors","label":"Authors","type":"multi-reference","config":{"min":1,"max":3,"contentModelId":"col_authors"},"ui":{"tab":{"id":"content"},"group":{"id":"byline","label":"Byline","kind":"group","description":"Who wrote it and what it's about."}}},{"key":"topics","label":"Topics","type":"multi-reference","config":{"max":4,"contentModelId":"col_topics"},"ui":{"tab":{"id":"content"},"group":{"id":"byline"}}},{"key":"readingTime","label":"Reading time","type":"number","config":{"unit":"min","min":1,"max":60},"ui":{"tab":{"id":"content"},"group":{"id":"byline"}}},{"key":"body","label":"Body","type":"richtext","required":true,"ai":true,"localized":true,"config":{"features":["bold","italic","underline","strikethrough","code","highlight","blockquote","horizontalRule","orderedList","unorderedList","checklist","link","internalLink","inlineImage","videoEmbed","codeBlock","table","columns","h1","h2","h3","h4","h5","h6","gallery","embed","tableOfContents","relatedPosts","authorBio","footnotes","button"]},"ui":{"tab":{"id":"content"}}},{"key":"product","label":"Reviewed product","type":"text","readOnly":true,"lockReason":"A Shopify product id. No Shopify integration backs a reference in BetterCMS yet, so the id is kept as it is.","ui":{"tab":{"id":"content"},"group":{"id":"review","label":"Gear review","kind":"group","collapsed":true,"description":"Only for stories that review a product."}}},{"key":"score","label":"Our score","type":"rating","config":{"step":0.1},"ui":{"tab":{"id":"content"},"group":{"id":"review"}}},{"key":"verdict","label":"Verdict","type":"text","recommendedMax":80,"ui":{"tab":{"id":"content"},"group":{"id":"review"}}},{"key":"cta","label":"Call to action","type":"button","ui":{"tab":{"id":"content"}}},{"key":"cover","label":"Cover image","type":"image","helpText":"1600 × 900 or larger. Also used on the social card.","required":true,"ui":{"tab":{"id":"media","label":"Media","icon":"photo"}}},{"key":"gallery","label":"Gallery","type":"array","config":{"maxItems":12,"itemType":"image"},"ui":{"itemName":"photo","itemTitle":"Photo","tab":{"id":"media"}}},{"key":"film","label":"Film","type":"video","ui":{"tab":{"id":"media"}}},{"key":"location","label":"Where it happened","type":"location","ui":{"tab":{"id":"media"}}},{"key":"publishedAt","label":"Publish date","type":"datetime","ui":{"tab":{"id":"settings","label":"Settings","icon":"settings"},"group":{"id":"publishing","label":"Publishing","kind":"group"
|
|
1511
|
+
{"id":"core-journalStory","name":"Journal story","category":"Core examples","kind":"entry","tags":["rich-text","references","media-heavy","seo-structured","localized","validation","embed"],"proves":"An entry: groups, fieldsets, references, rich text, SEO limits, changed-since-publish","why":"A story is an ENTRY, one of many, with its own URL: content in groups (Content, Media, Settings) and fieldsets (Byline, a collapsed Gear review, Publishing). Authors and topics are references to their own collections, not copied names; the reviewed product is a reference to commerce. The body is the one long rich-text field. Layout, accent, internal tags, related stories and developer-only custom CSS are Settings. It proves references, rich text, SEO-friendly limits (title, excerpt) and changed-since-publish.","htmlSignals":["An <article> (often itemtype BlogPosting) with an <h1>, a dek <p>, a byline with <a rel=\"author\"> and <time datetime>","A cover <figure> with <img> and <figcaption> above a prose body of <h2>, <p>, lists, figures, tables and code","A topic link above the title and a reading time (\"7 min read\") in the byline","One of many pages under a shared route such as /blog/<slug>"],"mcp":"Not a component: create_content_model for the stories (a collection with urlPattern '/blog/:slug' and one dynamic page), and create_content_entry per story. Find or create the author and topic entries first and reference them by id. title, slug, excerpt, cover, gallery and film are fields; body is the ONE `document` field (top level, at most one per schema); dates are ISO 8601 with their offset. Publish authors and topics, then the post, then the template page. The `component` shape below is props-shaped only for comparison; if you place a story teaser as a component, each prop needs a `target` into your own blockJson.","pitfalls":["Never model SEO fields: entry meta (metaTitle, metaDescription, og, canonical) goes in update_content_entry `meta`, and BlogPosting markup is automatic for a collection with a body, a date and an author.","Reading time is computed by the template; no field stores it today, so don't copy \"7 min read\" into readingTime.","Bind the body wrapper as kind `document`, never `richtext`, or a save repaints the article from plain text."],"notCarried":["shopify reference"],"component":{"name":"Story","slug":"journal-story","props":[{"key":"title","label":"Title","type":"text","required":true,"ai":true,"recommendedMax":70,"localized":true,"config":{"maxLength":90},"ui":{"tab":{"id":"content","label":"Content","icon":"file-text"}}},{"key":"slug","label":"Slug","type":"slug","required":true,"ui":{"tab":{"id":"content"}}},{"key":"excerpt","label":"Excerpt","type":"longtext","ai":true,"recommendedMax":160,"localized":true,"ui":{"rows":2,"tab":{"id":"content"}}},{"key":"authors","label":"Authors","type":"multi-reference","config":{"min":1,"max":3,"contentModelId":"col_authors"},"ui":{"tab":{"id":"content"},"group":{"id":"byline","label":"Byline","kind":"group","description":"Who wrote it and what it's about."}}},{"key":"topics","label":"Topics","type":"multi-reference","config":{"max":4,"contentModelId":"col_topics"},"ui":{"tab":{"id":"content"},"group":{"id":"byline"}}},{"key":"readingTime","label":"Reading time","type":"number","config":{"unit":"min","min":1,"max":60},"ui":{"tab":{"id":"content"},"group":{"id":"byline"}}},{"key":"body","label":"Body","type":"richtext","required":true,"ai":true,"localized":true,"config":{"features":["bold","italic","underline","strikethrough","code","highlight","blockquote","horizontalRule","orderedList","unorderedList","checklist","link","internalLink","inlineImage","videoEmbed","codeBlock","table","columns","h1","h2","h3","h4","h5","h6","gallery","embed","tableOfContents","relatedPosts","authorBio","footnotes","button"]},"ui":{"tab":{"id":"content"}}},{"key":"product","label":"Reviewed product","type":"text","readOnly":true,"lockReason":"A Shopify product id. No Shopify integration backs a reference in BetterCMS yet, so the id is kept as it is.","ui":{"tab":{"id":"content"},"group":{"id":"review","label":"Gear review","kind":"group","collapsed":true,"description":"Only for stories that review a product."}}},{"key":"score","label":"Our score","type":"rating","config":{"step":0.1},"ui":{"tab":{"id":"content"},"group":{"id":"review"}}},{"key":"verdict","label":"Verdict","type":"text","recommendedMax":80,"ui":{"tab":{"id":"content"},"group":{"id":"review"}}},{"key":"cta","label":"Call to action","type":"button","ui":{"tab":{"id":"content"}}},{"key":"cover","label":"Cover image","type":"image","helpText":"1600 × 900 or larger. Also used on the social card.","required":true,"ui":{"tab":{"id":"media","label":"Media","icon":"photo"}}},{"key":"gallery","label":"Gallery","type":"array","config":{"maxItems":12,"itemType":"image"},"ui":{"itemName":"photo","itemTitle":"Photo","tab":{"id":"media"}}},{"key":"film","label":"Film","type":"video","ui":{"tab":{"id":"media"}}},{"key":"location","label":"Where it happened","type":"location","ui":{"tab":{"id":"media"}}},{"key":"publishedAt","label":"Publish date","type":"datetime","ui":{"tab":{"id":"settings","label":"Settings","icon":"settings"},"group":{"id":"publishing","label":"Publishing","kind":"group"}}},{"key":"featured","label":"Featured on the Journal","type":"boolean","ui":{"tab":{"id":"settings"},"group":{"id":"publishing"}}},{"key":"layout","label":"Layout","type":"select","config":{"options":[{"label":"Standard","value":"standard","icon":"file-text","description":"Text column, inline images"},{"label":"Wide","value":"wide","icon":"layout-columns","description":"Full-width images"},{"label":"Photo essay","value":"essay","icon":"library-photo","description":"Images first, short captions"}]},"ui":{"control":"cards","tab":{"id":"settings"}}},{"key":"accent","label":"Accent colour","type":"color","ui":{"tab":{"id":"settings"}}},{"key":"tags","label":"Internal tags","type":"tags","helpText":"Only your team sees these.","config":{"max":6},"ui":{"tab":{"id":"settings"}}},{"key":"related","label":"Related stories","type":"select","config":{"options":[{"label":"Automatic","value":"auto","description":"Same topics, newest first"},{"label":"Pick them","value":"manual","description":"Choose up to three"},{"label":"Don't show","value":"none"}]},"ui":{"control":"radio","tab":{"id":"settings"}}},{"key":"customCss","label":"Custom CSS","type":"code","advanced":true,"ui":{"access":{"view":"schema.view","edit":"schema.manage"},"tab":{"id":"settings"}}}],"description":"A long-form Journal story","v2":{"shape":"entry"},"icon":"news","preview":{"title":"title","subtitle":"excerpt","media":"cover"}}},
|
|
1512
1512
|
{"id":"core-hero","name":"Hero","category":"Core examples","kind":"block","tags":["variants","media-heavy","localized","a11y"],"proves":"Buttons as one unit · inline proof object · cards, segmented and slider controls","why":"The opening band: an eyebrow, a headline (required, 90 max, 60 recommended), supporting text, two buttons and a proof line of rating plus label. Each button is one unit, so label, link and look travel together. The proof is a small object because the stars are drawn from the number. Media (a required image, an optional background video) and Design (alignment, theme, overlay, fill-the-screen) are their own tabs, so copy, media and look never mix; split, centered and full-bleed are variants.","htmlSignals":["The first <section> after the header with one <h1>, a short eyebrow <p> above it and a lede <p> below","Two links styled as buttons (btn-primary / btn-ghost), sometimes with an arrow icon","A <picture>/<img> beside the copy (split) or absolutely positioned behind it with a dark scrim <div> (full-bleed)","A rating line: star glyphs with aria-label=\"Rated 4.8 out of 5\" and \"from 310 reviews\""],"mcp":"create_component with sectionType 'Hero' and category 'hero'; root is a `section` block with `style`, content in props.children. Each prop needs a `target` into your own blockJson: eyebrow/body → text props on text blocks (props.html), heading → props.text of a level-1 heading block, primary/secondary → one `button` prop each (label, link and look in one unit) on a button block's `props`, image → an `image` prop on an image block's props.src plus a text prop on props.alt, video → a video block's props.url, proof → an `object` prop with config.fields rating (number) and label (text). Put image/video in ui.tab 'Media' and align/theme/overlay/fullHeight in ui.tab 'Design' (theme with ui.control 'segmented'). Split image, Centered and Full-bleed image are three components sharing sectionType 'Hero' with the same prop keys.","pitfalls":["Overlay and height have no section token today: the scrim and spacing stay in the template's classes unless the template reads those props.","object-position is the image's focal point (50% 35% → { x: 0.5, y: 0.35 }); store the number 4.8, never the star glyphs.","A variant that renames a key (title vs heading) silently drops that content on a swap."],"notCarried":["variants"],"component":{"name":"Hero","slug":"hero","props":[{"key":"eyebrow","label":"Eyebrow","type":"text","config":{"maxLength":40},"ui":{"tab":{"id":"content","label":"Content"}}},{"key":"heading","label":"Headline","type":"text","required":true,"ai":true,"recommendedMax":60,"localized":true,"config":{"maxLength":90},"ui":{"tab":{"id":"content"}}},{"key":"body","label":"Supporting text","type":"longtext","ai":true,"recommendedMax":180,"localized":true,"ui":{"rows":3,"tab":{"id":"content"}}},{"key":"primary","label":"Primary button","type":"button","ui":{"tab":{"id":"content"}}},{"key":"secondary","label":"Secondary button","type":"button","ui":{"tab":{"id":"content"}}},{"key":"proof","label":"Proof line","type":"object","config":{"fields":[{"key":"rating","label":"Rating","type":"number","config":{"scale":{"steps":{"min":0,"max":5,"step":0.1}}}},{"key":"label","label":"Label","type":"text","placeholder":"from 2,400 reviews"}]},"ui":{"icon":"star","tab":{"id":"content"}}},{"key":"image","label":"Image","type":"image","required":true,"ui":{"tab":{"id":"media","label":"Media"}}},{"key":"video","label":"Background video","type":"video","ui":{"tab":{"id":"media"}}},{"key":"align","label":"Text alignment","type":"select","config":{"options":[{"label":"Left","value":"left","icon":"layout-sidebar","description":"Reads like a story"},{"label":"Centered","value":"center","icon":"layout-columns","description":"Short, punchy lines"}]},"ui":{"control":"cards","tab":{"id":"design","label":"Design"}}},{"key":"theme","label":"Theme","type":"select","config":{"options":[{"label":"Light","value":"light"},{"label":"Dark","value":"dark"},{"label":"Brand","value":"brand"}]},"ui":{"control":"segmented","tab":{"id":"design"}}},{"key":"overlay","label":"Image overlay","type":"number","config":{"scale":{"steps":{"min":0,"max":80,"step":5},"units":["%"]}},"ui":{"tab":{"id":"design"}}},{"key":"fullHeight","label":"Fill the screen","type":"boolean","ui":{"tab":{"id":"design"}}}],"description":"Headline, supporting copy, actions and media","category":"hero","icon":"template","preview":{"title":"heading","subtitle":"eyebrow","media":"image"}}}
|
|
1513
1513
|
]
|
|
1514
1514
|
}
|