@typia/utils 12.0.0-dev.20260225

package/lib/utils/index.js

@@ -0,0 +1,24 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./ArrayUtil"), exports);
+__exportStar(require("./MapUtil"), exports);
+__exportStar(require("./NamingConvention"), exports);
+__exportStar(require("./Singleton"), exports);
+__exportStar(require("./StringUtil"), exports);
+__exportStar(require("./dedent"), exports);
+__exportStar(require("./stringifyValidationFailure"), exports);
+//# sourceMappingURL=index.js.map

package/lib/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,4CAA0B;AAC1B,qDAAmC;AACnC,8CAA4B;AAC5B,+CAA6B;AAE7B,2CAAyB;AACzB,+DAA6C"}

package/lib/utils/index.mjs

@@ -0,0 +1,8 @@
+export { ArrayUtil } from './ArrayUtil.mjs';
+export { MapUtil } from './MapUtil.mjs';
+export { NamingConvention } from './NamingConvention.mjs';
+export { Singleton } from './Singleton.mjs';
+export { StringUtil } from './StringUtil.mjs';
+export { dedent } from './dedent.mjs';
+export { stringifyValidationFailure } from './stringifyValidationFailure.mjs';
+//# sourceMappingURL=index.mjs.map

package/lib/utils/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;"}

package/lib/utils/internal/EndpointUtil.d.ts

@@ -0,0 +1,8 @@
+export declare namespace EndpointUtil {
+    const capitalize: (str: string) => string;
+    const pascal: (path: string) => string;
+    const splitWithNormalization: (path: string) => string[];
+    const reJoinWithDecimalParameters: (path: string) => string;
+    const normalize: (str: string) => string;
+    const escapeDuplicate: (keep: string[]) => (change: string) => string;
+}

package/lib/utils/internal/EndpointUtil.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EndpointUtil = void 0;
+const NamingConvention_1 = require("../NamingConvention");
+var EndpointUtil;
+(function (EndpointUtil) {
+    EndpointUtil.capitalize = (str) => str.length !== 0 ? str[0].toUpperCase() + str.slice(1).toLowerCase() : str;
+    EndpointUtil.pascal = (path) => EndpointUtil.splitWithNormalization(path)
+        .filter((str) => str[0] !== "{")
+        .map(NamingConvention_1.NamingConvention.pascal)
+        .join("");
+    EndpointUtil.splitWithNormalization = (path) => path
+        .split("/")
+        .map((str) => EndpointUtil.normalize(str.trim()))
+        .filter((str) => !!str.length);
+    EndpointUtil.reJoinWithDecimalParameters = (path) => {
+        path = path
+            .split("/")
+            .map((str) => str[0] === "{" && str[str.length - 1] === "}"
+            ? `:${str.substring(1, str.length - 1)}`
+            : str)
+            .join("/");
+        return `${path.startsWith("/") ? "" : "/"}${path}`;
+    };
+    EndpointUtil.normalize = (str) => {
+        str = str.split(".").join("_").split("-").join("_").trim();
+        if (str.length === 0)
+            return str;
+        else if (NamingConvention_1.NamingConvention.reserved(str))
+            return `_${str}`;
+        else if (str.length !== 0 && "0" <= str[0] && str[0] <= "9")
+            str = `_${str}`;
+        return str;
+    };
+    EndpointUtil.escapeDuplicate = (keep) => (change) => keep.includes(change) ? EndpointUtil.escapeDuplicate(keep)(`_${change}`) : change;
+})(EndpointUtil || (exports.EndpointUtil = EndpointUtil = {}));
+//# sourceMappingURL=EndpointUtil.js.map

package/lib/utils/internal/EndpointUtil.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EndpointUtil.js","sourceRoot":"","sources":["../../../src/utils/internal/EndpointUtil.ts"],"names":[],"mappings":";;;AAAA,0DAAuD;AAEvD,IAAiB,YAAY,CAyC5B;AAzCD,WAAiB,YAAY;IACd,uBAAU,GAAG,CAAC,GAAW,EAAU,EAAE,CAChD,GAAG,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAE,CAAC,WAAW,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;IAEjE,mBAAM,GAAG,CAAC,IAAY,EAAU,EAAE,CAC7C,aAAA,sBAAsB,CAAC,IAAI,CAAC;SACzB,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC;SAC/B,GAAG,CAAC,mCAAgB,CAAC,MAAM,CAAC;SAC5B,IAAI,CAAC,EAAE,CAAC,CAAC;IAED,mCAAsB,GAAG,CAAC,IAAY,EAAY,EAAE,CAC/D,IAAI;SACD,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,aAAA,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;SACnC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAEtB,wCAA2B,GAAG,CAAC,IAAY,EAAE,EAAE;QAC1D,IAAI,GAAG,IAAI;aACR,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CACX,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,GAAG;YAC3C,CAAC,CAAC,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE;YACxC,CAAC,CAAC,GAAG,CACR;aACA,IAAI,CAAC,GAAG,CAAC,CAAC;QACb,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,EAAE,CAAC;IACrD,CAAC,CAAC;IAEW,sBAAS,GAAG,CAAC,GAAW,EAAU,EAAE;QAC/C,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QAC3D,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,GAAG,CAAC;aAC5B,IAAI,mCAAgB,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,OAAO,IAAI,GAAG,EAAE,CAAC;aACrD,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,CAAE,IAAI,GAAG,CAAC,CAAC,CAAE,IAAI,GAAG;YAC3D,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;QAClB,OAAO,GAAG,CAAC;IACb,CAAC,CAAC;IAEW,4BAAe,GAC1B,CAAC,IAAc,EAAE,EAAE,CACnB,CAAC,MAAc,EAAU,EAAE,CACzB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,aAAA,eAAe,CAAC,IAAI,CAAC,CAAC,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;AAC3E,CAAC,EAzCgB,YAAY,4BAAZ,YAAY,QAyC5B"}

package/lib/utils/internal/EndpointUtil.mjs

@@ -0,0 +1,37 @@
+import { NamingConvention } from '../NamingConvention.mjs';
+
+var EndpointUtil;
+(function (EndpointUtil) {
+    EndpointUtil.capitalize = (str) => str.length !== 0 ? str[0].toUpperCase() + str.slice(1).toLowerCase() : str;
+    EndpointUtil.pascal = (path) => EndpointUtil.splitWithNormalization(path)
+        .filter((str) => str[0] !== "{")
+        .map(NamingConvention.pascal)
+        .join("");
+    EndpointUtil.splitWithNormalization = (path) => path
+        .split("/")
+        .map((str) => EndpointUtil.normalize(str.trim()))
+        .filter((str) => !!str.length);
+    EndpointUtil.reJoinWithDecimalParameters = (path) => {
+        path = path
+            .split("/")
+            .map((str) => str[0] === "{" && str[str.length - 1] === "}"
+            ? `:${str.substring(1, str.length - 1)}`
+            : str)
+            .join("/");
+        return `${path.startsWith("/") ? "" : "/"}${path}`;
+    };
+    EndpointUtil.normalize = (str) => {
+        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;
+    };
+    EndpointUtil.escapeDuplicate = (keep) => (change) => keep.includes(change) ? EndpointUtil.escapeDuplicate(keep)(`_${change}`) : change;
+})(EndpointUtil || (EndpointUtil = {}));
+
+export { EndpointUtil };
+//# sourceMappingURL=EndpointUtil.mjs.map

package/lib/utils/internal/EndpointUtil.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"EndpointUtil.mjs","sources":["../../../src/utils/internal/EndpointUtil.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAEM,IAAW;AAAjB,CAAA,UAAiB,YAAY,EAAA;AACd,IAAA,YAAA,CAAA,UAAU,GAAG,CAAC,GAAW,KACpC,GAAG,CAAC,MAAM,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAE,CAAC,WAAW,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,GAAG;IAEhE,YAAA,CAAA,MAAM,GAAG,CAAC,IAAY,KACjC,YAAA,CAAA,sBAAsB,CAAC,IAAI;AACxB,SAAA,MAAM,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG;AAC9B,SAAA,GAAG,CAAC,gBAAgB,CAAC,MAAM;SAC3B,IAAI,CAAC,EAAE,CAAC;AAEA,IAAA,YAAA,CAAA,sBAAsB,GAAG,CAAC,IAAY,KACjD;SACG,KAAK,CAAC,GAAG;AACT,SAAA,GAAG,CAAC,CAAC,GAAG,KAAK,YAAA,CAAA,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;AAClC,SAAA,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC;AAErB,IAAA,YAAA,CAAA,2BAA2B,GAAG,CAAC,IAAY,KAAI;AAC1D,QAAA,IAAI,GAAG;aACJ,KAAK,CAAC,GAAG;aACT,GAAG,CAAC,CAAC,GAAG,KACP,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK;AACxC,cAAE,CAAA,CAAA,EAAI,GAAG,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;cACpC,GAAG;aAER,IAAI,CAAC,GAAG,CAAC;AACZ,QAAA,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,GAAG,CAAA,EAAG,IAAI,EAAE;AACpD,IAAA,CAAC;AAEY,IAAA,YAAA,CAAA,SAAS,GAAG,CAAC,GAAW,KAAY;QAC/C,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE;AAC1D,QAAA,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;AAAE,YAAA,OAAO,GAAG;AAC3B,aAAA,IAAI,gBAAgB,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,OAAO,CAAA,CAAA,EAAI,GAAG,CAAA,CAAE;AACpD,aAAA,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,CAAE,IAAI,GAAG,CAAC,CAAC,CAAE,IAAI,GAAG;AAC3D,YAAA,GAAG,GAAG,CAAA,CAAA,EAAI,GAAG,CAAA,CAAE;AACjB,QAAA,OAAO,GAAG;AACZ,IAAA,CAAC;AAEY,IAAA,YAAA,CAAA,eAAe,GAC1B,CAAC,IAAc,KACf,CAAC,MAAc,KACb,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,YAAA,CAAA,eAAe,CAAC,IAAI,CAAC,CAAC,CAAA,CAAA,EAAI,MAAM,EAAE,CAAC,GAAG,MAAM;AAC1E,CAAC,EAzCgB,YAAY,KAAZ,YAAY,GAAA,EAAA,CAAA,CAAA;;;;"}

package/lib/utils/internal/JsonDescriptor.d.ts

@@ -0,0 +1,10 @@
+import { OpenApi } from "@typia/interface";
+export declare namespace JsonDescriptor {
+    const cascade: (props: {
+        prefix: string;
+        components: OpenApi.IComponents;
+        schema: OpenApi.IJsonSchema.IReference;
+        escape: boolean;
+    }) => string | undefined;
+    const take: (o: OpenApi.IJsonSchema.IObject) => string | undefined;
+}

package/lib/utils/internal/JsonDescriptor.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JsonDescriptor = void 0;
+const OpenApiTypeChecker_1 = require("../../validators/OpenApiTypeChecker");
+const NamingConvention_1 = require("../NamingConvention");
+var JsonDescriptor;
+(function (JsonDescriptor) {
+    JsonDescriptor.cascade = (props) => {
+        var _a, _b, _c;
+        const accessors = ((_a = props.schema.$ref.split(props.prefix)[1]) !== null && _a !== void 0 ? _a : props.schema.$ref.split("/").at(-1)).split(".");
+        const pReferences = accessors
+            .slice(0, props.escape ? accessors.length : accessors.length - 1)
+            .map((_, i, array) => array.slice(0, i + 1).join("."))
+            .map((key) => {
+            var _a, _b;
+            return ({
+                key,
+                description: (_b = (_a = props.components.schemas) === null || _a === void 0 ? void 0 : _a[key]) === null || _b === void 0 ? void 0 : _b.description,
+            });
+        })
+            .reverse()
+            .filter((schema, i) => i === 0 || !!(schema === null || schema === void 0 ? void 0 : schema.description));
+        if (!((_b = props.schema.description) === null || _b === void 0 ? void 0 : _b.length) && pReferences.length === 0)
+            return undefined;
+        return [
+            ...(!!((_c = props.schema.description) === null || _c === void 0 ? void 0 : _c.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");
+    };
+    JsonDescriptor.take = (o) => {
+        var _a, _b;
+        const result = [
+            ...(!!((_a = o.description) === null || _a === void 0 ? void 0 : _a.length) ? [o.description] : []),
+            ...Object.entries((_b = o.properties) !== null && _b !== void 0 ? _b : {})
+                .filter(([_key, value]) => {
+                var _a;
+                return OpenApiTypeChecker_1.OpenApiTypeChecker.isReference(value) &&
+                    !!((_a = value.description) === null || _a === void 0 ? void 0 : _a.length);
+            })
+                .map(([key, value]) => {
+                var _a;
+                return `### Description of {@link ${NamingConvention_1.NamingConvention.variable(key) ? key : JSON.stringify(key)}} property:\n\n` +
+                    ((_a = value.description) !== null && _a !== void 0 ? _a : "")
+                        .split("\n")
+                        .map((str) => `> ${str}`)
+                        .join("\n");
+            }),
+        ].join("\n\n");
+        return !!result.length ? result : undefined;
+    };
+})(JsonDescriptor || (exports.JsonDescriptor = JsonDescriptor = {}));
+//# sourceMappingURL=JsonDescriptor.js.map

package/lib/utils/internal/JsonDescriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsonDescriptor.js","sourceRoot":"","sources":["../../../src/utils/internal/JsonDescriptor.ts"],"names":[],"mappings":"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"}

package/lib/utils/internal/JsonDescriptor.mjs

@@ -0,0 +1,48 @@
+import { OpenApiTypeChecker } from '../../validators/OpenApiTypeChecker.mjs';
+import { NamingConvention } from '../NamingConvention.mjs';
+
+var JsonDescriptor;
+(function (JsonDescriptor) {
+    JsonDescriptor.cascade = (props) => {
+        const accessors = (props.schema.$ref.split(props.prefix)[1] ??
+            props.schema.$ref.split("/").at(-1)).split(".");
+        const pReferences = 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) => 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");
+    };
+    JsonDescriptor.take = (o) => {
+        const result = [
+            ...(!!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;
+    };
+})(JsonDescriptor || (JsonDescriptor = {}));
+
+export { JsonDescriptor };
+//# sourceMappingURL=JsonDescriptor.mjs.map

package/lib/utils/internal/JsonDescriptor.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsonDescriptor.mjs","sources":["../../../src/utils/internal/JsonDescriptor.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/lib/utils/internal/OpenApiTypeCheckerBase.d.ts

@@ -0,0 +1 @@
+export {};