@@ -0,0 +1,17 @@
+---
+"@objectstack/spec": patch
+---
+
+A view container's `form` is its default form: it is never collapsed into a named form, and no named form is promoted to default
+
+Clause-②: no
+
+`ViewSchema` declares `form` the container's default form and `formViews` additional named forms. `expandViewContainer` / `expandViewContainerWithDiagnostics`, which every view registrar shares, now serves exactly that. Behaviour changes for authors:
+
+- **A container with no `form` no longer serves its first named form as the default create/edit form.** Before, the first `formViews` entry was flagged `isDefault`, whatever it was: in the CRM example that was the anonymous Web-to-Lead form. Now no form item is flagged, and each named form is served only where it is asked for by name (a form action's `target`, `addRecord.formView`, a public `sharing.publicLink`). If you relied on the old promotion, move the intended create/edit form into `form`: `formViews: { edit: { … } }` becomes `form: { … }`, and a reference to `<object>.edit` becomes `<object>.form`.
+- **A named form no longer replaces `form`.** Before, `form` was dropped when any named form shared its `type`, `label` and `columns`, even with different sections, and the first named form became the default. Now `form` is always served as `<object>.form`, flagged `isDefault`, and is the only form item flagged. A named form whose body equals `form` stays its own named item.
+- **The default `list` collapses only into a named list that restates its whole body.** A `listViews` entry that repeats `list` key for key, the list's own `name` aside (the "default == `listViews.all`" pattern), still folds into that one named item. A named list that shares `list`'s `type`, `label` and `columns` but differs in anything else (a filter, a sort) is now its own view, and `list` is served beside it as `<object>.default`, the default list. Before, such a named list took the default's place, and the default list's own body was not served.
+
+The CRM and showcase examples move their create/edit form into `form`. The showcase task's `showcase_log_time` and `showcase_new_task` actions now target `showcase_task.form`. The public Web-to-Lead and contact-us forms stay named.
+
+⛔ No schema, parse, export or accept-set change.
@@ -8,7 +8,7 @@ A **View** defines how records of an Object are displayed to users. ObjectStack
 
 ## The `defineView` Container
 
-Views are authored **per object** inside a `defineView({ ... })` container — the default `list`, named `listViews`, and named `formViews` all live in one document. The loader expands the container into independently addressable `<object>.<key>` view items that power the view switcher.
+Views are authored **per object** inside a `defineView({ ... })` container — the default `list`, named `listViews`, the default `form`, and named `formViews` all live in one document. The loader expands the container into independently addressable `<object>.<key>` view items that power the view switcher.
 
 {/* os:check */}
 ```typescript
@@ -43,15 +43,13 @@ export const TaskViews = defineView({
     },
   },
 
-  // Named form views
-  formViews: {
-    edit: {
-      type: 'simple',
-      data,
-      sections: [
-        { name: 'task', label: 'Task', columns: 2, fields: ['title', 'status', 'assignee', 'due_date'] },
-      ],
-    },
+  // The default form — the create and edit surfaces render it
+  form: {
+    type: 'simple',
+    data,
+    sections: [
+      { name: 'task', label: 'Task', columns: 2, fields: ['title', 'status', 'assignee', 'due_date'] },
+    ],
   },
 });
 ```
@@ -360,39 +358,40 @@ gantt: {
 
 ## Form View
 
-A Form View defines how a single record is displayed for viewing or editing. Form views live under `formViews` in the same `defineView` container as the object's list views.
+A Form View defines how a single record is displayed for viewing or editing. It lives in the same `defineView` container as the object's list views:
+
+- `form` is the object's **default form** — the create and edit surfaces render it.
+- `formViews` holds **additional named forms**. Each one is served only where it is asked for by name: a form action's `target` (`<object>.<key>`), `addRecord.formView`, or a public `sharing.publicLink`. A named form never becomes the default — a container with no `form` has no default form, even when it declares named ones.
 
 ### Basic Structure
 
 ```typescript
-formViews: {
-  edit: {
-    type: 'simple',
-    data: { provider: 'object', object: 'task' },
-    sections: [
-      {
-        name: 'basic_information',
-        label: 'Basic Information',
-        columns: 2,
-        fields: [
-          { field: 'title', span: 'full' },
-          { field: 'status' },
-          { field: 'priority' },
-          { field: 'assignee' },
-          { field: 'due_date' },
-        ],
-      },
-      {
-        name: 'details',
-        label: 'Details',
-        collapsible: true,
-        columns: 1,
-        fields: [
-          { field: 'description' },
-        ],
-      },
-    ],
-  },
+form: {
+  type: 'simple',
+  data: { provider: 'object', object: 'task' },
+  sections: [
+    {
+      name: 'basic_information',
+      label: 'Basic Information',
+      columns: 2,
+      fields: [
+        { field: 'title', span: 'full' },
+        { field: 'status' },
+        { field: 'priority' },
+        { field: 'assignee' },
+        { field: 'due_date' },
+      ],
+    },
+    {
+      name: 'details',
+      label: 'Details',
+      collapsible: true,
+      columns: 1,
+      fields: [
+        { field: 'description' },
+      ],
+    },
+  ],
 },
 ```
 
@@ -467,7 +466,7 @@ app page or action, where `features.*` stays bound and stays legal. A record *fi
 
 ## Complete Example
 
-One container covering a default grid, a kanban saved view, and a tabbed edit form — mirroring `examples/app-showcase/src/ui/views/task.view.ts`:
+One container covering a default grid, a kanban saved view, and a tabbed default form — mirroring `examples/app-showcase/src/ui/views/task.view.ts`:
 
 {/* os:check */}
 ```typescript
@@ -502,37 +501,35 @@ export const TaskViews = defineView({
     },
   },
 
-  formViews: {
-    edit: {
-      type: 'tabbed',
-      data,
-      sections: [
-        {
-          name: 'details',
-          label: 'Details',
-          columns: 2,
-          fields: [
-            { field: 'title', span: 'full', required: true },
-            { field: 'status' },
-            { field: 'priority' },
-            { field: 'assignee' },
-            { field: 'due_date' },
-            { field: 'description', span: 'full' },
-          ],
-        },
-        {
-          name: 'system',
-          label: 'System',
-          collapsible: true,
-          collapsed: true,
-          columns: 2,
-          fields: [
-            { field: 'created_at', readonly: true },
-            { field: 'updated_at', readonly: true },
-          ],
-        },
-      ],
-    },
+  form: {
+    type: 'tabbed',
+    data,
+    sections: [
+      {
+        name: 'details',
+        label: 'Details',
+        columns: 2,
+        fields: [
+          { field: 'title', span: 'full', required: true },
+          { field: 'status' },
+          { field: 'priority' },
+          { field: 'assignee' },
+          { field: 'due_date' },
+          { field: 'description', span: 'full' },
+        ],
+      },
+      {
+        name: 'system',
+        label: 'System',
+        collapsible: true,
+        collapsed: true,
+        columns: 2,
+        fields: [
+          { field: 'created_at', readonly: true },
+          { field: 'updated_at', readonly: true },
+        ],
+      },
+    ],
   },
 });
 ```
 
@@ -1534,7 +1534,7 @@
         "boot the showcase isolated; sign in as admin; open the showcase_task list view",
         "for each location variant, navigate to its surface (list header / row menu / a not-done task's detail title bar / its ⋯ menu / a related-list section / the Task Detail quick-actions bar), screenshot AFTER render settles, then read the rendered action buttons from the DOM",
         "record for every fixture action WHERE it rendered — building the full placement matrix (rendered locations vs declared locations)",
-        "dispatch one action per location with a ref-targeted click: bulk_reassign (screen-flow wizard opens), quick_view (modal opens), mark_done (script executes), log_time (form dialog opens on showcase_task.edit), open_docs (url navigation), recalc_selection from the ⋯ menu (api POST); capture each network trace",
+        "dispatch one action per location with a ref-targeted click: bulk_reassign (screen-flow wizard opens), quick_view (modal opens), mark_done (script executes), log_time (form dialog opens on showcase_task.form), open_docs (url navigation), recalc_selection from the ⋯ menu (api POST); capture each network trace",
         "verify the state-changing dispatches server-side: mark_done flips the task's done flag (API re-read), recalc_selection's per-record branch recomputes the estimate",
         "CEL visibility both sides: locate a done task and a not-done task; read the row menu and record header of each for showcase_mark_done",
         "empty-locations probe, both halves: (a) in a scratch/writable package author a copy of an api action with NO locations key; reload and sweep all six surfaces (list toolbar, row menu, record header, ⋯ overflow, related-list section, quick-actions bar) recording every surface it appears on — the expected list is EMPTY — then delete the probe; (b) sweep the same six surfaces for showcase_new_task, the fixture fleet's headless `locations: []` declaration, and record that its list is empty too"
@@ -1574,7 +1574,7 @@
       "negative": [
         "any action rendering at a location it did not declare is a FAIL — placement is a contract, not a hint, and since objectui#3142 there is no everywhere-default left to inherit",
         "showcase_recalc_selection appearing on the list toolbar is the objectui#3142 regression shape — FAIL even though clicking it would merely error",
-        "a dispatch that opens the wrong target (e.g. log_time opening a list view instead of the showcase_task.edit form — the #2554 build-gate class) is a FAIL of the dispatch clause, not a cosmetic note"
+        "a dispatch that opens the wrong target (e.g. log_time opening a list view instead of the showcase_task.form form — the #2554 build-gate class) is a FAIL of the dispatch clause, not a cosmetic note"
       ],
       "traps": [
         "hydration-race",
 
@@ -136,7 +136,7 @@ export const CrmTranslationBundle = defineTranslationBundle({
           all: { label: '全部商机' },
           pipeline: { label: '商机看板' },
         },
-        // Form section heading of `ui/views/opportunity.view.ts` `default`.
+        // Form section heading of `ui/views/opportunity.view.ts` `form`.
         // Declares a stable `name`, which is the only thing that makes the
         // heading translatable — otherwise it renders the English `label` in
         // every locale (#8231). Bare object word, matching this bundle's own
@@ -162,7 +162,7 @@ export const CrmTranslationBundle = defineTranslationBundle({
           pipeline: { label: '线索看板' },
         },
         // Form section headings of `ui/views/lead.view.ts` (public web-to-lead
-        // `contact_us`, plus the four `default` groups). Each section declares
+        // `contact_us`, plus the four `form` groups). Each section declares
         // a stable `name`, the only thing that makes the heading translatable
         // (#8231). `conversion` reuses this bundle's own `messages` vocabulary
         // for "convert" (`crm.lead.convert.success` already reads 转化).
@@ -190,7 +190,7 @@ export const CrmTranslationBundle = defineTranslationBundle({
           all: { label: '全部活动' },
           calendar: { label: '活动日历' },
         },
-        // Form section headings of `ui/views/activity.view.ts` `default`. Each
+        // Form section headings of `ui/views/activity.view.ts` `form`. Each
         // declares a stable `name`, the only thing that makes the heading
         // translatable (#8231).
         _sections: {
 
@@ -48,42 +48,41 @@ export const ActivityViews = defineView({
       },
     },
   },
-  formViews: {
-    default: {
-      type: 'simple',
-      sections: [
-        {
-          name: 'activity_details',
-          label: 'Activity Details',
-          columns: 2,
-          fields: [
-            { field: 'subject',          required: true },
-            { field: 'type',             required: true },
-            { field: 'status',           required: true },
-            { field: 'due_date' },
-            { field: 'duration_minutes' },
-          ],
-        },
-        {
-          name: 'related_records',
-          label: 'Related Records',
-          columns: 2,
-          fields: [
-            { field: 'contact' },
-            { field: 'account' },
-            { field: 'opportunity' },
-          ],
-        },
-        {
-          name: 'notes',
-          label: 'Notes',
-          columns: 1,
-          fields: [
-            { field: 'description' },
-            { field: 'outcome' },
-          ],
-        },
-      ],
-    },
+  // The default form — what the create and edit surfaces render.
+  form: {
+    type: 'simple',
+    sections: [
+      {
+        name: 'activity_details',
+        label: 'Activity Details',
+        columns: 2,
+        fields: [
+          { field: 'subject',          required: true },
+          { field: 'type',             required: true },
+          { field: 'status',           required: true },
+          { field: 'due_date' },
+          { field: 'duration_minutes' },
+        ],
+      },
+      {
+        name: 'related_records',
+        label: 'Related Records',
+        columns: 2,
+        fields: [
+          { field: 'contact' },
+          { field: 'account' },
+          { field: 'opportunity' },
+        ],
+      },
+      {
+        name: 'notes',
+        label: 'Notes',
+        columns: 1,
+        fields: [
+          { field: 'description' },
+          { field: 'outcome' },
+        ],
+      },
+    ],
   },
 });