@typia/utils 12.0.0-dev.20260310 → 12.0.0-dev.20260312

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (67) hide show
  1. package/lib/converters/LlmSchemaConverter.d.ts +0 -1
  2. package/lib/converters/LlmSchemaConverter.js +4 -31
  3. package/lib/converters/LlmSchemaConverter.js.map +1 -1
  4. package/lib/converters/LlmSchemaConverter.mjs +2 -32
  5. package/lib/converters/LlmSchemaConverter.mjs.map +1 -1
  6. package/lib/converters/OpenApiConverter.d.ts +29 -16
  7. package/lib/converters/OpenApiConverter.js +25 -15
  8. package/lib/converters/OpenApiConverter.js.map +1 -1
  9. package/lib/converters/OpenApiConverter.mjs +25 -15
  10. package/lib/converters/OpenApiConverter.mjs.map +1 -1
  11. package/lib/converters/internal/OpenApiV3Downgrader.js +38 -18
  12. package/lib/converters/internal/OpenApiV3Downgrader.js.map +1 -1
  13. package/lib/converters/internal/OpenApiV3Downgrader.mjs +50 -27
  14. package/lib/converters/internal/OpenApiV3Downgrader.mjs.map +1 -1
  15. package/lib/converters/internal/OpenApiV3Upgrader.js +36 -18
  16. package/lib/converters/internal/OpenApiV3Upgrader.js.map +1 -1
  17. package/lib/converters/internal/OpenApiV3Upgrader.mjs +50 -29
  18. package/lib/converters/internal/OpenApiV3Upgrader.mjs.map +1 -1
  19. package/lib/converters/internal/OpenApiV3_1Upgrader.js +38 -20
  20. package/lib/converters/internal/OpenApiV3_1Upgrader.js.map +1 -1
  21. package/lib/converters/internal/OpenApiV3_1Upgrader.mjs +51 -29
  22. package/lib/converters/internal/OpenApiV3_1Upgrader.mjs.map +1 -1
  23. package/lib/converters/internal/OpenApiV3_2Upgrader.d.ts +16 -0
  24. package/lib/converters/internal/OpenApiV3_2Upgrader.js +204 -0
  25. package/lib/converters/internal/OpenApiV3_2Upgrader.js.map +1 -0
  26. package/lib/converters/internal/OpenApiV3_2Upgrader.mjs +243 -0
  27. package/lib/converters/internal/OpenApiV3_2Upgrader.mjs.map +1 -0
  28. package/lib/converters/internal/SwaggerV2Downgrader.js +38 -18
  29. package/lib/converters/internal/SwaggerV2Downgrader.js.map +1 -1
  30. package/lib/converters/internal/SwaggerV2Downgrader.mjs +50 -27
  31. package/lib/converters/internal/SwaggerV2Downgrader.mjs.map +1 -1
  32. package/lib/converters/internal/SwaggerV2Upgrader.js +37 -19
  33. package/lib/converters/internal/SwaggerV2Upgrader.js.map +1 -1
  34. package/lib/converters/internal/SwaggerV2Upgrader.mjs +50 -29
  35. package/lib/converters/internal/SwaggerV2Upgrader.mjs.map +1 -1
  36. package/lib/http/HttpLlm.js +4 -5
  37. package/lib/http/HttpLlm.js.map +1 -1
  38. package/lib/http/HttpLlm.mjs +0 -1
  39. package/lib/http/HttpLlm.mjs.map +1 -1
  40. package/lib/http/internal/HttpLlmApplicationComposer.js +3 -4
  41. package/lib/http/internal/HttpLlmApplicationComposer.js.map +1 -1
  42. package/lib/http/internal/HttpLlmApplicationComposer.mjs +0 -1
  43. package/lib/http/internal/HttpLlmApplicationComposer.mjs.map +1 -1
  44. package/lib/http/internal/HttpMigrateApplicationComposer.js +1 -1
  45. package/lib/http/internal/HttpMigrateApplicationComposer.js.map +1 -1
  46. package/lib/http/internal/HttpMigrateApplicationComposer.mjs +1 -1
  47. package/lib/http/internal/HttpMigrateApplicationComposer.mjs.map +1 -1
  48. package/lib/http/internal/HttpMigrateRouteComposer.d.ts +1 -1
  49. package/lib/utils/LlmJson.d.ts +19 -1
  50. package/lib/utils/LlmJson.js +27 -0
  51. package/lib/utils/LlmJson.js.map +1 -1
  52. package/lib/utils/LlmJson.mjs +27 -0
  53. package/lib/utils/LlmJson.mjs.map +1 -1
  54. package/package.json +2 -2
  55. package/src/converters/LlmSchemaConverter.ts +1 -31
  56. package/src/converters/OpenApiConverter.ts +322 -285
  57. package/src/converters/internal/OpenApiV3Downgrader.ts +381 -355
  58. package/src/converters/internal/OpenApiV3Upgrader.ts +494 -470
  59. package/src/converters/internal/OpenApiV3_1Upgrader.ts +710 -685
  60. package/src/converters/internal/OpenApiV3_2Upgrader.ts +342 -0
  61. package/src/converters/internal/SwaggerV2Downgrader.ts +450 -424
  62. package/src/converters/internal/SwaggerV2Upgrader.ts +547 -523
  63. package/src/http/HttpLlm.ts +0 -1
  64. package/src/http/internal/HttpLlmApplicationComposer.ts +0 -1
  65. package/src/http/internal/HttpMigrateApplicationComposer.ts +56 -56
  66. package/src/http/internal/HttpMigrateRouteComposer.ts +505 -505
  67. package/src/utils/LlmJson.ts +173 -141
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@typia/utils",
3
- "version": "12.0.0-dev.20260310",
3
+ "version": "12.0.0-dev.20260312",
4
4
  "description": "Superfast runtime validators with only one line",
5
5
  "main": "lib/index.js",
6
6
  "exports": {
@@ -22,7 +22,7 @@
22
22
  },
23
23
  "homepage": "https://typia.io",
24
24
  "dependencies": {
25
- "@typia/interface": "^12.0.0-dev.20260310"
25
+ "@typia/interface": "^12.0.0-dev.20260312"
26
26
  },
27
27
  "devDependencies": {
28
28
  "@rollup/plugin-commonjs": "^29.0.0",
@@ -29,7 +29,6 @@ import { OpenApiConstraintShifter } from "./internal/OpenApiConstraintShifter";
29
29
  *
30
30
  * Configuration options ({@link ILlmSchema.IConfig}):
31
31
  *
32
- * - `reference`: Allow `$ref` references (reduces tokens but may confuse LLM)
33
32
  * - `strict`: OpenAI structured output mode (all properties required)
34
33
  *
35
34
  * @author Jeongho Nam - https://github.com/samchon
@@ -44,7 +43,6 @@ export namespace LlmSchemaConverter {
44
43
  export const getConfig = (
45
44
  config?: Partial<ILlmSchema.IConfig> | undefined,
46
45
  ): ILlmSchema.IConfig => ({
47
- reference: config?.reference ?? true,
48
46
  strict: config?.strict ?? false,
49
47
  });
50
48
 
@@ -238,14 +236,8 @@ export namespace LlmSchemaConverter {
238
236
  const target: OpenApi.IJsonSchema | undefined =
239
237
  props.components.schemas?.[key];
240
238
  if (target === undefined) return;
241
- else if (
239
+ else {
242
240
  // KEEP THE REFERENCE TYPE
243
- props.config.reference === true ||
244
- OpenApiTypeChecker.isRecursiveReference({
245
- components: props.components,
246
- schema: input,
247
- })
248
- ) {
249
241
  const out = () => {
250
242
  union.push({
251
243
  ...input,
@@ -267,28 +259,6 @@ export namespace LlmSchemaConverter {
267
259
  if (converted.success === false) return; // UNREACHABLE
268
260
  props.$defs[key] = converted.value;
269
261
  return out();
270
- } else {
271
- // DISCARD THE REFERENCE TYPE
272
- const length: number = union.length;
273
- visit(target, accessor);
274
- visitConstant(target);
275
- if (length === union.length - 1)
276
- union[union.length - 1] = {
277
- ...union[union.length - 1]!,
278
- description: JsonDescriptor.cascade({
279
- prefix: "#/components/schemas/",
280
- components: props.components,
281
- schema: input,
282
- escape: true,
283
- }),
284
- };
285
- else
286
- attribute.description = JsonDescriptor.cascade({
287
- prefix: "#/components/schemas/",
288
- components: props.components,
289
- schema: input,
290
- escape: true,
291
- });
292
262
  }
293
263
  } else if (OpenApiTypeChecker.isObject(input)) {
294
264
  // OBJECT TYPE