@object-ui/types 3.0.3 → 3.1.0

package/src/zod/objectql.zod.ts

@@ -73,6 +73,18 @@ export const ListColumnSchema = z.object({
   type: z.string().optional().describe('Renderer type override'),
   link: z.boolean().optional().describe('Functions as the primary navigation link (triggers View navigation)'),
   action: z.string().optional().describe('Registered Action ID to execute when clicked'),
+  pinned: z.enum(['left', 'right']).optional().describe('Pin column to left or right edge'),
+  summary: z.union([
+    z.string(),
+    z.object({
+      type: z.enum(['count', 'sum', 'avg', 'min', 'max']).describe('Aggregation type'),
+      field: z.string().optional().describe('Field to aggregate (defaults to column field)'),
+    }),
+  ]).optional().describe('Column footer summary/aggregation'),
+  prefix: z.object({
+    field: z.string().describe('Field name to render as prefix'),
+    type: z.enum(['badge', 'text']).optional().describe('Renderer type for the prefix'),
+  }).optional().describe('Prefix configuration for compound cell rendering (Airtable-style)'),
 });
 
 /**
@@ -179,6 +191,7 @@ export const ObjectViewSchema = BaseSchema.extend({
   form: z.lazy(() => ObjectFormSchema.omit({ type: true, objectName: true, mode: true }).partial()).optional().describe('Form config'),
   showSearch: z.boolean().optional().describe('Show search'),
   showFilters: z.boolean().optional().describe('Show filters'),
+  showSort: z.boolean().optional().describe('Show sort controls'),
   showCreate: z.boolean().optional().describe('Show create button'),
   showRefresh: z.boolean().optional().describe('Show refresh button'),
   operations: z.object({
@@ -189,6 +202,49 @@ export const ObjectViewSchema = BaseSchema.extend({
   }).optional().describe('Enabled operations'),
 });
 
+/**
+ * User Filters — field-level filter option
+ */
+const UserFilterOptionSchema = z.object({
+  label: z.string().describe('Option display label'),
+  value: z.union([z.string(), z.number(), z.boolean()]).describe('Option value'),
+  color: z.string().optional().describe('Option badge color'),
+});
+
+/**
+ * User Filters — field-level filter definition (dropdown & toggle modes)
+ */
+const UserFilterFieldSchema = z.object({
+  field: z.string().describe('Field name to filter on'),
+  label: z.string().optional().describe('Display label'),
+  type: z.enum(['select', 'multi-select', 'boolean', 'date-range', 'text']).optional().describe('Filter input type'),
+  options: z.array(UserFilterOptionSchema).optional().describe('Static options'),
+  showCount: z.boolean().optional().describe('Show record count per option'),
+  defaultValues: z.array(z.union([z.string(), z.number(), z.boolean()])).optional().describe('Default selected values'),
+});
+
+/**
+ * User Filters — tab preset definition (tabs mode)
+ */
+const UserFilterTabSchema = z.object({
+  id: z.string().describe('Unique tab identifier'),
+  label: z.string().describe('Tab display label'),
+  filters: z.array(z.union([z.array(z.any()), z.string()])).describe('Filter conditions'),
+  icon: z.string().optional().describe('Icon name'),
+  default: z.boolean().optional().describe('Default active tab'),
+});
+
+/**
+ * User Filters Configuration Schema (Airtable Interfaces-style)
+ */
+const UserFiltersSchema = z.object({
+  element: z.enum(['dropdown', 'tabs', 'toggle']).describe('UI element type'),
+  fields: z.array(UserFilterFieldSchema).optional().describe('Field-level filters'),
+  tabs: z.array(UserFilterTabSchema).optional().describe('Named filter presets'),
+  allowAddTab: z.boolean().optional().describe('Allow adding new tabs'),
+  showAllRecords: z.boolean().optional().describe('Show All records tab'),
+});
+
 /**
  * ListView Schema
  */
@@ -200,6 +256,105 @@ export const ListViewSchema = BaseSchema.extend({
   filters: z.array(z.union([z.array(z.any()), z.string()])).optional().describe('Filter conditions'),
   sort: z.array(SortConfigSchema).optional().describe('Sort order'),
   options: z.record(z.string(), z.any()).optional().describe('Component overrides'),
+  userFilters: UserFiltersSchema.optional().describe('User filters configuration'),
+  showSearch: z.boolean().optional().describe('Show search in toolbar'),
+  showSort: z.boolean().optional().describe('Show sort controls in toolbar'),
+  showFilters: z.boolean().optional().describe('Show filter controls in toolbar'),
+  showHideFields: z.boolean().optional().describe('Show hide-fields button in toolbar'),
+  showGroup: z.boolean().optional().describe('Show group button in toolbar'),
+  showColor: z.boolean().optional().describe('Show color button in toolbar'),
+  showDensity: z.boolean().optional().describe('Show density/row-height button in toolbar'),
+  allowExport: z.boolean().optional().describe('Allow data export'),
+  striped: z.boolean().optional().describe('Alternating row colors'),
+  bordered: z.boolean().optional().describe('Show cell borders'),
+  color: z.string().optional().describe('Color field for row/card coloring'),
+  inlineEdit: z.boolean().optional().describe('Enable inline editing'),
+  wrapHeaders: z.boolean().optional().describe('Wrap column headers'),
+  clickIntoRecordDetails: z.boolean().optional().describe('Navigate to detail on row click'),
+  addRecordViaForm: z.boolean().optional().describe('Add records via form dialog'),
+  addDeleteRecordsInline: z.boolean().optional().describe('Enable inline add/delete'),
+  collapseAllByDefault: z.boolean().optional().describe('Collapse all groups by default'),
+  fieldTextColor: z.string().optional().describe('Field for custom text color'),
+  prefixField: z.string().optional().describe('Prefix field before title'),
+  showDescription: z.boolean().optional().describe('Show field descriptions'),
+  navigation: z.object({
+    mode: z.enum(['page', 'drawer', 'modal', 'split', 'popover', 'new_window', 'none']),
+    view: z.string().optional(),
+    preventNavigation: z.boolean().optional(),
+    openNewTab: z.boolean().optional(),
+    width: z.union([z.string(), z.number()]).optional(),
+  }).optional().describe('Navigation configuration'),
+  selection: z.object({
+    type: z.enum(['none', 'single', 'multiple']),
+  }).optional().describe('Row selection mode'),
+  pagination: z.object({
+    pageSize: z.number(),
+    pageSizeOptions: z.array(z.number()).optional(),
+  }).optional().describe('Pagination configuration'),
+  searchableFields: z.array(z.string()).optional().describe('Searchable fields'),
+  filterableFields: z.array(z.string()).optional().describe('Filterable fields'),
+  resizable: z.boolean().optional().describe('Allow column resizing'),
+  densityMode: z.enum(['compact', 'comfortable', 'spacious']).optional().describe('Density mode'),
+  rowHeight: z.enum(['compact', 'short', 'medium', 'tall', 'extra_tall']).optional().describe('Row height'),
+  hiddenFields: z.array(z.string()).optional().describe('Hidden fields'),
+  exportOptions: z.union([
+    z.array(z.enum(['csv', 'xlsx', 'json', 'pdf'])),
+    z.object({
+      formats: z.array(z.enum(['csv', 'xlsx', 'json', 'pdf'])).optional(),
+      maxRecords: z.number().optional(),
+      includeHeaders: z.boolean().optional(),
+      fileNamePrefix: z.string().optional(),
+    }),
+  ]).optional().describe('Export options'),
+  rowActions: z.array(z.string()).optional().describe('Row action identifiers'),
+  bulkActions: z.array(z.string()).optional().describe('Bulk action identifiers'),
+  sharing: z.object({
+    visibility: z.enum(['private', 'team', 'organization', 'public']).optional(),
+    enabled: z.boolean().optional(),
+    type: z.enum(['personal', 'collaborative']).optional(),
+    lockedBy: z.string().optional(),
+  }).optional().describe('Sharing configuration'),
+  addRecord: z.object({
+    enabled: z.boolean().optional(),
+    position: z.string().optional(),
+    mode: z.string().optional(),
+    formView: z.string().optional(),
+  }).optional().describe('Add record configuration'),
+  conditionalFormatting: z.array(z.union([
+    z.object({
+      field: z.string(),
+      operator: z.enum(['equals', 'not_equals', 'contains', 'greater_than', 'less_than', 'in']),
+      value: z.any(),
+      backgroundColor: z.string().optional(),
+      textColor: z.string().optional(),
+      borderColor: z.string().optional(),
+      expression: z.string().optional(),
+    }),
+    z.object({
+      condition: z.string(),
+      style: z.record(z.string(), z.string()),
+    }),
+  ])).optional().describe('Conditional formatting rules'),
+  quickFilters: z.array(z.object({
+    id: z.string(),
+    label: z.string(),
+    filters: z.array(z.union([z.array(z.any()), z.string()])),
+    icon: z.string().optional(),
+    defaultActive: z.boolean().optional(),
+  })).optional().describe('Quick filter presets'),
+  showRecordCount: z.boolean().optional().describe('Show total record count'),
+  allowPrinting: z.boolean().optional().describe('Allow printing'),
+  virtualScroll: z.boolean().optional().describe('Enable virtual scrolling'),
+  emptyState: z.object({
+    title: z.string().optional(),
+    message: z.string().optional(),
+    icon: z.string().optional(),
+  }).optional().describe('Empty state configuration'),
+  aria: z.object({
+    label: z.string().optional(),
+    describedBy: z.string().optional(),
+    live: z.enum(['polite', 'assertive', 'off']).optional(),
+  }).optional().describe('ARIA attributes'),
 });
 
 /**
@@ -240,12 +395,24 @@ export const ObjectCalendarSchema = BaseSchema.extend({
 /**
  * ObjectKanban Schema
  */
+const KanbanConditionalFormattingRuleSchema = z.object({
+  field: z.string().describe('Field name to check'),
+  operator: z.enum(['equals', 'not_equals', 'contains', 'in']).describe('Comparison operator'),
+  value: z.union([z.string(), z.array(z.string())]).describe('Value to compare against'),
+  backgroundColor: z.string().optional().describe('Background color'),
+  borderColor: z.string().optional().describe('Border color'),
+});
+
 export const ObjectKanbanSchema = BaseSchema.extend({
   type: z.literal('object-kanban'),
   objectName: z.string().describe('ObjectQL object name'),
   groupField: z.string().describe('Group field'),
   titleField: z.string().optional().describe('Title field'),
   cardFields: z.array(z.string()).optional().describe('Card fields'),
+  quickAdd: z.boolean().optional().describe('Enable Quick Add button at column bottom'),
+  coverImageField: z.string().optional().describe('Field name for cover image on cards'),
+  allowCollapse: z.boolean().optional().describe('Allow columns to collapse/expand'),
+  conditionalFormatting: z.array(KanbanConditionalFormattingRuleSchema).optional().describe('Card conditional formatting rules'),
 });
 
 /**

package/src/zod/views.zod.ts

@@ -22,7 +22,7 @@ import { BaseSchema, SchemaNodeSchema } from './base.zod.js';
 /**
  * View Type Schema
  */
-export const ViewTypeSchema = z.enum(['list', 'detail', 'grid', 'kanban', 'calendar', 'timeline', 'map']).describe('View type');
+export const ViewTypeSchema = z.enum(['list', 'detail', 'grid', 'kanban', 'calendar', 'timeline', 'map', 'gallery', 'gantt']).describe('View type');
 
 /**
  * Detail View Field Schema
@@ -30,13 +30,25 @@ export const ViewTypeSchema = z.enum(['list', 'detail', 'grid', 'kanban', 'calen
 export const DetailViewFieldSchema = z.object({
   name: z.string().describe('Field name/path'),
   label: z.string().optional().describe('Display label'),
-  type: z.enum(['text', 'image', 'link', 'badge', 'date', 'datetime', 'json', 'html', 'markdown', 'custom']).optional().describe('Field type for rendering'),
+  type: z.enum([
+    'text', 'number', 'currency', 'percent', 'boolean', 'select', 'lookup', 'master_detail',
+    'email', 'url', 'phone', 'user',
+    'image', 'link', 'badge', 'date', 'datetime', 'json', 'html', 'markdown', 'custom',
+  ]).optional().describe('Field type for rendering'),
   format: z.string().optional().describe('Format string (e.g., date format)'),
   render: SchemaNodeSchema.optional().describe('Custom renderer'),
   value: z.any().optional().describe('Field value'),
   readonly: z.boolean().optional().describe('Whether field is read-only'),
   visible: z.union([z.boolean(), z.string()]).optional().describe('Field visibility condition'),
   span: z.number().optional().describe('Span across columns (for grid layout)'),
+  options: z.array(z.object({
+    label: z.string(),
+    value: z.union([z.string(), z.number(), z.boolean()]),
+    color: z.string().optional(),
+  })).optional().describe('Options for select/lookup fields'),
+  reference_to: z.string().optional().describe('Referenced object name for lookup/master_detail fields'),
+  reference_field: z.string().optional().describe('Display field on the referenced object'),
+  currency: z.string().optional().describe('Currency code for currency fields (e.g. USD, EUR)'),
 });
 
 /**
@@ -51,6 +63,8 @@ export const DetailViewSectionSchema = z.object({
   defaultCollapsed: z.boolean().optional().describe('Default collapsed state'),
   columns: z.number().optional().describe('Grid columns for field layout'),
   visible: z.union([z.boolean(), z.string()]).optional().describe('Section visibility condition'),
+  showBorder: z.boolean().optional().describe('Show border around section'),
+  headerColor: z.string().optional().describe('Header background color (Tailwind class)'),
 });
 
 /**
@@ -119,6 +133,11 @@ export const ViewSwitcherSchema = BaseSchema.extend({
   onViewChange: z.string().optional().describe('View change callback'),
   persistPreference: z.boolean().optional().describe('Persist view preference'),
   storageKey: z.string().optional().describe('Storage key for persisting view'),
+  allowCreateView: z.boolean().optional().describe('Show "+" button to add/create a new view'),
+  viewActions: z.array(z.object({
+    type: z.enum(['share', 'settings', 'duplicate', 'delete']).describe('Action type'),
+    icon: z.string().optional().describe('Action icon'),
+  })).optional().describe('Per-view action icons'),
 });
 
 /**