typia 9.7.2 → 10.0.0-dev.20251107

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 (116) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +153 -153
  3. package/lib/factories/ProtobufFactory.js +1 -1
  4. package/lib/factories/ProtobufFactory.mjs +1 -1
  5. package/lib/programmers/internal/json_schema_station.d.mts +2 -2
  6. package/lib/programmers/internal/json_schema_station.d.ts +2 -2
  7. package/lib/programmers/llm/LlmApplicationProgrammer.js +5 -1
  8. package/lib/programmers/llm/LlmApplicationProgrammer.js.map +1 -1
  9. package/lib/programmers/llm/LlmApplicationProgrammer.mjs +5 -1
  10. package/lib/programmers/llm/LlmSchemaProgrammer.js +1 -4
  11. package/lib/programmers/llm/LlmSchemaProgrammer.js.map +1 -1
  12. package/lib/programmers/llm/LlmSchemaProgrammer.mjs +1 -35
  13. package/package.json +121 -121
  14. package/src/AssertionGuard.ts +41 -41
  15. package/src/CamelCase.ts +75 -75
  16. package/src/IRandomGenerator.ts +337 -337
  17. package/src/IReadableURLSearchParams.ts +9 -9
  18. package/src/PascalCase.ts +71 -71
  19. package/src/Primitive.ts +90 -90
  20. package/src/Resolved.ts +72 -72
  21. package/src/SnakeCase.ts +127 -127
  22. package/src/TypeGuardError.ts +216 -216
  23. package/src/factories/MetadataCollection.ts +270 -270
  24. package/src/factories/MetadataCommentTagFactory.ts +632 -632
  25. package/src/factories/MetadataFactory.ts +402 -402
  26. package/src/factories/ProtobufFactory.ts +873 -873
  27. package/src/functional.ts +705 -705
  28. package/src/http.ts +972 -972
  29. package/src/internal/_ProtobufReader.ts +188 -188
  30. package/src/internal/_ProtobufSizer.ts +137 -137
  31. package/src/internal/_ProtobufWriter.ts +135 -135
  32. package/src/internal/_jsonStringifyString.ts +42 -42
  33. package/src/json.ts +643 -643
  34. package/src/llm.ts +615 -615
  35. package/src/misc.ts +594 -594
  36. package/src/module.ts +889 -889
  37. package/src/notations.ts +751 -751
  38. package/src/programmers/FeatureProgrammer.ts +605 -605
  39. package/src/programmers/ImportProgrammer.ts +179 -179
  40. package/src/programmers/RandomProgrammer.ts +1195 -1195
  41. package/src/programmers/helpers/ProtobufWire.ts +34 -34
  42. package/src/programmers/internal/check_array_length.ts +43 -43
  43. package/src/programmers/internal/check_bigint.ts +46 -46
  44. package/src/programmers/internal/check_dynamic_key.ts +197 -197
  45. package/src/programmers/internal/check_dynamic_properties.ts +231 -231
  46. package/src/programmers/internal/check_everything.ts +21 -21
  47. package/src/programmers/internal/check_native.ts +23 -23
  48. package/src/programmers/internal/check_number.ts +108 -108
  49. package/src/programmers/internal/check_object.ts +72 -72
  50. package/src/programmers/internal/check_string.ts +46 -46
  51. package/src/programmers/internal/check_template.ts +46 -46
  52. package/src/programmers/internal/check_union_array_like.ts +331 -331
  53. package/src/programmers/internal/decode_union_object.ts +110 -110
  54. package/src/programmers/internal/feature_object_entries.ts +59 -59
  55. package/src/programmers/internal/json_schema_escaped.ts +78 -78
  56. package/src/programmers/internal/json_schema_object.ts +150 -150
  57. package/src/programmers/internal/json_schema_station.ts +2 -2
  58. package/src/programmers/internal/metadata_to_pattern.ts +40 -40
  59. package/src/programmers/internal/postfix_of_tuple.ts +3 -3
  60. package/src/programmers/internal/prune_object_properties.ts +69 -69
  61. package/src/programmers/internal/stringify_dynamic_properties.ts +158 -158
  62. package/src/programmers/internal/stringify_native.ts +5 -5
  63. package/src/programmers/internal/stringify_regular_properties.ts +77 -77
  64. package/src/programmers/internal/template_to_pattern.ts +21 -21
  65. package/src/programmers/internal/wrap_metadata_rest_tuple.ts +21 -21
  66. package/src/programmers/json/JsonStringifyProgrammer.ts +1124 -1124
  67. package/src/programmers/llm/LlmApplicationProgrammer.ts +10 -1
  68. package/src/programmers/llm/LlmSchemaProgrammer.ts +2 -7
  69. package/src/protobuf.ts +820 -820
  70. package/src/reflect.ts +46 -46
  71. package/src/schemas/json/IJsonApplication.ts +77 -77
  72. package/src/schemas/json/IJsonSchemaCollection.ts +212 -212
  73. package/src/schemas/json/IJsonSchemaUnit.ts +263 -263
  74. package/src/schemas/metadata/IMetadataTypeTag.ts +14 -14
  75. package/src/schemas/metadata/Metadata.ts +669 -669
  76. package/src/schemas/metadata/MetadataAliasType.ts +57 -57
  77. package/src/schemas/metadata/MetadataApplication.ts +40 -40
  78. package/src/schemas/metadata/MetadataArray.ts +47 -47
  79. package/src/schemas/metadata/MetadataArrayType.ts +51 -51
  80. package/src/schemas/metadata/MetadataAtomic.ts +85 -85
  81. package/src/schemas/metadata/MetadataEscaped.ts +45 -45
  82. package/src/schemas/metadata/MetadataFunction.ts +45 -45
  83. package/src/schemas/metadata/MetadataObject.ts +46 -46
  84. package/src/schemas/metadata/MetadataObjectType.ts +137 -137
  85. package/src/schemas/metadata/MetadataParameter.ts +52 -52
  86. package/src/schemas/metadata/MetadataProperty.ts +53 -53
  87. package/src/schemas/metadata/MetadataTemplate.ts +78 -78
  88. package/src/schemas/metadata/MetadataTuple.ts +28 -28
  89. package/src/schemas/metadata/MetadataTupleType.ts +61 -61
  90. package/src/tags/Constant.ts +47 -47
  91. package/src/tags/ContentMediaType.ts +27 -27
  92. package/src/tags/Default.ts +52 -52
  93. package/src/tags/Example.ts +56 -56
  94. package/src/tags/Examples.ts +56 -56
  95. package/src/tags/ExclusiveMaximum.ts +44 -44
  96. package/src/tags/ExclusiveMinimum.ts +44 -44
  97. package/src/tags/Format.ts +78 -78
  98. package/src/tags/JsonSchemaPlugin.ts +36 -36
  99. package/src/tags/MaxItems.ts +31 -31
  100. package/src/tags/MaxLength.ts +25 -25
  101. package/src/tags/Maximum.ts +39 -39
  102. package/src/tags/MinItems.ts +31 -31
  103. package/src/tags/MinLength.ts +25 -25
  104. package/src/tags/Minimum.ts +39 -39
  105. package/src/tags/MultipleOf.ts +42 -42
  106. package/src/tags/Pattern.ts +49 -49
  107. package/src/tags/Sequence.ts +37 -37
  108. package/src/tags/TagBase.ts +102 -102
  109. package/src/tags/Type.ts +64 -64
  110. package/src/tags/UniqueItems.ts +34 -34
  111. package/src/tags/internal/FormatCheatSheet.ts +71 -71
  112. package/src/transformers/ITransformOptions.ts +70 -70
  113. package/src/transformers/ImportTransformer.ts +253 -253
  114. package/src/transformers/NoTransformConfigurationError.ts +16 -16
  115. package/src/transformers/features/llm/LlmApplicationTransformer.ts +224 -224
  116. package/src/typings/Equal.ts +18 -18
@@ -1,179 +1,179 @@
1
- import ts from "typescript";
2
-
3
- import { MapUtil } from "../utils/MapUtil";
4
-
5
- export class ImportProgrammer {
6
- private readonly assets_: Map<string, IAsset> = new Map();
7
- private readonly options_: Readonly<ImportProgrammer.IOptions>;
8
-
9
- public constructor(options?: Partial<ImportProgrammer.IOptions>) {
10
- this.options_ = {
11
- internalPrefix: options?.internalPrefix ?? "",
12
- };
13
- }
14
-
15
- /* -----------------------------------------------------------
16
- ENROLLMENTS
17
- ----------------------------------------------------------- */
18
- public default(props: ImportProgrammer.IDefault): ts.Identifier {
19
- const asset: IAsset = this.take(props.file);
20
- asset.default ??= props;
21
- asset.default.type ||= props.type;
22
- return ts.factory.createIdentifier(asset.default.name);
23
- }
24
-
25
- public instance(props: ImportProgrammer.IInstance): ts.Identifier {
26
- const alias: string = props.alias ?? props.name;
27
- const asset: IAsset = this.take(props.file);
28
- MapUtil.take(asset.instances, alias, () => props);
29
- return ts.factory.createIdentifier(alias);
30
- }
31
-
32
- public namespace(props: ImportProgrammer.INamespace): ts.Identifier {
33
- const asset: IAsset = this.take(props.file);
34
- asset.namespace ??= props;
35
- return ts.factory.createIdentifier(asset.namespace.name);
36
- }
37
-
38
- public type(props: {
39
- file: string;
40
- name: string | ts.EntityName;
41
- arguments?: ts.TypeNode[];
42
- }): ts.ImportTypeNode {
43
- return ts.factory.createImportTypeNode(
44
- ts.factory.createLiteralTypeNode(
45
- ts.factory.createStringLiteral(props.file),
46
- ),
47
- undefined,
48
- typeof props.name === "string"
49
- ? ts.factory.createIdentifier(props.name)
50
- : props.name,
51
- props.arguments,
52
- );
53
- }
54
-
55
- /** @internal */
56
- public internal(name: string): ts.PropertyAccessExpression {
57
- if (name.startsWith("_") === false) name = `_${name}`;
58
- return ts.factory.createPropertyAccessExpression(
59
- this.namespace({
60
- file: `typia/lib/internal/${name}.js`,
61
- name: this.alias(name),
62
- }),
63
- name,
64
- );
65
- }
66
-
67
- /** @internal */
68
- public getInternalText(name: string): string {
69
- if (name.startsWith("_") === false) name = `_${name}`;
70
- const asset: IAsset | undefined = this.take(
71
- `typia/lib/internal/${name}.js`,
72
- );
73
- if (!asset?.namespace) throw new Error(`Internal asset not found: ${name}`);
74
- return `${asset.namespace.name}.${name}`;
75
- }
76
-
77
- /** @internal */
78
- private take(file: string): IAsset {
79
- return MapUtil.take(this.assets_, file, () => ({
80
- file,
81
- default: null,
82
- namespace: null,
83
- instances: new Map(),
84
- }));
85
- }
86
-
87
- private alias(name: string): string {
88
- return `__${this.options_.internalPrefix}${name}`;
89
- }
90
-
91
- /* -----------------------------------------------------------
92
- PROGRAM STATEMENTS
93
- ----------------------------------------------------------- */
94
- public toStatements(): ts.ImportDeclaration[] {
95
- const statements: ts.ImportDeclaration[] = [];
96
- for (const asset of this.assets_.values()) {
97
- if (asset.namespace !== null)
98
- statements.push(
99
- ts.factory.createImportDeclaration(
100
- undefined,
101
- ts.factory.createImportClause(
102
- false,
103
- undefined,
104
- ts.factory.createNamespaceImport(
105
- ts.factory.createIdentifier(asset.namespace.name),
106
- ),
107
- ),
108
- ts.factory.createStringLiteral(asset.file),
109
- ),
110
- );
111
- if (asset.default !== null)
112
- statements.push(
113
- ts.factory.createImportDeclaration(
114
- undefined,
115
- ts.factory.createImportClause(
116
- asset.default.type,
117
- ts.factory.createIdentifier(asset.default.name),
118
- undefined,
119
- ),
120
- ts.factory.createStringLiteral(asset.file),
121
- ),
122
- );
123
- if (asset.instances.size > 0)
124
- statements.push(
125
- ts.factory.createImportDeclaration(
126
- undefined,
127
- ts.factory.createImportClause(
128
- false,
129
- undefined,
130
- asset.instances.size > 0
131
- ? ts.factory.createNamedImports(
132
- [...asset.instances.values()].map((ins) =>
133
- ts.factory.createImportSpecifier(
134
- false,
135
- ins.alias || ins.alias === ins.name
136
- ? ts.factory.createIdentifier(ins.name)
137
- : undefined,
138
- ts.factory.createIdentifier(ins.alias ?? ins.name),
139
- ),
140
- ),
141
- )
142
- : undefined,
143
- ),
144
- ts.factory.createStringLiteral(asset.file),
145
- undefined,
146
- ),
147
- );
148
- }
149
- return statements;
150
- }
151
- }
152
-
153
- export namespace ImportProgrammer {
154
- export interface IOptions {
155
- internalPrefix: string;
156
- }
157
-
158
- export interface IDefault {
159
- file: string;
160
- name: string;
161
- type: boolean;
162
- }
163
- export interface IInstance {
164
- file: string;
165
- name: string;
166
- alias: string | null;
167
- }
168
- export interface INamespace {
169
- file: string;
170
- name: string;
171
- }
172
- }
173
-
174
- interface IAsset {
175
- file: string;
176
- default: ImportProgrammer.IDefault | null;
177
- namespace: ImportProgrammer.INamespace | null;
178
- instances: Map<string, ImportProgrammer.IInstance>;
179
- }
1
+ import ts from "typescript";
2
+
3
+ import { MapUtil } from "../utils/MapUtil";
4
+
5
+ export class ImportProgrammer {
6
+ private readonly assets_: Map<string, IAsset> = new Map();
7
+ private readonly options_: Readonly<ImportProgrammer.IOptions>;
8
+
9
+ public constructor(options?: Partial<ImportProgrammer.IOptions>) {
10
+ this.options_ = {
11
+ internalPrefix: options?.internalPrefix ?? "",
12
+ };
13
+ }
14
+
15
+ /* -----------------------------------------------------------
16
+ ENROLLMENTS
17
+ ----------------------------------------------------------- */
18
+ public default(props: ImportProgrammer.IDefault): ts.Identifier {
19
+ const asset: IAsset = this.take(props.file);
20
+ asset.default ??= props;
21
+ asset.default.type ||= props.type;
22
+ return ts.factory.createIdentifier(asset.default.name);
23
+ }
24
+
25
+ public instance(props: ImportProgrammer.IInstance): ts.Identifier {
26
+ const alias: string = props.alias ?? props.name;
27
+ const asset: IAsset = this.take(props.file);
28
+ MapUtil.take(asset.instances, alias, () => props);
29
+ return ts.factory.createIdentifier(alias);
30
+ }
31
+
32
+ public namespace(props: ImportProgrammer.INamespace): ts.Identifier {
33
+ const asset: IAsset = this.take(props.file);
34
+ asset.namespace ??= props;
35
+ return ts.factory.createIdentifier(asset.namespace.name);
36
+ }
37
+
38
+ public type(props: {
39
+ file: string;
40
+ name: string | ts.EntityName;
41
+ arguments?: ts.TypeNode[];
42
+ }): ts.ImportTypeNode {
43
+ return ts.factory.createImportTypeNode(
44
+ ts.factory.createLiteralTypeNode(
45
+ ts.factory.createStringLiteral(props.file),
46
+ ),
47
+ undefined,
48
+ typeof props.name === "string"
49
+ ? ts.factory.createIdentifier(props.name)
50
+ : props.name,
51
+ props.arguments,
52
+ );
53
+ }
54
+
55
+ /** @internal */
56
+ public internal(name: string): ts.PropertyAccessExpression {
57
+ if (name.startsWith("_") === false) name = `_${name}`;
58
+ return ts.factory.createPropertyAccessExpression(
59
+ this.namespace({
60
+ file: `typia/lib/internal/${name}.js`,
61
+ name: this.alias(name),
62
+ }),
63
+ name,
64
+ );
65
+ }
66
+
67
+ /** @internal */
68
+ public getInternalText(name: string): string {
69
+ if (name.startsWith("_") === false) name = `_${name}`;
70
+ const asset: IAsset | undefined = this.take(
71
+ `typia/lib/internal/${name}.js`,
72
+ );
73
+ if (!asset?.namespace) throw new Error(`Internal asset not found: ${name}`);
74
+ return `${asset.namespace.name}.${name}`;
75
+ }
76
+
77
+ /** @internal */
78
+ private take(file: string): IAsset {
79
+ return MapUtil.take(this.assets_, file, () => ({
80
+ file,
81
+ default: null,
82
+ namespace: null,
83
+ instances: new Map(),
84
+ }));
85
+ }
86
+
87
+ private alias(name: string): string {
88
+ return `__${this.options_.internalPrefix}${name}`;
89
+ }
90
+
91
+ /* -----------------------------------------------------------
92
+ PROGRAM STATEMENTS
93
+ ----------------------------------------------------------- */
94
+ public toStatements(): ts.ImportDeclaration[] {
95
+ const statements: ts.ImportDeclaration[] = [];
96
+ for (const asset of this.assets_.values()) {
97
+ if (asset.namespace !== null)
98
+ statements.push(
99
+ ts.factory.createImportDeclaration(
100
+ undefined,
101
+ ts.factory.createImportClause(
102
+ false,
103
+ undefined,
104
+ ts.factory.createNamespaceImport(
105
+ ts.factory.createIdentifier(asset.namespace.name),
106
+ ),
107
+ ),
108
+ ts.factory.createStringLiteral(asset.file),
109
+ ),
110
+ );
111
+ if (asset.default !== null)
112
+ statements.push(
113
+ ts.factory.createImportDeclaration(
114
+ undefined,
115
+ ts.factory.createImportClause(
116
+ asset.default.type,
117
+ ts.factory.createIdentifier(asset.default.name),
118
+ undefined,
119
+ ),
120
+ ts.factory.createStringLiteral(asset.file),
121
+ ),
122
+ );
123
+ if (asset.instances.size > 0)
124
+ statements.push(
125
+ ts.factory.createImportDeclaration(
126
+ undefined,
127
+ ts.factory.createImportClause(
128
+ false,
129
+ undefined,
130
+ asset.instances.size > 0
131
+ ? ts.factory.createNamedImports(
132
+ [...asset.instances.values()].map((ins) =>
133
+ ts.factory.createImportSpecifier(
134
+ false,
135
+ ins.alias || ins.alias === ins.name
136
+ ? ts.factory.createIdentifier(ins.name)
137
+ : undefined,
138
+ ts.factory.createIdentifier(ins.alias ?? ins.name),
139
+ ),
140
+ ),
141
+ )
142
+ : undefined,
143
+ ),
144
+ ts.factory.createStringLiteral(asset.file),
145
+ undefined,
146
+ ),
147
+ );
148
+ }
149
+ return statements;
150
+ }
151
+ }
152
+
153
+ export namespace ImportProgrammer {
154
+ export interface IOptions {
155
+ internalPrefix: string;
156
+ }
157
+
158
+ export interface IDefault {
159
+ file: string;
160
+ name: string;
161
+ type: boolean;
162
+ }
163
+ export interface IInstance {
164
+ file: string;
165
+ name: string;
166
+ alias: string | null;
167
+ }
168
+ export interface INamespace {
169
+ file: string;
170
+ name: string;
171
+ }
172
+ }
173
+
174
+ interface IAsset {
175
+ file: string;
176
+ default: ImportProgrammer.IDefault | null;
177
+ namespace: ImportProgrammer.INamespace | null;
178
+ instances: Map<string, ImportProgrammer.IInstance>;
179
+ }