typia 9.1.1 → 9.3.0-dev.20250511

package/src/internal/_randomFormatHostname.ts

@@ -1,6 +1,6 @@
-import { _randomString } from "./_randomString";
-
-export const _randomFormatHostname = (): string => `${random(10)}.${random(3)}`;
-
-const random = (length: number) =>
-  _randomString({ type: "string", minLength: length, maxLength: length });
+import { _randomString } from "./_randomString";
+
+export const _randomFormatHostname = (): string => `${random(10)}.${random(3)}`;
+
+const random = (length: number) =>
+  _randomString({ type: "string", minLength: length, maxLength: length });

package/src/internal/_randomFormatIdnEmail.ts

@@ -1,3 +1,3 @@
-import { _randomFormatEmail } from "./_randomFormatEmail";
-
-export const _randomFormatIdnEmail = (): string => _randomFormatEmail();
+import { _randomFormatEmail } from "./_randomFormatEmail";
+
+export const _randomFormatIdnEmail = (): string => _randomFormatEmail();

package/src/internal/_randomFormatIdnHostname.ts

@@ -1,3 +1,3 @@
-import { _randomFormatHostname } from "./_randomFormatHostname";
-
-export const _randomFormatIdnHostname = (): string => _randomFormatHostname();
+import { _randomFormatHostname } from "./_randomFormatHostname";
+
+export const _randomFormatIdnHostname = (): string => _randomFormatHostname();

package/src/internal/_randomFormatIpv4.ts

@@ -1,11 +1,11 @@
-import { _randomInteger } from "./_randomInteger";
-
-export const _randomFormatIpv4 = (): string =>
-  new Array(4).fill(0).map(random).join(".");
-
-const random = () =>
-  _randomInteger({
-    type: "integer",
-    minimum: 0,
-    maximum: 255,
-  });
+import { _randomInteger } from "./_randomInteger";
+
+export const _randomFormatIpv4 = (): string =>
+  new Array(4).fill(0).map(random).join(".");
+
+const random = () =>
+  _randomInteger({
+    type: "integer",
+    minimum: 0,
+    maximum: 255,
+  });

package/src/internal/_randomFormatIpv6.ts

@@ -1,11 +1,11 @@
-import { _randomInteger } from "./_randomInteger";
-
-export const _randomFormatIpv6 = (): string =>
-  new Array(8).fill(0).map(random).join(":");
-
-const random = () =>
-  _randomInteger({
-    type: "integer",
-    minimum: 0,
-    maximum: 65_535,
-  }).toString(16);
+import { _randomInteger } from "./_randomInteger";
+
+export const _randomFormatIpv6 = (): string =>
+  new Array(8).fill(0).map(random).join(":");
+
+const random = () =>
+  _randomInteger({
+    type: "integer",
+    minimum: 0,
+    maximum: 65_535,
+  }).toString(16);

package/src/internal/_randomFormatIri.ts

@@ -1,3 +1,3 @@
-import { _randomFormatUrl } from "./_randomFormatUrl";
-
-export const _randomFormatIri = (): string => _randomFormatUrl();
+import { _randomFormatUrl } from "./_randomFormatUrl";
+
+export const _randomFormatIri = (): string => _randomFormatUrl();

package/src/internal/_randomFormatIriReference.ts

@@ -1,3 +1,3 @@
-import { _randomFormatUrl } from "./_randomFormatUrl";
-
-export const _randomFormatIriReference = (): string => _randomFormatUrl();
+import { _randomFormatUrl } from "./_randomFormatUrl";
+
+export const _randomFormatIriReference = (): string => _randomFormatUrl();

package/src/internal/_randomFormatJsonPointer.ts

@@ -1,7 +1,7 @@
-import { _randomString } from "./_randomString";
-
-export const _randomFormatJsonPointer = (): string =>
-  `/components/schemas/${random()}`;
-
-const random = () =>
-  _randomString({ type: "string", minLength: 10, maxLength: 10 });
+import { _randomString } from "./_randomString";
+
+export const _randomFormatJsonPointer = (): string =>
+  `/components/schemas/${random()}`;
+
+const random = () =>
+  _randomString({ type: "string", minLength: 10, maxLength: 10 });

package/src/internal/_randomFormatPassword.ts

@@ -1,8 +1,8 @@
-import { _randomString } from "./_randomString";
-
-export const _randomFormatPassword = (): string =>
-  _randomString({
-    type: "string",
-    minLength: 4,
-    maxLength: 16,
-  });
+import { _randomString } from "./_randomString";
+
+export const _randomFormatPassword = (): string =>
+  _randomString({
+    type: "string",
+    minLength: 4,
+    maxLength: 16,
+  });

package/src/internal/_randomFormatRegex.ts

@@ -1,4 +1,4 @@
-export const _randomFormatRegex = (): string => FIXED;
-
-const FIXED =
-  "/^(?:(?:25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)\\.){3}(?:25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)$/";
+export const _randomFormatRegex = (): string => FIXED;
+
+const FIXED =
+  "/^(?:(?:25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)\\.){3}(?:25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)$/";

package/src/internal/_randomFormatRelativeJsonPointer.ts

@@ -1,8 +1,8 @@
-import { _randomInteger } from "./_randomInteger";
-
-export const _randomFormatRelativeJsonPointer = (): string =>
-  `${_randomInteger({
-    type: "integer",
-    minimum: 0,
-    maximum: 10,
-  })}#`;
+import { _randomInteger } from "./_randomInteger";
+
+export const _randomFormatRelativeJsonPointer = (): string =>
+  `${_randomInteger({
+    type: "integer",
+    minimum: 0,
+    maximum: 10,
+  })}#`;

package/src/internal/_randomFormatTime.ts

@@ -1,14 +1,14 @@
-import { _randomInteger } from "./_randomInteger";
-
-export const _randomFormatTime = (): string =>
-  new Date(
-    _randomInteger({
-      type: "integer",
-      minimum: 0,
-      maximum: DAY,
-    }),
-  )
-    .toISOString()
-    .substring(11);
-
-const DAY = 86_400_000;
+import { _randomInteger } from "./_randomInteger";
+
+export const _randomFormatTime = (): string =>
+  new Date(
+    _randomInteger({
+      type: "integer",
+      minimum: 0,
+      maximum: DAY,
+    }),
+  )
+    .toISOString()
+    .substring(11);
+
+const DAY = 86_400_000;

package/src/internal/_randomFormatUri.ts

@@ -1,3 +1,3 @@
-import { _randomFormatUrl } from "./_randomFormatUrl";
-
-export const _randomFormatUri = (): string => _randomFormatUrl();
+import { _randomFormatUrl } from "./_randomFormatUrl";
+
+export const _randomFormatUri = (): string => _randomFormatUrl();

package/src/internal/_randomFormatUriReference.ts

@@ -1,3 +1,3 @@
-import { _randomFormatUrl } from "./_randomFormatUrl";
-
-export const _randomFormatUriReference = (): string => _randomFormatUrl();
+import { _randomFormatUrl } from "./_randomFormatUrl";
+
+export const _randomFormatUriReference = (): string => _randomFormatUrl();

package/src/internal/_randomFormatUriTemplate.ts

@@ -1,3 +1,3 @@
-import { _randomFormatUrl } from "./_randomFormatUrl";
-
-export const _randomFormatUriTemplate = (): string => _randomFormatUrl();
+import { _randomFormatUrl } from "./_randomFormatUrl";
+
+export const _randomFormatUriTemplate = (): string => _randomFormatUrl();

package/src/internal/_randomFormatUrl.ts

@@ -1,11 +1,11 @@
-import { _randomString } from "./_randomString";
-
-export const _randomFormatUrl = (): string =>
-  `https://${random(10)}.${random(3)}`;
-
-const random = (length: number) =>
-  _randomString({
-    type: "string",
-    minLength: length,
-    maxLength: length,
-  });
+import { _randomString } from "./_randomString";
+
+export const _randomFormatUrl = (): string =>
+  `https://${random(10)}.${random(3)}`;
+
+const random = (length: number) =>
+  _randomString({
+    type: "string",
+    minLength: length,
+    maxLength: length,
+  });

package/src/internal/_randomFormatUuid.ts

@@ -1,6 +1,6 @@
-export const _randomFormatUuid = (): string =>
-  "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
-    const r = (Math.random() * 16) | 0;
-    const v = c === "x" ? r : (r & 0x3) | 0x8;
-    return v.toString(16);
-  });
+export const _randomFormatUuid = (): string =>
+  "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
+    const r = (Math.random() * 16) | 0;
+    const v = c === "x" ? r : (r & 0x3) | 0x8;
+    return v.toString(16);
+  });

package/src/internal/_randomInteger.ts

@@ -1,53 +1,53 @@
-import { OpenApi } from "@samchon/openapi";
-
-export const _randomInteger = (schema: OpenApi.IJsonSchema.IInteger) => {
-  let minimum: number =
-    schema.minimum ??
-    schema.exclusiveMinimum ??
-    (schema.multipleOf ?? 1) *
-      (schema.maximum === undefined && schema.exclusiveMaximum === undefined
-        ? 0
-        : (schema.maximum ?? schema.exclusiveMaximum!) - 100);
-  if (schema.exclusiveMinimum !== undefined) minimum++;
-  let maximum: number =
-    schema.maximum ??
-    schema.exclusiveMaximum ??
-    (schema.multipleOf ?? 1) *
-      (schema.minimum === undefined && schema.exclusiveMinimum === undefined
-        ? 100
-        : (schema.minimum ?? schema.exclusiveMinimum!) + 100);
-  if (schema.exclusiveMaximum !== undefined) maximum--;
-  if (minimum > maximum)
-    throw new Error("Minimum value is greater than maximum value.");
-  return schema.multipleOf === undefined
-    ? scalar({
-        minimum,
-        maximum,
-      })
-    : multiple({
-        minimum,
-        maximum,
-        multipleOf: schema.multipleOf,
-      });
-};
-
-const scalar = (p: { minimum: number; maximum: number }): number =>
-  Math.floor(Math.random() * (p.maximum - p.minimum + 1)) + p.minimum;
-
-const multiple = (p: {
-  minimum: number;
-  maximum: number;
-  multipleOf: number;
-}): number => {
-  const minimum = Math.ceil(p.minimum / p.multipleOf) * p.multipleOf;
-  const maximum = Math.floor(p.maximum / p.multipleOf) * p.multipleOf;
-  if (minimum > maximum)
-    throw new Error(
-      "The range of the integer is smaller than the multipleOf value.",
-    );
-  const value: number = scalar({
-    minimum,
-    maximum,
-  });
-  return value - (value % p.multipleOf);
-};
+import { OpenApi } from "@samchon/openapi";
+
+export const _randomInteger = (schema: OpenApi.IJsonSchema.IInteger) => {
+  let minimum: number =
+    schema.minimum ??
+    schema.exclusiveMinimum ??
+    (schema.multipleOf ?? 1) *
+      (schema.maximum === undefined && schema.exclusiveMaximum === undefined
+        ? 0
+        : (schema.maximum ?? schema.exclusiveMaximum!) - 100);
+  if (schema.exclusiveMinimum !== undefined) minimum++;
+  let maximum: number =
+    schema.maximum ??
+    schema.exclusiveMaximum ??
+    (schema.multipleOf ?? 1) *
+      (schema.minimum === undefined && schema.exclusiveMinimum === undefined
+        ? 100
+        : (schema.minimum ?? schema.exclusiveMinimum!) + 100);
+  if (schema.exclusiveMaximum !== undefined) maximum--;
+  if (minimum > maximum)
+    throw new Error("Minimum value is greater than maximum value.");
+  return schema.multipleOf === undefined
+    ? scalar({
+        minimum,
+        maximum,
+      })
+    : multiple({
+        minimum,
+        maximum,
+        multipleOf: schema.multipleOf,
+      });
+};
+
+const scalar = (p: { minimum: number; maximum: number }): number =>
+  Math.floor(Math.random() * (p.maximum - p.minimum + 1)) + p.minimum;
+
+const multiple = (p: {
+  minimum: number;
+  maximum: number;
+  multipleOf: number;
+}): number => {
+  const minimum = Math.ceil(p.minimum / p.multipleOf) * p.multipleOf;
+  const maximum = Math.floor(p.maximum / p.multipleOf) * p.multipleOf;
+  if (minimum > maximum)
+    throw new Error(
+      "The range of the integer is smaller than the multipleOf value.",
+    );
+  const value: number = scalar({
+    minimum,
+    maximum,
+  });
+  return value - (value % p.multipleOf);
+};

package/src/internal/_randomNumber.ts

@@ -1,80 +1,80 @@
-import { OpenApi } from "@samchon/openapi";
-
-export const _randomNumber = (schema: OpenApi.IJsonSchema.INumber): number => {
-  const minimum: number =
-    schema.minimum ??
-    schema.exclusiveMinimum ??
-    (schema.multipleOf ?? 1) *
-      (schema.maximum === undefined && schema.exclusiveMaximum === undefined
-        ? 0
-        : (schema.maximum ?? schema.exclusiveMaximum!) - 100);
-  const maximum: number =
-    schema.maximum ??
-    schema.exclusiveMaximum ??
-    (schema.multipleOf ?? 1) *
-      (schema.minimum === undefined && schema.exclusiveMinimum === undefined
-        ? 100
-        : (schema.minimum ?? schema.exclusiveMinimum!) + 100);
-  if (minimum > maximum)
-    throw new Error("Minimum value is greater than maximum value.");
-  return schema.multipleOf === undefined
-    ? scalar({
-        minimum,
-        maximum,
-        exclusiveMinimum: schema.exclusiveMinimum !== undefined,
-        exclusiveMaximum: schema.exclusiveMaximum !== undefined,
-      })
-    : multiple({
-        minimum,
-        maximum,
-        multipleOf: schema.multipleOf,
-        exclusiveMinimum: schema.exclusiveMinimum !== undefined,
-        exclusiveMaximum: schema.exclusiveMaximum !== undefined,
-      });
-};
-
-const scalar = (p: {
-  minimum: number;
-  maximum: number;
-  exclusiveMinimum?: boolean;
-  exclusiveMaximum?: boolean;
-}): number => {
-  if (p.minimum === p.maximum && (p.exclusiveMinimum || p.exclusiveMaximum))
-    throw new Error(
-      p.exclusiveMinimum
-        ? "Exclusive minimum value equals maximum value."
-        : "Exclusive maximum value equals minimum value.",
-    );
-  while (true) {
-    const value: number = Math.random() * (p.maximum - p.minimum) + p.minimum;
-    if (p.exclusiveMinimum && value === p.minimum) continue;
-    else if (p.exclusiveMaximum && value === p.maximum) continue;
-    return value;
-  }
-};
-
-const multiple = (p: {
-  minimum: number;
-  maximum: number;
-  multipleOf: number;
-  exclusiveMinimum?: boolean;
-  exclusiveMaximum?: boolean;
-}): number => {
-  let minimum = Math.ceil(p.minimum / p.multipleOf) * p.multipleOf;
-  let maximum = Math.floor(p.maximum / p.multipleOf) * p.multipleOf;
-  if (p.exclusiveMinimum === true && minimum % p.multipleOf === 0)
-    minimum += p.multipleOf;
-  if (p.exclusiveMaximum === true && maximum % p.multipleOf === 0)
-    maximum -= p.multipleOf;
-  if (minimum > maximum)
-    throw new Error(
-      "The range of the integer is smaller than the multipleOf value.",
-    );
-  const value: number = scalar({
-    minimum,
-    maximum,
-    exclusiveMinimum: p.exclusiveMinimum,
-    exclusiveMaximum: p.exclusiveMaximum,
-  });
-  return value - (value % p.multipleOf);
-};
+import { OpenApi } from "@samchon/openapi";
+
+export const _randomNumber = (schema: OpenApi.IJsonSchema.INumber): number => {
+  const minimum: number =
+    schema.minimum ??
+    schema.exclusiveMinimum ??
+    (schema.multipleOf ?? 1) *
+      (schema.maximum === undefined && schema.exclusiveMaximum === undefined
+        ? 0
+        : (schema.maximum ?? schema.exclusiveMaximum!) - 100);
+  const maximum: number =
+    schema.maximum ??
+    schema.exclusiveMaximum ??
+    (schema.multipleOf ?? 1) *
+      (schema.minimum === undefined && schema.exclusiveMinimum === undefined
+        ? 100
+        : (schema.minimum ?? schema.exclusiveMinimum!) + 100);
+  if (minimum > maximum)
+    throw new Error("Minimum value is greater than maximum value.");
+  return schema.multipleOf === undefined
+    ? scalar({
+        minimum,
+        maximum,
+        exclusiveMinimum: schema.exclusiveMinimum !== undefined,
+        exclusiveMaximum: schema.exclusiveMaximum !== undefined,
+      })
+    : multiple({
+        minimum,
+        maximum,
+        multipleOf: schema.multipleOf,
+        exclusiveMinimum: schema.exclusiveMinimum !== undefined,
+        exclusiveMaximum: schema.exclusiveMaximum !== undefined,
+      });
+};
+
+const scalar = (p: {
+  minimum: number;
+  maximum: number;
+  exclusiveMinimum?: boolean;
+  exclusiveMaximum?: boolean;
+}): number => {
+  if (p.minimum === p.maximum && (p.exclusiveMinimum || p.exclusiveMaximum))
+    throw new Error(
+      p.exclusiveMinimum
+        ? "Exclusive minimum value equals maximum value."
+        : "Exclusive maximum value equals minimum value.",
+    );
+  while (true) {
+    const value: number = Math.random() * (p.maximum - p.minimum) + p.minimum;
+    if (p.exclusiveMinimum && value === p.minimum) continue;
+    else if (p.exclusiveMaximum && value === p.maximum) continue;
+    return value;
+  }
+};
+
+const multiple = (p: {
+  minimum: number;
+  maximum: number;
+  multipleOf: number;
+  exclusiveMinimum?: boolean;
+  exclusiveMaximum?: boolean;
+}): number => {
+  let minimum = Math.ceil(p.minimum / p.multipleOf) * p.multipleOf;
+  let maximum = Math.floor(p.maximum / p.multipleOf) * p.multipleOf;
+  if (p.exclusiveMinimum === true && minimum % p.multipleOf === 0)
+    minimum += p.multipleOf;
+  if (p.exclusiveMaximum === true && maximum % p.multipleOf === 0)
+    maximum -= p.multipleOf;
+  if (minimum > maximum)
+    throw new Error(
+      "The range of the integer is smaller than the multipleOf value.",
+    );
+  const value: number = scalar({
+    minimum,
+    maximum,
+    exclusiveMinimum: p.exclusiveMinimum,
+    exclusiveMaximum: p.exclusiveMaximum,
+  });
+  return value - (value % p.multipleOf);
+};

package/src/internal/_randomPattern.ts

@@ -1,10 +1,10 @@
-import RandExp from "randexp";
-
-export const _randomPattern = (regex: RegExp): string => {
-  const r: RandExp = new RandExp(regex);
-  for (let i: number = 0; i < 10; ++i) {
-    const str: string = r.gen();
-    if (regex.test(str)) return str;
-  }
-  return r.gen();
-};
+import RandExp from "randexp";
+
+export const _randomPattern = (regex: RegExp): string => {
+  const r: RandExp = new RandExp(regex);
+  for (let i: number = 0; i < 10; ++i) {
+    const str: string = r.gen();
+    if (regex.test(str)) return str;
+  }
+  return r.gen();
+};

package/src/internal/_randomPick.ts

@@ -1,9 +1,9 @@
-import { _randomInteger } from "./_randomInteger";
-
-export const _randomPick = <T>(array: T[]): T => array[random(array)]!;
-const random = <T>(array: T[]) =>
-  _randomInteger({
-    type: "integer",
-    minimum: 0,
-    maximum: array.length - 1,
-  });
+import { _randomInteger } from "./_randomInteger";
+
+export const _randomPick = <T>(array: T[]): T => array[random(array)]!;
+const random = <T>(array: T[]) =>
+  _randomInteger({
+    type: "integer",
+    minimum: 0,
+    maximum: array.length - 1,
+  });

package/src/internal/_randomString.ts

@@ -1,24 +1,24 @@
-import { OpenApi } from "@samchon/openapi";
-
-import { _randomInteger } from "./_randomInteger";
-
-export const _randomString = (props: OpenApi.IJsonSchema.IString) => {
-  const length: number = _randomInteger({
-    type: "integer",
-    minimum: props.minLength ?? 0,
-    maximum: props.maxLength,
-  });
-  return new Array(length)
-    .fill(0)
-    .map(() => ALPHABETS[random()])
-    .join("");
-};
-
-const ALPHABETS = "abcdefghijklmnopqrstuvwxyz";
-
-const random = () =>
-  _randomInteger({
-    type: "integer",
-    minimum: 0,
-    maximum: ALPHABETS.length - 1,
-  });
+import { OpenApi } from "@samchon/openapi";
+
+import { _randomInteger } from "./_randomInteger";
+
+export const _randomString = (props: OpenApi.IJsonSchema.IString) => {
+  const length: number = _randomInteger({
+    type: "integer",
+    minimum: props.minLength ?? 0,
+    maximum: props.maxLength,
+  });
+  return new Array(length)
+    .fill(0)
+    .map(() => ALPHABETS[random()])
+    .join("");
+};
+
+const ALPHABETS = "abcdefghijklmnopqrstuvwxyz";
+
+const random = () =>
+  _randomInteger({
+    type: "integer",
+    minimum: 0,
+    maximum: ALPHABETS.length - 1,
+  });

package/src/internal/_throwTypeGuardError.ts

@@ -1,5 +1,5 @@
-import { TypeGuardError } from "../TypeGuardError";
-
-export const _throwTypeGuardError = (props: TypeGuardError.IProps) => {
-  throw new TypeGuardError(props);
-};
+import { TypeGuardError } from "../TypeGuardError";
+
+export const _throwTypeGuardError = (props: TypeGuardError.IProps) => {
+  throw new TypeGuardError(props);
+};

package/src/internal/_validateReport.ts

@@ -1,13 +1,13 @@
-import { IValidation } from "../IValidation";
-
-export const _validateReport = (array: IValidation.IError[]) => {
-  const reportable = (path: string): boolean => {
-    if (array.length === 0) return true;
-    const last: string = array[array.length - 1]!.path;
-    return path.length > last.length || last.substring(0, path.length) !== path;
-  };
-  return (exceptable: boolean, error: IValidation.IError): false => {
-    if (exceptable && reportable(error.path)) array.push(error);
-    return false;
-  };
-};
+import { IValidation } from "../IValidation";
+
+export const _validateReport = (array: IValidation.IError[]) => {
+  const reportable = (path: string): boolean => {
+    if (array.length === 0) return true;
+    const last: string = array[array.length - 1]!.path;
+    return path.length > last.length || last.substring(0, path.length) !== path;
+  };
+  return (exceptable: boolean, error: IValidation.IError): false => {
+    if (exceptable && reportable(error.path)) array.push(error);
+    return false;
+  };
+};

package/src/internal/private/__notationCapitalize.ts

@@ -1,2 +1,2 @@
-export const __notationCapitalize = (str: string) =>
-  str.length ? str[0]!.toUpperCase() + str.slice(1).toLowerCase() : str;
+export const __notationCapitalize = (str: string) =>
+  str.length ? str[0]!.toUpperCase() + str.slice(1).toLowerCase() : str;