typia 7.4.2 → 7.5.0-dev.20241218

package/src/schemas/metadata/MetadataTemplate.ts

@@ -1,80 +1,80 @@
-import { ClassProperties } from "../../typings/ClassProperties";
-
-import { IMetadataDictionary } from "./IMetadataDictionary";
-import { IMetadataTemplate } from "./IMetadataTemplate";
-import { IMetadataTypeTag } from "./IMetadataTypeTag";
-import { Metadata } from "./Metadata";
-
-export class MetadataTemplate {
-  public readonly row: Metadata[];
-  public readonly tags: IMetadataTypeTag[][];
-
-  private name_?: string;
-
-  private constructor(props: ClassProperties<MetadataTemplate>) {
-    this.row = props.row.map(Metadata.create);
-    this.tags = props.tags;
-  }
-
-  public static create(
-    props: ClassProperties<MetadataTemplate>,
-  ): MetadataTemplate {
-    return new MetadataTemplate(props);
-  }
-
-  public static from(
-    json: IMetadataTemplate,
-    dict: IMetadataDictionary,
-  ): MetadataTemplate {
-    return new MetadataTemplate({
-      row: json.row.map((m) => Metadata.from(m, dict)),
-      tags: json.tags,
-    });
-  }
-
-  public getName(): string {
-    return (this.name_ ??= getName(this));
-  }
-
-  /**
-   * @internal
-   */
-  public getBaseName(): string {
-    return (
-      "`" +
-      this.row
-        .map((child) =>
-          child.isConstant() && child.size() === 1
-            ? child.constants[0]!.values[0]!.value
-            : `$\{${child.getName()}\}`,
-        )
-        .join("")
-        .split("`")
-        .join("\\`") +
-      "`"
-    );
-  }
-
-  public toJSON(): IMetadataTemplate {
-    return {
-      row: this.row.map((m) => m.toJSON()),
-      tags: this.tags,
-    };
-  }
-}
-
-const getName = (template: MetadataTemplate): string => {
-  const base: string = template.getBaseName();
-  if (!template.tags?.length) return base;
-  else if (template.tags.length === 1) {
-    const str: string = [base, ...template.tags[0]!.map((t) => t.name)].join(
-      " & ",
-    );
-    return `(${str})`;
-  }
-  const rows: string[] = template.tags.map((row) => {
-    const str: string = row.map((t) => t.name).join(" & ");
-    return row.length === 1 ? str : `(${str})`;
-  });
-  return `(${base} & (${rows.join(" | ")}))`;
-};
+import { ClassProperties } from "../../typings/ClassProperties";
+
+import { IMetadataDictionary } from "./IMetadataDictionary";
+import { IMetadataTemplate } from "./IMetadataTemplate";
+import { IMetadataTypeTag } from "./IMetadataTypeTag";
+import { Metadata } from "./Metadata";
+
+export class MetadataTemplate {
+  public readonly row: Metadata[];
+  public readonly tags: IMetadataTypeTag[][];
+
+  private name_?: string;
+
+  private constructor(props: ClassProperties<MetadataTemplate>) {
+    this.row = props.row.map(Metadata.create);
+    this.tags = props.tags;
+  }
+
+  public static create(
+    props: ClassProperties<MetadataTemplate>,
+  ): MetadataTemplate {
+    return new MetadataTemplate(props);
+  }
+
+  public static from(
+    json: IMetadataTemplate,
+    dict: IMetadataDictionary,
+  ): MetadataTemplate {
+    return new MetadataTemplate({
+      row: json.row.map((m) => Metadata.from(m, dict)),
+      tags: json.tags,
+    });
+  }
+
+  public getName(): string {
+    return (this.name_ ??= getName(this));
+  }
+
+  /**
+   * @internal
+   */
+  public getBaseName(): string {
+    return (
+      "`" +
+      this.row
+        .map((child) =>
+          child.isConstant() && child.size() === 1
+            ? child.constants[0]!.values[0]!.value
+            : `$\{${child.getName()}\}`,
+        )
+        .join("")
+        .split("`")
+        .join("\\`") +
+      "`"
+    );
+  }
+
+  public toJSON(): IMetadataTemplate {
+    return {
+      row: this.row.map((m) => m.toJSON()),
+      tags: this.tags,
+    };
+  }
+}
+
+const getName = (template: MetadataTemplate): string => {
+  const base: string = template.getBaseName();
+  if (!template.tags?.length) return base;
+  else if (template.tags.length === 1) {
+    const str: string = [base, ...template.tags[0]!.map((t) => t.name)].join(
+      " & ",
+    );
+    return `(${str})`;
+  }
+  const rows: string[] = template.tags.map((row) => {
+    const str: string = row.map((t) => t.name).join(" & ");
+    return row.length === 1 ? str : `(${str})`;
+  });
+  return `(${base} & (${rows.join(" | ")}))`;
+};

package/src/schemas/metadata/MetadataTuple.ts

@@ -1,32 +1,32 @@
-import { ClassProperties } from "../../typings/ClassProperties";
-
-import { IMetadataTuple } from "./IMetadataTuple";
-import { IMetadataTypeTag } from "./IMetadataTypeTag";
-import { MetadataTupleType } from "./MetadataTupleType";
-
-export class MetadataTuple {
-  public readonly type: MetadataTupleType;
-  public readonly tags: IMetadataTypeTag[][];
-
-  /**
-   * @hidden
-   */
-  private constructor(props: ClassProperties<MetadataTuple>) {
-    this.type = props.type;
-    this.tags = props.tags;
-  }
-
-  /**
-   * @internal
-   */
-  public static create(props: ClassProperties<MetadataTuple>): MetadataTuple {
-    return new MetadataTuple(props);
-  }
-
-  public toJSON(): IMetadataTuple {
-    return {
-      name: this.type.name,
-      tags: this.tags.map((row) => row.slice()),
-    };
-  }
-}
+import { ClassProperties } from "../../typings/ClassProperties";
+
+import { IMetadataTuple } from "./IMetadataTuple";
+import { IMetadataTypeTag } from "./IMetadataTypeTag";
+import { MetadataTupleType } from "./MetadataTupleType";
+
+export class MetadataTuple {
+  public readonly type: MetadataTupleType;
+  public readonly tags: IMetadataTypeTag[][];
+
+  /**
+   * @hidden
+   */
+  private constructor(props: ClassProperties<MetadataTuple>) {
+    this.type = props.type;
+    this.tags = props.tags;
+  }
+
+  /**
+   * @internal
+   */
+  public static create(props: ClassProperties<MetadataTuple>): MetadataTuple {
+    return new MetadataTuple(props);
+  }
+
+  public toJSON(): IMetadataTuple {
+    return {
+      name: this.type.name,
+      tags: this.tags.map((row) => row.slice()),
+    };
+  }
+}

package/src/schemas/protobuf/IProtobufProperty.ts

@@ -1,6 +1,6 @@
-import { IProtobufPropertyType } from "./IProtobufPropertyType";
-
-export interface IProtobufProperty {
-  fixed: boolean;
-  union: IProtobufPropertyType[];
-}
+import { IProtobufPropertyType } from "./IProtobufPropertyType";
+
+export interface IProtobufProperty {
+  fixed: boolean;
+  union: IProtobufPropertyType[];
+}

package/src/schemas/protobuf/IProtobufPropertyType.ts

@@ -1,37 +1,37 @@
-import { IProtobufSchema } from "./IProtobufSchema";
-
-export type IProtobufPropertyType =
-  | IProtobufPropertyType.IByte
-  | IProtobufPropertyType.IBoolean
-  | IProtobufPropertyType.IBigint
-  | IProtobufPropertyType.INumber
-  | IProtobufPropertyType.IString
-  | IProtobufPropertyType.IArray
-  | IProtobufPropertyType.IObject
-  | IProtobufPropertyType.IMap;
-export namespace IProtobufPropertyType {
-  export interface IByte extends IProtobufSchema.IByte {
-    index: number;
-  }
-  export interface IBoolean extends IProtobufSchema.IBoolean {
-    index: number;
-  }
-  export interface IBigint extends IProtobufSchema.IBigint {
-    index: number;
-  }
-  export interface INumber extends IProtobufSchema.INumber {
-    index: number;
-  }
-  export interface IString extends IProtobufSchema.IString {
-    index: number;
-  }
-  export interface IArray extends IProtobufSchema.IArray {
-    index: number;
-  }
-  export interface IObject extends IProtobufSchema.IObject {
-    index: number;
-  }
-  export interface IMap extends IProtobufSchema.IMap {
-    index: number;
-  }
-}
+import { IProtobufSchema } from "./IProtobufSchema";
+
+export type IProtobufPropertyType =
+  | IProtobufPropertyType.IByte
+  | IProtobufPropertyType.IBoolean
+  | IProtobufPropertyType.IBigint
+  | IProtobufPropertyType.INumber
+  | IProtobufPropertyType.IString
+  | IProtobufPropertyType.IArray
+  | IProtobufPropertyType.IObject
+  | IProtobufPropertyType.IMap;
+export namespace IProtobufPropertyType {
+  export interface IByte extends IProtobufSchema.IByte {
+    index: number;
+  }
+  export interface IBoolean extends IProtobufSchema.IBoolean {
+    index: number;
+  }
+  export interface IBigint extends IProtobufSchema.IBigint {
+    index: number;
+  }
+  export interface INumber extends IProtobufSchema.INumber {
+    index: number;
+  }
+  export interface IString extends IProtobufSchema.IString {
+    index: number;
+  }
+  export interface IArray extends IProtobufSchema.IArray {
+    index: number;
+  }
+  export interface IObject extends IProtobufSchema.IObject {
+    index: number;
+  }
+  export interface IMap extends IProtobufSchema.IMap {
+    index: number;
+  }
+}

package/src/schemas/protobuf/IProtobufSchema.ts

@@ -1,50 +1,50 @@
-import { MetadataArrayType } from "../metadata/MetadataArrayType";
-import { MetadataMap } from "../metadata/MetadataMap";
-import { MetadataObjectType } from "../metadata/MetadataObjectType";
-
-export type IProtobufSchema =
-  | IProtobufSchema.IByte
-  | IProtobufSchema.IBoolean
-  | IProtobufSchema.IBigint
-  | IProtobufSchema.INumber
-  | IProtobufSchema.IString
-  | IProtobufSchema.IArray
-  | IProtobufSchema.IObject
-  | IProtobufSchema.IMap;
-export namespace IProtobufSchema {
-  export interface IByte {
-    type: "bytes";
-  }
-  export interface IBoolean {
-    type: "bool";
-  }
-  export interface IBigint {
-    type: "bigint";
-    name: "int64" | "uint64";
-  }
-  export interface INumber {
-    type: "number";
-    name: "int32" | "int64" | "uint32" | "uint64" | "float" | "double";
-  }
-  export interface IString {
-    type: "string";
-  }
-  export interface IArray {
-    type: "array";
-    array: MetadataArrayType;
-    value: Exclude<IProtobufSchema, IArray | IMap>;
-  }
-  export interface IObject {
-    type: "object";
-    object: MetadataObjectType;
-  }
-  export interface IMap {
-    type: "map";
-    map: MetadataMap | MetadataObjectType;
-    key:
-      | IProtobufSchema.IBoolean
-      | IProtobufSchema.INumber
-      | IProtobufSchema.IString;
-    value: Exclude<IProtobufSchema, IArray | IMap>;
-  }
-}
+import { MetadataArrayType } from "../metadata/MetadataArrayType";
+import { MetadataMap } from "../metadata/MetadataMap";
+import { MetadataObjectType } from "../metadata/MetadataObjectType";
+
+export type IProtobufSchema =
+  | IProtobufSchema.IByte
+  | IProtobufSchema.IBoolean
+  | IProtobufSchema.IBigint
+  | IProtobufSchema.INumber
+  | IProtobufSchema.IString
+  | IProtobufSchema.IArray
+  | IProtobufSchema.IObject
+  | IProtobufSchema.IMap;
+export namespace IProtobufSchema {
+  export interface IByte {
+    type: "bytes";
+  }
+  export interface IBoolean {
+    type: "bool";
+  }
+  export interface IBigint {
+    type: "bigint";
+    name: "int64" | "uint64";
+  }
+  export interface INumber {
+    type: "number";
+    name: "int32" | "int64" | "uint32" | "uint64" | "float" | "double";
+  }
+  export interface IString {
+    type: "string";
+  }
+  export interface IArray {
+    type: "array";
+    array: MetadataArrayType;
+    value: Exclude<IProtobufSchema, IArray | IMap>;
+  }
+  export interface IObject {
+    type: "object";
+    object: MetadataObjectType;
+  }
+  export interface IMap {
+    type: "map";
+    map: MetadataMap | MetadataObjectType;
+    key:
+      | IProtobufSchema.IBoolean
+      | IProtobufSchema.INumber
+      | IProtobufSchema.IString;
+    value: Exclude<IProtobufSchema, IArray | IMap>;
+  }
+}

package/src/tags/Example.ts

@@ -1,24 +1,24 @@
-import { TagBase } from "./TagBase";
-
-export type Example<
-  Value extends
-    | boolean
-    | bigint
-    | number
-    | string
-    | object
-    | Array<unknown>
-    | null,
-> = TagBase<{
-  target: "boolean" | "bigint" | "number" | "string" | "array" | "object";
-  kind: "example";
-  value: Value;
-  exclusive: true;
-  schema: Value extends bigint
-    ? { example: Numeric<Value> }
-    : { example: Value };
-}>;
-
-type Numeric<T extends bigint> = `${T}` extends `${infer N extends number}`
-  ? N
-  : never;
+import { TagBase } from "./TagBase";
+
+export type Example<
+  Value extends
+    | boolean
+    | bigint
+    | number
+    | string
+    | object
+    | Array<unknown>
+    | null,
+> = TagBase<{
+  target: "boolean" | "bigint" | "number" | "string" | "array" | "object";
+  kind: "example";
+  value: Value;
+  exclusive: true;
+  schema: Value extends bigint
+    ? { example: Numeric<Value> }
+    : { example: Value };
+}>;
+
+type Numeric<T extends bigint> = `${T}` extends `${infer N extends number}`
+  ? N
+  : never;

package/src/tags/Examples.ts

@@ -1,16 +1,16 @@
-import { TagBase } from "./TagBase";
-
-export type Examples<
-  Dict extends Record<
-    string,
-    boolean | bigint | number | string | object | Array<unknown> | null
-  >,
-> = TagBase<{
-  target: "boolean" | "bigint" | "number" | "string" | "array" | "object";
-  kind: "examples";
-  value: Dict;
-  exclusive: true;
-  schema: {
-    examples: Dict;
-  };
-}>;
+import { TagBase } from "./TagBase";
+
+export type Examples<
+  Dict extends Record<
+    string,
+    boolean | bigint | number | string | object | Array<unknown> | null
+  >,
+> = TagBase<{
+  target: "boolean" | "bigint" | "number" | "string" | "array" | "object";
+  kind: "examples";
+  value: Dict;
+  exclusive: true;
+  schema: {
+    examples: Dict;
+  };
+}>;

package/src/tags/Format.ts

@@ -1,50 +1,50 @@
-import type { TagBase } from "./TagBase";
-
-export type Format<Value extends Format.Value> = TagBase<{
-  target: "string";
-  kind: "format";
-  value: Value;
-  validate: `$importInternal("isFormat${PascalizeString<Value>}")($input)`;
-  exclusive: ["format", "pattern"];
-  schema: {
-    format: Value;
-  };
-}>;
-export namespace Format {
-  export type Value =
-    | "byte"
-    | "password"
-    | "regex"
-    | "uuid"
-    | "email"
-    | "hostname"
-    | "idn-email"
-    | "idn-hostname"
-    | "iri"
-    | "iri-reference"
-    | "ipv4"
-    | "ipv6"
-    | "uri"
-    | "uri-reference"
-    | "uri-template"
-    | "url"
-    | "date-time"
-    | "date"
-    | "time"
-    | "duration"
-    | "json-pointer"
-    | "relative-json-pointer";
-}
-
-type PascalizeString<Key extends string> = Key extends `-${infer R}`
-  ? `${PascalizeString<R>}`
-  : Key extends `${infer _F}-${infer _R}`
-    ? PascalizeSnakeString<Key>
-    : Capitalize<Key>;
-type PascalizeSnakeString<Key extends string> = Key extends `-${infer R}`
-  ? PascalizeSnakeString<R>
-  : Key extends `${infer F}${infer M}-${infer R}`
-    ? `${Uppercase<F>}${Lowercase<M>}${PascalizeSnakeString<R>}`
-    : Key extends `${infer F}${infer R}`
-      ? `${Uppercase<F>}${Lowercase<R>}`
-      : Key;
+import type { TagBase } from "./TagBase";
+
+export type Format<Value extends Format.Value> = TagBase<{
+  target: "string";
+  kind: "format";
+  value: Value;
+  validate: `$importInternal("isFormat${PascalizeString<Value>}")($input)`;
+  exclusive: ["format", "pattern"];
+  schema: {
+    format: Value;
+  };
+}>;
+export namespace Format {
+  export type Value =
+    | "byte"
+    | "password"
+    | "regex"
+    | "uuid"
+    | "email"
+    | "hostname"
+    | "idn-email"
+    | "idn-hostname"
+    | "iri"
+    | "iri-reference"
+    | "ipv4"
+    | "ipv6"
+    | "uri"
+    | "uri-reference"
+    | "uri-template"
+    | "url"
+    | "date-time"
+    | "date"
+    | "time"
+    | "duration"
+    | "json-pointer"
+    | "relative-json-pointer";
+}
+
+type PascalizeString<Key extends string> = Key extends `-${infer R}`
+  ? `${PascalizeString<R>}`
+  : Key extends `${infer _F}-${infer _R}`
+    ? PascalizeSnakeString<Key>
+    : Capitalize<Key>;
+type PascalizeSnakeString<Key extends string> = Key extends `-${infer R}`
+  ? PascalizeSnakeString<R>
+  : Key extends `${infer F}${infer M}-${infer R}`
+    ? `${Uppercase<F>}${Lowercase<M>}${PascalizeSnakeString<R>}`
+    : Key extends `${infer F}${infer R}`
+      ? `${Uppercase<F>}${Lowercase<R>}`
+      : Key;

package/src/tags/JsonSchemaPlugin.ts

@@ -1,8 +1,8 @@
-import { TagBase } from "./TagBase";
-
-export type JsonSchemaPlugin<Schema extends object> = TagBase<{
-  target: "string" | "boolean" | "bigint" | "number" | "array" | "object";
-  kind: "jsonPlugin";
-  value: undefined;
-  schema: Schema;
-}>;
+import { TagBase } from "./TagBase";
+
+export type JsonSchemaPlugin<Schema extends object> = TagBase<{
+  target: "string" | "boolean" | "bigint" | "number" | "array" | "object";
+  kind: "jsonPlugin";
+  value: undefined;
+  schema: Schema;
+}>;

package/src/tags/Sequence.ts

@@ -1,10 +1,10 @@
-import { TagBase } from "./TagBase";
-
-export type Sequence<N extends number> = TagBase<{
-  target: "boolean" | "bigint" | "number" | "string" | "array" | "object";
-  kind: "sequence";
-  value: N;
-  schema: {
-    "x-protobuf-sequence": N;
-  };
-}>;
+import { TagBase } from "./TagBase";
+
+export type Sequence<N extends number> = TagBase<{
+  target: "boolean" | "bigint" | "number" | "string" | "array" | "object";
+  kind: "sequence";
+  value: N;
+  schema: {
+    "x-protobuf-sequence": N;
+  };
+}>;