typia 6.6.0-dev.20240720 → 6.6.0-dev.20240727

package/src/programmers/internal/postfix_of_tuple.ts

@@ -0,0 +1,2 @@
+export const postfix_of_tuple = (str: string): string =>
+  str.endsWith('"') ? str.slice(0, -1) : `${str} + "`;

package/src/programmers/json/JsonStringifyProgrammer.ts

@@ -33,6 +33,7 @@ import { UnionExplorer } from "../helpers/UnionExplorer";
 import { check_native } from "../internal/check_native";
 import { decode_union_object } from "../internal/decode_union_object";
 import { feature_object_entries } from "../internal/feature_object_entries";
+import { postfix_of_tuple } from "../internal/postfix_of_tuple";
 import { wrap_metadata_rest_tuple } from "../internal/wrap_metadata_rest_tuple";
 
 export namespace JsonStringifyProgrammer {
@@ -543,7 +544,7 @@ export namespace JsonStringifyProgrammer {
               ...explore,
               from: "array",
               postfix: explore.postfix.length
-                ? `${explore.postfix.slice(0, -1)}[${index}]"`
+                ? `${postfix_of_tuple(explore.postfix)}[${index}]"`
                 : `"[${index}]"`,
             },
           ),

package/src/programmers/misc/MiscCloneProgrammer.ts

@@ -21,6 +21,7 @@ import { CloneJoiner } from "../helpers/CloneJoiner";
 import { FunctionImporter } from "../helpers/FunctionImporter";
 import { UnionExplorer } from "../helpers/UnionExplorer";
 import { decode_union_object } from "../internal/decode_union_object";
+import { postfix_of_tuple } from "../internal/postfix_of_tuple";
 import { wrap_metadata_rest_tuple } from "../internal/wrap_metadata_rest_tuple";
 
 export namespace MiscCloneProgrammer {
@@ -335,7 +336,7 @@ export namespace MiscCloneProgrammer {
               ...explore,
               from: "array",
               postfix: explore.postfix.length
-                ? `${explore.postfix.slice(0, -1)}[${index}]"`
+                ? `${postfix_of_tuple(explore.postfix)}[${index}]"`
                 : `"[${index}]"`,
             },
           ),

package/src/programmers/misc/MiscPruneProgrammer.ts

@@ -21,6 +21,7 @@ import { FunctionImporter } from "../helpers/FunctionImporter";
 import { PruneJoiner } from "../helpers/PruneJoiner";
 import { UnionExplorer } from "../helpers/UnionExplorer";
 import { decode_union_object } from "../internal/decode_union_object";
+import { postfix_of_tuple } from "../internal/postfix_of_tuple";
 import { wrap_metadata_rest_tuple } from "../internal/wrap_metadata_rest_tuple";
 
 export namespace MiscPruneProgrammer {
@@ -302,7 +303,7 @@ export namespace MiscPruneProgrammer {
               ...explore,
               from: "array",
               postfix: explore.postfix.length
-                ? `${explore.postfix.slice(0, -1)}[${index}]"`
+                ? `${postfix_of_tuple(explore.postfix)}[${index}]"`
                 : `"[${index}]"`,
             },
           ),

package/src/programmers/notations/NotationGeneralProgrammer.ts

@@ -23,6 +23,7 @@ import { FunctionImporter } from "../helpers/FunctionImporter";
 import { NotationJoiner } from "../helpers/NotationJoiner";
 import { UnionExplorer } from "../helpers/UnionExplorer";
 import { decode_union_object } from "../internal/decode_union_object";
+import { postfix_of_tuple } from "../internal/postfix_of_tuple";
 import { wrap_metadata_rest_tuple } from "../internal/wrap_metadata_rest_tuple";
 
 export namespace NotationGeneralProgrammer {
@@ -345,7 +346,7 @@ export namespace NotationGeneralProgrammer {
               ...explore,
               from: "array",
               postfix: explore.postfix.length
-                ? `${explore.postfix.slice(0, -1)}[${index}]"`
+                ? `${postfix_of_tuple(explore.postfix)}[${index}]"`
                 : `"[${index}]"`,
             },
           ),

package/src/schemas/metadata/IMetadataConstantValue.ts

@@ -1,8 +1,11 @@
 import { Atomic } from "../../typings/Atomic";
 
+import { IJsDocTagInfo } from "./IJsDocTagInfo";
 import { IMetadataTypeTag } from "./IMetadataTypeTag";
 
 export interface IMetadataConstantValue<T extends Atomic.Type> {
   value: T;
   tags: IMetadataTypeTag[][] | undefined;
+  description?: string | null;
+  jsDocTags?: IJsDocTagInfo[];
 }

package/src/schemas/metadata/MetadataConstantValue.ts

@@ -1,16 +1,21 @@
 import { ClassProperties } from "../../typings/ClassProperties";
 
+import { IJsDocTagInfo } from "./IJsDocTagInfo";
 import { IMetadataConstantValue } from "./IMetadataConstantValue";
 import { IMetadataTypeTag } from "./IMetadataTypeTag";
 
 export class MetadataConstantValue {
   public readonly value: boolean | bigint | number | string;
   public tags: IMetadataTypeTag[][] | undefined;
+  public readonly description?: string | null;
+  public readonly jsDocTags?: IJsDocTagInfo[];
   private name_?: string;
 
   private constructor(props: ClassProperties<MetadataConstantValue>) {
     this.value = props.value;
     this.tags = props.tags;
+    this.description = props.description;
+    this.jsDocTags = props.jsDocTags;
   }
 
   public static create(

package/src/utils/NamingConvention/NamingConvention.ts

@@ -1,6 +1,24 @@
 import { StringUtil } from "../StringUtil";
 
 export function snake(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);
@@ -23,29 +41,33 @@ export function snake(str: string): string {
     ret += "_";
   }
   ret += str.substring(indexes[indexes.length - 1]!).toLowerCase();
-  return ret;
+  return out(ret);
 }
 
-export function camel(str: string): string {
-  return unsnake((str: string) => {
-    if (str.length === 0) return str;
-    else if (str[0] === str[0]!.toUpperCase())
-      return str[0]!.toLowerCase() + str.substring(1);
-    else return str;
+export const camel = (str: string): string =>
+  unsnake({
+    plain: (str) =>
+      str.length
+        ? str === str.toUpperCase()
+          ? str.toLocaleLowerCase()
+          : `${str[0]!.toLowerCase()}${str.substring(1)}`
+        : str,
+    snake: (str, i) =>
+      i === 0 ? str.toLowerCase() : StringUtil.capitalize(str.toLowerCase()),
   })(str);
-}
 
-export function pascal(str: string): string {
-  return unsnake((str: string) => {
-    if (str.length === 0) return str;
-    else if (str[0] === str[0]!.toLowerCase())
-      return str[0]!.toUpperCase() + str.substring(1);
-    else return str;
+export const pascal = (str: string): string =>
+  unsnake({
+    plain: (str) =>
+      str.length ? `${str[0]!.toUpperCase()}${str.substring(1)}` : str,
+    snake: StringUtil.capitalize,
   })(str);
-}
 
 const unsnake =
-  (escaper: (str: string) => string) =>
+  (props: {
+    plain: (str: string) => string;
+    snake: (str: string, index: number) => string;
+  }) =>
   (str: string): string => {
     // eslint-disable-next-line @typescript-eslint/no-unused-vars
     let prefix: string = "";
@@ -55,32 +77,13 @@ const unsnake =
     }
     if (prefix.length !== 0) str = str.substring(prefix.length);
 
-    const indexes: [number, number][] = [];
-    for (let i: number = 0; i < str.length; i++) {
-      const ch: string = str[i]!;
-      if (ch !== "_") continue;
-
-      const last = indexes[indexes.length - 1];
-      if (last === undefined || last[0] + last[1] !== i) indexes.push([i, 1]);
-      else ++last[1];
-    }
-    if (indexes.length === 0) return prefix + escaper(str);
+    const out = (s: string) => `${prefix}${s}`;
+    if (str.length === 0) return out("");
 
-    // eslint-disable-next-line @typescript-eslint/no-unused-vars
-    let ret: string = "";
-    for (let i: number = 0; i < indexes.length; i++) {
-      const [first] = indexes[i]!;
-      if (i === 0)
-        if (first === 0) ret += "_";
-        else ret += str.substring(0, first);
-      else {
-        const [prevFirst, prevLength] = indexes[i - 1]!;
-        const piece: string = str.substring(prevFirst + prevLength, first);
-        if (piece.length) ret += StringUtil.capitalize(piece);
-      }
-    }
-    const last = indexes[indexes.length - 1]!;
-    const piece: string = str.substring(last[0] + last[1]);
-    if (last.length) ret += StringUtil.capitalize(piece);
-    return prefix + escaper(ret);
+    const items: string[] = str.split("_").filter((s) => s.length !== 0);
+    return items.length === 0
+      ? out("")
+      : items.length === 1
+        ? out(props.plain(items[0]!))
+        : out(items.map(props.snake).join(""));
   };

package/src/utils/StringUtil/StringUtil.ts

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