@bettercms-ai/mcp 0.72.2 → 0.73.1

package/dist/index.js

@@ -2989,6 +2989,7 @@ var PARAM_TEXT = {
   recommendedMax: "a SOFT limit (characters, items or value): the editor warns past it, never refuses",
   openMode: "object/array/group/repeater: how the value (or each row) opens: 'inline', 'drill', 'popover' or 'dialog'",
   fromBuiltin: "a builtin:* id from list_components: copies it into the project; fields you send win",
+  componentPreview: "how ONE instance reads as a ROW in a parent's slot list (a /kit schema's document-level `preview`): {title?, subtitle?, media?} each a TOP-LEVEL prop key (422 preview_key_unknown otherwise), fallback? a literal row label (\u2264120), icon? a dock icon name. null clears it",
   describes: "for editors: what it is and holds; omitted: written for you",
   runtimeBundle: "instead of pageId: the server-app bundle cleanup",
   pageRef: "page id or path ('/de/about'); a bare slug only when one page has it",
@@ -3034,7 +3035,7 @@ var DETACHED_COPY_NOTE = "{overrides?}: a rich-text embed's separate-copy `field
 var UNPROPPED_COPY_NOTE = "A `warnings` entry UNPROPPED_COPY names copy no prop targets, which nobody can edit: add a prop with a `target` for each leaf it lists.";
 var UPDATE_PAGE_IF_MATCH_NOTE = "get_page's `optimisticVersion`: the write applies only at that version, and a 409 means the page changed since, so read it again. Send it whenever you pass blockJson, which REPLACES the whole composition.";
 var SLOT_MULTIPLE_NOTE = "'slot' with config.multiple holds a list [{componentId, overrides?}] (config.maxItems, default 12, at most 50): target.path 'props.children' on a section. V2 slots, 'table' mode 'types': playbook \xA75.";
-var PROP_V2_NOTE = "Props take the fields' V2 keys (\xA714): 'object' = ONE {child: value} from config.fields, \u226410 levels (field_depth_exceeded); datetime|slug|email|phone|json|location|tags|rating|code|reference|multi-reference as that field (a reference names contentModelId, or polymorphic + allowedModelSlugs; page reads hydrate its entries); helpMore, advanced, recommendedMax, openMode, config.scale, ui.layout rows|chips|gallery, ui.preview.fallback, showIf notEmpty|empty.";
+var PROP_V2_NOTE = "Props take the fields' V2 keys (\xA714): 'object' = ONE {child: value} from config.fields, \u226410 levels (field_depth_exceeded); datetime|slug|email|phone|json|location|tags|rating|code|reference|multi-reference as that field (a reference names contentModelId, or polymorphic + allowedModelSlugs; page reads hydrate its entries); helpMore, advanced, recommendedMax, openMode, config.scale, ui.layout rows|chips|gallery, ui.preview.fallback, showIf notEmpty|empty. Send helpText: null for a prop whose /kit schema has no description (omitted, the platform writes one).";
 var LAYOUT_LOCK_NOTE = "A Global field with `overridable:false` + `lockReason` (add-field `field`, update-field `patch`) refuses page overrides (LAYOUT_FIELD_NOT_OVERRIDABLE); get_layout scope page lists stored ones as `shadowed`.";
 
 // src/entry-query.ts
@@ -3265,7 +3266,13 @@ var propUiObject = uiObject.extend({
     collapsible: z.boolean().optional(),
     layout: z.enum(["stack", "breakpoints"]).optional(),
     order: z.number().int().min(0).max(99).optional()
-  }).optional().describe("the group this prop (or sub-field) sits in. The FIRST member defines {id, label, kind?, icon?, collapsed?, description?, columns?, collapsible?, layout?, order?}; later ones send only {id}.")
+  }).optional().describe("the group this prop (or sub-field) sits in. The FIRST member defines {id, label, kind?, icon?, collapsed?, description?, columns?, collapsible?, layout?, order?}; later ones send only {id}."),
+  tab: z.strictObject({
+    id: z.string().min(1).max(40),
+    label: z.string().min(1).max(40).optional(),
+    icon: uiObject.shape.icon,
+    order: z.number().int().min(0).max(99).optional()
+  }).optional().describe("TOP-LEVEL props only: the dock tab this prop sits in (a V2 kit schema `groups` entry: Content, Design, \u2026). The FIRST prop in a tab defines {id, label, icon?, order?}; later ones send only {id}. \u22648 tabs, labels \u226440 chars and unique; a group's members share one tab.")
 });
 var choiceOption = z.union([z.string(), z.object({ label: z.string(), value: z.string(), icon: z.string().optional(), description: z.string().optional() })]);
 var fieldShape = {
@@ -3284,7 +3291,7 @@ var fieldShape = {
     "choices when type is 'select'. A plain string, or {label, value, icon?, description?} when the stored value differs from what the editor shows (e.g. {label:'Sold out', value:'soldOut'}); icon a dock name, description one line \u2264140."
   ),
   config: z.record(z.string(), z.unknown()).optional().describe(
-    "per-type config: reference {contentModelId}, multi-reference {contentModelId,min,max}, array {itemType: text|number|date|image|link|richtext}, date {includeTime, timezone}, modular|slot {blockSlugs: ['quote','gallery'], minItems?, maxItems?} (slot: playbook \xA75) \u2014 blockSlugs is REQUIRED, non-empty, and each slug must name an existing kind:'block' model; richtext {inline:true, hostTag:'h2', accept:['h2','p','b','i','u','link'], features:['bold','italic','underline','link','headings'], allowMultipleParagraphs:false} \u2014 for a field bound to ONE element on the page: `hostTag` is that element's tag and `accept` must name it, so the editor's block-style control opens already showing 'Heading 2' instead of 'Paragraph'. Name exactly ONE heading level: publish refuses an <h3> value bound to an <h2> rather than nesting one heading inside the other. Keep 'p' in `accept` or the sanitiser strips a block demoted to Paragraph; limits: text/longtext {minLength,maxLength,pattern,patternMessage}, richtext {minLength,maxLength}, number {validation:{min,max}}, array {minItems,maxItems}, tags {min,max}, rating {min,max,step}"
+    "per-type config: reference {contentModelId}, multi-reference {contentModelId,min,max}, repeater {minItems, maxItems} (the list's item limits; the editor shows 'max N' and stops Add there), array {itemType: text|number|date|image|link|richtext}, date {includeTime, timezone}, modular|slot {blockSlugs: ['quote','gallery'], minItems?, maxItems?} (slot: playbook \xA75) \u2014 blockSlugs is REQUIRED, non-empty, and each slug must name an existing kind:'block' model; richtext {inline:true, hostTag:'h2', accept:['h2','p','b','i','u','link'], features:['bold','italic','underline','link','headings'], allowMultipleParagraphs:false} \u2014 for a field bound to ONE element on the page: `hostTag` is that element's tag and `accept` must name it, so the editor's block-style control opens already showing 'Heading 2' instead of 'Paragraph'. Name exactly ONE heading level: publish refuses an <h3> value bound to an <h2> rather than nesting one heading inside the other. Keep 'p' in `accept` or the sanitiser strips a block demoted to Paragraph; limits: text/longtext {minLength,maxLength,pattern,patternMessage}, richtext {minLength,maxLength}, number {validation:{min,max}}, array {minItems,maxItems}, tags {min,max}, rating {min,max,step}"
   ),
   fields: z.array(z.lazy(() => fieldObject)).optional().describe(
     "NESTED child fields \u2014 REQUIRED for type 'group' (one nested object, a Non-Repeatable Zone like blog_hero \u2192 heading, description, hero_image) and type 'repeater' (a repeatable array of such objects, a Repeatable Zone / section-list like testimonials \u2192 quote, author). A section with repeating items is a 'repeater'; a fixed grouped block is a 'group'. Recurse to any depth \u2014 do NOT flatten zones into separate top-level fields."
@@ -3455,7 +3462,8 @@ function toField(f) {
     return { ...base, type: "array", config: { zones: { nonRepeatable: toFields(f.fields) } } };
   }
   if (f.type === "repeater") {
-    return { ...base, type: "array", config: { zones: { repeatable: { fields: toFields(f.fields) } } } };
+    const { minItems, maxItems } = f.config ?? {};
+    return { ...base, type: "array", config: { zones: { repeatable: { fields: toFields(f.fields), ...minItems !== void 0 ? { minItems } : {}, ...maxItems !== void 0 ? { maxItems } : {} } } } };
   }
   if (f.type === "array" && f.config && typeof f.config === "object" && "zones" in f.config) {
     const zones = f.config.zones ?? {};
@@ -3488,8 +3496,8 @@ var UPDATE_MODEL_DESCRIPTION = "Edit a content model: rename it, change descript
 var FIELD_REMOVAL_NOTE = "top-level field keys (from get_content_model) to DELETE from this model with every entry's value for them; needs allowFieldRemoval: true. An unknown key refuses the whole call. Never for a rename: rename the label instead.";
 var ALLOW_FIELD_REMOVAL_NOTE = "true = the user accepts that removeFields discards those fields' data in every entry. There is no dry run on this route: confirm first.";
 var MODEL_IF_MATCH_NOTE = "optimisticVersion from get_content_model (with pageId: get_page backingModel). The write applies only at that version; a 409 version-conflict means it changed since: read it again and re-apply, never retry blindly. REQUIRED with field*, override or a fieldset kind/tab/icon/collapsed (428 without); otherwise, omitted, the last write wins.";
-var COMPONENT_IF_MATCH_NOTE = "optimisticVersion from get_component. The write applies only at that version; a 409 version-conflict means it changed since: read it again and re-apply. REQUIRED with prop*, override or a prop ui icon/itemLabel/group (428 without).";
-var PROP_UI_ARG_NOTE = "top-level prop key \u2192 ui patch, the same vocabulary as a prop's `ui`: each key merges, a null key clears it, null clears the whole ui";
+var COMPONENT_IF_MATCH_NOTE = "optimisticVersion from get_component. The write applies only at that version; a 409 version-conflict means it changed since: read it again and re-apply. REQUIRED with prop*, override or a prop ui icon/itemLabel/group/tab (428 without).";
+var PROP_UI_ARG_NOTE = "top-level prop key \u2192 ui patch, the same vocabulary as a prop's `ui` (group and tab included): each key merges, a null key clears it, null clears the whole ui. Patches keep every other prop as stored; sending `props` instead REPLACES the whole array, so echo each prop's stored `ui` (its `ui.group` AND `ui.tab`) or the prop leaves its tab";
 var OVERRIDE_NOTE = "replace chrome a person set (otherwise 409 ui_human_owned names those paths). Send it only on the user's word.";
 var FIELD_UI_ARG_NOTE = "path \u2192 ui patch, a field's `ui` vocabulary: each key merges, a null key clears it, null clears the whole ui";
 var MODEL_UPDATE_KEYS = [
@@ -3657,7 +3665,7 @@ var withProjectId = (def) => ({
     return currentProject.run(arg("projectId"), () => currentBranch.run(arg("branchId"), () => def.handler(args)));
   }
 });
-var autoHelpNote = (args) => typeof args.helpText === "string" && args.helpText.trim() ? "" : " No helpText was sent, so the platform wrote it (helpSource: auto); send helpText with update_field to write your own.";
+var autoHelpNote = (args) => args.helpText === null || typeof args.helpText === "string" && args.helpText.trim() ? "" : " No helpText was sent, so the platform wrote it (helpSource: auto); send helpText with update_field to write your own.";
 function buildToolDefs(deps) {
   async function withClient(fn) {
     const token = await deps.auth.getAccessToken();
@@ -3964,6 +3972,7 @@ function buildToolDefs(deps) {
       // 'select' — required, choices
       // 'group'/'table'/'object' sub-shape. Typed loosely here (the server validates the full
       // recursive shape, 10 levels at most) so a deep tree needs no Zod mirror in the client.
+      // A sub-field may be a 'slot' (its value at its key in the object or row), with the slot keys above.
       fields: z.array(z.record(z.string(), z.unknown())).optional(),
       min: z.number().optional(),
       // 'number'
@@ -3975,7 +3984,7 @@ function buildToolDefs(deps) {
     // override that omits it still saves — so it is a marker the dashboard renders and
     // get_site_composition counts, never a refusal. Parity: componentPropDefSchema on the server.
     required: z.boolean().optional().describe("mark the field required in the editor. An editor HINT: the API still accepts a placement that leaves it empty, and get_site_composition is what reports one."),
-    helpText: z.string().max(200).optional().describe("hint shown under the control, muted (\u2264 200 chars)"),
+    helpText: z.string().max(200).nullable().optional().describe("hint shown under the control, muted (\u2264 200 chars). null = no help on purpose (a /kit schema with no description); omitted = the platform writes it"),
     placeholder: z.string().max(120).optional().describe("ghost text inside a text-ish control (\u2264 120 chars)"),
     // Stored markers on a prop: nothing refuses a prop value for them. Declared so an echo keeps them.
     readOnly: z.union([z.literal(true), z.literal("developer")]).optional(),
@@ -4064,6 +4073,13 @@ function buildToolDefs(deps) {
     "section family, e.g. 'Hero' \u2014 set this with a library category to make the component selectable in the page editor's 'Add a section' picker. Components sharing one are layout variants of one section."
   );
   const allowedOn = z.array(z.string().regex(/^(\*|slug:[a-z0-9-]+|type:(singleton|dynamic|template))$/)).max(100).describe("placement allowlist: *, slug:<page-slug>, and/or type:singleton|dynamic|template");
+  const componentPreviewArg = z.strictObject({
+    title: z.string().min(1).max(64).optional(),
+    subtitle: z.string().min(1).max(64).optional(),
+    media: z.string().min(1).max(64).optional(),
+    fallback: z.string().min(1).max(120).optional(),
+    icon: dockIconArg.optional()
+  }).nullable().describe(PARAM_TEXT.componentPreview);
   const createComponentInput = z.object({
     name: z.string().min(1),
     slug: slug.describe("url-safe unique slug (lowercase letters/numbers/hyphens)"),
@@ -4075,6 +4091,7 @@ function buildToolDefs(deps) {
     projectId: z.string().nullable().optional().describe("owning project id; null creates a workspace-wide global component"),
     allowedOn: allowedOn.optional(),
     description: z.string().optional().describe(PARAM_TEXT.describes),
+    preview: componentPreviewArg.optional(),
     blockJson: z.array(blockObject).default([]).describe("the component's block tree"),
     props: z.array(componentPropObject).default([]).describe(
       "overridable fields. DECLARE A PROP \u2014 WITH A `target` \u2014 for every string, link and image a marketer will ever touch: only the leaves a prop targets are click-to-edit. Each one may carry `ui` to say how its control presents in the inspector \u2014 a collapsed group, what titles and thumbnails a table's rows, whether that table's rows can be dragged at all. 'button' is ONE unit {label, href, variant?, size?, arrow?, icon?, newTab?} on a button block's 'props', never a text prop plus a url prop. 'link' an href, 'date' YYYY-MM-DD, 'color' a hex, 'file' {url, name?}, 'icon' an icon name or an image, 'multiselect' a string[] from config.options (required). " + SLOT_MULTIPLE_NOTE + " " + PROP_V2_NOTE
@@ -4091,14 +4108,16 @@ function buildToolDefs(deps) {
     variantOf: z.string().min(1).max(255).optional().describe("see create_component"),
     allowedOn: allowedOn.optional().describe("REPLACES the placement allowlist"),
     description: z.string().optional(),
+    preview: componentPreviewArg.optional(),
     blockJson: z.array(blockObject).optional().describe("REPLACES the block tree"),
     props: z.array(componentPropObject).optional().describe(
       "REPLACES the prop array \u2014 include every prop you want to keep, WITH its stored `ui`, or that prop's authoring chrome is dropped along with the prop. Read get_component first."
     ),
     propUi: z.record(z.string(), z.record(z.string(), z.unknown()).nullable()).optional().describe(PROP_UI_ARG_NOTE),
     propGroup: z.record(z.string(), z.record(z.string(), z.unknown()).nullable()).optional().describe("prop key \u2192 its ui.group ({id, label?, kind?, icon?, collapsed?}), null takes it out"),
+    propTab: z.record(z.string(), z.record(z.string(), z.unknown()).nullable()).optional().describe("prop key \u2192 its ui.tab ({id, label?, icon?, order?}), the V2 schema group it sits in. The FIRST top-level prop in a tab defines {id, label, icon?, order?}, later ones send {id}; \u22648 tabs; one group's members share one tab. null takes it out"),
     propLabel: z.record(z.string(), z.string().min(1).max(255)).optional().describe("prop key \u2192 label"),
-    propHelpText: z.record(z.string(), z.string().max(200).nullable()).optional().describe("prop key \u2192 help text, null clears it"),
+    propHelpText: z.record(z.string(), z.string().max(200).nullable()).optional().describe("prop key \u2192 help text; null = no help on purpose (stays empty, never refilled)"),
     override: z.boolean().optional().describe(OVERRIDE_NOTE),
     ifMatch: z.number().int().min(0).optional().describe(COMPONENT_IF_MATCH_NOTE),
     confirmed: z.boolean().optional().describe(PARAM_TEXT.confirmedInput)
@@ -6521,8 +6540,11 @@ Then declare what an editor may change, via \`props\`:
     ]
 
 Each prop also takes \`required\`, \`helpText\` (\u2264 200 chars) and \`placeholder\` (\u2264 120), which the
-dashboard's prop editor renders. They are HINTS: nothing on the write path refuses a placement
+dashboard's prop editor renders. \`helpText\` is three-state: a string is yours, \`null\` is no help on
+purpose (send it for a prop whose /kit schema has no description; nothing refills it), and omitted
+lets the platform write one. They are HINTS: nothing on the write path refuses a placement
 that leaves a required prop empty, so \`get_site_composition\` is what reports one.
+A /kit schema's document-level \`preview\` \u2192 the component's \`preview\` ({title?, subtitle?, media?} are top-level prop keys, plus \`fallback?\`, \`icon?\`); slot rows read it.
 
 \u{1F534} **On a components-first page, \`props\` is the ONLY editing surface.** Click-to-edit binds
 \`heading\`/\`text\`/\`button\`/\`image\` blocks; it does **not** bind a \`component\` block, because
@@ -6574,7 +6596,12 @@ A \`slot\` field (V2 blocks inside a block) takes the same \`config.blockSlugs\`
 but stores each child INLINE: \`[{ _key, _type: '<block slug>', _variant?, _settings?, ...values }]\`,
 its values judged by its block's fields. A component's \`slot\` prop with \`config.multiple\`
 takes the same child shape with \`_type\` the COMPONENT id (no \`_variant\`: a variant is its own
-component). A list of several item shapes on a component is a \`table\` prop with
+component). A \`slot\` may also be a SUB-FIELD: inside a \`group\` / \`object\` prop's
+\`config.fields\` or a \`table\` row (an item type's \`fields\` too), with the slot prop's
+config keys (\`componentIds\`, \`multiple\`, \`minItems\`/\`maxItems\`, \`slotSettings\`). Its value
+sits at its key in the object or row, \`{ componentId, overrides? }\` or a list with
+\`config.multiple\`, judged like a slot prop's: the same allowlist, depth cap and cycle refusal.
+A list of several item shapes on a component is a \`table\` prop with
 \`config.mode: 'types'\` and \`config.itemTypes: [{ name, label?, fields }]\`, rows
 \`[{ _key?, _type: '<name>', ...values }]\`.
 
@@ -7030,8 +7057,10 @@ hints the dashboard renders \u2014 they are NOT enforced at write time, so an ov
 required prop still saves; \`get_site_composition\` is what reports those. Use \`select\` with
 \`config.options\` for layout / theme / alignment / spacing variants that change only styling,
 and a SEPARATE variant component when the markup differs. Repeatable list \u2192 \`table\`; fixed
-cluster \u2192 \`group\`. Nesting is capped at TWO levels from the prop (a \`table\` row may hold a
-\`table\`, and that inner row is scalars only). Flatten anything deeper.
+cluster \u2192 \`group\`. Nesting goes up to 10 levels counting the prop itself. A \`table\` row may hold a
+\`table\` (rows), a data table (\`config.mode: "data"\`) or a polymorphic list
+(\`config.mode: "types"\`), so a size guide's rows can each carry a chart and a multi-step
+form's steps can each carry their fields. Deeper is refused (\`field_depth_exceeded\`).
 
 **5. Design, responsiveness and accessibility.** \`componentize_sections\` and \`npx
 @bettercms-ai/convert --componentize\` move the section's markup VERBATIM \u2014 classes, responsive
@@ -7396,8 +7425,13 @@ them \u2014 except on a \`slot\`, whose children belong to whichever component f
 cannot be resolved at save time. \`update_component\` REPLACES the whole \`props\` array, so echo
 back each prop's stored \`ui\` or you delete it along with the prop. Props have no fieldsets, so a
 prop joins a group with \`ui.group\`: the FIRST prop of a group defines \`{ id, label, kind?, icon?,
-collapsed? }\` (kind \`group\` or \`row\`, never \`tab\`), and every later prop sends \`{ id }\` only. A
-FIELD never takes \`ui.group\`; it joins a fieldset with \`fieldsetId\`.
+collapsed? }\` (kind \`group\` or \`row\`; a tab is \`ui.tab\`, never a group kind), and every later prop
+sends \`{ id }\` only. A prop joins a TAB with \`ui.tab\` the same way: the FIRST top-level prop in a tab
+defines \`{ id, label, icon?, order? }\`, later props send \`{ id }\`; at most 8 tabs, labels \u226440 characters
+and unique; top-level props only (never a sub-field); all members of one \`ui.group\` share one tab. A V2
+kit entry's schema \`groups\` and each field's \`group\` map 1:1 to \`ui.tab\`, so its \`design\` group is a
+tab named Design holding the theme, sticky and similar props. A FIELD never takes \`ui.group\` or
+\`ui.tab\`; it joins a fieldset with \`fieldsetId\`.
 
 \`\`\`jsonc
 { "key": "slides", "label": "Slides", "type": "table",
@@ -7466,13 +7500,13 @@ Importance orders a screen: required fields first, then array order.
 | A star rating | \`type: 'rating'\`: a number from 0 to \`config.max\` (5), \`config.step\` 1 or 0.5 (\`rating_value_invalid\`) |
 | A code snippet | \`type: 'code'\`: \`{ language?, code }\` or a string; \`config.language\` default, \`config.languages\` allowlist (\`code_value_invalid\`) |
 | "Add question" instead of "Add item" | \`ui.itemLabel: 'Question'\` (V2 \`itemNoun\`; there is no itemNoun key) |
-| The same section as a component (the dock edits a page section through its props) | the same keys on its \`props\`: \`type: 'object'\` with \`config.fields\` (\`group\` and \`table\` too, 10 levels), \`datetime\`, \`slug\`, \`email\`, \`phone\`, \`json\`, \`location\`, \`tags\`, \`rating\`, \`code\`, plus the two CMS-item types (\`reference\`, \`multi-reference\`: \`config.contentModelId\` or \`polymorphic\` + \`allowedModelSlugs\`; page reads hydrate them, a text slot shows the title), and every key above except fieldsets (props group with \`ui.group\`) |
+| The same section as a component (the dock edits a page section through its props) | the same keys on its \`props\`: \`type: 'object'\` with \`config.fields\` (\`group\` and \`table\` too, 10 levels), \`datetime\`, \`slug\`, \`email\`, \`phone\`, \`json\`, \`location\`, \`tags\`, \`rating\`, \`code\`, plus the two CMS-item types (\`reference\`, \`multi-reference\`: \`config.contentModelId\` or \`polymorphic\` + \`allowedModelSlugs\`; page reads hydrate them, a text slot shows the title), and every key above except fieldsets (props group with \`ui.group\` and tab with \`ui.tab\`) |
 
 An unknown \`openMode\` is refused with \`openMode_invalid\`, one on a leaf \`openMode_leaf\`; a bad \`config.scale\` with \`scale_invalid\`; more than 10 nested field levels with \`field_depth_exceeded\`. update_field sets and clears (null) helpMore, advanced, recommendedMax and openMode on an existing field.
 
 **Tabs.** A \`kind: 'tab'\` fieldset is a tab:
-- at most **3** tabs, names at most 20 characters and unique;
-- top-level fields only: tabs never nest and props never take them;
+- at most **3** tabs, names at most 40 characters and unique;
+- top-level fields only: tabs never nest (a component's props take tabs through \`ui.tab\`, its own rules);
 - untabbed fields stay PINNED above the strip;
 - a group or row fieldset joins a tab with \`tab: '<tab id>'\`; groups in a non-first tab default open;
 - with fewer than 2 non-empty tabs no strip renders, so a tab for one fieldset is noise.
@@ -7491,7 +7525,7 @@ An unknown \`openMode\` is refused with \`openMode_invalid\`, one on a leaf \`op
   \`fieldLabel\`, \`fieldHelpText\` (keyed by dotted key path, \`'hero.title'\`) and \`fieldsets\`. A page's
   schema: the same call with \`pageId\` instead of \`modelId\`, and the version from \`get_page\`'s
   \`backingModel\`.
-- A component's props: \`update_component\` with \`propUi\`, \`propGroup\`, \`propLabel\`, \`propHelpText\` (keyed by prop key).
+- A component's props: \`update_component\` with \`propUi\`, \`propGroup\`, \`propTab\`, \`propLabel\`, \`propHelpText\` (keyed by prop key).
   Name props from the code (\`plan.cents\` \u2192 Cents); help text guides ("Whole number, no currency symbol."), never repeats
   the value; repeated cards are one \`table\` prop. An icon (\`config.media: "icon"\`) is content: group it, never prune it.
   They write the DRAFT props; no publish is needed for the editor to show them.
@@ -7504,6 +7538,8 @@ An unknown \`openMode\` is refused with \`openMode_invalid\`, one on a leaf \`op
 - **409** \`ui_human_owned\` \u2014 a person shaped those paths. Leave them, or send \`override: true\`, and
   only when the user said so.
 - \`tab_unknown\`, \`tab_nested\`, \`tab_props\`, \`tab_max\`, \`tab_name\`, \`tab_depth\` \u2014 the tab rules above.
+- \`prop_tab_unknown\`, \`prop_tab_redefined\`, \`prop_group_split_tabs\` \u2014 a prop's \`ui.tab\` rules (\`tab_max\`,
+  \`tab_name\` and \`tab_nested\` too); \`tab_props\` is a \`ui.group\` with \`kind: 'tab'\` \u2014 use \`ui.tab\`.
 - \`fieldset_unknown\` / \`fieldset_orphan\` \u2014 a \`fieldsetId\` naming no fieldset, or a list that drops a
   fieldset its fields still name.
 - \`row_member_type\`, \`row_member_count\`, \`row_member_control\` \u2014 the row rule.
@@ -7629,7 +7665,7 @@ shape, then ask me, once and batched). Icon names are in bettercms://icons/dock.
    - fields that exist: \`update_content_model\` fieldUi / fieldFieldset / fieldOrder / fieldLabel /
      fieldHelpText by field path, plus \`fieldsets\`. A singleton page: send \`pageId\` instead of
      modelId, with its backingModel's version;
-   - component props: \`update_component\` propUi / propGroup / propLabel / propHelpText;
+   - component props: \`update_component\` propUi / propGroup / propTab / propLabel / propHelpText;
    - a NEW field: ui / helpText / showIf in the same \`add_field\` call, with \`after\`.
    A 409 \`ui_human_owned\` names chrome a person set: leave it, or ask me and send \`override: true\`
    only on my word.
@@ -7751,7 +7787,7 @@ Read \`bettercms://playbook/schema\` \xA712 first \u2014 this is the short form
 4. **Fields** = \`props\`: text, richtext, image, url, boolean, number, select, group, table, slot.
    Always a \`defaultValue\`; \`required\` / \`helpText\` / \`placeholder\` are editor hints, not write
    -time enforcement. \`select\` for styling-only variants, a separate component when the markup
-   differs. Nesting is capped at two levels \u2014 flatten anything deeper.
+   differs. Nesting goes up to 10 levels; a \`table\` row may hold a data table or a polymorphic list.
 5. **Quality.** The componentize lane and \`npx @bettercms-ai/convert --componentize\` move markup
    VERBATIM \u2014 classes, responsive utilities, aria attributes, alt text all survive. Never
    restyle. Dry-run first.