@typia/transform 12.0.0-dev.20260307-2 → 12.0.0-dev.20260310

package/src/features/llm/LlmCreateCoerceTransformer.ts

@@ -0,0 +1,84 @@
+import {
+  LlmCoerceProgrammer,
+  LlmMetadataFactory,
+  MetadataCollection,
+  MetadataFactory,
+  MetadataSchema,
+} from "@typia/core";
+import { ILlmSchema, ValidationPipe } from "@typia/interface";
+import ts from "typescript";
+
+import { ITransformProps } from "../../ITransformProps";
+import { TransformerError } from "../../TransformerError";
+
+export namespace LlmCreateCoerceTransformer {
+  export const transform = (props: ITransformProps): ts.Expression => {
+    // GET GENERIC ARGUMENT
+    if (!props.expression.typeArguments?.length)
+      throw new TransformerError({
+        code: "typia.llm.createCoerce",
+        message: "no generic argument.",
+      });
+
+    const top: ts.Node = props.expression.typeArguments[0]!;
+    if (ts.isTypeNode(top) === false) return props.expression;
+
+    // GET TYPE AND CONFIG
+    const config: Partial<ILlmSchema.IConfig> = LlmMetadataFactory.getConfig({
+      context: props.context,
+      method: "createCoerce",
+      node: props.expression.typeArguments[1],
+    }) as Partial<ILlmSchema.IConfig>;
+
+    const type: ts.Type = props.context.checker.getTypeFromTypeNode(top);
+
+    if (type.isTypeParameter())
+      throw new TransformerError({
+        code: "typia.llm.createCoerce",
+        message: "non-specified generic argument.",
+      });
+
+    // VALIDATE TYPE
+    const analyze = (validate: boolean): MetadataSchema => {
+      const result: ValidationPipe<MetadataSchema, MetadataFactory.IError> =
+        MetadataFactory.analyze({
+          checker: props.context.checker,
+          transformer: props.context.transformer,
+          options: {
+            absorb: validate,
+            escape: true,
+            constant: true,
+            validate:
+              validate === true
+                ? (metadata, explore) =>
+                    LlmCoerceProgrammer.validate({
+                      config,
+                      metadata,
+                      explore,
+                    })
+                : undefined,
+          },
+          components: new MetadataCollection({
+            replace: MetadataCollection.replace,
+          }),
+          type,
+        });
+      if (result.success === false)
+        throw TransformerError.from({
+          code: "typia.llm.createCoerce",
+          errors: result.errors,
+        });
+      return result.data;
+    };
+    analyze(true);
+
+    // GENERATE CODE (factory returns the function directly)
+    return LlmCoerceProgrammer.write({
+      context: props.context,
+      modulo: props.modulo,
+      metadata: analyze(false),
+      name: (top as ts.TypeNode).getFullText().trim(),
+      config,
+    });
+  };
+}

package/src/features/llm/LlmCreateParseTransformer.ts

@@ -0,0 +1,84 @@
+import {
+  LlmMetadataFactory,
+  LlmParseProgrammer,
+  MetadataCollection,
+  MetadataFactory,
+  MetadataSchema,
+} from "@typia/core";
+import { ILlmSchema, ValidationPipe } from "@typia/interface";
+import ts from "typescript";
+
+import { ITransformProps } from "../../ITransformProps";
+import { TransformerError } from "../../TransformerError";
+
+export namespace LlmCreateParseTransformer {
+  export const transform = (props: ITransformProps): ts.Expression => {
+    // GET GENERIC ARGUMENT
+    if (!props.expression.typeArguments?.length)
+      throw new TransformerError({
+        code: "typia.llm.createParse",
+        message: "no generic argument.",
+      });
+
+    const top: ts.Node = props.expression.typeArguments[0]!;
+    if (ts.isTypeNode(top) === false) return props.expression;
+
+    // GET TYPE AND CONFIG
+    const config: Partial<ILlmSchema.IConfig> = LlmMetadataFactory.getConfig({
+      context: props.context,
+      method: "createParse",
+      node: props.expression.typeArguments[1],
+    }) as Partial<ILlmSchema.IConfig>;
+
+    const type: ts.Type = props.context.checker.getTypeFromTypeNode(top);
+
+    if (type.isTypeParameter())
+      throw new TransformerError({
+        code: "typia.llm.createParse",
+        message: "non-specified generic argument.",
+      });
+
+    // VALIDATE TYPE
+    const analyze = (validate: boolean): MetadataSchema => {
+      const result: ValidationPipe<MetadataSchema, MetadataFactory.IError> =
+        MetadataFactory.analyze({
+          checker: props.context.checker,
+          transformer: props.context.transformer,
+          options: {
+            absorb: validate,
+            escape: true,
+            constant: true,
+            validate:
+              validate === true
+                ? (metadata, explore) =>
+                    LlmParseProgrammer.validate({
+                      config,
+                      metadata,
+                      explore,
+                    })
+                : undefined,
+          },
+          components: new MetadataCollection({
+            replace: MetadataCollection.replace,
+          }),
+          type,
+        });
+      if (result.success === false)
+        throw TransformerError.from({
+          code: "typia.llm.createParse",
+          errors: result.errors,
+        });
+      return result.data;
+    };
+    analyze(true);
+
+    // GENERATE CODE (factory returns the function directly)
+    return LlmParseProgrammer.write({
+      context: props.context,
+      modulo: props.modulo,
+      metadata: analyze(false),
+      name: (top as ts.TypeNode).getFullText().trim(),
+      config,
+    });
+  };
+}

package/src/features/llm/LlmParametersTransformer.ts

@@ -1,88 +1,76 @@
-import {
-  LiteralFactory,
-  LlmMetadataFactory,
-  LlmParametersProgrammer,
-  MetadataCollection,
-  MetadataFactory,
-  MetadataSchema,
-} from "@typia/core";
-import { ILlmSchema, ValidationPipe } from "@typia/interface";
-import ts from "typescript";
-
-import { ITransformProps } from "../../ITransformProps";
-import { TransformerError } from "../../TransformerError";
-
-export namespace LlmParametersTransformer {
-  export const transform = (
-    props: Omit<ITransformProps, "modulo">,
-  ): ts.Expression => {
-    // GET GENERIC ARGUMENT
-    if (!props.expression.typeArguments?.length)
-      throw new TransformerError({
-        code: "typia.llm.parameters",
-        message: "no generic argument.",
-      });
-
-    const top: ts.Node = props.expression.typeArguments[0]!;
-    if (ts.isTypeNode(top) === false) return props.expression;
-
-    // GET TYPE
-    const config: Partial<ILlmSchema.IConfig> = LlmMetadataFactory.getConfig({
-      context: props.context,
-      method: "parameters",
-      node: props.expression.typeArguments[1],
-    }) as Partial<ILlmSchema.IConfig>;
-
-    const type: ts.Type = props.context.checker.getTypeFromTypeNode(top);
-
-    // VALIDATE TYPE
-    const analyze = (validate: boolean): MetadataSchema => {
-      const result: ValidationPipe<MetadataSchema, MetadataFactory.IError> =
-        MetadataFactory.analyze({
-          checker: props.context.checker,
-          transformer: props.context.transformer,
-          options: {
-            absorb: validate,
-            escape: true,
-            constant: true,
-            validate:
-              validate === true
-                ? (metadata, explore) =>
-                    LlmParametersProgrammer.validate({
-                      config,
-                      metadata,
-                      explore,
-                    })
-                : undefined,
-          },
-          components: new MetadataCollection({
-            replace: MetadataCollection.replace,
-          }),
-          type,
-        });
-      if (result.success === false)
-        throw TransformerError.from({
-          code: "typia.llm.parameters",
-          errors: result.errors,
-        });
-      return result.data;
-    };
-    analyze(true);
-
-    // GENERATE LLM SCHEMA
-    const out: ILlmSchema.IParameters = LlmParametersProgrammer.write({
-      metadata: analyze(false),
-      config,
-    });
-    return ts.factory.createSatisfiesExpression(
-      LiteralFactory.write(out),
-      props.context.importer.type({
-        file: "typia",
-        name: ts.factory.createQualifiedName(
-          ts.factory.createIdentifier("ILlmSchema"),
-          ts.factory.createIdentifier("IParameters"),
-        ),
-      }),
-    );
-  };
-}
+import {
+  LlmMetadataFactory,
+  LlmParametersProgrammer,
+  MetadataCollection,
+  MetadataFactory,
+  MetadataSchema,
+} from "@typia/core";
+import { ILlmSchema, ValidationPipe } from "@typia/interface";
+import ts from "typescript";
+
+import { ITransformProps } from "../../ITransformProps";
+import { TransformerError } from "../../TransformerError";
+
+export namespace LlmParametersTransformer {
+  export const transform = (props: ITransformProps): ts.Expression => {
+    // GET GENERIC ARGUMENT
+    if (!props.expression.typeArguments?.length)
+      throw new TransformerError({
+        code: "typia.llm.parameters",
+        message: "no generic argument.",
+      });
+
+    const top: ts.Node = props.expression.typeArguments[0]!;
+    if (ts.isTypeNode(top) === false) return props.expression;
+
+    // GET TYPE
+    const config: Partial<ILlmSchema.IConfig> = LlmMetadataFactory.getConfig({
+      context: props.context,
+      method: "parameters",
+      node: props.expression.typeArguments[1],
+    }) as Partial<ILlmSchema.IConfig>;
+
+    const type: ts.Type = props.context.checker.getTypeFromTypeNode(top);
+
+    // VALIDATE TYPE
+    const analyze = (validate: boolean): MetadataSchema => {
+      const result: ValidationPipe<MetadataSchema, MetadataFactory.IError> =
+        MetadataFactory.analyze({
+          checker: props.context.checker,
+          transformer: props.context.transformer,
+          options: {
+            absorb: validate,
+            escape: true,
+            constant: true,
+            validate:
+              validate === true
+                ? (metadata, explore) =>
+                    LlmParametersProgrammer.validate({
+                      config,
+                      metadata,
+                      explore,
+                    })
+                : undefined,
+          },
+          components: new MetadataCollection({
+            replace: MetadataCollection.replace,
+          }),
+          type,
+        });
+      if (result.success === false)
+        throw TransformerError.from({
+          code: "typia.llm.parameters",
+          errors: result.errors,
+        });
+      return result.data;
+    };
+    analyze(true);
+
+    // GENERATE LLM PARAMETERS SCHEMA
+    return LlmParametersProgrammer.write({
+      context: props.context,
+      metadata: analyze(false),
+      config,
+    });
+  };
+}

package/src/features/llm/LlmParseTransformer.ts

@@ -0,0 +1,95 @@
+import {
+  LlmMetadataFactory,
+  LlmParseProgrammer,
+  MetadataCollection,
+  MetadataFactory,
+  MetadataSchema,
+} from "@typia/core";
+import { ILlmSchema, ValidationPipe } from "@typia/interface";
+import ts from "typescript";
+
+import { ITransformProps } from "../../ITransformProps";
+import { TransformerError } from "../../TransformerError";
+
+export namespace LlmParseTransformer {
+  export const transform = (props: ITransformProps): ts.Expression => {
+    // CHECK PARAMETER
+    if (props.expression.arguments.length === 0)
+      throw new TransformerError({
+        code: "typia.llm.parse",
+        message: "no input value.",
+      });
+
+    // GET GENERIC ARGUMENT
+    if (!props.expression.typeArguments?.length)
+      throw new TransformerError({
+        code: "typia.llm.parse",
+        message: "no generic argument.",
+      });
+
+    const top: ts.Node = props.expression.typeArguments[0]!;
+    if (ts.isTypeNode(top) === false) return props.expression;
+
+    // GET TYPE AND CONFIG
+    const config: Partial<ILlmSchema.IConfig> = LlmMetadataFactory.getConfig({
+      context: props.context,
+      method: "parse",
+      node: props.expression.typeArguments[1],
+    }) as Partial<ILlmSchema.IConfig>;
+
+    const type: ts.Type = props.context.checker.getTypeFromTypeNode(top);
+
+    if (type.isTypeParameter())
+      throw new TransformerError({
+        code: "typia.llm.parse",
+        message: "non-specified generic argument.",
+      });
+
+    // VALIDATE TYPE
+    const analyze = (validate: boolean): MetadataSchema => {
+      const result: ValidationPipe<MetadataSchema, MetadataFactory.IError> =
+        MetadataFactory.analyze({
+          checker: props.context.checker,
+          transformer: props.context.transformer,
+          options: {
+            absorb: validate,
+            escape: true,
+            constant: true,
+            validate:
+              validate === true
+                ? (metadata, explore) =>
+                    LlmParseProgrammer.validate({
+                      config,
+                      metadata,
+                      explore,
+                    })
+                : undefined,
+          },
+          components: new MetadataCollection({
+            replace: MetadataCollection.replace,
+          }),
+          type,
+        });
+      if (result.success === false)
+        throw TransformerError.from({
+          code: "typia.llm.parse",
+          errors: result.errors,
+        });
+      return result.data;
+    };
+    analyze(true);
+
+    // GENERATE CODE
+    return ts.factory.createCallExpression(
+      LlmParseProgrammer.write({
+        context: props.context,
+        modulo: props.modulo,
+        metadata: analyze(false),
+        name: (top as ts.TypeNode).getFullText().trim(),
+        config,
+      }),
+      undefined,
+      props.expression.arguments,
+    );
+  };
+}

package/src/features/llm/LlmSchemaTransformer.ts

@@ -1,133 +1,87 @@
-import {
-  IdentifierFactory,
-  LiteralFactory,
-  LlmMetadataFactory,
-  LlmSchemaProgrammer,
-  MetadataCollection,
-  MetadataFactory,
-  MetadataSchema,
-} from "@typia/core";
-import { ILlmSchema, ValidationPipe } from "@typia/interface";
-import ts from "typescript";
-
-import { ITransformProps } from "../../ITransformProps";
-import { TransformerError } from "../../TransformerError";
-
-export namespace LlmSchemaTransformer {
-  export const transform = (
-    props: Omit<ITransformProps, "modulo">,
-  ): ts.Expression => {
-    // GET GENERIC ARGUMENT
-    if (!props.expression.typeArguments?.length)
-      throw new TransformerError({
-        code: "typia.llm.schema",
-        message: "no generic argument.",
-      });
-
-    const top: ts.Node = props.expression.typeArguments[0]!;
-    if (ts.isTypeNode(top) === false) return props.expression;
-
-    // GET TYPE
-    const config: Partial<ILlmSchema.IConfig> = LlmMetadataFactory.getConfig({
-      context: props.context,
-      method: "schema",
-      node: props.expression.typeArguments[1],
-    }) as Partial<ILlmSchema.IConfig>;
-
-    const type: ts.Type = props.context.checker.getTypeFromTypeNode(top);
-
-    // VALIDATE TYPE
-    const analyze = (validate: boolean): MetadataSchema => {
-      const result: ValidationPipe<MetadataSchema, MetadataFactory.IError> =
-        MetadataFactory.analyze({
-          checker: props.context.checker,
-          transformer: props.context.transformer,
-          options: {
-            absorb: validate,
-            constant: true,
-            escape: true,
-            validate:
-              validate === true
-                ? (metadata: MetadataSchema) =>
-                    LlmSchemaProgrammer.validate({
-                      config,
-                      metadata,
-                    })
-                : undefined,
-          },
-          components: new MetadataCollection({
-            replace: MetadataCollection.replace,
-          }),
-          type,
-        });
-      if (result.success === false)
-        throw TransformerError.from({
-          code: "typia.llm.schema",
-          errors: result.errors,
-        });
-      return result.data;
-    };
-    analyze(true);
-
-    // GENERATE LLM SCHEMA
-    const out: LlmSchemaProgrammer.IOutput = LlmSchemaProgrammer.write({
-      metadata: analyze(false),
-      config,
-    });
-    const schemaTypeNode = props.context.importer.type({
-      file: "typia",
-      name: "ILlmSchema",
-    });
-    const literal = ts.factory.createSatisfiesExpression(
-      LiteralFactory.write(out.schema),
-      schemaTypeNode,
-    );
-    if (Object.keys(out.$defs).length === 0) return literal;
-    return ts.factory.createCallExpression(
-      ts.factory.createArrowFunction(
-        undefined,
-        undefined,
-        [
-          IdentifierFactory.parameter(
-            "$defs",
-            ts.factory.createTypeReferenceNode("Record", [
-              ts.factory.createKeywordTypeNode(ts.SyntaxKind.StringKeyword),
-              schemaTypeNode,
-            ]),
-            undefined,
-          ),
-        ],
-        undefined,
-        undefined,
-        ts.factory.createBlock(
-          [
-            ts.factory.createExpressionStatement(
-              ts.factory.createCallExpression(
-                ts.factory.createIdentifier("Object.assign"),
-                undefined,
-                [
-                  ts.factory.createIdentifier("$defs"),
-                  ts.factory.createAsExpression(
-                    LiteralFactory.write(out.$defs),
-                    ts.factory.createTypeReferenceNode("Record", [
-                      ts.factory.createKeywordTypeNode(
-                        ts.SyntaxKind.StringKeyword,
-                      ),
-                      schemaTypeNode,
-                    ]),
-                  ),
-                ],
-              ),
-            ),
-            ts.factory.createReturnStatement(literal),
-          ],
-          true,
-        ),
-      ),
-      undefined,
-      props.expression.arguments?.[0] !== undefined
-        ? [props.expression.arguments[0]!]
-        : [],
-    );
-  };
-}
+import {
+  LlmMetadataFactory,
+  LlmSchemaProgrammer,
+  MetadataCollection,
+  MetadataFactory,
+  MetadataSchema,
+} from "@typia/core";
+import { ILlmSchema, ValidationPipe } from "@typia/interface";
+import ts from "typescript";
+
+import { ITransformProps } from "../../ITransformProps";
+import { TransformerError } from "../../TransformerError";
+
+export namespace LlmSchemaTransformer {
+  export const transform = (props: ITransformProps): ts.Expression => {
+    // GET GENERIC ARGUMENT
+    if (!props.expression.typeArguments?.length)
+      throw new TransformerError({
+        code: "typia.llm.schema",
+        message: "no generic argument.",
+      });
+
+    const top: ts.Node = props.expression.typeArguments[0]!;
+    if (ts.isTypeNode(top) === false) return props.expression;
+
+    // GET TYPE
+    const config: Partial<ILlmSchema.IConfig> = LlmMetadataFactory.getConfig({
+      context: props.context,
+      method: "schema",
+      node: props.expression.typeArguments[1],
+    }) as Partial<ILlmSchema.IConfig>;
+
+    const type: ts.Type = props.context.checker.getTypeFromTypeNode(top);
+
+    // VALIDATE TYPE
+    const analyze = (validate: boolean): MetadataSchema => {
+      const result: ValidationPipe<MetadataSchema, MetadataFactory.IError> =
+        MetadataFactory.analyze({
+          checker: props.context.checker,
+          transformer: props.context.transformer,
+          options: {
+            absorb: validate,
+            constant: true,
+            escape: true,
+            validate:
+              validate === true
+                ? (metadata: MetadataSchema) =>
+                    LlmSchemaProgrammer.validate({
+                      config,
+                      metadata,
+                    })
+                : undefined,
+          },
+          components: new MetadataCollection({
+            replace: MetadataCollection.replace,
+          }),
+          type,
+        });
+      if (result.success === false)
+        throw TransformerError.from({
+          code: "typia.llm.schema",
+          errors: result.errors,
+        });
+      return result.data;
+    };
+    analyze(true);
+
+    // GENERATE LLM SCHEMA
+    const expr = LlmSchemaProgrammer.write({
+      context: props.context,
+      metadata: analyze(false),
+      config,
+    });
+
+    // If user provided $defs argument and expression is a function, call it with $defs
+    if (
+      props.expression.arguments?.[0] !== undefined &&
+      ts.isArrowFunction(expr)
+    ) {
+      return ts.factory.createCallExpression(expr, undefined, [
+        props.expression.arguments[0]!,
+      ]);
+    }
+
+    return expr;
+  };
+}