@wildo-ai/zod-decorators 1.1.3 → 1.1.5

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

@@ -44,6 +44,7 @@ export declare enum FieldSchemaType {
     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
+    ADDRESS = "address",// Address schemas created by z_address() - detected by SCHEMA_METADATA.addressConfig
     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"
@@ -67,7 +68,8 @@ export declare enum FormFieldComponent {
     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"
+    PHONE = "phone",// Phone input (country + number, E.164 output)
+    ADDRESS = "address"
 }
 /**
  * Official HTML autocomplete field identifiers.
@@ -197,11 +199,11 @@ export type ResponsiveChromeMode = EditChromeMode | Partial<Record<ViewportBreak
  */
 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;
+    [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.ADDRESS ? FormFieldComponent.ADDRESS : 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;
+    [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.ADDRESS ? FormFieldComponent.ADDRESS : 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> = {
@@ -224,6 +226,7 @@ export declare enum DisplayFieldComponent {
     BIGDECIMAL = "bigdecimal",
     DURATION = "duration",
     PHONE = "phone",
+    ADDRESS = "address",
     RANGE_NUMBER = "range-number",
     RANGE_DATE = "range-date",
     RANGE_TIME = "range-time",
@@ -232,11 +235,11 @@ export declare enum DisplayFieldComponent {
     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;
+    [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.ADDRESS ? DisplayFieldComponent.ADDRESS | 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;
+    [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.ADDRESS ? DisplayFieldComponent.ADDRESS : 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];
 /**
@@ -366,6 +369,50 @@ export declare const BooleanLabellingValue: {
     readonly ACTIVE_INACTIVE: "active/inactive";
 };
 export type BooleanLabellingValue = typeof BooleanLabellingValue[keyof typeof BooleanLabellingValue];
+/**
+ * WHY a field has nothing to show — the semantic half of an empty rendering.
+ *
+ * ## The problem this names
+ *
+ * Every empty value rendered as one em dash, and an em dash says four different things at once.
+ * Administration → Entitlements showed five rows of "—" for a ledger whose emptiness is the CORRECT
+ * and reassuring state ("nothing is overridden"); an SSO pane showed "—" for `verifiedDomains`,
+ * which an operator can fill, beside "—" for `domainVerificationStatus`, which is computed and which
+ * they cannot. A reader cannot tell a working empty ledger from a failed read, nor a field awaiting
+ * their input from one awaiting the system's.
+ *
+ * ## Derived, never authored
+ *
+ * No new decoration: the reason is computed from what the field already declares and from the shape
+ * of the emptiness at the render site. A field added tomorrow is classified without anybody
+ * remembering to mark it — a derivation that is TOTAL over the vocabulary, which a hand-kept list of
+ * marked fields can never be.
+ *
+ * This is the REASON. How it renders — an em dash, the word, nothing at all, a skeleton — stays
+ * `AutoEmptyValue`, a surface policy. Keeping them apart is what lets one surface show "No domains
+ * yet" while a dense table keeps its dash, without either deciding what the emptiness MEANS.
+ */
+export declare const DisplayEmptyReason: {
+    /**
+     * Writable and unset. The operator can fill it, and the word should invite that.
+     * `verifiedDomains` before a domain is claimed.
+     */
+    readonly NOT_SET: "not-set";
+    /**
+     * A COLLECTION with no members — an empty array, object or record. Distinct from `NOT_SET`
+     * because "none yet" is a statement about a list that exists, not about a field nobody has
+     * touched, and because an empty ledger is frequently the correct state rather than a gap.
+     */
+    readonly NONE: "none";
+    /**
+     * Nothing has produced a value, and the operator cannot produce one either — the field is
+     * `.excludeFromUpdate()`, so it is computed, derived or system-owned. `domainVerificationStatus`
+     * with no domain to verify. Rendering this identically to `NOT_SET` is what sends an operator
+     * hunting for a control that does not exist.
+     */
+    readonly NOT_PROVIDED: "not-provided";
+};
+export type DisplayEmptyReason = typeof DisplayEmptyReason[keyof typeof DisplayEmptyReason];
 /**
  * Display mode for boolean fields
  */
@@ -511,6 +558,40 @@ export declare const EnumEditMode: {
     readonly COMBOBOX: "combobox";
 };
 export type EnumEditMode = typeof EnumEditMode[keyof typeof EnumEditMode];
+/**
+ * How an ARRAY OF ENUM VALUES is chosen — the MULTIPLE-selection sibling of {@link EnumEditMode},
+ * and a category of its own rather than a flag on that one.
+ *
+ * Picking several of a closed set is a different act from picking one, and the controls are
+ * different controls: a checkbox group, a multi-select trigger showing chips, a segmented group
+ * where any number of segments can be on. Before this vocabulary existed an array of enums
+ * declared its shape with the SINGLE-select one — `z.array(z.enum(X).enumUI({ edit: { editMode:
+ * EnumEditMode.COMBOBOX } }))` — so one member meant two different controls depending on whether
+ * the field happened to be an array, and the other seven meant nothing at all there. Two meanings
+ * on one enum member is exactly the merge a framework must not make.
+ *
+ * **There is no RADIO twin, and that absence is the point.** A radio group is single-choice by
+ * definition; its multiple form IS the checkbox group, which is why `CHECKBOX` sits where `RADIO`
+ * and `RADIO_ICON_ONLY` sit in the single vocabulary. Every other member is the same control
+ * admitting more than one answer.
+ */
+export declare const EnumMultipleEditMode: {
+    /** A checkbox per option. The default: it shows the whole vocabulary and says "any number" without being told. */
+    readonly CHECKBOX: "checkbox";
+    /** A dropdown whose trigger carries the chosen values as chips. For a vocabulary too long to list inline. */
+    readonly SELECT: "select";
+    /** A segmented group where any number of segments can be on at once. */
+    readonly TOGGLE: "toggle";
+    /** The same group, each segment reduced to its value's glyph. */
+    readonly TOGGLE_ICON_ONLY: "toggle_icon_only";
+    /** One card per option, each independently on or off. */
+    readonly CARD: "card";
+    /** The same grid, each card reduced to its value's glyph. */
+    readonly CARD_ICON_ONLY: "card_icon_only";
+    /** A searchable popover with chips. For a long vocabulary someone types their way through. */
+    readonly COMBOBOX: "combobox";
+};
+export type EnumMultipleEditMode = typeof EnumMultipleEditMode[keyof typeof EnumMultipleEditMode];
 /**
  * Layout direction for form layouts
  */
@@ -947,6 +1028,34 @@ export interface PhoneSchemaOptions {
     /** Default country when parsing numbers without country code */
     defaultCountry?: PhoneCountryCode;
 }
+/**
+ * Metadata stored on address schemas for detection and configuration (#561).
+ *
+ * Country codes are ISO 3166-1 alpha-2 STRINGS rather than the `AvailableCountry` enum on purpose:
+ * that enum lives in `@wildo-ai/presets-components-models`, which depends on this package, so importing
+ * it here would be a cycle — the same reason `PhoneUIParams.displayCountry` is a string.
+ */
+export interface AddressSchemaMetadata {
+    /** Marker for detecting address schemas */
+    isAddress: true;
+    /** Whether the form offers the optional `coordinates` pair for editing. The value may carry one either way. */
+    withCoordinates: boolean;
+    /** Countries a value may name (uppercase ISO 3166-1 alpha-2). Absent means any country. */
+    countriesAllowed?: readonly string[];
+    /** Country pre-selected for a new value (uppercase ISO 3166-1 alpha-2). */
+    defaultCountry?: string;
+}
+/**
+ * Options for creating an address schema via z_address().
+ */
+export interface AddressSchemaOptions {
+    /** Offer the optional `{ latitude, longitude }` pair in the form. Default `false`. */
+    withCoordinates?: boolean;
+    /** Restrict the countries a value may name (ISO 3166-1 alpha-2, any case). */
+    countriesAllowed?: readonly string[];
+    /** Country pre-selected for a new value (ISO 3166-1 alpha-2, any case). Must be allowed when `countriesAllowed` is set. */
+    defaultCountry?: string;
+}
 /**
  * Supported code/programming languages for code schemas.
  */
@@ -1158,10 +1267,16 @@ export interface FileMediaPreviewOptions {
  * EXPRESSES PREFERENCE: list several and the first CONFIGURED one is used. Omit the option entirely
  * and the field resolves to managed storage.
  *
- * ⚠️ **Only `WILDO_MANAGED` and `LOCAL_DIRECTORY` have a provider behind them.** `ONEDRIVE`,
- * `GOOGLE_DRIVE` and `DROPBOX` are declared vocabulary with no implementation — a field naming only
- * those has no configured provider, and startup configuration validation refuses the application
- * rather than letting it serve a field that could never accept an upload.
+ * ⚠️ **`WILDO_MANAGED`, `LOCAL_DIRECTORY` and `GOOGLE_DRIVE` have a provider behind them.** `ONEDRIVE`
+ * and `DROPBOX` are declared vocabulary with no implementation — a field naming only those has no
+ * configured provider, and startup configuration validation refuses the application rather than
+ * letting it serve a field that could never accept an upload.
+ *
+ * `GOOGLE_DRIVE` is a VENDOR storage: the bytes live in a person's Drive and are reached through the
+ * delegated grant of whoever linked (via the Drive picker) or uploaded them, never through an
+ * application credential. It is "configured" when the `google-drive` provider admits a user-owned
+ * connection. A field that accepts it is offered the Drive picker; a local pick on such a field is
+ * uploaded INTO that person's Drive when Drive is the first configured storage in the list.
  *
  * ⚠️ **The target is decided once, when the file is created, and the object never moves.** Changing
  * a field's declared target changes where NEW files go; it does not relocate what is already stored.
@@ -1363,11 +1478,16 @@ export type AudioFormat = typeof AudioFormat[keyof typeof AudioFormat];
  * field's `nature`. `imageConstraints`, `videoConstraints`, `audioConstraints` and
  * `documentConstraints` on the `z_file()` options each take the matching interface below.
  *
- * ⚠️ **A constraint describes what the FIELD ACCEPTS, not what the bytes ARE.** The media type comes
- * from the upload's declared content type; nothing here decodes the file to confirm that something
- * claiming to be an image is one. Treat these as an authoring contract and a form control's
- * behaviour, not as a security boundary — the defence against a mislabelled file is on the SERVING
- * side, where every response carries a no-sniff header and a restrictive content policy.
+ * Image geometry declared with `nature: FileNature.IMAGE` is enforced on multipart uploads by the
+ * default backend image analyzer. Bounds are inclusive positive integer pixels; aspect ratio
+ * permits a 1% relative difference. Measurements use EXIF-oriented, per-frame dimensions from
+ * image headers. Invalid declarations or unavailable/failed analysis refuse the upload.
+ * Metadata-only remote links cannot establish geometry and are refused for these fields; upload
+ * the image bytes instead. Browser cropping prepares an image but cannot authorize its admission.
+ *
+ * Type/extension checks still use the upload's declared MIME type and filename. Header geometry
+ * does not prove complete pixel integrity, content-type authenticity or malware safety. Other
+ * media analyzers retain their optional policies; serving headers and scanning remain separate.
  *
  * ⚠️ **`generateThumbnails` (image, PLURAL) and `generateThumbnail` (video, SINGULAR) are different
  * options on different bags.** The names differ by one letter and do not behave alike; read each
@@ -1527,11 +1647,33 @@ export interface FileGenerationConfig {
     templateId: string;
 }
 /** @wildo_source:part:end zod.decorators.file-generation */
+/**
+ * @wildo_source:part:start zod.decorators.file-readiness-metadata
+ *
+ * Import FileReadiness and FileMetadata from @wildo-ai/zod-decorators.
+ * Standard file fields wait for READY before publishing new references to forms/autosave.
+ * Custom upload clients must inspect the returned metadata, refresh PROCESSING through
+ * the authorized metadata endpoint, and refuse unknown or UNAVAILABLE results.
+ * An HTTP upload success is not evidence that asynchronous scanning finished.
+ *
+ * Attachment readiness, distinct from storage lifecycle and download authorization.
+ * READY may be attached; ATTACHED may be retained by its current parent, not reused elsewhere.
+ * PROCESSING must be refreshed; UNAVAILABLE cannot be newly attached. A downloadable orphan
+ * can still be UNAVAILABLE here. Server authorization remains authoritative for every operation.
+ */
+export declare enum FileReadiness {
+    READY = "ready",
+    PROCESSING = "processing",
+    ATTACHED = "attached",
+    UNAVAILABLE = "unavailable"
+}
 /**
  * File metadata returned by the getMetadata endpoint.
  * This describes the uploaded file's properties.
  */
 export type FileMetadata = {
+    /** Server-derived attachment readiness; never infer this from an upload HTTP success. */
+    readiness: FileReadiness;
     /** Unique file identifier */
     fileId: string;
     /** Original filename */
@@ -1561,6 +1703,7 @@ export type FileMetadata = {
     /** Upload timestamp */
     uploadedAt: Date;
 } & FileUploaderOwnership;
+/** @wildo_source:part:end zod.decorators.file-readiness-metadata */
 /**
  * @wildo_source:part:start zod.decorators.file-vocabularies
  *
@@ -2103,12 +2246,6 @@ export interface UniqueFieldParams {
      * @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;
     /**
      * The custom message reference the API returns when THIS field's unique index is violated.
      *
@@ -2619,7 +2756,16 @@ export interface BooleanUIParams {
 export interface StringUIDisplayParams extends PrimitiveUIBaseDisplayParams {
     /** Display renderer. TEXT | TRUNCATE | MULTILINE | MARKDOWN | COLOR | LINK | EMAIL | BADGE | COPY | SECRET. */
     displayMode?: StringDisplayMode;
-    /** Max characters before truncation (TRUNCATE displayMode only). */
+    /**
+     * Max characters of the value to show (TRUNCATE displayMode only). Beyond it the value is cut
+     * and an ellipsis marks that more exists; the full value stays reachable as the element's
+     * `title`.
+     *
+     * This is a CHARACTER cap and it composes with — rather than replaces — the width cap TRUNCATE
+     * already applies through CSS. A value is clipped by whichever of the two is shorter, so the
+     * cap holds on a wide screen where the container would have had room, which is the point of
+     * declaring it. Leave it unset to keep width as the only axis.
+     */
     truncateLength?: number;
     /**
      * SECRET displayMode only: render the value revealed (not masked) on first
@@ -2671,6 +2817,17 @@ export interface EnumUIDisplayParams extends PrimitiveUIBaseDisplayParams {
 export interface EnumUIEditParams extends PrimitiveUIBaseEditParams {
     /** Edit control. SELECT | RADIO | RADIO_ICON_ONLY | TOGGLE | TOGGLE_ICON_ONLY | CARD | CARD_ICON_ONLY | COMBOBOX. */
     editMode?: EnumEditMode;
+    /**
+     * How this enum is chosen when the FIELD IS AN ARRAY of it (`z.array(z.enum(X))`).
+     *
+     * A separate key from `editMode`, not a reinterpretation of it: the two vocabularies answer
+     * different questions and share no member meaning. Declared on the ELEMENT rather than on the
+     * array because every other per-value presentation decision — `values`, `defaultIcon`,
+     * `defaultColor` — is declared here too, and splitting them would put half an enum's appearance
+     * in `arrayUI()`, which is otherwise about arrayness (sorting, add mode, item framing) and is
+     * shared with arrays of things that are not enums at all.
+     */
+    multipleEditMode?: EnumMultipleEditMode;
     /** Direction of radio/toggle/checkbox group. Renamed from `layout`. */
     editDirection?: LayoutDirection;
     /** Number of grid columns for radio/toggle/card groups. Renamed from `columns`. */
@@ -2687,20 +2844,62 @@ export interface EnumUIParams {
     summaryOverride?: EnumUIDisplayParams;
     edit?: EnumUIEditParams;
 }
-export type DateUIDisplayParams = PrimitiveUIBaseDisplayParams;
+/**
+ * How a date or datetime value is PHRASED. The sibling of `StringDisplayMode` and
+ * `NumberDisplayMode` for the temporal primitives.
+ *
+ * Without it every date in every Wildo application reads identically: a `createdAt` on an audit
+ * row and a `dueDate` on a work item are the same pixels, because the only available rendering
+ * was the regional absolute format. The distinction is not cosmetic — a deadline is understood
+ * against NOW, and a record of when something happened is understood against the calendar.
+ *
+ * `AUTO` is the one to reach for on a field that is both at different times: a due date is a
+ * deadline this week and a historical fact next quarter.
+ */
+export declare const DateDisplayMode: {
+    /** The regional absolute format — what every date rendered as before this vocabulary existed. */
+    readonly ABSOLUTE: "absolute";
+    /** Phrased against now: "tomorrow", "in 3 days", "2 months ago". Always relative, at any distance. */
+    readonly RELATIVE: "relative";
+    /** Relative while the value is near now, absolute once it is not. The near window is a week. */
+    readonly AUTO: "auto";
+};
+export type DateDisplayMode = typeof DateDisplayMode[keyof typeof DateDisplayMode];
+export interface DateUIDisplayParams extends PrimitiveUIBaseDisplayParams {
+    /** How the value is phrased. ABSOLUTE (default) | RELATIVE | AUTO. */
+    displayMode?: DateDisplayMode;
+}
 export type DateUIEditParams = PrimitiveUIBaseEditParams;
 export interface DateUIParams {
     display?: DateUIDisplayParams;
     summaryOverride?: DateUIDisplayParams;
     edit?: DateUIEditParams;
 }
-export type DateTimeUIDisplayParams = PrimitiveUIBaseDisplayParams;
+export interface DateTimeUIDisplayParams extends PrimitiveUIBaseDisplayParams {
+    /**
+     * How the value is phrased. ABSOLUTE (default) | RELATIVE | AUTO.
+     *
+     * A datetime's relative phrasing resolves finer than a date's — "in 20 minutes", "3 hours ago"
+     * — because the value carries a time of day to be precise about. Beyond a day it falls back to
+     * the same calendar units a date uses.
+     */
+    displayMode?: DateDisplayMode;
+}
 export type DateTimeUIEditParams = PrimitiveUIBaseEditParams;
 export interface DateTimeUIParams {
     display?: DateTimeUIDisplayParams;
     summaryOverride?: DateTimeUIDisplayParams;
     edit?: DateTimeUIEditParams;
 }
+/**
+ * DELIBERATELY has no `displayMode`, and this is a statement rather than an omission.
+ *
+ * A time-of-day carries no date, so "relative to now" has no answer: is `09:30` this morning,
+ * tomorrow morning, or the opening hour of a shop that never happens on any particular day? Any
+ * relative phrasing would have to ASSUME a date the value does not hold, and would be confidently
+ * wrong on exactly the fields — opening hours, schedules, recurring slots — that `z.time()` exists
+ * for. A field that wants a relative phrasing is carrying a datetime and should say so.
+ */
 export type TimeUIDisplayParams = PrimitiveUIBaseDisplayParams;
 export type TimeUIEditParams = PrimitiveUIBaseEditParams;
 export interface TimeUIParams {
@@ -2818,6 +3017,36 @@ export interface ForeignKeyUIDisplayParams extends PrimitiveUIBaseDisplayParams
     linkable?: boolean;
     /** Override the preset used to display the referenced resource summary. */
     displayPresetOverride?: string;
+    /**
+     * A SIBLING field on the SAME record holding a readable copy of the referenced row's label —
+     * used when the reference itself cannot be resolved, INSTEAD of printing the raw id.
+     *
+     * ## Why a raw id is not an acceptable fallback
+     *
+     * `ForeignKeyDisplayMode.LABEL` is the default and resolves the referenced row's label. When that
+     * resolution yields nothing the renderer had one option left: print the foreign key. Measured
+     * 2026-09-19 on the Settings hub's member directory — three of four rows showed
+     * `6aaba6b3a2d3b6b0ad61f33e` in the USER column, because those people are invited and have no
+     * `USER_PROFILE` for a label to come from. The fourth, a real user, resolved.
+     *
+     * The readable value was on the row the whole time. `organizationMembers.userEmail` is a
+     * denormalized immutable copy of the linked user's email whose own docstring says it exists so "a
+     * membership row can be read without resolving the user" — exactly this case — and it is
+     * `.isHidden({ display: true })` precisely BECAUSE "the user-facing email is surfaced by resolving
+     * the `userId` reference". When that resolution fails, the design's own premise fails with it and
+     * nothing picks the copy up.
+     *
+     * ## Why this is declared rather than derived
+     *
+     * Nothing in the schema says "this field is a readable copy of that reference". A convention
+     * guessed from the name (`userId` → `userEmail`) would be wrong the first time a resource spells
+     * it differently, and silently. So the relationship is NAMED by the one author who knows it, and
+     * omitting it keeps today's behaviour exactly.
+     *
+     * Read from the record being displayed; a missing or empty sibling falls through to the id as
+     * before, so this can never render less than it does now.
+     */
+    labelFallbackField?: string;
 }
 export interface ForeignKeyUIEditParams extends PrimitiveUIBaseEditParams {
     /**
@@ -3120,6 +3349,7 @@ export declare enum CodePrimitiveKind {
     FILE = "file",
     DURATION = "duration",
     PHONE = "phone",
+    ADDRESS = "address",
     BIGDECIMAL = "bigdecimal",
     UNKNOWN = "unknown"
 }
@@ -3678,15 +3908,37 @@ export interface CustomFieldMetadata {
     durationConfig?: DurationSchemaMetadata;
     /** Phone schema configuration (only present for phone schemas) */
     phoneConfig?: PhoneSchemaMetadata;
+    /** Address schema configuration (only present for address schemas) */
+    addressConfig?: AddressSchemaMetadata;
     /** Code schema configuration (only present for code schemas) */
     codeConfig?: CodeSchemaMetadata;
     /** File schema configuration (only present for file schemas) */
     fileConfig?: FileSchemaMetadata;
+    /**
+     * Set on an UPDATE request DTO object whose keys follow the PATCH write rule — see
+     * `RequestDtoWriteSemantics` and `markPatchRequestDtoObject`. Absent on every other object.
+     */
+    requestDtoWriteSemantics?: RequestDtoWriteSemantics;
     /** Versioned schema configuration (only present for versioned schemas) */
     versionedConfig?: VersionedSchemaMetadata;
     /** Versioned foreign key configuration (only present for versioned foreign key schemas) */
     versionedForeignKeyConfig?: VersionedForeignKeySchemaMetadata;
 }
+/**
+ * How the keys of a request DTO OBJECT are written — the fact a form needs to decide how a field inside it
+ * is cleared (#989).
+ *
+ * Only one member exists because only one rule needs naming. A request DTO's UPDATE root is written PATCH
+ * style: an ABSENT key leaves the stored value untouched, so clearing needs an explicit `null`, and
+ * `toPatchOptionalField` admits that null. An object VALUE nested inside a field (`reminder`, an address)
+ * is written WHOLE instead: the persistence layer clears only top-level fields, a stored nested `null`
+ * would fail the main schema's `.optional()` on the next read, and absence is therefore the only clear.
+ * An object carrying no member is written whole.
+ */
+export declare enum RequestDtoWriteSemantics {
+    /** Absent key = untouched, `null` = clear. The UPDATE request DTO root, and a nested child's update branch. */
+    PATCH = "patch"
+}
 /** @wildo_source:part:end zod.decorators.schema-metadata */
 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>;