typia 6.10.2 → 6.10.3-dev.20240925

package/src/factories/CommentFactory.ts

@@ -1,79 +1,79 @@
-import ts from "typescript";
-
-export namespace CommentFactory {
-  export const description = (
-    symbol: ts.Symbol,
-    includeTags: boolean = false,
-  ): string | undefined => {
-    const node = symbol.declarations?.[0];
-    if (!node) return undefined;
-
-    // FOR LEGACY TS < 5.2
-    const [major, minor] = ts.versionMajorMinor.split(".").map(Number) as [
-      number,
-      number,
-    ];
-    if (major < 5 || (major === 5 && minor < 1)) {
-      const content: string[] = [];
-      const main: string = ts.displayPartsToString(
-        symbol.getDocumentationComment(undefined),
-      );
-      if (main.length) {
-        content.push(main);
-        if (includeTags && symbol.getJsDocTags().length) content.push("");
-      }
-      if (includeTags)
-        for (const tag of symbol.getJsDocTags()) {
-          content.push(
-            tag.text
-              ? `@${tag.name} ${ts.displayPartsToString(tag.text)}`
-              : `@${tag.name}`,
-          );
-        }
-      return content.length
-        ? content.map((line) => line.split("\r\n").join("\n")).join("\n")
-        : undefined;
-    }
-
-    // NEW FEATURE OF TS 5.2
-    const elements: readonly (ts.JSDoc | ts.JSDocTag)[] =
-      ts.getJSDocCommentsAndTags(node);
-    if (elements.length === 0) return undefined;
-
-    const content: string[] = [];
-    for (const comment of elements) {
-      if (ts.isJSDoc(comment)) {
-        const parsed: string | undefined = ts.getTextOfJSDocComment(
-          comment.comment,
-        );
-        if (parsed?.length) {
-          content.push(parsed);
-          if (includeTags && comment.tags?.length) content.push("");
-        }
-        if (includeTags)
-          for (const tag of comment.tags ?? [])
-            content.push(parseJSDocTag(tag));
-      } else if (includeTags) content.push(parseJSDocTag(comment));
-    }
-    const output: string = content
-      .map((line) => line.split("\r\n").join("\n"))
-      .join("\n");
-    return output.length ? output : undefined;
-  };
-
-  export const merge = (comments: ts.SymbolDisplayPart[]): string =>
-    comments
-      .map((part) => part.text)
-      .map((str) => str.split("\r\n").join("\n"))
-      .join("");
-}
-
-const parseJSDocTag = (tag: ts.JSDocTag): string => {
-  const name: string | undefined = (
-    tag as ts.JSDocParameterTag
-  ).name?.getText();
-  const parsed: string | undefined = ts.getTextOfJSDocComment(tag.comment);
-  return [`@${tag.tagName.text}`, name, parsed]
-    .filter((str) => !!str?.length)
-    .join(" ");
-};
+import ts from "typescript";
+
+export namespace CommentFactory {
+  export const description = (
+    symbol: ts.Symbol,
+    includeTags: boolean = false,
+  ): string | undefined => {
+    const node = symbol.declarations?.[0];
+    if (!node) return undefined;
+
+    // FOR LEGACY TS < 5.2
+    const [major, minor] = ts.versionMajorMinor.split(".").map(Number) as [
+      number,
+      number,
+    ];
+    if (major < 5 || (major === 5 && minor < 1)) {
+      const content: string[] = [];
+      const main: string = ts.displayPartsToString(
+        symbol.getDocumentationComment(undefined),
+      );
+      if (main.length) {
+        content.push(main);
+        if (includeTags && symbol.getJsDocTags().length) content.push("");
+      }
+      if (includeTags)
+        for (const tag of symbol.getJsDocTags()) {
+          content.push(
+            tag.text
+              ? `@${tag.name} ${ts.displayPartsToString(tag.text)}`
+              : `@${tag.name}`,
+          );
+        }
+      return content.length
+        ? content.map((line) => line.split("\r\n").join("\n")).join("\n")
+        : undefined;
+    }
+
+    // NEW FEATURE OF TS 5.2
+    const elements: readonly (ts.JSDoc | ts.JSDocTag)[] =
+      ts.getJSDocCommentsAndTags(node);
+    if (elements.length === 0) return undefined;
+
+    const content: string[] = [];
+    for (const comment of elements) {
+      if (ts.isJSDoc(comment)) {
+        const parsed: string | undefined = ts.getTextOfJSDocComment(
+          comment.comment,
+        );
+        if (parsed?.length) {
+          content.push(parsed);
+          if (includeTags && comment.tags?.length) content.push("");
+        }
+        if (includeTags)
+          for (const tag of comment.tags ?? [])
+            content.push(parseJSDocTag(tag));
+      } else if (includeTags) content.push(parseJSDocTag(comment));
+    }
+    const output: string = content
+      .map((line) => line.split("\r\n").join("\n"))
+      .join("\n");
+    return output.length ? output : undefined;
+  };
+
+  export const merge = (comments: ts.SymbolDisplayPart[]): string =>
+    comments
+      .map((part) => part.text)
+      .map((str) => str.split("\r\n").join("\n"))
+      .join("");
+}
+
+const parseJSDocTag = (tag: ts.JSDocTag): string => {
+  const name: string | undefined = (
+    tag as ts.JSDocParameterTag
+  ).name?.getText();
+  const parsed: string | undefined = ts.getTextOfJSDocComment(tag.comment);
+  return [`@${tag.tagName.text}`, name, parsed]
+    .filter((str) => !!str?.length)
+    .join(" ");
+};

package/src/factories/ExpressionFactory.ts

@@ -1,150 +1,150 @@
-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 =
-    (options: { checkNull: boolean; checkArray: boolean }) =>
-    (input: ts.Expression): ts.Expression => {
-      const conditions: ts.Expression[] = [
-        ts.factory.createStrictEquality(
-          ts.factory.createStringLiteral("object"),
-          ts.factory.createTypeOfExpression(input),
-        ),
-      ];
-      if (options.checkNull === true)
-        conditions.push(
-          ts.factory.createStrictInequality(ts.factory.createNull(), input),
-        );
-      if (options.checkArray === true)
-        conditions.push(
-          ts.factory.createStrictEquality(
-            ts.factory.createFalse(),
-            ts.factory.createCallExpression(
-              ts.factory.createIdentifier("Array.isArray"),
-              undefined,
-              [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 =
-    (target: ts.Expression) => (parameters: ts.Expression[]) => {
-      if (parameters.length === 0)
-        return ts.factory.createCallExpression(target, undefined, undefined);
-      let prev: ts.CallExpression = ts.factory.createCallExpression(
-        target,
-        undefined,
-        [parameters[0]!],
-      );
-      for (const param of parameters.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 =
-    (printer: ts.Printer) =>
-    (input: ts.Expression): string =>
-      printer.printNode(ts.EmitHint.Expression, input, input.getSourceFile());
-
-  export const transpile =
-    (context: 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,
-            context,
-          );
-        };
-        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 =
+    (options: { checkNull: boolean; checkArray: boolean }) =>
+    (input: ts.Expression): ts.Expression => {
+      const conditions: ts.Expression[] = [
+        ts.factory.createStrictEquality(
+          ts.factory.createStringLiteral("object"),
+          ts.factory.createTypeOfExpression(input),
+        ),
+      ];
+      if (options.checkNull === true)
+        conditions.push(
+          ts.factory.createStrictInequality(ts.factory.createNull(), input),
+        );
+      if (options.checkArray === true)
+        conditions.push(
+          ts.factory.createStrictEquality(
+            ts.factory.createFalse(),
+            ts.factory.createCallExpression(
+              ts.factory.createIdentifier("Array.isArray"),
+              undefined,
+              [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 =
+    (target: ts.Expression) => (parameters: ts.Expression[]) => {
+      if (parameters.length === 0)
+        return ts.factory.createCallExpression(target, undefined, undefined);
+      let prev: ts.CallExpression = ts.factory.createCallExpression(
+        target,
+        undefined,
+        [parameters[0]!],
+      );
+      for (const param of parameters.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 =
+    (printer: ts.Printer) =>
+    (input: ts.Expression): string =>
+      printer.printNode(ts.EmitHint.Expression, input, input.getSourceFile());
+
+  export const transpile =
+    (context: 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,
+            context,
+          );
+        };
+        return visitor(statement.expression) as ts.Expression;
+      };
+    };
+}

package/src/factories/IdentifierFactory.ts

@@ -1,70 +1,70 @@
-import ts from "typescript";
-
-import { Escaper } from "../utils/Escaper";
-
-import { TypeFactory } from "./TypeFactory";
-
-export namespace IdentifierFactory {
-  export const identifier = (name: string) =>
-    Escaper.variable(name)
-      ? ts.factory.createIdentifier(name)
-      : ts.factory.createStringLiteral(name);
-
-  export const access = (target: ts.Expression) => (property: string) => {
-    const postfix = identifier(property);
-    return ts.isStringLiteral(postfix)
-      ? ts.factory.createElementAccessExpression(target, postfix)
-      : ts.factory.createPropertyAccessExpression(target, postfix);
-  };
-
-  export const getName = (input: ts.Expression): string => {
-    const value: any = (input as any).escapedText?.toString();
-    if (typeof value === "string") return value;
-
-    if (ts.isPropertyAccessExpression(input))
-      return `${getName(
-        input.expression,
-      )}.${input.name.escapedText.toString()}`;
-    else if (ts.isElementAccessExpression(input))
-      return `${getName(input.expression)}[${getName(
-        input.argumentExpression,
-      )}]`;
-    return "uknown";
-  };
-
-  export const postfix = (str: string): string =>
-    Escaper.variable(str)
-      ? `".${str}"`
-      : `"[${JSON.stringify(str).split('"').join('\\"')}]"`;
-
-  export const parameter = (
-    name: string | ts.BindingName,
-    type?: ts.TypeNode,
-    init?: ts.Expression | ts.PunctuationToken<ts.SyntaxKind.QuestionToken>,
-  ): ts.ParameterDeclaration => {
-    // instead of ts.version >= "4.8"
-    if (ts.getDecorators !== undefined)
-      return ts.factory.createParameterDeclaration(
-        undefined,
-        undefined,
-        name,
-        init?.kind === ts.SyntaxKind.QuestionToken
-          ? ts.factory.createToken(ts.SyntaxKind.QuestionToken)
-          : undefined,
-        type ?? TypeFactory.keyword("any"),
-        init && init.kind !== ts.SyntaxKind.QuestionToken ? init : undefined,
-      );
-    // eslint-disable-next-line
-    return (ts.factory.createParameterDeclaration as any)(
-      undefined,
-      undefined,
-      undefined,
-      name,
-      init?.kind === ts.SyntaxKind.QuestionToken
-        ? ts.factory.createToken(ts.SyntaxKind.QuestionToken)
-        : undefined,
-      type,
-      init && init.kind !== ts.SyntaxKind.QuestionToken ? init : undefined,
-    );
-  };
-}
+import ts from "typescript";
+
+import { Escaper } from "../utils/Escaper";
+
+import { TypeFactory } from "./TypeFactory";
+
+export namespace IdentifierFactory {
+  export const identifier = (name: string) =>
+    Escaper.variable(name)
+      ? ts.factory.createIdentifier(name)
+      : ts.factory.createStringLiteral(name);
+
+  export const access = (target: ts.Expression) => (property: string) => {
+    const postfix = identifier(property);
+    return ts.isStringLiteral(postfix)
+      ? ts.factory.createElementAccessExpression(target, postfix)
+      : ts.factory.createPropertyAccessExpression(target, postfix);
+  };
+
+  export const getName = (input: ts.Expression): string => {
+    const value: any = (input as any).escapedText?.toString();
+    if (typeof value === "string") return value;
+
+    if (ts.isPropertyAccessExpression(input))
+      return `${getName(
+        input.expression,
+      )}.${input.name.escapedText.toString()}`;
+    else if (ts.isElementAccessExpression(input))
+      return `${getName(input.expression)}[${getName(
+        input.argumentExpression,
+      )}]`;
+    return "uknown";
+  };
+
+  export const postfix = (str: string): string =>
+    Escaper.variable(str)
+      ? `".${str}"`
+      : `"[${JSON.stringify(str).split('"').join('\\"')}]"`;
+
+  export const parameter = (
+    name: string | ts.BindingName,
+    type?: ts.TypeNode,
+    init?: ts.Expression | ts.PunctuationToken<ts.SyntaxKind.QuestionToken>,
+  ): ts.ParameterDeclaration => {
+    // instead of ts.version >= "4.8"
+    if (ts.getDecorators !== undefined)
+      return ts.factory.createParameterDeclaration(
+        undefined,
+        undefined,
+        name,
+        init?.kind === ts.SyntaxKind.QuestionToken
+          ? ts.factory.createToken(ts.SyntaxKind.QuestionToken)
+          : undefined,
+        type ?? TypeFactory.keyword("any"),
+        init && init.kind !== ts.SyntaxKind.QuestionToken ? init : undefined,
+      );
+    // eslint-disable-next-line
+    return (ts.factory.createParameterDeclaration as any)(
+      undefined,
+      undefined,
+      undefined,
+      name,
+      init?.kind === ts.SyntaxKind.QuestionToken
+        ? ts.factory.createToken(ts.SyntaxKind.QuestionToken)
+        : undefined,
+      type,
+      init && init.kind !== ts.SyntaxKind.QuestionToken ? init : undefined,
+    );
+  };
+}