@fluojs/validation 1.0.5 → 1.0.6

package/README.ko.md

@@ -74,12 +74,37 @@ class rule이 실행되기 전에 deterministic `DtoValidationError`로 거부
 DTO 바인딩 메타데이터를 적용한 뒤 `@ValidateNested(...)` 필드를 재귀적으로
 실체화합니다. 어떤 요청 소스를 선택하고 스칼라 값을 변환할지는 transport 또는
 binder가 검증 전에 담당한다는 request-pipeline 계약을 유지합니다.
+Plain 입력 객체를 materialize할 때 안전한 추가 own enumerable 속성은 유지됩니다. `__proto__`, `constructor`,
+`prototype` 같은 위험한 key와 inherited 또는 non-enumerable 속성만 제외합니다.
+이는 `ValidationPipe` 스타일의 whitelist 또는 `forbidNonWhitelisted` 경계가
+아닙니다. 애플리케이션에 해당 정책이 필요하면 materialization 전에 추가 입력을
+명시적으로 shaping하거나 거부해야 합니다.
 선언된 중첩 DTO의 인스턴스인 기존 중첩 값은 그대로 보존하고, plain 중첩 값만
 해당 필드 또는 collection entry 단위로 실체화합니다.
 `materialize()`에 넘기는 루트 값은 plain 객체이거나 대상 DTO 인스턴스여야 합니다.
 문자열, 배열, `null` 같은 잘못된 루트 값은 대상 DTO 생성자나 필드 initializer가
 실행되기 전에 거부됩니다.
 
+### 누락 값과 validation group
+
+일반 field validator는 `null`과 `undefined`를 모두 건너뜁니다. 두 값 중 하나라도
+누락된 필수 field로 실패해야 한다면 `@IsDefined()`를 추가하세요. Optional 계약을
+명시하고 해당 field의 다른 validator를 short-circuit하려면 `@IsOptional()`을
+사용할 수 있습니다.
+
+Validation group은 지원되는 실행 surface가 아닙니다. Decorator option에는
+class-validator 스타일의 `groups` 또는 `always`가 없고, `validate()`와
+`materialize()`도 group 선택을 받지 않습니다. Group 기반 실행을 가정하지 말고
+별도 DTO, mapped DTO helper, `@ValidateIf(...)`, 명시적 class-level validation으로
+workflow 차이를 모델링하세요.
+
+### DTO 상속
+
+Derived DTO는 base DTO의 field-level 및 class-level validation rule을 상속합니다.
+Derived DTO에 validation decorator를 추가하면 derived DTO가 소유하는 metadata가
+생성되며 base DTO의 검증 동작은 바뀌지 않습니다. Mapped DTO helper가 반환한 class를
+확장할 때도 같은 격리가 유지됩니다.
+
 ### 검증 이슈 형태
 
 `DtoValidationError.issues`는 request-pipeline 오류 상세에 사용하는 안정적인 DTO입니다.
@@ -146,6 +171,7 @@ IPv6 모두 허용" 계약을 명시하고 싶을 때 사용할 수 있습니다
 ### 중첩 검증
 
 `@ValidateNested(...)`는 객체 필드, 배열, `Set`, `Map`을 지원합니다. 중첩 DTO path는 validation issue에서 dot/index 표기법을 사용하며, cycle은 안전하게 감지되고 shared reference는 허용됩니다.
+Array, `Set`, `Map` member는 자동으로 검증되고 실체화되므로 nested collection 순회를 활성화하기 위해 `each: true`를 지정할 필요가 없습니다. 기존 DTO를 위해 이 option은 계속 허용됩니다.
 중첩 타입을 지연 해석해야 할 때는 DTO 클래스 자체나 `() => ChildDto`, `function resolveChildDto() { return ChildDto; }` 같은 lazy constructor factory를 전달할 수 있습니다.
 
 ### 암묵적 scalar coercion 없음

package/README.md

@@ -77,6 +77,11 @@ coercion.
 applies DTO binding metadata, and recursively hydrates `@ValidateNested(...)`
 fields. It preserves the request-pipeline contract that transports or binders own
 source selection and scalar conversion before validation runs.
+When materializing a plain input object, safe extra own enumerable properties are retained; only dangerous keys such as
+`__proto__`, `constructor`, and `prototype`, plus inherited or non-enumerable
+properties, are excluded. This is not a `ValidationPipe`-style whitelist or
+`forbidNonWhitelisted` boundary. Shape or reject extra input explicitly before
+materialization when an application requires that policy.
 Existing nested values that are already instances of the declared nested DTO are
 preserved; plain nested values are hydrated only for the affected nested field or
 collection entry.
@@ -84,6 +89,26 @@ The root value passed to `materialize()` must already be a plain object or an
 instance of the target DTO; malformed roots such as strings, arrays, and `null`
 are rejected before the target DTO constructor or field initializers run.
 
+### Missing values and validation groups
+
+Ordinary field validators skip both `null` and `undefined`. Add `@IsDefined()`
+when either value must fail as a missing required field. `@IsOptional()` remains
+useful when the optional contract should be explicit and should short-circuit the
+other validators on that field.
+
+Validation groups are not a supported execution surface. Decorator options do
+not include class-validator-style `groups` or `always`, and `validate()` /
+`materialize()` do not accept a group selection. Model different workflows with
+separate DTOs, mapped DTO helpers, `@ValidateIf(...)`, or explicit class-level
+validation instead of assuming group-based execution.
+
+### DTO inheritance
+
+Derived DTOs inherit field-level and class-level validation rules from their base
+DTO. Adding validation decorators to the derived DTO creates derived-owned
+metadata and does not change how the base DTO validates. The same isolation holds
+when extending a class returned by a mapped DTO helper.
+
 ### Validation issue shape
 
 `DtoValidationError.issues` is a stable DTO for request-pipeline error details:
@@ -150,6 +175,7 @@ contract explicitly while still using the same runtime behavior as `@IsIP()`.
 ### Nested validation
 
 `@ValidateNested(...)` supports object fields, arrays, `Set`, and `Map`. Nested DTO paths use dot/index notation in validation issues, cycles are detected safely, and shared references are allowed.
+Array, `Set`, and `Map` members are validated and materialized automatically; `each: true` is not required to enable nested collection traversal. The option remains accepted for existing DTOs.
 Pass either a DTO class or a lazy constructor factory such as `() => ChildDto` or `function resolveChildDto() { return ChildDto; }` when nested types need deferred resolution.
 
 ### No implicit scalar coercion

package/dist/decorators.d.ts

@@ -1,20 +1,19 @@
 import type { Constructor } from '@fluojs/core';
-import type { CustomClassValidator, CustomFieldValidator, CustomValidationDecoratorOptions, ValidationDecoratorOptions } from '@fluojs/core/internal';
+import type { CustomClassValidator, CustomFieldValidator, CustomValidationDecoratorOptions, ValidationDecoratorOptions } from '@fluojs/core/request-pipeline';
+import { type ClassDecoratorFn, type FieldDecoratorFn } from './internal/decorator-metadata.js';
 import { type StandardSchemaV1Like } from './standard-schema.js';
-type ClassDecoratorFn = (value: Function, context: ClassDecoratorContext) => void;
-type FieldDecoratorFn = <This, Value>(value: undefined, context: ClassFieldDecoratorContext<This, Value>) => void;
 type ValidateClassInput = CustomClassValidator | StandardSchemaV1Like;
 /**
  * Validates that the decorated field is a string value.
  *
- * @param options Optional validation behavior (`message`, `groups`, `always`, `each`).
+ * @param options Optional validation behavior (`message`, `code`, `each`).
  * @returns A field decorator that registers a string validation rule.
  */
 export declare function IsString(options?: ValidationDecoratorOptions): FieldDecoratorFn;
 /**
  * Validates that the decorated field is a number value.
  *
- * @param options Optional validation behavior (`message`, `groups`, `always`, `each`).
+ * @param options Optional validation behavior (`message`, `code`, `each`, `allowNaN`).
  * @returns A field decorator that registers a number validation rule.
  */
 export declare function IsNumber(options?: ValidationDecoratorOptions & {
@@ -23,7 +22,7 @@ export declare function IsNumber(options?: ValidationDecoratorOptions & {
 /**
  * Validates that the decorated field is a boolean value.
  *
- * @param options Optional validation behavior (`message`, `groups`, `always`, `each`).
+ * @param options Optional validation behavior (`message`, `code`, `each`).
  * @returns A field decorator that registers a boolean validation rule.
  */
 export declare function IsBoolean(options?: ValidationDecoratorOptions): FieldDecoratorFn;
@@ -31,21 +30,21 @@ export declare function IsBoolean(options?: ValidationDecoratorOptions): FieldDe
  * Applies subsequent validators only when the condition returns `true`.
  *
  * @param validateIf Predicate that decides whether subsequent validators should run.
- * @param options Optional validation behavior (`message`, `groups`, `always`, `each`).
+ * @param options Optional validation behavior (`message`, `code`, `each`).
  * @returns A field decorator that adds conditional validation execution.
  */
 export declare const ValidateIf: (validateIf: (dto: unknown, value: unknown) => boolean | Promise<boolean>, options?: ValidationDecoratorOptions) => FieldDecoratorFn;
 /**
  * Validates that the decorated field is neither `null` nor `undefined`.
  *
- * @param options Optional validation behavior (`message`, `groups`, `always`, `each`).
+ * @param options Optional validation behavior (`message`, `code`, `each`).
  * @returns A field decorator that registers a required-value rule.
  */
 export declare const IsDefined: (options?: ValidationDecoratorOptions) => FieldDecoratorFn;
 /**
  * Skips subsequent validators when the decorated field is `null` or `undefined`.
  *
- * @param options Optional validation behavior (`message`, `groups`, `always`, `each`).
+ * @param options Optional validation behavior (`message`, `code`, `each`).
  * @returns A field decorator that registers optional-value semantics.
  */
 export declare const IsOptional: (options?: ValidationDecoratorOptions) => FieldDecoratorFn;
@@ -53,7 +52,7 @@ export declare const IsOptional: (options?: ValidationDecoratorOptions) => Field
  * Validates that the decorated field strictly equals the expected value.
  *
  * @param value Expected value to compare against the field value.
- * @param options Optional validation behavior (`message`, `groups`, `always`, `each`).
+ * @param options Optional validation behavior (`message`, `code`, `each`).
  * @returns A field decorator that registers an equality rule.
  */
 export declare const Equals: (value: unknown, options?: ValidationDecoratorOptions) => FieldDecoratorFn;
@@ -61,21 +60,21 @@ export declare const Equals: (value: unknown, options?: ValidationDecoratorOptio
  * Validates that the decorated field does not strictly equal the forbidden value.
  *
  * @param value Forbidden value to compare against the field value.
- * @param options Optional validation behavior (`message`, `groups`, `always`, `each`).
+ * @param options Optional validation behavior (`message`, `code`, `each`).
  * @returns A field decorator that registers an inequality rule.
  */
 export declare const NotEquals: (value: unknown, options?: ValidationDecoratorOptions) => FieldDecoratorFn;
 /**
  * Validates that the decorated field is empty.
  *
- * @param options Optional validation behavior (`message`, `groups`, `always`, `each`).
+ * @param options Optional validation behavior (`message`, `code`, `each`).
  * @returns A field decorator that registers an empty-value rule.
  */
 export declare const IsEmpty: (options?: ValidationDecoratorOptions) => FieldDecoratorFn;
 /**
  * Validates that the decorated field is not empty.
  *
- * @param options Optional validation behavior (`message`, `groups`, `always`, `each`).
+ * @param options Optional validation behavior (`message`, `code`, `each`).
  * @returns A field decorator that registers a non-empty-value rule.
  */
 export declare const IsNotEmpty: (options?: ValidationDecoratorOptions) => FieldDecoratorFn;
@@ -83,7 +82,7 @@ export declare const IsNotEmpty: (options?: ValidationDecoratorOptions) => Field
  * Validates that the decorated field is included in the accepted values.
  *
  * @param values Accepted values for the field.
- * @param options Optional validation behavior (`message`, `groups`, `always`, `each`).
+ * @param options Optional validation behavior (`message`, `code`, `each`).
  * @returns A field decorator that registers an inclusion rule.
  */
 export declare const IsIn: (values: readonly unknown[], options?: ValidationDecoratorOptions) => FieldDecoratorFn;
@@ -91,49 +90,49 @@ export declare const IsIn: (values: readonly unknown[], options?: ValidationDeco
  * Validates that the decorated field is not included in the rejected values.
  *
  * @param values Rejected values for the field.
- * @param options Optional validation behavior (`message`, `groups`, `always`, `each`).
+ * @param options Optional validation behavior (`message`, `code`, `each`).
  * @returns A field decorator that registers an exclusion rule.
  */
 export declare const IsNotIn: (values: readonly unknown[], options?: ValidationDecoratorOptions) => FieldDecoratorFn;
 /**
  * Validates that the decorated field is a `Date` value.
  *
- * @param options Optional validation behavior (`message`, `groups`, `always`, `each`).
+ * @param options Optional validation behavior (`message`, `code`, `each`).
  * @returns A field decorator that registers a date validation rule.
  */
 export declare const IsDate: (options?: ValidationDecoratorOptions) => FieldDecoratorFn;
 /**
  * Validates that the decorated field is an array.
  *
- * @param options Optional validation behavior (`message`, `groups`, `always`, `each`).
+ * @param options Optional validation behavior (`message`, `code`, `each`).
  * @returns A field decorator that registers an array validation rule.
  */
 export declare const IsArray: (options?: ValidationDecoratorOptions) => FieldDecoratorFn;
 /**
  * Validates that the decorated field is an object value.
  *
- * @param options Optional validation behavior (`message`, `groups`, `always`, `each`).
+ * @param options Optional validation behavior (`message`, `code`, `each`).
  * @returns A field decorator that registers an object validation rule.
  */
 export declare const IsObject: (options?: ValidationDecoratorOptions) => FieldDecoratorFn;
 /**
  * Validates that the decorated field is an integer.
  *
- * @param options Optional validation behavior (`message`, `groups`, `always`, `each`).
+ * @param options Optional validation behavior (`message`, `code`, `each`).
  * @returns A field decorator that registers an integer validation rule.
  */
 export declare const IsInt: (options?: ValidationDecoratorOptions) => FieldDecoratorFn;
 /**
  * Validates that the decorated field is a positive number.
  *
- * @param options Optional validation behavior (`message`, `groups`, `always`, `each`).
+ * @param options Optional validation behavior (`message`, `code`, `each`).
  * @returns A field decorator that registers a positive-number rule.
  */
 export declare const IsPositive: (options?: ValidationDecoratorOptions) => FieldDecoratorFn;
 /**
  * Validates that the decorated field is a negative number.
  *
- * @param options Optional validation behavior (`message`, `groups`, `always`, `each`).
+ * @param options Optional validation behavior (`message`, `code`, `each`).
  * @returns A field decorator that registers a negative-number rule.
  */
 export declare const IsNegative: (options?: ValidationDecoratorOptions) => FieldDecoratorFn;
@@ -141,7 +140,7 @@ export declare const IsNegative: (options?: ValidationDecoratorOptions) => Field
  * Validates that the field value is included in the given enum-like set.
  *
  * @param values Enum object or literal value list that defines the accepted set.
- * @param options Optional validation behavior (`message`, `groups`, `always`, `each`).
+ * @param options Optional validation behavior (`message`, `code`, `each`).
  * @returns A field decorator that registers an enum-membership rule.
  */
 export declare function IsEnum(values: Record<string, unknown> | readonly unknown[], options?: ValidationDecoratorOptions): FieldDecoratorFn;
@@ -149,7 +148,7 @@ export declare function IsEnum(values: Record<string, unknown> | readonly unknow
  * Validates that the decorated field is divisible by the given divisor.
  *
  * @param value Divisor used for the numeric divisibility check.
- * @param options Optional validation behavior (`message`, `groups`, `always`, `each`).
+ * @param options Optional validation behavior (`message`, `code`, `each`).
  * @returns A field decorator that registers a divisibility rule.
  */
 export declare const IsDivisibleBy: (value: number, options?: ValidationDecoratorOptions) => FieldDecoratorFn;
@@ -157,7 +156,7 @@ export declare const IsDivisibleBy: (value: number, options?: ValidationDecorato
  * Validates that the decorated field is greater than or equal to the minimum.
  *
  * @param value Inclusive minimum allowed numeric value.
- * @param options Optional validation behavior (`message`, `groups`, `always`, `each`).
+ * @param options Optional validation behavior (`message`, `code`, `each`).
  * @returns A field decorator that registers a minimum-value rule.
  */
 export declare const Min: (value: number, options?: ValidationDecoratorOptions) => FieldDecoratorFn;
@@ -165,7 +164,7 @@ export declare const Min: (value: number, options?: ValidationDecoratorOptions)
  * Validates that the decorated field is less than or equal to the maximum.
  *
  * @param value Inclusive maximum allowed numeric value.
- * @param options Optional validation behavior (`message`, `groups`, `always`, `each`).
+ * @param options Optional validation behavior (`message`, `code`, `each`).
  * @returns A field decorator that registers a maximum-value rule.
  */
 export declare const Max: (value: number, options?: ValidationDecoratorOptions) => FieldDecoratorFn;
@@ -173,7 +172,7 @@ export declare const Max: (value: number, options?: ValidationDecoratorOptions)
  * Validates that the decorated field is on or after the minimum date.
  *
  * @param value Inclusive minimum allowed date.
- * @param options Optional validation behavior (`message`, `groups`, `always`, `each`).
+ * @param options Optional validation behavior (`message`, `code`, `each`).
  * @returns A field decorator that registers a minimum-date rule.
  */
 export declare const MinDate: (value: Date, options?: ValidationDecoratorOptions) => FieldDecoratorFn;
@@ -181,7 +180,7 @@ export declare const MinDate: (value: Date, options?: ValidationDecoratorOptions
  * Validates that the decorated field is on or before the maximum date.
  *
  * @param value Inclusive maximum allowed date.
- * @param options Optional validation behavior (`message`, `groups`, `always`, `each`).
+ * @param options Optional validation behavior (`message`, `code`, `each`).
  * @returns A field decorator that registers a maximum-date rule.
  */
 export declare const MaxDate: (value: Date, options?: ValidationDecoratorOptions) => FieldDecoratorFn;
@@ -189,7 +188,7 @@ export declare const MaxDate: (value: Date, options?: ValidationDecoratorOptions
  * Validates that the decorated field contains the required substring.
  *
  * @param value Required substring.
- * @param options Optional validation behavior (`message`, `groups`, `always`, `each`).
+ * @param options Optional validation behavior (`message`, `code`, `each`).
  * @returns A field decorator that registers a substring-presence rule.
  */
 export declare const Contains: (value: string, options?: ValidationDecoratorOptions) => FieldDecoratorFn;
@@ -197,7 +196,7 @@ export declare const Contains: (value: string, options?: ValidationDecoratorOpti
  * Validates that the decorated field does not contain the forbidden substring.
  *
  * @param value Forbidden substring.
- * @param options Optional validation behavior (`message`, `groups`, `always`, `each`).
+ * @param options Optional validation behavior (`message`, `code`, `each`).
  * @returns A field decorator that registers a substring-exclusion rule.
  */
 export declare const NotContains: (value: string, options?: ValidationDecoratorOptions) => FieldDecoratorFn;
@@ -206,15 +205,16 @@ export declare const NotContains: (value: string, options?: ValidationDecoratorO
  *
  * @param min Minimum inclusive length.
  * @param max Optional maximum inclusive length.
- * @param options Optional validation behavior (`message`, `groups`, `always`, `each`).
+ * @param options Optional validation behavior (`message`, `code`, `each`).
  * @returns A field decorator that registers a bounded-length rule.
  */
 export declare function Length(min: number, max?: number, options?: ValidationDecoratorOptions): FieldDecoratorFn;
 /**
  * Validates a nested DTO instance using the provided constructor.
+ * Arrays, Sets, and Maps are traversed automatically without requiring `each`.
  *
  * @param dto DTO constructor (or lazy constructor factory) used for nested validation/materialization.
- * @param options Optional validation behavior (`message`, `groups`, `always`, `each`).
+ * @param options Optional validation behavior (`message`, `code`, `each`); collection traversal is automatic.
  * @returns A field decorator that registers recursive nested DTO validation.
  */
 export declare function ValidateNested(dto: Constructor | (() => Constructor), options?: ValidationDecoratorOptions): FieldDecoratorFn;
@@ -222,7 +222,7 @@ export declare function ValidateNested(dto: Constructor | (() => Constructor), o
  * Validates that the decorated field has at least the given length.
  *
  * @param value Inclusive minimum string length.
- * @param options Optional validation behavior (`message`, `groups`, `always`, `each`).
+ * @param options Optional validation behavior (`message`, `code`, `each`).
  * @returns A field decorator that registers a minimum-length rule.
  */
 export declare const MinLength: (value: number, options?: ValidationDecoratorOptions) => FieldDecoratorFn;
@@ -230,7 +230,7 @@ export declare const MinLength: (value: number, options?: ValidationDecoratorOpt
  * Validates that the decorated field has at most the given length.
  *
  * @param value Inclusive maximum string length.
- * @param options Optional validation behavior (`message`, `groups`, `always`, `each`).
+ * @param options Optional validation behavior (`message`, `code`, `each`).
  * @returns A field decorator that registers a maximum-length rule.
  */
 export declare const MaxLength: (value: number, options?: ValidationDecoratorOptions) => FieldDecoratorFn;
@@ -246,196 +246,196 @@ export declare function Matches(pattern: RegExp | string, modifiersOrOptions?: s
 /**
  * Validates that the decorated field contains only alphabetic characters.
  *
- * @param options Optional validation behavior (`message`, `groups`, `always`, `each`).
+ * @param options Optional validation behavior (`message`, `code`, `each`).
  * @returns A field decorator that registers an alphabetic string rule.
  */
 export declare const IsAlpha: (options?: ValidationDecoratorOptions) => FieldDecoratorFn;
 /**
  * Validates that the decorated field contains only alphanumeric characters.
  *
- * @param options Optional validation behavior (`message`, `groups`, `always`, `each`).
+ * @param options Optional validation behavior (`message`, `code`, `each`).
  * @returns A field decorator that registers an alphanumeric string rule.
  */
 export declare const IsAlphanumeric: (options?: ValidationDecoratorOptions) => FieldDecoratorFn;
 /**
  * Validates that the decorated field contains only ASCII characters.
  *
- * @param options Optional validation behavior (`message`, `groups`, `always`, `each`).
+ * @param options Optional validation behavior (`message`, `code`, `each`).
  * @returns A field decorator that registers an ASCII string rule.
  */
 export declare const IsAscii: (options?: ValidationDecoratorOptions) => FieldDecoratorFn;
 /**
  * Validates that the decorated field is a Base64 string.
  *
- * @param options Optional validation behavior (`message`, `groups`, `always`, `each`).
+ * @param options Optional validation behavior (`message`, `code`, `each`).
  * @returns A field decorator that registers a Base64 string rule.
  */
 export declare const IsBase64: (options?: ValidationDecoratorOptions) => FieldDecoratorFn;
 /**
  * Validates that the decorated field is a boolean-like string.
  *
- * @param options Optional validation behavior (`message`, `groups`, `always`, `each`).
+ * @param options Optional validation behavior (`message`, `code`, `each`).
  * @returns A field decorator that registers a boolean-string rule.
  */
 export declare const IsBooleanString: (options?: ValidationDecoratorOptions) => FieldDecoratorFn;
 /**
  * Validates that the decorated field is a data URI string.
  *
- * @param options Optional validation behavior (`message`, `groups`, `always`, `each`).
+ * @param options Optional validation behavior (`message`, `code`, `each`).
  * @returns A field decorator that registers a data URI rule.
  */
 export declare const IsDataURI: (options?: ValidationDecoratorOptions) => FieldDecoratorFn;
 /**
  * Validates that the decorated field is a date string.
  *
- * @param options Optional validation behavior (`message`, `groups`, `always`, `each`).
+ * @param options Optional validation behavior (`message`, `code`, `each`).
  * @returns A field decorator that registers a date-string rule.
  */
 export declare const IsDateString: (options?: ValidationDecoratorOptions) => FieldDecoratorFn;
 /**
  * Validates that the decorated field is a decimal string.
  *
- * @param options Optional validation behavior (`message`, `groups`, `always`, `each`).
+ * @param options Optional validation behavior (`message`, `code`, `each`).
  * @returns A field decorator that registers a decimal-string rule.
  */
 export declare const IsDecimal: (options?: ValidationDecoratorOptions) => FieldDecoratorFn;
 /**
  * Validates that the decorated field is an email address.
  *
- * @param options Optional validation behavior (`message`, `groups`, `always`, `each`).
+ * @param options Optional validation behavior (`message`, `code`, `each`).
  * @returns A field decorator that registers an email-address rule.
  */
 export declare const IsEmail: (options?: ValidationDecoratorOptions) => FieldDecoratorFn;
 /**
  * Validates that the decorated field is a fully qualified domain name.
  *
- * @param options Optional validation behavior (`message`, `groups`, `always`, `each`).
+ * @param options Optional validation behavior (`message`, `code`, `each`).
  * @returns A field decorator that registers an FQDN rule.
  */
 export declare const IsFQDN: (options?: ValidationDecoratorOptions) => FieldDecoratorFn;
 /**
  * Validates that the decorated field is a hexadecimal color string.
  *
- * @param options Optional validation behavior (`message`, `groups`, `always`, `each`).
+ * @param options Optional validation behavior (`message`, `code`, `each`).
  * @returns A field decorator that registers a hex-color rule.
  */
 export declare const IsHexColor: (options?: ValidationDecoratorOptions) => FieldDecoratorFn;
 /**
  * Validates that the decorated field is a hexadecimal string.
  *
- * @param options Optional validation behavior (`message`, `groups`, `always`, `each`).
+ * @param options Optional validation behavior (`message`, `code`, `each`).
  * @returns A field decorator that registers a hexadecimal string rule.
  */
 export declare const IsHexadecimal: (options?: ValidationDecoratorOptions) => FieldDecoratorFn;
 /**
  * Validates that the decorated field is a JSON string.
  *
- * @param options Optional validation behavior (`message`, `groups`, `always`, `each`).
+ * @param options Optional validation behavior (`message`, `code`, `each`).
  * @returns A field decorator that registers a JSON-string rule.
  */
 export declare const IsJSON: (options?: ValidationDecoratorOptions) => FieldDecoratorFn;
 /**
  * Validates that the decorated field is a JSON Web Token string.
  *
- * @param options Optional validation behavior (`message`, `groups`, `always`, `each`).
+ * @param options Optional validation behavior (`message`, `code`, `each`).
  * @returns A field decorator that registers a JWT-string rule.
  */
 export declare const IsJWT: (options?: ValidationDecoratorOptions) => FieldDecoratorFn;
 /**
  * Validates that the decorated field is a locale identifier.
  *
- * @param options Optional validation behavior (`message`, `groups`, `always`, `each`).
+ * @param options Optional validation behavior (`message`, `code`, `each`).
  * @returns A field decorator that registers a locale-string rule.
  */
 export declare const IsLocale: (options?: ValidationDecoratorOptions) => FieldDecoratorFn;
 /**
  * Validates that the decorated field is lowercase.
  *
- * @param options Optional validation behavior (`message`, `groups`, `always`, `each`).
+ * @param options Optional validation behavior (`message`, `code`, `each`).
  * @returns A field decorator that registers a lowercase-string rule.
  */
 export declare const IsLowercase: (options?: ValidationDecoratorOptions) => FieldDecoratorFn;
 /**
  * Validates that the decorated field is a magnet URI string.
  *
- * @param options Optional validation behavior (`message`, `groups`, `always`, `each`).
+ * @param options Optional validation behavior (`message`, `code`, `each`).
  * @returns A field decorator that registers a magnet URI rule.
  */
 export declare const IsMagnetURI: (options?: ValidationDecoratorOptions) => FieldDecoratorFn;
 /**
  * Validates that the decorated field is a MIME type string.
  *
- * @param options Optional validation behavior (`message`, `groups`, `always`, `each`).
+ * @param options Optional validation behavior (`message`, `code`, `each`).
  * @returns A field decorator that registers a MIME type rule.
  */
 export declare const IsMimeType: (options?: ValidationDecoratorOptions) => FieldDecoratorFn;
 /**
  * Validates that the decorated field is a MongoDB object ID string.
  *
- * @param options Optional validation behavior (`message`, `groups`, `always`, `each`).
+ * @param options Optional validation behavior (`message`, `code`, `each`).
  * @returns A field decorator that registers a MongoDB object ID rule.
  */
 export declare const IsMongoId: (options?: ValidationDecoratorOptions) => FieldDecoratorFn;
 /**
  * Validates that the decorated field is a numeric string.
  *
- * @param options Optional validation behavior (`message`, `groups`, `always`, `each`).
+ * @param options Optional validation behavior (`message`, `code`, `each`).
  * @returns A field decorator that registers a numeric-string rule.
  */
 export declare const IsNumberString: (options?: ValidationDecoratorOptions) => FieldDecoratorFn;
 /**
  * Validates that the decorated field is a network port string.
  *
- * @param options Optional validation behavior (`message`, `groups`, `always`, `each`).
+ * @param options Optional validation behavior (`message`, `code`, `each`).
  * @returns A field decorator that registers a port-string rule.
  */
 export declare const IsPort: (options?: ValidationDecoratorOptions) => FieldDecoratorFn;
 /**
  * Validates that the decorated field is an RFC 3339 date-time string.
  *
- * @param options Optional validation behavior (`message`, `groups`, `always`, `each`).
+ * @param options Optional validation behavior (`message`, `code`, `each`).
  * @returns A field decorator that registers an RFC 3339 string rule.
  */
 export declare const IsRFC3339: (options?: ValidationDecoratorOptions) => FieldDecoratorFn;
 /**
  * Validates that the decorated field is a semantic version string.
  *
- * @param options Optional validation behavior (`message`, `groups`, `always`, `each`).
+ * @param options Optional validation behavior (`message`, `code`, `each`).
  * @returns A field decorator that registers a semantic-version rule.
  */
 export declare const IsSemVer: (options?: ValidationDecoratorOptions) => FieldDecoratorFn;
 /**
  * Validates that the decorated field is uppercase.
  *
- * @param options Optional validation behavior (`message`, `groups`, `always`, `each`).
+ * @param options Optional validation behavior (`message`, `code`, `each`).
  * @returns A field decorator that registers an uppercase-string rule.
  */
 export declare const IsUppercase: (options?: ValidationDecoratorOptions) => FieldDecoratorFn;
 /**
  * Validates that the decorated field is an ISO 8601 date-time string.
  *
- * @param options Optional validation behavior (`message`, `groups`, `always`, `each`).
+ * @param options Optional validation behavior (`message`, `code`, `each`).
  * @returns A field decorator that registers an ISO 8601 string rule.
  */
 export declare const IsISO8601: (options?: ValidationDecoratorOptions) => FieldDecoratorFn;
 /**
  * Validates that the decorated field is a latitude value.
  *
- * @param options Optional validation behavior (`message`, `groups`, `always`, `each`).
+ * @param options Optional validation behavior (`message`, `code`, `each`).
  * @returns A field decorator that registers a latitude rule.
  */
 export declare const IsLatitude: (options?: ValidationDecoratorOptions) => FieldDecoratorFn;
 /**
  * Validates that the decorated field is a longitude value.
  *
- * @param options Optional validation behavior (`message`, `groups`, `always`, `each`).
+ * @param options Optional validation behavior (`message`, `code`, `each`).
  * @returns A field decorator that registers a longitude rule.
  */
 export declare const IsLongitude: (options?: ValidationDecoratorOptions) => FieldDecoratorFn;
 /**
  * Validates that the decorated field is a latitude/longitude coordinate string.
  *
- * @param options Optional validation behavior (`message`, `groups`, `always`, `each`).
+ * @param options Optional validation behavior (`message`, `code`, `each`).
  * @returns A field decorator that registers a latitude/longitude rule.
  */
 export declare const IsLatLong: (options?: ValidationDecoratorOptions) => FieldDecoratorFn;
@@ -447,7 +447,7 @@ export declare const IsLatLong: (options?: ValidationDecoratorOptions) => FieldD
  * version only.
  *
  * @param version Optional IP version filter (`'4'`, `'6'`, or `'4_or_6'`).
- * @param options Optional validation behavior (`message`, `groups`, `always`, `each`).
+ * @param options Optional validation behavior (`message`, `code`, `each`).
  * @returns A field decorator that registers an IP-address rule.
  */
 export declare function IsIP(version?: '4' | '6' | '4_or_6', options?: ValidationDecoratorOptions): FieldDecoratorFn;
@@ -516,7 +516,7 @@ export declare function IsCurrency(options?: ValidationDecoratorOptions): FieldD
  * Validates that the decorated array contains all required values.
  *
  * @param values Required values that must be present in the array.
- * @param options Optional validation behavior (`message`, `groups`, `always`, `each`).
+ * @param options Optional validation behavior (`message`, `code`, `each`).
  * @returns A field decorator that registers an array-contains rule.
  */
 export declare const ArrayContains: (values: readonly unknown[], options?: ValidationDecoratorOptions) => FieldDecoratorFn;
@@ -524,14 +524,14 @@ export declare const ArrayContains: (values: readonly unknown[], options?: Valid
  * Validates that the decorated array excludes all forbidden values.
  *
  * @param values Forbidden values that must not be present in the array.
- * @param options Optional validation behavior (`message`, `groups`, `always`, `each`).
+ * @param options Optional validation behavior (`message`, `code`, `each`).
  * @returns A field decorator that registers an array-exclusion rule.
  */
 export declare const ArrayNotContains: (values: readonly unknown[], options?: ValidationDecoratorOptions) => FieldDecoratorFn;
 /**
  * Validates that the decorated array is not empty.
  *
- * @param options Optional validation behavior (`message`, `groups`, `always`, `each`).
+ * @param options Optional validation behavior (`message`, `code`, `each`).
  * @returns A field decorator that registers a non-empty-array rule.
  */
 export declare const ArrayNotEmpty: (options?: ValidationDecoratorOptions) => FieldDecoratorFn;
@@ -539,7 +539,7 @@ export declare const ArrayNotEmpty: (options?: ValidationDecoratorOptions) => Fi
  * Validates that the decorated array has at least the given size.
  *
  * @param value Inclusive minimum array length.
- * @param options Optional validation behavior (`message`, `groups`, `always`, `each`).
+ * @param options Optional validation behavior (`message`, `code`, `each`).
  * @returns A field decorator that registers a minimum-array-size rule.
  */
 export declare const ArrayMinSize: (value: number, options?: ValidationDecoratorOptions) => FieldDecoratorFn;
@@ -547,7 +547,7 @@ export declare const ArrayMinSize: (value: number, options?: ValidationDecorator
  * Validates that the decorated array has at most the given size.
  *
  * @param value Inclusive maximum array length.
- * @param options Optional validation behavior (`message`, `groups`, `always`, `each`).
+ * @param options Optional validation behavior (`message`, `code`, `each`).
  * @returns A field decorator that registers a maximum-array-size rule.
  */
 export declare const ArrayMaxSize: (value: number, options?: ValidationDecoratorOptions) => FieldDecoratorFn;