@object-ui/types 3.0.3 → 3.1.1

package/dist/objectql.d.ts

@@ -53,7 +53,27 @@ export type { SelectionConfig } from '@objectstack/spec/ui';
  * Canonical definition from @objectstack/spec/ui.
  */
 export type { PaginationConfig } from '@objectstack/spec/ui';
-import type { ViewData, ListColumn, SelectionConfig, PaginationConfig, GroupingConfig, RowColorConfig } from '@objectstack/spec/ui';
+import type { ViewData, ListColumn, SelectionConfig, 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).
@@ -107,6 +127,81 @@ export interface SortConfig {
     /** Sort order */
     order: 'asc' | 'desc';
 }
+/**
+ * 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;
+/**
+ * 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.
@@ -314,6 +409,12 @@ 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)
      * Groups rows by specified fields with collapsible sections.
@@ -340,6 +441,28 @@ export interface ObjectGridSchema extends BaseSchema {
      * @default 0
      */
     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.
@@ -351,6 +474,40 @@ 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;
+    };
 }
 /**
  * Form Section Configuration
@@ -689,6 +846,11 @@ export interface ObjectViewSchema extends BaseSchema {
      * @default true
      */
     showFilters?: boolean;
+    /**
+     * Show sort controls
+     * @default true
+     */
+    showSort?: boolean;
     /**
      * Show create button
      * @default true
@@ -701,7 +863,7 @@ export interface ObjectViewSchema extends BaseSchema {
     showRefresh?: boolean;
     /**
      * 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;
@@ -722,6 +884,46 @@ 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;
 }
 /**
  * Named List View Definition
@@ -743,6 +945,121 @@ 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';
+    };
 }
 /**
  * Navigation configuration for row/item click behavior.
@@ -785,6 +1102,25 @@ export interface ListViewSchema extends BaseSchema {
     objectName: string;
     /** 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;
@@ -798,16 +1134,23 @@ 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) */
     fields?: string[];
     /** Filter conditions */
     filters?: Array<any[] | string>;
-    /** Sort order */
+    /** 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[];
     /** Fields available for filter UI */
@@ -827,6 +1170,24 @@ export interface ListViewSchema extends BaseSchema {
     striped?: boolean;
     /** 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;
     /**
@@ -858,12 +1219,248 @@ 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;
+    };
+    /**
+     * 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;
 }
-/**
- * Object Map Component Schema
- */
 export interface ObjectMapSchema extends BaseSchema {
     type: 'object-map';
     /** ObjectQL object name */
@@ -920,6 +1517,43 @@ 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;
 }
 /**
  * Object Chart Component Schema