@stndrds/schema 0.1.0-alpha.67 → 1.0.0-alpha.102

package/dist/helpers-DD6JzYfI.d.mts

@@ -0,0 +1,860 @@
+import { z } from 'zod';
+import { A as Attribute, j as AttributeType, f as RollupAttribute } from './attributes-D7yQuTJK.mjs';
+import { V as ValidationMessages, a as ValidationResult } from './types-BAPgWlpX.mjs';
+import { IconName } from '@stndrds/constants';
+import { Uuid } from './utils.mjs';
+
+/** 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" | "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 (supports single or multi-value filtering) */
+type RelationFilterOperator = "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 {
+    /** Attribute name to filter on */
+    attribute: 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[];
+
+/**
+ * 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 TransformSource = "system" | "runtime" | "rollback" | "seed";
+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[];
+    reverse_operations: SchemaOperation[];
+}
+interface SchemaTransform {
+    id: string;
+    tenantId: string;
+    objectId: string;
+    fromVersion: number;
+    toVersion: number;
+    operations: SchemaOperation[];
+    reverseOperations: SchemaOperation[];
+    source: TransformSource;
+    appliedAt: Date;
+    fullyMigrated: boolean;
+}
+interface ViewTransform {
+    id: string;
+    tenantId: string;
+    viewId: string;
+    fromVersion: number;
+    toVersion: number;
+    operations: ViewOperation[];
+    reverseOperations: ViewOperation[];
+    source: TransformSource;
+    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[];
+}
+/**
+ * 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;
+    /**
+     * User ID who created this record.
+     * Automatically set by RecordService when userId is configured.
+     * Optional for backward compatibility with existing records.
+     */
+    createdBy?: string;
+    /**
+     * User ID who last updated this record.
+     * Automatically set by RecordService when userId is configured.
+     * Optional for backward compatibility with existing records.
+     */
+    lastUpdatedBy?: string;
+    /** Schema version at the time this record was last migrated */
+    schemaVersion: number;
+    /**
+     * Values archived during attribute removal or type changes.
+     * Retained according to the retention policy before permanent deletion.
+     */
+    archivedValues?: Record<string, unknown>;
+}
+/**
+ * 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", "schemaVersion", "archivedValues"];
+/**
+ * Type for reserved attribute names
+ */
+type ReservedAttributeName = (typeof RESERVED_ATTRIBUTE_NAMES)[number];
+
+/**
+ * Create a Zod schema for any attribute type.
+ * Returns a strict validator that does NOT handle optional fields.
+ * Use createFormAttributeValidator for form validation with optional support.
+ *
+ * @param attr - The attribute to create a validator for
+ * @param messages - Custom validation messages for i18n support
+ */
+declare function createAttributeValidator(attr: Attribute, messages?: ValidationMessages): z.ZodTypeAny;
+/**
+ * Create a Zod schema for form validation.
+ * - Normalizes empty values (empty strings, empty objects) to null for optional fields
+ * - Accepts custom messages for i18n support
+ *
+ * Use this in UI forms where optional fields may have null/undefined values.
+ *
+ * @param attr - The attribute to create a validator for
+ * @param messages - Custom validation messages for i18n support
+ */
+declare function createFormAttributeValidator(attr: Attribute, messages?: ValidationMessages): z.ZodTypeAny;
+
+/**
+ * Validate data against an attribute schema
+ */
+declare function validateAttribute(attr: Attribute, value: unknown): ValidationResult;
+/**
+ * Validate data against an object schema
+ */
+declare function validateObject(objectDef: ObjectDefinition, data: Record<string, unknown>): ValidationResult;
+/**
+ * Validate and throw if invalid
+ */
+declare function validateObjectOrThrow(objectDef: ObjectDefinition, data: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Validate data in draft mode.
+ * - All attributes are treated as optional (no required validation)
+ * - Provided values are still validated for format/type correctness
+ */
+declare function validateDraft(objectDef: ObjectDefinition, data: Record<string, unknown>): ValidationResult;
+/**
+ * Validate draft data and throw if format validation fails.
+ */
+declare function validateDraftOrThrow(objectDef: ObjectDefinition, data: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Get the list of required attributes that are missing values.
+ */
+declare function getMissingRequiredAttributes(objectDef: ObjectDefinition, data: Record<string, unknown>): Attribute[];
+/**
+ * Check if a record is complete (all required attributes have valid values).
+ */
+declare function isRecordComplete(objectDef: ObjectDefinition, data: Record<string, unknown>): boolean;
+/**
+ * Compute the completion status of a record based on its data.
+ */
+declare function computeRecordStatus(objectDef: ObjectDefinition, data: Record<string, unknown>): CompletionStatus;
+
+export { type MigrationError as $, type AttributeGroupField as A, type BuiltInTransform as B, type ConfigOverrides as C, type DetailViewConfig as D, type CurrencyFilterValue as E, type FilterState as F, type Group as G, type CustomTab as H, type DocumentsTab as I, type ExtendedFilterRule as J, type FilterCombinator as K, type ListViewConfig as L, type MigrationDefinition as M, type FilterGroup as N, type ObjectDefinition as O, type FilterOperator as P, type FilterRule as Q, type RelationGroup as R, type SortRule as S, type Timestamps as T, type FilterValue as U, type ViewType as V, type FormDensity as W, type FormTab as X, type FormsTab as Y, type InverseSource as Z, type ListViewLayout as _, createFormAttributeValidator as a, NO_VALUE_OPERATORS as a0, type NoValueOperator as a1, OPERATORS_BY_TYPE as a2, type ObjectAttribute as a3, type PhoneFilterValue as a4, type QueryState as a5, RESERVED_ATTRIBUTE_NAMES as a6, type RelationSource as a7, type RelativeDateValue as a8, type ReservedAttributeName as a9, type RichtextTab as aa, SYSTEM_FIELD_NAMES as ab, type SchemaOperation as ac, type SchemaTransform as ad, type SortDirection as ae, type SystemFieldName as af, type TabType as ag, type TableSource as ah, type TransformSource as ai, type ViewOperation as aj, type ViewOverlay as ak, type ViewTransform as al, getRollupFilterOperators as am, isDetailView as an, isFieldGroup as ao, isListView as ap, isNoValueOperator as aq, isRelationGroup as ar, validateObject as b, computeRecordStatus as c, validateObjectOrThrow as d, createAttributeValidator as e, validateAttribute as f, getMissingRequiredAttributes as g, validateDraft as h, isRecordComplete as i, type ViewConfig as j, type CompletionStatus as k, type ObjectRecord as l, type DetailViewDefinition as m, type DetailViewLayout as n, type SidePanelConfig as o, type Field as p, type FieldGroup as q, type TableTab as r, type CreateMode as s, type Tab as t, type ListViewDefinition as u, validateDraftOrThrow as v, type ViewDefinition as w, type ListViewTab as x, type ActivityTab as y, type AdvancedFilterState as z };