@typia/transform 12.0.1 → 12.1.0-dev.20260325

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 (18) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +25 -25
  3. package/lib/FileTransformer.js +16 -12
  4. package/lib/FileTransformer.js.map +1 -1
  5. package/lib/FileTransformer.mjs +16 -12
  6. package/lib/FileTransformer.mjs.map +1 -1
  7. package/package.json +5 -5
  8. package/src/CallExpressionTransformer.ts +581 -581
  9. package/src/FileTransformer.ts +143 -143
  10. package/src/features/llm/LlmApplicationTransformer.ts +89 -89
  11. package/src/features/llm/LlmCoerceTransformer.ts +95 -95
  12. package/src/features/llm/LlmControllerTransformer.ts +100 -100
  13. package/src/features/llm/LlmCreateCoerceTransformer.ts +84 -84
  14. package/src/features/llm/LlmCreateParseTransformer.ts +84 -84
  15. package/src/features/llm/LlmParametersTransformer.ts +76 -76
  16. package/src/features/llm/LlmParseTransformer.ts +95 -95
  17. package/src/features/llm/LlmSchemaTransformer.ts +88 -88
  18. package/src/features/llm/LlmStructuredOutputTransformer.ts +86 -86
package/src/features/llm/LlmControllerTransformer.ts CHANGED
@@ -1,100 +1,100 @@
1
- import {
2
- LlmApplicationProgrammer,
3
- LlmControllerProgrammer,
4
- LlmMetadataFactory,
5
- MetadataCollection,
6
- MetadataFactory,
7
- MetadataSchema,
8
- } from "@typia/core";
9
- import { ILlmSchema, ValidationPipe } from "@typia/interface";
10
- import ts from "typescript";
11
-
12
- import { ITransformProps } from "../../ITransformProps";
13
- import { TransformerError } from "../../TransformerError";
14
-
15
- export namespace LlmControllerTransformer {
16
- export const transform = (props: ITransformProps): ts.Expression => {
17
- // GET GENERIC ARGUMENT
18
- if (!props.expression.typeArguments?.length)
19
- throw new TransformerError({
20
- code: "typia.llm.controller",
21
- message: "no generic argument.",
22
- });
23
- const top: ts.Node = props.expression.typeArguments[0]!;
24
- if (ts.isTypeNode(top) === false) return props.expression;
25
-
26
- if (props.expression.arguments[0] === undefined)
27
- throw new TransformerError({
28
- code: "typia.llm.controller",
29
- message: "no identifier name.",
30
- });
31
- if (props.expression.arguments[1] === undefined)
32
- throw new TransformerError({
33
- code: "typia.llm.controller",
34
- message: "no executor.",
35
- });
36
-
37
- // GET CONFIG
38
- const config:
39
- | Partial<
40
- ILlmSchema.IConfig & {
41
- equals: boolean;
42
- }
43
- >
44
- | undefined = LlmMetadataFactory.getConfig({
45
- context: props.context,
46
- method: "controller",
47
- node: props.expression.typeArguments[1],
48
- });
49
- const type: ts.Type = props.context.checker.getTypeFromTypeNode(top);
50
-
51
- // VALIDATE TYPE
52
- const analyze = (validate: boolean): MetadataSchema => {
53
- const result: ValidationPipe<MetadataSchema, MetadataFactory.IError> =
54
- MetadataFactory.analyze({
55
- checker: props.context.checker,
56
- transformer: props.context.transformer,
57
- options: {
58
- absorb: validate,
59
- escape: true,
60
- constant: true,
61
- functional: true,
62
- validate:
63
- validate === true
64
- ? (next) =>
65
- LlmApplicationProgrammer.validate({
66
- config,
67
- metadata: next.metadata,
68
- explore: next.explore,
69
- top: next.top,
70
- })
71
- : undefined,
72
- },
73
- components: new MetadataCollection({
74
- replace: MetadataCollection.replace,
75
- }),
76
- type,
77
- });
78
- if (result.success === false)
79
- throw TransformerError.from({
80
- code: "typia.llm.controller",
81
- errors: result.errors,
82
- });
83
- return result.data;
84
- };
85
- analyze(true);
86
-
87
- // GENERATE LLM CONTROLLER
88
- return LlmControllerProgrammer.write({
89
- context: props.context,
90
- modulo: props.modulo,
91
- metadata: analyze(false),
92
- className: top.getFullText().trim(),
93
- config,
94
- node: top,
95
- nameArgument: props.expression.arguments[0],
96
- executeArgument: props.expression.arguments[1],
97
- configArgument: props.expression.arguments[2],
98
- });
99
- };
100
- }
1
+ import {
2
+ LlmApplicationProgrammer,
3
+ LlmControllerProgrammer,
4
+ LlmMetadataFactory,
5
+ MetadataCollection,
6
+ MetadataFactory,
7
+ MetadataSchema,
8
+ } from "@typia/core";
9
+ import { ILlmSchema, ValidationPipe } from "@typia/interface";
10
+ import ts from "typescript";
11
+
12
+ import { ITransformProps } from "../../ITransformProps";
13
+ import { TransformerError } from "../../TransformerError";
14
+
15
+ export namespace LlmControllerTransformer {
16
+ export const transform = (props: ITransformProps): ts.Expression => {
17
+ // GET GENERIC ARGUMENT
18
+ if (!props.expression.typeArguments?.length)
19
+ throw new TransformerError({
20
+ code: "typia.llm.controller",
21
+ message: "no generic argument.",
22
+ });
23
+ const top: ts.Node = props.expression.typeArguments[0]!;
24
+ if (ts.isTypeNode(top) === false) return props.expression;
25
+
26
+ if (props.expression.arguments[0] === undefined)
27
+ throw new TransformerError({
28
+ code: "typia.llm.controller",
29
+ message: "no identifier name.",
30
+ });
31
+ if (props.expression.arguments[1] === undefined)
32
+ throw new TransformerError({
33
+ code: "typia.llm.controller",
34
+ message: "no executor.",
35
+ });
36
+
37
+ // GET CONFIG
38
+ const config:
39
+ | Partial<
40
+ ILlmSchema.IConfig & {
41
+ equals: boolean;
42
+ }
43
+ >
44
+ | undefined = LlmMetadataFactory.getConfig({
45
+ context: props.context,
46
+ method: "controller",
47
+ node: props.expression.typeArguments[1],
48
+ });
49
+ const type: ts.Type = props.context.checker.getTypeFromTypeNode(top);
50
+
51
+ // VALIDATE TYPE
52
+ const analyze = (validate: boolean): MetadataSchema => {
53
+ const result: ValidationPipe<MetadataSchema, MetadataFactory.IError> =
54
+ MetadataFactory.analyze({
55
+ checker: props.context.checker,
56
+ transformer: props.context.transformer,
57
+ options: {
58
+ absorb: validate,
59
+ escape: true,
60
+ constant: true,
61
+ functional: true,
62
+ validate:
63
+ validate === true
64
+ ? (next) =>
65
+ LlmApplicationProgrammer.validate({
66
+ config,
67
+ metadata: next.metadata,
68
+ explore: next.explore,
69
+ top: next.top,
70
+ })
71
+ : undefined,
72
+ },
73
+ components: new MetadataCollection({
74
+ replace: MetadataCollection.replace,
75
+ }),
76
+ type,
77
+ });
78
+ if (result.success === false)
79
+ throw TransformerError.from({
80
+ code: "typia.llm.controller",
81
+ errors: result.errors,
82
+ });
83
+ return result.data;
84
+ };
85
+ analyze(true);
86
+
87
+ // GENERATE LLM CONTROLLER
88
+ return LlmControllerProgrammer.write({
89
+ context: props.context,
90
+ modulo: props.modulo,
91
+ metadata: analyze(false),
92
+ className: top.getFullText().trim(),
93
+ config,
94
+ node: top,
95
+ nameArgument: props.expression.arguments[0],
96
+ executeArgument: props.expression.arguments[1],
97
+ configArgument: props.expression.arguments[2],
98
+ });
99
+ };
100
+ }
package/src/features/llm/LlmCreateCoerceTransformer.ts CHANGED
@@ -1,84 +1,84 @@
1
- import {
2
- LlmCoerceProgrammer,
3
- LlmMetadataFactory,
4
- MetadataCollection,
5
- MetadataFactory,
6
- MetadataSchema,
7
- } from "@typia/core";
8
- import { ILlmSchema, ValidationPipe } from "@typia/interface";
9
- import ts from "typescript";
10
-
11
- import { ITransformProps } from "../../ITransformProps";
12
- import { TransformerError } from "../../TransformerError";
13
-
14
- export namespace LlmCreateCoerceTransformer {
15
- export const transform = (props: ITransformProps): ts.Expression => {
16
- // GET GENERIC ARGUMENT
17
- if (!props.expression.typeArguments?.length)
18
- throw new TransformerError({
19
- code: "typia.llm.createCoerce",
20
- message: "no generic argument.",
21
- });
22
-
23
- const top: ts.Node = props.expression.typeArguments[0]!;
24
- if (ts.isTypeNode(top) === false) return props.expression;
25
-
26
- // GET TYPE AND CONFIG
27
- const config: Partial<ILlmSchema.IConfig> = LlmMetadataFactory.getConfig({
28
- context: props.context,
29
- method: "createCoerce",
30
- node: props.expression.typeArguments[1],
31
- }) as Partial<ILlmSchema.IConfig>;
32
-
33
- const type: ts.Type = props.context.checker.getTypeFromTypeNode(top);
34
-
35
- if (type.isTypeParameter())
36
- throw new TransformerError({
37
- code: "typia.llm.createCoerce",
38
- message: "non-specified generic argument.",
39
- });
40
-
41
- // VALIDATE TYPE
42
- const analyze = (validate: boolean): MetadataSchema => {
43
- const result: ValidationPipe<MetadataSchema, MetadataFactory.IError> =
44
- MetadataFactory.analyze({
45
- checker: props.context.checker,
46
- transformer: props.context.transformer,
47
- options: {
48
- absorb: validate,
49
- escape: true,
50
- constant: true,
51
- validate:
52
- validate === true
53
- ? (next) =>
54
- LlmCoerceProgrammer.validate({
55
- config,
56
- metadata: next.metadata,
57
- explore: next.explore,
58
- })
59
- : undefined,
60
- },
61
- components: new MetadataCollection({
62
- replace: MetadataCollection.replace,
63
- }),
64
- type,
65
- });
66
- if (result.success === false)
67
- throw TransformerError.from({
68
- code: "typia.llm.createCoerce",
69
- errors: result.errors,
70
- });
71
- return result.data;
72
- };
73
- analyze(true);
74
-
75
- // GENERATE CODE (factory returns the function directly)
76
- return LlmCoerceProgrammer.write({
77
- context: props.context,
78
- modulo: props.modulo,
79
- metadata: analyze(false),
80
- name: (top as ts.TypeNode).getFullText().trim(),
81
- config,
82
- });
83
- };
84
- }
1
+ import {
2
+ LlmCoerceProgrammer,
3
+ LlmMetadataFactory,
4
+ MetadataCollection,
5
+ MetadataFactory,
6
+ MetadataSchema,
7
+ } from "@typia/core";
8
+ import { ILlmSchema, ValidationPipe } from "@typia/interface";
9
+ import ts from "typescript";
10
+
11
+ import { ITransformProps } from "../../ITransformProps";
12
+ import { TransformerError } from "../../TransformerError";
13
+
14
+ export namespace LlmCreateCoerceTransformer {
15
+ export const transform = (props: ITransformProps): ts.Expression => {
16
+ // GET GENERIC ARGUMENT
17
+ if (!props.expression.typeArguments?.length)
18
+ throw new TransformerError({
19
+ code: "typia.llm.createCoerce",
20
+ message: "no generic argument.",
21
+ });
22
+
23
+ const top: ts.Node = props.expression.typeArguments[0]!;
24
+ if (ts.isTypeNode(top) === false) return props.expression;
25
+
26
+ // GET TYPE AND CONFIG
27
+ const config: Partial<ILlmSchema.IConfig> = LlmMetadataFactory.getConfig({
28
+ context: props.context,
29
+ method: "createCoerce",
30
+ node: props.expression.typeArguments[1],
31
+ }) as Partial<ILlmSchema.IConfig>;
32
+
33
+ const type: ts.Type = props.context.checker.getTypeFromTypeNode(top);
34
+
35
+ if (type.isTypeParameter())
36
+ throw new TransformerError({
37
+ code: "typia.llm.createCoerce",
38
+ message: "non-specified generic argument.",
39
+ });
40
+
41
+ // VALIDATE TYPE
42
+ const analyze = (validate: boolean): MetadataSchema => {
43
+ const result: ValidationPipe<MetadataSchema, MetadataFactory.IError> =
44
+ MetadataFactory.analyze({
45
+ checker: props.context.checker,
46
+ transformer: props.context.transformer,
47
+ options: {
48
+ absorb: validate,
49
+ escape: true,
50
+ constant: true,
51
+ validate:
52
+ validate === true
53
+ ? (next) =>
54
+ LlmCoerceProgrammer.validate({
55
+ config,
56
+ metadata: next.metadata,
57
+ explore: next.explore,
58
+ })
59
+ : undefined,
60
+ },
61
+ components: new MetadataCollection({
62
+ replace: MetadataCollection.replace,
63
+ }),
64
+ type,
65
+ });
66
+ if (result.success === false)
67
+ throw TransformerError.from({
68
+ code: "typia.llm.createCoerce",
69
+ errors: result.errors,
70
+ });
71
+ return result.data;
72
+ };
73
+ analyze(true);
74
+
75
+ // GENERATE CODE (factory returns the function directly)
76
+ return LlmCoerceProgrammer.write({
77
+ context: props.context,
78
+ modulo: props.modulo,
79
+ metadata: analyze(false),
80
+ name: (top as ts.TypeNode).getFullText().trim(),
81
+ config,
82
+ });
83
+ };
84
+ }
package/src/features/llm/LlmCreateParseTransformer.ts CHANGED
@@ -1,84 +1,84 @@
1
- import {
2
- LlmMetadataFactory,
3
- LlmParseProgrammer,
4
- MetadataCollection,
5
- MetadataFactory,
6
- MetadataSchema,
7
- } from "@typia/core";
8
- import { ILlmSchema, ValidationPipe } from "@typia/interface";
9
- import ts from "typescript";
10
-
11
- import { ITransformProps } from "../../ITransformProps";
12
- import { TransformerError } from "../../TransformerError";
13
-
14
- export namespace LlmCreateParseTransformer {
15
- export const transform = (props: ITransformProps): ts.Expression => {
16
- // GET GENERIC ARGUMENT
17
- if (!props.expression.typeArguments?.length)
18
- throw new TransformerError({
19
- code: "typia.llm.createParse",
20
- message: "no generic argument.",
21
- });
22
-
23
- const top: ts.Node = props.expression.typeArguments[0]!;
24
- if (ts.isTypeNode(top) === false) return props.expression;
25
-
26
- // GET TYPE AND CONFIG
27
- const config: Partial<ILlmSchema.IConfig> = LlmMetadataFactory.getConfig({
28
- context: props.context,
29
- method: "createParse",
30
- node: props.expression.typeArguments[1],
31
- }) as Partial<ILlmSchema.IConfig>;
32
-
33
- const type: ts.Type = props.context.checker.getTypeFromTypeNode(top);
34
-
35
- if (type.isTypeParameter())
36
- throw new TransformerError({
37
- code: "typia.llm.createParse",
38
- message: "non-specified generic argument.",
39
- });
40
-
41
- // VALIDATE TYPE
42
- const analyze = (validate: boolean): MetadataSchema => {
43
- const result: ValidationPipe<MetadataSchema, MetadataFactory.IError> =
44
- MetadataFactory.analyze({
45
- checker: props.context.checker,
46
- transformer: props.context.transformer,
47
- options: {
48
- absorb: validate,
49
- escape: true,
50
- constant: true,
51
- validate:
52
- validate === true
53
- ? (next) =>
54
- LlmParseProgrammer.validate({
55
- config,
56
- metadata: next.metadata,
57
- explore: next.explore,
58
- })
59
- : undefined,
60
- },
61
- components: new MetadataCollection({
62
- replace: MetadataCollection.replace,
63
- }),
64
- type,
65
- });
66
- if (result.success === false)
67
- throw TransformerError.from({
68
- code: "typia.llm.createParse",
69
- errors: result.errors,
70
- });
71
- return result.data;
72
- };
73
- analyze(true);
74
-
75
- // GENERATE CODE (factory returns the function directly)
76
- return LlmParseProgrammer.write({
77
- context: props.context,
78
- modulo: props.modulo,
79
- metadata: analyze(false),
80
- name: (top as ts.TypeNode).getFullText().trim(),
81
- config,
82
- });
83
- };
84
- }
1
+ import {
2
+ LlmMetadataFactory,
3
+ LlmParseProgrammer,
4
+ MetadataCollection,
5
+ MetadataFactory,
6
+ MetadataSchema,
7
+ } from "@typia/core";
8
+ import { ILlmSchema, ValidationPipe } from "@typia/interface";
9
+ import ts from "typescript";
10
+
11
+ import { ITransformProps } from "../../ITransformProps";
12
+ import { TransformerError } from "../../TransformerError";
13
+
14
+ export namespace LlmCreateParseTransformer {
15
+ export const transform = (props: ITransformProps): ts.Expression => {
16
+ // GET GENERIC ARGUMENT
17
+ if (!props.expression.typeArguments?.length)
18
+ throw new TransformerError({
19
+ code: "typia.llm.createParse",
20
+ message: "no generic argument.",
21
+ });
22
+
23
+ const top: ts.Node = props.expression.typeArguments[0]!;
24
+ if (ts.isTypeNode(top) === false) return props.expression;
25
+
26
+ // GET TYPE AND CONFIG
27
+ const config: Partial<ILlmSchema.IConfig> = LlmMetadataFactory.getConfig({
28
+ context: props.context,
29
+ method: "createParse",
30
+ node: props.expression.typeArguments[1],
31
+ }) as Partial<ILlmSchema.IConfig>;
32
+
33
+ const type: ts.Type = props.context.checker.getTypeFromTypeNode(top);
34
+
35
+ if (type.isTypeParameter())
36
+ throw new TransformerError({
37
+ code: "typia.llm.createParse",
38
+ message: "non-specified generic argument.",
39
+ });
40
+
41
+ // VALIDATE TYPE
42
+ const analyze = (validate: boolean): MetadataSchema => {
43
+ const result: ValidationPipe<MetadataSchema, MetadataFactory.IError> =
44
+ MetadataFactory.analyze({
45
+ checker: props.context.checker,
46
+ transformer: props.context.transformer,
47
+ options: {
48
+ absorb: validate,
49
+ escape: true,
50
+ constant: true,
51
+ validate:
52
+ validate === true
53
+ ? (next) =>
54
+ LlmParseProgrammer.validate({
55
+ config,
56
+ metadata: next.metadata,
57
+ explore: next.explore,
58
+ })
59
+ : undefined,
60
+ },
61
+ components: new MetadataCollection({
62
+ replace: MetadataCollection.replace,
63
+ }),
64
+ type,
65
+ });
66
+ if (result.success === false)
67
+ throw TransformerError.from({
68
+ code: "typia.llm.createParse",
69
+ errors: result.errors,
70
+ });
71
+ return result.data;
72
+ };
73
+ analyze(true);
74
+
75
+ // GENERATE CODE (factory returns the function directly)
76
+ return LlmParseProgrammer.write({
77
+ context: props.context,
78
+ modulo: props.modulo,
79
+ metadata: analyze(false),
80
+ name: (top as ts.TypeNode).getFullText().trim(),
81
+ config,
82
+ });
83
+ };
84
+ }