@typia/utils 12.0.0-dev.20260309 → 12.0.0-dev.20260311

package/src/utils/NamingConvention.ts

@@ -1,205 +1,205 @@
-/**
- * String naming convention converters.
- *
- * `NamingConvention` converts between common code naming conventions:
- * camelCase, PascalCase, and snake_case. Handles edge cases like consecutive
- * uppercase letters (e.g., `XMLParser` → `xml_parser`) and leading
- * underscores.
- *
- * Functions:
- *
- * - {@link camel}: Convert to camelCase (`fooBar`)
- * - {@link pascal}: Convert to PascalCase (`FooBar`)
- * - {@link snake}: Convert to snake_case (`foo_bar`)
- * - {@link variable}: Test if string is valid JavaScript variable name
- *
- * @author Jeongho Nam - https://github.com/samchon
- */
-export namespace NamingConvention {
-  /**
-   * Convert to camelCase.
-   *
-   * @param str Input string
-   * @returns CamelCase string
-   */
-  export function camel(str: string) {
-    return unsnake({
-      plain: (str) =>
-        str.length
-          ? str === str.toUpperCase()
-            ? str.toLocaleLowerCase()
-            : `${str[0]!.toLowerCase()}${str.substring(1)}`
-          : str,
-      snake: (str, i) =>
-        i === 0 ? str.toLowerCase() : capitalize(str.toLowerCase()),
-    })(str);
-  }
-
-  /**
-   * Convert to PascalCase.
-   *
-   * @param str Input string
-   * @returns PascalCase string
-   */
-  export function pascal(str: string) {
-    return unsnake({
-      plain: (str) =>
-        str.length ? `${str[0]!.toUpperCase()}${str.substring(1)}` : str,
-      snake: capitalize,
-    })(str);
-  }
-
-  /**
-   * Convert to snake_case.
-   *
-   * @param str Input string
-   * @returns Snake_case string
-   */
-  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);
-      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);
-  }
-
-  /**
-   * Capitalize first character.
-   *
-   * @param str Input string
-   * @returns Capitalized string
-   */
-  export const capitalize = (str: string): string =>
-    str.length !== 0 ? str[0]!.toUpperCase() + str.slice(1) : str;
-
-  /**
-   * Lowercase first character.
-   *
-   * @param str Input string
-   * @returns Localized string
-   */
-  export const localize = (str: string) => str[0]!.toLowerCase() + str.slice(1);
-
-  /**
-   * Check if string is valid JavaScript variable name.
-   *
-   * @param str String to check
-   * @returns True if valid variable name
-   */
-  export const variable = (str: string): boolean =>
-    reserved(str) === false && /^[a-zA-Z_$][a-zA-Z_$0-9]*$/g.test(str);
-
-  /**
-   * Check if string is JavaScript reserved word.
-   *
-   * @param str String to check
-   * @returns True if reserved word
-   */
-  export const reserved = (str: string): boolean => RESERVED.has(str);
-}
-
-const RESERVED: Set<string> = new Set([
-  "break",
-  "case",
-  "catch",
-  "class",
-  "const",
-  "continue",
-  "debugger",
-  "default",
-  "delete",
-  "do",
-  "else",
-  "enum",
-  "export",
-  "extends",
-  "false",
-  "finally",
-  "for",
-  "function",
-  "if",
-  "import",
-  "in",
-  "instanceof",
-  "module",
-  "new",
-  "null",
-  "package",
-  "public",
-  "private",
-  "protected",
-  "return",
-  "super",
-  "switch",
-  "this",
-  "throw",
-  "true",
-  "try",
-  "typeof",
-  "var",
-  "void",
-  "while",
-  "with",
-]);
-
-const unsnake =
-  (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 = "";
-    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}`;
-    if (str.length === 0) return out("");
-
-    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(""));
-  };
+/**
+ * String naming convention converters.
+ *
+ * `NamingConvention` converts between common code naming conventions:
+ * camelCase, PascalCase, and snake_case. Handles edge cases like consecutive
+ * uppercase letters (e.g., `XMLParser` → `xml_parser`) and leading
+ * underscores.
+ *
+ * Functions:
+ *
+ * - {@link camel}: Convert to camelCase (`fooBar`)
+ * - {@link pascal}: Convert to PascalCase (`FooBar`)
+ * - {@link snake}: Convert to snake_case (`foo_bar`)
+ * - {@link variable}: Test if string is valid JavaScript variable name
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export namespace NamingConvention {
+  /**
+   * Convert to camelCase.
+   *
+   * @param str Input string
+   * @returns CamelCase string
+   */
+  export function camel(str: string) {
+    return unsnake({
+      plain: (str) =>
+        str.length
+          ? str === str.toUpperCase()
+            ? str.toLocaleLowerCase()
+            : `${str[0]!.toLowerCase()}${str.substring(1)}`
+          : str,
+      snake: (str, i) =>
+        i === 0 ? str.toLowerCase() : capitalize(str.toLowerCase()),
+    })(str);
+  }
+
+  /**
+   * Convert to PascalCase.
+   *
+   * @param str Input string
+   * @returns PascalCase string
+   */
+  export function pascal(str: string) {
+    return unsnake({
+      plain: (str) =>
+        str.length ? `${str[0]!.toUpperCase()}${str.substring(1)}` : str,
+      snake: capitalize,
+    })(str);
+  }
+
+  /**
+   * Convert to snake_case.
+   *
+   * @param str Input string
+   * @returns Snake_case string
+   */
+  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);
+      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);
+  }
+
+  /**
+   * Capitalize first character.
+   *
+   * @param str Input string
+   * @returns Capitalized string
+   */
+  export const capitalize = (str: string): string =>
+    str.length !== 0 ? str[0]!.toUpperCase() + str.slice(1) : str;
+
+  /**
+   * Lowercase first character.
+   *
+   * @param str Input string
+   * @returns Localized string
+   */
+  export const localize = (str: string) => str[0]!.toLowerCase() + str.slice(1);
+
+  /**
+   * Check if string is valid JavaScript variable name.
+   *
+   * @param str String to check
+   * @returns True if valid variable name
+   */
+  export const variable = (str: string): boolean =>
+    reserved(str) === false && /^[a-zA-Z_$][a-zA-Z_$0-9]*$/g.test(str);
+
+  /**
+   * Check if string is JavaScript reserved word.
+   *
+   * @param str String to check
+   * @returns True if reserved word
+   */
+  export const reserved = (str: string): boolean => RESERVED.has(str);
+}
+
+const RESERVED: Set<string> = new Set([
+  "break",
+  "case",
+  "catch",
+  "class",
+  "const",
+  "continue",
+  "debugger",
+  "default",
+  "delete",
+  "do",
+  "else",
+  "enum",
+  "export",
+  "extends",
+  "false",
+  "finally",
+  "for",
+  "function",
+  "if",
+  "import",
+  "in",
+  "instanceof",
+  "module",
+  "new",
+  "null",
+  "package",
+  "public",
+  "private",
+  "protected",
+  "return",
+  "super",
+  "switch",
+  "this",
+  "throw",
+  "true",
+  "try",
+  "typeof",
+  "var",
+  "void",
+  "while",
+  "with",
+]);
+
+const unsnake =
+  (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 = "";
+    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}`;
+    if (str.length === 0) return out("");
+
+    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/Singleton.ts

@@ -1,17 +1,17 @@
-/** @internal */
-export class Singleton<T, Args extends any[] = []> {
-  private readonly closure_: (...args: Args) => T;
-  private value_: T | object;
-
-  public constructor(closure: (...args: Args) => T) {
-    this.closure_ = closure;
-    this.value_ = NOT_MOUNTED_YET;
-  }
-
-  public get(...args: Args): T {
-    if (this.value_ === NOT_MOUNTED_YET) this.value_ = this.closure_(...args);
-    return this.value_ as T;
-  }
-}
-
-const NOT_MOUNTED_YET = {};
+/** @internal */
+export class Singleton<T, Args extends any[] = []> {
+  private readonly closure_: (...args: Args) => T;
+  private value_: T | object;
+
+  public constructor(closure: (...args: Args) => T) {
+    this.closure_ = closure;
+    this.value_ = NOT_MOUNTED_YET;
+  }
+
+  public get(...args: Args): T {
+    if (this.value_ === NOT_MOUNTED_YET) this.value_ = this.closure_(...args);
+    return this.value_ as T;
+  }
+}
+
+const NOT_MOUNTED_YET = {};

package/src/utils/StringUtil.ts

@@ -1,14 +1,14 @@
-/** @internal */
-export namespace StringUtil {
-  export const escapeDuplicate = (props: {
-    keep: string[];
-    input: string;
-    escape?: (str: string) => string;
-  }): string =>
-    props.keep.includes(props.input)
-      ? escapeDuplicate({
-          keep: props.keep,
-          input: (props.escape ?? ((str) => `_${str}`))(props.input),
-        })
-      : props.input;
-}
+/** @internal */
+export namespace StringUtil {
+  export const escapeDuplicate = (props: {
+    keep: string[];
+    input: string;
+    escape?: (str: string) => string;
+  }): string =>
+    props.keep.includes(props.input)
+      ? escapeDuplicate({
+          keep: props.keep,
+          input: (props.escape ?? ((str) => `_${str}`))(props.input),
+        })
+      : props.input;
+}

package/src/utils/dedent.ts

@@ -1,57 +1,57 @@
-/**
- * Remove common leading whitespace from template literal.
- *
- * Strips leading/trailing blank lines and removes the minimum indentation level
- * from all lines.
- *
- * @author Jeongho Nam - https://github.com/samchon
- * @param strings Template literal strings
- * @param values Interpolated values
- * @returns Dedented string
- */
-export function dedent(
-  strings: TemplateStringsArray,
-  ...values: Array<boolean | number | string>
-): string {
-  // Combine all template string parts to understand the full structure
-  let combined: string = strings[0]!;
-  for (let i = 0; i < values.length; i++) {
-    combined += `__PLACEHOLDER_${i}__` + strings[i + 1];
-  }
-
-  // Split into lines
-  const lines = combined.split("\n");
-
-  // Remove leading and trailing empty lines
-  while (lines.length > 0 && lines[0]!.trim() === "") {
-    lines.shift();
-  }
-  while (lines.length > 0 && lines[lines.length - 1]!.trim() === "") {
-    lines.pop();
-  }
-
-  if (lines.length === 0) return "";
-
-  // Find minimum indentation from non-empty lines
-  const nonEmptyLines = lines.filter((line) => line.trim() !== "");
-  const minIndent = Math.min(
-    ...nonEmptyLines.map((line) => {
-      const match = line.match(/^[ \t]*/);
-      return match ? match[0].length : 0;
-    }),
-  );
-
-  // Remove minimum indentation from all lines
-  const dedentedLines = lines.map((line) => {
-    if (line.trim() === "") return "";
-    return line.slice(minIndent);
-  });
-
-  // Replace placeholders with actual values
-  let result = dedentedLines.join("\n");
-  for (let i = 0; i < values.length; i++) {
-    result = result.replace(`__PLACEHOLDER_${i}__`, String(values[i]));
-  }
-
-  return result;
-}
+/**
+ * Remove common leading whitespace from template literal.
+ *
+ * Strips leading/trailing blank lines and removes the minimum indentation level
+ * from all lines.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ * @param strings Template literal strings
+ * @param values Interpolated values
+ * @returns Dedented string
+ */
+export function dedent(
+  strings: TemplateStringsArray,
+  ...values: Array<boolean | number | string>
+): string {
+  // Combine all template string parts to understand the full structure
+  let combined: string = strings[0]!;
+  for (let i = 0; i < values.length; i++) {
+    combined += `__PLACEHOLDER_${i}__` + strings[i + 1];
+  }
+
+  // Split into lines
+  const lines = combined.split("\n");
+
+  // Remove leading and trailing empty lines
+  while (lines.length > 0 && lines[0]!.trim() === "") {
+    lines.shift();
+  }
+  while (lines.length > 0 && lines[lines.length - 1]!.trim() === "") {
+    lines.pop();
+  }
+
+  if (lines.length === 0) return "";
+
+  // Find minimum indentation from non-empty lines
+  const nonEmptyLines = lines.filter((line) => line.trim() !== "");
+  const minIndent = Math.min(
+    ...nonEmptyLines.map((line) => {
+      const match = line.match(/^[ \t]*/);
+      return match ? match[0].length : 0;
+    }),
+  );
+
+  // Remove minimum indentation from all lines
+  const dedentedLines = lines.map((line) => {
+    if (line.trim() === "") return "";
+    return line.slice(minIndent);
+  });
+
+  // Replace placeholders with actual values
+  let result = dedentedLines.join("\n");
+  for (let i = 0; i < values.length; i++) {
+    result = result.replace(`__PLACEHOLDER_${i}__`, String(values[i]));
+  }
+
+  return result;
+}

package/src/utils/index.ts

@@ -1,8 +1,8 @@
-export * from "./ArrayUtil";
-export * from "./LlmJson";
-export * from "./MapUtil";
-export * from "./NamingConvention";
-export * from "./Singleton";
-export * from "./StringUtil";
-
-export * from "./dedent";
+export * from "./ArrayUtil";
+export * from "./LlmJson";
+export * from "./MapUtil";
+export * from "./NamingConvention";
+export * from "./Singleton";
+export * from "./StringUtil";
+
+export * from "./dedent";