typia 9.3.1 → 9.5.0-dev.20250710

package/src/internal/_notationCamel.ts

@@ -1,13 +1,13 @@
-import { __notationCapitalize } from "./private/__notationCapitalize";
-import { __notationUnsnake } from "./private/__notationUnsnake";
-
-export const _notationCamel = __notationUnsnake({
-  plain: (str) =>
-    str.length
-      ? str === str.toUpperCase()
-        ? str.toLocaleLowerCase()
-        : `${str[0]!.toLowerCase()}${str.substring(1)}`
-      : str,
-  snake: (str, i) =>
-    i === 0 ? str.toLowerCase() : __notationCapitalize(str.toLowerCase()),
-});
+import { __notationCapitalize } from "./private/__notationCapitalize";
+import { __notationUnsnake } from "./private/__notationUnsnake";
+
+export const _notationCamel = __notationUnsnake({
+  plain: (str) =>
+    str.length
+      ? str === str.toUpperCase()
+        ? str.toLocaleLowerCase()
+        : `${str[0]!.toLowerCase()}${str.substring(1)}`
+      : str,
+  snake: (str, i) =>
+    i === 0 ? str.toLowerCase() : __notationCapitalize(str.toLowerCase()),
+});

package/src/internal/_notationPascal.ts

@@ -1,8 +1,8 @@
-import { __notationCapitalize } from "./private/__notationCapitalize";
-import { __notationUnsnake } from "./private/__notationUnsnake";
-
-export const _notationPascal = __notationUnsnake({
-  plain: (str) =>
-    str.length ? `${str[0]!.toUpperCase()}${str.substring(1)}` : str,
-  snake: __notationCapitalize,
-});
+import { __notationCapitalize } from "./private/__notationCapitalize";
+import { __notationUnsnake } from "./private/__notationUnsnake";
+
+export const _notationPascal = __notationUnsnake({
+  plain: (str) =>
+    str.length ? `${str[0]!.toUpperCase()}${str.substring(1)}` : str,
+  snake: __notationCapitalize,
+});

package/src/internal/_notationSnake.ts

@@ -1,43 +1,43 @@
-export const _notationSnake = (str: string): string => {
-  if (str.length === 0) return str;
-
-  // PREFIX
-  // eslint-disable-next-line @typescript-eslint/no-unused-vars
-  let prefix: string = "";
-  for (let i: number = 0; i < str.length; i++) {
-    if (str[i] === "_") prefix += "_";
-    else break;
-  }
-  if (prefix.length !== 0) str = str.substring(prefix.length);
-
-  const out = (s: string) => `${prefix}${s}`;
-
-  // SNAKE CASE
-  const items: string[] = str.split("_");
-  if (items.length > 1) return out(items.map((s) => s.toLowerCase()).join("_"));
-
-  // CAMEL OR PASCAL CASE
-  const indexes: number[] = [];
-  for (let i: number = 0; i < str.length; i++) {
-    const code: number = str.charCodeAt(i);
-    if (65 <= code && code <= 90) indexes.push(i);
-  }
-  for (let i: number = indexes.length - 1; i > 0; --i) {
-    const now: number = indexes[i]!;
-    const prev: number = indexes[i - 1]!;
-    if (now - prev === 1) indexes.splice(i, 1);
-  }
-  if (indexes.length !== 0 && indexes[0] === 0) indexes.splice(0, 1);
-  if (indexes.length === 0) return str.toLowerCase();
-
-  let ret: string = "";
-  for (let i: number = 0; i < indexes.length; i++) {
-    const first: number = i === 0 ? 0 : indexes[i - 1]!;
-    const last: number = indexes[i]!;
-
-    ret += str.substring(first, last).toLowerCase();
-    ret += "_";
-  }
-  ret += str.substring(indexes[indexes.length - 1]!).toLowerCase();
-  return out(ret);
-};
+export const _notationSnake = (str: string): string => {
+  if (str.length === 0) return str;
+
+  // PREFIX
+  // eslint-disable-next-line @typescript-eslint/no-unused-vars
+  let prefix: string = "";
+  for (let i: number = 0; i < str.length; i++) {
+    if (str[i] === "_") prefix += "_";
+    else break;
+  }
+  if (prefix.length !== 0) str = str.substring(prefix.length);
+
+  const out = (s: string) => `${prefix}${s}`;
+
+  // SNAKE CASE
+  const items: string[] = str.split("_");
+  if (items.length > 1) return out(items.map((s) => s.toLowerCase()).join("_"));
+
+  // CAMEL OR PASCAL CASE
+  const indexes: number[] = [];
+  for (let i: number = 0; i < str.length; i++) {
+    const code: number = str.charCodeAt(i);
+    if (65 <= code && code <= 90) indexes.push(i);
+  }
+  for (let i: number = indexes.length - 1; i > 0; --i) {
+    const now: number = indexes[i]!;
+    const prev: number = indexes[i - 1]!;
+    if (now - prev === 1) indexes.splice(i, 1);
+  }
+  if (indexes.length !== 0 && indexes[0] === 0) indexes.splice(0, 1);
+  if (indexes.length === 0) return str.toLowerCase();
+
+  let ret: string = "";
+  for (let i: number = 0; i < indexes.length; i++) {
+    const first: number = i === 0 ? 0 : indexes[i - 1]!;
+    const last: number = indexes[i]!;
+
+    ret += str.substring(first, last).toLowerCase();
+    ret += "_";
+  }
+  ret += str.substring(indexes[indexes.length - 1]!).toLowerCase();
+  return out(ret);
+};

package/src/internal/_randomArray.ts

@@ -1,21 +1,21 @@
-import { OpenApi } from "@samchon/openapi";
-
-import { _randomInteger } from "./_randomInteger";
-
-export const _randomArray = <T>(
-  props: Omit<OpenApi.IJsonSchema.IArray, "items"> & {
-    element: (index: number, count: number) => T;
-  },
-) => {
-  const count: number = _randomInteger({
-    type: "integer",
-    minimum: props.minItems ?? 0,
-    maximum: props.maxItems ?? (props.minItems ?? 0) + 5,
-  });
-  if (props.uniqueItems !== true)
-    return new Array(count).fill(null).map((_, i) => props.element(i, count));
-  const elements: Set<any> = new Set();
-  while (elements.size !== count)
-    elements.add(props.element(elements.size, count));
-  return Array.from(elements);
-};
+import { OpenApi } from "@samchon/openapi";
+
+import { _randomInteger } from "./_randomInteger";
+
+export const _randomArray = <T>(
+  props: Omit<OpenApi.IJsonSchema.IArray, "items"> & {
+    element: (index: number, count: number) => T;
+  },
+) => {
+  const count: number = _randomInteger({
+    type: "integer",
+    minimum: props.minItems ?? 0,
+    maximum: props.maxItems ?? (props.minItems ?? 0) + 5,
+  });
+  if (props.uniqueItems !== true)
+    return new Array(count).fill(null).map((_, i) => props.element(i, count));
+  const elements: Set<any> = new Set();
+  while (elements.size !== count)
+    elements.add(props.element(elements.size, count));
+  return Array.from(elements);
+};

package/src/internal/_randomBigint.ts

@@ -1,6 +1,6 @@
-import { OpenApi } from "@samchon/openapi";
-
-import { _randomInteger } from "./_randomInteger";
-
-export const _randomBigint = (props: OpenApi.IJsonSchema.IInteger): bigint =>
-  BigInt(_randomInteger(props));
+import { OpenApi } from "@samchon/openapi";
+
+import { _randomInteger } from "./_randomInteger";
+
+export const _randomBigint = (props: OpenApi.IJsonSchema.IInteger): bigint =>
+  BigInt(_randomInteger(props));

package/src/internal/_randomBoolean.ts

@@ -1 +1 @@
-export const _randomBoolean = (): boolean => Math.random() < 0.5;
+export const _randomBoolean = (): boolean => Math.random() < 0.5;

package/src/internal/_randomFormatByte.ts

@@ -1,3 +1,3 @@
-export const _randomFormatByte = (): string => FIXED;
-
-const FIXED = "vt7ekz4lIoNTTS9sDQYdWKharxIFAR54+z/umIxSgUM=";
+export const _randomFormatByte = (): string => FIXED;
+
+const FIXED = "vt7ekz4lIoNTTS9sDQYdWKharxIFAR54+z/umIxSgUM=";

package/src/internal/_randomFormatDate.ts

@@ -1,18 +1,18 @@
-import { _randomInteger } from "./_randomInteger";
-
-export const _randomFormatDate = (props?: {
-  minimum?: number;
-  maximum?: number;
-}) =>
-  new Date(
-    _randomInteger({
-      type: "integer",
-      minimum: props?.minimum ?? 0,
-      maximum:
-        (props?.maximum ?? props?.minimum === undefined)
-          ? Date.now()
-          : props.minimum + 365 * 24 * 60 * 60 * 1_000,
-    }),
-  )
-    .toISOString()
-    .substring(0, 10);
+import { _randomInteger } from "./_randomInteger";
+
+export const _randomFormatDate = (props?: {
+  minimum?: number;
+  maximum?: number;
+}) =>
+  new Date(
+    _randomInteger({
+      type: "integer",
+      minimum: props?.minimum ?? 0,
+      maximum:
+        (props?.maximum ?? props?.minimum === undefined)
+          ? Date.now()
+          : props.minimum + 365 * 24 * 60 * 60 * 1_000,
+    }),
+  )
+    .toISOString()
+    .substring(0, 10);

package/src/internal/_randomFormatDatetime.ts

@@ -1,16 +1,16 @@
-import { _randomInteger } from "./_randomInteger";
-
-export const _randomFormatDatetime = (props?: {
-  minimum?: number;
-  maximum?: number;
-}) =>
-  new Date(
-    _randomInteger({
-      type: "integer",
-      minimum: props?.minimum ?? 0,
-      maximum:
-        (props?.maximum ?? props?.minimum === undefined)
-          ? Date.now()
-          : props.minimum + 365 * 24 * 60 * 60 * 1_000,
-    }),
-  ).toISOString();
+import { _randomInteger } from "./_randomInteger";
+
+export const _randomFormatDatetime = (props?: {
+  minimum?: number;
+  maximum?: number;
+}) =>
+  new Date(
+    _randomInteger({
+      type: "integer",
+      minimum: props?.minimum ?? 0,
+      maximum:
+        (props?.maximum ?? props?.minimum === undefined)
+          ? Date.now()
+          : props.minimum + 365 * 24 * 60 * 60 * 1_000,
+    }),
+  ).toISOString();

package/src/internal/_randomFormatDuration.ts

@@ -1,27 +1,27 @@
-import { _randomInteger } from "./_randomInteger";
-
-export const _randomFormatDuration = (): string => {
-  const period: string = durate([
-    ["Y", random(0, 100)],
-    ["M", random(0, 12)],
-    ["D", random(0, 31)],
-  ]);
-  const time: string = durate([
-    ["H", random(0, 24)],
-    ["M", random(0, 60)],
-    ["S", random(0, 60)],
-  ]);
-  if (period.length + time.length === 0) return "PT0S";
-  return `P${period}${time.length ? "T" : ""}${time}`;
-};
-const durate = (elements: [string, number][]) =>
-  elements
-    .filter(([_unit, value]) => value !== 0)
-    .map(([unit, value]) => `${value}${unit}`)
-    .join("");
-const random = (minimum: number, maximum: number) =>
-  _randomInteger({
-    type: "integer",
-    minimum,
-    maximum,
-  });
+import { _randomInteger } from "./_randomInteger";
+
+export const _randomFormatDuration = (): string => {
+  const period: string = durate([
+    ["Y", random(0, 100)],
+    ["M", random(0, 12)],
+    ["D", random(0, 31)],
+  ]);
+  const time: string = durate([
+    ["H", random(0, 24)],
+    ["M", random(0, 60)],
+    ["S", random(0, 60)],
+  ]);
+  if (period.length + time.length === 0) return "PT0S";
+  return `P${period}${time.length ? "T" : ""}${time}`;
+};
+const durate = (elements: [string, number][]) =>
+  elements
+    .filter(([_unit, value]) => value !== 0)
+    .map(([unit, value]) => `${value}${unit}`)
+    .join("");
+const random = (minimum: number, maximum: number) =>
+  _randomInteger({
+    type: "integer",
+    minimum,
+    maximum,
+  });

package/src/internal/_randomFormatEmail.ts

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

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);
+  });