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

package/src/utils/internal/EndpointUtil.ts

@@ -1,44 +1,44 @@
-import { NamingConvention } from "../NamingConvention";
-
-export namespace EndpointUtil {
-  export const capitalize = (str: string): string =>
-    str.length !== 0 ? str[0]!.toUpperCase() + str.slice(1).toLowerCase() : str;
-
-  export const pascal = (path: string): string =>
-    splitWithNormalization(path)
-      .filter((str) => str[0] !== "{")
-      .map(NamingConvention.pascal)
-      .join("");
-
-  export const splitWithNormalization = (path: string): string[] =>
-    path
-      .split("/")
-      .map((str) => normalize(str.trim()))
-      .filter((str) => !!str.length);
-
-  export const reJoinWithDecimalParameters = (path: string) => {
-    path = path
-      .split("/")
-      .map((str) =>
-        str[0] === "{" && str[str.length - 1] === "}"
-          ? `:${str.substring(1, str.length - 1)}`
-          : str,
-      )
-      .join("/");
-    return `${path.startsWith("/") ? "" : "/"}${path}`;
-  };
-
-  export const normalize = (str: string): string => {
-    str = str.split(".").join("_").split("-").join("_").trim();
-    if (str.length === 0) return str;
-    else if (NamingConvention.reserved(str)) return `_${str}`;
-    else if (str.length !== 0 && "0" <= str[0]! && str[0]! <= "9")
-      str = `_${str}`;
-    return str;
-  };
-
-  export const escapeDuplicate =
-    (keep: string[]) =>
-    (change: string): string =>
-      keep.includes(change) ? escapeDuplicate(keep)(`_${change}`) : change;
-}
+import { NamingConvention } from "../NamingConvention";
+
+export namespace EndpointUtil {
+  export const capitalize = (str: string): string =>
+    str.length !== 0 ? str[0]!.toUpperCase() + str.slice(1).toLowerCase() : str;
+
+  export const pascal = (path: string): string =>
+    splitWithNormalization(path)
+      .filter((str) => str[0] !== "{")
+      .map(NamingConvention.pascal)
+      .join("");
+
+  export const splitWithNormalization = (path: string): string[] =>
+    path
+      .split("/")
+      .map((str) => normalize(str.trim()))
+      .filter((str) => !!str.length);
+
+  export const reJoinWithDecimalParameters = (path: string) => {
+    path = path
+      .split("/")
+      .map((str) =>
+        str[0] === "{" && str[str.length - 1] === "}"
+          ? `:${str.substring(1, str.length - 1)}`
+          : str,
+      )
+      .join("/");
+    return `${path.startsWith("/") ? "" : "/"}${path}`;
+  };
+
+  export const normalize = (str: string): string => {
+    str = str.split(".").join("_").split("-").join("_").trim();
+    if (str.length === 0) return str;
+    else if (NamingConvention.reserved(str)) return `_${str}`;
+    else if (str.length !== 0 && "0" <= str[0]! && str[0]! <= "9")
+      str = `_${str}`;
+    return str;
+  };
+
+  export const escapeDuplicate =
+    (keep: string[]) =>
+    (change: string): string =>
+      keep.includes(change) ? escapeDuplicate(keep)(`_${change}`) : change;
+}

package/src/utils/internal/JsonDescriptor.ts

@@ -1,70 +1,70 @@
-import { OpenApi } from "@typia/interface";
-
-import { OpenApiTypeChecker } from "../../validators/OpenApiTypeChecker";
-import { NamingConvention } from "../NamingConvention";
-
-export namespace JsonDescriptor {
-  export const cascade = (props: {
-    prefix: string;
-    components: OpenApi.IComponents;
-    schema: OpenApi.IJsonSchema.IReference;
-    escape: boolean;
-  }): string | undefined => {
-    const accessors: string[] = (
-      props.schema.$ref.split(props.prefix)[1] ??
-      props.schema.$ref.split("/").at(-1)!
-    ).split(".");
-    const pReferences: IParentReference[] = accessors
-      .slice(0, props.escape ? accessors.length : accessors.length - 1)
-      .map((_, i, array) => array.slice(0, i + 1).join("."))
-      .map((key) => ({
-        key,
-        description: props.components.schemas?.[key]?.description,
-      }))
-      .reverse()
-      .filter(
-        (schema, i): schema is IParentReference =>
-          i === 0 || !!schema?.description,
-      );
-    if (!props.schema.description?.length && pReferences.length === 0)
-      return undefined;
-    return [
-      ...(!!props.schema.description?.length ? [props.schema.description] : []),
-      ...pReferences.map((pRef, i) =>
-        pRef.description === undefined
-          ? `Current Type: {@link ${pRef.key}}`
-          : `Description of the ${i === 0 && props.escape ? "current" : "parent"} {@link ${pRef.key}} type:\n\n` +
-            pRef.description
-              .split("\n")
-              .map((str) => `> ${str}`)
-              .join("\n"),
-      ),
-    ].join("\n\n------------------------------\n\n");
-  };
-
-  export const take = (o: OpenApi.IJsonSchema.IObject): string | undefined => {
-    const result: string = [
-      ...(!!o.description?.length ? [o.description] : []),
-      ...Object.entries(o.properties ?? {})
-        .filter(
-          ([_key, value]) =>
-            OpenApiTypeChecker.isReference(value) &&
-            !!value.description?.length,
-        )
-        .map(
-          ([key, value]) =>
-            `### Description of {@link ${NamingConvention.variable(key) ? key : JSON.stringify(key)}} property:\n\n` +
-            (value.description ?? "")
-              .split("\n")
-              .map((str) => `> ${str}`)
-              .join("\n"),
-        ),
-    ].join("\n\n");
-    return !!result.length ? result : undefined;
-  };
-}
-
-interface IParentReference {
-  key: string;
-  description: string | undefined;
-}
+import { OpenApi } from "@typia/interface";
+
+import { OpenApiTypeChecker } from "../../validators/OpenApiTypeChecker";
+import { NamingConvention } from "../NamingConvention";
+
+export namespace JsonDescriptor {
+  export const cascade = (props: {
+    prefix: string;
+    components: OpenApi.IComponents;
+    schema: OpenApi.IJsonSchema.IReference;
+    escape: boolean;
+  }): string | undefined => {
+    const accessors: string[] = (
+      props.schema.$ref.split(props.prefix)[1] ??
+      props.schema.$ref.split("/").at(-1)!
+    ).split(".");
+    const pReferences: IParentReference[] = accessors
+      .slice(0, props.escape ? accessors.length : accessors.length - 1)
+      .map((_, i, array) => array.slice(0, i + 1).join("."))
+      .map((key) => ({
+        key,
+        description: props.components.schemas?.[key]?.description,
+      }))
+      .reverse()
+      .filter(
+        (schema, i): schema is IParentReference =>
+          i === 0 || !!schema?.description,
+      );
+    if (!props.schema.description?.length && pReferences.length === 0)
+      return undefined;
+    return [
+      ...(!!props.schema.description?.length ? [props.schema.description] : []),
+      ...pReferences.map((pRef, i) =>
+        pRef.description === undefined
+          ? `Current Type: {@link ${pRef.key}}`
+          : `Description of the ${i === 0 && props.escape ? "current" : "parent"} {@link ${pRef.key}} type:\n\n` +
+            pRef.description
+              .split("\n")
+              .map((str) => `> ${str}`)
+              .join("\n"),
+      ),
+    ].join("\n\n------------------------------\n\n");
+  };
+
+  export const take = (o: OpenApi.IJsonSchema.IObject): string | undefined => {
+    const result: string = [
+      ...(!!o.description?.length ? [o.description] : []),
+      ...Object.entries(o.properties ?? {})
+        .filter(
+          ([_key, value]) =>
+            OpenApiTypeChecker.isReference(value) &&
+            !!value.description?.length,
+        )
+        .map(
+          ([key, value]) =>
+            `### Description of {@link ${NamingConvention.variable(key) ? key : JSON.stringify(key)}} property:\n\n` +
+            (value.description ?? "")
+              .split("\n")
+              .map((str) => `> ${str}`)
+              .join("\n"),
+        ),
+    ].join("\n\n");
+    return !!result.length ? result : undefined;
+  };
+}
+
+interface IParentReference {
+  key: string;
+  description: string | undefined;
+}