feat(spec): interface pages own their view metadata directly (revise ADR-0047 iron rule)

Airtable parity: an interface (list) page now defines its data surface DIRECTLY
as metadata — columns, base filter, sort — instead of inheriting them from a
referenced object view ("sourceView"). There is no "inherit from a separate
view" concept anymore; the page IS the view definition.

Spec (packages/spec/src/ui):
- page.zod.ts — InterfacePageConfigSchema gains its own `columns`
  (string[] | ListColumnSchema[]) and `sort`; `filterBy` clarified as the
  always-on base filter. `sourceView` is now @deprecated, kept only as a
  runtime back-compat fallback.
- page.form.ts — the inspector follows Airtable's IA: Data (Source → Columns →
  Filter By → Levels) · Appearance · User filters · User actions. The
  "Source View" picker is removed and replaced by a Columns field picker
  (widget: field-multi, dependsOn: source). Iron-rule helptext rewritten.

Showcase migrated to the new model (define columns directly, drop sourceView):
- task-triage.page.ts, task-workbench.page.ts.

Pairs with the objectui runtime change that reads page-owned columns/sort with
a view→object fallback. Browser-verified: the page editor shows Source/Columns/
Filter By (no Source View); picking columns re-renders the preview live; both
showcase pages render their own column sets (workbench shows Estimate (h), which
the object default view omits — proving independence).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

Author: os-zhuang

examples/app-showcase/src/pages/task-triage.page.ts

@@ -24,8 +24,8 @@ export const TaskTriagePage: Page = {
   regions: [],
   interfaceConfig: {
     source: 'showcase_task',
-    // Inherit columns/filter/sort from the object's default view (ADR-0047).
-    sourceView: 'default',
+    // ADR-0047 (revised): columns defined directly on the page (no inheritance).
+    columns: ['title', 'project', 'assignee', 'status', 'priority', 'due_date', 'progress'],
 
     // End-user filter element: a row of preset tabs. `showAllRecords` adds the
     // leading unfiltered "All" tab automatically.

examples/app-showcase/src/pages/task-workbench.page.ts

@@ -34,9 +34,9 @@ export const TaskWorkbenchPage: Page = {
   interfaceConfig: {
     source: 'showcase_task',
 
-    // ADR-0047 iron rule: the page inherits columns/filter/sort from the
-    // referenced view and adds presentation policy only.
-    sourceView: 'default',
+    // ADR-0047 (revised): the page defines its own columns directly — no
+    // inheriting from a separate view.
+    columns: ['title', 'project', 'assignee', 'status', 'priority', 'estimate_hours'],
 
     // End-user quick filters — the only filtering surface on this page.
     userFilters: {

packages/spec/src/ui/page.form.ts

@@ -68,7 +68,7 @@ export const pageForm = defineForm({
     {
       name: 'interface',
       label: 'Interface (list pages)',
-      description: 'ADR-0047 interface mode: bind a source view and curate the end-user surface — quick filters, locked visualizations, toolbar actions (Airtable Interfaces parity).',
+      description: 'Interface mode (Airtable parity): the page defines its own data surface directly — columns, filters, visualizations and toolbar — no inheriting from a separate view.',
       collapsible: true,
       // Primary content for a list page — open by default (still collapsible).
       collapsed: false,
@@ -78,7 +78,7 @@ export const pageForm = defineForm({
           field: 'interfaceConfig',
           type: 'composite',
           helpText:
-            'source/sourceView bind the object view (columns, base filter and sort are inherited — the iron rule); appearance.allowedVisualizations whitelists renderers (one entry = locked); userActions toggles the toolbar.',
+            'The page IS the view: source picks the object, columns/filterBy are defined directly here; appearance.allowedVisualizations whitelists renderers (one entry = locked); userActions toggles the toolbar.',
           // Order: common authoring controls first, rarely-used ones last.
           // Explicit sub-fields so `userFilters` can use the dedicated
           // filter-mode selector (None / Tabs / Dropdown, ADR-0047 §3.4a).
@@ -87,22 +87,25 @@ export const pageForm = defineForm({
           // (`element: 'toggle'` stays valid but deprecated — not offered.)
           // Keep this list in sync with InterfacePageConfigSchema.
           fields: [
-            { field: 'source', widget: 'ref:object', helpText: 'Object this list reads from' },
-            // Pick from the source object's views instead of typing a name.
-            // `dependsOn: 'source'` tells the picker which object's views to list.
-            { field: 'sourceView', widget: 'view-ref', dependsOn: 'source', helpText: 'Named list view to inherit columns/filter/sort from (blank = object default)' },
+            // ── Data ── the page defines its own data surface directly.
+            { field: 'source', widget: 'ref:object', helpText: 'Object this page reads from' },
+            // Columns are defined ON the page (no view inheritance). `dependsOn:
+            // 'source'` tells the picker which object's fields to offer.
+            { field: 'columns', widget: 'field-multi', dependsOn: 'source', helpText: 'Columns to show — defined directly on the page (blank = all object fields)' },
+            { field: 'filterBy', type: 'repeater', helpText: 'Always-on base filter for the page' },
+            { field: 'levels', helpText: 'Hierarchy levels to display (tree-like sources)' },
+            // ── Appearance ──
             { field: 'appearance', type: 'composite', helpText: 'Allowed visualizations (Grid / Kanban / Calendar / …) and description visibility' },
+            // ── User filters ──
             {
               field: 'userFilters',
               widget: 'filter-mode',
               helpText: 'End-user filter bar: None (no bar) / Tabs (named presets) / Dropdown (per-field). None removes the config.',
             },
+            // ── User actions ──
             { field: 'userActions', type: 'composite', helpText: 'Toolbar toggles (search, sort, filter, row height)' },
             { field: 'addRecord', type: 'composite', helpText: 'Add-record entry point' },
             { field: 'showRecordCount', helpText: 'Show the record count bar' },
-            // Less-common — kept last.
-            { field: 'filterBy', type: 'repeater', helpText: 'Always-on page filter (in addition to the source view)' },
-            { field: 'levels', helpText: 'Hierarchy levels to display (tree-like sources)' },
             { field: 'allowPrinting', helpText: 'Allow users to print this page' },
           ],
         },

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

@@ -13,6 +13,7 @@ import {
   UserFiltersSchema,
   ViewFilterRuleSchema,
   AddRecordConfigSchema,
+  ListColumnSchema,
 } from './view.zod';
 
 /**
@@ -226,10 +227,22 @@ export const RecordReviewConfigSchema = lazySchema(() => z.object({
 export const InterfacePageConfigSchema = lazySchema(() => z.object({
   /** Data binding (ADR-0047: pages REFERENCE views, never restate them) */
   source: z.string().optional().describe('Source object name for the page'),
-  sourceView: z.string().optional()
-    .describe('Named list view on the source object to inherit columns/filter/sort from (ADR-0047 iron rule: the page adds presentation policy only). Omit to use the object default view'),
+
+  // ADR-0047 (revised): the page carries its OWN view metadata — columns, sort
+  // and base filter are defined directly here (Airtable parity: there is no
+  // "inherit from a named view" concept). The page IS the view definition.
+  columns: z.union([z.array(z.string()), z.array(ListColumnSchema)]).optional()
+    .describe('Columns shown by the page. Blank = all object fields. Defined directly on the page (no view inheritance).'),
+  sort: z.array(SortItemSchema).optional()
+    .describe('Default sort order for the page, defined directly on the page.'),
+  filterBy: z.array(ViewFilterRuleSchema).optional().describe('Always-on page filter (base filter).'),
   levels: z.number().int().min(1).optional().describe('Number of hierarchy levels to display'),
-  filterBy: z.array(ViewFilterRuleSchema).optional().describe('Page-level filter criteria'),
+
+  /** @deprecated Back-compat only. Pre-revision pages inherited columns/filter/sort
+   * from a named object view; new pages define `columns`/`sort`/`filterBy` directly.
+   * Still honored at runtime as a fallback when the page has no own `columns`. */
+  sourceView: z.string().optional()
+    .describe('@deprecated Legacy named-view inheritance. Define columns/sort/filterBy on the page instead.'),
 
   /** Appearance — `appearance.allowedVisualizations` is the runtime visualization whitelist */
   appearance: AppearanceConfigSchema.optional().describe('Appearance and visualization configuration'),