@stndrds/schema 1.0.0-alpha.192 → 1.0.0-alpha.194

package/dist/filters-DVBn5tov.d.ts

@@ -1,1630 +0,0 @@
-import { IconName, CountryIso3, CurrencyCode, ColorId, MimeType } from '@stndrds/constants';
-import { Uuid } from './utils.js';
-
-interface DocumentLayout {
-    /** Named sub-folders auto-created at the top of the record's drive when first used via attach --variant. */
-    variants?: Record<string, DocumentLayoutVariant>;
-    /** Dev-declared folder structures the user can instantiate via the UI inside a record's drive. */
-    presets?: FolderPreset[];
-}
-interface DocumentLayoutVariant {
-    /** Display title for the auto-created sub-folder. */
-    title: string;
-    description?: string;
-}
-interface FolderPreset {
-    id: string;
-    label: string;
-    icon?: IconName;
-    description?: string;
-    structure: PresetNode[];
-}
-interface PresetNode {
-    title: string;
-    description?: string;
-    children?: PresetNode[];
-}
-/** Max depth allowed for preset.structure to keep instantiation predictable. */
-declare const MAX_PRESET_DEPTH = 5;
-
-/**
- * Type of view - determines the config structure
- */
-type ViewType = "detail" | "list";
-/**
- * Creation behavior when clicking the "+" button
- * - `redirect`: Create the record then navigate to its detail page
- * - `inline`: Insert an empty row in the table (no navigation)
- * - `modal`: Open a stacked modal for creation
- */
-type CreateMode = "redirect" | "inline" | "modal";
-/**
- * Inline attribute group configuration
- * Groups multiple attributes into a single composite field with dropdown editing
- */
-interface AttributeGroupField {
-    /** Unique identifier for the group */
-    id: string;
-    /** Display label for the composite field */
-    label: string;
-    /** Description shown in the dropdown */
-    description?: string;
-    /** Attribute names to include in this group */
-    attributes: string[];
-    /**
-     * Template for the display value
-     * Uses {attributeName} syntax for interpolation
-     * @example "{billing_street}, {billing_city} {billing_postal_code}"
-     */
-    displayTemplate?: string;
-}
-/**
- * Field definition within a form group
- * Can be either a single attribute or an inline attribute group
- */
-interface Field {
-    /** Attribute name to display (for single attribute fields) */
-    attribute?: string;
-    /** Inline attribute group (groups multiple attributes into one composite field) */
-    attributeGroup?: AttributeGroupField;
-    /** Grid span (1-12 columns) */
-    span?: 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12;
-    /** Override label for this view (only for single attribute fields) */
-    label?: string;
-    /** Force read-only display */
-    readOnly?: boolean;
-}
-/**
- * Base properties shared by all group types
- */
-interface BaseGroup {
-    id: string;
-    label: string;
-    description?: string;
-    collapsible?: boolean;
-    collapsed?: boolean;
-    order?: number;
-}
-/**
- * Group of fields for organizing forms (default group type)
- */
-interface FieldGroup extends BaseGroup {
-    /** Discriminant — optional for backward compatibility with existing data */
-    type?: "fields";
-    fields: Field[];
-}
-/**
- * Group that displays related records for a relation attribute
- */
-interface RelationGroup extends BaseGroup {
-    type: "relation";
-    /** Relation attribute name on the source object */
-    attribute: string;
-    /** Columns to display (auto-detected from target object if empty) */
-    columns?: string[];
-    /** Read-only mode */
-    readOnly?: boolean;
-    /** Allow creating new related records */
-    allowCreate?: boolean;
-    /**
-     * Two-level traversal — display records from the target's relation.
-     * When set, parent rows become grouping headers and the sub-rows
-     * (from `through.attribute`) are the primary display.
-     *
-     * @example attribute = "members", through.attribute = "companies"
-     *          → displays companies of each member
-     */
-    through?: {
-        /** Relation attribute on the first-level target object */
-        attribute: string;
-    };
-}
-/**
- * Discriminated union of all group types
- */
-type Group = FieldGroup | RelationGroup;
-type TabType = "form" | "table" | "custom" | "activity" | "richtext" | "documents" | "forms";
-/**
- * Base properties shared by all tab types
- */
-interface BaseTab {
-    id: string;
-    name: string;
-    label: string;
-    icon?: IconName;
-    order?: number;
-}
-/**
- * Form layout density
- */
-type FormDensity = "compact" | "comfortable" | "spacious";
-/**
- * Form tab - displays attributes organized in groups
- */
-interface FormTab extends BaseTab {
-    type: "form";
-    groups: Group[];
-    /** Number of grid columns (1, 2, or 3). Default: 2 */
-    formColumns?: 1 | 2 | 3;
-    /** Layout density. Default: "comfortable" */
-    density?: FormDensity;
-}
-/**
- * Direct relation on the current object
- *
- * @example Contact.companies → shows Companies linked via the "companies" relation
- */
-interface RelationSource {
-    type: "relation";
-    /** Relation attribute name on the current object */
-    attribute: string;
-}
-/**
- * Inverse lookup — records from another object that point to us
- *
- * @example On Company, show Contacts where Contact.company = this Company
- */
-interface InverseSource {
-    type: "inverse";
-    /** Object name that has the relation to us */
-    object: string;
-    /** Relation attribute name on the source object that points to us */
-    attribute: string;
-}
-/**
- * Where table data comes from — either a direct relation or an inverse lookup
- */
-type TableSource = RelationSource | InverseSource;
-/**
- * Table tab - displays related records in a table
- *
- * The `source` field determines where data comes from.
- *
- * @example Direct: source = { type: "relation", attribute: "members" }
- * @example Inverse: source = { type: "inverse", object: "contacts", attribute: "company" }
- */
-interface TableTab extends BaseTab {
-    type: "table";
-    /** Where the data comes from */
-    source: TableSource;
-    /** Columns to display (attribute names from the resolved target object) */
-    columns: string[];
-    /**
-     * Traverse a 2nd-level relation to display nested data.
-     * When active, `columns` stores the 2nd-level object's attribute names.
-     *
-     * @example source.attribute = "members", through.attribute = "companies"
-     *          → displays companies of each member
-     */
-    through?: {
-        /** Relation attribute on the first-level target object */
-        attribute: string;
-        /** Show _source and _target columns */
-        showSourceTarget?: boolean;
-    };
-    /** Allow creating new records */
-    allowCreate?: boolean;
-    /** Creation behavior when allowCreate is true. Default: "redirect" */
-    createMode?: CreateMode;
-    /** Allow inline editing */
-    allowEdit?: boolean;
-    /** Allow deleting records */
-    allowDelete?: boolean;
-    /** Default filters applied to the table */
-    filters?: FilterState;
-    /** Default sort rules */
-    sorts?: SortRule[];
-}
-/**
- * Custom tab - renders a developer-defined component
- */
-interface CustomTab extends BaseTab {
-    type: "custom";
-    /** Component identifier to render */
-    component: string;
-    /** Props to pass to the component */
-    props?: Record<string, unknown>;
-}
-/**
- * Activity tab - displays activity feed for the current record
- */
-interface ActivityTab extends BaseTab {
-    type: "activity";
-    limit?: number;
-}
-/**
- * Richtext tab - displays a block editor for a richtext attribute
- */
-interface RichtextTab extends BaseTab {
-    type: "richtext";
-    /** Richtext attribute to display in the BlockEditor */
-    attribute: string;
-    /** Optional text attribute for an editable title input above the editor */
-    titleAttribute?: string;
-}
-/**
- * Documents tab - displays all documents attached to the record
- */
-interface DocumentsTab extends BaseTab {
-    type: "documents";
-    allowUpload?: boolean;
-    allowRemove?: boolean;
-    hideAttachments?: boolean;
-}
-/**
- * Forms tab - displays available forms for creating related records
- */
-interface FormsTab extends BaseTab {
-    type: "forms";
-    /** Object name to filter forms by slot (derived from record context, but can be overridden) */
-    objectName?: string;
-}
-/**
- * Union of all tab types (for detail views)
- */
-type Tab = FormTab | TableTab | CustomTab | ActivityTab | RichtextTab | DocumentsTab | FormsTab;
-/**
- * Detail view layout mode
- * - `page`: Full view with multiple tabs
- * - `modal`: Simplified view for modals (single FormTab, no tabs UI)
- */
-type DetailViewLayout = "page" | "modal";
-/**
- * List view layout mode
- * - `table`: Table/grid layout
- * - `kanban`: Kanban board layout (grouped by attribute)
- */
-type ListViewLayout = "table" | "kanban";
-/**
- * Tab within a list view — each tab carries its own full display configuration.
- *
- * @example
- * ```typescript
- * const tabs: ListViewTab[] = [
- *   { id: "all", label: "All Contacts", default: true, layout: "table", columns: ["name", "email", "status"] },
- *   { id: "active", label: "Active", layout: "table", columns: ["name", "email"], filters: activeFilter },
- *   { id: "pipeline", label: "Pipeline", layout: "kanban", columns: ["name", "amount"], groupByAttribute: "stage" },
- * ];
- * ```
- */
-interface ListViewTab {
-    /** Unique identifier */
-    id: string;
-    /** Display label */
-    label: string;
-    /** Icon */
-    icon?: IconName;
-    /** Default tab (shown on load) */
-    default?: boolean;
-    /** Layout mode */
-    layout: ListViewLayout;
-    /** Attribute names to display as columns */
-    columns: string[];
-    /** Column widths in pixels */
-    columnSizing?: Record<string, number>;
-    /** Filters applied to this tab */
-    filters?: FilterGroup;
-    /** Sort rules for this tab */
-    sorts?: SortRule[];
-    /** Attribute to group by (required when layout is "kanban") */
-    groupByAttribute?: string;
-    /** When true, the tab is read-only: no cell editing, no create, no delete */
-    readOnly?: boolean;
-    /** Creation behavior when clicking "+". Default: "redirect" */
-    createMode?: CreateMode;
-    /** User attribute to display on kanban cards (bottom-left) */
-    cardUserAttribute?: string;
-    /** Date attribute to display on kanban cards (bottom-right) */
-    cardDateAttribute?: string;
-    /** Order of kanban columns (by option value) - for kanban layout only */
-    kanbanColumnOrder?: string[];
-    /** Visibility of kanban columns (by option value) - for kanban layout only */
-    kanbanColumnVisibility?: Record<string, boolean>;
-    /** Pinned kanban columns (by option value) - for kanban layout only */
-    kanbanPinnedColumns?: string[];
-}
-/**
- * Configuration for the side panel displayed alongside tab content.
- * When present, a right-side panel shows the configured attributes as flat fields.
- */
-interface SidePanelConfig {
-    /** Attribute names to display as flat fields in the panel */
-    attributes: string[];
-    /** Width in pixels. @default 320 */
-    width?: number;
-}
-/**
- * Configuration for detail views (RecordEditView)
- */
-interface DetailViewConfig {
-    /** Layout mode */
-    layout: DetailViewLayout;
-    /** Tabs in this view */
-    tabs: Tab[];
-    /** Optional side panel with flat attribute fields (not available for modal layout) */
-    sidePanel?: SidePanelConfig;
-}
-/**
- * Configuration for list views (RecordsView)
- *
- * Each tab carries its own full config (layout, columns, filters, sorts, groupBy).
- * The view only holds shared base filters applied to ALL tabs.
- */
-interface ListViewConfig {
-    /** Base filters applied to ALL tabs (scoping, tenant, etc.) */
-    defaultFilters?: FilterGroup;
-    /** Tabs — at least one required. Each carries its own full config. */
-    tabs: ListViewTab[];
-}
-/**
- * Union of all view configs
- */
-type ViewConfig = DetailViewConfig | ListViewConfig;
-/**
- * Base view properties shared by all view types
- */
-interface BaseViewDefinition {
-    /** Unique identifier (UUID, assigned by database) */
-    id?: string;
-    /** Technical name (kebab-case) */
-    name: string;
-    /** Display label */
-    label: string;
-    /** Description */
-    description?: string;
-    /** Icon */
-    icon?: IconName;
-    /** Object this view belongs to (object name) */
-    object: string;
-    /** Default view for this object+type combination */
-    default?: boolean;
-    /** Extensible metadata */
-    metadata?: Record<string, unknown>;
-    /** Current schema version of this view definition */
-    schema_version: number;
-}
-/**
- * Detail view definition
- */
-interface DetailViewDefinition extends BaseViewDefinition {
-    type: "detail";
-    config: DetailViewConfig;
-}
-/**
- * List view definition
- */
-interface ListViewDefinition extends BaseViewDefinition {
-    type: "list";
-    config: ListViewConfig;
-}
-/**
- * Unified view definition - discriminated union by type
- */
-type ViewDefinition = DetailViewDefinition | ListViewDefinition;
-/**
- * Configuration overrides for user customizations
- * Only stores the delta from the source view
- */
-interface ConfigOverrides {
-    tabs?: ListViewTab[];
-    hiddenTabIds?: string[];
-    detailTabs?: Tab[];
-    hiddenDetailTabIds?: string[];
-}
-/**
- * User customization overlay for a view
- * Stored per user, merged at runtime with the source view
- */
-interface ViewOverlay {
-    /** Unique identifier */
-    id: string;
-    /** View ID this overlay applies to (UUID or virtual ID) */
-    viewId: string;
-    /** User ID who owns this overlay */
-    userId: string;
-    /** Configuration overrides (delta only) */
-    configOverrides: ConfigOverrides;
-    /** User's default view for this object (stored in overlay) */
-    isUserDefault?: boolean;
-    /** Created timestamp */
-    createdAt: Date;
-    /** Updated timestamp */
-    updatedAt: Date;
-}
-/**
- * Check if a view is a detail view
- */
-declare function isDetailView(view: ViewDefinition): view is DetailViewDefinition;
-/**
- * Check if a view is a list view
- */
-declare function isListView(view: ViewDefinition): view is ListViewDefinition;
-/**
- * Check if a group is a field group (default type)
- */
-declare function isFieldGroup(group: Group): group is FieldGroup;
-/**
- * Check if a group is a relation group
- */
-declare function isRelationGroup(group: Group): group is RelationGroup;
-
-type BuiltInTransform = "toString" | "toNumber" | "toDate" | "toBoolean" | "toISOString";
-type SchemaOperation = {
-    type: "add_attribute";
-    attribute: Attribute;
-} | {
-    type: "remove_attribute";
-    name: string;
-    backup_config: Attribute;
-} | {
-    type: "rename_attribute";
-    from: string;
-    to: string;
-} | {
-    type: "change_type";
-    name: string;
-    from: AttributeType;
-    to: AttributeType;
-    transform?: BuiltInTransform;
-} | {
-    type: "update_config";
-    name: string;
-    from: Partial<Record<string, unknown>>;
-    to: Partial<Record<string, unknown>>;
-} | {
-    type: "remove_object";
-    backup: Record<string, unknown>;
-} | {
-    type: "rename_object";
-    from: string;
-    to: string;
-};
-type ViewOperation = {
-    type: "update_config";
-    from: ViewConfig;
-    to: ViewConfig;
-} | {
-    type: "update_tabs";
-    from: (ListViewTab | Tab)[];
-    to: (ListViewTab | Tab)[];
-} | {
-    type: "force_reset";
-    config: ViewConfig;
-} | {
-    type: "remove_view";
-    backup: Record<string, unknown>;
-};
-interface MigrationDefinition {
-    version: number;
-    operations: SchemaOperation[];
-}
-interface ViewTransform {
-    id: string;
-    tenantId: string;
-    viewId: string;
-    fromVersion: number;
-    toVersion: number;
-    operations: ViewOperation[];
-    appliedAt: Date;
-}
-interface MigrationError {
-    id: string;
-    tenantId: string;
-    transformId: string;
-    recordId: string;
-    attributeName: string;
-    originalValue: unknown;
-    error: string;
-    resolvedAt: Date | null;
-    resolvedValue: unknown | null;
-}
-
-/**
- * Timestamps for tracking creation and updates
- */
-interface Timestamps {
-    createdAt: Date;
-    updatedAt: Date;
-}
-/**
- * Object definition - Represents a database table/entity
- */
-interface ObjectDefinition {
-    id?: Uuid;
-    name: string;
-    label: string;
-    pluralLabel?: string;
-    description?: string;
-    icon?: IconName;
-    /**
-     * Template expression used to compute the object's display label.
-     * Supports variable interpolation and pipes for formatting.
-     *
-     * @example
-     * ```typescript
-     * // Simple attribute reference
-     * labelExpression: "{{ name }}"
-     *
-     * // Multiple attributes
-     * labelExpression: "{{ firstName }} {{ lastName }}"
-     *
-     * // With pipes for formatting
-     * labelExpression: "{{ code | UPPER }} - {{ name | capitalize }}"
-     * ```
-     *
-     * Available pipes: UPPER, LOWER, capitalize, trim
-     */
-    labelExpression: string;
-    attributes: Attribute[];
-    system?: boolean;
-    metadata?: Record<string, unknown>;
-    /** Current schema version (incremented with each migration) */
-    schema_version: number;
-    /** Ordered list of migrations applied to this object's schema */
-    migrations: MigrationDefinition[];
-    /** Smart-folder layout convention for documents attached to records of this object. */
-    documentLayout?: DocumentLayout;
-}
-/**
- * Links an attribute to an object
- */
-interface ObjectAttribute {
-    objectId: Uuid;
-    attributeId: Uuid;
-    order?: number;
-    required?: boolean;
-}
-/**
- * Completion status of a record based on data completeness.
- *
- * - `draft`: Record is missing one or more required attribute values.
- *   Can be saved but is considered incomplete.
- * - `complete`: All required attribute values are present and valid.
- *   Record is ready for use.
- *
- * This is different from workflow status (e.g., "pending", "approved").
- * Completion status is computed dynamically based on the object schema.
- */
-type CompletionStatus = "draft" | "complete";
-/**
- * Record - Instance of an Object (a row in the database)
- */
-interface ObjectRecord extends Timestamps {
-    id: Uuid;
-    objectId: Uuid;
-    /**
-     * Display label computed from the object's labelExpression.
-     * Computed dynamically based on record values.
-     *
-     * @example "John Doe" (from "{{ firstName }} {{ lastName }}")
-     */
-    label: string;
-    /**
-     * Completion status of the record.
-     * - `draft`: Missing required values, record is incomplete
-     * - `complete`: All required values present and valid
-     *
-     * Computed dynamically based on the object's schema.
-     */
-    completionStatus: CompletionStatus;
-    values: Record<string, unknown>;
-    /**
-     * Custom metadata for the record.
-     * Use this for UI/UX state, feature flags, or any application-specific data.
-     * Unlike system fields (id, createdAt, updatedAt), metadata can be updated.
-     */
-    metadata?: Record<string, unknown>;
-    /**
-     * Soft delete timestamp.
-     * If set, the record is considered deleted but can be restored.
-     * Queries exclude soft-deleted records by default.
-     */
-    deletedAt?: Date | null;
-    /**
-     * Actor ID who soft-deleted this record.
-     * Set alongside deletedAt when a record is soft-deleted.
-     */
-    deletedBy?: string | null;
-    /**
-     * Actor ID who created this record.
-     * Automatically set by RecordService when actorId is configured.
-     * Optional for backward compatibility with existing records.
-     */
-    createdBy?: string;
-    /**
-     * Actor ID who last updated this record.
-     * Automatically set by RecordService when actorId is configured.
-     * Optional for backward compatibility with existing records.
-     */
-    lastUpdatedBy?: string;
-    /** Schema version at the time this record was last migrated */
-    schemaVersion: number;
-}
-/**
- * System-managed field names on ObjectRecord.
- * These are stored as SQL columns (not in JSONB `values`).
- *
- * Use this in adapters to determine if a filter/sort attribute is a table column
- * vs. a JSONB value field.
- *
- * @example
- * ```typescript
- * if (SYSTEM_FIELD_NAMES.includes(filter.attribute)) {
- *   // Filter on SQL column (e.g., WHERE created_at > ...)
- * } else {
- *   // Filter on JSONB field (e.g., WHERE values->>'name' = ...)
- * }
- * ```
- */
-declare const SYSTEM_FIELD_NAMES: readonly ["id", "createdAt", "updatedAt", "createdBy", "lastUpdatedBy"];
-/**
- * Type for system field names
- */
-type SystemFieldName = (typeof SYSTEM_FIELD_NAMES)[number];
-/**
- * Reserved attribute names that cannot be used for custom attributes.
- * These names conflict with ObjectRecord properties.
- *
- * Includes:
- * - System fields (id, createdAt, updatedAt, createdBy, lastUpdatedBy)
- * - Other ObjectRecord properties (objectId, label, completionStatus, values, metadata, deletedAt)
- *
- * @example
- * ```typescript
- * if (RESERVED_ATTRIBUTE_NAMES.includes(attributeName)) {
- *   throw new Error(`"${attributeName}" is a reserved name`);
- * }
- * ```
- */
-declare const RESERVED_ATTRIBUTE_NAMES: readonly ["id", "createdAt", "updatedAt", "createdBy", "lastUpdatedBy", "objectId", "label", "completionStatus", "values", "metadata", "deletedAt", "deletedBy", "schemaVersion"];
-/**
- * Type for reserved attribute names
- */
-type ReservedAttributeName = (typeof RESERVED_ATTRIBUTE_NAMES)[number];
-
-type DocumentKind = "file" | "folder";
-interface Document extends Timestamps {
-    id: Uuid;
-    tenantId: Uuid;
-    title: string;
-    kind: DocumentKind;
-    parentId?: Uuid | null;
-    description?: string;
-    contentHash?: string;
-    createdBy?: Uuid;
-    updatedBy?: Uuid;
-    deletedAt?: Date | null;
-    /**
-     * Fractional ordering position within `(tenantId, parentId)`. Lower values
-     * sort first. New rows default to `max(siblings) + 1024` so reorderings can
-     * insert between neighbours without renumbering. The server may rebalance
-     * positions in the background to keep the spacing bounded.
-     */
-    position: number;
-}
-interface DocumentWithSubCount extends Document {
-    subCount: number | null;
-}
-/**
- * Configuration for a single named slot on a DocumentAttribute.
- * Slots are placeholders for files within a Document; declared at design-time
- * on the attribute and validated at attach time.
- */
-interface DocumentSlotConfig {
-    /** Stable identifier referenced in DB. */
-    name: string;
-    /** Display label in UI. Falls back to `name` if absent. */
-    label?: string;
-    /** Description shown to users and to the AI in tool context. */
-    description?: string;
-    /** Surfaced to UI/AI but not enforced by the system. */
-    required?: boolean;
-    /** MIME prefixes or globs (e.g. "image/*", "application/pdf"). */
-    acceptedMimeTypes?: string[];
-    /** Hard ceiling enforced by the service before upload. */
-    maxSizeBytes?: number;
-}
-/** Default applied by the document() builder when no slots are configured. */
-declare const DEFAULT_DOCUMENT_SLOT: DocumentSlotConfig;
-interface DocumentSlot extends Timestamps {
-    id: Uuid;
-    tenantId: Uuid;
-    documentId: Uuid;
-    slotName: string;
-    isAdditional: boolean;
-    fileId: Uuid;
-    status: SlotStatus;
-    ocrText?: string;
-    ocrConfidence?: number;
-    processedAt?: Date;
-}
-type SlotStatus = "uploaded" | "processing" | "completed" | "failed";
-interface ProcessingJob extends Timestamps {
-    id: Uuid;
-    tenantId: Uuid;
-    documentId: Uuid;
-    slotName?: string | null;
-    type: ProcessingJobType;
-    provider: string;
-    status: ProcessingJobStatus;
-    input?: Record<string, unknown>;
-    result?: Record<string, unknown>;
-    error?: string;
-    startedAt?: Date | null;
-    completedAt?: Date | null;
-    createdBy?: Uuid;
-}
-type ProcessingJobType = "ocr";
-type ProcessingJobStatus = "pending" | "processing" | "completed" | "failed" | "cancelled";
-interface CreateDocument {
-    title: string;
-    kind?: DocumentKind;
-    parentId?: Uuid | null;
-    description?: string;
-    position?: number;
-}
-/**
- * Reference to a record attribute that should atomically attach a freshly
- * created Document. Passed alongside `CreateDocument` to make creation
- * link-aware end-to-end (client → REST → service → repo).
- *
- * The server requires this — orphan Documents are not creatable through the
- * REST API.
- */
-interface CreateDocumentLink {
-    objectName: string;
-    sourceRecordId: string;
-    attributeName: string;
-    /**
-     * Optional qualifyWith properties on the record→Document edge. Currently
-     * accepted by the controller DTO but silently ignored by the service (see
-     * `DocumentService.createDocument` — there's a TODO to support this).
-     */
-    properties?: Record<string, unknown>;
-}
-interface UpdateDocument {
-    title?: string;
-    parentId?: Uuid | null;
-    position?: number;
-}
-interface CreateDocumentSlot {
-    documentId: Uuid;
-    slotName: string;
-    fileId: Uuid;
-    isAdditional?: boolean;
-}
-interface UpdateDocumentSlot {
-    status?: SlotStatus;
-    ocrText?: string;
-    ocrConfidence?: number;
-}
-interface CreateProcessingJob {
-    documentId: Uuid;
-    slotName?: string;
-    type: ProcessingJobType;
-    provider: string;
-    input?: Record<string, unknown>;
-}
-interface UpdateProcessingJob {
-    status?: ProcessingJobStatus;
-    result?: Record<string, unknown>;
-    error?: string;
-    startedAt?: Date;
-    completedAt?: Date;
-}
-interface DocumentListOptions {
-    limit?: number;
-    offset?: number;
-}
-interface DocumentWithSlots extends Document {
-    slots: DocumentSlot[];
-}
-interface RecordDocuments {
-    /** Documents grouped by attribute name (includes system 'attachments' attribute) */
-    byAttribute: Record<string, DocumentWithSlots[]>;
-}
-
-/**
- * Feature flag levels (resolution priority: user > tenant > global).
- *
- * - `global`: Applies to all tenants and users
- * - `tenant`: Applies to a specific tenant
- * - `user`: Applies to a specific user within a tenant
- */
-type FlagLevel = "global" | "tenant" | "user";
-/**
- * Flag value types supported by the system.
- */
-type FlagValueType = "boolean" | "string" | "number" | "json";
-/**
- * Definition of a feature flag.
- * Created using the flag builders (booleanFlag, stringFlag, etc.)
- */
-interface FeatureFlagDefinition<T = unknown> {
-    /** Unique identifier for the flag (kebab-case) */
-    name: string;
-    /** Human-readable label */
-    label: string;
-    /** Optional description */
-    description?: string;
-    /** Type of the flag value */
-    valueType: FlagValueType;
-    /** Default value when no override exists */
-    defaultValue: T;
-    /** Levels at which this flag can be overridden */
-    allowedLevels: FlagLevel[];
-    /** Grouping category for UI */
-    category?: string;
-    /** System flag - cannot be modified via API */
-    system?: boolean;
-}
-/**
- * Stored override for a feature flag.
- * Represents a row in the feature_flag_overrides table.
- */
-interface FlagOverride<T = unknown> {
-    /** Name of the flag being overridden */
-    flagName: string;
-    /** Level of the override */
-    level: FlagLevel;
-    /** Target ID (tenantId for tenant-level, userId for user-level) */
-    targetId?: string;
-    /** Override value */
-    value: T;
-    /** Optional expiration date */
-    expiresAt?: Date;
-    /** Who created this override */
-    createdBy?: string;
-    /** When the override was created */
-    createdAt: Date;
-    /** When the override was last updated */
-    updatedAt: Date;
-}
-/**
- * Resolved flag value with source information.
- * Result of flag resolution including where the value came from.
- */
-interface ResolvedFlag<T = unknown> {
-    /** Flag name */
-    name: string;
-    /** Resolved value */
-    value: T;
-    /** Where the value came from */
-    source: FlagLevel | "default";
-    /** ID of the source (tenantId or userId) if not default */
-    sourceId?: string;
-}
-/**
- * Feature gate configuration for conditional attribute visibility.
- * Used with the `.featureGate()` builder method.
- */
-interface FeatureGate {
-    /** Name of the flag to check */
-    flag: string;
-    /**
-     * Expected value for the gate to pass.
-     * For boolean flags, defaults to `true`.
-     * For other types, compares with strict equality.
-     */
-    expectedValue?: unknown;
-    /**
-     * Behavior when the gate fails.
-     * - `hide`: Attribute is completely hidden (default)
-     * - `show`: Attribute is shown regardless (no gating)
-     * - `disable`: Attribute is visible but read-only
-     */
-    fallback?: "hide" | "show" | "disable";
-}
-/**
- * Repository interface for feature flag overrides storage.
- * Added to DatabaseAdapter as an optional repository.
- *
- * If not provided, only static defaults from module config are used.
- */
-interface FeatureFlagsRepository {
-    /**
-     * Get all overrides matching the criteria.
-     * Returns overrides from the database (global, tenant, or user level).
-     */
-    getOverrides(options: {
-        /** Filter by level */
-        level?: FlagLevel;
-        /** Filter by target ID (tenantId or userId) */
-        targetId?: string;
-        /** Filter by flag names (for efficient single/batch lookups) */
-        flagNames?: string[];
-    }): Promise<FlagOverride[]>;
-    /**
-     * Create or update an override.
-     * Uses upsert semantics based on (flagName, level, targetId).
-     */
-    setOverride(override: Omit<FlagOverride, "createdAt" | "updatedAt">): Promise<FlagOverride>;
-    /**
-     * Delete an override.
-     */
-    deleteOverride(flagName: string, level: FlagLevel, targetId?: string): Promise<void>;
-}
-/**
- * Static flag default value for module configuration.
- */
-interface StaticFlagDefault {
-    /** Flag name */
-    name: string;
-    /** Default value */
-    value: unknown;
-}
-/**
- * Feature flags configuration for SchemaModule.
- */
-interface FeatureFlagsConfig {
-    /**
-     * Static default values for flags.
-     * These are always applied and used when no database override exists.
-     *
-     * @example
-     * ```typescript
-     * featureFlags: {
-     *   defaults: [
-     *     { name: "architect-mode", value: false },
-     *     { name: "ai-chat", value: false },
-     *     { name: "tier", value: "free" },
-     *   ],
-     * }
-     * ```
-     */
-    defaults?: StaticFlagDefault[];
-}
-
-/**
- * Allowed attribute types in .qualifyWith()
- *
- * IMPORTANT: Complex types (formula, rollup, relation, file, user, document, richtext)
- * are NOT supported to avoid duplicating backend behavior.
- */
-type PropertyType = "text" | "textarea" | "number" | "checkbox" | "date" | "phone" | "currency" | "status" | "select" | "multiselect" | "rating" | "location";
-/**
- * Union of attribute types allowed as qualified relation properties.
- *
- * These are the same Attribute types used for object attributes,
- * restricted to simple types that don't require complex backend duplication.
- */
-type PropertyAttribute = TextAttribute | TextAreaAttribute | NumberAttribute | CheckboxAttribute | DateAttribute | PhoneAttribute | CurrencyAttribute | StatusAttribute | SelectAttribute | MultiselectAttribute | RatingAttribute | LocationAttribute;
-/**
- * Schema defining properties for a qualified relation.
- *
- * Uses the same Attribute types as object attributes, enabling DRY builders:
- *
- * @example
- * ```typescript
- * relation({ name: "companies", label: "Companies" })
- *   .to("companies").many()
- *   .qualifyWith(
- *     select({ name: "role", label: "Role" }).options([...]).required(),
- *     number({ name: "shares", label: "Shares" }).min(0),
- *   )
- * ```
- */
-interface PropertySchema {
-    definitions: PropertyAttribute[];
-}
-/**
- * Property attribute types that have an `options` array.
- */
-type OptionPropertyAttribute = SelectAttribute | StatusAttribute | MultiselectAttribute;
-/**
- * Type guard to check if a property attribute has options.
- *
- * @param attr - The property attribute to check
- * @returns true if the attribute is a select, status, or multiselect type with options
- *
- * @example
- * ```typescript
- * for (const def of definitions) {
- *   if (hasOptions(def)) {
- *     // TypeScript knows def.options exists and is Option[]
- *     for (const option of def.options) {
- *       console.log(option.value);
- *     }
- *   }
- * }
- * ```
- */
-declare function hasOptions(attr: PropertyAttribute): attr is OptionPropertyAttribute;
-
-type AttributeType = "text" | "textarea" | "richtext" | "number" | "checkbox" | "date" | "phone" | "currency" | "status" | "location" | "select" | "multiselect" | "file" | "user" | "relation" | "rating" | "formula" | "rollup" | "document";
-/**
- * Status group categorization
- */
-type StatusGroup = "idle" | "in_progress" | "finished";
-/**
- * Unified option type for select-like fields
- */
-interface Option {
-    id: string;
-    label: string;
-    value: string;
-    color?: ColorId;
-    icon?: IconName;
-    description?: string;
-    group?: StatusGroup;
-    /** Value of the inverse option for bilateral relations (e.g. "parent" → "child") */
-    inverse?: string;
-}
-/**
- * Attribute grouping for UI organization
- */
-interface AttributeGroup {
-    id: string;
-    label: string;
-    description?: string;
-    attributeIds: string[];
-    collapsible?: boolean;
-    collapsed?: boolean;
-    order?: number;
-}
-interface BaseAttribute<DefaultValueType = unknown> {
-    id: Uuid;
-    name: string;
-    label: string;
-    type: AttributeType;
-    required: boolean;
-    disabled?: boolean;
-    placeholder?: string;
-    description?: string;
-    defaultValue?: DefaultValueType;
-    icon?: IconName;
-    order?: number;
-    hidden?: boolean;
-    archived?: boolean;
-    deprecated?: boolean;
-    system?: boolean;
-    /**
-     * Feature gate to conditionally show/hide/disable this attribute.
-     * When the flag condition is not met, the attribute behavior depends on `fallback`:
-     * - "hide" (default): Attribute is completely hidden
-     * - "disable": Attribute is visible but read-only
-     * - "show": No gating (useful for overriding parent settings)
-     */
-    featureGate?: FeatureGate;
-    metadata?: Record<string, unknown>;
-}
-interface TextAttribute extends BaseAttribute<string> {
-    type: "text";
-    minLength?: number;
-    maxLength?: number;
-    pattern?: string;
-}
-type NumberUnit = "integer" | "decimal" | "percentage";
-interface NumberAttribute extends BaseAttribute<number> {
-    type: "number";
-    min?: number;
-    max?: number;
-    unit?: NumberUnit;
-    decimals?: number;
-}
-interface CheckboxAttribute extends BaseAttribute<boolean> {
-    type: "checkbox";
-}
-type DateFormat = "short" | "long" | "full" | "relative";
-type DateValue = string | "today";
-interface DateAttribute extends BaseAttribute<string> {
-    type: "date";
-    dateFormat?: DateFormat;
-    minDate?: DateValue;
-    maxDate?: DateValue;
-}
-interface Phone {
-    countryCode: CountryIso3;
-    phoneNumber: string;
-}
-interface PhoneAttribute extends BaseAttribute<Phone> {
-    type: "phone";
-    defaultCountryCode?: CountryIso3;
-}
-interface Currency {
-    code: CurrencyCode;
-    value: number;
-}
-interface CurrencyAttribute extends BaseAttribute<Currency> {
-    type: "currency";
-    defaultCurrency?: CurrencyCode;
-    allowedCurrencies?: CurrencyCode[];
-    /** Allow negative currency values (e.g. refunds, credits). Defaults to false. */
-    allowNegative?: boolean;
-}
-/**
- * StatusAttribute - For workflow states with semantic grouping (idle/in_progress/finished)
- * Use this for: Task status, Order status, Project phases, Process states
- * Use SelectAttribute for: Categories, Types, simple choices without workflow
- */
-interface StatusAttribute extends BaseAttribute<string> {
-    type: "status";
-    options: Option[];
-}
-interface Location {
-    address?: string;
-    address2?: string;
-    city?: string;
-    state?: string;
-    postalCode?: string;
-    country?: CountryIso3;
-    latitude?: number;
-    longitude?: number;
-}
-type LocationGranularity = "full" | "address" | "city" | "state" | "country" | "coordinates";
-interface LocationAttribute extends BaseAttribute<Location> {
-    type: "location";
-    granularity: LocationGranularity;
-    enableAutocomplete?: boolean;
-    enableMap?: boolean;
-    defaultCountry?: CountryIso3;
-    allowedCountries?: CountryIso3[];
-    displayFormat?: "single_line" | "multi_line" | "compact";
-}
-/**
- * SelectAttribute - For simple single-choice selection
- * Use this for: Categories, Document types, Departments, Priorities
- * Options can be grouped (e.g., countries by continent) but no workflow logic
- */
-interface SelectAttribute extends BaseAttribute<string> {
-    type: "select";
-    options: Option[];
-}
-interface MultiselectAttribute extends BaseAttribute<string[]> {
-    type: "multiselect";
-    options: Option[];
-}
-interface FileAttribute extends BaseAttribute<string> {
-    type: "file";
-    maxFiles?: number;
-    maxSize?: number;
-    allowedTypes?: MimeType[] | readonly MimeType[];
-    multiple?: boolean;
-}
-interface UserAttribute extends BaseAttribute<string> {
-    type: "user";
-    allowedRoles?: string[];
-    multiple?: boolean;
-}
-/**
- * Wildcard marker for universal relations (can link to any object)
- * Use with `.toAny()` builder method
- */
-declare const RELATION_TARGET_ANY: "*";
-/**
- * Configuration for bilateral synchronization (bidirectional relations)
- */
-interface BilateralConfig {
-    /** Target object containing the inverse attribute */
-    object: string;
-    /** Name of the inverse attribute */
-    attribute: string;
-    /** Optional cardinality override (inferred by default) */
-    cardinality?: "one" | "many";
-    /** When true, this side owns the storage direction for qualified properties.
-     *  Set to false on the inverse side (enriched at read time). */
-    storageOwner?: boolean;
-}
-/**
- * Target object for a relation - defines which objects can be linked
- */
-interface RelationTarget {
-    /** Object name (e.g., "companies", "contacts") or "*" for any object */
-    object: string;
-    /**
-     * Display template for the label using mustache-like syntax
-     * @example "{name}" or "{firstName} {lastName} — {email}"
-     */
-    displayTemplate?: string;
-    /**
-     * Optional filter to restrict available records
-     * @example { status: "active" }
-     */
-    filter?: Record<string, unknown>;
-}
-/**
- * Base properties shared by both single and multi relation attributes
- *
- * Note: Deletion behavior is always "restrict" - if a record is referenced
- * by other records, it cannot be deleted until those references are removed.
- * This is enforced by RecordService.deleteRecord() which throws
- * RecordReferencedError when attempting to delete a referenced record.
- */
-interface RelationAttributeBase extends Omit<BaseAttribute<unknown>, "defaultValue"> {
-    type: "relation";
-    /** Target objects that can be linked */
-    targets: RelationTarget[];
-    /** Optional properties schema for qualified relations */
-    properties?: PropertySchema;
-    /** Configuration for bilateral synchronization (opt-in) */
-    bilateral?: BilateralConfig;
-}
-/**
- * Single relation attribute (one-to-one or many-to-one)
- * Stores a single record ID or null
- */
-interface SingleRelationAttribute extends RelationAttributeBase {
-    cardinality: "one";
-    defaultValue?: string | null;
-}
-/**
- * Multi relation attribute (one-to-many or many-to-many)
- * Stores an array of record IDs
- */
-interface MultiRelationAttribute extends RelationAttributeBase {
-    cardinality: "many";
-    defaultValue?: string[];
-    /** Minimum number of relations required */
-    minItems?: number;
-    /** Maximum number of relations allowed */
-    maxItems?: number;
-}
-/**
- * RelationAttribute links to other objects/records
- * Discriminated union by cardinality for type-safe value handling
- *
- * @example Single relation (many-to-one)
- * ```typescript
- * relation({ name: "company", label: "Company" })
- *   .to("companies")
- *   .required()
- * // → Value: "rec-uuid-123" | null
- * ```
- *
- * @example Multi relation (many-to-many)
- * ```typescript
- * relation({ name: "contacts", label: "Contacts" })
- *   .to("contacts", { displayTemplate: "{firstName} {lastName}" })
- *   .many()
- *   .maxItems(5)
- * // → Value: ["rec-1", "rec-2", ...]
- * ```
- *
- * @example Polymorphic relation (multiple target objects)
- * ```typescript
- * relation({ name: "linked", label: "Linked Items" })
- *   .to("companies")
- *   .to("contacts")
- *   .to("deals")
- *   .many()
- * // → Can link to records from any of these objects
- * ```
- */
-type RelationAttribute = SingleRelationAttribute | MultiRelationAttribute;
-/**
- * Check if a relation attribute is universal (can link to any object)
- * Universal relations have `targets: [{ object: "*" }]`
- */
-declare function isUniversalRelation(attr: RelationAttribute): boolean;
-/**
- * Check if a relation attribute has bilateral synchronization enabled
- */
-declare function isBilateralRelation(attr: RelationAttribute): attr is RelationAttribute & {
-    bilateral: BilateralConfig;
-};
-/**
- * Infer the cardinality of the inverse relation
- * - one → many (contact.company ↔ company.contacts)
- * - many → many (contact.tags ↔ tag.contacts)
- */
-declare function inferInverseCardinality(cardinality: "one" | "many"): "one" | "many";
-interface TextAreaAttribute extends BaseAttribute<string> {
-    type: "textarea";
-}
-/**
- * Available features for richtext editor
- */
-type RichtextFeature = "headings" | "bold" | "italic" | "lists" | "links" | "images" | "codeBlocks" | "tables";
-/**
- * RichtextAttribute - Rich text content using semantic markdown
- *
- * Stores content as semantic markdown string (with directives like :::callout).
- * Parsed at runtime to Tiptap JSON for editing.
- * Use this for: Notes, articles, descriptions, long-form content.
- *
- * @example
- * ```typescript
- * richtext({ name: "content", label: "Content" })
- *   .features(["headings", "bold", "italic", "lists", "links"])
- *   .required()
- * ```
- */
-interface RichtextAttribute extends BaseAttribute<string> {
-    type: "richtext";
-    /** Enabled features. If undefined, all features are enabled. */
-    features?: RichtextFeature[];
-}
-interface RatingAttribute extends BaseAttribute<number> {
-    type: "rating";
-    max?: number;
-    iconType?: "star" | "heart" | "thumbs" | "number";
-}
-/**
- * Return type for formula expressions
- */
-type FormulaReturnType = "text" | "number" | "boolean" | "date";
-/**
- * FormulaAttribute - Computed value based on other attributes
- *
- * Formulas are calculated at read-time and are always read-only.
- * Users cannot directly edit formula values.
- *
- * @example Simple calculation
- * ```typescript
- * formula({ name: "total", label: "Total" })
- *   .expression("price * quantity")
- *   .returns("number")
- *   .decimals(2)
- * ```
- *
- * @example With functions
- * ```typescript
- * formula({ name: "fullName", label: "Full Name" })
- *   .expression("CONCAT(firstName, ' ', lastName)")
- *   .returns("text")
- * ```
- */
-interface FormulaAttribute extends Omit<BaseAttribute<never>, "defaultValue" | "required"> {
-    type: "formula";
-    /** Expression to evaluate (e.g., "price * quantity") */
-    expression: string;
-    /** Expected return type for formatting */
-    returnType: FormulaReturnType;
-    /** Decimal places for number results */
-    decimals?: number;
-    /** Whether to allow relation references in the expression (e.g., "company.name") */
-    allowRelations?: boolean;
-    /** Formula is always not required (read-only) */
-    required: false;
-}
-/**
- * Aggregation functions for rollup attributes
- *
- * Categories:
- * - Numeric (sum, avg): Only for number, currency, rating types
- * - Date (earliest, latest): Only for date type
- * - Count (count, countValues, countUniqueValues, countEmpty): Universal
- * - Percent (percentEmpty, percentNotEmpty): Universal
- * - Lookup (original): Returns all values as array, rendered as target type
- */
-type RollupFunction = "sum" | "avg" | "earliest" | "latest" | "count" | "countValues" | "countUniqueValues" | "countEmpty" | "percentEmpty" | "percentNotEmpty" | "original";
-/**
- * RollupAttribute - Aggregates values from related records
- *
- * Rollups are calculated and stored (denormalized) for performance.
- * They are automatically recalculated when related records change.
- * Users cannot directly edit rollup values.
- *
- * @example Sum of related amounts
- * ```typescript
- * rollup({ name: "totalOrders", label: "Total Orders" })
- *   .from("orders")           // relation attribute name
- *   .aggregate("amount")      // target attribute to sum
- *   .using("sum")
- *   .decimals(2)
- * ```
- *
- * @example Count of related records
- * ```typescript
- * rollup({ name: "orderCount", label: "Number of Orders" })
- *   .from("orders")
- *   .using("count")
- * ```
- */
-interface RollupAttribute extends Omit<BaseAttribute<never>, "defaultValue" | "required"> {
-    type: "rollup";
-    /** Name of the relation attribute on this object */
-    relationAttribute: string;
-    /**
-     * Dot notation path for multi-level traversal (Phase 4+)
-     * @example "orders.items" - traverse through orders to items
-     */
-    relationPath?: string;
-    /** Attribute name on the target object to aggregate */
-    targetAttribute: string;
-    /** Aggregation function to apply */
-    function: RollupFunction;
-    /** Decimal places for numeric results */
-    decimals?: number;
-    /** Rollup is always not required (read-only) */
-    required: false;
-    /**
-     * Cached type of the target attribute for display purposes
-     * Used when function="original" to render values as the target type
-     */
-    targetAttributeType?: AttributeType;
-    /**
-     * Cached options from target attribute (for select/status/multiselect display)
-     * Required when function="original" and target is a select-like type
-     */
-    targetAttributeOptions?: Option[];
-}
-/**
- * DocumentAttribute - References one or multiple structured documents.
- *
- * Unlike FileAttribute which stores raw file references, DocumentAttribute
- * provides structured document handling with multi-file support and
- * optional agent-compatible processing (for example OCR).
- *
- * Every document attribute is multi by construction — the underlying
- * storage (documents + document_slots + files) supports 1 Doc → N slot
- * files uniformly. Single-value file fields use `file()` instead.
- *
- * @example
- * ```typescript
- * document({ name: "contracts", label: "Contrats" })
- *   .autoProcess()
- *   .maxDocuments(10)
- * ```
- */
-interface DocumentAttribute extends BaseAttribute<string[]> {
-    type: "document";
-    /**
-     * Maximum number of documents.
-     */
-    maxDocuments?: number;
-    /**
-     * Automatically trigger agent-compatible processing on upload.
-     */
-    autoProcess?: boolean;
-    /**
-     * Schema for typed properties on the record→document edge.
-     * Symmetric with `RelationAttribute.properties`; populated by `.qualifyWith(...)`.
-     * Stored on `record_reference_edges.properties`, not on the document itself.
-     */
-    properties?: PropertySchema;
-    /** Child attribute definitions for per-document metadata. */
-    attributes?: Attribute[];
-    /**
-     * File slots declared on this attribute. Builder injects
-     * [DEFAULT_DOCUMENT_SLOT] when omitted. Always non-empty in practice.
-     */
-    slots?: DocumentSlotConfig[];
-}
-type Attribute = TextAttribute | TextAreaAttribute | RichtextAttribute | NumberAttribute | CheckboxAttribute | DateAttribute | PhoneAttribute | CurrencyAttribute | StatusAttribute | LocationAttribute | SelectAttribute | MultiselectAttribute | FileAttribute | UserAttribute | RelationAttribute | RatingAttribute | FormulaAttribute | RollupAttribute | DocumentAttribute;
-/**
- * Check if an attribute supports sorting based on its type.
- */
-declare function isAttributeSortable(attr: {
-    type: AttributeType;
-}): boolean;
-
-/** Operators for text-based attributes */
-type TextFilterOperator = "is" | "is_not" | "contains" | "not_contains" | "starts_with" | "ends_with" | "is_empty" | "is_not_empty";
-/** Operators for number-based attributes */
-type NumberFilterOperator = "eq" | "neq" | "lt" | "gt" | "lte" | "gte" | "is_empty" | "is_not_empty";
-/** Operators for checkbox */
-type CheckboxFilterOperator = "is_checked" | "is_not_checked";
-/** Operators for date-based attributes */
-type DateFilterOperator = "is" | "is_not" | "before" | "after" | "on_or_before" | "on_or_after" | "is_within" | "day_month_eq" | "is_empty" | "is_not_empty";
-/** Operators for select-based attributes (supports single or multi-value filtering) */
-type SelectFilterOperator = "is" | "is_not" | "any_of" | "none_of" | "is_empty" | "is_not_empty";
-/** Operators for multiselect-based attributes */
-type MultiselectFilterOperator = "contains" | "not_contains" | "is_empty" | "is_not_empty";
-/**
- * Operators for relation-based attributes (covers single, multi-value, and
- * reference-shaped filtering — file, user, relation, document all share the
- * same edge-backed operator set as of Phase 4.4).
- */
-type RelationFilterOperator = "is" | "is_not" | "any_of" | "none_of" | "contains" | "not_contains" | "is_empty" | "is_not_empty";
-/** All possible filter operators */
-type FilterOperator = TextFilterOperator | NumberFilterOperator | CheckboxFilterOperator | DateFilterOperator | SelectFilterOperator | MultiselectFilterOperator | RelationFilterOperator;
-/** Relative date value for "is_within" operator */
-interface RelativeDateValue {
-    amount: number;
-    unit: "days" | "weeks" | "months" | "years";
-    direction: "past" | "future";
-}
-/** Currency filter value with amount and optional currency codes
- * - code: undefined or [] = any currency
- * - code: string[] = filter by specific currencies
- */
-interface CurrencyFilterValue {
-    value: number | null;
-    code?: string[];
-}
-/** Phone filter value with number and optional country code */
-interface PhoneFilterValue {
-    phoneNumber: string | null;
-    countryCode?: string;
-}
-/** Filter value can be various types depending on the attribute */
-type FilterValue = string | number | boolean | string[] | RelativeDateValue | CurrencyFilterValue | PhoneFilterValue | null;
-/** A single filter rule */
-interface FilterRule {
-    /** Root attribute name (scalar attribute, or a reference attribute when `property` is set). */
-    attribute: string;
-    /**
-     * If set, this rule filters on a qualified edge property.
-     * Requires `attribute` to be a reference attribute (today: `relation` or `document`) that has `.qualifyWith()`.
-     * The `operator` must be valid for the property's type, not the root attribute's type.
-     */
-    property?: string;
-    /** Filter operator */
-    operator: FilterOperator;
-    /** Filter value (null for operators like is_empty) */
-    value: FilterValue;
-}
-/**
- * Extended filter rule with optional attribute definition.
- * When provided, enables smarter type-aware filtering (e.g., array operators for multiselect).
- */
-interface ExtendedFilterRule extends FilterRule {
-    /** Full attribute definition for type-aware filtering */
-    attributeDef?: Attribute;
-}
-/** Combinator for filter rules */
-type FilterCombinator = "and" | "or";
-/** Complete filter state (simple mode) */
-interface FilterState {
-    /** How to combine rules */
-    combinator: FilterCombinator;
-    /** List of filter rules */
-    rules: FilterRule[];
-}
-/**
- * A filter group containing rules (used in advanced mode)
- * Groups can be nested up to 2 levels deep
- */
-interface FilterGroup {
-    /** Unique identifier for this group */
-    id: string;
-    /** How to combine rules within this group */
-    combinator: FilterCombinator;
-    /** List of filter rules in this group */
-    rules: FilterRule[];
-}
-/**
- * Advanced filter state with nested groups
- * Structure: AdvancedFilterState -> FilterGroup[] -> FilterRule[]
- * Maximum 2 levels of nesting
- */
-interface AdvancedFilterState {
-    /** How to combine groups at the top level */
-    combinator: FilterCombinator;
-    /** List of filter groups */
-    groups: FilterGroup[];
-}
-/** Sort direction */
-type SortDirection = "asc" | "desc";
-/** A single sort rule */
-interface SortRule {
-    /** Attribute name to sort by */
-    attribute: string;
-    /** Sort direction */
-    direction: SortDirection;
-}
-/** Complete query state with search, filters, sorts, and pagination */
-interface QueryState {
-    /** Full-text search query */
-    search?: string;
-    /** Filter configuration (simple mode) */
-    filters?: FilterState;
-    /** Advanced filter configuration (grouped mode) */
-    advancedFilters?: AdvancedFilterState;
-    /** Sort configuration (multiple sorts supported) */
-    sorts?: SortRule[];
-    /** Pagination */
-    limit?: number;
-    offset?: number;
-}
-/** Mapping of attribute types to their valid operators (rollup excluded — use getRollupFilterOperators()) */
-declare const OPERATORS_BY_TYPE: Record<Exclude<AttributeType, "rollup">, readonly FilterOperator[]>;
-/** Check if an operator requires a value */
-type NoValueOperator = "is_empty" | "is_not_empty" | "is_checked" | "is_not_checked";
-/** Operators that don't require a value */
-declare const NO_VALUE_OPERATORS: readonly NoValueOperator[];
-/**
- * Check if an operator requires a value
- */
-declare function isNoValueOperator(operator: FilterOperator): operator is NoValueOperator;
-/**
- * Get the filter operators for a rollup attribute based on its aggregation function and target type.
- *
- * - earliest / latest → date operators
- * - original → operators matching targetAttributeType (falls back to numeric if unknown)
- * - all other functions → numeric operators (sum, avg, count, percent, etc.)
- */
-declare function getRollupFilterOperators(attr: RollupAttribute): readonly FilterOperator[];
-
-export { type FieldGroup as $, type Attribute as A, type Option as B, type CurrencyAttribute as C, type DateAttribute as D, type FormulaReturnType as E, type FileAttribute as F, type BilateralConfig as G, type RelationTarget as H, type RichtextFeature as I, type RollupFunction as J, type MigrationDefinition as K, type LocationAttribute as L, type MultiRelationAttribute as M, type NumberAttribute as N, type ObjectDefinition as O, type PhoneAttribute as P, type DetailViewConfig as Q, type RelationAttribute as R, type SingleRelationAttribute as S, type TextAreaAttribute as T, type UserAttribute as U, type ViewType as V, type DetailViewDefinition as W, type DetailViewLayout as X, type SidePanelConfig as Y, type Field as Z, type AttributeGroupField as _, type RichtextAttribute as a, type ProcessingJobStatus as a$, type RelationGroup as a0, type Group as a1, type TableTab as a2, type CreateMode as a3, type Tab as a4, type ListViewConfig as a5, type ListViewDefinition as a6, type FlagValueType as a7, type FeatureFlagDefinition as a8, type FlagLevel as a9, type DocumentSlot as aA, type DocumentWithSlots as aB, type DocumentWithSubCount as aC, type DocumentsTab as aD, type ExtendedFilterRule as aE, type FeatureFlagsConfig as aF, type FilterCombinator as aG, type FilterGroup as aH, type FlagOverride as aI, type FolderPreset as aJ, type FormDensity as aK, type FormTab as aL, type FormsTab as aM, type InverseSource as aN, type ListViewLayout as aO, MAX_PRESET_DEPTH as aP, type MigrationError as aQ, NO_VALUE_OPERATORS as aR, type NoValueOperator as aS, type NumberUnit as aT, OPERATORS_BY_TYPE as aU, type ObjectAttribute as aV, type ObjectRecord as aW, type OptionPropertyAttribute as aX, type PhoneFilterValue as aY, type PresetNode as aZ, type ProcessingJob as a_, type FeatureFlagsRepository as aa, type StaticFlagDefault as ab, type ResolvedFlag as ac, type ViewDefinition as ad, type ListViewTab as ae, type FilterOperator as af, type FilterValue as ag, type FilterRule as ah, type ActivityTab as ai, type AdvancedFilterState as aj, type AttributeGroup as ak, type BaseAttribute as al, type BuiltInTransform as am, type CreateDocument as an, type CreateDocumentLink as ao, type CreateDocumentSlot as ap, type CreateProcessingJob as aq, type CurrencyFilterValue as ar, type CustomTab as as, DEFAULT_DOCUMENT_SLOT as at, type DateFormat as au, type DateValue as av, type Document as aw, type DocumentKind as ax, type DocumentLayoutVariant as ay, type DocumentListOptions as az, type MultiselectAttribute as b, type ProcessingJobType as b0, type PropertyAttribute as b1, type PropertyType as b2, type QueryState as b3, RELATION_TARGET_ANY as b4, RESERVED_ATTRIBUTE_NAMES as b5, type RecordDocuments as b6, type RelationSource as b7, type RelativeDateValue as b8, type ReservedAttributeName as b9, type RichtextTab as ba, SYSTEM_FIELD_NAMES as bb, type SlotStatus as bc, type SortDirection as bd, type StatusGroup as be, type SystemFieldName as bf, type TabType as bg, type TableSource as bh, type UpdateDocument as bi, type UpdateDocumentSlot as bj, type UpdateProcessingJob as bk, type ViewOperation as bl, type ViewOverlay as bm, type ViewTransform as bn, getRollupFilterOperators as bo, hasOptions as bp, inferInverseCardinality as bq, isAttributeSortable as br, isBilateralRelation as bs, isDetailView as bt, isFieldGroup as bu, isListView as bv, isNoValueOperator as bw, isRelationGroup as bx, isUniversalRelation as by, type SelectAttribute as c, type StatusAttribute as d, type FormulaAttribute as e, type RollupAttribute as f, type CheckboxAttribute as g, type RatingAttribute as h, type TextAttribute as i, type CompletionStatus as j, type SortRule as k, type FilterState as l, type Timestamps as m, type AttributeType as n, type DocumentLayout as o, type ViewConfig as p, type ConfigOverrides as q, type SchemaOperation as r, type LocationGranularity as s, type Location as t, type DocumentAttribute as u, type Phone as v, type Currency as w, type DocumentSlotConfig as x, type PropertySchema as y, type FeatureGate as z };