fix(spec): the form-view conversion strips a master-detail block's section pane

object-master-detail-form shares the object-form section shape, so its
sections[].pane parsed through 18.2.0 and is a tombstone now. A stored
master-detail page would have failed at parse after the upgrade.
convertBlock's page walk now strips sections[].pane on that block too
(fixture row, expectedNotices 17), the D3 entry names it, and the pane
prescription is worded for both blocks.

Claude-Session: https://claude.ai/code/session_01JQwxbWHWPRD5rZXeY69YvL
Co-authored-by: Claude <noreply@anthropic.com>

Author: claude

content/docs/references/ui/component.mdx

@@ -640,7 +640,7 @@ Sort field and direction pair
 | **collapsed** | `boolean` | optional | Start the section closed (implies `collapsible`) |
 | **visibleWhen** | `string \| { dialect: Enum<'cel' \| 'cron' \| 'template'>; source: string; ast?: any; meta?: object }` | optional | Predicate (CEL) — the whole section, heading and fields, is drawn only when TRUE |
 | **columns** | `integer` | optional | Field-grid columns for this section (1-4), a number |
-| **pane** | `never` | optional | [REMOVED] `object-form` property `sections[].pane` was removed in @objectstack/spec 18.3.0 (ADR-0050) — it placed a section in one pane of a `formType: 'split'` form, and `split` left the block in the same release, so no form draws panes. Delete the key. Run `os migrate meta --from 17` to list the mechanical edits for existing sources; `--write` applies the ones it can prove, and you apply the rest by hand. |
+| **pane** | `never` | optional | [REMOVED] Section property `pane` (on `object-form` and `object-master-detail-form` `sections[]`) was removed in @objectstack/spec 18.3.0 (ADR-0050) — it placed a section in one pane of an `object-form` `formType: 'split'` form, and `split` left that block in the same release, so no form draws panes. Delete the key. Run `os migrate meta --from 17` to list the mechanical edits for existing sources; `--write` applies the ones it can prove, and you apply the rest by hand. |
 | **group** | `string` | optional | Field group key (snake_case) whose members and presentation this section inherits, from the object's `fieldGroups`. Mutually exclusive with `fields`, and with every key the group itself declares (`name`, `label`, `description`, `visibleWhen`, and a `true` `collapsible` / `collapsed`) |
 | **fields** | `(string \| { field: string; type?: Enum<'text' \| 'textarea' \| 'email' \| 'url' \| 'phone' \| 'password' \| 'secret' \| …>; options?: object[]; reference?: string; … } \| { name: string; label?: string; description?: string; type?: string; … })[]` | optional | The section's fields, in order — each a field name, the form view's `{ field, … }` entry overriding that object field, or an inline form field `{ name, type, … }`. Omit only when `group` supplies the members |
 
@@ -1151,7 +1151,7 @@ Sort field and direction pair
 | **recordId** | `string \| number` | optional | Parent record to load (edit mode) |
 | **mode** | `Enum<'create' \| 'edit'>` | optional | Form mode |
 | **formType** | `Enum<'simple' \| 'tabbed'>` | optional | Parent form presentation — the two variants the renderer honours for the parent half |
-| **sections** | `{ name?: string; label?: string; description?: string; collapsible?: boolean; … }[]` | optional | Parent form sections — the same section shape `object-form` takes: `{ name?, label?, description?, collapsible?, collapsed?, visibleWhen?, columns?, pane?, fields }` or `{ group, columns?, pane? }` |
+| **sections** | `{ name?: string; label?: string; description?: string; collapsible?: boolean; … }[]` | optional | Parent form sections — the same section shape `object-form` takes: `{ name?, label?, description?, collapsible?, collapsed?, visibleWhen?, columns?, fields }` or `{ group, columns? }` |
 | **fields** | `string[]` | optional | Parent field names to draw, in order — bare names, as on `object-form`; a `{ name }` or `{ field }` object entry is refused |
 | **details** | `{ childObject: string; relationshipField?: string; columns?: object[]; formFields?: string[]; … }[]` | optional | Detail collections — each a strict entry (`{ childObject, title?, addLabel?, columns?, relationshipField?, … }`) whose `columns` are the inline grid columns a relationship field's `inlineColumns` takes; the FK and columns auto-derive from child metadata when omitted |
 | **title** | `string \| Record<string, string>` | optional | Form title |
@@ -1173,7 +1173,7 @@ Sort field and direction pair
 | **collapsed** | `boolean` | optional | Start the section closed (implies `collapsible`) |
 | **visibleWhen** | `string \| { dialect: Enum<'cel' \| 'cron' \| 'template'>; source: string; ast?: any; meta?: object }` | optional | Predicate (CEL) — the whole section, heading and fields, is drawn only when TRUE |
 | **columns** | `integer` | optional | Field-grid columns for this section (1-4), a number |
-| **pane** | `never` | optional | [REMOVED] `object-form` property `sections[].pane` was removed in @objectstack/spec 18.3.0 (ADR-0050) — it placed a section in one pane of a `formType: 'split'` form, and `split` left the block in the same release, so no form draws panes. Delete the key. Run `os migrate meta --from 17` to list the mechanical edits for existing sources; `--write` applies the ones it can prove, and you apply the rest by hand. |
+| **pane** | `never` | optional | [REMOVED] Section property `pane` (on `object-form` and `object-master-detail-form` `sections[]`) was removed in @objectstack/spec 18.3.0 (ADR-0050) — it placed a section in one pane of an `object-form` `formType: 'split'` form, and `split` left that block in the same release, so no form draws panes. Delete the key. Run `os migrate meta --from 17` to list the mechanical edits for existing sources; `--write` applies the ones it can prove, and you apply the rest by hand. |
 | **group** | `string` | optional | Field group key (snake_case) whose members and presentation this section inherits, from the object's `fieldGroups`. Mutually exclusive with `fields`, and with every key the group itself declares (`name`, `label`, `description`, `visibleWhen`, and a `true` `collapsible` / `collapsed`) |
 | **fields** | `(string \| { field: string; type?: Enum<'text' \| 'textarea' \| 'email' \| 'url' \| 'phone' \| 'password' \| 'secret' \| …>; options?: object[]; reference?: string; … } \| { name: string; label?: string; description?: string; type?: string; … })[]` | optional | The section's fields, in order — each a field name, the form view's `{ field, … }` entry overriding that object field, or an inline form field `{ name, type, … }`. Omit only when `group` supplies the members |
 

packages/spec/src/conversions/registry.ts

@@ -8739,7 +8739,10 @@ const connectorConnectionTimeoutMsRemoved: MetadataConversion = {
  * and container nesting — scoped to `type === 'object-form'`, as
  * {@link formLayoutInlineGridToVertical} is. The block accepted `split` and
  * the three keys through 18.2.0, so a stored page or an assembled artifact
- * can carry them.
+ * can carry them. The `object-master-detail-form` block's parent `sections`
+ * are the same section shape (`objectFormSection()`), so its `pane` parsed
+ * through 18.2.0 and is refused now: the walk strips `sections[].pane` there
+ * too, and touches nothing else on that block.
  */
 const formViewPresentationTypesRemoved: MetadataConversion = {
   id: 'form-view-presentation-types-removed',
@@ -8751,13 +8754,15 @@ const formViewPresentationTypesRemoved: MetadataConversion = {
     + 'view.form.sections[].pane / view.form.splitSize / view.form.splitResizable / '
     + "view.form.splitDirection / page.component.object-form.formType ('split') / "
     + 'page.component.object-form.sections[].pane / page.component.object-form.splitDirection / '
-    + 'page.component.object-form.splitSize / page.component.object-form.splitResizable',
+    + 'page.component.object-form.splitSize / page.component.object-form.splitResizable / '
+    + 'page.component.object-master-detail-form.sections[].pane',
   summary:
     "form view `type` members 'split' / 'drawer' / 'modal' removed (`type` is the form's layout — "
     + "simple, tabbed or wizard; where a form opens is the caller's open mode, and a record beside its "
     + 'list is a reader\'s preference), with the split-only keys `sections[].pane`, `splitDirection`, '
     + '`splitSize` and `splitResizable`; the `object-form` page block sheds its `split` member and the same '
-    + 'four keys (its `drawer` / `modal` containers stay). The retired member is deleted, which lands the '
+    + 'four keys (its `drawer` / `modal` containers stay), and the `object-master-detail-form` block its '
+    + 'sections\' `pane`. The retired member is deleted, which lands the '
     + 'form on the `simple` default',
   apply(stack, emit) {
     const RETIRED_TYPES: ReadonlySet<unknown> = new Set(['split', 'drawer', 'modal']);
@@ -8796,10 +8801,14 @@ const formViewPresentationTypesRemoved: MetadataConversion = {
       return stripSectionPanes(next, 'sections', path);
     };
     const withPages = mapPageComponents(stack, (component, path) => {
-      if (component.type !== 'object-form') return component;
+      if (component.type !== 'object-form' && component.type !== 'object-master-detail-form') return component;
       const properties = component.properties;
       if (!isDict(properties)) return component;
-      const next = convertBlock(properties, `${path}.properties`);
+      // The master-detail block's parent `sections` share the `object-form`
+      // section shape, `pane` included; it had no `split` member or split keys.
+      const next = component.type === 'object-form'
+        ? convertBlock(properties, `${path}.properties`)
+        : stripSectionPanes(properties, 'sections', `${path}.properties`);
       return next === properties ? component : { ...component, properties: next };
     });
     const withViews = mapViewPayloads(withPages, (payload, kind, path) =>
@@ -8841,6 +8850,11 @@ const formViewPresentationTypesRemoved: MetadataConversion = {
                 },
                 // A drawer block is a live container on the block: untouched.
                 { type: 'object-form', properties: { objectName: 'fv_task', formType: 'drawer', drawerSide: 'right' } },
+                // A master-detail block's parent sections share the shape: the pane goes.
+                {
+                  type: 'object-master-detail-form',
+                  properties: { objectName: 'fv_task', sections: [{ label: 'Task', pane: 'primary', fields: ['title'] }] },
+                },
                 // The same keys on a component that is NOT an `object-form` survive.
                 { type: 'element:custom', properties: { formType: 'split', splitSize: 40 } },
               ],
@@ -8900,6 +8914,10 @@ const formViewPresentationTypesRemoved: MetadataConversion = {
                   },
                 },
                 { type: 'object-form', properties: { objectName: 'fv_task', formType: 'drawer', drawerSide: 'right' } },
+                {
+                  type: 'object-master-detail-form',
+                  properties: { objectName: 'fv_task', sections: [{ label: 'Task', fields: ['title'] }] },
+                },
                 { type: 'element:custom', properties: { formType: 'split', splitSize: 40 } },
               ],
             },
@@ -8928,12 +8946,13 @@ const formViewPresentationTypesRemoved: MetadataConversion = {
         { name: 'fv_task.side', object: 'fv_task', viewKind: 'form' },
       ],
     },
-    // The split block: the member, three keys and two panes (6). `beside`: the
-    // member, `splitDirection`, `splitSize`, `splitResizable` and two panes
-    // (6); `quick`, `dialog`, the item record and the assembled overlay: one
-    // member each (4). The drawer block, the non-form component, the tabbed
-    // form and the list emit none.
-    expectedNotices: 16,
+    // The split block: the member, three keys and two panes (6). The
+    // master-detail block: its one pane (1). `beside`: the member,
+    // `splitDirection`, `splitSize`, `splitResizable` and two panes (6);
+    // `quick`, `dialog`, the item record and the assembled overlay: one member
+    // each (4). The drawer block, the non-form component, the tabbed form and
+    // the list emit none.
+    expectedNotices: 17,
   },
 };
 

packages/spec/src/migrations/entries/semantic/18.ui-form-view-type-layout-only.ts

@@ -23,7 +23,7 @@ export const entry: SemanticMigration = {
     + 'view.form.sections[].pane, view.form.splitDirection, view.form.splitSize and view.form.splitResizable '
     + 'were removed with them; on an object-form page block the value \'split\' and the props '
     + 'splitDirection, splitSize, splitResizable and sections[].pane left too (its \'drawer\' and '
-    + '\'modal\' stay)',
+    + '\'modal\' stay), and so did sections[].pane on an object-master-detail-form block',
   replacement:
     'the form\'s layout: delete the retired value for the `simple` default, or write `tabbed` (one tab '
     + 'per section) or `wizard`. Where the form opens is the caller\'s: a list opens a clicked record in '
@@ -40,13 +40,13 @@ export const entry: SemanticMigration = {
     + '`form-view-presentation-types-removed` makes each stored or existing source parse: it DELETES a '
     + 'retired member, which lands the form on the `simple` default, and strips `pane`, `splitDirection`, '
     + '`splitSize` and `splitResizable` (on an `object-form` page block it deletes `formType: \'split\'` '
-    + 'and strips the same keys). What it cannot decide is the layout a former `split` form should take (`tabbed` '
+    + 'and strips the same keys, and on an `object-master-detail-form` block it strips a section `pane`). What it cannot decide is the layout a former `split` form should take (`tabbed` '
     + 'keeps its sections apart, `simple` stacks them), and how the caller of a former `drawer` or `modal` '
     + 'form should now open it',
   acceptanceCriteria:
     'No form view declares `type` `split`, `drawer` or `modal`, and no form view section declares `pane`, '
     + 'nor a form view `splitDirection`, `splitSize` or `splitResizable`; no `object-form` page block '
-    + 'declares `formType` `split`, `splitDirection`, `splitSize`, `splitResizable` or a section `pane`; each is refused at parse with its prescription, and '
+    + 'declares `formType` `split`, `splitDirection`, `splitSize`, `splitResizable` or a section `pane`, and no `object-master-detail-form` block a section `pane`; each is refused at parse with its prescription, and '
     + 'TypeScript rejects each at a `FormView` position. Every form the conversion changed renders in the '
     + 'layout its author chose, and every entry point that opened it as a drawer or dialog still opens it '
     + 'that way through its own open mode.',

packages/spec/src/shared/retired-key-removal-version.pin.test.ts

@@ -110,6 +110,7 @@ import {
   ElementRepeaterPropsSchema,
   ObjectFormPropsSchema,
   ObjectGridPropsSchema,
+  ObjectMasterDetailFormPropsSchema,
   ObjectKanbanPropsSchema,
   PageHeaderProps,
 } from '../ui/component.zod';
@@ -431,6 +432,11 @@ const JOIN: Readonly<Record<string, readonly Renderer[]>> = {
       () => ObjectFormPropsSchema.safeParse({ objectName: 'crm_contact', sections: [{ pane: 'primary', fields: ['name'] }] }),
       'sections',
     ),
+    refusal(
+      'object-master-detail-form sections[].pane',
+      () => ObjectMasterDetailFormPropsSchema.safeParse({ objectName: 'crm_contact', sections: [{ pane: 'primary', fields: ['name'] }] }),
+      'sections',
+    ),
   ],
   // #25050: retired after 18.0.0, so the v18 train's major. Partial (unset
   // values and remote urls only), so the prescription's migrate sentence is

packages/spec/src/ui/component.zod.ts

@@ -6270,10 +6270,15 @@ const objectFormSplitKeyRetired = (key: string, what: string): string =>
 const OBJECT_FORM_SPLIT_DIRECTION_RETIRED = objectFormSplitKeyRetired('splitDirection', 'set the pane orientation');
 const OBJECT_FORM_SPLIT_SIZE_RETIRED = objectFormSplitKeyRetired('splitSize', 'sized the primary pane');
 const OBJECT_FORM_SPLIT_RESIZABLE_RETIRED = objectFormSplitKeyRetired('splitResizable', 'made the panes resizable');
+/**
+ * One section shape serves the `object-form` block and the parent half of the
+ * `object-master-detail-form` block (`objectFormSection()`), so this
+ * prescription names both.
+ */
 const OBJECT_FORM_SECTION_PANE_RETIRED =
-  '`object-form` property `sections[].pane` was removed in @objectstack/spec 18.3.0 (ADR-0050) — it '
-  + "placed a section in one pane of a `formType: 'split'` form, and `split` left the block in the same "
-  + 'release, so no form draws panes. Delete the key. '
+  'Section property `pane` (on `object-form` and `object-master-detail-form` `sections[]`) was removed in '
+  + "@objectstack/spec 18.3.0 (ADR-0050) — it placed a section in one pane of an `object-form` `formType: 'split'` "
+  + 'form, and `split` left that block in the same release, so no form draws panes. Delete the key. '
   + OBJECT_FORM_SPLIT_FIX;
 
 /**
@@ -6823,9 +6828,9 @@ function objectFormSectionColumnsRefusal(input: unknown): string | undefined {
  *
  * `name` and `label` (the heading, and the per-`formType` maps),
  * `description`, `collapsible` / `collapsed` (`resolveSectionCollapse`),
- * `visibleWhen` (the divider row's predicate), `columns`, `pane` (the split
- * form), `group` (resolved into the field group's own section above the
- * routing) and `fields` (read points recorded in `liveness/page.json`, row
+ * `visibleWhen` (the divider row's predicate), `columns`, `pane` (a
+ * tombstone since 18.3.0: its reader, the split form, retired), `group`
+ * (resolved into the field group's own section above the routing) and `fields` (read points recorded in `liveness/page.json`, row
  * `regions`). That is exactly the form view's section's key set, and objectui
  * declares the same (`ObjectFormSection`).
  *
@@ -7255,7 +7260,7 @@ export const ObjectMasterDetailFormPropsSchema = lazySchema(() => strictObject({
    * one instance {@link buildObjectFormSection} builds (S-forms stage).
    */
   sections: z.array(objectFormSection()).optional()
-    .describe('Parent form sections — the same section shape `object-form` takes: `{ name?, label?, description?, collapsible?, collapsed?, visibleWhen?, columns?, pane?, fields }` or `{ group, columns?, pane? }`'),
+    .describe('Parent form sections — the same section shape `object-form` takes: `{ name?, label?, description?, collapsible?, collapsed?, visibleWhen?, columns?, fields }` or `{ group, columns? }`'),
   fields: formFieldNameList().optional()
     .describe('Parent field names to draw, in order — bare names, as on `object-form`; a `{ name }` or `{ field }` object entry is refused'),
   details: z.array(masterDetailDetailEntry()).optional()