typia 7.0.0-dev.20241003 → 7.0.0-dev.20241005

package/src/SnakeCase.ts

@@ -1,126 +1,126 @@
-import { Equal } from "./typings/Equal";
-import { NativeClass } from "./typings/NativeClass";
-import { ValueOf } from "./typings/ValueOf";
-
-/**
- * Snake case type.
- *
- * `SnakeCase` type is a type that all keys of an object are converted to snake case.
- *
- * It also erase every method properties like {@link Resolved} type.
- *
- * @template T Target type to be snake cased
- * @author Jeongho Nam - https://github.com/samchon
- */
-export type SnakeCase<T> =
-  Equal<T, SnakageMain<T>> extends true ? T : SnakageMain<T>;
-
-/* -----------------------------------------------------------
-    OBJECT CONVERSION
------------------------------------------------------------ */
-
-type SnakageMain<T> = T extends [never]
-  ? never // special trick for (jsonable | null) type
-  : T extends { valueOf(): boolean | bigint | number | string }
-    ? ValueOf<T>
-    : T extends Function
-      ? never
-      : T extends object
-        ? SnakageObject<T>
-        : T;
-
-type SnakageObject<T extends object> =
-  T extends Array<infer U>
-    ? IsTuple<T> extends true
-      ? SnakageTuple<T>
-      : SnakageMain<U>[]
-    : T extends Set<infer U>
-      ? Set<SnakageMain<U>>
-      : T extends Map<infer K, infer V>
-        ? Map<SnakageMain<K>, SnakageMain<V>>
-        : T extends WeakSet<any> | WeakMap<any, any>
-          ? never
-          : T extends NativeClass
-            ? T
-            : {
-                [Key in keyof T as SnakageString<Key & string>]: SnakageMain<
-                  T[Key]
-                >;
-              };
-
-/* -----------------------------------------------------------
-    SPECIAL CASES
------------------------------------------------------------ */
-type IsTuple<T extends readonly any[] | { length: number }> = [T] extends [
-  never,
-]
-  ? false
-  : T extends readonly any[]
-    ? number extends T["length"]
-      ? false
-      : true
-    : false;
-type SnakageTuple<T extends readonly any[]> = T extends []
-  ? []
-  : T extends [infer F]
-    ? [SnakageMain<F>]
-    : T extends [infer F, ...infer Rest extends readonly any[]]
-      ? [SnakageMain<F>, ...SnakageTuple<Rest>]
-      : T extends [(infer F)?]
-        ? [SnakageMain<F>?]
-        : T extends [(infer F)?, ...infer Rest extends readonly any[]]
-          ? [SnakageMain<F>?, ...SnakageTuple<Rest>]
-          : [];
-
-/* -----------------------------------------------------------
-    STRING CONVERTER
------------------------------------------------------------ */
-type SnakageString<Key extends string> = Key extends `${infer _}`
-  ? SnakageStringRepeatedly<Key, "">
-  : Key;
-type SnakageStringRepeatedly<
-  S extends string,
-  Previous extends string,
-> = S extends `${infer First}${infer Second}${infer Rest}`
-  ? `${Underscore<Previous, First>}${Lowercase<First>}${Underscore<
-      First,
-      Second
-    >}${Lowercase<Second>}${SnakageStringRepeatedly<Rest, Second>}`
-  : S extends `${infer First}`
-    ? `${Underscore<Previous, First>}${Lowercase<First>}`
-    : "";
-type Underscore<First extends string, Second extends string> = First extends
-  | UpperAlphabetic
-  | ""
-  | "_"
-  ? ""
-  : Second extends UpperAlphabetic
-    ? "_"
-    : "";
-type UpperAlphabetic =
-  | "A"
-  | "B"
-  | "C"
-  | "D"
-  | "E"
-  | "F"
-  | "G"
-  | "H"
-  | "I"
-  | "J"
-  | "K"
-  | "L"
-  | "M"
-  | "N"
-  | "O"
-  | "P"
-  | "Q"
-  | "R"
-  | "S"
-  | "T"
-  | "U"
-  | "V"
-  | "W"
-  | "X"
-  | "Y"
-  | "Z";
+import { Equal } from "./typings/Equal";
+import { NativeClass } from "./typings/NativeClass";
+import { ValueOf } from "./typings/ValueOf";
+
+/**
+ * Snake case type.
+ *
+ * `SnakeCase` type is a type that all keys of an object are converted to snake case.
+ *
+ * It also erase every method properties like {@link Resolved} type.
+ *
+ * @template T Target type to be snake cased
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export type SnakeCase<T> =
+  Equal<T, SnakageMain<T>> extends true ? T : SnakageMain<T>;
+
+/* -----------------------------------------------------------
+    OBJECT CONVERSION
+----------------------------------------------------------- */
+
+type SnakageMain<T> = T extends [never]
+  ? never // special trick for (jsonable | null) type
+  : T extends { valueOf(): boolean | bigint | number | string }
+    ? ValueOf<T>
+    : T extends Function
+      ? never
+      : T extends object
+        ? SnakageObject<T>
+        : T;
+
+type SnakageObject<T extends object> =
+  T extends Array<infer U>
+    ? IsTuple<T> extends true
+      ? SnakageTuple<T>
+      : SnakageMain<U>[]
+    : T extends Set<infer U>
+      ? Set<SnakageMain<U>>
+      : T extends Map<infer K, infer V>
+        ? Map<SnakageMain<K>, SnakageMain<V>>
+        : T extends WeakSet<any> | WeakMap<any, any>
+          ? never
+          : T extends NativeClass
+            ? T
+            : {
+                [Key in keyof T as SnakageString<Key & string>]: SnakageMain<
+                  T[Key]
+                >;
+              };
+
+/* -----------------------------------------------------------
+    SPECIAL CASES
+----------------------------------------------------------- */
+type IsTuple<T extends readonly any[] | { length: number }> = [T] extends [
+  never,
+]
+  ? false
+  : T extends readonly any[]
+    ? number extends T["length"]
+      ? false
+      : true
+    : false;
+type SnakageTuple<T extends readonly any[]> = T extends []
+  ? []
+  : T extends [infer F]
+    ? [SnakageMain<F>]
+    : T extends [infer F, ...infer Rest extends readonly any[]]
+      ? [SnakageMain<F>, ...SnakageTuple<Rest>]
+      : T extends [(infer F)?]
+        ? [SnakageMain<F>?]
+        : T extends [(infer F)?, ...infer Rest extends readonly any[]]
+          ? [SnakageMain<F>?, ...SnakageTuple<Rest>]
+          : [];
+
+/* -----------------------------------------------------------
+    STRING CONVERTER
+----------------------------------------------------------- */
+type SnakageString<Key extends string> = Key extends `${infer _}`
+  ? SnakageStringRepeatedly<Key, "">
+  : Key;
+type SnakageStringRepeatedly<
+  S extends string,
+  Previous extends string,
+> = S extends `${infer First}${infer Second}${infer Rest}`
+  ? `${Underscore<Previous, First>}${Lowercase<First>}${Underscore<
+      First,
+      Second
+    >}${Lowercase<Second>}${SnakageStringRepeatedly<Rest, Second>}`
+  : S extends `${infer First}`
+    ? `${Underscore<Previous, First>}${Lowercase<First>}`
+    : "";
+type Underscore<First extends string, Second extends string> = First extends
+  | UpperAlphabetic
+  | ""
+  | "_"
+  ? ""
+  : Second extends UpperAlphabetic
+    ? "_"
+    : "";
+type UpperAlphabetic =
+  | "A"
+  | "B"
+  | "C"
+  | "D"
+  | "E"
+  | "F"
+  | "G"
+  | "H"
+  | "I"
+  | "J"
+  | "K"
+  | "L"
+  | "M"
+  | "N"
+  | "O"
+  | "P"
+  | "Q"
+  | "R"
+  | "S"
+  | "T"
+  | "U"
+  | "V"
+  | "W"
+  | "X"
+  | "Y"
+  | "Z";

package/src/factories/ExpressionFactory.ts

@@ -1,164 +1,164 @@
-import ts from "typescript";
-
-import { RandomGenerator } from "../utils/RandomGenerator";
-
-export namespace ExpressionFactory {
-  export const number = (value: number) =>
-    value < 0
-      ? ts.factory.createPrefixUnaryExpression(
-          ts.SyntaxKind.MinusToken,
-          ts.factory.createNumericLiteral(Math.abs(value)),
-        )
-      : ts.factory.createNumericLiteral(value);
-
-  export const bigint = (value: number | bigint) =>
-    ts.factory.createCallExpression(
-      ts.factory.createIdentifier("BigInt"),
-      undefined,
-      [ts.factory.createIdentifier(value.toString())],
-    );
-
-  export const isRequired = (input: ts.Expression): ts.Expression =>
-    ts.factory.createStrictInequality(
-      ts.factory.createIdentifier("undefined"),
-      input,
-    );
-
-  export const isArray = (input: ts.Expression): ts.Expression =>
-    ts.factory.createCallExpression(
-      ts.factory.createIdentifier("Array.isArray"),
-      undefined,
-      [input],
-    );
-
-  export const isObject = (props: {
-    checkNull: boolean;
-    checkArray: boolean;
-    input: ts.Expression;
-  }): ts.Expression => {
-    const conditions: ts.Expression[] = [
-      ts.factory.createStrictEquality(
-        ts.factory.createStringLiteral("object"),
-        ts.factory.createTypeOfExpression(props.input),
-      ),
-    ];
-    if (props.checkNull === true)
-      conditions.push(
-        ts.factory.createStrictInequality(ts.factory.createNull(), props.input),
-      );
-    if (props.checkArray === true)
-      conditions.push(
-        ts.factory.createStrictEquality(
-          ts.factory.createFalse(),
-          ts.factory.createCallExpression(
-            ts.factory.createIdentifier("Array.isArray"),
-            undefined,
-            [props.input],
-          ),
-        ),
-      );
-
-    return conditions.length === 1
-      ? conditions[0]!
-      : conditions.reduce((x, y) => ts.factory.createLogicalAnd(x, y));
-  };
-
-  export const isInstanceOf = (
-    type: string,
-    input: ts.Expression,
-  ): ts.Expression => {
-    return ts.factory.createBinaryExpression(
-      input,
-      ts.factory.createToken(ts.SyntaxKind.InstanceOfKeyword),
-      ts.factory.createIdentifier(type),
-    );
-  };
-
-  export const coalesce = (x: ts.Expression, y: ts.Expression): ts.Expression =>
-    ts.factory.createBinaryExpression(
-      x,
-      ts.factory.createToken(ts.SyntaxKind.QuestionQuestionToken),
-      y,
-    );
-
-  export const currying = (props: {
-    function: ts.Expression;
-    arguments: ts.Expression[];
-  }) => {
-    if (props.arguments.length === 0)
-      return ts.factory.createCallExpression(
-        props.function,
-        undefined,
-        undefined,
-      );
-    let prev: ts.CallExpression = ts.factory.createCallExpression(
-      props.function,
-      undefined,
-      [props.arguments[0]!],
-    );
-    for (const param of props.arguments.slice(1))
-      prev = ts.factory.createCallExpression(prev, undefined, [param]);
-    return prev;
-  };
-
-  export const selfCall = (body: ts.ConciseBody) =>
-    ts.isCallExpression(body)
-      ? body
-      : ts.factory.createCallExpression(
-          ts.factory.createParenthesizedExpression(
-            ts.factory.createArrowFunction(
-              undefined,
-              undefined,
-              [],
-              undefined,
-              undefined,
-              body,
-            ),
-          ),
-          undefined,
-          undefined,
-        );
-
-  export const getEscapedText = (props: {
-    printer: ts.Printer;
-    input: ts.Expression;
-  }): string =>
-    props.printer.printNode(
-      ts.EmitHint.Expression,
-      props.input,
-      props.input.getSourceFile(),
-    );
-
-  export const transpile = (
-    transformer: ts.TransformationContext,
-    script: string,
-  ) => {
-    const file: ts.SourceFile = ts.createSourceFile(
-      `${RandomGenerator.uuid()}.ts`,
-      script,
-      ts.ScriptTarget.ESNext,
-      true,
-      ts.ScriptKind.TS,
-    );
-    const statement: ts.Statement | undefined = file.statements[0];
-    if (statement === undefined)
-      throw new ReferenceError(
-        "Error on ExpressionFactory.transpile(): no statement exists.",
-      );
-    else if (!ts.isExpressionStatement(statement))
-      throw new TypeError(
-        "Error on ExpressionFactory.transpile(): statement is not an expression statement.",
-      );
-    return (input: ts.Expression): ts.Expression => {
-      const visitor = (node: ts.Node): ts.Node => {
-        if (ts.isIdentifier(node) && node.text === "$input") return input;
-        return ts.visitEachChild(
-          (ts.factory as any).cloneNode(node),
-          visitor,
-          transformer,
-        );
-      };
-      return visitor(statement.expression) as ts.Expression;
-    };
-  };
-}
+import ts from "typescript";
+
+import { RandomGenerator } from "../utils/RandomGenerator";
+
+export namespace ExpressionFactory {
+  export const number = (value: number) =>
+    value < 0
+      ? ts.factory.createPrefixUnaryExpression(
+          ts.SyntaxKind.MinusToken,
+          ts.factory.createNumericLiteral(Math.abs(value)),
+        )
+      : ts.factory.createNumericLiteral(value);
+
+  export const bigint = (value: number | bigint) =>
+    ts.factory.createCallExpression(
+      ts.factory.createIdentifier("BigInt"),
+      undefined,
+      [ts.factory.createIdentifier(value.toString())],
+    );
+
+  export const isRequired = (input: ts.Expression): ts.Expression =>
+    ts.factory.createStrictInequality(
+      ts.factory.createIdentifier("undefined"),
+      input,
+    );
+
+  export const isArray = (input: ts.Expression): ts.Expression =>
+    ts.factory.createCallExpression(
+      ts.factory.createIdentifier("Array.isArray"),
+      undefined,
+      [input],
+    );
+
+  export const isObject = (props: {
+    checkNull: boolean;
+    checkArray: boolean;
+    input: ts.Expression;
+  }): ts.Expression => {
+    const conditions: ts.Expression[] = [
+      ts.factory.createStrictEquality(
+        ts.factory.createStringLiteral("object"),
+        ts.factory.createTypeOfExpression(props.input),
+      ),
+    ];
+    if (props.checkNull === true)
+      conditions.push(
+        ts.factory.createStrictInequality(ts.factory.createNull(), props.input),
+      );
+    if (props.checkArray === true)
+      conditions.push(
+        ts.factory.createStrictEquality(
+          ts.factory.createFalse(),
+          ts.factory.createCallExpression(
+            ts.factory.createIdentifier("Array.isArray"),
+            undefined,
+            [props.input],
+          ),
+        ),
+      );
+
+    return conditions.length === 1
+      ? conditions[0]!
+      : conditions.reduce((x, y) => ts.factory.createLogicalAnd(x, y));
+  };
+
+  export const isInstanceOf = (
+    type: string,
+    input: ts.Expression,
+  ): ts.Expression => {
+    return ts.factory.createBinaryExpression(
+      input,
+      ts.factory.createToken(ts.SyntaxKind.InstanceOfKeyword),
+      ts.factory.createIdentifier(type),
+    );
+  };
+
+  export const coalesce = (x: ts.Expression, y: ts.Expression): ts.Expression =>
+    ts.factory.createBinaryExpression(
+      x,
+      ts.factory.createToken(ts.SyntaxKind.QuestionQuestionToken),
+      y,
+    );
+
+  export const currying = (props: {
+    function: ts.Expression;
+    arguments: ts.Expression[];
+  }): ts.CallExpression => {
+    if (props.arguments.length === 0)
+      return ts.factory.createCallExpression(
+        props.function,
+        undefined,
+        undefined,
+      );
+    let prev: ts.CallExpression = ts.factory.createCallExpression(
+      props.function,
+      undefined,
+      [props.arguments[0]!],
+    );
+    for (const param of props.arguments.slice(1))
+      prev = ts.factory.createCallExpression(prev, undefined, [param]);
+    return prev;
+  };
+
+  export const selfCall = (body: ts.ConciseBody) =>
+    ts.isCallExpression(body)
+      ? body
+      : ts.factory.createCallExpression(
+          ts.factory.createParenthesizedExpression(
+            ts.factory.createArrowFunction(
+              undefined,
+              undefined,
+              [],
+              undefined,
+              undefined,
+              body,
+            ),
+          ),
+          undefined,
+          undefined,
+        );
+
+  export const getEscapedText = (props: {
+    printer: ts.Printer;
+    input: ts.Expression;
+  }): string =>
+    props.printer.printNode(
+      ts.EmitHint.Expression,
+      props.input,
+      props.input.getSourceFile(),
+    );
+
+  export const transpile = (
+    transformer: ts.TransformationContext,
+    script: string,
+  ) => {
+    const file: ts.SourceFile = ts.createSourceFile(
+      `${RandomGenerator.uuid()}.ts`,
+      script,
+      ts.ScriptTarget.ESNext,
+      true,
+      ts.ScriptKind.TS,
+    );
+    const statement: ts.Statement | undefined = file.statements[0];
+    if (statement === undefined)
+      throw new ReferenceError(
+        "Error on ExpressionFactory.transpile(): no statement exists.",
+      );
+    else if (!ts.isExpressionStatement(statement))
+      throw new TypeError(
+        "Error on ExpressionFactory.transpile(): statement is not an expression statement.",
+      );
+    return (input: ts.Expression): ts.Expression => {
+      const visitor = (node: ts.Node): ts.Node => {
+        if (ts.isIdentifier(node) && node.text === "$input") return input;
+        return ts.visitEachChild(
+          (ts.factory as any).cloneNode(node),
+          visitor,
+          transformer,
+        );
+      };
+      return visitor(statement.expression) as ts.Expression;
+    };
+  };
+}