feat(view): enhance ListViewSchema to support filterable fields and update documentation

Author: hotlong

packages/spec/src/ui/view.test.ts

@@ -253,6 +253,16 @@ describe('ListViewSchema', () => {
     expect(() => ListViewSchema.parse(listView)).not.toThrow();
   });
 
+  it('should accept list view with top filter fields', () => {
+    const listView: ListView = {
+      type: 'grid',
+      columns: ['name', 'status'],
+      filterableFields: ['status', 'category', 'owner'],
+    };
+
+    expect(() => ListViewSchema.parse(listView)).not.toThrow();
+  });
+
   it('should accept kanban view with config', () => {
     const kanbanView: ListView = {
       type: 'kanban',

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

@@ -193,8 +193,9 @@ export const ListViewSchema = z.object({
     }))
   ]).optional(),
 
-  /** Search */
+  /** Search & Filter */
   searchableFields: z.array(z.string()).optional().describe('Fields enabled for search'),
+  filterableFields: z.array(z.string()).optional().describe('Fields enabled for end-user filtering in the top bar'),
 
   /** Grid Features */
   resizable: z.boolean().optional().describe('Enable column resizing'),