/**
 * ObjectUI
 * Copyright (c) 2024-present ObjectStack Inc.
 *
 * This source code is licensed under the MIT license found in the
 * LICENSE file in the root directory of this source tree.
 */
/**
 * @object-ui/types - ObjectQL Component Schemas
 *
 * Type definitions for ObjectQL-specific components.
 * These schemas enable building ObjectQL-aware interfaces directly from object metadata.
 *
 * Now aligned with @objectstack/spec view.zod schema for better interoperability.
 *
 * @module objectql
 * @packageDocumentation
 */
import type { BaseSchema } from './base';
import type { FormField } from './form';
/**
 * HTTP Method for API requests
 * Canonical definition from @objectstack/spec/ui.
 */
export type { HttpMethod } from '@objectstack/spec/ui';
/**
 * HTTP Request Configuration for API Provider
 * Canonical definition from @objectstack/spec/ui.
 */
export type { HttpRequest } from '@objectstack/spec/ui';
/**
 * View Data Source Configuration
 * Canonical definition from @objectstack/spec/ui.
 *
 * Supports three modes:
 * 1. 'object': Standard Protocol - Auto-connects to ObjectStack Metadata and Data APIs
 * 2. 'api': Custom API - Explicitly provided API URLs
 * 3. 'value': Static Data - Hardcoded data array
 */
export type { ViewData } from '@objectstack/spec/ui';
/**
 * List Column Configuration
 * Canonical definition from @objectstack/spec/ui.
 */
export type { ListColumn } from '@objectstack/spec/ui';
/**
 * Selection Configuration
 * Canonical definition from @objectstack/spec/ui.
 */
export type { SelectionConfig } from '@objectstack/spec/ui';
/**
 * Pagination Configuration
 * Canonical definition from @objectstack/spec/ui.
 */
export type { PaginationConfig } 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).
 */
export type KanbanConfig = {
    /** Field to group columns by (usually status/select) */
    groupByField: string;
    /** Field to sum at top of column (e.g. amount) */
    summarizeField?: string;
    /** Fields to show on cards */
    columns: string[];
};
/**
 * Calendar Configuration
 * Canonical definition from @objectstack/spec/ui (CalendarConfigSchema).
 */
export type CalendarConfig = {
    /** Start date field */
    startDateField: string;
    /** End date field */
    endDateField?: string;
    /** Title field */
    titleField: string;
    /** Color field */
    colorField?: string;
};
/**
 * Gantt Configuration
 * Canonical definition from @objectstack/spec/ui (GanttConfigSchema).
 */
export type GanttConfig = {
    /** Start date field */
    startDateField: string;
    /** End date field */
    endDateField: string;
    /** Title field */
    titleField: string;
    /** Progress field (0-100) */
    progressField?: string;
    /** Dependencies field */
    dependenciesField?: string;
    /** Color field */
    colorField?: string;
    /**
     * Fields to surface in the hover tooltip (悬浮详情), in display order.
     * ObjectUI display extension — not part of the upstream GanttConfigSchema.
     * Each entry is either a field name (string) or `{ field, label? }` to
     * override the label; values are formatted by field type. When omitted the
     * tooltip falls back to the built-in start → end · duration · progress line.
     */
    tooltipFields?: Array<string | {
        field: string;
        label?: string;
    }>;
};
/**
 * Sort Configuration
 */
export interface SortConfig {
    /** Field to sort by */
    field: string;
    /** Sort order */
    order: 'asc' | 'desc';
}
/**
 * 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;
/**
 * Parameter declaration for a bulk action. Rendered as a single field in the
 * BulkActionDialog params step. Mirrors a minimal FormField shape so existing
 * field widgets (text/number/select/lookup/boolean/date) can render it.
 */
export interface BulkActionParam {
    /** Parameter name — passed to the runtime handler as params[name]. */
    name: string;
    /** Human-readable label (i18n-resolved upstream). */
    label?: string;
    /** Optional help text shown beneath the field. */
    help?: string;
    /**
     * Field widget type — one of the standard FieldWidget names.
     * Common values: 'text' | 'number' | 'select' | 'lookup' | 'boolean' | 'date' | 'datetime' | 'textarea'.
     */
    type: string;
    /** Whether the param is required to enable the Confirm button. */
    required?: boolean;
    /** Default value applied when the dialog opens. */
    default?: unknown;
    /** Static options for select-style fields. */
    options?: Array<{
        label: string;
        value: string | number | boolean;
    }>;
    /** For lookup widgets — the related object name (e.g. 'user'). */
    object?: string;
    /** Placeholder text. */
    placeholder?: string;
    /**
     * Catch-all for extra widget-specific configuration (min/max/step/format/...).
     * Forwarded to the underlying field renderer as-is.
     */
    [key: string]: unknown;
}
/**
 * Bulk action operation kind. Determines which `dataSource` method the executor
 * calls per batch. `custom` defers entirely to `onComplete` event handlers and
 * is intended for callouts (notify/export/...) that don't mutate records.
 */
export type BulkActionOperation = 'update' | 'delete' | 'custom';
/**
 * Rich, schema-driven definition of a bulk action.
 *
 * The grid renders one button per def in the BulkActionBar. Clicking it opens
 * the BulkActionDialog: params form → confirm → progress → result. The executor
 * batches selected records via `dataSource.bulk(resource, op, items)`.
 *
 * Pair with the legacy `bulkActions: string[]` field — `bulkActionDefs` takes
 * precedence when both are set, but legacy IDs still render alongside as
 * fallback buttons.
 */
export interface BulkActionDef {
    /** Stable identifier — also used as the action key in audit logs. */
    name: string;
    /** Human-readable label shown on the button + dialog header. */
    label?: string;
    /** Lucide icon name (e.g. 'user-check', 'trash-2'); falls back to a generic icon. */
    icon?: string;
    /** Visual treatment of the action button. */
    variant?: 'primary' | 'secondary' | 'danger' | 'ghost' | 'outline';
    /** Operation kind — drives how the executor mutates records. */
    operation: BulkActionOperation;
    /**
     * For `operation: 'update'`, a static patch applied to every selected record
     * (merged AFTER user-supplied params). Allows declaring fixed-value mass
     * updates without exposing them in the params form.
     */
    patch?: Record<string, unknown>;
    /**
     * Parameters collected from the user before execution. Empty/undefined →
     * dialog skips the params step and jumps straight to confirm.
     */
    params?: BulkActionParam[];
    /** Confirmation text shown above the affected-record summary. */
    confirmText?: string;
    /** Custom Confirm button label (default: "Run"). */
    confirmLabel?: string;
    /** Permission check expression — disables the button when it returns falsy. */
    visible?: string;
    /** Max records the action will operate on; selection above this is blocked. */
    maxRecords?: number;
    /** Batch size for the executor loop (default: 200). */
    batchSize?: number;
}
/**
 * ObjectGrid Schema
 * A specialized grid component that automatically fetches and displays data from ObjectQL objects.
 * Implements the grid view type from @objectstack/spec view.zod ListView schema.
 *
 * Features:
 * - Traditional table/grid with CRUD operations
 * - Search, filters, pagination
 * - Column resizing, sorting
 * - Row selection
 * - Inline editing support
 */
export interface ObjectGridSchema extends BaseSchema {
    type: 'object-grid';
    /**
     * Internal name for the view
     */
    name?: string;
    /**
     * Display label override
     */
    label?: string;
    /**
     * ObjectQL object name (e.g., 'users', 'accounts', 'contacts')
     * Used when data provider is 'object' or not specified
     */
    objectName: string;
    /**
     * Data Source Configuration
     * Aligned with @objectstack/spec ViewDataSchema
     * If not provided, defaults to { provider: 'object', object: objectName }
     */
    data?: ViewData;
    /**
     * Columns Configuration
     * Can be either:
     * - Array of field names (simple): ['name', 'email', 'status']
     * - Array of ListColumn objects (enhanced): [{ field: 'name', label: 'Full Name', width: 200 }]
     */
    columns?: string[] | ListColumn[];
    /**
     * Filter criteria (JSON Rules format)
     * Array-based filter configuration
     */
    filter?: any[];
    /**
     * Sort Configuration
     * Can be either:
     * - Legacy string format: "name desc"
     * - Array of sort configs: [{ field: 'name', order: 'desc' }]
     */
    sort?: string | SortConfig[];
    /**
     * Fields enabled for search
     * Defines which fields are searchable when using the search box
     */
    searchableFields?: string[];
    /**
     * Enable column resizing
     * Allows users to drag column borders to resize
     */
    resizable?: boolean;
    /**
     * Enable column reordering
     * Allows users to drag columns to reorder
     */
    reorderableColumns?: boolean;
    /**
     * Striped row styling
     * Alternating row background colors
     */
    striped?: boolean;
    /**
     * Show borders
     * Display borders around cells
     */
    bordered?: boolean;
    /**
     * Show column type icons (T / Tag / Calendar / Hash) in column headers.
     * Off by default — type is usually obvious from cell content; the icons
     * add visual noise that competes with column labels.
     * @default false
     */
    showColumnTypeIcons?: boolean;
    /**
     * Row Selection Configuration
     * Aligned with @objectstack/spec SelectionConfigSchema
     */
    selection?: SelectionConfig;
    /**
     * Pagination Configuration
     * Aligned with @objectstack/spec PaginationConfigSchema
     */
    pagination?: PaginationConfig;
    /**
     * Custom CSS class
     */
    className?: string;
    /**
     * @deprecated Use columns instead
     * Legacy field names to display
     */
    fields?: string[];
    /**
     * @deprecated Use data with provider: 'value' instead
     * Legacy inline data support
     */
    staticData?: any[];
    /**
     * @deprecated Use selection.type instead
     * Legacy selection mode
     */
    selectable?: boolean | 'single' | 'multiple';
    /**
     * @deprecated Use pagination.pageSize instead
     * Legacy page size
     */
    pageSize?: number;
    /**
     * @deprecated Use searchableFields instead
     * Legacy search toggle
     */
    showSearch?: boolean;
    /**
     * @deprecated Use filter property instead
     * Legacy filters toggle
     */
    showFilters?: boolean;
    /**
     * @deprecated Use pagination config instead
     * Legacy pagination toggle
     */
    showPagination?: boolean;
    /**
     * @deprecated Use sort instead
     * Legacy sort configuration
     */
    defaultSort?: {
        field: string;
        order: 'asc' | 'desc';
    };
    /**
     * @deprecated Use filter instead
     * Legacy default filters
     */
    defaultFilters?: Record<string, any>;
    /**
     * @deprecated Moved to top-level resizable
     * Legacy resizable columns flag
     */
    resizableColumns?: boolean;
    /**
     * @deprecated Use label instead
     * Legacy title field
     */
    title?: string;
    /**
     * @deprecated No direct replacement (consider using label with additional context)
     * Legacy description field
     */
    description?: string;
    /**
     * Enable/disable built-in operations
     * NOTE: This is ObjectUI-specific and not part of @objectstack/spec
     */
    operations?: {
        /**
         * Enable create operation
         * @default true
         */
        create?: boolean;
        /**
         * Enable read/view operation
         * @default true
         */
        read?: boolean;
        /**
         * Enable update operation
         * @default true
         */
        update?: boolean;
        /**
         * Enable delete operation
         * @default true
         */
        delete?: boolean;
        /**
         * Enable export operation
         * @default false
         */
        export?: boolean;
        /**
         * Enable import operation
         * @default false
         */
        import?: boolean;
    };
    /**
     * Custom row actions
     * NOTE: This is ObjectUI-specific and not part of @objectstack/spec
     */
    rowActions?: string[];
    /**
     * Custom batch actions
     * NOTE: This is ObjectUI-specific and not part of @objectstack/spec
     */
    batchActions?: string[];
    /**
     * Enable inline cell editing (Grid mode)
     * When true, cells become editable on double-click or Enter key
     * NOTE: This is ObjectUI-specific and not part of @objectstack/spec
     * @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.
     * Aligned with @objectstack/spec GroupingConfigSchema.
     */
    grouping?: GroupingConfig;
    /**
     * Per-group aggregations to display in group headers (e.g. SUM(amount) per region).
     * ObjectUI-specific (not in @objectstack/spec for ObjectGrid; sourced from the
     * Report protocol when ObjectGrid is rendered as a Summary report body).
     * @example [{ field: 'amount', type: 'sum' }, { field: 'id', type: 'count_distinct' }]
     */
    aggregations?: Array<{
        field: string;
        type: 'sum' | 'count' | 'avg' | 'min' | 'max' | 'count_distinct';
    }>;
    /**
     * Row Color Configuration (Airtable-style)
     * Colors rows based on field values.
     * Aligned with @objectstack/spec RowColorConfigSchema.
     */
    rowColor?: RowColorConfig;
    /**
     * Enable keyboard navigation (Grid mode)
     * Arrow keys, Tab, Enter for cell navigation
     * NOTE: This is ObjectUI-specific and not part of @objectstack/spec
     * @default true when editable is true
     */
    keyboardNavigation?: boolean;
    /**
     * Number of columns to freeze (left-pin)
     * Useful for keeping certain columns visible while scrolling
     * NOTE: This is ObjectUI-specific and not part of @objectstack/spec
     * @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.
     * Aligned with @objectstack/spec ListView.navigation.
     */
    navigation?: ViewNavigationConfig;
    /**
     * Callback for page-level navigation (used by 'page' mode).
     * 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[];
    /**
     * Rich bulk action definitions. When provided, takes precedence over
     * `bulkActions` / `bulkSpecActions` (string-id lists) by opening a
     * BulkActionDialog that collects params, confirms, and executes via
     * dataSource.bulk(...) with progress + result reporting.
     */
    bulkActionDefs?: BulkActionDef[];
    /**
     * 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
 * Aligns with @objectstack/spec FormSection
 */
export interface ObjectFormSection {
    /**
     * Section identifier
     */
    name?: string;
    /**
     * Section label
     */
    label?: string;
    /**
     * Section description
     */
    description?: string;
    /**
     * Whether the section can be collapsed
     * @default false
     */
    collapsible?: boolean;
    /**
     * Whether the section is initially collapsed
     * @default false
     */
    collapsed?: boolean;
    /**
     * Number of columns for field layout
     * @default 1
     */
    columns?: 1 | 2 | 3 | 4;
    /**
     * Field names or inline field configurations for this section
     */
    fields: (string | FormField)[];
}
/**
 * ObjectForm Schema
 * A smart form component that generates forms from ObjectQL object schemas.
 * It automatically creates form fields based on object metadata.
 *
 * Supports multiple form variants aligned with @objectstack/spec FormView:
 * - `simple`  – Flat field list (default)
 * - `tabbed`  – Fields organized in tabs
 * - `wizard`  – Multi-step form with navigation
 * - `split`   – Side-by-side panels (reserved)
 * - `drawer`  – Slide-out form panel (reserved)
 * - `modal`   – Dialog-based form (reserved)
 */
export interface ObjectFormSchema extends BaseSchema {
    type: 'object-form';
    /**
     * Form variant type.
     * Aligns with @objectstack/spec FormView.type
     *
     * - `simple`  – Standard flat form (default)
     * - `tabbed`  – Sections as tabs
     * - `wizard`  – Multi-step wizard with progress indicator
     * - `split`   – Side-by-side panel layout (reserved)
     * - `drawer`  – Slide-out form (reserved)
     * - `modal`   – Dialog form (reserved)
     *
     * @default 'simple'
     */
    formType?: 'simple' | 'tabbed' | 'wizard' | 'split' | 'drawer' | 'modal';
    /**
     * ObjectQL object name (e.g., 'users', 'accounts', 'contacts')
     */
    objectName: string;
    /**
     * Form mode
     */
    mode: 'create' | 'edit' | 'view';
    /**
     * Record ID (required for edit/view modes)
     */
    recordId?: string | number;
    /**
     * Optional title for the form
     */
    title?: string;
    /**
     * Optional description
     */
    description?: string;
    /**
     * Field names to include in the form
     * If not specified, uses all editable fields from object schema
     */
    fields?: string[];
    /**
     * Custom field configurations
     * Overrides auto-generated fields for specific fields.
     * When used with inline field definitions (without dataSource), this becomes the primary field source.
     */
    customFields?: FormField[];
    /**
     * Inline initial data for demo/static forms
     * When provided along with customFields (or inline field definitions), the form can work without a data source.
     * Useful for documentation examples and prototyping.
     */
    initialData?: Record<string, any>;
    /**
     * Form sections for organized layout.
     * Used by tabbed/wizard/simple forms to group fields.
     * Aligns with @objectstack/spec FormView.sections
     */
    sections?: ObjectFormSection[];
    /**
     * Field groups for organized layout (legacy, prefer sections)
     */
    groups?: Array<{
        title?: string;
        description?: string;
        fields: string[];
        collapsible?: boolean;
        defaultCollapsed?: boolean;
    }>;
    /**
     * Form layout.
     *
     * Supported layouts:
     * - `vertical`   – label above field (default)
     * - `horizontal` – label and field in a row
     * - `inline`     – compact inline layout, typically used in toolbars
     * - `grid`       – **experimental** grid layout
     *
     * @default 'vertical'
     */
    layout?: 'vertical' | 'horizontal' | 'inline' | 'grid';
    /**
     * Grid columns (for grid layout).
     * @default 2
     */
    columns?: number;
    /**
     * Default active tab (section name). Only used when formType is 'tabbed'.
     */
    defaultTab?: string;
    /**
     * Tab position. Only used when formType is 'tabbed'.
     * @default 'top'
     */
    tabPosition?: 'top' | 'bottom' | 'left' | 'right';
    /**
     * Allow skipping steps. Only used when formType is 'wizard'.
     * @default false
     */
    allowSkip?: boolean;
    /**
     * Show step indicator. Only used when formType is 'wizard'.
     * @default true
     */
    showStepIndicator?: boolean;
    /**
     * Text for Next button. Only used when formType is 'wizard'.
     * @default 'Next'
     */
    nextText?: string;
    /**
     * Text for Previous button. Only used when formType is 'wizard'.
     * @default 'Back'
     */
    prevText?: string;
    /**
     * Called when wizard step changes. Only used when formType is 'wizard'.
     */
    onStepChange?: (step: number) => void;
    /**
     * Show submit button
     * @default true
     */
    showSubmit?: boolean;
    /**
     * Submit button text
     */
    submitText?: string;
    /**
     * Declarative success toast text shown after a successful create/update when
     * no `onSuccess` function handler is supplied (metadata-only pages cannot
     * pass a function). Falls back to 'Created' / 'Saved'.
     */
    successMessage?: string;
    /**
     * Navigate here after a successful create/update (declarative; falls back to
     * a toast). Supports `{id}`/`{recordId}` interpolation from the saved record;
     * same-origin-guarded. Takes precedence over `successMessage`.
     */
    navigateOnSuccess?: string;
    /**
     * Reset the form after a successful create so the user can enter another.
     * Ignored when `navigateOnSuccess` is set.
     */
    resetOnSuccess?: boolean;
    /**
     * Show cancel button
     * @default true
     */
    showCancel?: boolean;
    /**
     * Cancel button text
     */
    cancelText?: string;
    /**
     * Show reset button
     * @default false
     */
    showReset?: boolean;
    /**
     * Initial values (for create mode)
     */
    initialValues?: Record<string, any>;
    /**
     * Callback on successful submission
     */
    onSuccess?: (data: any) => void | Promise<void>;
    /**
     * Override persistence. When supplied, the form validates and hands the
     * collected values to this handler INSTEAD of calling dataSource.create /
     * dataSource.update — the host owns the write (e.g. MasterDetailForm batching
     * the parent + child line items into one atomic server transaction). The
     * returned record is passed on to `onSuccess`.
     */
    submitHandler?: (values: Record<string, any>) => any | Promise<any>;
    /**
     * Inline child collections (master-detail). When present, the form renders as
     * a master-detail form: the object's own fields on top, then an editable grid
     * per child collection, persisted together in one atomic transaction. Each
     * entry needs only `childObject` — the relationship FK and grid columns are
     * derived from the child object's metadata (override with
     * `relationshipField` / `columns`). This lets a regular form view declare
     * master-detail without a bespoke page.
     */
    subforms?: Array<{
        childObject: string;
        relationshipField?: string;
        columns?: any[];
        amountField?: string;
        totalField?: string;
        title?: string;
        addLabel?: string;
        minRows?: number;
        maxRows?: number;
    }>;
    /**
     * Callback on error
     */
    onError?: (error: Error) => void;
    /**
     * Callback on cancel
     */
    onCancel?: () => void;
    /**
     * Read-only mode
     * @default false
     */
    readOnly?: boolean;
    /**
     * Custom CSS class
     */
    className?: string;
    /**
     * Split panel direction. Only used when formType is 'split'.
     * @default 'horizontal'
     */
    splitDirection?: 'horizontal' | 'vertical';
    /**
     * Size of the left/top panel in the split layout (percentage 1-99).
     * Only used when formType is 'split'.
     * @default 50
     */
    splitSize?: number;
    /**
     * Whether the split panels can be resized. Only used when formType is 'split'.
     * @default true
     */
    splitResizable?: boolean;
    /**
     * Whether the drawer is open. Only used when formType is 'drawer'.
     * @default true
     */
    open?: boolean;
    /**
     * Callback when open state changes. Only used when formType is 'drawer'.
     */
    onOpenChange?: (open: boolean) => void;
    /**
     * Drawer slide-in side. Only used when formType is 'drawer'.
     * @default 'right'
     */
    drawerSide?: 'top' | 'bottom' | 'left' | 'right';
    /**
     * Drawer width (CSS value). Only used when formType is 'drawer'.
     * @default '50%'
     */
    drawerWidth?: string;
    /**
     * Modal dialog size. Only used when formType is 'modal'.
     * @default 'default'
     */
    modalSize?: 'sm' | 'default' | 'lg' | 'xl' | 'full';
    /**
     * Whether to show a close button in the modal header. Only used when formType is 'modal'.
     * @default true
     */
    modalCloseButton?: boolean;
    /**
     * Mobile-specific form behavior. All options are opt-in; on desktop the
     * form renders unchanged. `auto` values activate only when the viewport
     * matches `(max-width: 767px)`.
     *
     * @example
     * ```ts
     * mobile: {
     *   stickyActions: true,        // pin Submit/Cancel to the bottom of the viewport
     *   stepper: 'auto',            // long forms render one field at a time on phones
     *   stepperMinFields: 8,        // … but only past this many fields
     *   fullscreenLongText: true,   // textarea/rich-text get an "expand" button
     * }
     * ```
     */
    mobile?: {
        /** Render Submit/Cancel as a sticky bottom action bar on mobile. */
        stickyActions?: boolean;
        /**
         * One-field-at-a-time stepper on small screens.
         * - `false` (default): never use the stepper.
         * - `true`: always use it on mobile.
         * - `'auto'`: only when the form has > `stepperMinFields` fields.
         */
        stepper?: boolean | 'auto';
        /** Threshold for `stepper: 'auto'`. @default 8 */
        stepperMinFields?: number;
        /** How many fields to show per step when stepper is active. @default 1 */
        stepperFieldsPerStep?: number;
        /** Show a fullscreen-edit affordance for textarea / rich-text fields. */
        fullscreenLongText?: boolean;
    };
}
/**
 * ObjectView Schema
 * A complete object management interface combining ObjectTable and ObjectForm.
 * Provides list view with search, filters, and integrated create/edit dialogs.
 */
export interface ObjectViewSchema extends BaseSchema {
    type: 'object-view';
    /**
     * ObjectQL object name (e.g., 'users', 'accounts', 'contacts')
     */
    objectName: string;
    /**
     * Optional title for the view
     */
    title?: string;
    /**
     * Optional description
     */
    description?: string;
    /**
     * Layout mode for create/edit operations
     * - drawer: Side drawer (default, recommended for forms)
     * - modal: Center modal dialog
     * - page: Navigate to separate page (requires onNavigate handler)
     * @default 'drawer'
     */
    layout?: 'drawer' | 'modal' | 'page';
    /**
     * Default list view type
     * @default 'grid'
     */
    defaultViewType?: 'grid' | 'kanban' | 'gallery' | 'calendar' | 'timeline' | 'gantt' | 'map';
    /**
     * Named list views (e.g., "All Records", "My Records", "Active").
     * Aligned with @objectstack/spec View.listViews.
     */
    listViews?: Record<string, NamedListView>;
    /**
     * Default named list view to display
     */
    defaultListView?: string;
    /**
     * Navigation config for row/item click behavior.
     * Aligned with @objectstack/spec ListView.navigation.
     */
    navigation?: ViewNavigationConfig;
    /**
     * Table/Grid configuration
     * Inherits from ObjectGridSchema
     */
    table?: Partial<Omit<ObjectGridSchema, 'type' | 'objectName'>>;
    /**
     * Form configuration
     * Inherits from ObjectFormSchema
     */
    form?: Partial<Omit<ObjectFormSchema, 'type' | 'objectName' | 'mode'>>;
    /**
     * Fields that support text search
     */
    searchableFields?: string[];
    /**
     * Fields available for the filter UI
     */
    filterableFields?: string[];
    /**
     * Show search box
     * @default true
     */
    showSearch?: boolean;
    /**
     * Show filters
     * @default true
     */
    showFilters?: boolean;
    /**
     * Show sort controls
     * @default true
     */
    showSort?: boolean;
    /**
     * Show create button
     * @default true
     */
    showCreate?: boolean;
    /**
     * Show refresh button
     * @default true
     */
    showRefresh?: boolean;
    /**
     * Show view switcher (for multi-view)
     * When false (default), view type is fixed at creation in ViewConfigPanel
     * @default false
     */
    showViewSwitcher?: boolean;
    /**
     * Enable/disable built-in operations
     */
    operations?: {
        create?: boolean;
        read?: boolean;
        update?: boolean;
        delete?: boolean;
    };
    /**
     * Callback when navigating to detail page (page layout mode)
     */
    onNavigate?: (recordId: string | number, mode: 'view' | 'edit') => void;
    /**
     * 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
 * Used in ObjectViewSchema.listViews for named views (e.g., "All", "My Records").
 */
export interface NamedListView {
    /** View display label */
    label: string;
    /** View type (grid, kanban, etc.) */
    type?: 'grid' | 'kanban' | 'gallery' | 'calendar' | 'timeline' | 'gantt' | 'map';
    /** Columns/fields to display */
    columns?: string[];
    /** Filter conditions */
    filter?: any[];
    /** Sort configuration */
    sort?: Array<{
        field: string;
        order: 'asc' | 'desc';
    }>;
    /** 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;
    /**
     * Collapse the appearance/grouping cluster (Group + Color + Density + Hide Fields)
     * into a single "View settings" popover button. Reduces toolbar clutter on
     * data-heavy lists. Filter / Sort / Export remain top-level chips.
     * @default false
     */
    compactToolbar?: 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[];
    /** Rich bulk action definitions — see BulkActionDef. */
    bulkActionDefs?: BulkActionDef[];
    /** 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[];
    /**
     * User Filters Configuration (Airtable Interfaces-style).
     * Reuses the ListViewSchema.userFilters type to keep both definitions in parity.
     *
     * Supports three display modes configured by `element`:
     * - 'dropdown': Each field renders as a dropdown selector badge
     * - 'tabs': Named filter presets rendered as a tab bar
     */
    userFilters?: ListViewSchema['userFilters'];
    /** 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.
 * Aligned with @objectstack/spec ListView.navigation.
 */
export interface ViewNavigationConfig {
    /**
     * How to open the target view on interaction
     * - page: Full page navigation
     * - drawer: Slide-out panel
     * - modal: Dialog overlay
     * - split: Side-by-side panel
     * - popover: Hover/click preview card
     * - new_window: Open in new browser tab
     * - none: No navigation on click
     * @default 'page'
     */
    mode: 'page' | 'drawer' | 'modal' | 'split' | 'popover' | 'new_window' | 'none';
    /** Target view/form config name */
    view?: string;
    /** Prevent default navigation behavior */
    preventNavigation?: boolean;
    /** Open in new tab (for page/new_window modes) */
    openNewTab?: boolean;
    /** Width for drawer/modal/split modes (e.g., '600px', '50%') */
    width?: string | number;
}
/**
 * Generic View Definition
 * Aligned with @objectstack/spec View/ListView.
 * Defines the data requirement, not just the visual component.
 */
export interface ListViewSchema extends BaseSchema {
    type: 'list-view';
    /** View name identifier */
    name?: string;
    /** View display label */
    label?: string;
    /** Object Name */
    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;
        label?: string;
        width?: number | string;
        align?: 'left' | 'center' | 'right';
        hidden?: boolean;
        sortable?: boolean;
        resizable?: boolean;
        wrap?: boolean;
        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. 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 */
    filterableFields?: string[];
    /** Row selection mode */
    selection?: {
        type: 'none' | 'single' | 'multiple';
    };
    /** Pagination configuration */
    pagination?: {
        pageSize: number;
        pageSizeOptions?: number[];
    };
    /** Allow column resizing @default false */
    resizable?: boolean;
    /** Show alternating row colors @default false */
    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;
    /**
     * Collapse the appearance/grouping cluster (Group + Color + Density + Hide Fields)
     * into a single "View settings" popover button. Reduces toolbar clutter on
     * data-heavy lists. Filter / Sort / Export remain top-level chips.
     * @default false
     */
    compactToolbar?: boolean;
    /** Allow data export @default undefined */
    allowExport?: boolean;
    /** Color field for row/card coloring */
    color?: string;
    /** Navigation config for row click behavior */
    navigation?: ViewNavigationConfig;
    /**
     * Callback for page-level navigation (used by 'page' mode).
     * Called with recordId and action ('view' | 'edit').
     */
    onNavigate?: (recordId: string | number, action?: string) => void;
    /** Kanban-specific configuration */
    kanban?: {
        groupField: string;
        titleField?: string;
        cardFields?: string[];
        [key: string]: any;
    };
    /** Calendar-specific configuration */
    calendar?: {
        startDateField: string;
        endDateField?: string;
        titleField?: string;
        defaultView?: 'month' | 'week' | 'day' | 'agenda';
        [key: string]: any;
    };
    /** Gantt-specific configuration */
    gantt?: {
        startDateField: string;
        endDateField: string;
        titleField?: string;
        progressField?: string;
        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;
    };
    /**
     * 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';
    /**
     * Optional callback fired when the user toggles row density via the
     * toolbar. When provided, the host (typically ObjectView) is expected to
     * persist the new value on the active view definition (e.g. via
     * dataSource.updateViewConfig). Without this callback the toggle remains
     * a session-local preference.
     */
    onDensityChange?: (mode: 'compact' | 'comfortable' | 'spacious') => void;
    /**
     * 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")
     */
    userFilters?: {
        /** UI element type for displaying filters */
        element: 'dropdown' | 'tabs';
        /**
         * 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.
         *
         * Canonical shape is `{ name, label, icon?, filter, isDefault? }` — aligned
         * with the `{ field, operator, value }` rules used by every other filter in
         * the protocol, so AI authoring and the Studio tabs editor emit one
         * consistent form. The legacy `{ id, filters, default }` fields remain
         * accepted (normalized at runtime by `normalizeTabPresets`) for back-compat.
         */
        tabs?: Array<{
            /** Unique tab identifier (snake_case). Falls back to `id` if omitted. */
            name?: string;
            /** Tab display label. */
            label: string;
            /** Filter rules applied when this tab is active. */
            filter?: Array<{
                field: string;
                operator: string;
                value?: unknown;
            }>;
            /** Icon name (Lucide icon identifier). */
            icon?: string;
            /** Whether this tab is active by default. */
            isDefault?: boolean;
            /** @deprecated use `name`. */
            id?: string;
            /** @deprecated use `filter` ({ field, operator, value }). */
            filters?: Array<any[] | string>;
            /** @deprecated use `isDefault`. */
            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[];
    /**
     * Rich bulk action definitions. See BulkActionDef. Takes precedence over
     * `bulkActions` (string-id list) by opening the BulkActionDialog flow.
     */
    bulkActionDefs?: BulkActionDef[];
    /**
     * 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[];
    };
    /**
     * 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;
    /**
     * External refresh trigger.
     * Increment this value to force the ListView to re-fetch data.
     * Used by parent components (e.g., ObjectView) to signal that a mutation
     * (create/update/delete) has occurred and the list should refresh.
     */
    refreshTrigger?: number;
}
export interface ObjectMapSchema extends BaseSchema {
    type: 'object-map';
    /** ObjectQL object name */
    objectName: string;
    /** Field containing location data (or lat/long pair) */
    locationField?: string;
    /** Field for marker title */
    titleField?: string;
}
/**
 * Object Tree (tree-grid) Component Schema
 *
 * Renders a self-referencing object as an indented, expand/collapse tree-grid.
 * Flat records are nested via a single-parent pointer field (`parentField`).
 */
export interface ObjectTreeSchema extends BaseSchema {
    type: 'object-tree';
    /** ObjectQL object name */
    objectName: string;
    /**
     * Field holding the parent record reference (single-parent pointer).
     * When omitted, the renderer auto-detects the object's `tree`/self-reference field.
     */
    parentField?: string;
    /** Field rendered (indented) in the tree's first column. Defaults to `name`. */
    labelField?: string;
    /** Additional fields rendered as flat columns alongside the label. */
    fields?: string[];
    /**
     * Default expansion depth (0 = roots only). When omitted, all nodes expand.
     */
    defaultExpandedDepth?: number;
}
/**
 * Object Gantt Component Schema
 */
export interface ObjectGanttSchema extends BaseSchema {
    type: 'object-gantt';
    /** ObjectQL object name */
    objectName: string;
    /** Field for task start date */
    startDateField?: string;
    /** Field for task end date */
    endDateField?: string;
    /** Field for task title/name */
    titleField?: string;
    /** Field for task dependencies */
    dependencyField?: string;
    /** Field for progress (0-100) */
    progressField?: string;
}
/**
 * Object Calendar Component Schema
 */
export interface ObjectCalendarSchema extends BaseSchema {
    type: 'object-calendar';
    /** ObjectQL object name */
    objectName: string;
    /** Field for event start */
    startDateField?: string;
    /** Field for event end */
    endDateField?: string;
    /** Field for event title */
    titleField?: string;
    /** Default view mode */
    defaultView?: 'month' | 'week' | 'day' | 'agenda';
}
/**
 * Object Kanban Component Schema
 */
export interface ObjectKanbanSchema extends BaseSchema {
    type: 'object-kanban';
    /** ObjectQL object name */
    objectName: string;
    /** Field to group columns by (e.g. status) */
    groupField: string;
    /** Field for card title */
    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
 */
export interface ObjectChartSchema extends BaseSchema {
    type: 'object-chart';
    /** ObjectQL object name (legacy inline path; optional under ADR-0021 dataset binding) */
    objectName?: string;
    /** Chart type. Includes donut / horizontal-bar / column — all rendered by
     *  AdvancedChartImpl (previously only reachable by passing an untyped string). */
    chartType: 'bar' | 'column' | 'horizontal-bar' | 'line' | 'area' | 'pie' | 'donut' | 'scatter';
    /** Field for X axis (categories) — legacy inline path */
    xAxisField?: string;
    /** Fields for Y axis (values) — legacy */
    yAxisFields?: string[];
    /** Aggregation function — legacy */
    aggregation?: 'cardinality' | 'sum' | 'avg' | 'min' | 'max';
    /** Semantic-layer dataset name (ADR-0021, #1890) */
    dataset?: string;
    /** Dataset dimension names */
    dimensions?: string[];
    /** Dataset measure names */
    values?: string[];
}
/**
 * Union type of all ObjectQL component schemas
 */
export type ObjectQLComponentSchema = ObjectGridSchema | ObjectFormSchema | ObjectViewSchema | ObjectMapSchema | ObjectTreeSchema | ObjectGanttSchema | ObjectCalendarSchema | ObjectKanbanSchema | ObjectChartSchema | ListViewSchema;
//# sourceMappingURL=objectql.d.ts.map