typia 7.6.0-dev.20241229 → 7.7.0-dev.20250130

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/ValueFactory.ts

@@ -1,12 +1,12 @@
-import ts from "typescript";
-
-export namespace ValueFactory {
-  export const NULL = () => ts.factory.createNull();
-  export const UNDEFINED = () => ts.factory.createIdentifier("undefined");
-  export const BOOLEAN = (value: boolean) =>
-    value ? ts.factory.createTrue() : ts.factory.createFalse();
-  export const INPUT = (str: string = "input") =>
-    ts.factory.createIdentifier(str);
-  export const TYPEOF = (input: ts.Expression) =>
-    ts.factory.createTypeOfExpression(input);
-}
+import ts from "typescript";
+
+export namespace ValueFactory {
+  export const NULL = () => ts.factory.createNull();
+  export const UNDEFINED = () => ts.factory.createIdentifier("undefined");
+  export const BOOLEAN = (value: boolean) =>
+    value ? ts.factory.createTrue() : ts.factory.createFalse();
+  export const INPUT = (str: string = "input") =>
+    ts.factory.createIdentifier(str);
+  export const TYPEOF = (input: ts.Expression) =>
+    ts.factory.createTypeOfExpression(input);
+}

package/src/factories/internal/metadata/emend_metadata_atomics.ts

@@ -1,45 +1,45 @@
-import { Metadata } from "../../../schemas/metadata/Metadata";
-import { MetadataAtomic } from "../../../schemas/metadata/MetadataAtomic";
-
-import { ArrayUtil } from "../../../utils/ArrayUtil";
-
-export const emend_metadata_atomics = (meta: Metadata) => {
-  // ATOMICS
-  for (const a of meta.atomics) {
-    if (is_not_pure(a)) continue;
-    const index: number = meta.constants.findIndex((c) => c.type === a.type);
-    if (index !== -1) meta.constants.splice(index, 1);
-  }
-
-  // BOOLEAN
-  {
-    const index: number = meta.constants.findIndex((c) => c.type === "boolean");
-    if (index !== -1 && meta.constants[index]!.values.length === 2) {
-      const temp = meta.constants.splice(index, 1)[0]!;
-      ArrayUtil.take(
-        meta.atomics,
-        (a) => a.type === "boolean",
-        () =>
-          MetadataAtomic.create({
-            type: "boolean" as const,
-            tags: temp.values[0]!.tags ?? [],
-          }),
-      );
-    }
-  }
-
-  // TEMPLATE
-  if (meta.templates.length) {
-    const atomic: MetadataAtomic | undefined = meta.atomics.find(
-      (a) => a.type === "string",
-    );
-    if (atomic !== undefined && false === is_not_pure(atomic))
-      meta.templates.splice(0, meta.templates.length);
-  }
-};
-
-const is_not_pure = (atomic: MetadataAtomic): boolean =>
-  atomic.tags.length !== 0 &&
-  atomic.tags.every(
-    (row) => row.length !== 0 && row.every((c) => !!c.validate?.length),
-  );
+import { Metadata } from "../../../schemas/metadata/Metadata";
+import { MetadataAtomic } from "../../../schemas/metadata/MetadataAtomic";
+
+import { ArrayUtil } from "../../../utils/ArrayUtil";
+
+export const emend_metadata_atomics = (meta: Metadata) => {
+  // ATOMICS
+  for (const a of meta.atomics) {
+    if (is_not_pure(a)) continue;
+    const index: number = meta.constants.findIndex((c) => c.type === a.type);
+    if (index !== -1) meta.constants.splice(index, 1);
+  }
+
+  // BOOLEAN
+  {
+    const index: number = meta.constants.findIndex((c) => c.type === "boolean");
+    if (index !== -1 && meta.constants[index]!.values.length === 2) {
+      const temp = meta.constants.splice(index, 1)[0]!;
+      ArrayUtil.take(
+        meta.atomics,
+        (a) => a.type === "boolean",
+        () =>
+          MetadataAtomic.create({
+            type: "boolean" as const,
+            tags: temp.values[0]!.tags ?? [],
+          }),
+      );
+    }
+  }
+
+  // TEMPLATE
+  if (meta.templates.length) {
+    const atomic: MetadataAtomic | undefined = meta.atomics.find(
+      (a) => a.type === "string",
+    );
+    if (atomic !== undefined && false === is_not_pure(atomic))
+      meta.templates.splice(0, meta.templates.length);
+  }
+};
+
+const is_not_pure = (atomic: MetadataAtomic): boolean =>
+  atomic.tags.length !== 0 &&
+  atomic.tags.every(
+    (row) => row.length !== 0 && row.every((c) => !!c.validate?.length),
+  );

package/src/http.ts

@@ -25,7 +25,7 @@ import { TypeGuardError } from "./TypeGuardError";
  *
  * By the way, as `FormData` is not enough to express complex data structures,
  * `typia.http.formData()` function has some limitations. If target type `T` is
- * not following those restrictions, compilation errors would be occured.
+ * not following those restrictions, compilation errors would be occurred.
  *
  * 1. Type `T` must be an object type
  * 2. Do not allow dynamic property
@@ -34,7 +34,7 @@ import { TypeGuardError } from "./TypeGuardError";
  *
  * Also, `typia.http.formData()` function does not perform validation about the
  * decoded value. Therefore, if you can't sure that input data is following the
- * `T` type, it would better to call one of below functions intead.
+ * `T` type, it would better to call one of below functions instead.
  *
  * @template T Expected type of decoded value
  * @param input FormData instance
@@ -66,7 +66,7 @@ export function formData(): never {
  *
  * By the way, as `FormData` is not enough to express complex data structures,
  * `typia.http.assertFormData()` function has some limitations. If target type `T`
- * is not following those restrictions, compilation errors would be occured.
+ * is not following those restrictions, compilation errors would be occurred.
  *
  * 1. Type `T` must be an object type
  * 2. Do not allow dynamic property
@@ -106,7 +106,7 @@ export function assertFormData(): never {
  *
  * By the way, as `FormData` is not enough to express complex data structures,
  * `typia.http.isFormData()` function has some limitations. If target type `T` is
- * not following those restrictions, compilation errors would be occured.
+ * not following those restrictions, compilation errors would be occurred.
  *
  * 1. Type `T` must be an object type
  * 2. Do not allow dynamic property
@@ -146,7 +146,7 @@ export function isFormData(): never {
  *
  * By the way, as `FormData` is not enough to express complex data structures,
  * `typia.http.validateFormData()` function has some limitations. If target type
- * `T` is not following those restrictions, compilation errors would be occured.
+ * `T` is not following those restrictions, compilation errors would be occurred.
  *
  * 1. Type `T` must be an object type
  * 2. Do not allow dynamic property
@@ -183,7 +183,7 @@ export function validateFormData(): never {
  *
  * By the way, as URL query is not enough to express complex data structures,
  * `typia.http.query()` function has some limitations. If target type `T` is not
- * following those restrictions, compilation errors would be occured.
+ * following those restrictions, compilation errors would be occurred.
  *
  *  1. Type `T` must be an object type
  *  2. Do not allow dynamic property
@@ -192,7 +192,7 @@ export function validateFormData(): never {
  *
  * Also, `typia.http.query()` function does not perform validation about the decoded
  * value. Therefore, if you can't sure that input data is following the `T` type,
- * it would better to call one of below functions intead.
+ * it would better to call one of below functions instead.
  *
  *  - {@link assertQuery}
  *  - {@link isQuery}
@@ -230,7 +230,7 @@ export function query(): never {
  *
  * By the way, as URL query is not enough to express complex data structures,
  * `typia.http.assertQuery()` function has some limitations. If target type `T` is
- * notfollowing those restrictions, compilation errors would be occured.
+ * notfollowing those restrictions, compilation errors would be occurred.
  *
  *  1. Type `T` must be an object type
  *  2. Do not allow dynamic property
@@ -270,7 +270,7 @@ export function assertQuery(): never {
  *
  * By the way, as URL query is not enough to express complex data structures,
  * `typia.http.isQuery()` function has some limitations. If target type `T` is
- * notfollowing those restrictions, compilation errors would be occured.
+ * notfollowing those restrictions, compilation errors would be occurred.
  *
  *  1. Type `T` must be an object type
  *  2. Do not allow dynamic property
@@ -309,7 +309,7 @@ export function isQuery(): never {
  *
  * By the way, as URL query is not enough to express complex data structures,
  * `typia.http.validateQuery()` function has some limitations. If target type `T` is
- * notfollowing those restrictions, compilation errors would be occured.
+ * notfollowing those restrictions, compilation errors would be occurred.
  *
  *  1. Type `T` must be an object type
  *  2. Do not allow dynamic property
@@ -345,7 +345,7 @@ export function validateQuery(): never {
  *
  * By the way, as HTTP headers are not enough to express complex data structures,
  * `typia.http.headers()` function has some limitations. If target type `T` is not
- * following those restrictions, compilation errors would be occured.
+ * following those restrictions, compilation errors would be occurred.
  *
  *  1. Type `T` must be an object type
  *  2. Do not allow dynamic property
@@ -376,7 +376,7 @@ export function validateQuery(): never {
  *
  * Also, `typia.http.headers()` function does not perform validation about the decoded
  * value. Therefore, if you can't sure that input data is following the `T` type,
- * it would better to call one of below functions intead.
+ * it would better to call one of below functions instead.
  *
  *  - {@link assertHeaders}
  *  - {@link isHeaders}
@@ -414,7 +414,7 @@ export function headers(): never {
  *
  * By the way, as HTTP headers are not enough to express complex data structures,
  * `typia.http.headers()` function has some limitations. If target type `T` is not
- * following those restrictions, compilation errors would be occured.
+ * following those restrictions, compilation errors would be occurred.
  *
  *  1. Type `T` must be an object type
  *  2. Do not allow dynamic property
@@ -478,7 +478,7 @@ export function assertHeaders(): never {
  *
  * By the way, as HTTP headers are not enough to express complex data structures,
  * `typia.http.headers()` function has some limitations. If target type `T` is not
- * following those restrictions, compilation errors would be occured.
+ * following those restrictions, compilation errors would be occurred.
  *
  *  1. Type `T` must be an object type
  *  2. Do not allow dynamic property
@@ -539,7 +539,7 @@ export function isHeaders(): never {
  *
  * By the way, as HTTP headers are not enough to express complex data structures,
  * `typia.http.headers()` function has some limitations. If target type `T` is not
- * following those restrictions, compilation errors would be occured.
+ * following those restrictions, compilation errors would be occurred.
  *
  *  1. Type `T` must be an object type
  *  2. Do not allow dynamic property

package/src/index.ts

@@ -1,4 +1,4 @@
-import * as typia from "./module";
-
-export default typia;
-export * from "./module";
+import * as typia from "./module";
+
+export default typia;
+export * from "./module";

package/src/module.ts

@@ -630,7 +630,7 @@ export function createAssert<T>(): (input: unknown) => T {
  * // MUST DECLARE THE VARIABLE TYPE
  * const func: typia.AssertionGuard<number> = typia.createAssertGuard<number>();
  *
- * // IF NOT, COMPILATION ERROR BE OCCURED
+ * // IF NOT, COMPILATION ERROR BE OCCURRED
  * const func = typia.createAssertGuard<number>();
  * ```
  *
@@ -659,7 +659,7 @@ export function createAssertGuard(
  * // MUST DECLARE THE VARIABLE TYPE
  * const func: typia.AssertionGuard<number> = typia.createAssertGuard<number>();
  *
- * // IF NOT, COMPILATION ERROR BE OCCURED
+ * // IF NOT, COMPILATION ERROR BE OCCURRED
  * const func = typia.createAssertGuard<number>();
  * ```
  *
@@ -784,7 +784,7 @@ export function createAssertEquals<T>(): (input: unknown) => T {
  * // MUST DECLARE THE VARIABLE TYPE
  * const func: typia.AssertionGuard<number> = typia.createAssertGuardEquals<number>();
  *
- * // IF NOT, COMPILATION ERROR BE OCCURED
+ * // IF NOT, COMPILATION ERROR BE OCCURRED
  * const func = typia.createAssertGuardEquals<number>();
  * ```
  *
@@ -813,7 +813,7 @@ export function createAssertGuardEquals(
  * // MUST DECLARE THE VARIABLE TYPE
  * const func: typia.AssertionGuard<number> = typia.createAssertGuardEquals<number>();
  *
- * // IF NOT, COMPILATION ERROR BE OCCURED
+ * // IF NOT, COMPILATION ERROR BE OCCURRED
  * const func = typia.createAssertGuardEquals<number>();
  * ```
  *

package/src/programmers/helpers/ICheckEntry.ts

@@ -1,13 +1,13 @@
-import ts from "typescript";
-
-export interface ICheckEntry {
-  expected: string;
-  expression: ts.Expression | null;
-  conditions: ICheckEntry.ICondition[][];
-}
-export namespace ICheckEntry {
-  export interface ICondition {
-    expected: string;
-    expression: ts.Expression;
-  }
-}
+import ts from "typescript";
+
+export interface ICheckEntry {
+  expected: string;
+  expression: ts.Expression | null;
+  conditions: ICheckEntry.ICondition[][];
+}
+export namespace ICheckEntry {
+  export interface ICondition {
+    expected: string;
+    expression: ts.Expression;
+  }
+}

package/src/programmers/helpers/IExpressionEntry.ts

@@ -1,12 +1,12 @@
-import ts from "typescript";
-
-import { Metadata } from "../../schemas/metadata/Metadata";
-
-export interface IExpressionEntry<
-  Expression extends ts.ConciseBody = ts.ConciseBody,
-> {
-  input: ts.Expression;
-  key: Metadata;
-  meta: Metadata;
-  expression: Expression;
-}
+import ts from "typescript";
+
+import { Metadata } from "../../schemas/metadata/Metadata";
+
+export interface IExpressionEntry<
+  Expression extends ts.ConciseBody = ts.ConciseBody,
+> {
+  input: ts.Expression;
+  key: Metadata;
+  meta: Metadata;
+  expression: Expression;
+}

package/src/programmers/helpers/ProtobufWire.ts

@@ -1,34 +1,34 @@
-export const enum ProtobufWire {
-  /**
-   * - integers
-   * - bool
-   * - enum
-   */
-  VARIANT = 0,
-
-  /**
-   * - fixed64
-   * - sfixed64
-   * - double
-   */
-  I64 = 1,
-
-  /**
-   * - string
-   * - bytes
-   * - mebedded messages
-   * - packed repeated fields
-   */
-  LEN = 2,
-
-  START_GROUP = 3,
-
-  END_GROUP = 4,
-
-  /**
-   * - fixed
-   * - sfixed32
-   * - float
-   */
-  I32 = 5,
-}
+export const enum ProtobufWire {
+  /**
+   * - integers
+   * - bool
+   * - enum
+   */
+  VARIANT = 0,
+
+  /**
+   * - fixed64
+   * - sfixed64
+   * - double
+   */
+  I64 = 1,
+
+  /**
+   * - string
+   * - bytes
+   * - mebedded messages
+   * - packed repeated fields
+   */
+  LEN = 2,
+
+  START_GROUP = 3,
+
+  END_GROUP = 4,
+
+  /**
+   * - fixed
+   * - sfixed32
+   * - float
+   */
+  I32 = 5,
+}

package/src/programmers/internal/stringify_native.ts

@@ -1,7 +1,7 @@
-import ts from "typescript";
-
-/**
- * @internal
- */
-export const stringify_native = (): ts.Expression =>
-  ts.factory.createStringLiteral("{}");
+import ts from "typescript";
+
+/**
+ * @internal
+ */
+export const stringify_native = (): ts.Expression =>
+  ts.factory.createStringLiteral("{}");

package/src/programmers/json/JsonApplicationProgrammer.ts

@@ -130,6 +130,33 @@ export namespace JsonApplicationProgrammer {
     };
   };
 
+  export const writeDescription = <Kind extends "summary" | "title">(props: {
+    description: string | null;
+    jsDocTags: IJsDocTagInfo[];
+    kind: Kind;
+  }): Kind extends "summary"
+    ? { summary?: string; description?: string }
+    : { title?: string; description?: string } => {
+    const title: string | undefined = (() => {
+      const [explicit] = getJsDocTexts({
+        jsDocTags: props.jsDocTags,
+        name: props.kind,
+      });
+      if (explicit?.length) return explicit;
+      else if (!props.description?.length) return undefined;
+
+      const index: number = props.description.indexOf("\n");
+      const top: string = (
+        index === -1 ? props.description : props.description.substring(0, index)
+      ).trim();
+      return top.endsWith(".") ? top.substring(0, top.length - 1) : undefined;
+    })();
+    return {
+      [props.kind]: title,
+      description: props.description?.length ? props.description : undefined,
+    } as any;
+  };
+
   const collectFunction = <Version extends "3.0" | "3.1">(props: {
     version: Version;
     name: string;
@@ -217,33 +244,6 @@ export namespace JsonApplicationProgrammer {
   };
 }
 
-const writeDescription = <Kind extends "summary" | "title">(props: {
-  description: string | null;
-  jsDocTags: IJsDocTagInfo[];
-  kind: Kind;
-}): Kind extends "summary"
-  ? { summary?: string; description?: string }
-  : { title?: string; description?: string } => {
-  const title: string | undefined = (() => {
-    const [explicit] = getJsDocTexts({
-      jsDocTags: props.jsDocTags,
-      name: props.kind,
-    });
-    if (explicit?.length) return explicit;
-    else if (!props.description?.length) return undefined;
-
-    const index: number = props.description.indexOf("\n");
-    const top: string = (
-      index === -1 ? props.description : props.description.substring(0, index)
-    ).trim();
-    return top.endsWith(".") ? top.substring(0, top.length - 1) : undefined;
-  })();
-  return {
-    [props.kind]: title,
-    description: props.description?.length ? props.description : undefined,
-  } as any;
-};
-
 const writeDescriptionFromJsDocTag = (props: {
   jsDocTags: IJsDocTagInfo[];
   name: string;