@bettercms-ai/mcp 0.59.2 → 0.60.0

package/dist/index.js

@@ -2268,15 +2268,19 @@ var uiObject = z.object({
   collapsed: z.boolean().optional().describe("start this panel collapsed. Use it for long optional sections."),
   preview: z.object({
     title: z.string().min(1).optional().describe("CHILD KEY whose value titles a collapsed row"),
+    subtitle: z.string().min(1).optional().describe("CHILD KEY whose value is the row's second line (e.g. 'level' \u2192 'Heading \xB7 h2')"),
     media: z.string().min(1).optional().describe("CHILD KEY whose value is the row's thumbnail (image/file/url all work)")
   }).optional().describe(
-    "how ONE ITEM summarises itself when collapsed. Both slots name a CHILD KEY of THIS field/prop \u2014 not a value, not a dotted path. Without it a repeater of testimonials reads 'Item 1, Item 2, Item 3'; with {title:'author', media:'avatar'} it reads the names with their faces."
+    "how ONE ITEM summarises itself when collapsed. Every slot names a CHILD KEY of THIS field/prop \u2014 not a value, not a dotted path. Without it a repeater of testimonials reads 'Item 1, Item 2, Item 3'; with {title:'author', media:'avatar'} it reads the names with their faces."
   ),
   layout: z.enum(["list", "grid"]).optional().describe(
     "how the ITEMS are arranged. Omit (\u2261 'list') for rows of text; 'grid' for items whose thumbnail is the thing you scan \u2014 a gallery, a logo wall, a team. Same placement rule as `preview`."
   ),
   reorderable: z.boolean().optional().describe(
     "omit (\u2261 true) unless the order is PART OF THE MEANING. `false` LOCKS the list \u2014 a 'three steps' band that must stay three steps in that order, a nav whose order is semantic, a timeline. Valid only where there is a list to lock."
+  ),
+  control: z.enum(["segmented", "slider"]).optional().describe(
+    "editor control for a LEAF. Omit for the default. 'segmented' on a select with a few short options (alignment, theme, size); 'slider' on a number that has config.min < config.max (opacity, columns). Anything else is refused with the rule named."
   )
 });
 var fieldShape = {
@@ -5896,8 +5900,8 @@ delivered value \u2014 they change editor chrome only.
   BARE KEY, and the key namespace is FLAT across the model (\xA7 the duplicate-key rule), so the
   key you reference must exist.
 - **\`ui.collapsed\`** \u2014 start a nesting field's panel closed. For long optional sections.
-- **\`ui.preview\`** \u2014 how ONE ITEM of a nesting field summarises itself when collapsed. Both
-  slots name a **CHILD FIELD KEY of that field** \u2014 not a value, not a dotted path.
+- **\`ui.preview\`** \u2014 how ONE ITEM of a nesting field summarises itself when collapsed. Each
+  slot (\`title\`, \`subtitle\`, \`media\`) names a **CHILD FIELD KEY of that field** \u2014 not a value, not a dotted path.
   Without it a repeater of ten testimonials reads "Item 1 \u2026 Item 10" and the author has to open
   each one to find the one they meant. \`media\` may point at an \`image\`, \`file\` or url-ish
   \`text\` child; the type is not constrained.
@@ -5909,19 +5913,25 @@ delivered value \u2014 they change editor chrome only.
   in that order, a nav whose order is semantic, a timeline. Locking a list nobody should reorder
   is the declaration there was previously no way to make; locking one out of tidiness takes a
   capability away from the author, so do not set it "just in case".
+- **\`ui.control\`** \u2014 which control a LEAF edits with; omit it for the default. \`'segmented'\` on a
+  \`select\` with a few short options (alignment, theme, size: one click instead of a dropdown);
+  \`'slider'\` on a \`number\` with \`config.min\` < \`config.max\` (opacity, columns). Anywhere else it
+  is refused with the rule named.
 
-**Five refusals, all deliberate, all 400 with the fix in the message.**
+**Six refusals, all deliberate, all 400 with the fix in the message.**
 1. An unknown key inside \`ui\` is REJECTED, not stripped. \`ui\` is a strict object precisely so
    that a typo is a refusal you can read instead of a 200 with your declaration gone.
 2. \`ui.preview\` on a LEAF field is refused \u2014 it summarises an item, and a leaf has no items.
    Valid on \`group\`, \`repeater\`, an \`array\` with \`config.zones\`, or \`modular\`.
-3. \`preview.title\` / \`preview.media\` naming a key that is not a child of that field is refused,
+3. \`preview.title\` / \`preview.subtitle\` / \`preview.media\` naming a key that is not a child of that field is refused,
    and the error lists the valid child keys.
 4. \`ui.layout\` follows the same rule as \`preview\`: nesting fields only. A leaf has no items
    to arrange.
 5. \`ui.reorderable\` is STRICTER \u2014 it needs a LIST, not merely children. Valid on \`repeater\`,
    an \`array\` with \`config.zones.repeatable\`, or \`modular\`. A \`group\` (and a non-repeatable
    zone) holds exactly ONE item, so there is nothing there to drag and the write is refused.
+6. \`ui.control\` outside its fit is refused: \`segmented\` needs a \`select\`, \`slider\` a \`number\`
+   whose \`config.min\` and \`config.max\` are both set with min < max.
 
 **The same \`ui\` rides on COMPONENT PROPS.** \`create_component\` / \`update_component\` take it on
 each entry of \`props\`, with the placement rules the prop vocabulary implies: \`preview\` and
@@ -6583,9 +6593,10 @@ Read bettercms://playbook/schema section 14 first \u2014 it has the exact prop s
 **What you are setting** (all of these ride on any field, on create_content_model / create_page /
 add_field / add_page_field; none of them affect delivery):
   ui.collapsed              start a nesting field's panel closed
-  ui.preview {title,media}  which CHILD FIELD KEY titles a collapsed row, and which is its thumb
+  ui.preview {title,subtitle,media}  which CHILD FIELD KEY titles a collapsed row, its second line, its thumb
   ui.layout 'list'|'grid'|'table'   how its items are arranged; table is for repeatable row schemas; omit for list
   ui.reorderable            omit (= true) unless the ORDER IS THE MEANING; false LOCKS the list
+  ui.control 'segmented'|'slider'   a LEAF's control: segmented on a select, slider on a number with config.min < max
   helpText                  one line under the field: what to WRITE here
   showIf                    hide a field until another field has a value