@bettercms-ai/kit 3.1.22 → 3.1.23

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.
@@ -1485,7 +1485,7 @@
1485
1485
  {"id":"stockist-map","name":"Map with markers","category":"Data & interactive","kind":"block","tags":["repeater","conditional","embed","a11y","references","seo-structured"],"proves":"Categories → markers → popup → button · geopoints · manual or collection source · list fallback for keyboard users","why":"Categories are an array (editors add 'Pop-ups' without a developer) and drive both filter chips and pin styling; each marker stores a geopoint, a readable address (the list fallback reads it, not the map) and a popup object that drills in to a button — Map › Place › Popup › Button. A collection source exists because stockist lists outgrow a block fast. Provider is developer-locked because it depends on an API key in the environment; consent is a content decision.","htmlSignals":["A Leaflet/MapLibre/Mapbox/Google Maps container (div.leaflet-container, .mapboxgl-map, iframe to maps.google.com/embed)","Marker data in JSON (data-markers, window.locations) or repeated <li> with address + lat/lng data attributes","Filter chips above the map toggling categories","Popups with an image, a line of text and 'Directions' links","LocalBusiness / Store JSON-LD per location"],"mcp":"Read marker data from the JSON the map is initialised with (or the visible list); each → `marker` with geopoint {lat,lng,label}. Derive `categories` from distinct marker types/filters; set each marker's `category` to the generated key. Popup HTML → popup.image/body/button. If there are more than 50 places or the list is a CMS feed, create a Locations collection and set `source: collection` — each location becomes an entry (it has its own page, hours and JSON-LD). Never extract the provider API key; set `provider` only. A static map image with no interactivity is NOT this entry — model it as an image.","pitfalls":["SCHEMA GAP: a marker's category should be a select whose options come from the sibling `categories` array (dynamic options); it is a patterned string with no integrity check.","SCHEMA GAP: opening hours want a structured type (day-of-week ranges, exceptions/holidays) to emit LocalBusiness openingHoursSpecification; strings can't be validated against real times.","SCHEMA GAP: no address type (street, locality, region, postcode, country) — needed for JSON-LD PostalAddress and geocoding; a multi-line text loses structure.","Turning off `showList` leaves keyboard and screen-reader users with no way to reach the places."],"notCarried":["variants"],"component":{"name":"Map","slug":"marker-map","props":[{"key":"heading","label":"Heading","type":"text","required":true,"ai":true,"recommendedMax":50,"ui":{"tab":{"id":"content","label":"Content"}}},{"key":"intro","label":"Intro","type":"longtext","recommendedMax":160,"ui":{"rows":2,"tab":{"id":"content"}}},{"key":"categories","label":"Categories","type":"table","config":{"maxItems":6,"fields":[{"key":"label","label":"Label","type":"text","required":true,"config":{"maxLength":24}},{"key":"key","label":"Key","type":"text","required":true,"unique":true,"config":{"pattern":"^[a-z][a-zA-Z0-9]*$","patternMessage":"Use camelCase letters and numbers, like hoursPerRun."}},{"key":"color","label":"Pin color","type":"color"},{"key":"icon","label":"Pin icon","type":"icon"}]},"ui":{"itemLabel":"Category","icon":"tag","preview":{"title":"label","subtitle":"key","fallback":"Untitled category"},"tab":{"id":"places","label":"Places","icon":"map-pins"}}},{"key":"source","label":"Places come from","type":"select","defaultValue":"manual","config":{"options":[{"label":"Added here","value":"manual"},{"label":"Locations collection","value":"collection"}]},"ui":{"control":"segmented","tab":{"id":"places"}}},{"key":"markers","label":"Places","type":"table","showIf":{"match":"all","rules":[{"field":"source","op":"eq","value":"manual"}]},"config":{"minItems":1,"maxItems":50,"fields":[{"key":"name","label":"Name","type":"text","required":true,"config":{"maxLength":60}},{"key":"category","label":"Category key","type":"text","helpText":"One of the category keys above, e.g. retailer.","required":true,"config":{"pattern":"^[a-z][a-zA-Z0-9]*$","patternMessage":"Use camelCase letters and numbers, like hoursPerRun."}},{"key":"location","label":"Pin","type":"location","required":true},{"key":"address","label":"Address","type":"longtext","required":true,"config":{"maxLength":160},"ui":{"rows":2}},{"key":"phone","label":"Phone","type":"text","config":{"pattern":"^\\+?[0-9 ()-]{7,20}$","patternMessage":"Use digits, spaces and an optional +, like +1 541 555 0182."}},{"key":"hours","label":"Opening hours","type":"table","openMode":"inline","fields":[{"key":"days","label":"Days","type":"text","required":true,"placeholder":"Mon–Fri","config":{"maxLength":20}},{"key":"times","label":"Hours","type":"text","required":true,"config":{"pattern":"^(Closed|\\d{1,2}:\\d{2}–\\d{1,2}:\\d{2})$","patternMessage":"Use opening hours, like 09:00–18:00 or Closed."}}],"config":{"maxItems":7},"ui":{"itemLabel":"Line","itemName":"hoursLine","icon":"clock","preview":{"title":"days","subtitle":"times","fallback":"Untitled line"}}},{"key":"popup","label":"Popup","type":"object","openMode":"drill","fields":[{"key":"image","label":"Image","type":"image"},{"key":"body","label":"Body","type":"longtext","recommendedMax":120,"ui":{"rows":2}},{"key":"button","label":"Button","type":"button"}],"ui":{"icon":"message-2"}}]},"ui":{"itemLabel":"Place","icon":"map-pin","preview":{"title":"name","subtitle":"address","fallback":"Untitled place"},"tab":{"id":"places"}}},{"key":"collection","label":"Collection","type":"reference","required":true,"showIf":{"match":"all","rules":[{"field":"source","op":"eq","value":"collection"}]},"config":{"targets":["collection"]},"ui":{"tab":{"id":"places"}}},{"key":"provider","label":"Map provider","type":"select","readOnly":"developer","lockReason":"The provider key is set in the site's environment.","config":{"options":[{"label":"MapLibre","value":"maplibre"},{"label":"Mapbox","value":"mapbox"},{"label":"Google Maps","value":"google"}]},"ui":{"access":{"edit":"schema.manage"},"tab":{"id":"map","label":"Map"}}},{"key":"style","label":"Map style","type":"select","config":{"options":[{"label":"Outdoors","value":"outdoors"},{"label":"Light","value":"light"},{"label":"Satellite","value":"satellite"}]},"ui":{"control":"segmented","tab":{"id":"map"}}},{"key":"center","label":"Start centered on","type":"location","helpText":"Leave empty to fit every pin.","ui":{"tab":{"id":"map"}}},{"key":"zoom","label":"Start zoom","type":"number","config":{"min":2,"max":16,"step":1},"ui":{"control":"slider","tab":{"id":"map"}}},{"key":"useClustering","label":"Group nearby pins","type":"boolean","defaultValue":true,"ui":{"tab":{"id":"map"}}},{"key":"showList","label":"List beside the map","type":"boolean","defaultValue":true,"ui":{"tab":{"id":"map"}}},{"key":"showNearMe","label":"Show Near me button","type":"boolean","ui":{"tab":{"id":"map"}}},{"key":"useConsentGate","label":"Ask before loading the map","type":"boolean","helpText":"Needed in the EU for Google Maps.","ui":{"tab":{"id":"map"}}}],"description":"Pins on a map with popups, filters and a list beside it","category":"Data & interactive","icon":"map-pin","preview":{"title":"heading","subtitle":"intro","icon":"map-pin"}}},
1486
1486
  {"id":"product-compare-slider","name":"Product comparison slider","category":"Data & interactive","kind":"block","tags":["references","repeater","conditional","validation","commerce","responsive-layout"],"proves":"References to products · attributes pulled from referenced fields or typed per product · swipe on phones","why":"Comparison values belong to the PRODUCTS, not the section — so rows default to 'pull this field from each referenced product' and only rows that aren't product data ('Best for') are typed here, keyed by product reference. That keeps prices and weights in one place. Products are an array of references with min 2 / max 4 and uniqueness; the phone behavior is an explicit choice because a 4-column table is unreadable at 390px.","htmlSignals":["A table or CSS grid whose column headers are product cards (image, name, price, button)","Row labels for specs (Weight, Capacity, Warranty) repeated across products","Horizontal scroll-snap on mobile (overflow-x: auto; scroll-snap-type: x) or 'swipe to compare' hints","Ticks/crosses or 'Best value' highlighting in cells"],"mcp":"Resolve each column header to an existing product entry (match by URL/handle/SKU) and add it to `products`; if a product doesn't exist, create it first — never type product names into the section. For each row: if the value matches a field on the product model (weight, price…), emit `source: field` with that field; otherwise `source: custom` with one value per product reference. Ticks → 'Yes'/'No' values or a boolean product field. Scroll-snap / swipe UI → `mobile: swipe`. If the page compares more than 4 products or more than 14 rows, it's a spec database: build a Products-table entry (data-table with collection source) instead.","pitfalls":["SCHEMA GAP: `field` options should be generated from the referenced collection's fields (dynamic options); here they're a hard-coded list that drifts when the Products model changes.","SCHEMA GAP: `recommended` must be one of `products` (constrained reference) — not expressible.","SCHEMA GAP: array `unique: true` (no duplicate product) is declared but not enforced by the validator.","SCHEMA GAP: custom `values` should have exactly one entry per product (a matrix keyed by another array); adding a fourth product leaves rows with three values and nothing warns."],"notCarried":["variants"],"component":{"name":"Comparison slider","slug":"comparison-slider","props":[{"key":"heading","label":"Heading","type":"text","required":true,"ai":true,"recommendedMax":50,"ui":{"tab":{"id":"content","label":"Content"}}},{"key":"intro","label":"Intro","type":"longtext","ui":{"rows":2,"tab":{"id":"content"}}},{"key":"products","label":"Products","type":"multi-reference","unique":true,"config":{"min":2,"max":4,"contentModelId":"col_products"},"ui":{"itemLabel":"Product","tab":{"id":"content"}}},{"key":"recommended","label":"Recommended","type":"reference","helpText":"Must be one of the products above.","config":{"contentModelId":"col_products"},"ui":{"tab":{"id":"content"}}},{"key":"attributes","label":"Rows","type":"table","config":{"minItems":1,"maxItems":14,"fields":[{"key":"source","label":"Values come from","type":"select","defaultValue":"field","options":[{"label":"Product field","value":"field"},{"label":"Typed here","value":"custom"}],"ui":{"control":"segmented"}},{"key":"field","label":"Product field","type":"select","required":true,"showIf":{"match":"all","rules":[{"field":"source","op":"eq","value":"field"}]},"options":[{"label":"Capacity","value":"capacity"},{"label":"Weight","value":"weight"},{"label":"Material","value":"material"},{"label":"Heat rating","value":"heatRating"},{"label":"Induction","value":"induction"},{"label":"Packed size","value":"packedSize"},{"label":"Warranty","value":"warranty"},{"label":"Price","value":"price"}]},{"key":"label","label":"Row label","type":"text","helpText":"Leave empty to use the field's name.","config":{"maxLength":32}},{"key":"tooltip","label":"Explainer","type":"text","config":{"maxLength":90}},{"key":"values","label":"Values","type":"table","showIf":{"match":"all","rules":[{"field":"source","op":"eq","value":"custom"}]},"openMode":"inline","fields":[{"key":"product","label":"Product","type":"reference","config":{"contentModelId":"col_products"}},{"key":"value","label":"Value","type":"text","required":true,"config":{"maxLength":40}}],"config":{"maxItems":4},"ui":{"itemLabel":"Value","itemName":"cellValue","icon":"square","preview":{"title":"value","fallback":"Untitled value"}}},{"key":"showDifferences","label":"Highlight differences","type":"boolean"}]},"ui":{"itemLabel":"Row","icon":"list-details","preview":{"title":"label","subtitle":"field","fallback":"Untitled row"},"tab":{"id":"rows","label":"Rows","icon":"list-details"}}},{"key":"mobile","label":"On phones","type":"select","defaultValue":"swipe","config":{"options":[{"label":"Swipe","value":"swipe","description":"One product at a time, row labels stay put"},{"label":"Pick two","value":"pair","description":"Two dropdowns choose which pair to compare"},{"label":"Stack","value":"stack","description":"Each product as its own card"}]},"ui":{"control":"radio","tab":{"id":"display","label":"Display"}}},{"key":"isHeaderSticky","label":"Keep the header row in view","type":"boolean","defaultValue":true,"ui":{"tab":{"id":"display"}}},{"key":"showAddToCart","label":"Show add to cart buttons","type":"boolean","defaultValue":true,"ui":{"tab":{"id":"display"}}}],"description":"Two to four products side by side, swipeable on phones","category":"Data & interactive","icon":"arrows-left-right","preview":{"title":"heading","subtitle":"intro"}}},
1487
1487
  {"id":"countdown-live-counter","name":"Countdown and live counter","category":"Data & interactive","kind":"block","tags":["conditional","validation","localized","a11y"],"proves":"Datetime + time zone · what happens after zero (conditional) · live counter from a static rate or an API · aria-live","why":"The timer is a datetime plus an explicit time zone (a launch is 9am Pacific for everyone), and the zero moment is a real content state: the after-launch heading and button are conditional fields so the section never shows 00:00:00 for a week. The live counter is a drill-in object with its own nested conditionals (enabled → source → rate fields or endpoint), which is the pattern for any self-contained sub-feature. Unit labels are localized strings because 'hrs' is copy.","htmlSignals":["Digits grouped as dd:hh:mm:ss updated by setInterval, often with data-countdown / data-end attributes holding an ISO date","Labels like 'days hrs min sec' under the digits","'X people waiting' / 'Y sold' numbers polling an endpoint (fetch in a loop)","Launch banner copy: 'Drops Friday', 'Ends in'"],"mcp":"Read the target from data attributes or the JS (new Date('…')); if it has no offset, ask for or default the brand's zone and set `timezone` — never store a local time without one. Units shown → `units`; their labels → `labels`. Find what the script does at zero (hide/replace text) and map to `afterEnd`, extracting the replacement copy. A polling number → counter.source api (copy the endpoint, developer-locked); a number computed from a start + rate → source rate. If the counter is fabricated (random increments with no data), do not migrate it — flag it.","pitfalls":["SCHEMA GAP: datetime has no time zone component; the zone is a separate select and nothing forces them to be read together (and DST is the renderer's job).","SCHEMA GAP: conditions don't chain — `startValue` is shown when source = rate even if the parent `showLiveCounter` toggle is off, because a field can only test one sibling. Needs `hidden` with AND/OR or nested condition groups.","SCHEMA GAP: no 'scheduled content' primitive — after-launch copy should be a scheduled change (release) rather than a second set of fields.","Countdowns that reset per visitor are dark patterns (and illegal under EU UCPD guidance); the schema has no per-visitor mode on purpose."],"notCarried":["variants"],"component":{"name":"Countdown","slug":"countdown","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":50,"localized":true,"ui":{"tab":{"id":"content"}}},{"key":"body","label":"Body","type":"longtext","localized":true,"ui":{"rows":2,"tab":{"id":"content"}}},{"key":"button","label":"Button","type":"button","ui":{"tab":{"id":"content"}}},{"key":"target","label":"Counts down to","type":"datetime","required":true,"ui":{"tab":{"id":"timer","label":"Timer","icon":"clock"}}},{"key":"timezone","label":"Time zone","type":"select","helpText":"The launch happens at this zone's time for everyone.","defaultValue":"America/Los_Angeles","config":{"options":[{"label":"Pacific (Bend)","value":"America/Los_Angeles"},{"label":"Eastern","value":"America/New_York"},{"label":"London","value":"Europe/London"},{"label":"UTC","value":"UTC"}]},"ui":{"tab":{"id":"timer"}}},{"key":"units","label":"Show","type":"multiselect","defaultValue":["days","hours","minutes","seconds"],"config":{"options":[{"label":"Days","value":"days"},{"label":"Hours","value":"hours"},{"label":"Minutes","value":"minutes"},{"label":"Seconds","value":"seconds"}]},"ui":{"tab":{"id":"timer"}}},{"key":"labels","label":"Unit labels","type":"object","openMode":"drill","config":{"fields":[{"key":"days","label":"Days","type":"text","localized":true,"placeholder":"days","config":{"maxLength":12}},{"key":"hours","label":"Hours","type":"text","localized":true,"placeholder":"hrs","config":{"maxLength":12}},{"key":"minutes","label":"Minutes","type":"text","localized":true,"placeholder":"min","config":{"maxLength":12}},{"key":"seconds","label":"Seconds","type":"text","localized":true,"placeholder":"sec","config":{"maxLength":12}}]},"ui":{"icon":"language","tab":{"id":"timer"}}},{"key":"afterEnd","label":"When it reaches zero","type":"select","defaultValue":"message","config":{"options":[{"label":"Hide the block","value":"hide"},{"label":"Show a message","value":"message","description":"Swap the timer for new copy and a button"},{"label":"Keep it at zero","value":"keep"}]},"ui":{"control":"radio","tab":{"id":"timer"}}},{"key":"endedHeading","label":"Heading after launch","type":"text","required":true,"showIf":{"match":"all","rules":[{"field":"afterEnd","op":"eq","value":"message"}]},"localized":true,"config":{"maxLength":60},"ui":{"tab":{"id":"timer"}}},{"key":"endedButton","label":"Button after launch","type":"button","showIf":{"match":"all","rules":[{"field":"afterEnd","op":"eq","value":"message"}]},"ui":{"tab":{"id":"timer"}}},{"key":"counter","label":"Live counter","type":"object","openMode":"drill","config":{"fields":[{"key":"showLiveCounter","label":"Show a live counter","type":"boolean"},{"key":"label","label":"Label","type":"text","showIf":{"match":"all","rules":[{"field":"showLiveCounter","op":"eq","value":"true"}]},"localized":true,"config":{"maxLength":40}},{"key":"source","label":"Number comes from","type":"select","defaultValue":"rate","showIf":{"match":"all","rules":[{"field":"showLiveCounter","op":"eq","value":"true"}]},"options":[{"label":"Start + rate","value":"rate"},{"label":"Live API","value":"api"}],"ui":{"control":"segmented"}},{"key":"startValue","label":"Starts at","type":"number","showIf":{"match":"all","rules":[{"field":"source","op":"eq","value":"rate"}]}},{"key":"startedAt","label":"Counted from","type":"datetime","showIf":{"match":"all","rules":[{"field":"source","op":"eq","value":"rate"}]}},{"key":"perHour","label":"Adds per hour","type":"number","helpText":"Only a real average. Fake urgency breaks EU law.","showIf":{"match":"all","rules":[{"field":"source","op":"eq","value":"rate"}]},"config":{"min":0,"step":1}},{"key":"endpoint","label":"Endpoint","type":"url","required":true,"showIf":{"match":"all","rules":[{"field":"source","op":"eq","value":"api"}]},"readOnly":"developer","lockReason":"Set by a developer. It must return { \"value\": number }.","config":{"pattern":"^https://","patternMessage":"Use an https:// address, like https://your-site.com."},"ui":{"access":{"view":"schema.view","edit":"schema.manage"}}},{"key":"refreshSeconds","label":"Refresh every","type":"number","showIf":{"match":"all","rules":[{"field":"source","op":"eq","value":"api"}]},"config":{"min":10,"max":600,"step":5,"unit":"s"}},{"key":"format","label":"Format","type":"select","defaultValue":"full","showIf":{"match":"all","rules":[{"field":"showLiveCounter","op":"eq","value":"true"}]},"options":[{"label":"12,431","value":"full"},{"label":"12.4k","value":"compact"}],"ui":{"control":"segmented"}}]},"ui":{"icon":"activity","tab":{"id":"counter","label":"Live counter","icon":"activity"}}},{"key":"announce","label":"Screen reader updates","type":"select","defaultValue":"off","advanced":true,"config":{"options":[{"label":"Off","value":"off","description":"Recommended: a ticking timer announced every second is noise"},{"label":"Every minute","value":"minute"}]},"ui":{"tab":{"id":"timer"}}}],"description":"Counts down to a launch, then swaps to a message or button","category":"Data & interactive","icon":"hourglass","preview":{"title":"heading","subtitle":"target"}}},
1488
- {"id":"reader-poll","name":"Poll","category":"Data & interactive","kind":"block","tags":["form","conditional","repeater","validation","references"],"proves":"Question type switches options vs scale vs open answer · results visibility · close date · one vote per reader","why":"The answer type drives everything below it, so options, scale and the open-answer settings are mutually exclusive conditional branches of one `type` select. Rules (results visibility, close date, eligibility) are a separate tab because they change behavior, not copy. Votes are SUBMISSIONS — runtime data in Forms, never stored on the block — so the schema has no results fields at all.","htmlSignals":["A <form> with one question and radio/checkbox inputs, submitting via fetch, often with 'Vote' as the button","Results rendered as horizontal percentage bars after submit","'Poll closes …' text or a disabled state with 'Final results'","Third-party poll scripts (Crowdsignal, Typeform embed) — map those to the embed entry instead"],"mcp":"Question text → `question`; radio inputs → type single, checkboxes → multiple (+ maxPicks if a limit is stated), a range/star/NPS row → scale with min/max and end labels, textarea → open. Each option label (+ image) → `pollOption`. Never import vote counts. If the page has several questions in sequence, it's a SURVEY: create a form (Forms) with those fields and place a form block — do not nest questions in this poll block.","pitfalls":["SCHEMA GAP: cross-field rules (scale.min < scale.max, maxPicks ≤ number of options, closesAt in the future) can't be written as validation.","SCHEMA GAP: 'images on every option or none' is a whole-array rule; validation is per item.","SCHEMA GAP: no read-only, platform-computed fields — editors can't see live tallies inside the schema form; results live in another surface.","Multiple-question surveys modelled as nested arrays in a block become an unversioned form builder — use Forms."],"notCarried":["variants"],"component":{"name":"Poll","slug":"poll","props":[{"key":"question","label":"Question","type":"text","required":true,"ai":true,"config":{"maxLength":140},"ui":{"tab":{"id":"content","label":"Question"}}},{"key":"context","label":"Context","type":"longtext","recommendedMax":200,"ui":{"rows":2,"tab":{"id":"content"}}},{"key":"type","label":"Answer type","type":"select","defaultValue":"single","config":{"options":[{"label":"Pick one","value":"single","icon":"circle-dot"},{"label":"Pick several","value":"multiple","icon":"checkbox"},{"label":"Scale","value":"scale","icon":"adjustments-horizontal","description":"1 to 5, 0 to 10"},{"label":"Written answer","value":"open","icon":"message"}]},"ui":{"control":"cards","tab":{"id":"content"}}},{"key":"options","label":"Options","type":"table","showIf":{"match":"all","rules":[{"field":"type","op":"in","value":["single","multiple"]}]},"config":{"minItems":2,"maxItems":8,"fields":[{"key":"label","label":"Label","type":"text","required":true,"config":{"maxLength":60}},{"key":"image","label":"Image","type":"image"}]},"ui":{"itemLabel":"Option","itemName":"pollOption","icon":"circle-dot","preview":{"title":"label","media":"image","fallback":"Untitled option"},"tab":{"id":"content"}}},{"key":"maxPicks","label":"At most","type":"number","showIf":{"match":"all","rules":[{"field":"type","op":"eq","value":"multiple"}]},"config":{"min":2,"max":8,"step":1},"ui":{"tab":{"id":"content"}}},{"key":"allowOther","label":"\"Other\" with a text box","type":"boolean","showIf":{"match":"all","rules":[{"field":"type","op":"in","value":["single","multiple"]}]},"ui":{"tab":{"id":"content"}}},{"key":"scale","label":"Scale","type":"object","showIf":{"match":"all","rules":[{"field":"type","op":"eq","value":"scale"}]},"openMode":"drill","config":{"fields":[{"key":"min","label":"From","type":"number","defaultValue":1,"config":{"min":0,"max":1,"step":1}},{"key":"max","label":"To","type":"number","defaultValue":5,"config":{"min":3,"max":10,"step":1}},{"key":"minLabel","label":"Low label","type":"text","placeholder":"Not at all","config":{"maxLength":24}},{"key":"maxLabel","label":"High label","type":"text","placeholder":"Every day","config":{"maxLength":24}}]},"ui":{"icon":"adjustments-horizontal","tab":{"id":"content"}}},{"key":"placeholder","label":"Answer placeholder","type":"text","showIf":{"match":"all","rules":[{"field":"type","op":"eq","value":"open"}]},"config":{"maxLength":60},"ui":{"tab":{"id":"content"}}},{"key":"useModeration","label":"Review answers before showing them","type":"boolean","defaultValue":true,"showIf":{"match":"all","rules":[{"field":"type","op":"eq","value":"open"}]},"ui":{"tab":{"id":"content"}}},{"key":"showResults","label":"Show results","type":"select","defaultValue":"afterVote","config":{"options":[{"label":"After someone votes","value":"afterVote"},{"label":"When the poll closes","value":"afterClose"},{"label":"Never","value":"never","description":"Results stay in Forms › Submissions"}]},"ui":{"control":"radio","tab":{"id":"rules","label":"Rules"}}},{"key":"closesAt","label":"Closes","type":"datetime","helpText":"Leave empty to keep it open.","ui":{"tab":{"id":"rules"}}},{"key":"voters","label":"Who can vote","type":"select","defaultValue":"anyone","config":{"options":[{"label":"Anyone","value":"anyone"},{"label":"Signed in","value":"members"},{"label":"Subscribers","value":"subscribers"}]},"ui":{"control":"segmented","tab":{"id":"rules"}}},{"key":"useOneVote","label":"One vote per reader","type":"boolean","defaultValue":true,"ui":{"tab":{"id":"rules"}}},{"key":"thankYou","label":"Thank-you line","type":"text","config":{"maxLength":100},"ui":{"tab":{"id":"rules"}}},{"key":"relatedStory","label":"Results story","type":"reference","helpText":"Linked under the results once it's published.","config":{"contentModelId":"col_journal"},"ui":{"tab":{"id":"rules"}}}],"description":"One question with live results","category":"Data & interactive","icon":"chart-bar-popular","preview":{"title":"question","subtitle":"type","icon":"chart-bar-popular"}}},
1488
+ {"id":"reader-poll","name":"Poll","category":"Data & interactive","kind":"block","tags":["form","conditional","repeater","validation","references"],"proves":"Question type switches options vs scale vs open answer · results visibility · close date · one vote per reader","why":"The answer type drives everything below it, so options, scale and the open-answer settings are mutually exclusive conditional branches of one `type` select. Rules (results visibility, close date, eligibility) are a separate tab because they change behavior, not copy. Votes are SUBMISSIONS — runtime data in Forms, never stored on the block — so the schema has no results fields at all.","htmlSignals":["A <form> with one question and radio/checkbox inputs, submitting via fetch, often with 'Vote' as the button","Results rendered as horizontal percentage bars after submit","'Poll closes …' text or a disabled state with 'Final results'","Third-party poll scripts (Crowdsignal, Typeform embed) — map those to the embed entry instead"],"mcp":"Question text → `question`; radio inputs → type single, checkboxes → multiple (+ maxPicks if a limit is stated), a range/star/NPS row → scale with min/max and end labels, textarea → open. Each option label (+ image) → `pollOption`. Never import vote counts. If the page has several questions in sequence, it's a SURVEY: create a form (Forms) with those fields and place a form block — do not nest questions in this poll block.","pitfalls":["SCHEMA GAP: cross-field rules (scale.min < scale.max, maxPicks ≤ number of options, closesAt in the future) can't be written as validation.","SCHEMA GAP: 'images on every option or none' is a whole-array rule; validation is per item.","SCHEMA GAP: no read-only, platform-computed fields — editors can't see live tallies inside the schema form; results live in another surface.","Multiple-question surveys modelled as nested arrays in a block become an unversioned form builder — use Forms."],"notCarried":["variants"],"component":{"name":"Poll","slug":"poll","props":[{"key":"question","label":"Question","type":"text","required":true,"ai":true,"config":{"maxLength":140},"ui":{"tab":{"id":"content","label":"Question"}}},{"key":"context","label":"Context","type":"longtext","recommendedMax":200,"ui":{"rows":2,"tab":{"id":"content"}}},{"key":"type","label":"Answer type","type":"select","defaultValue":"single","config":{"options":[{"label":"Pick one","value":"single","icon":"circle-dot"},{"label":"Pick several","value":"multiple","icon":"checkbox"},{"label":"Scale","value":"scale","icon":"adjustments-horizontal","description":"1 to 5, 0 to 10"},{"label":"Written answer","value":"open","icon":"message"}]},"ui":{"control":"cards","tab":{"id":"content"}}},{"key":"options","label":"Options","type":"table","showIf":{"match":"all","rules":[{"field":"type","op":"in","value":["single","multiple"]}]},"config":{"minItems":2,"maxItems":8,"fields":[{"key":"label","label":"Label","type":"text","required":true,"config":{"maxLength":60}},{"key":"image","label":"Image","type":"image"}]},"ui":{"itemLabel":"Option","itemName":"pollOption","icon":"circle-dot","preview":{"title":"label","media":"image","fallback":"Untitled option"},"tab":{"id":"content"}}},{"key":"maxPicks","label":"At most","type":"number","showIf":{"match":"all","rules":[{"field":"type","op":"eq","value":"multiple"}]},"config":{"min":2,"max":8,"step":1},"ui":{"tab":{"id":"content"}}},{"key":"allowOther","label":"\"Other\" with a text box","type":"boolean","showIf":{"match":"all","rules":[{"field":"type","op":"in","value":["single","multiple"]}]},"ui":{"tab":{"id":"content"}}},{"key":"scale","label":"Scale","type":"object","showIf":{"match":"all","rules":[{"field":"type","op":"eq","value":"scale"}]},"openMode":"drill","config":{"fields":[{"key":"min","label":"From","type":"number","defaultValue":1,"config":{"min":0,"max":1,"step":1}},{"key":"max","label":"To","type":"number","defaultValue":5,"config":{"min":3,"max":10,"step":1}},{"key":"minLabel","label":"Low label","type":"text","placeholder":"Not at all","config":{"maxLength":24}},{"key":"maxLabel","label":"High label","type":"text","placeholder":"Every day","config":{"maxLength":24}}]},"ui":{"icon":"adjustments-horizontal","tab":{"id":"content"}}},{"key":"placeholder","label":"Answer placeholder","type":"text","showIf":{"match":"all","rules":[{"field":"type","op":"eq","value":"open"}]},"config":{"maxLength":60},"ui":{"tab":{"id":"content"}}},{"key":"useModeration","label":"Review answers before showing them","type":"boolean","defaultValue":true,"showIf":{"match":"all","rules":[{"field":"type","op":"eq","value":"open"}]},"ui":{"tab":{"id":"content"}}},{"key":"showResults","label":"Show results","type":"select","defaultValue":"afterVote","config":{"options":[{"label":"After someone votes","value":"afterVote"},{"label":"When the poll closes","value":"afterClose"},{"label":"Never","value":"never","description":"Results stay in Forms › Submissions"}]},"ui":{"control":"radio","tab":{"id":"rules","label":"Rules"}}},{"key":"closesAt","label":"Closes","type":"datetime","helpText":"Leave empty to keep it open.","ui":{"tab":{"id":"rules"}}},{"key":"voters","label":"Who can vote","type":"select","defaultValue":"anyone","config":{"options":[{"label":"Anyone","value":"anyone"},{"label":"Signed in","value":"members"},{"label":"Subscribers","value":"subscribers"}]},"ui":{"control":"segmented","tab":{"id":"rules"}}},{"key":"useOneVote","label":"One vote per reader","type":"boolean","defaultValue":true,"ui":{"tab":{"id":"rules"}}},{"key":"thankYou","label":"Thank-you line","type":"text","config":{"maxLength":100},"ui":{"tab":{"id":"rules"}}},{"key":"relatedStory","label":"Results story","type":"reference","helpText":"Linked under the results once it's published.","config":{"contentModelId":"col_journal"},"ui":{"tab":{"id":"rules"}}},{"key":"form","label":"Form","type":"form","helpText":"Votes become this form's submissions. Vote stays off until one is picked.","ui":{"tab":{"id":"rules"}}}],"description":"One question with live results","category":"Data & interactive","icon":"chart-bar-popular","preview":{"title":"question","subtitle":"type","icon":"chart-bar-popular"}}},
1489
1489
  {"id":"safe-embed","name":"Embed (iframe, HTML, script)","category":"Data & interactive","kind":"block","tags":["embed","conditional","a11y","validation"],"proves":"Kind switches URL vs code · sandbox + permissions developer-locked · consent placeholder · required iframe title","why":"Embeds are the only block that runs someone else's code, so security choices (sandbox, permissions, raw HTML, script URLs) are a developer-locked tab and content choices (title, size, caption, fallback) stay editable. The kind select makes URL vs code branches exclusive. Consent is a drill-in object with its own conditionals: a block can stay compliant per embed instead of relying on a site-wide script blocker. The iframe title is required — without it the frame is unlabelled for screen readers.","htmlSignals":["<iframe> with src on a third-party domain (stackblitz, codepen, figma, calendly, typeform, airtable, google maps)","<script src> to a widget host next to a placeholder <div id=…> (Calendly, HubSpot forms, Intercom)","<blockquote class=\"twitter-tweet|instagram-media\"> + a platform script (oEmbed providers)","Consent wrappers: data-cookieconsent, data-category, class=\"cmplz-placeholder\", 'Load content' buttons"],"mcp":"<iframe> → kind iframe: copy src (force https), title (if missing, write one from the provider + context — required), width/height → size (aspect if responsive wrapper padding-top %, else fixed px), sandbox and allow attributes → sandbox/permissions verbatim. Known oEmbed URLs (YouTube, Vimeo, Figma, CodePen, Tweets) → kind oembed with the canonical URL; video specifically → prefer the video block. Script widgets → kind script with the src; the inline config goes into `html` only if it's static. Never migrate tracking pixels, analytics tags or chat widgets as embeds — they belong to site settings (scripts). If a consent wrapper exists, map its category and text to `consent`.","pitfalls":["SCHEMA GAP: no host allowlist validation — `pattern` checks https only; a real policy (allowed domains per site, CSP frame-src sync) has no schema expression.","SCHEMA GAP: `readOnly: \"developer\"` locks whole fields; there's no 'marketers can REMOVE a sandbox flag but not ADD one' (monotonic permissions).","SCHEMA GAP: the code field has no language setting in the schema (`html` vs `js`), so the editor guesses; see code-snippet-tabs.","oEmbed providers change markup; store the URL, never the provider's HTML snapshot.","allow-scripts + allow-same-origin on a same-origin URL removes the sandbox entirely — the help warns, nothing blocks it."],"notCarried":["variants"],"component":{"name":"Embed","slug":"embed","props":[{"key":"title","label":"Title","type":"text","helpText":"Not shown. Read by screen readers.","required":true,"config":{"maxLength":80},"ui":{"tab":{"id":"content","label":"Content"}}},{"key":"kind","label":"Type","type":"select","defaultValue":"iframe","config":{"options":[{"label":"Page in a frame","value":"iframe","icon":"app-window","description":"Paste the embed URL"},{"label":"Link preview","value":"oembed","icon":"link","description":"YouTube, Figma, CodePen…"},{"label":"HTML","value":"html","icon":"code","description":"Snippet from a provider"},{"label":"Script","value":"script","icon":"file-code","description":"A widget loaded from a URL"}]},"ui":{"control":"cards","tab":{"id":"content"}}},{"key":"url","label":"Embed URL","type":"url","required":true,"showIf":{"match":"all","rules":[{"field":"kind","op":"in","value":["iframe","oembed"]}]},"config":{"pattern":"^https://","patternMessage":"Use an https:// address, like https://your-site.com/embed."},"ui":{"tab":{"id":"content"}}},{"key":"html","label":"HTML","type":"code","required":true,"showIf":{"match":"all","rules":[{"field":"kind","op":"eq","value":"html"}]},"readOnly":"developer","lockReason":"Raw HTML runs on your site. A developer reviews it.","ui":{"access":{"edit":"schema.manage"},"tab":{"id":"content"}}},{"key":"scriptSrc","label":"Script URL","type":"url","required":true,"showIf":{"match":"all","rules":[{"field":"kind","op":"eq","value":"script"}]},"readOnly":"developer","lockReason":"Scripts run with full access to the page. A developer reviews them.","config":{"pattern":"^https://","patternMessage":"Use an https:// script, like https://your-site.com/widget.js."},"ui":{"access":{"edit":"schema.manage"},"tab":{"id":"content"}}},{"key":"size","label":"Size","type":"object","config":{"fields":[{"key":"ratio","label":"Shape","type":"select","defaultValue":"16:9","options":[{"label":"16:9","value":"16:9"},{"label":"4:3","value":"4:3"},{"label":"1:1","value":"1:1"},{"label":"Fixed","value":"fixed"}],"ui":{"control":"segmented"}},{"key":"height","label":"Height","type":"number","showIf":{"match":"all","rules":[{"field":"ratio","op":"eq","value":"fixed"}]},"config":{"unit":"px","min":120,"max":1200,"step":10}}]},"ui":{"icon":"aspect-ratio","tab":{"id":"content"}}},{"key":"caption","label":"Caption","type":"text","config":{"maxLength":140},"ui":{"tab":{"id":"content"}}},{"key":"fallback","label":"Fallback text","type":"longtext","helpText":"Shown if the embed can't load or consent is declined.","ui":{"rows":2,"tab":{"id":"content"}}},{"key":"sandbox","label":"Allow inside the frame","type":"multiselect","defaultValue":["allow-scripts","allow-same-origin"],"showIf":{"match":"all","rules":[{"field":"kind","op":"in","value":["iframe","oembed"]}]},"readOnly":"developer","lockReason":"Loosening the sandbox is a security decision.","config":{"options":[{"label":"Scripts","value":"allow-scripts"},{"label":"Same origin (cookies, storage)","value":"allow-same-origin"},{"label":"Forms","value":"allow-forms"},{"label":"Pop-ups","value":"allow-popups"},{"label":"Pop-ups without the sandbox","value":"allow-popups-to-escape-sandbox"},{"label":"Downloads","value":"allow-downloads"},{"label":"Presentation","value":"allow-presentation"}]},"ui":{"access":{"view":"schema.view","edit":"schema.manage"},"tab":{"id":"security","label":"Security","icon":"shield-lock"}}},{"key":"permissions","label":"Browser features","type":"multiselect","showIf":{"match":"all","rules":[{"field":"kind","op":"in","value":["iframe","oembed"]}]},"config":{"options":[{"label":"Full screen","value":"fullscreen"},{"label":"Copy to clipboard","value":"clipboard-write"},{"label":"Autoplay","value":"autoplay"},{"label":"Camera","value":"camera"},{"label":"Microphone","value":"microphone"},{"label":"Payment","value":"payment"}]},"ui":{"access":{"view":"schema.view","edit":"schema.manage"},"tab":{"id":"security"}}},{"key":"useLazyLoad","label":"Load when scrolled near","type":"boolean","defaultValue":true,"ui":{"tab":{"id":"security"}}},{"key":"consent","label":"Consent","type":"object","openMode":"drill","config":{"fields":[{"key":"isRequired","label":"Ask first","type":"boolean","defaultValue":true},{"key":"category","label":"Cookie category","type":"select","defaultValue":"functional","showIf":{"match":"all","rules":[{"field":"isRequired","op":"eq","value":"true"}]},"options":[{"label":"Functional","value":"functional"},{"label":"Analytics","value":"analytics"},{"label":"Marketing","value":"marketing"}]},{"key":"provider","label":"Provider name","type":"text","required":true,"showIf":{"match":"all","rules":[{"field":"isRequired","op":"eq","value":"true"}]},"placeholder":"StackBlitz","config":{"maxLength":40}},{"key":"message","label":"Placeholder text","type":"longtext","showIf":{"match":"all","rules":[{"field":"isRequired","op":"eq","value":"true"}]},"config":{"maxLength":200},"ui":{"rows":2}},{"key":"privacyLink","label":"Provider's privacy policy","type":"link","showIf":{"match":"all","rules":[{"field":"isRequired","op":"eq","value":"true"}]}},{"key":"previewImage","label":"Placeholder image","type":"image","showIf":{"match":"all","rules":[{"field":"isRequired","op":"eq","value":"true"}]}}]},"ui":{"icon":"cookie","tab":{"id":"privacy","label":"Privacy","icon":"cookie"}}}],"description":"Third-party content in a safe frame, with a consent placeholder","category":"Data & interactive","icon":"frame","preview":{"title":"title","subtitle":"kind","icon":"code"}}},
1490
1490
  {"id":"code-snippet-tabs","name":"Code snippet with tabs","category":"Data & interactive","kind":"block","tags":["repeater","validation","conditional","embed"],"proves":"Tabs per language/package manager · line highlights by pattern · synced tab groups · optional runnable playground","why":"Each tab is one file in one language, so language and filename sit with the code; highlights are a validated range string because that's how authors think about lines. Package-manager tabs across a docs page should switch together — a sync group key, not a global setting. The playground is a conditional drill-in object: most snippets aren't runnable and shouldn't show its settings.","htmlSignals":["<pre><code class=\"language-ts\"> blocks (Prism, Shiki, highlight.js markup: span.token, data-line)","A tablist (role=\"tablist\") switching between <pre> panels labeled npm / pnpm / yarn / bun","Copy buttons (navigator.clipboard) and filename headers above the code","'Open in StackBlitz/CodeSandbox' buttons or forms posting to those hosts"],"mcp":"Each tab panel → `codeTab`: label from the tab button, language from the class (language-xxx / data-language), filename from the header, code from the TEXT content (strip highlighting spans, keep whitespace exactly, decode entities). Highlighted lines (data-line, .highlighted) → `highlight` as ranges. Tabs labeled with package managers → `syncGroup: package-manager`. A single <pre> with no tabs is still this block with one tab — unless it's inside a long-form article, where it belongs in the rich-text body as a code block.","pitfalls":["SCHEMA GAP: the `code` field type has no `language` (or filename / highlightedLines) option in the schema; the control lets the user pick HTML/CSS/JS/Liquid only. Languages like Shell, TS, Python, Go need a schema-level `code: { language, languages[] }` setting.","SCHEMA GAP: tab labels should be unique within a snippet; `unique` isn't enforced.","Highlight ranges aren't checked against the code's line count.","Never store highlighted HTML (token spans) — store plain text and highlight at render."],"notCarried":["variants"],"component":{"name":"Code snippet","slug":"code-snippet","props":[{"key":"heading","label":"Heading","type":"text","recommendedMax":60,"ui":{"tab":{"id":"content","label":"Content"}}},{"key":"intro","label":"Intro","type":"longtext","ui":{"rows":2,"tab":{"id":"content"}}},{"key":"tabs","label":"Tabs","type":"table","config":{"minItems":1,"maxItems":6,"fields":[{"key":"label","label":"Tab label","type":"text","required":true,"placeholder":"npm","config":{"maxLength":16}},{"key":"language","label":"Language","type":"select","required":true,"options":[{"label":"Shell","value":"bash"},{"label":"TypeScript","value":"ts"},{"label":"JavaScript","value":"js"},{"label":"Python","value":"python"},{"label":"Go","value":"go"},{"label":"JSON","value":"json"},{"label":"HTML","value":"html"},{"label":"CSS","value":"css"}]},{"key":"filename","label":"File name","type":"text","config":{"maxLength":48,"pattern":"^[\\w./-]+$","patternMessage":"Use letters, numbers, dots, slashes and hyphens, like src/index.ts."}},{"key":"code","label":"Code","type":"code","required":true},{"key":"highlight","label":"Highlight lines","type":"text","placeholder":"3, 7-9","config":{"pattern":"^\\d+(-\\d+)?(,\\s*\\d+(-\\d+)?)*$","patternMessage":"Use line numbers and ranges, like 1, 4-6."}}]},"ui":{"itemLabel":"Tab","itemName":"codeTab","icon":"file-code","preview":{"title":"label","subtitle":"filename","fallback":"Untitled tab"},"tab":{"id":"content"}}},{"key":"syncGroup","label":"Sync group","type":"text","helpText":"Snippets with the same group switch tabs together.","advanced":true,"config":{"pattern":"^[a-z0-9-]+$","patternMessage":"Use lowercase letters, numbers and hyphens, like camp-kitchen."},"ui":{"tab":{"id":"behavior","label":"Behavior"}}},{"key":"showLineNumbers","label":"Show line numbers","type":"boolean","ui":{"tab":{"id":"behavior"}}},{"key":"showCopyButton","label":"Show copy button","type":"boolean","defaultValue":true,"ui":{"tab":{"id":"behavior"}}},{"key":"useLineWrap","label":"Wrap long lines","type":"boolean","ui":{"tab":{"id":"behavior"}}},{"key":"isRunnable","label":"Open in a playground","type":"boolean","ui":{"tab":{"id":"behavior"}}},{"key":"playground","label":"Playground","type":"object","showIf":{"match":"all","rules":[{"field":"isRunnable","op":"eq","value":"true"}]},"openMode":"drill","config":{"fields":[{"key":"provider","label":"Provider","type":"select","defaultValue":"stackblitz","options":[{"label":"StackBlitz","value":"stackblitz"},{"label":"CodeSandbox","value":"codesandbox"}],"ui":{"control":"segmented"}},{"key":"template","label":"Template","type":"select","defaultValue":"node","options":[{"label":"Node","value":"node"},{"label":"Vite + React","value":"vite-react"},{"label":"Next.js","value":"next"}]},{"key":"openFile","label":"Open file","type":"text","config":{"pattern":"^[\\w./-]+$","patternMessage":"Use a file path, like src/index.ts."}},{"key":"dependencies","label":"Dependencies","type":"array","helpText":"Package names to install, e.g. @northwind/sdk.","config":{"itemType":"text"},"ui":{"itemLabel":"Package","itemTitle":"Package"}}]},"ui":{"icon":"player-play","tab":{"id":"behavior"}}}],"description":"One snippet in several languages, with copy and run","category":"Data & interactive","icon":"terminal-2","preview":{"title":"heading","subtitle":"intro","icon":"terminal-2"}}},
1491
1491
  {"id":"page-builder-six-deep","name":"Page builder, six levels deep","category":"Advanced patterns","kind":"block","tags":["deep-nesting","slots","repeater","variants","media-heavy"],"proves":"Guide › Tab › Columns › Column › Accordion › Item › Card › Button — slots inside arrays inside slots · breadcrumb folding + Pathway","why":"Real page builders alternate between ARRAYS (items the section owns: tabs, columns, accordion items) and SLOTS (any block from the library: columns, accordion, text, image). Each slot is a seam where the content stops belonging to this section and becomes a reusable block with its own schema and variants; each array is where content is specific to its parent. The card is an object (always one per item), the button is the one-unit button screen. Depth is legal here because every level is a different KIND of thing with its own preview row — drill-in keeps each frame small.","htmlSignals":["role=\"tablist\" with role=\"tabpanel\" siblings, each panel holding a CSS grid/flex row of columns","<details>/<summary> or buttons with aria-expanded inside a column","Expanded panels containing a card (image + heading + paragraph + link/button)","Repeated structural wrappers (.row > .col > .accordion > .item > .card) 5+ levels deep"],"mcp":"Measure depth by counting CONTENT boundaries, not DOM nodes: each element that repeats siblings of the same shape (tabs, columns, items) is an array level; each element whose inner structure differs from its siblings (a column holding an accordion next to a column holding an image) is a slot level. Wrappers that only add spacing/grid are design, not levels. Model arrays for same-shaped siblings and slots where siblings differ. Rules: (1) up to 6 content levels → one section, as here; (2) if any slot child is used on more than one page, extract it as a block (D17) and place it as a linked instance; (3) if depth would exceed 6, or a level has more than ~10 children, split the deepest repeated subtree into its own block (e.g. the accordion becomes a standalone FAQ block referenced from the column); (4) never make a column an array item AND a slot at the same time. Paths: emit _key on every array item and slot child so drill-in paths stay stable across reorders.","pitfalls":["SCHEMA GAP: a TypeSchema can't declare its own nested block types — slot `allow` names blocks from a global registry, so a converted section that introduces Columns/Accordion must also register them (handled here via the new optional KitEntry.blocks; production needs a schema-level `blocks` or a registry write).","SCHEMA GAP: no per-slot depth limit — nothing stops an author nesting Columns inside Columns inside an Accordion card forever. Needs `maxDepth` or 'cannot contain itself' on slot fields.","SCHEMA GAP: fieldsets and groups exist only at the TypeSchema root; array item objects (Tab, Column, Item) can't group their own fields.","Breadcrumb at 7 drills (Guide / Seasoning / Steps and kit / Steps / Season over fire… / Heat it upside down / Card / Button) must fold into the Pathway chip on a 380px inspector — this entry is the test case.","Accordion item cards inside a 1/3 column are cramped; that's a variant decision, not a field."],"notCarried":["variants"],"component":{"name":"Guide","slug":"guide-section","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","recommendedMax":180,"ui":{"rows":2,"tab":{"id":"content"}}},{"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,"minItems":1,"maxItems":6,"allow":["layoutColumns","accordionBlock","textBlock","imageBlock","videoBlock","ctaCard"]}}]},"ui":{"itemLabel":"Tab","itemName":"guideTab","icon":"layout-list","preview":{"title":"label","fallback":"Untitled tab"},"tab":{"id":"content"}}},{"key":"theme","label":"Theme","type":"select","defaultValue":"light","config":{"options":[{"label":"Light","value":"light"},{"label":"Warm","value":"warm"},{"label":"Dark","value":"dark"}]},"ui":{"control":"segmented","tab":{"id":"design","label":"Design"}}},{"key":"anchor","label":"Anchor","type":"text","advanced":true,"config":{"pattern":"^[a-z][a-z0-9-]*$","patternMessage":"Use lowercase letters, numbers and hyphens, starting with a letter, like grate-xl."},"ui":{"tab":{"id":"design"}}}],"description":"Tabbed guide: each tab holds columns, accordions and cards","category":"Long-form & docs","icon":"book-2","preview":{"title":"heading","subtitle":"eyebrow"}}},
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@bettercms-ai/kit",
3
- "version": "3.1.22",
3
+ "version": "3.1.23",
4
4
  "description": "The BetterCMS V2 Block Kit: schema language, form engine, controls and design tokens.",
5
5
  "license": "MIT",
6
6
  "type": "module",