@wildo-ai/zod-decorators 1.0.0

package/dist/esm/zod-decorators.types.js

@@ -0,0 +1,771 @@
+// Symbol for storing metadata on Zod schemas. Uses Symbol.for() to ensure the same symbol is used across packages.
+export const SCHEMA_METADATA = Symbol.for('schema_metadata');
+// Schema type categories for component selection.
+// Represents the underlying Zod schema type detected from introspection.
+export var FieldSchemaType;
+(function (FieldSchemaType) {
+    FieldSchemaType["STRING"] = "string";
+    FieldSchemaType["NUMBER"] = "number";
+    FieldSchemaType["BIGINT"] = "bigint";
+    FieldSchemaType["BOOLEAN"] = "boolean";
+    FieldSchemaType["ENUM"] = "enum";
+    FieldSchemaType["DATE"] = "date";
+    FieldSchemaType["OBJECT"] = "object";
+    FieldSchemaType["ARRAY"] = "array";
+    FieldSchemaType["SET"] = "set";
+    FieldSchemaType["TUPLE"] = "tuple";
+    FieldSchemaType["RECORD"] = "record";
+    FieldSchemaType["MAP"] = "map";
+    FieldSchemaType["TIME"] = "time";
+    FieldSchemaType["DATETIME"] = "datetime";
+    FieldSchemaType["RANGE_NUMBER"] = "range_number";
+    FieldSchemaType["RANGE_DATE"] = "range_date";
+    FieldSchemaType["RANGE_DATETIME"] = "range_datetime";
+    FieldSchemaType["RANGE_TIME"] = "range_time";
+    FieldSchemaType["RANGE_BIGDECIMAL"] = "range_bigdecimal";
+    FieldSchemaType["RANGE_MONEY"] = "range_money";
+    FieldSchemaType["MONEY"] = "money";
+    FieldSchemaType["BIGDECIMAL"] = "bigdecimal";
+    FieldSchemaType["CODE"] = "code";
+    FieldSchemaType["FILE"] = "file";
+    FieldSchemaType["DURATION"] = "duration";
+    FieldSchemaType["PHONE"] = "phone";
+    FieldSchemaType["VERSIONED_FOREIGN_KEY"] = "versioned_foreign_key";
+    FieldSchemaType["VERSIONED_OBJECT"] = "versioned_object";
+    FieldSchemaType["UNKNOWN"] = "unknown";
+})(FieldSchemaType || (FieldSchemaType = {}));
+///=======================================================================================================================
+/// FORM FIELD COMPONENT TYPES
+///=======================================================================================================================
+// Form field component types.
+// Represents the UI component that should render a form field.
+export var FormFieldComponent;
+(function (FormFieldComponent) {
+    FormFieldComponent["INPUT"] = "input";
+    FormFieldComponent["TEXTAREA"] = "textarea";
+    FormFieldComponent["SELECT"] = "select";
+    FormFieldComponent["RADIO_GROUP"] = "radio-group";
+    FormFieldComponent["CHECKBOX"] = "checkbox";
+    FormFieldComponent["CHECKBOX_GROUP"] = "checkbox-group";
+    FormFieldComponent["SWITCH"] = "switch";
+    FormFieldComponent["SLIDER"] = "slider";
+    FormFieldComponent["DATE"] = "date";
+    FormFieldComponent["TIME"] = "time";
+    FormFieldComponent["DATETIME"] = "datetime";
+    FormFieldComponent["RANGE_SLIDER"] = "range-slider";
+    FormFieldComponent["DATE_RANGE"] = "date-range";
+    FormFieldComponent["DATETIME_RANGE"] = "datetime-range";
+    FormFieldComponent["TIME_RANGE"] = "time-range";
+    FormFieldComponent["BIGDECIMAL_RANGE"] = "bigdecimal-range";
+    FormFieldComponent["MONEY_RANGE"] = "money-range";
+    FormFieldComponent["DURATION"] = "duration";
+    FormFieldComponent["PHONE"] = "phone";
+})(FormFieldComponent || (FormFieldComponent = {}));
+// ================================
+// FORM FIELD CHROME MODES
+// ================================
+//------------------------------------------------------------------------------------------------
+// CHROME MODES — display and edit context
+//------------------------------------------------------------------------------------------------
+/**
+ * Chrome layout mode for display context (detail/read-only views).
+ * Controls how the field wrapper (label, value, description) is arranged.
+ */
+export const DisplayChromeMode = {
+    /** Label above, value below, description below value (default). */
+    STACKED: 'stacked',
+    /** Label and value on the same line. */
+    INLINE: 'inline',
+    /** No label/description, just value (dense mode). */
+    COMPACT: 'compact',
+    /** No chrome at all — bare value output. */
+    HIDDEN: 'hidden',
+};
+/**
+ * Chrome layout mode for edit context (forms).
+ * Superset of DisplayChromeMode with form-specific modes (SETTINGS_ROW, RELAXED).
+ *
+ * Also exported as `FormFieldChromeMode` for backward compatibility.
+ */
+export const EditChromeMode = {
+    /** Label above, control below, description + error below control (default). */
+    STACKED: 'stacked',
+    /** Label + description left, control + error right (settings page style). */
+    SETTINGS_ROW: 'settings_row',
+    /** Control left, label + description right (switch/checkbox style). */
+    INLINE: 'inline',
+    /** Generous spacing, heading-size label (onboarding, OTP, wizard). */
+    RELAXED: 'relaxed',
+    /** No label/description, just control + error (dense mode). */
+    COMPACT: 'compact',
+    /** No chrome at all — bare control output. */
+    HIDDEN: 'hidden',
+};
+/** @deprecated Use `EditChromeMode` directly. Kept as alias for backward compatibility. */
+export const FormFieldChromeMode = EditChromeMode;
+///=======================================================================================================================
+/// DISPLAY FIELD COMPONENT TYPES
+///=======================================================================================================================
+export var DisplayFieldComponent;
+(function (DisplayFieldComponent) {
+    // Basic/fallback
+    DisplayFieldComponent["SIMPLE_TEXT"] = "simple-text";
+    // Primitive types
+    DisplayFieldComponent["STRING"] = "string";
+    DisplayFieldComponent["NUMBER"] = "number";
+    DisplayFieldComponent["BOOLEAN"] = "boolean";
+    DisplayFieldComponent["ENUM"] = "enum";
+    // Date/Time types
+    DisplayFieldComponent["DATE"] = "date";
+    DisplayFieldComponent["TIME"] = "time";
+    DisplayFieldComponent["DATETIME"] = "datetime";
+    // Special primitive types
+    DisplayFieldComponent["CODE"] = "code";
+    DisplayFieldComponent["FILE"] = "file";
+    DisplayFieldComponent["MONEY"] = "money";
+    DisplayFieldComponent["BIGDECIMAL"] = "bigdecimal";
+    DisplayFieldComponent["DURATION"] = "duration";
+    DisplayFieldComponent["PHONE"] = "phone";
+    // Range types
+    DisplayFieldComponent["RANGE_NUMBER"] = "range-number";
+    DisplayFieldComponent["RANGE_DATE"] = "range-date";
+    DisplayFieldComponent["RANGE_TIME"] = "range-time";
+    DisplayFieldComponent["RANGE_DATETIME"] = "range-datetime";
+    DisplayFieldComponent["RANGE_BIGDECIMAL"] = "range-bigdecimal";
+    DisplayFieldComponent["RANGE_MONEY"] = "range-money";
+})(DisplayFieldComponent || (DisplayFieldComponent = {}));
+//------------------------------------------------------------------------------------------------
+// FORM FIELD
+//------------------------------------------------------------------------------------------------
+// =============================================================================
+// SECTION MODE - Unified enum for section rendering
+// =============================================================================
+/**
+ * How a section is rendered — both per-section appearance and container grouping.
+ *
+ * **Solo modes** (render in place, no grouping):
+ * - DEFAULT: Standard section with border and padding
+ * - CARD: Wrapped in a card container with shadow
+ * - GHOST: Minimal container without visual styling
+ * - COLLAPSIBLE: Expandable/collapsible section with trigger
+ *
+ * **Container modes** (sections sharing the same mode are grouped together,
+ * rendered at the position of the first occurrence):
+ *
+ * @category Layout-based (all sections visible simultaneously)
+ * - INLINE: Stacked vertically
+ * - GRID: CSS Grid layout with configurable columns
+ * - COLUMNS: Multi-column layout (newspaper style)
+ *
+ * @category Navigation-based (one section visible at a time)
+ * - TABS: Horizontal tabs navigation
+ * - VERTICAL_TABS: Vertical tabs (side navigation)
+ * - PILLS: Pill/segment navigation (compact)
+ *
+ * @category Expandable (toggle section visibility)
+ * - ACCORDION: Each section independently collapsible
+ * - EXPANDABLE: "Show more" button reveals additional sections
+ *
+ * @category Guided (sequential, with indicators)
+ * - STEPPER: Step-by-step with step indicators
+ * - TIMELINE: Chronological progression (vertical timeline)
+ *
+ * NOTE: Wizard is NOT included — it's a higher-level layout pattern
+ * that contains sections, not a section rendering mode.
+ */
+export var SectionMode;
+(function (SectionMode) {
+    // Solo (render in place, no grouping)
+    SectionMode["DEFAULT"] = "default";
+    SectionMode["CARD"] = "card";
+    SectionMode["GHOST"] = "ghost";
+    SectionMode["COLLAPSIBLE"] = "collapsible";
+    // Layout-based (all sections visible simultaneously)
+    SectionMode["INLINE"] = "inline";
+    SectionMode["GRID"] = "grid";
+    SectionMode["COLUMNS"] = "columns";
+    // Navigation-based (one section visible at a time)
+    SectionMode["TABS"] = "tabs";
+    SectionMode["VERTICAL_TABS"] = "vertical_tabs";
+    SectionMode["PILLS"] = "pills";
+    // Expandable (toggle section visibility)
+    SectionMode["ACCORDION"] = "accordion";
+    SectionMode["EXPANDABLE"] = "expandable";
+    // Guided (sequential, with indicators)
+    SectionMode["STEPPER"] = "stepper";
+    SectionMode["TIMELINE"] = "timeline";
+})(SectionMode || (SectionMode = {}));
+// =============================================================================
+// OVERLAY CONTAINER MODE - UI Abstraction for Overlay Rendering
+// =============================================================================
+/**
+ * OverlayContainerMode - How overlay containers are rendered.
+ * Controls the presentation style of standalone dismissable containers.
+ *
+ * @category Centered overlays (modal)
+ * - DIALOG: Standard centered modal
+ * - ALERT: Confirmation dialog with action buttons
+ * - COMMAND: Command palette (search-focused)
+ * - LIGHTBOX: Full-screen media viewer with navigation
+ *
+ * @category Side panels (modal)
+ * - SHEET: Side panel (direction via `side` prop)
+ *
+ * @category Mobile-optimized (modal)
+ * - DRAWER: Swipeable drawer with snap points
+ * - ACTION_SHEET: iOS-style action list (bottom)
+ *
+ * @category Non-blocking
+ * - POPOVER: Anchored contextual overlay
+ * - TOAST: Auto-dismiss notification
+ */
+export var OverlayContainerMode;
+(function (OverlayContainerMode) {
+    // Centered overlays (modal)
+    OverlayContainerMode["DIALOG"] = "dialog";
+    OverlayContainerMode["ALERT"] = "alert";
+    OverlayContainerMode["COMMAND"] = "command";
+    OverlayContainerMode["LIGHTBOX"] = "lightbox";
+    // Side panels (modal)
+    OverlayContainerMode["SHEET"] = "sheet";
+    // Mobile-optimized (modal)
+    OverlayContainerMode["DRAWER"] = "drawer";
+    OverlayContainerMode["ACTION_SHEET"] = "action_sheet";
+    // Non-blocking
+    OverlayContainerMode["POPOVER"] = "popover";
+    OverlayContainerMode["TOAST"] = "toast";
+})(OverlayContainerMode || (OverlayContainerMode = {}));
+/**
+ * Layout orientation / display direction (horizontal | vertical)
+ */
+export var DisplayDirection;
+(function (DisplayDirection) {
+    DisplayDirection["HORIZONTAL"] = "horizontal";
+    DisplayDirection["VERTICAL"] = "vertical";
+})(DisplayDirection || (DisplayDirection = {}));
+/**
+ * Horizontal alignment for UI elements (popovers, menus, action bars, etc.)
+ */
+export var HorizontalAlign;
+(function (HorizontalAlign) {
+    HorizontalAlign["START"] = "start";
+    HorizontalAlign["CENTER"] = "center";
+    HorizontalAlign["END"] = "end";
+})(HorizontalAlign || (HorizontalAlign = {}));
+//------------------------------------------------------------------------------------------------
+// BOOLEAN DISPLAY POLICY
+//------------------------------------------------------------------------------------------------
+/**
+ * Labelling values for boolean fields
+ */
+export const BooleanLabellingValue = {
+    YES_NO: 'yes/no',
+    TRUE_FALSE: 'true/false',
+    ON_OFF: 'on/off',
+    ENABLED_DISABLED: 'enabled/disabled',
+    ACTIVE_INACTIVE: 'active/inactive',
+};
+/**
+ * Display mode for boolean fields
+ */
+export const BooleanDisplayMode = {
+    RAW: 'raw',
+    CHECKMARK: 'checkmark',
+    EDIT_LIKE: 'edit_like',
+};
+/**
+ * Edit mode for boolean fields
+ */
+export const BooleanEditMode = {
+    TOGGLE: 'toggle',
+    SWITCH: 'switch',
+    CHECKBOX: 'checkbox',
+    RADIO: 'radio',
+};
+//------------------------------------------------------------------------------------------------
+// STRING DISPLAY POLICY
+//------------------------------------------------------------------------------------------------
+/**
+ * String display modes for rendering string values
+ */
+export const StringDisplayMode = {
+    TEXT: 'text',
+    TRUNCATE: 'truncate',
+    MULTILINE: 'multiline',
+    COLOR: 'color',
+    LINK: 'link',
+    EMAIL: 'email',
+    BADGE: 'badge',
+    COPY: 'copy',
+    SECRET: 'secret',
+};
+/**
+ * String edit modes for form components
+ */
+export const StringEditMode = {
+    INPUT: 'input',
+    TEXTAREA: 'textarea',
+    COLOR: 'color',
+    PASSWORD: 'password',
+    OTP: 'otp',
+};
+//------------------------------------------------------------------------------------------------
+// NUMBER DISPLAY POLICY
+//------------------------------------------------------------------------------------------------
+/**
+ * Number display modes for rendering number values
+ */
+export const NumberDisplayMode = {
+    RAW: 'raw',
+    FORMATTED: 'formatted',
+    PERCENTAGE: 'percentage',
+    COMPACT: 'compact',
+    ORDINAL: 'ordinal',
+    BYTES: 'bytes',
+};
+/**
+ * Number edit modes for form components
+ */
+export const NumberEditMode = {
+    INPUT: 'input',
+    SLIDER: 'slider',
+    STEPPER: 'stepper',
+};
+/**
+ * Scale modes for percentage display.
+ * - NORMALIZED: value is 0–1, Intl.NumberFormat's style:'percent' handles ×100
+ * - PERCENT: value is already 0–100, must be divided by 100 before passing to Intl
+ */
+export const PercentageScale = {
+    NORMALIZED: 'normalized',
+    PERCENT: 'percent',
+};
+//------------------------------------------------------------------------------------------------
+// BIGDECIMAL DISPLAY / EDIT MODES
+//------------------------------------------------------------------------------------------------
+/**
+ * Display mode for BigDecimal fields.
+ * Subset of NumberDisplayMode — COMPACT/ORDINAL/BYTES excluded for arbitrary precision numbers.
+ */
+export const BigDecimalDisplayMode = {
+    RAW: 'raw',
+    FORMATTED: 'formatted',
+    PERCENTAGE: 'percentage',
+};
+/**
+ * Edit mode for BigDecimal fields.
+ * Only INPUT — SLIDER/STEPPER are not applicable for arbitrary precision numbers.
+ */
+export const BigDecimalEditMode = {
+    INPUT: 'input',
+};
+//------------------------------------------------------------------------------------------------
+// ENUM DISPLAY POLICY
+//------------------------------------------------------------------------------------------------
+/**
+ * Enum display modes for rendering enum values
+ */
+export const EnumDisplayMode = {
+    TEXT: 'text',
+    BADGE: 'badge',
+    ICON: 'icon',
+    CARD: 'card',
+};
+/**
+ * Enum edit modes for form components
+ */
+export const EnumEditMode = {
+    SELECT: 'select',
+    RADIO: 'radio',
+    RADIO_ICON_ONLY: 'radio_icon_only',
+    TOGGLE: 'toggle',
+    TOGGLE_ICON_ONLY: 'toggle_icon_only',
+    CARD: 'card',
+    CARD_ICON_ONLY: 'card_icon_only',
+    COMBOBOX: 'combobox',
+};
+/**
+ * Layout direction for form layouts
+ */
+export const LayoutDirection = {
+    HORIZONTAL: 'horizontal',
+    VERTICAL: 'vertical',
+};
+/**
+ * Semantic badge variants for enum display.
+ * These map 1:1 to the Badge component's `variant` prop in presets-components.
+ */
+export const BadgeSemanticVariant = {
+    DEFAULT: 'default',
+    SECONDARY: 'secondary',
+    OUTLINE: 'outline',
+    INFO: 'info',
+    SUCCESS: 'success',
+    WARNING: 'warning',
+    DESTRUCTIVE: 'destructive',
+};
+//------------------------------------------------------------------------------------------------
+// FOREIGN KEY DISPLAY PARAMS
+//------------------------------------------------------------------------------------------------
+/**
+ * Foreign key display mode options
+ * - ID: Show raw FK ID value
+ * - LABEL: Show resolved label via getFrontendResourceLabel
+ * - SUMMARY: Show the referenced resource's summary view (compact card) (default)
+ *
+ * Note: "summary" here is about *FK rendering*, not API data shape (see DataMode.SUMMARY)
+ * or operation bar density (see ResourceOperationDisplayMode.SUMMARY).
+ */
+export const ForeignKeyDisplayMode = {
+    ID: 'id',
+    LABEL: 'label',
+    SUMMARY: 'summary',
+};
+//------------------------------------------------------------------------------------------------
+// RANGE SCHEMA TYPES
+//------------------------------------------------------------------------------------------------
+/**
+ * Supported types for range schemas.
+ */
+export var RangeType;
+(function (RangeType) {
+    RangeType["NUMBER"] = "number";
+    RangeType["DATE"] = "date";
+    RangeType["DATETIME"] = "datetime";
+    RangeType["TIME"] = "time";
+    RangeType["BIGDECIMAL"] = "bigdecimal";
+    RangeType["MONEY"] = "money";
+})(RangeType || (RangeType = {}));
+// Range type for range schemas (matches RangeType from saas-models).
+// Duplicated here to avoid circular dependency.
+export var RangeSchemaType;
+(function (RangeSchemaType) {
+    RangeSchemaType["NUMBER"] = "number";
+    RangeSchemaType["DATE"] = "date";
+    RangeSchemaType["DATETIME"] = "datetime";
+    RangeSchemaType["TIME"] = "time";
+    RangeSchemaType["BIGDECIMAL"] = "bigdecimal";
+    RangeSchemaType["MONEY"] = "money";
+})(RangeSchemaType || (RangeSchemaType = {}));
+// Map range type to its default component.
+export const RangeTypeToComponent = {
+    [RangeSchemaType.NUMBER]: FormFieldComponent.RANGE_SLIDER,
+    [RangeSchemaType.DATE]: FormFieldComponent.DATE_RANGE,
+    [RangeSchemaType.DATETIME]: FormFieldComponent.DATETIME_RANGE,
+    [RangeSchemaType.TIME]: FormFieldComponent.TIME_RANGE,
+    [RangeSchemaType.BIGDECIMAL]: FormFieldComponent.BIGDECIMAL_RANGE,
+    [RangeSchemaType.MONEY]: FormFieldComponent.MONEY_RANGE,
+};
+// Get the default form component for a range type.
+export function getDefaultRangeComponent(rangeType) {
+    return RangeTypeToComponent[rangeType] ?? FormFieldComponent.RANGE_SLIDER;
+}
+//------------------------------------------------------------------------------------------------
+// DURATION SCHEMA TYPES
+//------------------------------------------------------------------------------------------------
+/**
+ * Duration units enum.
+ * Uses string values for JSON serialization and API compatibility.
+ * Aligns with common patterns (e.g., expiresIn: { value, unit }).
+ */
+export var DurationUnit;
+(function (DurationUnit) {
+    DurationUnit["MILLISECONDS"] = "milliseconds";
+    DurationUnit["SECONDS"] = "seconds";
+    DurationUnit["MINUTES"] = "minutes";
+    DurationUnit["HOURS"] = "hours";
+    DurationUnit["DAYS"] = "days";
+    DurationUnit["WEEKS"] = "weeks";
+    DurationUnit["MONTHS"] = "months";
+    DurationUnit["YEARS"] = "years";
+    DurationUnit["CENTURIES"] = "centuries";
+})(DurationUnit || (DurationUnit = {}));
+//------------------------------------------------------------------------------------------------
+// FILE SCHEMA TYPES
+//------------------------------------------------------------------------------------------------
+/**
+ * Common MIME type groups for file uploads.
+ */
+export const FileMimeTypeGroups = {
+    /** Image files: JPEG, PNG, GIF, WebP, SVG, etc. */
+    Images: [
+        'image/jpeg', 'image/png', 'image/gif', 'image/webp', 'image/svg+xml',
+        'image/bmp', 'image/tiff', 'image/x-icon', 'image/heic', 'image/heif'
+    ],
+    /** Video files: MP4, WebM, AVI, MOV, etc. */
+    Video: [
+        'video/mp4', 'video/webm', 'video/ogg', 'video/avi', 'video/quicktime',
+        'video/x-msvideo', 'video/x-ms-wmv', 'video/mpeg', 'video/3gpp'
+    ],
+    /** Audio files: MP3, WAV, OGG, etc. */
+    Audio: [
+        'audio/mpeg', 'audio/wav', 'audio/ogg', 'audio/webm', 'audio/aac',
+        'audio/flac', 'audio/x-m4a', 'audio/mp4'
+    ],
+    /** PDF documents */
+    PDF: ['application/pdf'],
+    /** Office documents: Word, Excel, PowerPoint, etc. */
+    Office: [
+        'application/msword',
+        'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
+        'application/vnd.ms-excel',
+        'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
+        'application/vnd.ms-powerpoint',
+        'application/vnd.openxmlformats-officedocument.presentationml.presentation',
+        'application/vnd.oasis.opendocument.text',
+        'application/vnd.oasis.opendocument.spreadsheet',
+        'application/vnd.oasis.opendocument.presentation'
+    ],
+    /** All documents: PDF + Office */
+    Documents: [
+        'application/pdf',
+        'application/msword',
+        'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
+        'application/vnd.ms-excel',
+        'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
+        'application/vnd.ms-powerpoint',
+        'application/vnd.openxmlformats-officedocument.presentationml.presentation',
+        'application/vnd.oasis.opendocument.text',
+        'application/vnd.oasis.opendocument.spreadsheet',
+        'application/vnd.oasis.opendocument.presentation'
+    ],
+    /** Archives: ZIP, RAR, 7z, etc. */
+    Archives: [
+        'application/zip', 'application/x-zip-compressed',
+        'application/x-rar-compressed', 'application/x-7z-compressed',
+        'application/gzip', 'application/x-tar'
+    ],
+};
+/**
+ * File nature classification for constraint validation and UI display.
+ */
+export var FileNature;
+(function (FileNature) {
+    FileNature["IMAGE"] = "image";
+    FileNature["VIDEO"] = "video";
+    FileNature["AUDIO"] = "audio";
+    FileNature["PDF"] = "pdf";
+    FileNature["OFFICE"] = "office";
+    FileNature["ARCHIVE"] = "archive";
+    FileNature["ALL"] = "all";
+})(FileNature || (FileNature = {}));
+/**
+ * Rendering-level file nature categories.
+ *
+ * Maps the granular `FileNature` schema enum into coarser display categories
+ * used by frontend components to select the appropriate renderer:
+ * - `FileNature.PDF` + `FileNature.OFFICE` → `FileDisplayNature.DOCUMENT`
+ * - `FileNature.ARCHIVE` + `FileNature.ALL` + unknown → `FileDisplayNature.GENERIC`
+ *
+ * Use `resolveFileDisplayNature()` from `zod-file.ts` to resolve from
+ * schema metadata and/or MIME type.
+ */
+export var FileDisplayNature;
+(function (FileDisplayNature) {
+    FileDisplayNature["IMAGE"] = "image";
+    FileDisplayNature["VIDEO"] = "video";
+    FileDisplayNature["AUDIO"] = "audio";
+    FileDisplayNature["DOCUMENT"] = "document";
+    FileDisplayNature["GENERIC"] = "generic";
+})(FileDisplayNature || (FileDisplayNature = {}));
+/**
+ * Storage providers accepted for file uploads.
+ */
+export var FileStorageAccepted;
+(function (FileStorageAccepted) {
+    FileStorageAccepted["WILDO_MANAGED"] = "wildo_managed";
+    FileStorageAccepted["LOCAL_DIRECTORY"] = "local_directory";
+    FileStorageAccepted["ONEDRIVE"] = "onedrive";
+    FileStorageAccepted["GOOGLE_DRIVE"] = "google_drive";
+    FileStorageAccepted["DROPBOX"] = "dropbox";
+})(FileStorageAccepted || (FileStorageAccepted = {}));
+export var FileUploaderEntityType;
+(function (FileUploaderEntityType) {
+    FileUploaderEntityType["USER"] = "user";
+    FileUploaderEntityType["ANONYMOUS_USER"] = "anonymous_user";
+    FileUploaderEntityType["ORGANIZATION_API_KEY"] = "organization_api_key";
+    FileUploaderEntityType["APPLICATION_API_KEY"] = "application_api_key";
+})(FileUploaderEntityType || (FileUploaderEntityType = {}));
+/**
+ * Image format options for file validation.
+ */
+export const ImageFormat = {
+    JPEG: 'jpeg',
+    PNG: 'png',
+    GIF: 'gif',
+    WEBP: 'webp',
+    SVG: 'svg',
+};
+/**
+ * Video format options for file validation.
+ */
+export const VideoFormat = {
+    MP4: 'mp4',
+    WEBM: 'webm',
+    MOV: 'mov',
+};
+/**
+ * Audio format options for file validation.
+ */
+export const AudioFormat = {
+    MP3: 'mp3',
+    WAV: 'wav',
+    OGG: 'ogg',
+    AAC: 'aac',
+};
+/**
+ * RAG chunking strategy options for file content indexing.
+ */
+export const RAGChunkingStrategy = {
+    FIXED_SIZE: 'fixed_size',
+    RECURSIVE: 'recursive',
+    SEMANTIC: 'semantic',
+    MARKDOWN: 'markdown',
+};
+/**
+ * File behavior when parent resource is deleted.
+ * - CASCADE: Mark the file deleted as part of parent removal; physical storage cleanup is deferred to the cleanup batch
+ * - SOFT_DELETE: Same current runtime behavior as CASCADE, but keeps an explicit semantic marker for consumers that want to model softer intent
+ * - ORPHAN: Keep file, remove association with parent
+ */
+export const FileOnParentDelete = {
+    CASCADE: 'cascade',
+    SOFT_DELETE: 'soft-delete',
+    ORPHAN: 'orphan',
+};
+// HiddenFieldParams, NotEditableFieldParams
+// are imported from @wildo-ai/presets-components-models
+/**
+ * Inline edit mode options
+ */
+export const InlineEditMode = {
+    DIRECT: 'direct',
+    BUTTON: 'button',
+};
+/**
+ * P10: When to trigger save in inline editing mode
+ */
+export const InlineEditSaveOn = {
+    /** Save on blur (when user clicks away) */
+    BLUR: 'blur',
+    /** Save only on explicit button click */
+    EXPLICIT: 'explicit',
+};
+//------------------------------------------------------------------------------------------------
+// UNIQUE FIELD PARAMS
+//------------------------------------------------------------------------------------------------
+/**
+ * Scope for unique constraint enforcement.
+ * - 'global': Unique across the entire collection (default)
+ * - 'organization': Unique within an organization (compound index with organizationId)
+ * - 'user': Unique per user (compound index with createdByUserId)
+ */
+export const UniqueScope = {
+    GLOBAL: 'global',
+    ORGANIZATION: 'organization',
+    USER: 'user',
+};
+//------------------------------------------------------------------------------------------------
+// FORM VALIDATION DECORATOR PARAMS
+//------------------------------------------------------------------------------------------------
+/**
+ * Validation mode for form fields.
+ * Configures when field validation is triggered.
+ * - ON_CHANGE: Validate on every change (with debounce for text fields)
+ * - ON_BLUR: Validate when field loses focus (default for text fields)
+ * - ON_TOUCHED: Validate on blur initially, then on every change once touched
+ * - ON_SUBMIT: Validate only on form submission
+ */
+export var ValidationMode;
+(function (ValidationMode) {
+    ValidationMode["ON_CHANGE"] = "onChange";
+    ValidationMode["ON_BLUR"] = "onBlur";
+    ValidationMode["ON_TOUCHED"] = "onTouched";
+    ValidationMode["ON_SUBMIT"] = "onSubmit";
+})(ValidationMode || (ValidationMode = {}));
+/**
+ * Trigger mechanism for autosave.
+ * - DEBOUNCE: Save after a delay following the last change
+ * - BLUR: Save when field loses focus
+ * - NONE: Disable autosave for this field
+ */
+export var AutosaveTrigger;
+(function (AutosaveTrigger) {
+    AutosaveTrigger["DEBOUNCE"] = "debounce";
+    AutosaveTrigger["BLUR"] = "blur";
+    AutosaveTrigger["NONE"] = "none";
+})(AutosaveTrigger || (AutosaveTrigger = {}));
+// ==========================================================================================================================================================
+// SHOW WHEN TYPES (FIX-P5-H1)
+// ==========================================================================================================================================================
+/**
+ * FIX-P5-H1: Operator for showWhen condition comparison.
+ * - EQUALS: Field value equals the specified value
+ * - NOT_EQUALS: Field value does not equal the specified value
+ * - IN: Field value is in the specified array
+ * - NOT_IN: Field value is not in the specified array
+ * - EXISTS: Field value exists (is defined and not null)
+ * - NOT_EXISTS: Field value does not exist (undefined or null)
+ */
+export var ShowWhenOperator;
+(function (ShowWhenOperator) {
+    ShowWhenOperator["EQUALS"] = "equals";
+    ShowWhenOperator["NOT_EQUALS"] = "notEquals";
+    ShowWhenOperator["IN"] = "in";
+    ShowWhenOperator["NOT_IN"] = "notIn";
+    ShowWhenOperator["EXISTS"] = "exists";
+    ShowWhenOperator["NOT_EXISTS"] = "notExists";
+})(ShowWhenOperator || (ShowWhenOperator = {}));
+// ==========================================================================================================================================================
+// ZOD DECORATOR TYPES
+// ==========================================================================================================================================================
+export var ZodDecorator;
+(function (ZodDecorator) {
+    ZodDecorator["IS_DB_INDEXED"] = "isDBIndexed";
+    ZodDecorator["IS_FOREIGN_KEY"] = "isForeignKey";
+    ZodDecorator["IS_HIDDEN"] = "isHidden";
+    ZodDecorator["IS_NOT_EDITABLE"] = "isNotEditable";
+    // New decorators for resource derived objects rationalization
+    ZodDecorator["IS_SUMMARY_FIELD"] = "isSummaryField";
+    ZodDecorator["IS_BACKEND_ONLY"] = "isBackendOnly";
+    ZodDecorator["IS_VIRTUAL"] = "isVirtual";
+    ZodDecorator["IS_DISCRIMINATOR"] = "isDiscriminator";
+    ZodDecorator["EXCLUDE_FROM_CREATE"] = "excludeFromCreate";
+    ZodDecorator["EXCLUDE_FROM_UPDATE"] = "excludeFromUpdate";
+    // Database constraint decorators
+    ZodDecorator["IS_UNIQUE"] = "isUnique";
+    ZodDecorator["IS_PRIMARY_KEY"] = "isPrimaryKey";
+    ZodDecorator["TTL"] = "ttl";
+    // String edit mode convenience decorators (shorthand for STRING_UI with specific editMode)
+    ZodDecorator["IS_PASSWORD"] = "isPassword";
+    ZodDecorator["IS_OTP"] = "isOtp";
+    ZodDecorator["IS_COLOR"] = "isColor";
+    // Form validation decorators
+    ZodDecorator["IS_DRAFT_RELAXED"] = "isDraftRelaxed";
+    // FIX-P5-H1: Conditional visibility decorator
+    ZodDecorator["SHOW_WHEN"] = "showWhen";
+    // System enum decorator - marks an enum field as using a system-level enum (currency, language, country, etc.)
+    ZodDecorator["SYSTEM_ENUM"] = "systemEnum";
+    // Ephemeral field decorator - marks a field as transient response-only data (shown once, then gone)
+    ZodDecorator["IS_EPHEMERAL"] = "isEphemeral";
+    // CRDT field decorator - marks a field for future field-level LWW merge (Phase 3C)
+    ZodDecorator["IS_CRDT"] = "isCRDT";
+    // Unified {primitive}UI decorators — new API replacing display policy + formField decomposition
+    ZodDecorator["BOOLEAN_UI"] = "booleanUI";
+    ZodDecorator["STRING_UI"] = "stringUI";
+    ZodDecorator["NUMBER_UI"] = "numberUI";
+    ZodDecorator["ENUM_UI"] = "enumUI";
+    ZodDecorator["DATE_UI"] = "dateUI";
+    ZodDecorator["DATETIME_UI"] = "dateTimeUI";
+    ZodDecorator["TIME_UI"] = "timeUI";
+    ZodDecorator["MONEY_UI"] = "moneyUI";
+    ZodDecorator["CODE_UI"] = "codeUI";
+    ZodDecorator["FILE_UI"] = "fileUI";
+    ZodDecorator["DURATION_UI"] = "durationUI";
+    ZodDecorator["PHONE_UI"] = "phoneUI";
+    ZodDecorator["BIGDECIMAL_UI"] = "bigDecimalUI";
+    ZodDecorator["FOREIGN_KEY_UI"] = "foreignKeyUI";
+    ZodDecorator["ARRAY_UI"] = "arrayUI";
+    ZodDecorator["OBJECT_UI"] = "objectUI";
+})(ZodDecorator || (ZodDecorator = {}));
+//# sourceMappingURL=zod-decorators.types.js.map