@typia/utils 12.0.0-dev.20260316 → 12.0.0

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2022 Jeongho Nam
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2022 Jeongho Nam
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,85 +1,85 @@
-# `@typia/utils`
-
-![Typia Logo](https://typia.io/logo.png)
-
-[![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/samchon/typia/blob/master/LICENSE)
-[![NPM Version](https://img.shields.io/npm/v/typia.svg)](https://www.npmjs.com/package/typia)
-[![NPM Downloads](https://img.shields.io/npm/dm/typia.svg)](https://www.npmjs.com/package/typia)
-[![Build Status](https://github.com/samchon/typia/workflows/test/badge.svg)](https://github.com/samchon/typia/actions?query=workflow%3Atest)
-[![Guide Documents](https://img.shields.io/badge/Guide-Documents-forestgreen)](https://typia.io/docs/)
-[![Gurubase](https://img.shields.io/badge/Gurubase-Document%20Chatbot-006BFF)](https://gurubase.io/g/typia)
-[![Discord Badge](https://img.shields.io/badge/discord-samchon-d91965?style=flat&labelColor=5866f2&logo=discord&logoColor=white&link=https://discord.gg/E94XhzrUCZ)](https://discord.gg/E94XhzrUCZ)
-
-Utility functions and converters for the [`typia`](https://github.com/samchon/typia) ecosystem.
-
-Automatically installed as a dependency of `typia`.
-
-## Key Exports
-
-| Module | Description |
-|--------|-------------|
-| `HttpLlm` | Create LLM controllers from OpenAPI documents and execute function calls |
-| `HttpMigration` | HTTP migration utilities |
-| `HttpError` | HTTP error type |
-| `OpenApiConverter` | Convert between OpenAPI versions |
-| `OpenApiTypeChecker` | Type checker for OpenAPI documents |
-| `LlmSchemaConverter` | Convert JSON Schema to LLM schema |
-| `LlmTypeChecker` | Type checker for LLM schemas |
-| `LlmJson` | Parse lenient JSON and format validation errors for LLM-friendly feedback |
-
-## `LlmJson`
-
-Parse lenient JSON and format validation errors for LLM-friendly feedback:
-
-```typescript
-import { IValidation } from "@typia/interface";
-import { LlmJson } from "@typia/utils";
-
-const validation: IValidation<unknown> = func.validate(llmArguments);
-if (validation.success === false) {
-  console.log(LlmJson.stringify(validation));
-}
-```
-
-Output:
-
-```json
-{
-  "x": "not a number", // ❌ expected: number
-  "y": 5
-}
-```
-
-## `HttpLlm`
-
-Create LLM controllers from OpenAPI documents:
-
-```typescript
-import { IHttpLlmController } from "@typia/interface";
-import { HttpLlm } from "@typia/utils";
-
-// any OpenAPI version (Swagger 2.0, OpenAPI 3.0/3.1) is accepted
-const controller: IHttpLlmController = HttpLlm.controller({
-  name: "shopping",
-  document: await fetch("https://shopping.example.com/swagger.json").then(r => r.json()),
-  connection: {
-    host: "https://shopping.example.com",
-    headers: { Authorization: "Bearer ..." },
-  },
-});
-
-// use with @typia/langchain, @typia/mcp, or @typia/vercel
-toLangChainTools({ controllers: [controller] });
-registerMcpControllers({ server, controllers: [controller] });
-toVercelTools({ controllers: [controller] });
-```
-
-`OpenApiConverter` is used internally to normalize any OpenAPI version into a unified format. You can also use it directly:
-
-```typescript
-import { OpenApi, OpenApiV3 } from "@typia/interface";
-import { OpenApiConverter } from "@typia/utils";
-
-const emended: OpenApi.IDocument = OpenApiConverter.upgradeDocument(swagger2doc); // Swagger 2.0 → OpenApi
-const downgraded: OpenApiV3.IDocument = OpenApiConverter.downgradeDocument(emended, "3.0"); // → OpenAPI 3.0
-```
+# `@typia/utils`
+
+![Typia Logo](https://typia.io/logo.png)
+
+[![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/samchon/typia/blob/master/LICENSE)
+[![NPM Version](https://img.shields.io/npm/v/typia.svg)](https://www.npmjs.com/package/typia)
+[![NPM Downloads](https://img.shields.io/npm/dm/typia.svg)](https://www.npmjs.com/package/typia)
+[![Build Status](https://github.com/samchon/typia/workflows/test/badge.svg)](https://github.com/samchon/typia/actions?query=workflow%3Atest)
+[![Guide Documents](https://img.shields.io/badge/Guide-Documents-forestgreen)](https://typia.io/docs/)
+[![Gurubase](https://img.shields.io/badge/Gurubase-Document%20Chatbot-006BFF)](https://gurubase.io/g/typia)
+[![Discord Badge](https://img.shields.io/badge/discord-samchon-d91965?style=flat&labelColor=5866f2&logo=discord&logoColor=white&link=https://discord.gg/E94XhzrUCZ)](https://discord.gg/E94XhzrUCZ)
+
+Utility functions and converters for the [`typia`](https://github.com/samchon/typia) ecosystem.
+
+Automatically installed as a dependency of `typia`.
+
+## Key Exports
+
+| Module | Description |
+|--------|-------------|
+| `HttpLlm` | Create LLM controllers from OpenAPI documents and execute function calls |
+| `HttpMigration` | HTTP migration utilities |
+| `HttpError` | HTTP error type |
+| `OpenApiConverter` | Convert between OpenAPI versions |
+| `OpenApiTypeChecker` | Type checker for OpenAPI documents |
+| `LlmSchemaConverter` | Convert JSON Schema to LLM schema |
+| `LlmTypeChecker` | Type checker for LLM schemas |
+| `LlmJson` | Parse lenient JSON and format validation errors for LLM-friendly feedback |
+
+## `LlmJson`
+
+Parse lenient JSON and format validation errors for LLM-friendly feedback:
+
+```typescript
+import { IValidation } from "@typia/interface";
+import { LlmJson } from "@typia/utils";
+
+const validation: IValidation<unknown> = func.validate(llmArguments);
+if (validation.success === false) {
+  console.log(LlmJson.stringify(validation));
+}
+```
+
+Output:
+
+```json
+{
+  "x": "not a number", // ❌ expected: number
+  "y": 5
+}
+```
+
+## `HttpLlm`
+
+Create LLM controllers from OpenAPI documents:
+
+```typescript
+import { IHttpLlmController } from "@typia/interface";
+import { HttpLlm } from "@typia/utils";
+
+// any OpenAPI version (Swagger 2.0, OpenAPI 3.0/3.1) is accepted
+const controller: IHttpLlmController = HttpLlm.controller({
+  name: "shopping",
+  document: await fetch("https://shopping.example.com/swagger.json").then(r => r.json()),
+  connection: {
+    host: "https://shopping.example.com",
+    headers: { Authorization: "Bearer ..." },
+  },
+});
+
+// use with @typia/langchain, @typia/mcp, or @typia/vercel
+toLangChainTools({ controllers: [controller] });
+registerMcpControllers({ server, controllers: [controller] });
+toVercelTools({ controllers: [controller] });
+```
+
+`OpenApiConverter` is used internally to normalize any OpenAPI version into a unified format. You can also use it directly:
+
+```typescript
+import { OpenApi, OpenApiV3 } from "@typia/interface";
+import { OpenApiConverter } from "@typia/utils";
+
+const emended: OpenApi.IDocument = OpenApiConverter.upgradeDocument(swagger2doc); // Swagger 2.0 → OpenApi
+const downgraded: OpenApiV3.IDocument = OpenApiConverter.downgradeDocument(emended, "3.0"); // → OpenAPI 3.0
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@typia/utils",
-  "version": "12.0.0-dev.20260316",
+  "version": "12.0.0",
   "description": "Superfast runtime validators with only one line",
   "main": "lib/index.js",
   "exports": {
@@ -22,7 +22,7 @@
   },
   "homepage": "https://typia.io",
   "dependencies": {
-    "@typia/interface": "^12.0.0-dev.20260316"
+    "@typia/interface": "^12.0.0"
   },
   "devDependencies": {
     "@rollup/plugin-commonjs": "^29.0.0",