@wildo-ai/zod-decorators 1.0.0

package/dist/esm/zod-decorators.types.d.ts

@@ -0,0 +1,2207 @@
+import type { ComponentType } from 'react';
+import { ViewportBreakpoint } from './commons.js';
+import { AvailableCurrency, CurrencyAllowed } from './currencies.shared.schemas.js';
+import { z } from 'zod';
+import { DecoratedPrimitiveZodType } from './zod.module-override.js';
+import { ZodBrandedColorInstance } from './zod-color.js';
+export declare const SCHEMA_METADATA: symbol;
+export declare enum FieldSchemaType {
+    STRING = "string",// String schemas (z.string)
+    NUMBER = "number",// Number schemas (z.number, z.int)
+    BIGINT = "bigint",// BigInt schemas (z.bigint)
+    BOOLEAN = "boolean",// Boolean schemas (z.boolean)
+    ENUM = "enum",// Enum schemas (z.enum, z.enum)
+    DATE = "date",// Date schemas (z.date)
+    OBJECT = "object",// Object schemas (z.object) - NOT range schemas
+    ARRAY = "array",// Array schemas (z.array)
+    SET = "set",// Set schemas (z.set) - stored as array
+    TUPLE = "tuple",// Tuple schemas (z.tuple)
+    RECORD = "record",// Record schemas (z.record)
+    MAP = "map",// Map schemas (z.map)
+    TIME = "time",// Time schemas (z.time)
+    DATETIME = "datetime",// Datetime schemas (z.datetime)
+    RANGE_NUMBER = "range_number",// Range number schemas created by z_range('number')
+    RANGE_DATE = "range_date",// Range date schemas created by z_range('date')
+    RANGE_DATETIME = "range_datetime",// Range datetime schemas created by z_range('datetime')
+    RANGE_TIME = "range_time",// Range time schemas created by z_range('time')
+    RANGE_BIGDECIMAL = "range_bigdecimal",// Range bigdecimal schemas created by z_range('bigdecimal')
+    RANGE_MONEY = "range_money",// Range money schemas created by z_range('money')
+    MONEY = "money",// Money schemas created by z_money() - detected by SCHEMA_METADATA.moneyConfig
+    BIGDECIMAL = "bigdecimal",// BigDecimal schemas created by z_bigdecimal() - detected by SCHEMA_METADATA.bigDecimalConfig
+    CODE = "code",// Code schemas created by z_code() - detected by SCHEMA_METADATA.codeConfig
+    FILE = "file",// File schemas created by z_file() - detected by SCHEMA_METADATA.fileConfig
+    DURATION = "duration",// Duration schemas created by z_duration() - detected by SCHEMA_METADATA.durationConfig
+    PHONE = "phone",// Phone schemas created by z_phone() - detected by SCHEMA_METADATA.phoneConfig
+    VERSIONED_FOREIGN_KEY = "versioned_foreign_key",// Versioned foreign key schemas created by z_foreignKeyVersioned() - detected by SCHEMA_METADATA.versionedForeignKeyConfig
+    VERSIONED_OBJECT = "versioned_object",// Versioned object schemas created by versioned() - detected by SCHEMA_METADATA.versionedConfig
+    UNKNOWN = "unknown"
+}
+export declare enum FormFieldComponent {
+    INPUT = "input",// Standard text input
+    TEXTAREA = "textarea",// Multi-line text area
+    SELECT = "select",// Dropdown select
+    RADIO_GROUP = "radio-group",// Radio button group
+    CHECKBOX = "checkbox",// Single checkbox
+    CHECKBOX_GROUP = "checkbox-group",// Checkbox group for multi-select (arrays of enums)
+    SWITCH = "switch",// Toggle switch
+    SLIDER = "slider",// Single value slider
+    DATE = "date",// Date picker (single date)
+    TIME = "time",// Time picker (single time)
+    DATETIME = "datetime",// DateTime picker (date + time)
+    RANGE_SLIDER = "range-slider",// Number range slider (two thumbs for min/max)
+    DATE_RANGE = "date-range",// Date range picker (from/to dates)
+    DATETIME_RANGE = "datetime-range",// DateTime range picker (from/to datetime)
+    TIME_RANGE = "time-range",// Time range picker (from/to time)
+    BIGDECIMAL_RANGE = "bigdecimal-range",// BigDecimal range input (from/to bigdecimal)
+    MONEY_RANGE = "money-range",// Money range input (from/to money)
+    DURATION = "duration",// Duration input (value + unit selector)
+    PHONE = "phone"
+}
+/**
+ * Chrome layout mode for display context (detail/read-only views).
+ * Controls how the field wrapper (label, value, description) is arranged.
+ */
+export declare const DisplayChromeMode: {
+    /** Label above, value below, description below value (default). */
+    readonly STACKED: "stacked";
+    /** Label and value on the same line. */
+    readonly INLINE: "inline";
+    /** No label/description, just value (dense mode). */
+    readonly COMPACT: "compact";
+    /** No chrome at all — bare value output. */
+    readonly HIDDEN: "hidden";
+};
+export type DisplayChromeMode = typeof DisplayChromeMode[keyof typeof DisplayChromeMode];
+/**
+ * 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 declare const EditChromeMode: {
+    /** Label above, control below, description + error below control (default). */
+    readonly STACKED: "stacked";
+    /** Label + description left, control + error right (settings page style). */
+    readonly SETTINGS_ROW: "settings_row";
+    /** Control left, label + description right (switch/checkbox style). */
+    readonly INLINE: "inline";
+    /** Generous spacing, heading-size label (onboarding, OTP, wizard). */
+    readonly RELAXED: "relaxed";
+    /** No label/description, just control + error (dense mode). */
+    readonly COMPACT: "compact";
+    /** No chrome at all — bare control output. */
+    readonly HIDDEN: "hidden";
+};
+export type EditChromeMode = typeof EditChromeMode[keyof typeof EditChromeMode];
+/** @deprecated Use `EditChromeMode` directly. Kept as alias for backward compatibility. */
+export declare const FormFieldChromeMode: {
+    /** Label above, control below, description + error below control (default). */
+    readonly STACKED: "stacked";
+    /** Label + description left, control + error right (settings page style). */
+    readonly SETTINGS_ROW: "settings_row";
+    /** Control left, label + description right (switch/checkbox style). */
+    readonly INLINE: "inline";
+    /** Generous spacing, heading-size label (onboarding, OTP, wizard). */
+    readonly RELAXED: "relaxed";
+    /** No label/description, just control + error (dense mode). */
+    readonly COMPACT: "compact";
+    /** No chrome at all — bare control output. */
+    readonly HIDDEN: "hidden";
+};
+/** @deprecated Use `EditChromeMode` directly. */
+export type FormFieldChromeMode = EditChromeMode;
+/**
+ * Responsive chrome mode — either a single mode or per-breakpoint mapping.
+ * When a breakpoint mapping is provided, FormFieldChrome resolves the effective
+ * mode at runtime using useUI().
+ */
+export type ResponsiveChromeMode = EditChromeMode | Partial<Record<ViewportBreakpoint, EditChromeMode>>;
+/**
+ * Responsive-aware value: either a single value or per-breakpoint overrides.
+ * Used for chromeMode, forceHide, and other properties that may vary by viewport.
+ */
+export type ResponsiveAware<T> = T | Partial<Record<ViewportBreakpoint, T>>;
+export type FormFieldSchemaTypeComponents = {
+    [K in FieldSchemaType]: K extends FieldSchemaType.STRING ? FormFieldComponent.INPUT | FormFieldComponent.TEXTAREA | FormFieldComponent.SELECT | FormFieldComponent.RADIO_GROUP | FormFieldComponent.DATE | FormFieldComponent.TIME | FormFieldComponent.DATETIME : K extends FieldSchemaType.NUMBER ? FormFieldComponent.INPUT | FormFieldComponent.SLIDER | FormFieldComponent.SELECT | FormFieldComponent.RADIO_GROUP : K extends FieldSchemaType.BIGINT ? FormFieldComponent.INPUT : K extends FieldSchemaType.BOOLEAN ? FormFieldComponent.SWITCH | FormFieldComponent.CHECKBOX | FormFieldComponent.SELECT | FormFieldComponent.RADIO_GROUP : K extends FieldSchemaType.ENUM ? FormFieldComponent.SELECT | FormFieldComponent.RADIO_GROUP : K extends FieldSchemaType.DATE ? FormFieldComponent.DATE | FormFieldComponent.DATETIME | FormFieldComponent.INPUT : K extends FieldSchemaType.TIME ? FormFieldComponent.TIME | FormFieldComponent.INPUT : K extends FieldSchemaType.DATETIME ? FormFieldComponent.DATETIME | FormFieldComponent.INPUT : K extends FieldSchemaType.RANGE_NUMBER ? FormFieldComponent.RANGE_SLIDER : K extends FieldSchemaType.RANGE_DATE ? FormFieldComponent.DATE_RANGE : K extends FieldSchemaType.RANGE_DATETIME ? FormFieldComponent.DATETIME_RANGE : K extends FieldSchemaType.RANGE_TIME ? FormFieldComponent.TIME_RANGE : K extends FieldSchemaType.RANGE_BIGDECIMAL ? FormFieldComponent.BIGDECIMAL_RANGE : K extends FieldSchemaType.RANGE_MONEY ? FormFieldComponent.MONEY_RANGE : K extends FieldSchemaType.MONEY ? FormFieldComponent.INPUT : K extends FieldSchemaType.DURATION ? FormFieldComponent.DURATION : K extends FieldSchemaType.PHONE ? FormFieldComponent.PHONE : K extends FieldSchemaType.BIGDECIMAL ? FormFieldComponent.INPUT : K extends FieldSchemaType.CODE ? FormFieldComponent.TEXTAREA : K extends FieldSchemaType.FILE ? FormFieldComponent.INPUT : K extends FieldSchemaType.ARRAY ? FormFieldComponent.CHECKBOX_GROUP | FormFieldComponent.SELECT : K extends FieldSchemaType.SET ? FormFieldComponent.INPUT | FormFieldComponent.CHECKBOX_GROUP | FormFieldComponent.SELECT : K extends FieldSchemaType.TUPLE ? FormFieldComponent.INPUT : K extends FieldSchemaType.UNKNOWN ? FormFieldComponent.INPUT : never;
+};
+export type FormComponentForSchemaType<T extends FieldSchemaType> = FormFieldSchemaTypeComponents[T];
+export type FormFieldSchemaTypeDefaultComponent = {
+    [K in FieldSchemaType]: K extends FieldSchemaType.STRING ? FormFieldComponent.INPUT : K extends FieldSchemaType.NUMBER ? FormFieldComponent.INPUT : K extends FieldSchemaType.BIGINT ? FormFieldComponent.INPUT : K extends FieldSchemaType.BOOLEAN ? FormFieldComponent.SWITCH : K extends FieldSchemaType.ENUM ? FormFieldComponent.SELECT : K extends FieldSchemaType.DATE ? FormFieldComponent.DATE : K extends FieldSchemaType.TIME ? FormFieldComponent.TIME : K extends FieldSchemaType.DATETIME ? FormFieldComponent.DATETIME : K extends FieldSchemaType.RANGE_NUMBER ? FormFieldComponent.RANGE_SLIDER : K extends FieldSchemaType.RANGE_DATE ? FormFieldComponent.DATE_RANGE : K extends FieldSchemaType.RANGE_DATETIME ? FormFieldComponent.DATETIME_RANGE : K extends FieldSchemaType.RANGE_TIME ? FormFieldComponent.TIME_RANGE : K extends FieldSchemaType.RANGE_BIGDECIMAL ? FormFieldComponent.BIGDECIMAL_RANGE : K extends FieldSchemaType.RANGE_MONEY ? FormFieldComponent.MONEY_RANGE : K extends FieldSchemaType.MONEY ? FormFieldComponent.INPUT : K extends FieldSchemaType.DURATION ? FormFieldComponent.DURATION : K extends FieldSchemaType.PHONE ? FormFieldComponent.PHONE : K extends FieldSchemaType.BIGDECIMAL ? FormFieldComponent.INPUT : K extends FieldSchemaType.CODE ? FormFieldComponent.TEXTAREA : K extends FieldSchemaType.FILE ? FormFieldComponent.INPUT : FormFieldComponent.INPUT;
+};
+export type DefaultFormComponentForSchemaType<T extends FieldSchemaType> = FormFieldSchemaTypeDefaultComponent[T];
+export type DecoratorConfig<T extends ZodDecorator> = {
+    ref: T;
+    params: ZodDecorator_ParamsType[T];
+};
+export type DecoratorInput<T extends ZodDecorator = ZodDecorator> = T | DecoratorConfig<T>;
+export declare enum DisplayFieldComponent {
+    SIMPLE_TEXT = "simple-text",
+    STRING = "string",
+    NUMBER = "number",
+    BOOLEAN = "boolean",
+    ENUM = "enum",
+    DATE = "date",
+    TIME = "time",
+    DATETIME = "datetime",
+    CODE = "code",
+    FILE = "file",
+    MONEY = "money",
+    BIGDECIMAL = "bigdecimal",
+    DURATION = "duration",
+    PHONE = "phone",
+    RANGE_NUMBER = "range-number",
+    RANGE_DATE = "range-date",
+    RANGE_TIME = "range-time",
+    RANGE_DATETIME = "range-datetime",
+    RANGE_BIGDECIMAL = "range-bigdecimal",
+    RANGE_MONEY = "range-money"
+}
+export type DisplayFieldSchemaTypeComponents = {
+    [K in FieldSchemaType]: K extends FieldSchemaType.STRING ? DisplayFieldComponent.STRING | DisplayFieldComponent.SIMPLE_TEXT : K extends FieldSchemaType.NUMBER ? DisplayFieldComponent.NUMBER | DisplayFieldComponent.SIMPLE_TEXT : K extends FieldSchemaType.BIGINT ? DisplayFieldComponent.NUMBER | DisplayFieldComponent.SIMPLE_TEXT : K extends FieldSchemaType.BOOLEAN ? DisplayFieldComponent.BOOLEAN | DisplayFieldComponent.SIMPLE_TEXT : K extends FieldSchemaType.ENUM ? DisplayFieldComponent.ENUM | DisplayFieldComponent.SIMPLE_TEXT : K extends FieldSchemaType.DATE ? DisplayFieldComponent.DATE | DisplayFieldComponent.SIMPLE_TEXT : K extends FieldSchemaType.TIME ? DisplayFieldComponent.TIME | DisplayFieldComponent.SIMPLE_TEXT : K extends FieldSchemaType.DATETIME ? DisplayFieldComponent.DATETIME | DisplayFieldComponent.SIMPLE_TEXT : K extends FieldSchemaType.OBJECT ? DisplayFieldComponent.SIMPLE_TEXT : K extends FieldSchemaType.ARRAY ? DisplayFieldComponent.SIMPLE_TEXT : K extends FieldSchemaType.RECORD ? DisplayFieldComponent.SIMPLE_TEXT : K extends FieldSchemaType.MAP ? DisplayFieldComponent.SIMPLE_TEXT : K extends FieldSchemaType.RANGE_NUMBER ? DisplayFieldComponent.RANGE_NUMBER | DisplayFieldComponent.SIMPLE_TEXT : K extends FieldSchemaType.RANGE_DATE ? DisplayFieldComponent.RANGE_DATE | DisplayFieldComponent.SIMPLE_TEXT : K extends FieldSchemaType.RANGE_TIME ? DisplayFieldComponent.RANGE_TIME | DisplayFieldComponent.SIMPLE_TEXT : K extends FieldSchemaType.RANGE_DATETIME ? DisplayFieldComponent.RANGE_DATETIME | DisplayFieldComponent.SIMPLE_TEXT : K extends FieldSchemaType.RANGE_BIGDECIMAL ? DisplayFieldComponent.RANGE_BIGDECIMAL | DisplayFieldComponent.SIMPLE_TEXT : K extends FieldSchemaType.RANGE_MONEY ? DisplayFieldComponent.RANGE_MONEY | DisplayFieldComponent.SIMPLE_TEXT : K extends FieldSchemaType.MONEY ? DisplayFieldComponent.MONEY | DisplayFieldComponent.SIMPLE_TEXT : K extends FieldSchemaType.DURATION ? DisplayFieldComponent.DURATION | DisplayFieldComponent.SIMPLE_TEXT : K extends FieldSchemaType.PHONE ? DisplayFieldComponent.PHONE | DisplayFieldComponent.SIMPLE_TEXT : K extends FieldSchemaType.BIGDECIMAL ? DisplayFieldComponent.BIGDECIMAL | DisplayFieldComponent.SIMPLE_TEXT : K extends FieldSchemaType.CODE ? DisplayFieldComponent.CODE | DisplayFieldComponent.SIMPLE_TEXT : K extends FieldSchemaType.FILE ? DisplayFieldComponent.FILE | DisplayFieldComponent.SIMPLE_TEXT : K extends FieldSchemaType.SET ? DisplayFieldComponent.SIMPLE_TEXT : K extends FieldSchemaType.TUPLE ? DisplayFieldComponent.SIMPLE_TEXT : K extends FieldSchemaType.VERSIONED_FOREIGN_KEY ? DisplayFieldComponent.SIMPLE_TEXT : K extends FieldSchemaType.VERSIONED_OBJECT ? DisplayFieldComponent.SIMPLE_TEXT : K extends FieldSchemaType.UNKNOWN ? DisplayFieldComponent.SIMPLE_TEXT : never;
+};
+export type DisplayComponentForSchemaType<T extends FieldSchemaType> = DisplayFieldSchemaTypeComponents[T];
+export type DisplayFieldSchemaTypeDefaultComponent = {
+    [K in FieldSchemaType]: K extends FieldSchemaType.STRING ? DisplayFieldComponent.STRING : K extends FieldSchemaType.NUMBER ? DisplayFieldComponent.NUMBER : K extends FieldSchemaType.BIGINT ? DisplayFieldComponent.NUMBER : K extends FieldSchemaType.BOOLEAN ? DisplayFieldComponent.BOOLEAN : K extends FieldSchemaType.ENUM ? DisplayFieldComponent.ENUM : K extends FieldSchemaType.DATE ? DisplayFieldComponent.DATE : K extends FieldSchemaType.TIME ? DisplayFieldComponent.TIME : K extends FieldSchemaType.DATETIME ? DisplayFieldComponent.DATETIME : K extends FieldSchemaType.OBJECT ? DisplayFieldComponent.SIMPLE_TEXT : K extends FieldSchemaType.ARRAY ? DisplayFieldComponent.SIMPLE_TEXT : K extends FieldSchemaType.RECORD ? DisplayFieldComponent.SIMPLE_TEXT : K extends FieldSchemaType.MAP ? DisplayFieldComponent.SIMPLE_TEXT : K extends FieldSchemaType.RANGE_NUMBER ? DisplayFieldComponent.RANGE_NUMBER : K extends FieldSchemaType.RANGE_DATE ? DisplayFieldComponent.RANGE_DATE : K extends FieldSchemaType.RANGE_TIME ? DisplayFieldComponent.RANGE_TIME : K extends FieldSchemaType.RANGE_DATETIME ? DisplayFieldComponent.RANGE_DATETIME : K extends FieldSchemaType.RANGE_BIGDECIMAL ? DisplayFieldComponent.RANGE_BIGDECIMAL : K extends FieldSchemaType.RANGE_MONEY ? DisplayFieldComponent.RANGE_MONEY : K extends FieldSchemaType.MONEY ? DisplayFieldComponent.MONEY : K extends FieldSchemaType.DURATION ? DisplayFieldComponent.DURATION : K extends FieldSchemaType.PHONE ? DisplayFieldComponent.PHONE : K extends FieldSchemaType.BIGDECIMAL ? DisplayFieldComponent.BIGDECIMAL : K extends FieldSchemaType.CODE ? DisplayFieldComponent.CODE : K extends FieldSchemaType.FILE ? DisplayFieldComponent.FILE : K extends FieldSchemaType.SET ? DisplayFieldComponent.SIMPLE_TEXT : K extends FieldSchemaType.TUPLE ? DisplayFieldComponent.SIMPLE_TEXT : K extends FieldSchemaType.VERSIONED_FOREIGN_KEY ? DisplayFieldComponent.SIMPLE_TEXT : K extends FieldSchemaType.VERSIONED_OBJECT ? DisplayFieldComponent.SIMPLE_TEXT : DisplayFieldComponent.SIMPLE_TEXT;
+};
+export type DefaultDisplayComponentForSchemaType<T extends FieldSchemaType> = DisplayFieldSchemaTypeDefaultComponent[T];
+/**
+ * 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 declare enum SectionMode {
+    DEFAULT = "default",
+    CARD = "card",
+    GHOST = "ghost",
+    COLLAPSIBLE = "collapsible",
+    INLINE = "inline",
+    GRID = "grid",
+    COLUMNS = "columns",
+    TABS = "tabs",
+    VERTICAL_TABS = "vertical_tabs",
+    PILLS = "pills",
+    ACCORDION = "accordion",
+    EXPANDABLE = "expandable",
+    STEPPER = "stepper",
+    TIMELINE = "timeline"
+}
+/** Solo modes — render in place, no grouping. Valid on `<Section appearance>`. */
+export type SoloSectionMode = SectionMode.DEFAULT | SectionMode.CARD | SectionMode.GHOST | SectionMode.COLLAPSIBLE;
+/** Container modes — sections sharing the same mode are grouped into one container. */
+export type ContainerSectionMode = Exclude<SectionMode, SoloSectionMode>;
+/**
+ * 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 declare enum OverlayContainerMode {
+    DIALOG = "dialog",
+    ALERT = "alert",
+    COMMAND = "command",
+    LIGHTBOX = "lightbox",
+    SHEET = "sheet",
+    DRAWER = "drawer",
+    ACTION_SHEET = "action_sheet",
+    POPOVER = "popover",
+    TOAST = "toast"
+}
+/**
+ * Layout orientation / display direction (horizontal | vertical)
+ */
+export declare enum DisplayDirection {
+    HORIZONTAL = "horizontal",
+    VERTICAL = "vertical"
+}
+/**
+ * Horizontal alignment for UI elements (popovers, menus, action bars, etc.)
+ */
+export declare enum HorizontalAlign {
+    START = "start",
+    CENTER = "center",
+    END = "end"
+}
+/**
+ * Labelling values for boolean fields
+ */
+export declare const BooleanLabellingValue: {
+    readonly YES_NO: "yes/no";
+    readonly TRUE_FALSE: "true/false";
+    readonly ON_OFF: "on/off";
+    readonly ENABLED_DISABLED: "enabled/disabled";
+    readonly ACTIVE_INACTIVE: "active/inactive";
+};
+export type BooleanLabellingValue = typeof BooleanLabellingValue[keyof typeof BooleanLabellingValue];
+/**
+ * Display mode for boolean fields
+ */
+export declare const BooleanDisplayMode: {
+    readonly RAW: "raw";
+    readonly CHECKMARK: "checkmark";
+    readonly EDIT_LIKE: "edit_like";
+};
+export type BooleanDisplayMode = typeof BooleanDisplayMode[keyof typeof BooleanDisplayMode];
+/**
+ * Edit mode for boolean fields
+ */
+export declare const BooleanEditMode: {
+    readonly TOGGLE: "toggle";
+    readonly SWITCH: "switch";
+    readonly CHECKBOX: "checkbox";
+    readonly RADIO: "radio";
+};
+export type BooleanEditMode = typeof BooleanEditMode[keyof typeof BooleanEditMode];
+/**
+ * String display modes for rendering string values
+ */
+export declare const StringDisplayMode: {
+    readonly TEXT: "text";
+    readonly TRUNCATE: "truncate";
+    readonly MULTILINE: "multiline";
+    readonly COLOR: "color";
+    readonly LINK: "link";
+    readonly EMAIL: "email";
+    readonly BADGE: "badge";
+    readonly COPY: "copy";
+    readonly SECRET: "secret";
+};
+export type StringDisplayMode = typeof StringDisplayMode[keyof typeof StringDisplayMode];
+/**
+ * String edit modes for form components
+ */
+export declare const StringEditMode: {
+    readonly INPUT: "input";
+    readonly TEXTAREA: "textarea";
+    readonly COLOR: "color";
+    readonly PASSWORD: "password";
+    readonly OTP: "otp";
+};
+export type StringEditMode = typeof StringEditMode[keyof typeof StringEditMode];
+/**
+ * Number display modes for rendering number values
+ */
+export declare const NumberDisplayMode: {
+    readonly RAW: "raw";
+    readonly FORMATTED: "formatted";
+    readonly PERCENTAGE: "percentage";
+    readonly COMPACT: "compact";
+    readonly ORDINAL: "ordinal";
+    readonly BYTES: "bytes";
+};
+export type NumberDisplayMode = typeof NumberDisplayMode[keyof typeof NumberDisplayMode];
+/**
+ * Number edit modes for form components
+ */
+export declare const NumberEditMode: {
+    readonly INPUT: "input";
+    readonly SLIDER: "slider";
+    readonly STEPPER: "stepper";
+};
+export type NumberEditMode = typeof NumberEditMode[keyof typeof NumberEditMode];
+/**
+ * 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 declare const PercentageScale: {
+    readonly NORMALIZED: "normalized";
+    readonly PERCENT: "percent";
+};
+export type PercentageScale = typeof PercentageScale[keyof typeof PercentageScale];
+/**
+ * Display mode for BigDecimal fields.
+ * Subset of NumberDisplayMode — COMPACT/ORDINAL/BYTES excluded for arbitrary precision numbers.
+ */
+export declare const BigDecimalDisplayMode: {
+    readonly RAW: "raw";
+    readonly FORMATTED: "formatted";
+    readonly PERCENTAGE: "percentage";
+};
+export type BigDecimalDisplayMode = typeof BigDecimalDisplayMode[keyof typeof BigDecimalDisplayMode];
+/**
+ * Edit mode for BigDecimal fields.
+ * Only INPUT — SLIDER/STEPPER are not applicable for arbitrary precision numbers.
+ */
+export declare const BigDecimalEditMode: {
+    readonly INPUT: "input";
+};
+export type BigDecimalEditMode = typeof BigDecimalEditMode[keyof typeof BigDecimalEditMode];
+/**
+ * Enum display modes for rendering enum values
+ */
+export declare const EnumDisplayMode: {
+    readonly TEXT: "text";
+    readonly BADGE: "badge";
+    readonly ICON: "icon";
+    readonly CARD: "card";
+};
+export type EnumDisplayMode = typeof EnumDisplayMode[keyof typeof EnumDisplayMode];
+/**
+ * Enum edit modes for form components
+ */
+export declare const EnumEditMode: {
+    readonly SELECT: "select";
+    readonly RADIO: "radio";
+    readonly RADIO_ICON_ONLY: "radio_icon_only";
+    readonly TOGGLE: "toggle";
+    readonly TOGGLE_ICON_ONLY: "toggle_icon_only";
+    readonly CARD: "card";
+    readonly CARD_ICON_ONLY: "card_icon_only";
+    readonly COMBOBOX: "combobox";
+};
+export type EnumEditMode = typeof EnumEditMode[keyof typeof EnumEditMode];
+/**
+ * Layout direction for form layouts
+ */
+export declare const LayoutDirection: {
+    readonly HORIZONTAL: "horizontal";
+    readonly VERTICAL: "vertical";
+};
+export type LayoutDirection = typeof LayoutDirection[keyof typeof LayoutDirection];
+/**
+ * Semantic badge variants for enum display.
+ * These map 1:1 to the Badge component's `variant` prop in presets-components.
+ */
+export declare const BadgeSemanticVariant: {
+    readonly DEFAULT: "default";
+    readonly SECONDARY: "secondary";
+    readonly OUTLINE: "outline";
+    readonly INFO: "info";
+    readonly SUCCESS: "success";
+    readonly WARNING: "warning";
+    readonly DESTRUCTIVE: "destructive";
+};
+export type BadgeSemanticVariant = typeof BadgeSemanticVariant[keyof typeof BadgeSemanticVariant];
+/**
+ * An icon reference — either a React component (Lucide, custom SVG) or
+ * a string key (StandardIconReference) resolved via the icon registry.
+ *
+ * When `string`: resolved at render time through `renderIcon(key, opts)`.
+ * When `ComponentType`: rendered directly via `React.createElement(icon, props)`.
+ */
+export type IconLike = ComponentType<{
+    size?: number;
+    color?: string;
+    className?: string;
+    strokeWidth?: number;
+}> | string;
+/**
+ * Per-value display configuration for enum fields.
+ * Groups all visual properties for a single enum value in one place.
+ */
+export interface EnumValueDisplayConfig {
+    /** Badge variant / color for this enum value */
+    color?: BadgeSemanticVariant;
+    /** Icon for this enum value — React component or StandardIconReference string */
+    icon?: IconLike;
+}
+/**
+ * Updater function accepted by any decorator with object params.
+ *
+ * Receives the current metadata value (or `undefined` if no prior decorator
+ * or if the prior value is the `true` boolean shorthand). Returns the new value.
+ *
+ * For `{primitive}UI` decorators, the updater bypasses the
+ * normal merge behavior — the returned value replaces entirely.
+ *
+ * @example
+ * ```ts
+ * schema.enumUI((current) => ({
+ *   ...current,
+ *   defaultColor: 'secondary',
+ *   values: { ...current?.values, active: { color: 'success' } },
+ * }));
+ *
+ * schema.formComponent((current) => ({
+ *   ...current,
+ *   component: 'custom-input',
+ *   hideLabel: true,
+ * }));
+ * ```
+ */
+export type DecoratorUpdater<T> = (current: T | undefined) => T;
+/**
+ * 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 declare const ForeignKeyDisplayMode: {
+    readonly ID: "id";
+    readonly LABEL: "label";
+    readonly SUMMARY: "summary";
+};
+export type ForeignKeyDisplayMode = typeof ForeignKeyDisplayMode[keyof typeof ForeignKeyDisplayMode];
+/**
+ * Polymorphic FK variant definition.
+ * Specifies which parent resource variants a polymorphic FK targets.
+ * Used by the polymorphic factory to derive the correct FK field name per variant.
+ */
+export interface PolymorphicFkVariant {
+    /** The parent resource type (e.g., 'organizations') */
+    parentResourceType: string;
+    /** The parent's field identifier (e.g., 'organizationId') */
+    parentFieldIdentifier: string;
+}
+/**
+ * Structural FK params — backend/factory-relevant subset.
+ * Stays on `IS_FOREIGN_KEY`. UI-specific params (mode, linkable,
+ * displayPresetOverride) live on `ForeignKeyUIParams` via `.foreignKeyUI()`.
+ */
+export interface ForeignKeyStructuralParams {
+    polymorphicVariants?: PolymorphicFkVariant[];
+}
+/**
+ * Supported types for range schemas.
+ */
+export declare enum RangeType {
+    NUMBER = "number",
+    DATE = "date",
+    DATETIME = "datetime",
+    TIME = "time",
+    BIGDECIMAL = "bigdecimal",
+    MONEY = "money"
+}
+/**
+ * Type mapping for range schema outputs.
+ * Maps RangeType to the resulting schema's inferred TypeScript type.
+ */
+/**
+ * Type mapping for range schema outputs.
+ * Maps RangeType to the resulting schema's inferred TypeScript type.
+ * Note: Money and BigDecimal have their actual types, but for range purposes,
+ * the actual Zod schemas (MoneyValueSchema, BigDecimalValueSchema) define the real structure.
+ */
+export type RangeTypeMapping = {
+    [RangeType.NUMBER]: number;
+    [RangeType.DATE]: Date;
+    [RangeType.DATETIME]: string;
+    [RangeType.TIME]: string;
+    [RangeType.BIGDECIMAL]: string;
+    [RangeType.MONEY]: {
+        amount: bigint;
+        currency: string;
+        decimals: number;
+    };
+};
+/**
+ * Min/max constraint value types based on range type.
+ */
+export type RangeConstraintValue = number | Date | string;
+export interface RangeSchemaMetadata {
+    /** Marker for detecting range schemas */
+    isRange: true;
+    /** The type of values in the range */
+    type: RangeType;
+    /** Whether the 'from' field is optional (default: true) */
+    fromOptional: boolean;
+    /** Whether the 'to' field is optional (default: true) */
+    toOptional: boolean;
+    /** Minimum allowed value (for UI hints and validation) */
+    min?: RangeConstraintValue;
+    /** Maximum allowed value (for UI hints and validation) */
+    max?: RangeConstraintValue;
+}
+/**
+ * Options for creating a range schema.
+ */
+export interface RangeSchemaOptions {
+    /** Whether the 'from' field is optional (default: true) */
+    fromOptional?: boolean;
+    /** Whether the 'to' field is optional (default: true) */
+    toOptional?: boolean;
+    /** Minimum allowed value (stored in metadata for UI hints) */
+    min?: RangeConstraintValue;
+    /** Maximum allowed value (stored in metadata for UI hints) */
+    max?: RangeConstraintValue;
+}
+export declare enum RangeSchemaType {
+    NUMBER = "number",// Number schemas (z.number, z.int)
+    DATE = "date",// Date schemas (z.date)
+    DATETIME = "datetime",// Datetime schemas (z.datetime)
+    TIME = "time",// Time schemas (z.time)
+    BIGDECIMAL = "bigdecimal",// BigDecimal schemas (z_bigdecimal)
+    MONEY = "money"
+}
+export declare const RangeTypeToComponent: Record<RangeSchemaType, FormFieldComponent>;
+export declare function getDefaultRangeComponent(rangeType: RangeSchemaType | string): FormFieldComponent;
+/**
+ * Inferred type for a range schema based on options.
+ */
+export type RangeSchemaInferredType<T extends RangeType, FromOptional extends boolean = true, ToOptional extends boolean = true> = {
+    from: FromOptional extends true ? RangeTypeMapping[T] | undefined : RangeTypeMapping[T];
+    to: ToOptional extends true ? RangeTypeMapping[T] | undefined : RangeTypeMapping[T];
+};
+/**
+ * Metadata stored on money schemas for detection and configuration.
+ * Money schemas represent financial amounts with bigint storage to avoid precision issues.
+ * Structure: { amount: bigint, currency: string, decimals: number (int) }
+ */
+export interface MoneySchemaMetadata {
+    /** Marker for detecting money schemas */
+    isMoney: true;
+    /**
+     * Currency category filter. Replaces old `showCrypto` / `majorOnly` / `fiatOnly` booleans.
+     * E.g. `[CurrencyAllowed.FIAT]` = fiat only, `[CurrencyAllowed.FIAT_MAJOR]` = major fiat only.
+     * When undefined or empty, all currencies are available.
+     */
+    currenciesAllowed?: CurrencyAllowed[];
+    /** Whether to show only app-enabled currencies (default: true). Renamed from `enabledOnly`. */
+    appEnabledOnly?: boolean;
+    /** Whether to allow currency change (default: true) */
+    allowCurrencyChange?: boolean;
+    /** Minimum amount in smallest unit as bigint (e.g., 0n for non-negative) */
+    minAmount?: bigint;
+    /** Maximum amount in smallest unit as bigint */
+    maxAmount?: bigint;
+}
+/**
+ * Options for creating a money schema.
+ */
+export interface MoneySchemaOptions {
+    /**
+     * Currency category filter. Replaces old `showCrypto` / `majorOnly` / `fiatOnly` booleans.
+     * E.g. `[CurrencyAllowed.FIAT]` = fiat only, `[CurrencyAllowed.FIAT_MAJOR]` = major fiat only.
+     * When undefined or empty, all currencies are available.
+     */
+    currenciesAllowed?: CurrencyAllowed[];
+    /** Whether to show only app-enabled currencies (default: true). Renamed from `enabledOnly`. */
+    appEnabledOnly?: boolean;
+    /** Whether to allow currency change (default: true) */
+    allowCurrencyChange?: boolean;
+    /** Minimum amount in smallest unit as bigint (e.g., 0n for non-negative) */
+    minAmount?: bigint;
+    /** Maximum amount in smallest unit as bigint */
+    maxAmount?: bigint;
+}
+/**
+ * Metadata stored on bigdecimal schemas for detection and configuration.
+ * BigDecimal schemas represent precise decimal numbers stored as strings.
+ * Uses big.js for precise arithmetic operations.
+ */
+export interface BigDecimalSchemaMetadata {
+    /** Marker for detecting bigdecimal schemas */
+    isBigDecimal: true;
+    /** Maximum number of decimal places allowed */
+    precision?: number;
+    /** Minimum value (as string for precision) */
+    min?: string;
+    /** Maximum value (as string for precision) */
+    max?: string;
+}
+/**
+ * Options for creating a bigdecimal schema.
+ */
+export interface BigDecimalSchemaOptions {
+    /** Maximum number of decimal places allowed */
+    precision?: number;
+    /** Minimum value (as string for precision) */
+    min?: string;
+    /** Maximum value (as string for precision) */
+    max?: string;
+}
+/**
+ * Duration units enum.
+ * Uses string values for JSON serialization and API compatibility.
+ * Aligns with common patterns (e.g., expiresIn: { value, unit }).
+ */
+export declare enum DurationUnit {
+    MILLISECONDS = "milliseconds",
+    SECONDS = "seconds",
+    MINUTES = "minutes",
+    HOURS = "hours",
+    DAYS = "days",
+    WEEKS = "weeks",
+    MONTHS = "months",
+    YEARS = "years",
+    CENTURIES = "centuries"
+}
+/**
+ * Token expiry duration — minutes, hours, or days only.
+ * Structurally compatible with DurationValue. Use ExpiresInDurationSchema for validation.
+ */
+export type ExpiresInDuration = {
+    value: number;
+    unit: DurationUnit.MINUTES | DurationUnit.HOURS | DurationUnit.DAYS;
+};
+/**
+ * Metadata stored on duration schemas for detection and configuration.
+ * Duration schemas represent time spans with { value: number, unit: DurationUnit }.
+ */
+export interface DurationSchemaMetadata {
+    /** Marker for detecting duration schemas */
+    isDuration: true;
+    /** Allowed units (if empty/undefined, all units are allowed) */
+    allowedUnits?: DurationUnit[];
+    /** Minimum value (for the numeric part) */
+    minValue?: number;
+    /** Maximum value (for the numeric part) */
+    maxValue?: number;
+}
+/** ISO 3166-1 alpha-2 country code (e.g., 'US', 'FR') */
+export type PhoneCountryCode = string;
+/**
+ * Metadata stored on phone schemas for detection and configuration.
+ * Phone schemas store E.164 strings.
+ */
+export interface PhoneSchemaMetadata {
+    /** Marker for detecting phone schemas */
+    isPhone: true;
+    /** Default country when parsing numbers without country code */
+    defaultCountry?: PhoneCountryCode;
+}
+/**
+ * Options for creating a phone schema via z_phone().
+ */
+export interface PhoneSchemaOptions {
+    /** Default country when parsing numbers without country code */
+    defaultCountry?: PhoneCountryCode;
+}
+/**
+ * Supported code/programming languages for code schemas.
+ */
+export type CodeLanguage = 'javascript' | 'typescript' | 'python' | 'java' | 'csharp' | 'cpp' | 'c' | 'go' | 'rust' | 'ruby' | 'php' | 'swift' | 'kotlin' | 'scala' | 'html' | 'css' | 'scss' | 'less' | 'json' | 'yaml' | 'xml' | 'markdown' | 'sql' | 'graphql' | 'bash' | 'shell' | 'powershell' | 'dockerfile' | 'nginx' | 'apache' | 'plaintext' | string;
+/**
+ * Metadata stored on code schemas for detection and configuration.
+ * Code schemas represent code snippets with language information.
+ * Structure: { content: string, language: string }
+ */
+export interface CodeSchemaMetadata {
+    /** Marker for detecting code schemas */
+    isCode: true;
+    /** Allowed languages (if empty, all languages are allowed) */
+    allowedLanguages?: CodeLanguage[];
+    /** Maximum content length in characters */
+    maxLength?: number;
+    /** Minimum content length in characters */
+    minLength?: number;
+}
+/**
+ * Options for creating a code schema.
+ */
+export interface CodeSchemaOptions {
+    /** Allowed languages (if empty, all languages are allowed) */
+    allowedLanguages?: CodeLanguage[];
+    /** Maximum content length in characters */
+    maxLength?: number;
+    /** Minimum content length in characters */
+    minLength?: number;
+}
+/**
+ * Common MIME type groups for file uploads.
+ */
+export declare const FileMimeTypeGroups: {
+    /** Image files: JPEG, PNG, GIF, WebP, SVG, etc. */
+    readonly Images: readonly ["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. */
+    readonly Video: readonly ["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. */
+    readonly Audio: readonly ["audio/mpeg", "audio/wav", "audio/ogg", "audio/webm", "audio/aac", "audio/flac", "audio/x-m4a", "audio/mp4"];
+    /** PDF documents */
+    readonly PDF: readonly ["application/pdf"];
+    /** Office documents: Word, Excel, PowerPoint, etc. */
+    readonly Office: readonly ["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 */
+    readonly Documents: readonly ["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. */
+    readonly Archives: readonly ["application/zip", "application/x-zip-compressed", "application/x-rar-compressed", "application/x-7z-compressed", "application/gzip", "application/x-tar"];
+};
+export type FileMimeTypeGroup = keyof typeof FileMimeTypeGroups;
+/**
+ * File nature classification for constraint validation and UI display.
+ */
+export declare enum FileNature {
+    IMAGE = "image",
+    VIDEO = "video",
+    AUDIO = "audio",
+    PDF = "pdf",
+    OFFICE = "office",
+    ARCHIVE = "archive",
+    ALL = "all"
+}
+/**
+ * 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 declare enum FileDisplayNature {
+    IMAGE = "image",
+    VIDEO = "video",
+    AUDIO = "audio",
+    DOCUMENT = "document",
+    GENERIC = "generic"
+}
+/**
+ * Storage providers accepted for file uploads.
+ */
+export declare enum FileStorageAccepted {
+    WILDO_MANAGED = "wildo_managed",
+    LOCAL_DIRECTORY = "local_directory",
+    ONEDRIVE = "onedrive",
+    GOOGLE_DRIVE = "google_drive",
+    DROPBOX = "dropbox"
+}
+/**
+ * Context object passed to `FilePathBinding` resolver functions.
+ *
+ * `relatedObject` may be undefined for standalone uploads (no parent resource).
+ * `fileMetadata` and `applicationId` are always provided by the runtime.
+ */
+export interface FilePathBindingContext {
+    /** The parent resource instance (undefined for standalone uploads) */
+    relatedObject?: Record<string, unknown>;
+    /** The z_file() field's schema metadata */
+    fileMetadata: FileSchemaMetadata;
+    /** Application identifier from the execution context */
+    applicationId: string;
+}
+/**
+ * Policy for `z_file({ multiple: true })` fields.
+ *
+ * Controls the intermediary subfolder name and individual file naming
+ * when several files live under the same instance folder.
+ */
+export interface FileMultipleFilePolicy {
+    /**
+     * Subfolder name under the resolved folder path.
+     * Defaults to the field name when omitted.
+     * @example 'personnas'
+     */
+    subfolder?: string;
+    /**
+     * Determines the individual file name for each upload.
+     *
+     * - `string` — template with placeholders:
+     *   `{field}`, `{ts}`, `{uuid}`, `{ext}`, `{original}`
+     * - `function` — full control, receives context + file-level info
+     *
+     * @default '{field}_{ts}_{uuid}.{ext}'
+     */
+    fileNameTemplate?: string | ((context: FilePathBindingContext, fileInfo: {
+        fileId: string;
+        fieldName: string;
+        originalFileName?: string;
+    }) => string);
+}
+/**
+ * File path binding configuration authored on `z_file()`.
+ *
+ * Declares how files for a given field are located in path-based
+ * storage backends. The binding is backend-agnostic: it affects the
+ * S3 key prefix for managed storage and the filesystem path for
+ * local-directory storage alike.
+ *
+ * ## Path composition
+ *
+ * ```
+ * <provider root>/
+ *   [applicationId/]              ← only if includeApplicationId is true
+ *   [folderPath(ctx)/]            ← dynamic folder path
+ *   <fileName(ctx) | fileId>      ← explicit name or UUID fallback
+ * ```
+ *
+ * When nothing is configured, the fallback is the legacy `{fileId}` key
+ * for full backward compatibility.
+ *
+ * @example
+ * ```typescript
+ * z_file({
+ *   filePathBinding: {
+ *     folderPath: (ctx) => `specs/icps/${ctx.relatedObject?.name}`,
+ *     fileName: 'personna.md',
+ *   },
+ * })
+ * ```
+ *
+ * @example
+ * ```typescript
+ * z_file({
+ *   multiple: true,
+ *   filePathBinding: {
+ *     folderPath: (ctx) => `specs/icps/${ctx.relatedObject?.name}`,
+ *     multipleFilePolicy: {
+ *       subfolder: 'personnas',
+ *       fileNameTemplate: '{field}_{ts}_{uuid}.{ext}',
+ *     },
+ *   },
+ * })
+ * ```
+ */
+export interface FilePathBinding {
+    /**
+     * Determines the folder path relative to the provider's root.
+     *
+     * - `string` — static path, forward-slash separated.
+     * - `function` — receives the binding context and returns the path.
+     *   The function has access to the related resource object, file metadata,
+     *   and the applicationId.
+     *
+     * Forward-slash separated, no leading or trailing slash.
+     * @example 'specs/icps'
+     * @example (ctx) => `specs/icps/${slugify(ctx.relatedObject?.name)}`
+     */
+    folderPath?: string | ((context: FilePathBindingContext) => string);
+    /**
+     * File name for single `z_file()` fields (non-multiple).
+     * When omitted, falls back to the fileId (UUID-based, legacy behavior).
+     *
+     * - `string` — static name; can include `{ext}` placeholder.
+     * - `function` — receives binding context and returns the file name.
+     *
+     * @example 'personna.md'
+     * @example 'avatar.{ext}'
+     * @example (ctx) => `${ctx.relatedObject?.slug}.md`
+     */
+    fileName?: string | ((context: FilePathBindingContext) => string);
+    /**
+     * Naming policy for `z_file({ multiple: true })` fields.
+     * Controls the intermediary subfolder and individual file naming.
+     */
+    multipleFilePolicy?: FileMultipleFilePolicy;
+    /**
+     * Whether to include the applicationId as a path segment.
+     *
+     * Each provider has its own default:
+     *  - `wildo_managed` (S3) → `true` (always, for bucket isolation)
+     *  - `local_directory`    → `false` (volume is typically per-app)
+     *
+     * Set explicitly to override the provider default.
+     */
+    includeApplicationId?: boolean;
+}
+export declare enum FileUploaderEntityType {
+    USER = "user",
+    ANONYMOUS_USER = "anonymous_user",
+    ORGANIZATION_API_KEY = "organization_api_key",
+    APPLICATION_API_KEY = "application_api_key"
+}
+export type FileUploaderOwnership = {
+    uploadedBy: string;
+    uploadedByEntityType: FileUploaderEntityType;
+} | {
+    uploadedBy?: undefined;
+    uploadedByEntityType?: undefined;
+};
+/**
+ * Image format options for file validation.
+ */
+export declare const ImageFormat: {
+    readonly JPEG: "jpeg";
+    readonly PNG: "png";
+    readonly GIF: "gif";
+    readonly WEBP: "webp";
+    readonly SVG: "svg";
+};
+export type ImageFormat = typeof ImageFormat[keyof typeof ImageFormat];
+/**
+ * Video format options for file validation.
+ */
+export declare const VideoFormat: {
+    readonly MP4: "mp4";
+    readonly WEBM: "webm";
+    readonly MOV: "mov";
+};
+export type VideoFormat = typeof VideoFormat[keyof typeof VideoFormat];
+/**
+ * Audio format options for file validation.
+ */
+export declare const AudioFormat: {
+    readonly MP3: "mp3";
+    readonly WAV: "wav";
+    readonly OGG: "ogg";
+    readonly AAC: "aac";
+};
+export type AudioFormat = typeof AudioFormat[keyof typeof AudioFormat];
+/**
+ * Image-specific constraints for file validation.
+ */
+export interface FileNatureConstraints_Image {
+    minWidth?: number;
+    maxWidth?: number;
+    minHeight?: number;
+    maxHeight?: number;
+    aspectRatio?: {
+        width: number;
+        height: number;
+    };
+    allowedFormats?: ImageFormat[];
+    generateThumbnails?: boolean | {
+        sizes: {
+            width: number;
+            height: number;
+        }[];
+    };
+}
+/**
+ * Video-specific constraints for file validation.
+ */
+export interface FileNatureConstraints_Video {
+    maxDuration?: number;
+    minDuration?: number;
+    allowedFormats?: VideoFormat[];
+    generateThumbnail?: boolean;
+}
+/**
+ * Audio-specific constraints for file validation.
+ */
+export interface FileNatureConstraints_Audio {
+    maxDuration?: number;
+    minDuration?: number;
+    allowedFormats?: AudioFormat[];
+}
+/**
+ * Document-specific constraints for file validation.
+ */
+export interface FileNatureConstraints_Document {
+    maxPages?: number;
+    minPages?: number;
+}
+/**
+ * RAG chunking strategy options for file content indexing.
+ */
+export declare const RAGChunkingStrategy: {
+    readonly FIXED_SIZE: "fixed_size";
+    readonly RECURSIVE: "recursive";
+    readonly SEMANTIC: "semantic";
+    readonly MARKDOWN: "markdown";
+};
+export type RAGChunkingStrategy = typeof RAGChunkingStrategy[keyof typeof RAGChunkingStrategy];
+/**
+ * RAG configuration for file content indexing.
+ */
+export interface FileRAGConfiguration {
+    enabled: boolean;
+    extractText?: boolean;
+    chunkingStrategy?: RAGChunkingStrategy;
+    chunkSize?: number;
+    chunkOverlap?: number;
+}
+/**
+ * File metadata returned by the getMetadata endpoint.
+ * This describes the uploaded file's properties.
+ */
+export type FileMetadata = {
+    /** Unique file identifier */
+    fileId: string;
+    /** Original filename */
+    filename: string;
+    /** File size in bytes */
+    size: number;
+    /** MIME type */
+    mimeType: string;
+    /** File extension (without dot) */
+    extension?: string;
+    /** File checksum/hash for integrity */
+    checksum?: string;
+    /** URL to access/download the file */
+    url?: string;
+    /** URL to thumbnail (for images/videos) */
+    thumbnailUrl?: string;
+    /** Display nature category (image, video, audio, document, generic) */
+    nature?: FileDisplayNature;
+    /** Image width in pixels (for images) */
+    width?: number;
+    /** Image height in pixels (for images) */
+    height?: number;
+    /** Duration in seconds (for video/audio) */
+    duration?: number;
+    /** Page count (for documents) */
+    pageCount?: number;
+    /** Upload timestamp */
+    uploadedAt: Date;
+} & FileUploaderOwnership;
+/**
+ * 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 declare const FileOnParentDelete: {
+    readonly CASCADE: "cascade";
+    readonly SOFT_DELETE: "soft-delete";
+    readonly ORPHAN: "orphan";
+};
+export type FileOnParentDelete = typeof FileOnParentDelete[keyof typeof FileOnParentDelete];
+/**
+ * Metadata stored on file schemas for detection and configuration.
+ * File schemas represent file references with upload capabilities.
+ * Structure (single): { fileId: string, updatedAt: Date }
+ * Structure (multiple): { fileIds: string[], updatedAt: Date }
+ */
+export interface FileSchemaMetadata {
+    /** Marker for detecting file schemas */
+    isFile: true;
+    /** Whether existing files can be replaced/overridden (default: true) */
+    overridable?: boolean;
+    /** Allowed MIME types (if empty, all types are allowed) */
+    allowedMimeTypes?: string[];
+    /** Maximum file size in bytes */
+    maxSize?: number;
+    /** Minimum file size in bytes */
+    minSize?: number;
+    /** Whether multiple files can be uploaded (default: false) */
+    multiple?: boolean;
+    /** Maximum number of files (when multiple is true) */
+    maxFiles?: number;
+    /** File nature classification */
+    nature?: FileNature;
+    /** Storage providers accepted for file uploads */
+    storageAccepted?: FileStorageAccepted[];
+    /** File path binding for structured storage organization */
+    filePathBinding?: FilePathBinding;
+    /** Image-specific constraints */
+    imageConstraints?: FileNatureConstraints_Image;
+    /** Video-specific constraints */
+    videoConstraints?: FileNatureConstraints_Video;
+    /** Audio-specific constraints */
+    audioConstraints?: FileNatureConstraints_Audio;
+    /** Document-specific constraints */
+    documentConstraints?: FileNatureConstraints_Document;
+    /** RAG configuration */
+    rag?: FileRAGConfiguration;
+    /**
+     * Antivirus scan policy for this file field.
+     * - 'required': always scan after upload, regardless of global config
+     * - 'skip': never scan this field, even if global scanning is enabled
+     * - undefined: inherit from `appConfig.files.scanning.enabled`
+     */
+    scanPolicy?: 'required' | 'skip';
+    /** Behavior when parent resource is deleted (default: CASCADE) */
+    onParentDelete?: FileOnParentDelete;
+    /**
+     * Whether this file field supports public sharing via consumable tokens.
+     * When true, the `POST /files/:fileId/share` endpoint will generate a
+     * `FILE_PUBLIC_ACCESS` consumable token for this file.
+     * @default false
+     */
+    sharable?: boolean;
+    /**
+     * Default sharing configuration when `sharable` is true.
+     * Controls token duration and max uses for shared links.
+     */
+    sharableDefaults?: {
+        /** Default expiration for share tokens */
+        expiresIn?: ExpiresInDuration;
+        /** Default max uses for share tokens (BOUNDED_REUSE) */
+        maxUses?: number;
+        /** Default consumption mode. Defaults to BOUNDED_REUSE if not specified. */
+        consumptionMode?: 'SINGLE_USE' | 'BOUNDED_REUSE';
+    };
+}
+/**
+ * Options for creating a file schema.
+ */
+export interface FileSchemaOptions {
+    /** Whether existing files can be replaced/overridden (default: true) */
+    overridable?: boolean;
+    /** Allowed MIME types - can be array of MIME types or group names */
+    allowedMimeTypes?: string[] | FileMimeTypeGroup | FileMimeTypeGroup[];
+    /** Maximum file size in bytes */
+    maxSize?: number;
+    /** Minimum file size in bytes */
+    minSize?: number;
+    /** Whether multiple files can be uploaded (default: false) */
+    multiple?: boolean;
+    /** Maximum number of files (when multiple is true) */
+    maxFiles?: number;
+    /** File nature classification */
+    nature?: FileNature;
+    /** Storage providers accepted for file uploads */
+    storageAccepted?: FileStorageAccepted[];
+    /** File path binding for structured storage organization */
+    filePathBinding?: FilePathBinding;
+    /** Image-specific constraints */
+    imageConstraints?: FileNatureConstraints_Image;
+    /** Video-specific constraints */
+    videoConstraints?: FileNatureConstraints_Video;
+    /** Audio-specific constraints */
+    audioConstraints?: FileNatureConstraints_Audio;
+    /** Document-specific constraints */
+    documentConstraints?: FileNatureConstraints_Document;
+    /** RAG configuration */
+    rag?: FileRAGConfiguration;
+    /**
+     * Antivirus scan policy for this file field.
+     * - 'required': always scan after upload, regardless of global config
+     * - 'skip': never scan this field, even if global scanning is enabled
+     * - undefined: inherit from `appConfig.files.scanning.enabled`
+     */
+    scanPolicy?: 'required' | 'skip';
+    /** Behavior when parent resource is deleted (default: CASCADE) */
+    onParentDelete?: FileOnParentDelete;
+    /**
+     * Whether this file field supports public sharing via consumable tokens.
+     * When true, the `POST /files/:fileId/share` endpoint will generate a
+     * `FILE_PUBLIC_ACCESS` consumable token for this file.
+     * @default false
+     */
+    sharable?: boolean;
+    /**
+     * Default sharing configuration when `sharable` is true.
+     * Controls token duration and max uses for shared links.
+     */
+    sharableDefaults?: {
+        /** Default expiration for share tokens */
+        expiresIn?: ExpiresInDuration;
+        /** Default max uses for share tokens (BOUNDED_REUSE) */
+        maxUses?: number;
+        /** Default consumption mode. Defaults to BOUNDED_REUSE if not specified. */
+        consumptionMode?: 'SINGLE_USE' | 'BOUNDED_REUSE';
+    };
+}
+/**
+ * File field endpoint URLs for file operations.
+ * These are passed to the form field component.
+ */
+export interface FileFieldEndpoints {
+    /** URL to get file metadata */
+    getMetadata: string;
+    /** URL to upload a new file. Omitted when the field is intentionally read-only or fail-closed. */
+    upload?: string;
+    /** URL to override/replace an existing file (optional, uses upload if not provided) */
+    override?: string;
+    /** URL to delete a file (optional) */
+    delete?: string;
+}
+/**
+ * Metadata stored on versioned schemas for detection and configuration.
+ * Versioned schemas automatically track version history.
+ */
+export interface VersionedSchemaMetadata {
+    /** Marker for detecting versioned schemas */
+    isVersioned: true;
+    /** Initial version number for new records (default: 1) */
+    initialVersion?: number;
+}
+/**
+ * Metadata stored on versioned foreign key schemas for detection and configuration.
+ * Versioned foreign keys reference versioned resources.
+ */
+export interface VersionedForeignKeySchemaMetadata {
+    /** Marker for detecting versioned foreign key schemas */
+    isVersionedForeignKey: true;
+    /** The name of the target resource this foreign key references */
+    targetResource?: string;
+}
+export interface HiddenFieldParams {
+    display?: boolean;
+    edit?: boolean;
+    operations?: string[];
+}
+export interface NotEditableFieldParams {
+    operations?: string[];
+}
+/**
+ * Inline edit mode options
+ */
+export declare const InlineEditMode: {
+    readonly DIRECT: "direct";
+    readonly BUTTON: "button";
+};
+export type InlineEditMode = typeof InlineEditMode[keyof typeof InlineEditMode];
+/**
+ * P10: When to trigger save in inline editing mode
+ */
+export declare const InlineEditSaveOn: {
+    /** Save on blur (when user clicks away) */
+    readonly BLUR: "blur";
+    /** Save only on explicit button click */
+    readonly EXPLICIT: "explicit";
+};
+export type InlineEditSaveOn = typeof InlineEditSaveOn[keyof typeof InlineEditSaveOn];
+/**
+ * Parameters for the isBackendOnly decorator.
+ * Marks fields that should only exist on the backend and be stripped from API responses.
+ */
+export interface BackendOnlyFieldParams {
+    /**
+     * If true, the field will be included in the response for CREATE operations only,
+     * then stripped from all subsequent READ operations.
+     * Useful for secrets, API keys, etc. that should only be returned once.
+     */
+    isReturnedAtCreation?: boolean;
+    /**
+     * If true, access to this field will be logged for audit purposes.
+     * Useful for sensitive data that needs audit trail.
+     */
+    auditAccess?: boolean;
+}
+/**
+ * Parameters passed to virtual field calculation functions.
+ * The `utils` is typed as `any` in shared-lib but will be properly typed at runtime in backend-lib.
+ */
+export interface VirtualFieldCalculationParams<TObject = any, TContext = any, TUserContext = any> {
+    /** The current resource object */
+    currentObject: TObject;
+    /** The resource context (parent/child relationships) - only if needsObjectContext is true */
+    objectContext?: TContext;
+    /** The user context - only if needsUserContext is true */
+    userContext?: TUserContext;
+    /** The execution context containing user, organization, etc. */
+    executionContext: any;
+    /**
+     * Utility services for calculations.
+     * Typed as `any` in shared-lib, but at runtime provides:
+     * - repositories: RepositoryRegistry
+     * - logger: LoggerService
+     * - errorBuilder: ErrorBuilderBackendService
+     * - dateService: DateService
+     * - getService: <T>(symbol: symbol) => T
+     */
+    utils: any;
+}
+/**
+ * Parameters for the isVirtual decorator.
+ * Virtual fields are computed at runtime and not stored in the database.
+ */
+export interface VirtualFieldParams<TObject = any, TResult = any> {
+    /**
+     * The calculation function that computes this virtual field's value.
+     * Called at runtime by VirtualFieldsBackendService with injected utilities.
+     */
+    calculate: (params: VirtualFieldCalculationParams<TObject>) => TResult | Promise<TResult>;
+    /**
+     * If true, the objectContext (parent/child relationships) will be passed to calculate().
+     * Setting this to true has a performance cost as it requires fetching related resources.
+     */
+    needsObjectContext?: boolean;
+    /**
+     * If true, the userContext will be passed to calculate().
+     * Setting this to true requires additional context resolution.
+     */
+    needsUserContext?: boolean;
+    /**
+     * Optional list of field names this virtual field depends on.
+     * Used for documentation and potential future optimizations.
+     */
+    dependencies?: string[];
+}
+/**
+ * Parameters for the isDiscriminator decorator.
+ * Marks a field as the discriminator for a discriminated union schema.
+ */
+export interface DiscriminatorFieldParams {
+    /**
+     * Values for which the base schema is used (no extended variant).
+     * If not provided, auto-detected from enum values not covered by variants.
+     */
+    baseValues?: string[];
+}
+/**
+ * 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 declare const UniqueScope: {
+    readonly GLOBAL: "global";
+    readonly ORGANIZATION: "organization";
+    readonly USER: "user";
+};
+export type UniqueScope = typeof UniqueScope[keyof typeof UniqueScope];
+/**
+ * Parameters for the isUnique decorator.
+ * Marks a field as unique in the database with unique index.
+ * MongoDB will enforce uniqueness and throw E11000 duplicate key error on violations.
+ */
+export interface UniqueFieldParams {
+    /**
+     * Scope for uniqueness constraint.
+     * - 'global': Unique across the entire collection (default)
+     * - 'organization': Unique per organization (compound index with organizationId)
+     * - 'user': Unique per user (compound index with createdByUserId)
+     */
+    scope?: UniqueScope;
+    /**
+     * Create a compound unique index with another field in the same schema.
+     * The referenced field name is resolved against the actual schema fields,
+     * handling polymorphic field renames automatically.
+     *
+     * @example poolKey: z.string().isUnique({ compoundWith: 'billingAccountId' })
+     * // Creates compound unique index: { billingAccountId: 1, poolKey: 1 }
+     * // For polymorphic variants, resolves e.g. to: { organizationBillingAccountId: 1, poolKey: 1 }
+     */
+    compoundWith?: string;
+    /**
+     * Whether to allow null values without triggering uniqueness.
+     * MongoDB unique indexes exclude null by default when sparse is true.
+     * @default true
+     */
+    sparse?: boolean;
+    /**
+     * Custom error message to show when uniqueness is violated.
+     * Supports placeholder {fieldName} which is replaced with the actual field name.
+     * @example "This {fieldName} is already taken"
+     */
+    errorMessage?: string;
+}
+/**
+ * Parameters for the ttl decorator.
+ * Marks a Date field for TTL (Time To Live) expiration in MongoDB.
+ * MongoDB will automatically delete documents when the TTL expires.
+ *
+ * @example
+ * createdAt: z.date().ttl({ expireAfterSeconds: 3600 }) // Expire 1 hour after createdAt
+ *
+ * @example
+ * expiresAt: z.date().ttl({ expireAfterSeconds: 0 }) // Expire at the exact date value
+ */
+export interface TtlFieldParams {
+    /**
+     * Number of seconds after the field's date value when the document should be deleted.
+     * - 0: Document expires at the exact date/time stored in the field
+     * - N > 0: Document expires N seconds after the date/time stored in the field
+     *
+     * @example
+     * // Expire documents 24 hours after createdAt
+     * createdAt: z.date().ttl({ expireAfterSeconds: 86400 })
+     *
+     * @example
+     * // Expire documents at the exact expiresAt date
+     * expiresAt: z.date().ttl({ expireAfterSeconds: 0 })
+     */
+    expireAfterSeconds: number;
+}
+/**
+ * Parameters for the isOtp decorator.
+ * Configures the OTP (One-Time Password) input field behavior.
+ */
+export interface OtpFieldParams {
+    /**
+     * Maximum length of the OTP code.
+     * Determines how many input slots are rendered.
+     *
+     * @default 6
+     *
+     * @example
+     * // 6-digit OTP code
+     * otpCode: z.string().isOtp()
+     *
+     * @example
+     * // 4-digit PIN
+     * pin: z.string().isOtp({ maxLength: 4 })
+     */
+    maxLength?: number;
+}
+/**
+ * Parameters for the isSummaryField decorator.
+ * Controls how summary fields are handled, particularly for foreign key population.
+ */
+export interface SummaryFieldParams {
+    /**
+     * Whether to populate this foreign key field with the related resource's summary data.
+     * Only applicable when the field also has isForeignKey() decorator.
+     *
+     * When true:
+     * - The related resource will be fetched using the resourceIdentifier naming convention
+     * - Only the related resource's isSummaryField fields will be included
+     * - The populated data is optional (null if the related resource doesn't exist)
+     *
+     * @default false
+     *
+     * @example
+     * // Field definition:
+     * userId: z.string().isForeignKey().isSummaryField({ populate: true })
+     *
+     * // LIST/SEARCH response will include:
+     * {
+     *   _id: "123",
+     *   userId: "user-456",
+     *   user: { _id: "user-456", email: "...", displayName: "..." }  // populated summary
+     * }
+     */
+    populate?: boolean;
+}
+/**
+ * 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 declare enum ValidationMode {
+    ON_CHANGE = "onChange",
+    ON_BLUR = "onBlur",
+    ON_TOUCHED = "onTouched",
+    ON_SUBMIT = "onSubmit"
+}
+/**
+ * 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 declare enum AutosaveTrigger {
+    DEBOUNCE = "debounce",
+    BLUR = "blur",
+    NONE = "none"
+}
+export interface AutosaveFieldParams {
+    /**
+     * Whether autosave is enabled for this field.
+     * @default true
+     */
+    enabled?: boolean;
+    /**
+     * Trigger mechanism for autosave.
+     * - AutosaveTrigger.DEBOUNCE: Save after a delay following the last change
+     * - AutosaveTrigger.BLUR: Save when field loses focus
+     * - AutosaveTrigger.NONE: Disable autosave for this field
+     * @default AutosaveTrigger.DEBOUNCE
+     */
+    trigger?: AutosaveTrigger;
+    /**
+     * Debounce delay in milliseconds (only for DEBOUNCE trigger).
+     * @default 500
+     */
+    debounceMs?: number;
+}
+/**
+ * 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 declare enum ShowWhenOperator {
+    EQUALS = "equals",
+    NOT_EQUALS = "notEquals",
+    IN = "in",
+    NOT_IN = "notIn",
+    EXISTS = "exists",
+    NOT_EXISTS = "notExists"
+}
+/**
+ * FIX-P5-H1: A single condition for showWhen decorator.
+ * The field is visible when this condition is satisfied.
+ */
+export interface ShowWhenCondition {
+    /** Field name to watch for changes */
+    field: string;
+    /**
+     * Value(s) that satisfy the condition.
+     * For EQUALS/NOT_EQUALS: single value or array
+     * For IN/NOT_IN: array of values
+     * For EXISTS/NOT_EXISTS: ignored
+     */
+    value?: unknown | unknown[];
+    /**
+     * Comparison operator.
+     * @default ShowWhenOperator.EQUALS
+     */
+    operator?: ShowWhenOperator;
+}
+/**
+ * FIX-P5-H1: Parameters for the showWhen decorator.
+ * Configures conditional visibility for form fields.
+ *
+ * @example
+ * ```ts
+ * // Show when 'type' field equals 'advanced'
+ * advancedOption: z.string().showWhen({
+ *   conditions: { field: 'type', value: 'advanced' }
+ * })
+ *
+ * // Show when 'type' is one of multiple values
+ * featureOption: z.string().showWhen({
+ *   conditions: { field: 'type', value: ['pro', 'enterprise'], operator: 'in' }
+ * })
+ *
+ * // Show when both conditions are met
+ * premiumFeature: z.string().showWhen({
+ *   conditions: [
+ *     { field: 'type', value: 'enterprise' },
+ *     { field: 'hasPremium', value: true }
+ *   ],
+ *   combineWith: 'and'
+ * })
+ * ```
+ */
+export interface ShowWhenParams {
+    /**
+     * Condition(s) that control visibility.
+     * Can be a single condition or array of conditions.
+     */
+    conditions: ShowWhenCondition | ShowWhenCondition[];
+    /**
+     * How to combine multiple conditions.
+     * - 'and': All conditions must be true (default)
+     * - 'or': Any condition must be true
+     * @default 'and'
+     */
+    combineWith?: 'and' | 'or';
+}
+/**
+ * Parameters for the isDraftable decorator.
+ * Configures draft mode behavior at the schema level.
+ */
+export interface DraftableConfigParams {
+    /**
+     * Field name that indicates draft status (discriminator).
+     * @example 'status'
+     */
+    discriminator: string;
+    /**
+     * Value of the discriminator field that indicates draft mode.
+     * @example 'DRAFT'
+     */
+    draftValue: string;
+    /**
+     * Value of the discriminator field that indicates published status.
+     * If not provided, publishing will remove the discriminator field.
+     * @example 'PUBLISHED'
+     */
+    publishedValue?: string;
+    /**
+     * Whether to require confirmation dialog before publishing.
+     * @default false
+     */
+    requireConfirmationToPublish?: boolean;
+}
+/**
+ * Force-hide specific chrome sub-elements in display context.
+ * Display has no `error` sub-element to hide.
+ */
+export interface ForceHideDisplayConfig {
+    label?: boolean;
+    description?: boolean;
+}
+/**
+ * Force-hide specific chrome sub-elements in edit context.
+ * Extends display with `error` (form-specific).
+ */
+export interface ForceHideConfig extends ForceHideDisplayConfig {
+    error?: boolean;
+}
+/**
+ * Custom labelling for boolean true/false values when enum presets
+ * (BooleanLabellingValue) are insufficient.
+ */
+export interface BooleanLabellingCustomParams {
+    mode: 'custom';
+    trueValue: string;
+    falseValue: string;
+}
+/**
+ * Display-context base params.
+ * Controls chrome, inline editing, and tooltip behavior when a field is rendered in a read-only view.
+ */
+export interface PrimitiveUIBaseDisplayParams {
+    /** Override the display widget for this field (cross-cutting). Type-specific `displayMode` takes precedence. */
+    component?: DisplayFieldComponent;
+    /** Chrome layout mode for the field wrapper in display context. */
+    chromeMode?: ResponsiveAware<DisplayChromeMode>;
+    /** Force-hide specific chrome sub-elements in display context. Plain object = all breakpoints. */
+    forceHide?: ResponsiveAware<ForceHideDisplayConfig>;
+    /** Whether to show a tooltip icon in display chrome. Text comes from i18n. */
+    tooltip?: boolean;
+    /**
+     * Opt-in for description text below the field value in display mode.
+     * When true, the companion generates an i18n key for the description.
+     * Absorbed from the deleted `.displayField({ showDescription })` decorator.
+     */
+    showDescription?: boolean;
+    /**
+     * Inline editing configuration. When set, the display value becomes editable in-place.
+     */
+    inlineEditable?: boolean | {
+        mode?: InlineEditMode;
+        saveOn?: InlineEditSaveOn;
+        showSaveButton?: boolean;
+        showCancelButton?: boolean;
+    };
+}
+/**
+ * Edit-context base params.
+ * Controls chrome, validation, autosave, and focus behavior when a field is rendered in a form.
+ */
+export interface PrimitiveUIBaseEditParams {
+    /** Override the form widget for this field (cross-cutting). Type-specific `editMode` takes precedence. */
+    component?: FormFieldComponent;
+    /** Chrome layout mode for the field wrapper in edit context. */
+    chromeMode?: ResponsiveAware<EditChromeMode>;
+    /** Force-hide specific chrome sub-elements in edit context. Plain object = all breakpoints. */
+    forceHide?: ResponsiveAware<ForceHideConfig>;
+    /** Whether to show a tooltip icon in form chrome. Text comes from i18n. */
+    tooltip?: boolean;
+    /** Auto-focus this field when the form mounts. */
+    autoFocus?: boolean;
+    /**
+     * Opt-in for description/helper text below the form input in edit mode.
+     * When true, the companion generates an i18n key for the description.
+     * Absorbed from the deleted `.displayField({ showDescription })` decorator.
+     */
+    showDescription?: boolean;
+    /** When to trigger validation. Falls back to resource-level defaultValidationMode. */
+    validationMode?: ValidationMode;
+    /** Autosave config for this field. Falls back to resource-level defaultAutosave. */
+    autosave?: AutosaveFieldParams | true;
+}
+/**
+ * Top-level base for all {primitive}UI decorators.
+ * Splits configuration by UI context: display (detail views), summaryOverride (cards/lists), edit (forms).
+ */
+export interface PrimitiveUIBaseParams {
+    /** Config for Display context (detail/read-only views). Primary display config. */
+    display?: PrimitiveUIBaseDisplayParams;
+    /** Config for DisplaySummary context (cards, list items, FK references). Overrides display defaults when rendering in summary. */
+    summaryOverride?: PrimitiveUIBaseDisplayParams;
+    /** Config for Edition context (forms). */
+    edit?: PrimitiveUIBaseEditParams;
+}
+export interface BooleanUIDisplayParams extends PrimitiveUIBaseDisplayParams {
+    /** Display renderer. RAW = plain text, CHECKMARK = checkmark/cross, EDIT_LIKE = shows the edit control read-only. */
+    displayMode?: BooleanDisplayMode;
+}
+export interface BooleanUIEditParams extends PrimitiveUIBaseEditParams {
+    /** Edit control. TOGGLE = pill, SWITCH = iOS-style, CHECKBOX = classic, RADIO = two options. */
+    editMode?: BooleanEditMode;
+}
+export interface BooleanUIParams {
+    /**
+     * Labels for true/false values (cross-context — applies to display and edit).
+     * Use BooleanLabellingValue enum presets or BooleanLabellingCustomParams for literal labels.
+     */
+    labellingValue?: BooleanLabellingValue | BooleanLabellingCustomParams;
+    display?: BooleanUIDisplayParams;
+    summaryOverride?: BooleanUIDisplayParams;
+    edit?: BooleanUIEditParams;
+}
+export interface StringUIDisplayParams extends PrimitiveUIBaseDisplayParams {
+    /** Display renderer. TEXT | TRUNCATE | MULTILINE | COLOR | LINK | EMAIL | BADGE | COPY | SECRET. */
+    displayMode?: StringDisplayMode;
+    /** Max characters before truncation (TRUNCATE displayMode only). */
+    truncateLength?: number;
+}
+export interface StringUIEditParams extends PrimitiveUIBaseEditParams {
+    /** Edit control. INPUT | TEXTAREA | COLOR | PASSWORD | OTP. */
+    editMode?: StringEditMode;
+    /** Number of rows for TEXTAREA editMode. */
+    textareaRows?: number;
+}
+export interface StringUIParams {
+    display?: StringUIDisplayParams;
+    summaryOverride?: StringUIDisplayParams;
+    edit?: StringUIEditParams;
+}
+export interface NumberUIDisplayParams extends PrimitiveUIBaseDisplayParams {
+    /** Display renderer. RAW | FORMATTED | PERCENTAGE | COMPACT | ORDINAL | BYTES. */
+    displayMode?: NumberDisplayMode;
+}
+export interface NumberUIEditParams extends PrimitiveUIBaseEditParams {
+    /** Edit control. INPUT | SLIDER | STEPPER. */
+    editMode?: NumberEditMode;
+}
+export interface NumberUIParams {
+    /** Number of decimal places (cross-context). */
+    decimalPlaces?: number;
+    /** Whether to show trailing zeros (e.g., 1.00 vs 1). */
+    trailingZeros?: boolean;
+    /** Prefix string displayed before the value (e.g., "$", "€"). */
+    prefix?: string;
+    /** Suffix string displayed after the value (e.g., "kg", "%", "px"). */
+    suffix?: string;
+    /** How to interpret percentage values: NORMALIZED (0–1) or PERCENT (0–100). */
+    percentageScale?: PercentageScale;
+    display?: NumberUIDisplayParams;
+    summaryOverride?: NumberUIDisplayParams;
+    edit?: NumberUIEditParams;
+}
+export interface EnumUIDisplayParams extends PrimitiveUIBaseDisplayParams {
+    /** Display renderer. TEXT | BADGE | ICON | CARD. */
+    displayMode?: EnumDisplayMode;
+}
+export interface EnumUIEditParams extends PrimitiveUIBaseEditParams {
+    /** Edit control. SELECT | RADIO | RADIO_ICON_ONLY | TOGGLE | TOGGLE_ICON_ONLY | CARD | CARD_ICON_ONLY | COMBOBOX. */
+    editMode?: EnumEditMode;
+    /** Direction of radio/toggle/checkbox group. Renamed from `layout`. */
+    editDirection?: LayoutDirection;
+    /** Number of grid columns for radio/toggle/card groups. Renamed from `columns`. */
+    editColumnsCount?: number;
+}
+export interface EnumUIParams {
+    /** Per-value display config (cross-context — colors and icons used in both display badges and edit controls). */
+    values?: Record<string, EnumValueDisplayConfig>;
+    /** Default badge color when no per-value override (cross-context). */
+    defaultColor?: BadgeSemanticVariant;
+    /** Default icon when no per-value override (cross-context). */
+    defaultIcon?: IconLike;
+    display?: EnumUIDisplayParams;
+    summaryOverride?: EnumUIDisplayParams;
+    edit?: EnumUIEditParams;
+}
+export type DateUIDisplayParams = PrimitiveUIBaseDisplayParams;
+export type DateUIEditParams = PrimitiveUIBaseEditParams;
+export interface DateUIParams {
+    display?: DateUIDisplayParams;
+    summaryOverride?: DateUIDisplayParams;
+    edit?: DateUIEditParams;
+}
+export type DateTimeUIDisplayParams = PrimitiveUIBaseDisplayParams;
+export type DateTimeUIEditParams = PrimitiveUIBaseEditParams;
+export interface DateTimeUIParams {
+    display?: DateTimeUIDisplayParams;
+    summaryOverride?: DateTimeUIDisplayParams;
+    edit?: DateTimeUIEditParams;
+}
+export type TimeUIDisplayParams = PrimitiveUIBaseDisplayParams;
+export type TimeUIEditParams = PrimitiveUIBaseEditParams;
+export interface TimeUIParams {
+    display?: TimeUIDisplayParams;
+    summaryOverride?: TimeUIDisplayParams;
+    edit?: TimeUIEditParams;
+}
+export type MoneyUIDisplayParams = PrimitiveUIBaseDisplayParams;
+export interface MoneyUIEditParams extends PrimitiveUIBaseEditParams {
+    /** Initial/default currency shown in the picker. Moved from z_money(). ISO 4217. */
+    defaultCurrency?: AvailableCurrency;
+}
+export interface MoneyUIParams {
+    display?: MoneyUIDisplayParams;
+    summaryOverride?: MoneyUIDisplayParams;
+    edit?: MoneyUIEditParams;
+}
+export interface CodeUIDisplayParams extends PrimitiveUIBaseDisplayParams {
+    /** Show line numbers in display context. */
+    showLineNumbers?: boolean;
+}
+export interface CodeUIEditParams extends PrimitiveUIBaseEditParams {
+    /** Show line numbers in editor. */
+    showLineNumbers?: boolean;
+}
+export interface CodeUIParams {
+    /** Enable syntax highlighting (cross-context). */
+    syntaxHighlighting?: boolean;
+    /** Default language for the code editor/display (cross-context). Must be in allowedLanguages (from z_code()). */
+    defaultLanguage?: CodeLanguage;
+    display?: CodeUIDisplayParams;
+    summaryOverride?: CodeUIDisplayParams;
+    edit?: CodeUIEditParams;
+}
+export type FileUIDisplayParams = PrimitiveUIBaseDisplayParams;
+export type FileUIEditParams = PrimitiveUIBaseEditParams;
+export interface FileUIParams {
+    display?: FileUIDisplayParams;
+    summaryOverride?: FileUIDisplayParams;
+    edit?: FileUIEditParams;
+}
+export type DurationUIDisplayParams = PrimitiveUIBaseDisplayParams;
+export interface DurationUIEditParams extends PrimitiveUIBaseEditParams {
+    /** Default unit shown in the picker. Must be in allowedUnits (from z_duration()). */
+    defaultUnit?: DurationUnit;
+}
+export interface DurationUIParams {
+    display?: DurationUIDisplayParams;
+    summaryOverride?: DurationUIDisplayParams;
+    edit?: DurationUIEditParams;
+}
+export type PhoneUIDisplayParams = PrimitiveUIBaseDisplayParams;
+export type PhoneUIEditParams = PrimitiveUIBaseEditParams;
+export interface PhoneUIParams {
+    /**
+     * Overrides factory defaultCountry for UI rendering (cross-context).
+     * ISO 3166-1 alpha-2 code. Typed as string at this layer; consumers should use AvailableCountry
+     * from presets-components-models for type safety.
+     */
+    displayCountry?: string;
+    display?: PhoneUIDisplayParams;
+    summaryOverride?: PhoneUIDisplayParams;
+    edit?: PhoneUIEditParams;
+}
+export interface BigDecimalUIDisplayParams extends PrimitiveUIBaseDisplayParams {
+    /** Display renderer. RAW | FORMATTED | PERCENTAGE. */
+    displayMode?: BigDecimalDisplayMode;
+}
+export interface BigDecimalUIEditParams extends PrimitiveUIBaseEditParams {
+    /** Edit control. Only INPUT for arbitrary precision. */
+    editMode?: BigDecimalEditMode;
+    /** Default value shown in the editor before user interaction. Moved from bigDecimalConfig. */
+    defaultValue?: string;
+}
+export interface BigDecimalUIParams {
+    /** Number of decimal places (cross-context). */
+    decimalPlaces?: number;
+    /** Whether to show trailing zeros (e.g., 1.00 vs 1). */
+    trailingZeros?: boolean;
+    /** Prefix string displayed before the value (e.g., "$", "€"). */
+    prefix?: string;
+    /** Suffix string displayed after the value (e.g., "kg", "%", "px"). */
+    suffix?: string;
+    /** How to interpret percentage values: NORMALIZED (0–1) or PERCENT (0–100). */
+    percentageScale?: PercentageScale;
+    display?: BigDecimalUIDisplayParams;
+    summaryOverride?: BigDecimalUIDisplayParams;
+    edit?: BigDecimalUIEditParams;
+}
+export interface ForeignKeyUIDisplayParams extends PrimitiveUIBaseDisplayParams {
+    /** How to render the FK reference. ID | LABEL | SUMMARY. */
+    mode?: ForeignKeyDisplayMode;
+    /** Whether the displayed FK value is a clickable link to the referenced resource. */
+    linkable?: boolean;
+    /** Override the preset used to display the referenced resource summary. */
+    displayPresetOverride?: string;
+}
+export type ForeignKeyUIEditParams = PrimitiveUIBaseEditParams;
+export interface ForeignKeyUIParams {
+    display?: ForeignKeyUIDisplayParams;
+    summaryOverride?: ForeignKeyUIDisplayParams;
+    edit?: ForeignKeyUIEditParams;
+}
+export interface ArrayUIDisplayParams extends PrimitiveUIBaseDisplayParams {
+    /** Direction for rendering items in display context. */
+    displayMode?: DisplayDirection;
+    /** Max items shown in display (rest truncated). */
+    maxItems?: number;
+}
+export interface ArrayUIEditParams extends PrimitiveUIBaseEditParams {
+    /** Allow reordering via drag-and-drop in edit context. Set via `.isSortable()` convenience or directly. */
+    isSortable?: boolean;
+    /** Enable drag-and-drop reordering (default true when isSortable). */
+    dnd?: boolean;
+    /** Show up/down manual move buttons. */
+    upDownIcons?: boolean;
+}
+export interface ArrayUIParams {
+    display?: ArrayUIDisplayParams;
+    summaryOverride?: ArrayUIDisplayParams;
+    edit?: ArrayUIEditParams;
+}
+export interface ObjectUIDisplayParams extends PrimitiveUIBaseDisplayParams {
+    /** Direction for rendering properties in display context. */
+    displayMode?: DisplayDirection;
+    /** Max properties shown in display (rest truncated). */
+    maxItems?: number;
+}
+export type ObjectUIEditParams = PrimitiveUIBaseEditParams;
+export interface ObjectUIParams {
+    display?: ObjectUIDisplayParams;
+    summaryOverride?: ObjectUIDisplayParams;
+    edit?: ObjectUIEditParams;
+}
+export declare enum ZodDecorator {
+    IS_DB_INDEXED = "isDBIndexed",
+    IS_FOREIGN_KEY = "isForeignKey",
+    IS_HIDDEN = "isHidden",
+    IS_NOT_EDITABLE = "isNotEditable",
+    IS_SUMMARY_FIELD = "isSummaryField",
+    IS_BACKEND_ONLY = "isBackendOnly",
+    IS_VIRTUAL = "isVirtual",
+    IS_DISCRIMINATOR = "isDiscriminator",
+    EXCLUDE_FROM_CREATE = "excludeFromCreate",
+    EXCLUDE_FROM_UPDATE = "excludeFromUpdate",
+    IS_UNIQUE = "isUnique",
+    IS_PRIMARY_KEY = "isPrimaryKey",
+    TTL = "ttl",
+    IS_PASSWORD = "isPassword",
+    IS_OTP = "isOtp",
+    IS_COLOR = "isColor",
+    IS_DRAFT_RELAXED = "isDraftRelaxed",
+    SHOW_WHEN = "showWhen",
+    SYSTEM_ENUM = "systemEnum",
+    IS_EPHEMERAL = "isEphemeral",
+    IS_CRDT = "isCRDT",
+    BOOLEAN_UI = "booleanUI",
+    STRING_UI = "stringUI",
+    NUMBER_UI = "numberUI",
+    ENUM_UI = "enumUI",
+    DATE_UI = "dateUI",
+    DATETIME_UI = "dateTimeUI",
+    TIME_UI = "timeUI",
+    MONEY_UI = "moneyUI",
+    CODE_UI = "codeUI",
+    FILE_UI = "fileUI",
+    DURATION_UI = "durationUI",
+    PHONE_UI = "phoneUI",
+    BIGDECIMAL_UI = "bigDecimalUI",
+    FOREIGN_KEY_UI = "foreignKeyUI",
+    ARRAY_UI = "arrayUI",
+    OBJECT_UI = "objectUI"
+}
+export type ZodDecorator_ParamsType = {
+    [ZodDecorator.IS_DB_INDEXED]: undefined;
+    [ZodDecorator.IS_FOREIGN_KEY]: ForeignKeyStructuralParams | DecoratorUpdater<ForeignKeyStructuralParams> | undefined;
+    [ZodDecorator.IS_HIDDEN]: HiddenFieldParams | DecoratorUpdater<HiddenFieldParams> | undefined;
+    [ZodDecorator.IS_NOT_EDITABLE]: NotEditableFieldParams | DecoratorUpdater<NotEditableFieldParams> | undefined;
+    [ZodDecorator.IS_SUMMARY_FIELD]: SummaryFieldParams | DecoratorUpdater<SummaryFieldParams> | undefined;
+    [ZodDecorator.IS_BACKEND_ONLY]: BackendOnlyFieldParams | DecoratorUpdater<BackendOnlyFieldParams> | undefined;
+    [ZodDecorator.IS_VIRTUAL]: VirtualFieldParams | DecoratorUpdater<VirtualFieldParams>;
+    [ZodDecorator.IS_DISCRIMINATOR]: DiscriminatorFieldParams | DecoratorUpdater<DiscriminatorFieldParams> | undefined;
+    [ZodDecorator.EXCLUDE_FROM_CREATE]: undefined;
+    [ZodDecorator.EXCLUDE_FROM_UPDATE]: undefined;
+    [ZodDecorator.IS_UNIQUE]: UniqueFieldParams | DecoratorUpdater<UniqueFieldParams> | undefined;
+    [ZodDecorator.IS_PRIMARY_KEY]: undefined;
+    [ZodDecorator.TTL]: TtlFieldParams | DecoratorUpdater<TtlFieldParams>;
+    [ZodDecorator.IS_PASSWORD]: undefined;
+    [ZodDecorator.IS_OTP]: OtpFieldParams | DecoratorUpdater<OtpFieldParams> | undefined;
+    [ZodDecorator.IS_COLOR]: undefined;
+    [ZodDecorator.IS_DRAFT_RELAXED]: undefined;
+    [ZodDecorator.SHOW_WHEN]: ShowWhenParams | DecoratorUpdater<ShowWhenParams>;
+    [ZodDecorator.SYSTEM_ENUM]: string;
+    [ZodDecorator.IS_EPHEMERAL]: undefined;
+    [ZodDecorator.IS_CRDT]: undefined;
+    [ZodDecorator.BOOLEAN_UI]: BooleanUIParams | DecoratorUpdater<BooleanUIParams> | undefined;
+    [ZodDecorator.STRING_UI]: StringUIParams | DecoratorUpdater<StringUIParams> | undefined;
+    [ZodDecorator.NUMBER_UI]: NumberUIParams | DecoratorUpdater<NumberUIParams> | undefined;
+    [ZodDecorator.ENUM_UI]: EnumUIParams | DecoratorUpdater<EnumUIParams> | undefined;
+    [ZodDecorator.DATE_UI]: DateUIParams | DecoratorUpdater<DateUIParams> | undefined;
+    [ZodDecorator.DATETIME_UI]: DateTimeUIParams | DecoratorUpdater<DateTimeUIParams> | undefined;
+    [ZodDecorator.TIME_UI]: TimeUIParams | DecoratorUpdater<TimeUIParams> | undefined;
+    [ZodDecorator.MONEY_UI]: MoneyUIParams | DecoratorUpdater<MoneyUIParams> | undefined;
+    [ZodDecorator.CODE_UI]: CodeUIParams | DecoratorUpdater<CodeUIParams> | undefined;
+    [ZodDecorator.FILE_UI]: FileUIParams | DecoratorUpdater<FileUIParams> | undefined;
+    [ZodDecorator.DURATION_UI]: DurationUIParams | DecoratorUpdater<DurationUIParams> | undefined;
+    [ZodDecorator.PHONE_UI]: PhoneUIParams | DecoratorUpdater<PhoneUIParams> | undefined;
+    [ZodDecorator.BIGDECIMAL_UI]: BigDecimalUIParams | DecoratorUpdater<BigDecimalUIParams> | undefined;
+    [ZodDecorator.FOREIGN_KEY_UI]: ForeignKeyUIParams | DecoratorUpdater<ForeignKeyUIParams> | undefined;
+    [ZodDecorator.ARRAY_UI]: ArrayUIParams | DecoratorUpdater<ArrayUIParams> | undefined;
+    [ZodDecorator.OBJECT_UI]: ObjectUIParams | DecoratorUpdater<ObjectUIParams> | undefined;
+};
+export type ZodDecorator_Types = {
+    [ZodDecorator.IS_DB_INDEXED]: boolean;
+    [ZodDecorator.IS_FOREIGN_KEY]: ForeignKeyStructuralParams | true;
+    [ZodDecorator.IS_HIDDEN]: HiddenFieldParams | true;
+    [ZodDecorator.IS_NOT_EDITABLE]: NotEditableFieldParams | true;
+    [ZodDecorator.IS_SUMMARY_FIELD]: SummaryFieldParams | true;
+    [ZodDecorator.IS_BACKEND_ONLY]: BackendOnlyFieldParams | true;
+    [ZodDecorator.IS_VIRTUAL]: VirtualFieldParams;
+    [ZodDecorator.IS_DISCRIMINATOR]: DiscriminatorFieldParams | true;
+    [ZodDecorator.EXCLUDE_FROM_CREATE]: true;
+    [ZodDecorator.EXCLUDE_FROM_UPDATE]: true;
+    [ZodDecorator.IS_UNIQUE]: UniqueFieldParams | true;
+    [ZodDecorator.IS_PRIMARY_KEY]: true;
+    [ZodDecorator.TTL]: TtlFieldParams;
+    [ZodDecorator.IS_PASSWORD]: true;
+    [ZodDecorator.IS_OTP]: OtpFieldParams | true;
+    [ZodDecorator.IS_COLOR]: true;
+    [ZodDecorator.IS_DRAFT_RELAXED]: true;
+    [ZodDecorator.SHOW_WHEN]: ShowWhenParams;
+    [ZodDecorator.SYSTEM_ENUM]: string;
+    [ZodDecorator.IS_EPHEMERAL]: true;
+    [ZodDecorator.IS_CRDT]: true;
+    [ZodDecorator.BOOLEAN_UI]: BooleanUIParams;
+    [ZodDecorator.STRING_UI]: StringUIParams;
+    [ZodDecorator.NUMBER_UI]: NumberUIParams;
+    [ZodDecorator.ENUM_UI]: EnumUIParams;
+    [ZodDecorator.DATE_UI]: DateUIParams;
+    [ZodDecorator.DATETIME_UI]: DateTimeUIParams;
+    [ZodDecorator.TIME_UI]: TimeUIParams;
+    [ZodDecorator.MONEY_UI]: MoneyUIParams;
+    [ZodDecorator.CODE_UI]: CodeUIParams;
+    [ZodDecorator.FILE_UI]: FileUIParams;
+    [ZodDecorator.DURATION_UI]: DurationUIParams;
+    [ZodDecorator.PHONE_UI]: PhoneUIParams;
+    [ZodDecorator.BIGDECIMAL_UI]: BigDecimalUIParams;
+    [ZodDecorator.FOREIGN_KEY_UI]: ForeignKeyUIParams;
+    [ZodDecorator.ARRAY_UI]: ArrayUIParams;
+    [ZodDecorator.OBJECT_UI]: ObjectUIParams;
+};
+export interface CustomFieldMetadata {
+    [ZodDecorator.IS_DB_INDEXED]?: ZodDecorator_Types[ZodDecorator.IS_DB_INDEXED];
+    [ZodDecorator.IS_FOREIGN_KEY]?: ZodDecorator_Types[ZodDecorator.IS_FOREIGN_KEY];
+    [ZodDecorator.IS_HIDDEN]?: ZodDecorator_Types[ZodDecorator.IS_HIDDEN];
+    [ZodDecorator.IS_NOT_EDITABLE]?: ZodDecorator_Types[ZodDecorator.IS_NOT_EDITABLE];
+    [ZodDecorator.IS_SUMMARY_FIELD]?: ZodDecorator_Types[ZodDecorator.IS_SUMMARY_FIELD];
+    [ZodDecorator.IS_BACKEND_ONLY]?: ZodDecorator_Types[ZodDecorator.IS_BACKEND_ONLY];
+    [ZodDecorator.IS_VIRTUAL]?: ZodDecorator_Types[ZodDecorator.IS_VIRTUAL];
+    [ZodDecorator.IS_DISCRIMINATOR]?: ZodDecorator_Types[ZodDecorator.IS_DISCRIMINATOR];
+    [ZodDecorator.EXCLUDE_FROM_CREATE]?: ZodDecorator_Types[ZodDecorator.EXCLUDE_FROM_CREATE];
+    [ZodDecorator.EXCLUDE_FROM_UPDATE]?: ZodDecorator_Types[ZodDecorator.EXCLUDE_FROM_UPDATE];
+    [ZodDecorator.IS_UNIQUE]?: ZodDecorator_Types[ZodDecorator.IS_UNIQUE];
+    [ZodDecorator.IS_PRIMARY_KEY]?: ZodDecorator_Types[ZodDecorator.IS_PRIMARY_KEY];
+    [ZodDecorator.TTL]?: ZodDecorator_Types[ZodDecorator.TTL];
+    [ZodDecorator.IS_PASSWORD]?: ZodDecorator_Types[ZodDecorator.IS_PASSWORD];
+    [ZodDecorator.IS_OTP]?: ZodDecorator_Types[ZodDecorator.IS_OTP];
+    [ZodDecorator.IS_COLOR]?: ZodDecorator_Types[ZodDecorator.IS_COLOR];
+    [ZodDecorator.IS_DRAFT_RELAXED]?: ZodDecorator_Types[ZodDecorator.IS_DRAFT_RELAXED];
+    [ZodDecorator.SHOW_WHEN]?: ZodDecorator_Types[ZodDecorator.SHOW_WHEN];
+    [ZodDecorator.SYSTEM_ENUM]?: ZodDecorator_Types[ZodDecorator.SYSTEM_ENUM];
+    [ZodDecorator.IS_EPHEMERAL]?: ZodDecorator_Types[ZodDecorator.IS_EPHEMERAL];
+    [ZodDecorator.IS_CRDT]?: ZodDecorator_Types[ZodDecorator.IS_CRDT];
+    [ZodDecorator.BOOLEAN_UI]?: ZodDecorator_Types[ZodDecorator.BOOLEAN_UI];
+    [ZodDecorator.STRING_UI]?: ZodDecorator_Types[ZodDecorator.STRING_UI];
+    [ZodDecorator.NUMBER_UI]?: ZodDecorator_Types[ZodDecorator.NUMBER_UI];
+    [ZodDecorator.ENUM_UI]?: ZodDecorator_Types[ZodDecorator.ENUM_UI];
+    [ZodDecorator.DATE_UI]?: ZodDecorator_Types[ZodDecorator.DATE_UI];
+    [ZodDecorator.DATETIME_UI]?: ZodDecorator_Types[ZodDecorator.DATETIME_UI];
+    [ZodDecorator.TIME_UI]?: ZodDecorator_Types[ZodDecorator.TIME_UI];
+    [ZodDecorator.MONEY_UI]?: ZodDecorator_Types[ZodDecorator.MONEY_UI];
+    [ZodDecorator.CODE_UI]?: ZodDecorator_Types[ZodDecorator.CODE_UI];
+    [ZodDecorator.FILE_UI]?: ZodDecorator_Types[ZodDecorator.FILE_UI];
+    [ZodDecorator.DURATION_UI]?: ZodDecorator_Types[ZodDecorator.DURATION_UI];
+    [ZodDecorator.PHONE_UI]?: ZodDecorator_Types[ZodDecorator.PHONE_UI];
+    [ZodDecorator.BIGDECIMAL_UI]?: ZodDecorator_Types[ZodDecorator.BIGDECIMAL_UI];
+    [ZodDecorator.FOREIGN_KEY_UI]?: ZodDecorator_Types[ZodDecorator.FOREIGN_KEY_UI];
+    [ZodDecorator.ARRAY_UI]?: ZodDecorator_Types[ZodDecorator.ARRAY_UI];
+    [ZodDecorator.OBJECT_UI]?: ZodDecorator_Types[ZodDecorator.OBJECT_UI];
+    /** Range schema type (only present for range schemas) */
+    rangeType?: RangeType;
+    /** Full range schema configuration (only present for range schemas) */
+    rangeConfig?: RangeSchemaMetadata;
+    /** Currency schema configuration (only present for currency schemas) */
+    moneyConfig?: MoneySchemaMetadata;
+    /** BigDecimal schema configuration (only present for bigdecimal schemas) */
+    bigDecimalConfig?: BigDecimalSchemaMetadata;
+    /** Duration schema configuration (only present for duration schemas) */
+    durationConfig?: DurationSchemaMetadata;
+    /** Phone schema configuration (only present for phone schemas) */
+    phoneConfig?: PhoneSchemaMetadata;
+    /** Code schema configuration (only present for code schemas) */
+    codeConfig?: CodeSchemaMetadata;
+    /** File schema configuration (only present for file schemas) */
+    fileConfig?: FileSchemaMetadata;
+    /** Versioned schema configuration (only present for versioned schemas) */
+    versionedConfig?: VersionedSchemaMetadata;
+    /** Versioned foreign key configuration (only present for versioned foreign key schemas) */
+    versionedForeignKeyConfig?: VersionedForeignKeySchemaMetadata;
+}
+type ZodenumInstance = ReturnType<typeof z.enum>;
+export type PrimitiveZodType = z.ZodString | z.ZodNumber | z.ZodBoolean | z.ZodDate | z.ZodEnum<any> | ZodenumInstance | ZodBrandedColorInstance | DecoratedPrimitiveZodType<z.ZodString> | DecoratedPrimitiveZodType<z.ZodNumber> | DecoratedPrimitiveZodType<z.ZodBoolean> | DecoratedPrimitiveZodType<z.ZodDate> | DecoratedPrimitiveZodType<z.ZodEnum<any>> | DecoratedPrimitiveZodType<ZodenumInstance>;
+export type SerializableZodSchema = {
+    type: 'string';
+    optional?: boolean;
+    nullable?: boolean;
+    description?: string;
+    metadata?: CustomFieldMetadata;
+} | {
+    type: 'number';
+    optional?: boolean;
+    nullable?: boolean;
+    metadata?: CustomFieldMetadata;
+} | {
+    type: 'bigint';
+    optional?: boolean;
+    nullable?: boolean;
+    metadata?: CustomFieldMetadata;
+} | {
+    type: 'boolean';
+    optional?: boolean;
+    nullable?: boolean;
+    metadata?: CustomFieldMetadata;
+} | {
+    type: 'date';
+    optional?: boolean;
+    nullable?: boolean;
+    metadata?: CustomFieldMetadata;
+} | {
+    type: 'unknown' | 'any';
+    optional?: boolean;
+    nullable?: boolean;
+    metadata?: CustomFieldMetadata;
+} | {
+    type: 'literal';
+    value: unknown;
+    optional?: boolean;
+    nullable?: boolean;
+    metadata?: CustomFieldMetadata;
+} | {
+    type: 'enum';
+    values: string[];
+    optional?: boolean;
+    nullable?: boolean;
+    metadata?: CustomFieldMetadata;
+} | {
+    type: 'enum';
+    values: string[];
+    optional?: boolean;
+    nullable?: boolean;
+    metadata?: CustomFieldMetadata;
+} | {
+    type: 'array';
+    element: SerializableZodSchema;
+    optional?: boolean;
+    nullable?: boolean;
+    metadata?: CustomFieldMetadata;
+} | {
+    type: 'set';
+    element: SerializableZodSchema;
+    optional?: boolean;
+    nullable?: boolean;
+    metadata?: CustomFieldMetadata;
+} | {
+    type: 'tuple';
+    items: SerializableZodSchema[];
+    optional?: boolean;
+    nullable?: boolean;
+    metadata?: CustomFieldMetadata;
+} | {
+    type: 'record';
+    key: SerializableZodSchema;
+    value: SerializableZodSchema;
+    optional?: boolean;
+    nullable?: boolean;
+    metadata?: CustomFieldMetadata;
+} | {
+    type: 'union';
+    options: SerializableZodSchema[];
+    optional?: boolean;
+    nullable?: boolean;
+    metadata?: CustomFieldMetadata;
+} | {
+    type: 'object';
+    properties: Record<string, SerializableZodSchema>;
+    optional?: boolean;
+    nullable?: boolean;
+    metadata?: CustomFieldMetadata;
+} | {
+    type: 'lazy';
+    optional?: boolean;
+    nullable?: boolean;
+    metadata?: CustomFieldMetadata;
+};
+export {};
+//# sourceMappingURL=zod-decorators.types.d.ts.map