@object-ui/types 3.0.3 → 3.1.0

package/src/objectql.ts

@@ -78,8 +78,32 @@ import type {
   PaginationConfig,
   GroupingConfig,
   RowColorConfig,
+  GalleryConfig,
+  TimelineConfig,
 } from '@objectstack/spec/ui';
 
+/**
+ * Gallery configuration extended with legacy fields for backward compatibility.
+ * Spec fields from GalleryConfigSchema take priority; legacy fields serve as fallbacks.
+ */
+export type ListViewGalleryConfig = GalleryConfig & {
+  /** Legacy: image field (deprecated, use coverField) */
+  imageField?: string;
+  /** Legacy: subtitle field */
+  subtitleField?: string;
+  [key: string]: any;
+};
+
+/**
+ * Timeline configuration extended with legacy fields for backward compatibility.
+ * Spec fields from TimelineConfigSchema take priority; legacy fields serve as fallbacks.
+ */
+export type ListViewTimelineConfig = TimelineConfig & {
+  /** Legacy: date field (deprecated, use startDateField) */
+  dateField?: string;
+  [key: string]: any;
+};
+
 /**
  * Kanban Configuration
  * Canonical definition from @objectstack/spec/ui (KanbanConfigSchema).
@@ -137,6 +161,95 @@ export interface SortConfig {
   order: 'asc' | 'desc';
 }
 
+// ============================================================================
+// QuickFilter Types — Dual-format support
+// ============================================================================
+
+/**
+ * ObjectUI-native QuickFilter format.
+ * Each quick filter renders as a toggle button with explicit id, label, and filter conditions.
+ */
+export interface ObjectUIQuickFilterItem {
+  /** Unique identifier for this quick filter */
+  id: string;
+  /** Display label for the filter button */
+  label: string;
+  /** Filter conditions to apply when activated */
+  filters: Array<any[] | string>;
+  /** Icon name (Lucide icon identifier) */
+  icon?: string;
+  /** Default active state */
+  defaultActive?: boolean;
+}
+
+/**
+ * Spec-format QuickFilter item (from @objectstack/spec).
+ * A single field-level predicate: `{ field, operator, value }`.
+ * Automatically converted to ObjectUI format at runtime.
+ */
+export interface SpecQuickFilterItem {
+  /** Field name to filter on */
+  field: string;
+  /** Filter operator (e.g. 'eq', 'equals', 'contains', 'gt', etc.) */
+  operator: string;
+  /** Value to compare against */
+  value: unknown;
+  /** Optional display label (auto-generated if omitted) */
+  label?: string;
+  /** Icon name (Lucide icon identifier) */
+  icon?: string;
+  /** Default active state */
+  defaultActive?: boolean;
+}
+
+/**
+ * Union type for QuickFilter items — accepts both ObjectUI and Spec formats.
+ */
+export type QuickFilterItem = ObjectUIQuickFilterItem | SpecQuickFilterItem;
+
+// ============================================================================
+// ConditionalFormatting Types — Dual-format support
+// ============================================================================
+
+/**
+ * ObjectUI-native ConditionalFormatting rule.
+ * Uses field/operator/value for declarative comparisons.
+ */
+export interface ObjectUIConditionalFormattingRule {
+  /** Field name to evaluate */
+  field: string;
+  /** Comparison operator */
+  operator: 'equals' | 'not_equals' | 'contains' | 'greater_than' | 'less_than' | 'in';
+  /** Value to compare against */
+  value: unknown;
+  /** CSS-compatible background color */
+  backgroundColor?: string;
+  /** CSS-compatible text color */
+  textColor?: string;
+  /** CSS-compatible border color */
+  borderColor?: string;
+  /** Template expression override (e.g., '${data.amount > 1000}') */
+  expression?: string;
+}
+
+/**
+ * Spec-format ConditionalFormatting rule (from @objectstack/spec).
+ * Uses a plain expression string with a style map.
+ * Automatically evaluated at runtime via ExpressionEvaluator.
+ */
+export interface SpecConditionalFormattingRule {
+  /** Plain condition expression (e.g., "status == 'overdue'") or template expression (e.g., "${data.amount > 1000}") */
+  condition: string;
+  /** Style map to apply when condition matches (e.g., { backgroundColor: '#fee2e2', color: '#991b1b' }) */
+  style: Record<string, string>;
+}
+
+/**
+ * Union type for ConditionalFormatting rules — accepts both ObjectUI and Spec formats.
+ * Rules are evaluated in order; first matching rule wins.
+ */
+export type ConditionalFormattingRule = ObjectUIConditionalFormattingRule | SpecConditionalFormattingRule;
+
 /**
  * ObjectGrid Schema
  * A specialized grid component that automatically fetches and displays data from ObjectQL objects.
@@ -384,6 +497,13 @@ export interface ObjectGridSchema extends BaseSchema {
    * @default false
    */
   editable?: boolean;
+
+  /**
+   * Enable single-click editing mode
+   * When true with editable, clicking a cell enters edit mode (instead of double-click)
+   * @default false
+   */
+  singleClickEdit?: boolean;
   
   /**
    * Grouping Configuration (Airtable-style)
@@ -415,6 +535,30 @@ export interface ObjectGridSchema extends BaseSchema {
    */
   frozenColumns?: number;
 
+  /**
+   * Row height preset for the grid.
+   * Controls the density of grid rows.
+   * Aligned with @objectstack/spec RowHeight enum.
+   * @default 'compact'
+   */
+  rowHeight?: 'compact' | 'short' | 'medium' | 'tall' | 'extra_tall';
+
+  /**
+   * Export options configuration for exporting grid data.
+   * Supports csv, xlsx, json, and pdf formats.
+   * Aligned with @objectstack/spec ListViewSchema.exportOptions.
+   */
+  exportOptions?: {
+    /** Formats available for export */
+    formats?: Array<'csv' | 'xlsx' | 'json' | 'pdf'>;
+    /** Maximum number of records to export (0 = unlimited) */
+    maxRecords?: number;
+    /** Include column headers in export */
+    includeHeaders?: boolean;
+    /** Custom file name prefix */
+    fileNamePrefix?: string;
+  };
+
   /**
    * Navigation configuration for row click behavior.
    * Controls how record detail is displayed when a row is clicked.
@@ -427,6 +571,45 @@ export interface ObjectGridSchema extends BaseSchema {
    * Called with recordId and action ('view' | 'edit').
    */
   onNavigate?: (recordId: string | number, action?: string) => void;
+
+  /**
+   * Conditional formatting rules for row/cell styling.
+   * Aligned with @objectstack/spec ListViewSchema.conditionalFormatting.
+   * Supports both ObjectUI field/operator/value rules and Spec expression-based { condition, style } rules.
+   */
+  conditionalFormatting?: ConditionalFormattingRule[];
+
+  /**
+   * Enable virtual scrolling for large datasets.
+   * Aligned with @objectstack/spec ListViewSchema.virtualScroll.
+   * @default false
+   */
+  virtualScroll?: boolean;
+
+  /**
+   * Row action identifiers (action names from ActionSchema).
+   * Aligned with @objectstack/spec ListViewSchema.rowActions.
+   */
+  rowSpecActions?: string[];
+
+  /**
+   * Bulk action identifiers (action names from ActionSchema).
+   * Aligned with @objectstack/spec ListViewSchema.bulkActions.
+   */
+  bulkSpecActions?: string[];
+
+  /**
+   * Empty state configuration shown when no data is available.
+   * Aligned with @objectstack/spec ListViewSchema.emptyState.
+   */
+  emptyState?: {
+    /** Title text for the empty state */
+    title?: string;
+    /** Message/description for the empty state */
+    message?: string;
+    /** Icon name (Lucide icon identifier) */
+    icon?: string;
+  };
 }
 
 /**
@@ -835,6 +1018,12 @@ export interface ObjectViewSchema extends BaseSchema {
    */
   showFilters?: boolean;
   
+  /**
+   * Show sort controls
+   * @default true
+   */
+  showSort?: boolean;
+  
   /**
    * Show create button
    * @default true
@@ -849,7 +1038,7 @@ export interface ObjectViewSchema extends BaseSchema {
   
   /**
    * Show view switcher (for multi-view)
-   * When false (default), view type is fixed at creation in ViewDesigner
+   * When false (default), view type is fixed at creation in ViewConfigPanel
    * @default false
    */
   showViewSwitcher?: boolean;
@@ -873,6 +1062,50 @@ export interface ObjectViewSchema extends BaseSchema {
    * Custom CSS class
    */
   className?: string;
+
+  /**
+   * View tab bar UX configuration (inline add, context menu, overflow, indicators).
+   */
+  viewTabBar?: ViewTabBarConfig;
+
+  /**
+   * Show "+" button in ViewSwitcher to create a new view.
+   * Typically gated on admin permission.
+   */
+  allowCreateView?: boolean;
+
+  /**
+   * Per-view action icons shown in ViewSwitcher (e.g., share, settings, duplicate, delete).
+   */
+  viewActions?: Array<{
+    type: 'share' | 'settings' | 'duplicate' | 'delete';
+    icon?: string;
+  }>;
+}
+
+/**
+ * View Tab Bar Configuration
+ * Controls the UX of the view tab bar (inline add, context menu, overflow, indicators).
+ */
+export interface ViewTabBarConfig {
+  /** Show inline "+" button to create new views @default true */
+  showAddButton?: boolean;
+  /** Allow inline renaming by double-clicking tab @default true */
+  inlineRename?: boolean;
+  /** Show context menu on right-click @default true */
+  contextMenu?: boolean;
+  /** Allow drag-reorder of view tabs @default false */
+  reorderable?: boolean;
+  /** Max visible tabs before overflow → "More" dropdown @default 6 */
+  maxVisibleTabs?: number;
+  /** Show filter/sort indicator badges on tabs @default true */
+  showIndicators?: boolean;
+  /** Show "Save as View" when filters differ from saved @default true */
+  showSaveAsView?: boolean;
+  /** Show pinned views section @default true */
+  showPinnedSection?: boolean;
+  /** Group tabs by personal/shared @default false */
+  showVisibilityGroups?: boolean;
 }
 
 /**
@@ -897,6 +1130,158 @@ export interface NamedListView {
   
   /** Type-specific options (kanban groupField, calendar startDateField, etc.) */
   options?: Record<string, any>;
+
+  /** Show search box in toolbar @default true */
+  showSearch?: boolean;
+
+  /** Show sort controls in toolbar @default true */
+  showSort?: boolean;
+
+  /** Show filter controls in toolbar @default true */
+  showFilters?: boolean;
+
+  /** Show hide-fields button in toolbar @default false */
+  showHideFields?: boolean;
+
+  /** Show group button in toolbar @default true */
+  showGroup?: boolean;
+
+  /** Show color button in toolbar @default false */
+  showColor?: boolean;
+
+  /** Show density/row-height button in toolbar @default false */
+  showDensity?: boolean;
+
+  /** Allow data export @default undefined */
+  allowExport?: boolean;
+
+  /** Show alternating row colors @default false */
+  striped?: boolean;
+
+  /** Show cell borders @default false */
+  bordered?: boolean;
+
+  /** Color field for row/card coloring */
+  color?: string;
+
+  /** Enable inline editing @default false */
+  inlineEdit?: boolean;
+
+  /** Wrap column headers in grid view @default false */
+  wrapHeaders?: boolean;
+
+  /** Navigate to record detail view when row is clicked @default true */
+  clickIntoRecordDetails?: boolean;
+
+  /** Add records via a form dialog @default false */
+  addRecordViaForm?: boolean;
+
+  /** Enable inline add/delete of records @default false */
+  addDeleteRecordsInline?: boolean;
+
+  /** Collapse all grouped sections by default @default false */
+  collapseAllByDefault?: boolean;
+
+  /** Field name for custom text color */
+  fieldTextColor?: string;
+
+  /** Prefix field displayed before the main title */
+  prefixField?: string;
+
+  /** View description */
+  description?: string;
+
+  /** Show field descriptions below headers @default false */
+  showDescription?: boolean;
+
+  /** Navigation configuration for row click behavior */
+  navigation?: ViewNavigationConfig;
+
+  /** Row selection mode */
+  selection?: { type: 'none' | 'single' | 'multiple' };
+
+  /** Pagination configuration */
+  pagination?: { pageSize: number; pageSizeOptions?: number[] };
+
+  /** Fields that support text search */
+  searchableFields?: string[];
+
+  /** Fields available for filter UI */
+  filterableFields?: string[];
+
+  /** Allow column resizing @default false */
+  resizable?: boolean;
+
+  /** Density mode for controlling row/item spacing */
+  densityMode?: 'compact' | 'comfortable' | 'spacious';
+
+  /**
+   * Row height for list/grid view rows.
+   * Aligned with @objectstack/spec RowHeight enum.
+   */
+  rowHeight?: 'compact' | 'short' | 'medium' | 'tall' | 'extra_tall';
+
+  /** Fields to hide from the current view */
+  hiddenFields?: string[];
+
+  /** Export options configuration */
+  exportOptions?: {
+    formats?: Array<'csv' | 'xlsx' | 'json' | 'pdf'>;
+    maxRecords?: number;
+    includeHeaders?: boolean;
+    fileNamePrefix?: string;
+  };
+
+  /** Row action identifiers */
+  rowActions?: string[];
+
+  /** Bulk action identifiers */
+  bulkActions?: string[];
+
+  /** View sharing configuration */
+  sharing?: {
+    visibility?: 'private' | 'team' | 'organization' | 'public';
+    enabled?: boolean;
+  };
+
+  /** Add record configuration */
+  addRecord?: {
+    enabled?: boolean;
+    position?: string;
+    mode?: string;
+    formView?: string;
+  };
+
+  /** Conditional formatting rules.
+   * Supports both ObjectUI field/operator/value rules and Spec expression-based { condition, style } rules. */
+  conditionalFormatting?: ConditionalFormattingRule[];
+
+  /** Quick filter buttons for predefined filter presets.
+   * Supports both ObjectUI format and Spec format (auto-converted at runtime). */
+  quickFilters?: QuickFilterItem[];
+
+  /** Show total record count @default false */
+  showRecordCount?: boolean;
+
+  /** Allow printing the view @default false */
+  allowPrinting?: boolean;
+
+  /** Enable virtual scrolling for large datasets @default false */
+  virtualScroll?: boolean;
+
+  /** Empty state configuration */
+  emptyState?: {
+    title?: string;
+    message?: string;
+    icon?: string;
+  };
+
+  /** ARIA attributes for accessibility */
+  aria?: {
+    label?: string;
+    describedBy?: string;
+    live?: 'polite' | 'assertive' | 'off';
+  };
 }
 
 /**
@@ -949,7 +1334,29 @@ export interface ListViewSchema extends BaseSchema {
   
   /** View Type (grid, kanban, etc.) @default 'grid' */
   viewType?: 'grid' | 'kanban' | 'gallery' | 'calendar' | 'timeline' | 'gantt' | 'map';
-  
+
+  /**
+   * Data Source Configuration.
+   * Aligned with @objectstack/spec ViewDataSchema.
+   * Supports provider: 'object' (fetch from objectName), 'value' (inline items), 'api' (custom endpoint).
+   * If not provided, defaults to fetching from objectName via dataSource.find().
+   */
+  data?: ViewData;
+
+  /**
+   * Grouping Configuration (Airtable-style).
+   * Groups rows by specified fields with collapsible sections.
+   * Aligned with @objectstack/spec GroupingConfigSchema.
+   */
+  grouping?: GroupingConfig;
+
+  /**
+   * Row Color Configuration (Airtable-style).
+   * Colors rows based on field values.
+   * Aligned with @objectstack/spec RowColorConfigSchema.
+   */
+  rowColor?: RowColorConfig;
+
   /** Columns definition (string field names or full column config) */
   columns?: string[] | Array<{
     field: string;
@@ -963,6 +1370,10 @@ export interface ListViewSchema extends BaseSchema {
     type?: string;
     link?: boolean;
     action?: string;
+    /** Pin column to left or right edge */
+    pinned?: 'left' | 'right';
+    /** Column footer summary/aggregation (e.g., 'count', 'sum', 'avg') */
+    summary?: string | { type: 'count' | 'sum' | 'avg' | 'min' | 'max'; field?: string };
   }>;
   
   /** Fields to fetch/display (alias for simple string[] columns) */
@@ -971,8 +1382,8 @@ export interface ListViewSchema extends BaseSchema {
   /** Filter conditions */
   filters?: Array<any[] | string>;
   
-  /** Sort order */
-  sort?: Array<{ field: string; order: 'asc' | 'desc' }>;
+  /** Sort order. Supports array of objects or legacy string format "field desc" */
+  sort?: Array<{ field: string; order: 'asc' | 'desc' } | string>;
   
   /** Fields that support text search */
   searchableFields?: string[];
@@ -994,6 +1405,33 @@ export interface ListViewSchema extends BaseSchema {
   
   /** Show cell borders @default false */
   bordered?: boolean;
+
+  /** Show search box in toolbar @default true */
+  showSearch?: boolean;
+
+  /** Show sort controls in toolbar @default true */
+  showSort?: boolean;
+
+  /** Show filter controls in toolbar @default true */
+  showFilters?: boolean;
+
+  /** Show hide-fields button in toolbar @default false */
+  showHideFields?: boolean;
+
+  /** Show group button in toolbar @default true */
+  showGroup?: boolean;
+
+  /** Show color button in toolbar @default false */
+  showColor?: boolean;
+
+  /** Show density/row-height button in toolbar @default false */
+  showDensity?: boolean;
+
+  /** Allow data export @default undefined */
+  allowExport?: boolean;
+
+  /** Color field for row/card coloring */
+  color?: string;
   
   /** Navigation config for row click behavior */
   navigation?: ViewNavigationConfig;
@@ -1030,14 +1468,283 @@ export interface ListViewSchema extends BaseSchema {
     dependenciesField?: string;
     [key: string]: any;
   };
+
+  /** Gallery-specific configuration. Aligned with @objectstack/spec GalleryConfigSchema. */
+  gallery?: ListViewGalleryConfig;
+
+  /** Timeline-specific configuration. Aligned with @objectstack/spec TimelineConfigSchema. */
+  timeline?: ListViewTimelineConfig;
   
   /** Visual Component overrides (legacy, prefer typed configs above) */
   options?: Record<string, any>;
-}
+  
+  /** 
+   * Empty state configuration shown when no data is available.
+   * Aligned with @objectstack/spec ListViewSchema.emptyState.
+   */
+  emptyState?: {
+    /** Title text for the empty state */
+    title?: string;
+    /** Message/description for the empty state */
+    message?: string;
+    /** Icon name (Lucide icon identifier) for the empty state */
+    icon?: string;
+  };
 
-/**
- * Object Map Component Schema
- */
+  /**
+   * Quick filter buttons for predefined filter presets.
+   * Supports both ObjectUI format and Spec format (auto-converted at runtime).
+   */
+  quickFilters?: QuickFilterItem[];
+
+  /**
+   * Fields to hide from the current view.
+   * Hides columns in grid view or fields in other view types.
+   */
+  hiddenFields?: string[];
+
+  /**
+   * Custom field display order. Fields listed first appear first.
+   * Fields not listed are appended in their original order.
+   */
+  fieldOrder?: string[];
+
+  /**
+   * Export options configuration for exporting list data.
+   * Supports both ObjectUI object format and spec simple string[] format.
+   * Spec format: ['csv', 'xlsx'] (simple array of format strings)
+   * ObjectUI format: { formats, maxRecords, includeHeaders, fileNamePrefix }
+   */
+  exportOptions?: Array<'csv' | 'xlsx' | 'json' | 'pdf'> | {
+    /** Formats available for export */
+    formats?: Array<'csv' | 'xlsx' | 'json' | 'pdf'>;
+    /** Maximum number of records to export (0 = unlimited) */
+    maxRecords?: number;
+    /** Include column headers in export */
+    includeHeaders?: boolean;
+    /** Custom file name prefix */
+    fileNamePrefix?: string;
+  };
+
+  /**
+   * Density mode for controlling row/item spacing.
+   * Aligned with @objectstack/spec DensityMode.
+   */
+  densityMode?: 'compact' | 'comfortable' | 'spacious';
+
+  /**
+   * Row height for list/grid view rows.
+   * Aligned with @objectstack/spec RowHeight enum.
+   */
+  rowHeight?: 'compact' | 'short' | 'medium' | 'tall' | 'extra_tall';
+
+  /**
+   * Conditional formatting rules for row/cell styling.
+   * Rules are evaluated in order; first matching rule wins.
+   * Supports both ObjectUI field/operator/value rules and spec expression-based { condition, style } rules.
+   */
+  conditionalFormatting?: ConditionalFormattingRule[];
+
+  /**
+   * Enable inline editing for list view fields.
+   * When true, cells become editable on click/double-click.
+   */
+  inlineEdit?: boolean;
+
+  /** Wrap column headers in grid view @default false */
+  wrapHeaders?: boolean;
+
+  /** Navigate to record detail view when row is clicked @default true */
+  clickIntoRecordDetails?: boolean;
+
+  /** Add records via a form dialog @default false */
+  addRecordViaForm?: boolean;
+
+  /** Enable inline add/delete of records @default false */
+  addDeleteRecordsInline?: boolean;
+
+  /** Collapse all grouped sections by default @default false */
+  collapseAllByDefault?: boolean;
+
+  /** Field name for custom text color */
+  fieldTextColor?: string;
+
+  /** Prefix field displayed before the main title */
+  prefixField?: string;
+
+  /** Show field descriptions below headers @default false */
+  showDescription?: boolean;
+
+  /**
+   * ARIA attributes for accessibility.
+   * Applied to the root list container element.
+   */
+  aria?: {
+    /** Accessible label for the list view */
+    label?: string;
+    /** ID of the element that describes the list view */
+    describedBy?: string;
+    /** Live region politeness for dynamic updates */
+    live?: 'polite' | 'assertive' | 'off';
+  };
+
+  /**
+   * View sharing configuration.
+   * Supports both ObjectUI format { visibility, enabled } and spec format { type, lockedBy }.
+   * Controls who can see this view and enables share UI.
+   */
+  sharing?: {
+    /** Visibility level for the view (ObjectUI format) */
+    visibility?: 'private' | 'team' | 'organization' | 'public';
+    /** Whether sharing controls are shown in the toolbar */
+    enabled?: boolean;
+    /** Sharing type (spec format: personal or collaborative) */
+    type?: 'personal' | 'collaborative';
+    /** User who locked the view (spec format) */
+    lockedBy?: string;
+  };
+
+  /**
+   * User Filters Configuration (Airtable Interfaces-style).
+   *
+   * Supports three display modes configured by `element`:
+   * - 'dropdown': Each field renders as a dropdown selector badge (e.g., "Status ∨")
+   * - 'tabs': Named filter presets rendered as a tab bar (e.g., "Tab | my customers | All records")
+   * - 'toggle': Each filter field renders as an on/off toggle button
+   */
+  userFilters?: {
+    /** UI element type for displaying filters */
+    element: 'dropdown' | 'tabs' | 'toggle';
+
+    /**
+     * Field-level filter definitions (used by 'dropdown' and 'toggle' modes).
+     * Each field appears as an independent filter control in the toolbar.
+     */
+    fields?: Array<{
+      /** Field name to filter on */
+      field: string;
+      /** Display label (defaults to field label from objectDef) */
+      label?: string;
+      /** Filter input type */
+      type?: 'select' | 'multi-select' | 'boolean' | 'date-range' | 'text';
+      /** Static options (overrides auto-derived from objectDef) */
+      options?: Array<{
+        label: string;
+        value: string | number | boolean;
+        color?: string;
+      }>;
+      /** Show record count per option */
+      showCount?: boolean;
+      /** Default selected values */
+      defaultValues?: (string | number | boolean)[];
+    }>;
+
+    /**
+     * Named filter presets (used by 'tabs' mode).
+     * Each tab represents a pre-configured filter combination.
+     */
+    tabs?: Array<{
+      /** Unique tab identifier */
+      id: string;
+      /** Tab display label */
+      label: string;
+      /** Filter conditions to apply when this tab is active */
+      filters: Array<any[] | string>;
+      /** Icon name (Lucide icon identifier) */
+      icon?: string;
+      /** Whether this is the default active tab */
+      default?: boolean;
+    }>;
+
+    /** Allow users to add new filter tabs at runtime */
+    allowAddTab?: boolean;
+    /** Show "All records" tab (tabs mode) */
+    showAllRecords?: boolean;
+  };
+
+  /**
+   * Row action identifiers (action names from ActionSchema).
+   * Aligned with @objectstack/spec ListViewSchema.rowActions.
+   */
+  rowActions?: string[];
+
+  /**
+   * Bulk action identifiers (action names from ActionSchema).
+   * Aligned with @objectstack/spec ListViewSchema.bulkActions.
+   */
+  bulkActions?: string[];
+
+  /**
+   * Enable virtual scrolling for large datasets.
+   * Aligned with @objectstack/spec ListViewSchema.virtualScroll.
+   * @default false
+   */
+  virtualScroll?: boolean;
+
+  /**
+   * User actions configuration.
+   * Controls what UI actions are available to end users.
+   * Aligned with @objectstack/spec ListViewSchema.userActions.
+   */
+  userActions?: {
+    sort?: boolean;
+    search?: boolean;
+    filter?: boolean;
+    rowHeight?: boolean;
+    addRecordForm?: boolean;
+    buttons?: string[];
+  };
+
+  /**
+   * Appearance configuration.
+   * Aligned with @objectstack/spec ListViewSchema.appearance.
+   */
+  appearance?: {
+    showDescription?: boolean;
+    allowedVisualizations?: string[];
+  };
+
+  /**
+   * View tabs configuration.
+   * Aligned with @objectstack/spec ListViewSchema.tabs.
+   */
+  tabs?: Array<{
+    name: string;
+    label: string;
+    icon?: string;
+    view?: string;
+    filter?: any;
+    order?: number;
+    pinned?: boolean;
+    isDefault?: boolean;
+    visible?: string;
+  }>;
+
+  /**
+   * Add record configuration.
+   * Aligned with @objectstack/spec ListViewSchema.addRecord.
+   */
+  addRecord?: {
+    enabled?: boolean;
+    position?: string;
+    mode?: string;
+    formView?: string;
+  };
+
+  /**
+   * Show total record count in the view.
+   * Aligned with @objectstack/spec ListViewSchema.showRecordCount.
+   * @default false
+   */
+  showRecordCount?: boolean;
+
+  /**
+   * Allow printing the view.
+   * Aligned with @objectstack/spec ListViewSchema.allowPrinting.
+   * @default false
+   */
+  allowPrinting?: boolean;
+}
 export interface ObjectMapSchema extends BaseSchema {
   type: 'object-map';
   /** ObjectQL object name */
@@ -1097,6 +1804,48 @@ export interface ObjectKanbanSchema extends BaseSchema {
   titleField?: string;
   /** Fields to display on card */
   cardFields?: string[];
+
+  /**
+   * Enable Quick Add button at the bottom of each column.
+   * When true, a "+" button appears allowing inline card creation.
+   * @default false
+   */
+  quickAdd?: boolean;
+
+  /**
+   * Field name to use as cover image on cards.
+   * The field value should be a URL string or file object with a `url` property.
+   */
+  coverImageField?: string;
+
+  /**
+   * Allow columns to be collapsed/expanded.
+   * Collapsed columns show only the title and card count.
+   * @default false
+   */
+  allowCollapse?: boolean;
+
+  /**
+   * Conditional formatting rules for card coloring.
+   * Cards are colored based on field values matching conditions.
+   */
+  conditionalFormatting?: KanbanConditionalFormattingRule[];
+}
+
+/**
+ * Conditional formatting rule for Kanban cards
+ */
+export interface KanbanConditionalFormattingRule {
+  /** Field name to check */
+  field: string;
+  /** Operator for comparison */
+  operator: 'equals' | 'not_equals' | 'contains' | 'in';
+  /** Value to compare against */
+  value: string | string[];
+  /** Background color to apply (Tailwind class or CSS color) */
+  backgroundColor?: string;
+  /** Border color to apply (Tailwind class or CSS color) */
+  borderColor?: string;
 }
 
 /**