diff --git a/‎.changeset/11823-list-view-inspector.md‎
Lines changed: 13 additions & 0 deletions b/‎.changeset/11823-list-view-inspector.md‎
Lines changed: 13 additions & 0 deletions
diff --git a/‎packages/app-shell/src/views/metadata-admin/i18n.ts‎
Lines changed: 23 additions & 0 deletions b/‎packages/app-shell/src/views/metadata-admin/i18n.ts‎
Lines changed: 23 additions & 0 deletions
diff --git a/‎packages/app-shell/src/views/studio-design/ObjectListViewInspector.target.test.tsx‎
Lines changed: 87 additions & 0 deletions b/‎packages/app-shell/src/views/studio-design/ObjectListViewInspector.target.test.tsx‎
Lines changed: 87 additions & 0 deletions
@@ -0,0 +1,13 @@
+---
+'@object-ui/app-shell': patch
+---
+
+Studio's Interfaces pillar edits an object's list view (objectui#11823, step 1). The Properties panel of an `object` leaf used to say that nothing is edited there. It now edits the list view the canvas beside it shows: the columns (add, remove, drag or move up and down), the filter and the sort.
+
+- **Which view.** The view the canvas opens, read from the nav entry the way the running app reads it. An entry that names a view (`viewName`) edits that view. Any other entry edits the object's default list view: the view flagged `isDefault`, else `OBJECT.default`, the name the platform gives a container's default `list`.
+- **Where it is saved.** In the package draft, as a `view` metadata item (`{ name, object, viewKind: 'list', config }`), through the metadata draft write the other Studio editors use, with their version guard and autosave. Publishing the package publishes it with the rest of its drafts.
+- **A view that does not exist yet** is created by the first edit, seeded with the columns the running app shows for an object with no view.
+- **The canvas shows the edit at once.** It renders the panel's view, unsaved changes included, as the running app renders that list. An object entry now previews the list the running app opens: the object's default list view or, for an object with no list view yet, the default columns the running app shows. Before, it drew a plain grid of the object's fields.
+- **A read-only package** shows the panel with every control disabled, and nothing is saved.
+
+A studio-canvas leaf of any other type keeps its "nothing is edited from this panel" statement. Nothing is added to the package entry: no export, prop, type member or language-pack key. The panel's copy lives in the designer's own string tables (en and zh).
@@ -3118,6 +3118,19 @@ const ENGINE_STRINGS_EN: Record<string, string> = {
   // to wait for — `StudioCanvasPreviewProps` carries no selection by contract.
   'engine.studio.inspector.studioCanvasNoBlocks':
     'This canvas renders the running app, not a block tree — it has no blocks to select, and nothing here is edited from this panel.',
+  // objectui#11823 — an `object` leaf's panel: the list view its canvas shows.
+  'engine.studio.inspector.listView.kind': 'List view',
+  'engine.studio.inspector.listView.intro':
+    'The list on the canvas. Its columns, filter and sort save to this package\'s draft and show on the canvas at once.',
+  'engine.studio.inspector.listView.notCreated':
+    'There is no list view {view} yet. Your first change here creates it in this package\'s draft.',
+  'engine.studio.inspector.listView.readOnly': 'This package is read-only: the list view is shown here, not edited.',
+  'engine.studio.inspector.listView.notList': '{view} is not a list view, so it is not edited here.',
+  'engine.studio.inspector.listView.filter': 'Filter',
+  'engine.studio.inspector.listView.sort': 'Sort',
+  'engine.studio.inspector.listView.addSort': '+ Add sort…',
+  'engine.studio.inspector.listView.sortAsc': '{field} ascending',
+  'engine.studio.inspector.listView.sortDesc': '{field} descending',
   'engine.studio.inspector.designersMissing':
     'No metadata designers are registered in this session, so there is nothing to edit here.',
   'engine.studio.inspector.noPageSchema': 'Page settings are unavailable — the page schema could not be loaded.',
@@ -6099,6 +6112,16 @@ const ENGINE_STRINGS_ZH: Record<string, string> = {
   'engine.studio.inspector.emptyLine2': '它的属性会在这里直接编辑。',
   'engine.studio.inspector.studioCanvasNoBlocks':
     '此画布渲染的是运行态应用，而不是积木树 —— 这里没有可选中的积木，也没有可在本面板编辑的内容。',
+  'engine.studio.inspector.listView.kind': '列表视图',
+  'engine.studio.inspector.listView.intro': '画布上的就是这个列表。它的列、筛选与排序保存到本包的草稿,并立即显示在画布上。',
+  'engine.studio.inspector.listView.notCreated': '还没有列表视图 {view}。在这里做的第一次修改会在本包的草稿中创建它。',
+  'engine.studio.inspector.listView.readOnly': '本包只读:这里展示列表视图,不能编辑。',
+  'engine.studio.inspector.listView.notList': '{view} 不是列表视图,因此不在这里编辑。',
+  'engine.studio.inspector.listView.filter': '筛选',
+  'engine.studio.inspector.listView.sort': '排序',
+  'engine.studio.inspector.listView.addSort': '+ 添加排序…',
+  'engine.studio.inspector.listView.sortAsc': '{field} 升序',
+  'engine.studio.inspector.listView.sortDesc': '{field} 降序',
   'engine.studio.inspector.designersMissing': '本次会话没有注册任何元数据设计器,这里没有可编辑的内容。',
   'engine.studio.inspector.noPageSchema': '页面设置不可用——无法加载页面 schema。',
   'engine.studio.inspector.sourcePageLine1': '这个页面是 {kind} 源码,不是积木树 ——',
 
@@ -0,0 +1,87 @@
+// Copyright (c) 2026 ObjectStack. Licensed under the Apache-2.0 license.
+
+/**
+ * objectui#11823 — which list view an `object` leaf's panel edits, and the
+ * shapes it writes and hands the canvas. The pillar-level pins are in
+ * `StudioDesignSurface.listViewInspector-11823.test.tsx`.
+ */
+
+import { describe, expect, it } from 'vitest';
+import { ViewItemSchema } from '@objectstack/spec/ui';
+import { isListViewRow, listViewTargetOf, namedListViewOf, newListViewItem } from './ObjectListViewInspector';
+
+const VIEWS = {
+  'showcase_task.default': { name: 'showcase_task.default', type: 'grid', columns: [], isDefault: true },
+  'showcase_task.tabular': { name: 'showcase_task.tabular', type: 'grid', columns: [], isDefault: false },
+};
+
+describe('listViewTargetOf — the view the canvas opens (objectui#11823)', () => {
+  it('an entry that lands on a named view edits that view, matched as ObjectView matches it', () => {
+    expect(listViewTargetOf('showcase_task', 'tabular', VIEWS)).toEqual({
+      objectName: 'showcase_task',
+      viewId: 'showcase_task.tabular',
+      isDefault: false,
+    });
+    expect(listViewTargetOf('showcase_task', 'showcase_task.tabular', VIEWS).viewId).toBe('showcase_task.tabular');
+  });
+
+  it('a named view the object does not have yet is the one the entry opens once it exists', () => {
+    expect(listViewTargetOf('showcase_task', 'urgent', VIEWS)).toEqual({
+      objectName: 'showcase_task',
+      viewId: 'showcase_task.urgent',
+      isDefault: false,
+    });
+  });
+
+  it('any other entry edits the default list view: the one flagged, else `<object>.default`', () => {
+    const flagged = { ...VIEWS, 'showcase_task.default': { ...VIEWS['showcase_task.default'], isDefault: false }, 'showcase_task.tabular': { ...VIEWS['showcase_task.tabular'], isDefault: true } };
+    expect(listViewTargetOf('showcase_task', undefined, flagged)).toEqual({
+      objectName: 'showcase_task',
+      viewId: 'showcase_task.tabular',
+      isDefault: true,
+    });
+    expect(listViewTargetOf('showcase_task', undefined, {})).toEqual({
+      objectName: 'showcase_task',
+      viewId: 'showcase_task.default',
+      isDefault: true,
+    });
+  });
+});
+
+describe('newListViewItem — a view created by the first edit (objectui#11823)', () => {
+  it('is a spec-valid ViewItem record, flagged default only as the default list view', () => {
+    const created = newListViewItem({ objectName: 'showcase_task', viewId: 'showcase_task.default', isDefault: true }, ['title']);
+    expect(ViewItemSchema.safeParse(created).success).toBe(true);
+    expect(created).toMatchObject({ name: 'showcase_task.default', object: 'showcase_task', viewKind: 'list', isDefault: true });
+
+    const named = newListViewItem({ objectName: 'showcase_task', viewId: 'showcase_task.urgent', isDefault: false }, []);
+    expect(ViewItemSchema.safeParse(named).success).toBe(true);
+    expect(named).not.toHaveProperty('isDefault');
+  });
+});
+
+describe('namedListViewOf — the canvas copy of a view item (objectui#11823)', () => {
+  it('is the record\'s list body with the item label', () => {
+    expect(
+      namedListViewOf({ name: 'a.b', object: 'a', viewKind: 'list', label: 'All', config: { type: 'grid', columns: ['x'] } }),
+    ).toEqual({ type: 'grid', columns: ['x'], label: 'All' });
+  });
+
+  it('folds a stored `options.KIND` bag as the Studio view preview folds it', () => {
+    expect(
+      namedListViewOf({ name: 'a.b', config: { type: 'kanban', columns: [], options: { kanban: { groupByField: 's' } } } }),
+    ).toEqual({ type: 'kanban', columns: [], kanban: { groupByField: 's' } });
+  });
+});
+
+describe('isListViewRow — only a list view is edited (objectui#11823)', () => {
+  it('reads the spec\'s family discriminant, and a list body\'s required `columns` on a row with none', () => {
+    expect(isListViewRow({ name: 'a.b', object: 'a', viewKind: 'list', config: { type: 'grid', columns: [] } })).toBe(true);
+    expect(isListViewRow({ name: 'a.b', object: 'a', type: 'grid', columns: ['x'] })).toBe(true);
+  });
+
+  it('a form view, or a body that is no list, is never taken for one', () => {
+    expect(isListViewRow({ name: 'a.b', object: 'a', viewKind: 'form', config: { type: 'simple', sections: [] } })).toBe(false);
+    expect(isListViewRow({ name: 'a.b', label: 'a.b' })).toBe(false);
+  });
+});