@typia/utils 12.0.0-dev.20260225

package/lib/http/internal/HttpMigrateRouteFetcher.mjs

@@ -0,0 +1,174 @@
+import { HttpError } from '../HttpError.mjs';
+
+var HttpMigrateRouteFetcher;
+(function (HttpMigrateRouteFetcher) {
+    HttpMigrateRouteFetcher.execute = async (props) => {
+        const result = await _Propagate("request", props);
+        props.route.success?.media;
+        if (result.status !== 200 && result.status !== 201)
+            throw new HttpError(props.route.method.toUpperCase(), props.route.path, result.status, result.headers, result.body);
+        return result.body;
+    };
+    HttpMigrateRouteFetcher.propagate = (props) => _Propagate("propagate", props);
+})(HttpMigrateRouteFetcher || (HttpMigrateRouteFetcher = {}));
+const _Propagate = async (from, props) => {
+    // VALIDATE PARAMETERS
+    const error = (message) => new Error(`Error on MigrateRouteFetcher.${from}(): ${message}`);
+    if (Array.isArray(props.parameters)) {
+        if (props.route.parameters.length !== props.parameters.length)
+            throw error(`number of parameters is not matched.`);
+    }
+    else if (props.route.parameters.every((p) => props.parameters[p.key] !== undefined) === false)
+        throw error(`number of parameters is not matched.`);
+    // VALIDATE QUERY
+    if (!!props.route.query !== !!props.query)
+        throw error(`query is not matched.`);
+    else if (!!props.route.body !== (props.body !== undefined))
+        throw error(`body is not matched.`);
+    // INIT REQUEST DATA
+    const headers = {
+        ...(props.connection.headers ?? {}),
+        ...(props.route.body?.type &&
+            props.route.body.type !== "multipart/form-data"
+            ? { "Content-Type": props.route.body.type }
+            : {}),
+    };
+    const init = {
+        ...(props.connection.options ?? {}),
+        method: props.route.method.toUpperCase(),
+        headers: (() => {
+            const output = [];
+            for (const [key, value] of Object.entries(headers))
+                if (value === undefined)
+                    continue;
+                else if (Array.isArray(value))
+                    for (const v of value)
+                        output.push([key, String(v)]);
+                else
+                    output.push([key, String(value)]);
+            return output;
+        })(),
+    };
+    if (props.body !== undefined)
+        init.body = (props.route.body?.type === "application/x-www-form-urlencoded"
+            ? requestQueryBody(props.body)
+            : props.route.body?.type === "multipart/form-data"
+                ? requestFormDataBody(props.body)
+                : props.route.body?.type === "application/json"
+                    ? JSON.stringify(props.body)
+                    : props.body);
+    // DO REQUEST
+    const resolvedPath = props.connection.host.endsWith("/") === false &&
+        props.route.emendedPath.startsWith("/") === false
+        ? `/${getPath(props)}`
+        : getPath(props);
+    const url = new URL(`${props.connection.host}${resolvedPath}`);
+    const response = await (props.connection.fetch ?? fetch)(url, init);
+    const status = response.status;
+    const out = (body) => ({
+        status,
+        headers: responseHeaders(response.headers),
+        body,
+    });
+    if (status === 200 || status === 201) {
+        // SUCCESS CASE
+        if (props.route.method.toUpperCase() === "HEAD")
+            return out(undefined);
+        else if (props.route.success === null ||
+            props.route.success.type === "text/plain")
+            return out(await response.text());
+        else if (props.route.success.type === "application/json") {
+            const text = await response.text();
+            return out(text.length ? JSON.parse(text) : undefined);
+        }
+        else if (props.route.success.type === "application/x-www-form-urlencoded")
+            return out(new URLSearchParams(await response.text()));
+        else if (props.route.success.type === "multipart/form-data")
+            return out(await response.formData());
+        throw error("Unsupported response body type.");
+    }
+    else {
+        // FAILURE CASE
+        const type = (response.headers.get("content-type") ??
+            response.headers.get("Content-Type") ??
+            "")
+            .split(";")[0]
+            .trim();
+        if (type === "" || type.startsWith("text/"))
+            return out(await response.text());
+        else if (type === "application/json")
+            return out(await response.json());
+        else if (type === "application/x-www-form-urlencoded")
+            return out(new URLSearchParams(await response.text()));
+        else if (type === "multipart/form-data")
+            return out(await response.formData());
+        else if (type === "application/octet-stream")
+            return out(await response.blob());
+        return out(await response.text());
+    }
+};
+const getPath = (props) => {
+    let path = props.route.emendedPath;
+    props.route.parameters.forEach((p, i) => {
+        path = path.replace(`:${p.key}`, encodeURIComponent(String((Array.isArray(props.parameters)
+            ? props.parameters[i]
+            : props.parameters[p.key]) ?? "null")));
+    });
+    if (props.route.query)
+        path += getQueryPath(props.query ?? {});
+    return path;
+};
+const getQueryPath = (query) => {
+    const variables = new URLSearchParams();
+    for (const [key, value] of Object.entries(query))
+        if (undefined === value)
+            continue;
+        else if (Array.isArray(value))
+            value.forEach((elem) => variables.append(key, String(elem)));
+        else
+            variables.set(key, String(value));
+    return 0 === variables.size ? "" : `?${variables.toString()}`;
+};
+const requestQueryBody = (input) => {
+    const q = new URLSearchParams();
+    for (const [key, value] of Object.entries(input))
+        if (value === undefined)
+            continue;
+        else if (Array.isArray(value))
+            value.forEach((elem) => q.append(key, String(elem)));
+        else
+            q.set(key, String(value));
+    return q;
+};
+const requestFormDataBody = (input) => {
+    const encoded = new FormData();
+    const append = (key) => (value) => {
+        if (value === undefined)
+            return;
+        else if (typeof File === "function" && value instanceof File)
+            encoded.append(key, value, value.name);
+        else
+            encoded.append(key, value);
+    };
+    for (const [key, value] of Object.entries(input))
+        if (Array.isArray(value))
+            value.map(append(key));
+        else
+            append(key)(value);
+    return encoded;
+};
+const responseHeaders = (headers) => {
+    const output = {};
+    headers.forEach((value, key) => {
+        if (key === "set-cookie") {
+            output[key] ??= [];
+            output[key].push(...value.split(";").map((str) => str.trim()));
+        }
+        else
+            output[key] = value;
+    });
+    return output;
+};
+
+export { HttpMigrateRouteFetcher };
+//# sourceMappingURL=HttpMigrateRouteFetcher.mjs.map

package/lib/http/internal/HttpMigrateRouteFetcher.mjs.map

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

package/lib/http/internal/LlmDataMerger.d.ts

@@ -0,0 +1,48 @@
+import { ILlmFunction } from "@typia/interface";
+/**
+ * Data combiner for LLM function call.
+ *
+ * @author Samchon
+ */
+export declare namespace LlmDataMerger {
+    /** Properties of {@link parameters} function. */
+    interface IProps {
+        /** Target function to call. */
+        function: ILlmFunction;
+        /** Arguments composed by LLM (Large Language Model). */
+        llm: object | null;
+        /** Arguments composed by human. */
+        human: object | null;
+    }
+    /**
+     * Combine LLM and human arguments into one.
+     *
+     * When you compose {@link IHttpLlmApplication} with
+     * {@link IHttpLlmApplication.IConfig.separate} option, then the arguments of
+     * the target function would be separated into two parts; LLM (Large Language
+     * Model) and human.
+     *
+     * In that case, you can combine both LLM and human composed arguments into
+     * one by utilizing this {@link LlmDataMerger.parameters} function, referencing
+     * the target function metadata {@link ILlmFunction.separated}.
+     *
+     * @param props Properties to combine LLM and human arguments with metadata.
+     * @returns Combined arguments
+     */
+    const parameters: (props: IProps) => object;
+    /**
+     * Combine two values into one.
+     *
+     * If both values are objects, then combines them in the properties level.
+     *
+     * Otherwise, returns the latter value if it's not null, otherwise the former
+     * value
+     *
+     * - `return (y ?? x)`
+     *
+     * @param x Value X
+     * @param y Value Y
+     * @returns Combined value
+     */
+    const value: (x: unknown, y: unknown) => unknown;
+}

package/lib/http/internal/LlmDataMerger.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LlmDataMerger = void 0;
+/**
+ * Data combiner for LLM function call.
+ *
+ * @author Samchon
+ */
+var LlmDataMerger;
+(function (LlmDataMerger) {
+    /**
+     * Combine LLM and human arguments into one.
+     *
+     * When you compose {@link IHttpLlmApplication} with
+     * {@link IHttpLlmApplication.IConfig.separate} option, then the arguments of
+     * the target function would be separated into two parts; LLM (Large Language
+     * Model) and human.
+     *
+     * In that case, you can combine both LLM and human composed arguments into
+     * one by utilizing this {@link LlmDataMerger.parameters} function, referencing
+     * the target function metadata {@link ILlmFunction.separated}.
+     *
+     * @param props Properties to combine LLM and human arguments with metadata.
+     * @returns Combined arguments
+     */
+    LlmDataMerger.parameters = (props) => {
+        const separated = props.function.separated;
+        if (separated === undefined)
+            throw new Error("Error on LlmDataMerger.parameters(): the function parameters are not separated.");
+        return LlmDataMerger.value(props.llm, props.human);
+    };
+    /**
+     * Combine two values into one.
+     *
+     * If both values are objects, then combines them in the properties level.
+     *
+     * Otherwise, returns the latter value if it's not null, otherwise the former
+     * value
+     *
+     * - `return (y ?? x)`
+     *
+     * @param x Value X
+     * @param y Value Y
+     * @returns Combined value
+     */
+    LlmDataMerger.value = (x, y) => typeof x === "object" && typeof y === "object" && x !== null && y !== null
+        ? combineObject(x, y)
+        : Array.isArray(x) && Array.isArray(y)
+            ? new Array(Math.max(x.length, y.length))
+                .fill(0)
+                .map((_, i) => LlmDataMerger.value(x[i], y[i]))
+            : (y !== null && y !== void 0 ? y : x);
+    const combineObject = (x, y) => {
+        const output = Object.assign({}, x);
+        for (const [k, v] of Object.entries(y))
+            output[k] = LlmDataMerger.value(x[k], v);
+        return output;
+    };
+})(LlmDataMerger || (exports.LlmDataMerger = LlmDataMerger = {}));
+//# sourceMappingURL=LlmDataMerger.js.map

package/lib/http/internal/LlmDataMerger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LlmDataMerger.js","sourceRoot":"","sources":["../../../src/http/internal/LlmDataMerger.ts"],"names":[],"mappings":";;;AAEA;;;;GAIG;AACH,IAAiB,aAAa,CAiE7B;AAjED,WAAiB,aAAa;IAa5B;;;;;;;;;;;;;;OAcG;IACU,wBAAU,GAAG,CAAC,KAAa,EAAU,EAAE;QAClD,MAAM,SAAS,GAAG,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC;QAC3C,IAAI,SAAS,KAAK,SAAS;YACzB,MAAM,IAAI,KAAK,CACb,iFAAiF,CAClF,CAAC;QACJ,OAAO,cAAA,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,KAAK,CAAW,CAAC;IACjD,CAAC,CAAC;IAEF;;;;;;;;;;;;;OAaG;IACU,mBAAK,GAAG,CAAC,CAAU,EAAE,CAAU,EAAW,EAAE,CACvD,OAAO,CAAC,KAAK,QAAQ,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,IAAI;QACxE,CAAC,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC;QACrB,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;YACpC,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;iBACpC,IAAI,CAAC,CAAC,CAAC;iBACP,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,cAAA,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACrC,CAAC,CAAC,CAAC,CAAC,aAAD,CAAC,cAAD,CAAC,GAAI,CAAC,CAAC,CAAC;IAEjB,MAAM,aAAa,GAAG,CAAC,CAAM,EAAE,CAAM,EAAO,EAAE;QAC5C,MAAM,MAAM,qBAAa,CAAC,CAAE,CAAC;QAC7B,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;YAAE,MAAM,CAAC,CAAC,CAAC,GAAG,cAAA,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACnE,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC,EAjEgB,aAAa,6BAAb,aAAa,QAiE7B"}

package/lib/http/internal/LlmDataMerger.mjs

@@ -0,0 +1,59 @@
+/**
+ * Data combiner for LLM function call.
+ *
+ * @author Samchon
+ */
+var LlmDataMerger;
+(function (LlmDataMerger) {
+    /**
+     * Combine LLM and human arguments into one.
+     *
+     * When you compose {@link IHttpLlmApplication} with
+     * {@link IHttpLlmApplication.IConfig.separate} option, then the arguments of
+     * the target function would be separated into two parts; LLM (Large Language
+     * Model) and human.
+     *
+     * In that case, you can combine both LLM and human composed arguments into
+     * one by utilizing this {@link LlmDataMerger.parameters} function, referencing
+     * the target function metadata {@link ILlmFunction.separated}.
+     *
+     * @param props Properties to combine LLM and human arguments with metadata.
+     * @returns Combined arguments
+     */
+    LlmDataMerger.parameters = (props) => {
+        const separated = props.function.separated;
+        if (separated === undefined)
+            throw new Error("Error on LlmDataMerger.parameters(): the function parameters are not separated.");
+        return LlmDataMerger.value(props.llm, props.human);
+    };
+    /**
+     * Combine two values into one.
+     *
+     * If both values are objects, then combines them in the properties level.
+     *
+     * Otherwise, returns the latter value if it's not null, otherwise the former
+     * value
+     *
+     * - `return (y ?? x)`
+     *
+     * @param x Value X
+     * @param y Value Y
+     * @returns Combined value
+     */
+    LlmDataMerger.value = (x, y) => typeof x === "object" && typeof y === "object" && x !== null && y !== null
+        ? combineObject(x, y)
+        : Array.isArray(x) && Array.isArray(y)
+            ? new Array(Math.max(x.length, y.length))
+                .fill(0)
+                .map((_, i) => LlmDataMerger.value(x[i], y[i]))
+            : (y ?? x);
+    const combineObject = (x, y) => {
+        const output = { ...x };
+        for (const [k, v] of Object.entries(y))
+            output[k] = LlmDataMerger.value(x[k], v);
+        return output;
+    };
+})(LlmDataMerger || (LlmDataMerger = {}));
+
+export { LlmDataMerger };
+//# sourceMappingURL=LlmDataMerger.mjs.map

package/lib/http/internal/LlmDataMerger.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"LlmDataMerger.mjs","sources":["../../../src/http/internal/LlmDataMerger.ts"],"sourcesContent":[null],"names":[],"mappings":"AAEA;;;;AAIG;AACG,IAAW;AAAjB,CAAA,UAAiB,aAAa,EAAA;AAa5B;;;;;;;;;;;;;;AAcG;AACU,IAAA,aAAA,CAAA,UAAU,GAAG,CAAC,KAAa,KAAY;AAClD,QAAA,MAAM,SAAS,GAAG,KAAK,CAAC,QAAQ,CAAC,SAAS;QAC1C,IAAI,SAAS,KAAK,SAAS;AACzB,YAAA,MAAM,IAAI,KAAK,CACb,iFAAiF,CAClF;QACH,OAAO,aAAA,CAAA,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,KAAK,CAAW;AAChD,IAAA,CAAC;AAED;;;;;;;;;;;;;AAaG;IACU,aAAA,CAAA,KAAK,GAAG,CAAC,CAAU,EAAE,CAAU,KAC1C,OAAO,CAAC,KAAK,QAAQ,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK;AACpE,UAAE,aAAa,CAAC,CAAC,EAAE,CAAC;AACpB,UAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;AACnC,cAAE,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;iBACnC,IAAI,CAAC,CAAC;iBACN,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,aAAA,CAAA,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AACpC,eAAG,CAAC,IAAI,CAAC,CAAC;AAEhB,IAAA,MAAM,aAAa,GAAG,CAAC,CAAM,EAAE,CAAM,KAAS;AAC5C,QAAA,MAAM,MAAM,GAAQ,EAAE,GAAG,CAAC,EAAE;AAC5B,QAAA,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;AAAE,YAAA,MAAM,CAAC,CAAC,CAAC,GAAG,cAAA,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAClE,QAAA,OAAO,MAAM;AACf,IAAA,CAAC;AACH,CAAC,EAjEgB,aAAa,KAAb,aAAa,GAAA,EAAA,CAAA,CAAA;;;;"}

package/lib/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./converters/index";
+export * from "./http/index";
+export * from "./utils/index";
+export * from "./validators/index";

package/lib/index.js

@@ -0,0 +1,21 @@
+"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("./converters/index"), exports);
+__exportStar(require("./http/index"), exports);
+__exportStar(require("./utils/index"), exports);
+__exportStar(require("./validators/index"), exports);
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,qDAAmC;AACnC,+CAA6B;AAC7B,gDAA8B;AAC9B,qDAAmC"}

package/lib/index.mjs

@@ -0,0 +1,20 @@
+export { ArrayUtil } from './utils/ArrayUtil.mjs';
+export { HttpError } from './http/HttpError.mjs';
+export { HttpLlm } from './http/HttpLlm.mjs';
+export { HttpMigration } from './http/HttpMigration.mjs';
+export { LlmSchemaConverter } from './converters/LlmSchemaConverter.mjs';
+export { LlmTypeChecker } from './validators/LlmTypeChecker.mjs';
+export { MapUtil } from './utils/MapUtil.mjs';
+export { NamingConvention } from './utils/NamingConvention.mjs';
+export { OpenApiConverter } from './converters/OpenApiConverter.mjs';
+export { OpenApiExclusiveEmender } from './converters/internal/OpenApiExclusiveEmender.mjs';
+export { OpenApiTypeChecker } from './validators/OpenApiTypeChecker.mjs';
+export { OpenApiV3TypeChecker } from './validators/OpenApiV3TypeChecker.mjs';
+export { OpenApiV3_1TypeChecker } from './validators/OpenApiV3_1TypeChecker.mjs';
+export { OpenApiValidator } from './validators/OpenApiValidator.mjs';
+export { Singleton } from './utils/Singleton.mjs';
+export { StringUtil } from './utils/StringUtil.mjs';
+export { SwaggerV2TypeChecker } from './validators/SwaggerV2TypeChecker.mjs';
+export { dedent } from './utils/dedent.mjs';
+export { stringifyValidationFailure } from './utils/stringifyValidationFailure.mjs';
+//# sourceMappingURL=index.mjs.map

package/lib/index.mjs.map

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

package/lib/utils/ArrayUtil.d.ts

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

package/lib/utils/ArrayUtil.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ArrayUtil = void 0;
+/** @internal */
+var ArrayUtil;
+(function (ArrayUtil) {
+    ArrayUtil.has = (array, pred) => array.some(pred);
+    ArrayUtil.add = (array, value, pred = (x, y) => x === y) => {
+        if (array.some((elem) => pred(elem, value)))
+            return false;
+        array.push(value);
+        return true;
+    };
+    ArrayUtil.set = (array, value, key) => {
+        if (array.some((elem) => key(elem) === key(value)))
+            return;
+        array.push(value);
+    };
+    ArrayUtil.take = (array, pred, init) => {
+        const index = array.findIndex(pred);
+        if (index !== -1)
+            return array[index];
+        const elem = init();
+        array.push(elem);
+        return elem;
+    };
+    ArrayUtil.repeat = (count, closure) => new Array(count).fill("").map((_, index) => closure(index, count));
+})(ArrayUtil || (exports.ArrayUtil = ArrayUtil = {}));
+//# sourceMappingURL=ArrayUtil.js.map

package/lib/utils/ArrayUtil.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArrayUtil.js","sourceRoot":"","sources":["../../src/utils/ArrayUtil.ts"],"names":[],"mappings":";;;AAAA,gBAAgB;AAChB,IAAiB,SAAS,CAwCzB;AAxCD,WAAiB,SAAS;IACX,aAAG,GAAG,CAAI,KAAU,EAAE,IAA0B,EAAW,EAAE,CACxE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEN,aAAG,GAAG,CACjB,KAAU,EACV,KAAQ,EACR,OAAgC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,EACxC,EAAE;QACX,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;QAC1D,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClB,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;IAEW,aAAG,GAAG,CACjB,KAAU,EACV,KAAQ,EACR,GAAqB,EACf,EAAE;QACR,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,KAAK,CAAC,CAAC;YAAE,OAAO;QAC3D,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC,CAAC;IAEW,cAAI,GAAG,CAClB,KAAU,EACV,IAA0B,EAC1B,IAAa,EACV,EAAE;QACL,MAAM,KAAK,GAAW,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,KAAK,KAAK,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC,KAAK,CAAE,CAAC;QAEvC,MAAM,IAAI,GAAM,IAAI,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;IAEW,gBAAM,GAAG,CACpB,KAAa,EACb,OAA4C,EACvC,EAAE,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;AAC/E,CAAC,EAxCgB,SAAS,yBAAT,SAAS,QAwCzB"}

package/lib/utils/ArrayUtil.mjs

@@ -0,0 +1,28 @@
+/** @internal */
+var ArrayUtil;
+(function (ArrayUtil) {
+    ArrayUtil.has = (array, pred) => array.some(pred);
+    ArrayUtil.add = (array, value, pred = (x, y) => x === y) => {
+        if (array.some((elem) => pred(elem, value)))
+            return false;
+        array.push(value);
+        return true;
+    };
+    ArrayUtil.set = (array, value, key) => {
+        if (array.some((elem) => key(elem) === key(value)))
+            return;
+        array.push(value);
+    };
+    ArrayUtil.take = (array, pred, init) => {
+        const index = array.findIndex(pred);
+        if (index !== -1)
+            return array[index];
+        const elem = init();
+        array.push(elem);
+        return elem;
+    };
+    ArrayUtil.repeat = (count, closure) => new Array(count).fill("").map((_, index) => closure(index, count));
+})(ArrayUtil || (ArrayUtil = {}));
+
+export { ArrayUtil };
+//# sourceMappingURL=ArrayUtil.mjs.map

package/lib/utils/ArrayUtil.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArrayUtil.mjs","sources":["../../src/utils/ArrayUtil.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA;AACM,IAAW;AAAjB,CAAA,UAAiB,SAAS,EAAA;AACX,IAAA,SAAA,CAAA,GAAG,GAAG,CAAI,KAAU,EAAE,IAA0B,KAC3D,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;AAEL,IAAA,SAAA,CAAA,GAAG,GAAG,CACjB,KAAU,EACV,KAAQ,EACR,OAAgC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,KACtC;AACX,QAAA,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAAE,YAAA,OAAO,KAAK;AACzD,QAAA,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC;AACjB,QAAA,OAAO,IAAI;AACb,IAAA,CAAC;IAEY,SAAA,CAAA,GAAG,GAAG,CACjB,KAAU,EACV,KAAQ,EACR,GAAqB,KACb;AACR,QAAA,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,KAAK,CAAC,CAAC;YAAE;AACpD,QAAA,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC;AACnB,IAAA,CAAC;IAEY,SAAA,CAAA,IAAI,GAAG,CAClB,KAAU,EACV,IAA0B,EAC1B,IAAa,KACR;QACL,MAAM,KAAK,GAAW,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC;QAC3C,IAAI,KAAK,KAAK,EAAE;AAAE,YAAA,OAAO,KAAK,CAAC,KAAK,CAAE;AAEtC,QAAA,MAAM,IAAI,GAAM,IAAI,EAAE;AACtB,QAAA,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;AAChB,QAAA,OAAO,IAAI;AACb,IAAA,CAAC;AAEY,IAAA,SAAA,CAAA,MAAM,GAAG,CACpB,KAAa,EACb,OAA4C,KACpC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AAC9E,CAAC,EAxCgB,SAAS,KAAT,SAAS,GAAA,EAAA,CAAA,CAAA;;;;"}

package/lib/utils/MapUtil.d.ts

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

package/lib/utils/MapUtil.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MapUtil = void 0;
+/** @internal */
+var MapUtil;
+(function (MapUtil) {
+    MapUtil.take = (dict, key, generator) => {
+        const oldbie = dict.get(key);
+        if (oldbie)
+            return oldbie;
+        const value = generator();
+        dict.set(key, value);
+        return value;
+    };
+})(MapUtil || (exports.MapUtil = MapUtil = {}));
+//# sourceMappingURL=MapUtil.js.map

package/lib/utils/MapUtil.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MapUtil.js","sourceRoot":"","sources":["../../src/utils/MapUtil.ts"],"names":[],"mappings":";;;AAAA,gBAAgB;AAChB,IAAiB,OAAO,CAavB;AAbD,WAAiB,OAAO;IACT,YAAI,GAAG,CAClB,IAAiB,EACjB,GAAQ,EACR,SAAkB,EACf,EAAE;QACL,MAAM,MAAM,GAAkB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5C,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;QAE1B,MAAM,KAAK,GAAM,SAAS,EAAE,CAAC;QAC7B,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACrB,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;AACJ,CAAC,EAbgB,OAAO,uBAAP,OAAO,QAavB"}

package/lib/utils/MapUtil.mjs

@@ -0,0 +1,15 @@
+/** @internal */
+var MapUtil;
+(function (MapUtil) {
+    MapUtil.take = (dict, key, generator) => {
+        const oldbie = dict.get(key);
+        if (oldbie)
+            return oldbie;
+        const value = generator();
+        dict.set(key, value);
+        return value;
+    };
+})(MapUtil || (MapUtil = {}));
+
+export { MapUtil };
+//# sourceMappingURL=MapUtil.mjs.map

package/lib/utils/MapUtil.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"MapUtil.mjs","sources":["../../src/utils/MapUtil.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA;AACM,IAAW;AAAjB,CAAA,UAAiB,OAAO,EAAA;IACT,OAAA,CAAA,IAAI,GAAG,CAClB,IAAiB,EACjB,GAAQ,EACR,SAAkB,KACb;QACL,MAAM,MAAM,GAAkB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;AAC3C,QAAA,IAAI,MAAM;AAAE,YAAA,OAAO,MAAM;AAEzB,QAAA,MAAM,KAAK,GAAM,SAAS,EAAE;AAC5B,QAAA,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC;AACpB,QAAA,OAAO,KAAK;AACd,IAAA,CAAC;AACH,CAAC,EAbgB,OAAO,KAAP,OAAO,GAAA,EAAA,CAAA,CAAA;;;;"}

package/lib/utils/NamingConvention.d.ts

@@ -0,0 +1,68 @@
+/**
+ * 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 declare namespace NamingConvention {
+    /**
+     * Convert to camelCase.
+     *
+     * @param str Input string
+     * @returns CamelCase string
+     */
+    function camel(str: string): string;
+    /**
+     * Convert to PascalCase.
+     *
+     * @param str Input string
+     * @returns PascalCase string
+     */
+    function pascal(str: string): string;
+    /**
+     * Convert to snake_case.
+     *
+     * @param str Input string
+     * @returns Snake_case string
+     */
+    function snake(str: string): string;
+    /**
+     * Capitalize first character.
+     *
+     * @param str Input string
+     * @returns Capitalized string
+     */
+    const capitalize: (str: string) => string;
+    /**
+     * Lowercase first character.
+     *
+     * @param str Input string
+     * @returns Localized string
+     */
+    const localize: (str: string) => string;
+    /**
+     * Check if string is valid JavaScript variable name.
+     *
+     * @param str String to check
+     * @returns True if valid variable name
+     */
+    const variable: (str: string) => boolean;
+    /**
+     * Check if string is JavaScript reserved word.
+     *
+     * @param str String to check
+     * @returns True if reserved word
+     */
+    const reserved: (str: string) => boolean;
+}