typia 9.7.1 → 9.7.2

package/lib/tags/Example.d.mts

@@ -2,34 +2,34 @@ import { TagBase } from "./TagBase";
 /**
  * Example value tag that provides a single example value for documentation.
  *
- * This tag adds an example value to your JSON Schema, which is useful for
- * API documentation, client code generation, and helping developers understand
+ * This tag adds an example value to your JSON Schema, which is useful for API
+ * documentation, client code generation, and helping developers understand
  * expected data formats. The example doesn't affect runtime validation.
  *
  * Use Example for a single representative value. For multiple named examples,
  * use the Examples tag instead.
  *
+ * @author Jeongho Nam - https://github.com/samchon
  * @example
- * ```typescript
- * interface Product {
- *   name: string & Example<"iPhone 15 Pro">;
- *   price: number & Example<999.99>;
- *   inStock: boolean & Example<true>;
- * }
- * ```
+ *   ```typescript
+ *   interface Product {
+ *     name: string & Example<"iPhone 15 Pro">;
+ *     price: number & Example<999.99>;
+ *     inStock: boolean & Example<true>;
+ *   }
+ *   ```;
  *
  * @example
- * ```typescript
- * interface User {
- *   profile: {
- *     bio: string;
- *     tags: string[];
- *   } & Example<{ bio: "Software engineer", tags: ["typescript", "react"] }>;
- * }
- * ```
+ *   ```typescript
+ *   interface User {
+ *     profile: {
+ *       bio: string;
+ *       tags: string[];
+ *     } & Example<{ bio: "Software engineer", tags: ["typescript", "react"] }>;
+ *   }
+ *   ```;
  *
  * @template Value The example value (primitives, objects, arrays, or null)
- * @author Jeongho Nam - https://github.com/samchon
  */
 export type Example<Value extends boolean | bigint | number | string | object | Array<unknown> | null> = TagBase<{
     target: "boolean" | "bigint" | "number" | "string" | "array" | "object";

package/lib/tags/Example.d.ts

@@ -2,34 +2,34 @@ import { TagBase } from "./TagBase";
 /**
  * Example value tag that provides a single example value for documentation.
  *
- * This tag adds an example value to your JSON Schema, which is useful for
- * API documentation, client code generation, and helping developers understand
+ * This tag adds an example value to your JSON Schema, which is useful for API
+ * documentation, client code generation, and helping developers understand
  * expected data formats. The example doesn't affect runtime validation.
  *
  * Use Example for a single representative value. For multiple named examples,
  * use the Examples tag instead.
  *
+ * @author Jeongho Nam - https://github.com/samchon
  * @example
- * ```typescript
- * interface Product {
- *   name: string & Example<"iPhone 15 Pro">;
- *   price: number & Example<999.99>;
- *   inStock: boolean & Example<true>;
- * }
- * ```
+ *   ```typescript
+ *   interface Product {
+ *     name: string & Example<"iPhone 15 Pro">;
+ *     price: number & Example<999.99>;
+ *     inStock: boolean & Example<true>;
+ *   }
+ *   ```;
  *
  * @example
- * ```typescript
- * interface User {
- *   profile: {
- *     bio: string;
- *     tags: string[];
- *   } & Example<{ bio: "Software engineer", tags: ["typescript", "react"] }>;
- * }
- * ```
+ *   ```typescript
+ *   interface User {
+ *     profile: {
+ *       bio: string;
+ *       tags: string[];
+ *     } & Example<{ bio: "Software engineer", tags: ["typescript", "react"] }>;
+ *   }
+ *   ```;
  *
  * @template Value The example value (primitives, objects, arrays, or null)
- * @author Jeongho Nam - https://github.com/samchon
  */
 export type Example<Value extends boolean | bigint | number | string | object | Array<unknown> | null> = TagBase<{
     target: "boolean" | "bigint" | "number" | "string" | "array" | "object";

package/lib/tags/Examples.d.mts

@@ -10,34 +10,34 @@ import { TagBase } from "./TagBase";
  * names and values are the example data. This helps in API documentation and
  * test case generation.
  *
+ * @author Jeongho Nam - https://github.com/samchon
  * @example
- * ```typescript
- * interface PaymentRequest {
- *   amount: number & Examples<{
- *     small: 10.50,
- *     medium: 99.99,
- *     large: 1000.00
- *   }>;
- * }
- * ```
+ *   ```typescript
+ *   interface PaymentRequest {
+ *     amount: number & Examples<{
+ *       small: 10.50,
+ *       medium: 99.99,
+ *       large: 1000.00
+ *     }>;
+ *   }
+ *   ```;
  *
  * @example
- * ```typescript
- * interface UserStatus {
- *   state: string & Examples<{
- *     active: "active",
- *     inactive: "inactive",
- *     suspended: "suspended"
- *   }>;
- *   profile: object & Examples<{
- *     basic: { name: "John", age: 25 },
- *     detailed: { name: "Jane", age: 30, bio: "Developer", verified: true }
- *   }>;
- * }
- * ```
+ *   ```typescript
+ *   interface UserStatus {
+ *     state: string & Examples<{
+ *       active: "active",
+ *       inactive: "inactive",
+ *       suspended: "suspended"
+ *     }>;
+ *     profile: object & Examples<{
+ *       basic: { name: "John", age: 25 },
+ *       detailed: { name: "Jane", age: 30, bio: "Developer", verified: true }
+ *     }>;
+ *   }
+ *   ```;
  *
  * @template Value A record object mapping example names to example values
- * @author Jeongho Nam - https://github.com/samchon
  */
 export type Examples<Value extends Record<string, boolean | bigint | number | string | object | Array<unknown> | null>> = TagBase<{
     target: "boolean" | "bigint" | "number" | "string" | "array" | "object";

package/lib/tags/Examples.d.ts

@@ -10,34 +10,34 @@ import { TagBase } from "./TagBase";
  * names and values are the example data. This helps in API documentation and
  * test case generation.
  *
+ * @author Jeongho Nam - https://github.com/samchon
  * @example
- * ```typescript
- * interface PaymentRequest {
- *   amount: number & Examples<{
- *     small: 10.50,
- *     medium: 99.99,
- *     large: 1000.00
- *   }>;
- * }
- * ```
+ *   ```typescript
+ *   interface PaymentRequest {
+ *     amount: number & Examples<{
+ *       small: 10.50,
+ *       medium: 99.99,
+ *       large: 1000.00
+ *     }>;
+ *   }
+ *   ```;
  *
  * @example
- * ```typescript
- * interface UserStatus {
- *   state: string & Examples<{
- *     active: "active",
- *     inactive: "inactive",
- *     suspended: "suspended"
- *   }>;
- *   profile: object & Examples<{
- *     basic: { name: "John", age: 25 },
- *     detailed: { name: "Jane", age: 30, bio: "Developer", verified: true }
- *   }>;
- * }
- * ```
+ *   ```typescript
+ *   interface UserStatus {
+ *     state: string & Examples<{
+ *       active: "active",
+ *       inactive: "inactive",
+ *       suspended: "suspended"
+ *     }>;
+ *     profile: object & Examples<{
+ *       basic: { name: "John", age: 25 },
+ *       detailed: { name: "Jane", age: 30, bio: "Developer", verified: true }
+ *     }>;
+ *   }
+ *   ```;
  *
  * @template Value A record object mapping example names to example values
- * @author Jeongho Nam - https://github.com/samchon
  */
 export type Examples<Value extends Record<string, boolean | bigint | number | string | object | Array<unknown> | null>> = TagBase<{
     target: "boolean" | "bigint" | "number" | "string" | "array" | "object";

package/lib/tags/ExclusiveMaximum.d.mts

@@ -2,20 +2,23 @@ import { TagBase } from "./TagBase";
 /**
  * Exclusive maximum value constraint tag.
  *
- * Enforces that a numeric value must be strictly less than the specified maximum (not equal).
- * This constraint validates that the input value satisfies: input < maximum.
+ * Enforces that a numeric value must be strictly less than the specified
+ * maximum (not equal). This constraint validates that the input value
+ * satisfies: input < maximum.
  *
  * Example usage:
+ *
  * ```typescript
- * type Discount = number & tags.ExclusiveMaximum<100>;      // Must be < 100
- * type ByteValue = bigint & tags.ExclusiveMaximum<256n>;    // Must be < 256
+ * type Discount = number & tags.ExclusiveMaximum<100>; // Must be < 100
+ * type ByteValue = bigint & tags.ExclusiveMaximum<256n>; // Must be < 256
  * ```
  *
  * Note: This tag is mutually exclusive with Maximum. You cannot apply both
  * ExclusiveMaximum and Maximum constraints to the same property.
  *
- * @template Value - The exclusive maximum value constraint (number or bigint literal)
  * @author Jeongho Nam - https://github.com/samchon
+ * @template Value - The exclusive maximum value constraint (number or bigint
+ *   literal)
  */
 export type ExclusiveMaximum<Value extends number | bigint> = TagBase<{
     target: Value extends bigint ? "bigint" : "number";

package/lib/tags/ExclusiveMaximum.d.ts

@@ -2,20 +2,23 @@ import { TagBase } from "./TagBase";
 /**
  * Exclusive maximum value constraint tag.
  *
- * Enforces that a numeric value must be strictly less than the specified maximum (not equal).
- * This constraint validates that the input value satisfies: input < maximum.
+ * Enforces that a numeric value must be strictly less than the specified
+ * maximum (not equal). This constraint validates that the input value
+ * satisfies: input < maximum.
  *
  * Example usage:
+ *
  * ```typescript
- * type Discount = number & tags.ExclusiveMaximum<100>;      // Must be < 100
- * type ByteValue = bigint & tags.ExclusiveMaximum<256n>;    // Must be < 256
+ * type Discount = number & tags.ExclusiveMaximum<100>; // Must be < 100
+ * type ByteValue = bigint & tags.ExclusiveMaximum<256n>; // Must be < 256
  * ```
  *
  * Note: This tag is mutually exclusive with Maximum. You cannot apply both
  * ExclusiveMaximum and Maximum constraints to the same property.
  *
- * @template Value - The exclusive maximum value constraint (number or bigint literal)
  * @author Jeongho Nam - https://github.com/samchon
+ * @template Value - The exclusive maximum value constraint (number or bigint
+ *   literal)
  */
 export type ExclusiveMaximum<Value extends number | bigint> = TagBase<{
     target: Value extends bigint ? "bigint" : "number";

package/lib/tags/ExclusiveMinimum.d.mts

@@ -2,20 +2,23 @@ import { TagBase } from "./TagBase";
 /**
  * Exclusive minimum value constraint tag.
  *
- * Enforces that a numeric value must be strictly greater than the specified minimum (not equal).
- * This constraint validates that the input value satisfies: input > minimum.
+ * Enforces that a numeric value must be strictly greater than the specified
+ * minimum (not equal). This constraint validates that the input value
+ * satisfies: input > minimum.
  *
  * Example usage:
+ *
  * ```typescript
- * type PositiveNumber = number & tags.ExclusiveMinimum<0>;    // Must be > 0
- * type LargeCount = bigint & tags.ExclusiveMinimum<999n>;     // Must be > 999
+ * type PositiveNumber = number & tags.ExclusiveMinimum<0>; // Must be > 0
+ * type LargeCount = bigint & tags.ExclusiveMinimum<999n>; // Must be > 999
  * ```
  *
  * Note: This tag is mutually exclusive with Minimum. You cannot apply both
  * ExclusiveMinimum and Minimum constraints to the same property.
  *
- * @template Value - The exclusive minimum value constraint (number or bigint literal)
  * @author Jeongho Nam - https://github.com/samchon
+ * @template Value - The exclusive minimum value constraint (number or bigint
+ *   literal)
  */
 export type ExclusiveMinimum<Value extends number | bigint> = TagBase<{
     target: Value extends bigint ? "bigint" : "number";

package/lib/tags/ExclusiveMinimum.d.ts

@@ -2,20 +2,23 @@ import { TagBase } from "./TagBase";
 /**
  * Exclusive minimum value constraint tag.
  *
- * Enforces that a numeric value must be strictly greater than the specified minimum (not equal).
- * This constraint validates that the input value satisfies: input > minimum.
+ * Enforces that a numeric value must be strictly greater than the specified
+ * minimum (not equal). This constraint validates that the input value
+ * satisfies: input > minimum.
  *
  * Example usage:
+ *
  * ```typescript
- * type PositiveNumber = number & tags.ExclusiveMinimum<0>;    // Must be > 0
- * type LargeCount = bigint & tags.ExclusiveMinimum<999n>;     // Must be > 999
+ * type PositiveNumber = number & tags.ExclusiveMinimum<0>; // Must be > 0
+ * type LargeCount = bigint & tags.ExclusiveMinimum<999n>; // Must be > 999
  * ```
  *
  * Note: This tag is mutually exclusive with Minimum. You cannot apply both
  * ExclusiveMinimum and Minimum constraints to the same property.
  *
- * @template Value - The exclusive minimum value constraint (number or bigint literal)
  * @author Jeongho Nam - https://github.com/samchon
+ * @template Value - The exclusive minimum value constraint (number or bigint
+ *   literal)
  */
 export type ExclusiveMinimum<Value extends number | bigint> = TagBase<{
     target: Value extends bigint ? "bigint" : "number";

package/lib/tags/Format.d.mts

@@ -2,24 +2,28 @@ import type { TagBase } from "./TagBase";
 /**
  * String format constraint tag.
  *
- * Validates strings against predefined formats for common use cases.
- * This tag provides built-in validation for standard string formats without
- * needing to write custom regular expressions.
+ * Validates strings against predefined formats for common use cases. This tag
+ * provides built-in validation for standard string formats without needing to
+ * write custom regular expressions.
  *
  * Examples:
- *   type Email = string & Format<"email">;              // user@example.com
- *   type WebURL = string & Format<"url">;               // https://example.com
- *   type DateTime = string & Format<"date-time">;       // 2024-01-15T10:30:00Z
+ *
+ * ```ts
+ * Type Email = string & Format<"email">; // user@example.com
+ * Type WebURL = string & Format<"url">; // https://example.com
+ * Type DateTime = string & Format<"date-time">; // 2024-01-15T10:30:00Z
+ * ```
  *
  * Supported formats include:
+ *
  * - Network: email, url, hostname, ipv4, ipv6, uri
  * - Identifiers: uuid, byte, password
  * - Date/Time: date, time, date-time, duration
  * - Data: json-pointer, regex
  * - Internationalized: idn-email, idn-hostname, iri
  *
- * Note: This tag is mutually exclusive with the Pattern tag. You cannot use both
- * Format and Pattern on the same type.
+ * Note: This tag is mutually exclusive with the Pattern tag. You cannot use
+ * both Format and Pattern on the same type.
  *
  * @author Jeongho Nam - https://github.com/samchon
  */

package/lib/tags/Format.d.ts

@@ -2,24 +2,28 @@ import type { TagBase } from "./TagBase";
 /**
  * String format constraint tag.
  *
- * Validates strings against predefined formats for common use cases.
- * This tag provides built-in validation for standard string formats without
- * needing to write custom regular expressions.
+ * Validates strings against predefined formats for common use cases. This tag
+ * provides built-in validation for standard string formats without needing to
+ * write custom regular expressions.
  *
  * Examples:
- *   type Email = string & Format<"email">;              // user@example.com
- *   type WebURL = string & Format<"url">;               // https://example.com
- *   type DateTime = string & Format<"date-time">;       // 2024-01-15T10:30:00Z
+ *
+ * ```ts
+ * Type Email = string & Format<"email">; // user@example.com
+ * Type WebURL = string & Format<"url">; // https://example.com
+ * Type DateTime = string & Format<"date-time">; // 2024-01-15T10:30:00Z
+ * ```
  *
  * Supported formats include:
+ *
  * - Network: email, url, hostname, ipv4, ipv6, uri
  * - Identifiers: uuid, byte, password
  * - Date/Time: date, time, date-time, duration
  * - Data: json-pointer, regex
  * - Internationalized: idn-email, idn-hostname, iri
  *
- * Note: This tag is mutually exclusive with the Pattern tag. You cannot use both
- * Format and Pattern on the same type.
+ * Note: This tag is mutually exclusive with the Pattern tag. You cannot use
+ * both Format and Pattern on the same type.
  *
  * @author Jeongho Nam - https://github.com/samchon
  */

package/lib/tags/JsonSchemaPlugin.d.mts

@@ -2,28 +2,30 @@ import { TagBase } from "./TagBase";
 /**
  * Injects custom properties into generated JSON Schema.
  *
- * The JsonSchemaPlugin tag allows you to add vendor-specific extensions or custom metadata
- * to the generated JSON Schema output. These properties are merged at the root level of
- * the schema and are commonly used for documentation, tooling hints, or API-specific metadata.
- * The custom properties only affect schema generation and do not impact runtime validation.
+ * The JsonSchemaPlugin tag allows you to add vendor-specific extensions or
+ * custom metadata to the generated JSON Schema output. These properties are
+ * merged at the root level of the schema and are commonly used for
+ * documentation, tooling hints, or API-specific metadata. The custom properties
+ * only affect schema generation and do not impact runtime validation.
  *
+ * @author Jeongho Nam - https://github.com/samchon
  * @example
- * ```typescript
- * // Add OpenAPI vendor extensions
- * type UserId = string & JsonSchemaPlugin<{
- *   "x-internal-id": true,
- *   "x-deprecated": "Use UUID instead"
- * }>;
+ *   ```typescript
+ *   // Add OpenAPI vendor extensions
+ *   type UserId = string & JsonSchemaPlugin<{
+ *     "x-internal-id": true,
+ *     "x-deprecated": "Use UUID instead"
+ *   }>;
  *
- * // Add custom documentation metadata
- * type Price = number & JsonSchemaPlugin<{
- *   "x-format": "currency",
- *   "x-example": 19.99
- * }>;
- * ```
+ *   // Add custom documentation metadata
+ *   type Price = number & JsonSchemaPlugin<{
+ *     "x-format": "currency",
+ *     "x-example": 19.99
+ *   }>;
+ *   ```
  *
- * @template Schema - Object containing custom properties to add to the JSON Schema
- * @author Jeongho Nam - https://github.com/samchon
+ * @template Schema - Object containing custom properties to add to the JSON
+ *   Schema
  */
 export type JsonSchemaPlugin<Schema extends object> = TagBase<{
     target: "string" | "boolean" | "bigint" | "number" | "array" | "object";

package/lib/tags/JsonSchemaPlugin.d.ts

@@ -2,28 +2,30 @@ import { TagBase } from "./TagBase";
 /**
  * Injects custom properties into generated JSON Schema.
  *
- * The JsonSchemaPlugin tag allows you to add vendor-specific extensions or custom metadata
- * to the generated JSON Schema output. These properties are merged at the root level of
- * the schema and are commonly used for documentation, tooling hints, or API-specific metadata.
- * The custom properties only affect schema generation and do not impact runtime validation.
+ * The JsonSchemaPlugin tag allows you to add vendor-specific extensions or
+ * custom metadata to the generated JSON Schema output. These properties are
+ * merged at the root level of the schema and are commonly used for
+ * documentation, tooling hints, or API-specific metadata. The custom properties
+ * only affect schema generation and do not impact runtime validation.
  *
+ * @author Jeongho Nam - https://github.com/samchon
  * @example
- * ```typescript
- * // Add OpenAPI vendor extensions
- * type UserId = string & JsonSchemaPlugin<{
- *   "x-internal-id": true,
- *   "x-deprecated": "Use UUID instead"
- * }>;
+ *   ```typescript
+ *   // Add OpenAPI vendor extensions
+ *   type UserId = string & JsonSchemaPlugin<{
+ *     "x-internal-id": true,
+ *     "x-deprecated": "Use UUID instead"
+ *   }>;
  *
- * // Add custom documentation metadata
- * type Price = number & JsonSchemaPlugin<{
- *   "x-format": "currency",
- *   "x-example": 19.99
- * }>;
- * ```
+ *   // Add custom documentation metadata
+ *   type Price = number & JsonSchemaPlugin<{
+ *     "x-format": "currency",
+ *     "x-example": 19.99
+ *   }>;
+ *   ```
  *
- * @template Schema - Object containing custom properties to add to the JSON Schema
- * @author Jeongho Nam - https://github.com/samchon
+ * @template Schema - Object containing custom properties to add to the JSON
+ *   Schema
  */
 export type JsonSchemaPlugin<Schema extends object> = TagBase<{
     target: "string" | "boolean" | "bigint" | "number" | "array" | "object";

package/lib/tags/MaxItems.d.mts

@@ -2,21 +2,21 @@ import { TagBase } from "./TagBase";
 /**
  * Maximum items validation tag for arrays.
  *
- * Enforces that an array contains at most the specified number of items.
- * This tag is useful for limiting array sizes, such as restricting the
- * number of uploaded files, limiting selections in a form, or capping
- * the size of collections to prevent performance issues.
+ * Enforces that an array contains at most the specified number of items. This
+ * tag is useful for limiting array sizes, such as restricting the number of
+ * uploaded files, limiting selections in a form, or capping the size of
+ * collections to prevent performance issues.
  *
+ * @author Jeongho Nam - https://github.com/samchon
  * @example
- * // Allow maximum 5 file uploads
- * type FileList = File[] & MaxItems<5>;
+ *   // Allow maximum 5 file uploads
+ *   type FileList = File[] & MaxItems<5>;
  *
  * @example
- * // Limit tags to 10 items
- * type ProductTags = string[] & MaxItems<10>;
+ *   // Limit tags to 10 items
+ *   type ProductTags = string[] & MaxItems<10>;
  *
  * @template Value - The maximum number of items allowed
- * @author Jeongho Nam - https://github.com/samchon
  */
 export type MaxItems<Value extends number> = TagBase<{
     target: "array";

package/lib/tags/MaxItems.d.ts

@@ -2,21 +2,21 @@ import { TagBase } from "./TagBase";
 /**
  * Maximum items validation tag for arrays.
  *
- * Enforces that an array contains at most the specified number of items.
- * This tag is useful for limiting array sizes, such as restricting the
- * number of uploaded files, limiting selections in a form, or capping
- * the size of collections to prevent performance issues.
+ * Enforces that an array contains at most the specified number of items. This
+ * tag is useful for limiting array sizes, such as restricting the number of
+ * uploaded files, limiting selections in a form, or capping the size of
+ * collections to prevent performance issues.
  *
+ * @author Jeongho Nam - https://github.com/samchon
  * @example
- * // Allow maximum 5 file uploads
- * type FileList = File[] & MaxItems<5>;
+ *   // Allow maximum 5 file uploads
+ *   type FileList = File[] & MaxItems<5>;
  *
  * @example
- * // Limit tags to 10 items
- * type ProductTags = string[] & MaxItems<10>;
+ *   // Limit tags to 10 items
+ *   type ProductTags = string[] & MaxItems<10>;
  *
  * @template Value - The maximum number of items allowed
- * @author Jeongho Nam - https://github.com/samchon
  */
 export type MaxItems<Value extends number> = TagBase<{
     target: "array";

package/lib/tags/MaxLength.d.mts

@@ -2,12 +2,13 @@ import { TagBase } from "./TagBase";
 /**
  * String maximum length constraint tag.
  *
- * Validates that a string's length is less than or equal to the specified value.
- * This tag enforces an upper limit on the number of characters in a string.
+ * Validates that a string's length is less than or equal to the specified
+ * value. This tag enforces an upper limit on the number of characters in a
+ * string.
  *
- * Examples:
- *   type ShortComment = string & MaxLength<200>;  // Comment limited to 200 characters
- *   type ZipCode = string & MaxLength<10>;        // Zip code with max 10 characters
+ * Examples: type ShortComment = string & MaxLength<200>; // Comment limited to
+ * 200 characters type ZipCode = string & MaxLength<10>; // Zip code with max 10
+ * characters
  *
  * @author Jeongho Nam - https://github.com/samchon
  */

package/lib/tags/MaxLength.d.ts

@@ -2,12 +2,13 @@ import { TagBase } from "./TagBase";
 /**
  * String maximum length constraint tag.
  *
- * Validates that a string's length is less than or equal to the specified value.
- * This tag enforces an upper limit on the number of characters in a string.
+ * Validates that a string's length is less than or equal to the specified
+ * value. This tag enforces an upper limit on the number of characters in a
+ * string.
  *
- * Examples:
- *   type ShortComment = string & MaxLength<200>;  // Comment limited to 200 characters
- *   type ZipCode = string & MaxLength<10>;        // Zip code with max 10 characters
+ * Examples: type ShortComment = string & MaxLength<200>; // Comment limited to
+ * 200 characters type ZipCode = string & MaxLength<10>; // Zip code with max 10
+ * characters
  *
  * @author Jeongho Nam - https://github.com/samchon
  */