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

package/lib/utils/LlmJson.d.ts

@@ -1,4 +1,4 @@
-import { IJsonParseResult, ILlmSchema, IValidation } from "@typia/interface";
+import { IJsonParseResult, ILlmSchema, ILlmStructuredOutput, IValidation } from "@typia/interface";
 /**
  * JSON utilities for LLM function calling.
  *
@@ -84,4 +84,22 @@ export declare namespace LlmJson {
      * @returns Validator function that checks data against the schema
      */
     function validate(parameters: ILlmSchema.IParameters, equals?: boolean | undefined): (value: unknown) => IValidation<unknown>;
+    /**
+     * Convert LLM parameters schema to structured output interface.
+     *
+     * Creates an {@link ILlmStructuredOutput} containing everything needed for
+     * handling LLM structured outputs: the parameters schema for prompting, and
+     * functions for parsing, coercing, and validating responses.
+     *
+     * This is useful when you have a parameters schema (e.g., from
+     * `typia.llm.parameters()`) and need the full structured output interface
+     * with all utility functions.
+     *
+     * @template T The expected output type
+     * @param parameters LLM parameters schema
+     * @param equals If `true`, reject extraneous properties not defined in the
+     *   schema during validation. Otherwise, extra properties are ignored.
+     * @returns Structured output interface with parse, coerce, and validate
+     */
+    function structuredOutput<T>(parameters: ILlmSchema.IParameters, equals?: boolean | undefined): ILlmStructuredOutput<T>;
 }

package/lib/utils/LlmJson.js

@@ -125,5 +125,32 @@ var LlmJson;
         });
     }
     LlmJson.validate = validate;
+    /**
+     * Convert LLM parameters schema to structured output interface.
+     *
+     * Creates an {@link ILlmStructuredOutput} containing everything needed for
+     * handling LLM structured outputs: the parameters schema for prompting, and
+     * functions for parsing, coercing, and validating responses.
+     *
+     * This is useful when you have a parameters schema (e.g., from
+     * `typia.llm.parameters()`) and need the full structured output interface
+     * with all utility functions.
+     *
+     * @template T The expected output type
+     * @param parameters LLM parameters schema
+     * @param equals If `true`, reject extraneous properties not defined in the
+     *   schema during validation. Otherwise, extra properties are ignored.
+     * @returns Structured output interface with parse, coerce, and validate
+     */
+    function structuredOutput(parameters, equals) {
+        const validator = validate(parameters, equals);
+        return {
+            parameters,
+            parse: (str) => parse(str, parameters),
+            coerce: (input) => coerce(input, parameters),
+            validate: (input) => validator(input),
+        };
+    }
+    LlmJson.structuredOutput = structuredOutput;
 })(LlmJson || (exports.LlmJson = LlmJson = {}));
 //# sourceMappingURL=LlmJson.js.map

package/lib/utils/LlmJson.js.map

@@ -1 +1 @@
-{"version":3,"file":"LlmJson.js","sourceRoot":"","sources":["../../src/utils/LlmJson.ts"],"names":[],"mappings":";;;AAOA,8CAAmD;AACnD,8CAAiD;AACjD,sEAAmE;AACnE,kEAA+D;AAC/D,sFAAmF;AAEnF;;;;;;;;GAQG;AACH,IAAiB,OAAO,CAsHvB;AAtHD,WAAiB,OAAO;IACtB;;;;;;;;;;;;;;;;;;OAkBG;IACH,SAAgB,MAAM,CACpB,KAAc,EACd,UAAkC;QAElC,OAAO,IAAA,uCAAkB,EAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IAC/C,CAAC;IALe,cAAM,SAKrB,CAAA;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,SAAgB,KAAK,CACnB,KAAa,EACb,UAAmC;QAEnC,MAAM,MAAM,GAAwB,IAAA,mCAAgB,EAAI,KAAK,CAAC,CAAC;QAE/D,2EAA2E;QAC3E,IAAI,UAAU,KAAK,SAAS,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YAC/C,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE,IAAA,uCAAkB,EAAC,MAAM,CAAC,IAAI,EAAE,UAAU,CAAM;aACvD,CAAC;QACJ,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAde,aAAK,QAcpB,CAAA;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,SAAgB,SAAS,CAAC,OAA6B;QACrD,OAAO,IAAA,uDAA0B,EAAC,OAAO,CAAC,CAAC;IAC7C,CAAC;IAFe,iBAAS,YAExB,CAAA;IAED;;;;;;;;;;OAUG;IACH,SAAgB,QAAQ,CACtB,UAAkC,EAClC,MAA4B;QAE5B,MAAM,UAAU,GAAwB;YACtC,OAAO,EAAE,EAAE;SACZ,CAAC;QACF,MAAM,MAAM,GAAwB,+BAAkB,CAAC,MAAM,CAAC;YAC5D,UAAU;YACV,MAAM,EAAE,UAAU;YAClB,KAAK,EAAE,UAAU,CAAC,KAAK;SACxB,CAAC,CAAC;QACH,OAAO,6BAAgB,CAAC,MAAM,CAAC;YAC7B,UAAU;YACV,MAAM;YACN,QAAQ,EAAE,IAAI;YACd,MAAM;SACP,CAAC,CAAC;IACL,CAAC;IAlBe,gBAAQ,WAkBvB,CAAA;AACH,CAAC,EAtHgB,OAAO,uBAAP,OAAO,QAsHvB"}
+{"version":3,"file":"LlmJson.js","sourceRoot":"","sources":["../../src/utils/LlmJson.ts"],"names":[],"mappings":";;;AAQA,8CAAmD;AACnD,8CAAiD;AACjD,sEAAmE;AACnE,kEAA+D;AAC/D,sFAAmF;AAEnF;;;;;;;;GAQG;AACH,IAAiB,OAAO,CAqJvB;AArJD,WAAiB,OAAO;IACtB;;;;;;;;;;;;;;;;;;OAkBG;IACH,SAAgB,MAAM,CACpB,KAAc,EACd,UAAkC;QAElC,OAAO,IAAA,uCAAkB,EAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IAC/C,CAAC;IALe,cAAM,SAKrB,CAAA;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,SAAgB,KAAK,CACnB,KAAa,EACb,UAAmC;QAEnC,MAAM,MAAM,GAAwB,IAAA,mCAAgB,EAAI,KAAK,CAAC,CAAC;QAE/D,2EAA2E;QAC3E,IAAI,UAAU,KAAK,SAAS,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YAC/C,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE,IAAA,uCAAkB,EAAC,MAAM,CAAC,IAAI,EAAE,UAAU,CAAM;aACvD,CAAC;QACJ,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAde,aAAK,QAcpB,CAAA;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,SAAgB,SAAS,CAAC,OAA6B;QACrD,OAAO,IAAA,uDAA0B,EAAC,OAAO,CAAC,CAAC;IAC7C,CAAC;IAFe,iBAAS,YAExB,CAAA;IAED;;;;;;;;;;OAUG;IACH,SAAgB,QAAQ,CACtB,UAAkC,EAClC,MAA4B;QAE5B,MAAM,UAAU,GAAwB;YACtC,OAAO,EAAE,EAAE;SACZ,CAAC;QACF,MAAM,MAAM,GAAwB,+BAAkB,CAAC,MAAM,CAAC;YAC5D,UAAU;YACV,MAAM,EAAE,UAAU;YAClB,KAAK,EAAE,UAAU,CAAC,KAAK;SACxB,CAAC,CAAC;QACH,OAAO,6BAAgB,CAAC,MAAM,CAAC;YAC7B,UAAU;YACV,MAAM;YACN,QAAQ,EAAE,IAAI;YACd,MAAM;SACP,CAAC,CAAC;IACL,CAAC;IAlBe,gBAAQ,WAkBvB,CAAA;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,SAAgB,gBAAgB,CAC9B,UAAkC,EAClC,MAA4B;QAE5B,MAAM,SAAS,GAAG,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAC/C,OAAO;YACL,UAAU;YACV,KAAK,EAAE,CAAC,GAAW,EAAuB,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,UAAU,CAAC;YACnE,MAAM,EAAE,CAAC,KAAc,EAAK,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,UAAU,CAAC;YACxD,QAAQ,EAAE,CAAC,KAAc,EAAkB,EAAE,CAC3C,SAAS,CAAC,KAAK,CAAmB;SACrC,CAAC;IACJ,CAAC;IAZe,wBAAgB,mBAY/B,CAAA;AACH,CAAC,EArJgB,OAAO,uBAAP,OAAO,QAqJvB"}

package/lib/utils/LlmJson.mjs

@@ -130,6 +130,33 @@ var LlmJson;
         });
     }
     LlmJson.validate = validate;
+    /**
+     * Convert LLM parameters schema to structured output interface.
+     *
+     * Creates an {@link ILlmStructuredOutput} containing everything needed for
+     * handling LLM structured outputs: the parameters schema for prompting, and
+     * functions for parsing, coercing, and validating responses.
+     *
+     * This is useful when you have a parameters schema (e.g., from
+     * `typia.llm.parameters()`) and need the full structured output interface
+     * with all utility functions.
+     *
+     * @template T The expected output type
+     * @param parameters LLM parameters schema
+     * @param equals If `true`, reject extraneous properties not defined in the
+     *   schema during validation. Otherwise, extra properties are ignored.
+     * @returns Structured output interface with parse, coerce, and validate
+     */
+    function structuredOutput(parameters, equals) {
+        const validator = validate(parameters, equals);
+        return {
+            parameters,
+            parse: (str) => parse(str, parameters),
+            coerce: (input) => coerce(input, parameters),
+            validate: (input) => validator(input),
+        };
+    }
+    LlmJson.structuredOutput = structuredOutput;
 })(LlmJson || (LlmJson = {}));
 
 export { LlmJson };

package/lib/utils/LlmJson.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"LlmJson.mjs","sources":["../../src/utils/LlmJson.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;;;;;;AAaA;;;;;;;;AAQG;AACG,IAAW;AAAjB,CAAA,UAAiB,OAAO,EAAA;AACtB;;;;;;;;;;;;;;;;;;AAkBG;AACH,IAAA,SAAgB,MAAM,CACpB,KAAc,EACd,UAAkC,EAAA;AAElC,QAAA,OAAO,kBAAkB,CAAC,KAAK,EAAE,UAAU,CAAC;IAC9C;AALgB,IAAA,OAAA,CAAA,MAAM,SAKrB;AAED;;;;;;;;;;;;;;;;;;;AAmBG;AACH,IAAA,SAAgB,KAAK,CACnB,KAAa,EACb,UAAmC,EAAA;AAEnC,QAAA,MAAM,MAAM,GAAwB,gBAAgB,CAAI,KAAK,CAAC;;QAG9D,IAAI,UAAU,KAAK,SAAS,IAAI,MAAM,CAAC,OAAO,EAAE;YAC9C,OAAO;AACL,gBAAA,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE,kBAAkB,CAAC,MAAM,CAAC,IAAI,EAAE,UAAU,CAAM;aACvD;QACH;AACA,QAAA,OAAO,MAAM;IACf;AAdgB,IAAA,OAAA,CAAA,KAAK,QAcpB;AAED;;;;;;;;;;;;;;;;;;;;AAoBG;IACH,SAAgB,SAAS,CAAC,OAA6B,EAAA;AACrD,QAAA,OAAO,0BAA0B,CAAC,OAAO,CAAC;IAC5C;AAFgB,IAAA,OAAA,CAAA,SAAS,YAExB;AAED;;;;;;;;;;AAUG;AACH,IAAA,SAAgB,QAAQ,CACtB,UAAkC,EAClC,MAA4B,EAAA;AAE5B,QAAA,MAAM,UAAU,GAAwB;AACtC,YAAA,OAAO,EAAE,EAAE;SACZ;AACD,QAAA,MAAM,MAAM,GAAwB,kBAAkB,CAAC,MAAM,CAAC;YAC5D,UAAU;AACV,YAAA,MAAM,EAAE,UAAU;YAClB,KAAK,EAAE,UAAU,CAAC,KAAK;AACxB,SAAA,CAAC;QACF,OAAO,gBAAgB,CAAC,MAAM,CAAC;YAC7B,UAAU;YACV,MAAM;AACN,YAAA,QAAQ,EAAE,IAAI;YACd,MAAM;AACP,SAAA,CAAC;IACJ;AAlBgB,IAAA,OAAA,CAAA,QAAQ,WAkBvB;AACH,CAAC,EAtHgB,OAAO,KAAP,OAAO,GAAA,EAAA,CAAA,CAAA;;;;"}
+{"version":3,"file":"LlmJson.mjs","sources":["../../src/utils/LlmJson.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;;;;;;AAcA;;;;;;;;AAQG;AACG,IAAW;AAAjB,CAAA,UAAiB,OAAO,EAAA;AACtB;;;;;;;;;;;;;;;;;;AAkBG;AACH,IAAA,SAAgB,MAAM,CACpB,KAAc,EACd,UAAkC,EAAA;AAElC,QAAA,OAAO,kBAAkB,CAAC,KAAK,EAAE,UAAU,CAAC;IAC9C;AALgB,IAAA,OAAA,CAAA,MAAM,SAKrB;AAED;;;;;;;;;;;;;;;;;;;AAmBG;AACH,IAAA,SAAgB,KAAK,CACnB,KAAa,EACb,UAAmC,EAAA;AAEnC,QAAA,MAAM,MAAM,GAAwB,gBAAgB,CAAI,KAAK,CAAC;;QAG9D,IAAI,UAAU,KAAK,SAAS,IAAI,MAAM,CAAC,OAAO,EAAE;YAC9C,OAAO;AACL,gBAAA,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE,kBAAkB,CAAC,MAAM,CAAC,IAAI,EAAE,UAAU,CAAM;aACvD;QACH;AACA,QAAA,OAAO,MAAM;IACf;AAdgB,IAAA,OAAA,CAAA,KAAK,QAcpB;AAED;;;;;;;;;;;;;;;;;;;;AAoBG;IACH,SAAgB,SAAS,CAAC,OAA6B,EAAA;AACrD,QAAA,OAAO,0BAA0B,CAAC,OAAO,CAAC;IAC5C;AAFgB,IAAA,OAAA,CAAA,SAAS,YAExB;AAED;;;;;;;;;;AAUG;AACH,IAAA,SAAgB,QAAQ,CACtB,UAAkC,EAClC,MAA4B,EAAA;AAE5B,QAAA,MAAM,UAAU,GAAwB;AACtC,YAAA,OAAO,EAAE,EAAE;SACZ;AACD,QAAA,MAAM,MAAM,GAAwB,kBAAkB,CAAC,MAAM,CAAC;YAC5D,UAAU;AACV,YAAA,MAAM,EAAE,UAAU;YAClB,KAAK,EAAE,UAAU,CAAC,KAAK;AACxB,SAAA,CAAC;QACF,OAAO,gBAAgB,CAAC,MAAM,CAAC;YAC7B,UAAU;YACV,MAAM;AACN,YAAA,QAAQ,EAAE,IAAI;YACd,MAAM;AACP,SAAA,CAAC;IACJ;AAlBgB,IAAA,OAAA,CAAA,QAAQ,WAkBvB;AAED;;;;;;;;;;;;;;;;AAgBG;AACH,IAAA,SAAgB,gBAAgB,CAC9B,UAAkC,EAClC,MAA4B,EAAA;QAE5B,MAAM,SAAS,GAAG,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAC9C,OAAO;YACL,UAAU;YACV,KAAK,EAAE,CAAC,GAAW,KAA0B,KAAK,CAAC,GAAG,EAAE,UAAU,CAAC;YACnE,MAAM,EAAE,CAAC,KAAc,KAAQ,MAAM,CAAC,KAAK,EAAE,UAAU,CAAC;YACxD,QAAQ,EAAE,CAAC,KAAc,KACvB,SAAS,CAAC,KAAK,CAAmB;SACrC;IACH;AAZgB,IAAA,OAAA,CAAA,gBAAgB,mBAY/B;AACH,CAAC,EArJgB,OAAO,KAAP,OAAO,GAAA,EAAA,CAAA,CAAA;;;;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@typia/utils",
-  "version": "12.0.0-dev.20260311",
+  "version": "12.0.0-dev.20260312",
   "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.20260311"
+    "@typia/interface": "^12.0.0-dev.20260312"
   },
   "devDependencies": {
     "@rollup/plugin-commonjs": "^29.0.0",