typia 3.6.2 → 3.6.3

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 (205) hide show
  1. package/README.md +2 -1
  2. package/lib/factories/internal/metadata/emplace_metadata_object.js +8 -7
  3. package/lib/factories/internal/metadata/emplace_metadata_object.js.map +1 -1
  4. package/lib/module.d.ts +2 -2
  5. package/package.json +1 -1
  6. package/src/IRandomGenerator.ts +16 -16
  7. package/src/IValidation.ts +21 -21
  8. package/src/Primitive.ts +104 -104
  9. package/src/TypeGuardError.ts +36 -36
  10. package/src/executable/TypiaGenerateWizard.ts +87 -87
  11. package/src/executable/TypiaSetupWizard.ts +142 -142
  12. package/src/executable/setup/ArgumentParser.ts +91 -91
  13. package/src/executable/setup/CommandExecutor.ts +8 -8
  14. package/src/executable/setup/FileRetriever.ts +33 -33
  15. package/src/executable/setup/PackageManager.ts +92 -92
  16. package/src/executable/setup/PluginConfigurator.ts +99 -99
  17. package/src/executable/typia.ts +38 -38
  18. package/src/factories/CommentFactory.ts +10 -10
  19. package/src/factories/ExpressionFactory.ts +77 -77
  20. package/src/factories/IdentifierFactory.ts +73 -73
  21. package/src/factories/LiteralFactory.ts +44 -44
  22. package/src/factories/MetadataCollection.ts +122 -122
  23. package/src/factories/MetadataFactory.ts +51 -51
  24. package/src/factories/MetadataTagFactory.ts +265 -265
  25. package/src/factories/StatementFactory.ts +60 -60
  26. package/src/factories/TemplateFactory.ts +56 -56
  27. package/src/factories/TypeFactory.ts +129 -129
  28. package/src/factories/TypiaFileFactory.ts +117 -117
  29. package/src/factories/ValueFactory.ts +12 -12
  30. package/src/factories/internal/metadata/MetadataHelper.ts +12 -12
  31. package/src/factories/internal/metadata/emplace_metadata_object.ts +142 -140
  32. package/src/factories/internal/metadata/explore_metadata.ts +92 -92
  33. package/src/factories/internal/metadata/iterate_metadata.ts +80 -80
  34. package/src/factories/internal/metadata/iterate_metadata_array.ts +29 -29
  35. package/src/factories/internal/metadata/iterate_metadata_atomic.ts +59 -59
  36. package/src/factories/internal/metadata/iterate_metadata_coalesce.ts +33 -33
  37. package/src/factories/internal/metadata/iterate_metadata_constant.ts +58 -58
  38. package/src/factories/internal/metadata/iterate_metadata_map.ts +41 -41
  39. package/src/factories/internal/metadata/iterate_metadata_native.ts +222 -222
  40. package/src/factories/internal/metadata/iterate_metadata_object.ts +48 -48
  41. package/src/factories/internal/metadata/iterate_metadata_resolve.ts +27 -27
  42. package/src/factories/internal/metadata/iterate_metadata_set.ts +33 -33
  43. package/src/factories/internal/metadata/iterate_metadata_template.ts +38 -38
  44. package/src/factories/internal/metadata/iterate_metadata_tuple.ts +45 -45
  45. package/src/factories/internal/metadata/iterate_metadata_union.ts +59 -59
  46. package/src/functional/$any.ts +3 -3
  47. package/src/functional/$every.ts +11 -11
  48. package/src/functional/$guard.ts +35 -35
  49. package/src/functional/$is_between.ts +7 -7
  50. package/src/functional/$is_email.ts +5 -5
  51. package/src/functional/$is_ipv4.ts +5 -5
  52. package/src/functional/$is_ipv6.ts +5 -5
  53. package/src/functional/$is_url.ts +5 -5
  54. package/src/functional/$is_uuid.ts +5 -5
  55. package/src/functional/$join.ts +50 -50
  56. package/src/functional/$number.ts +12 -12
  57. package/src/functional/$report.ts +15 -15
  58. package/src/functional/$rest.ts +3 -3
  59. package/src/functional/$string.ts +37 -37
  60. package/src/functional/$tail.ts +6 -6
  61. package/src/functional/Namespace.ts +121 -121
  62. package/src/index.ts +4 -4
  63. package/src/metadata/IJsDocTagInfo.ts +10 -10
  64. package/src/metadata/IMetadata.ts +25 -25
  65. package/src/metadata/IMetadataApplication.ts +7 -7
  66. package/src/metadata/IMetadataConstant.ts +16 -16
  67. package/src/metadata/IMetadataEntry.ts +6 -6
  68. package/src/metadata/IMetadataObject.ts +29 -29
  69. package/src/metadata/IMetadataProperty.ts +11 -11
  70. package/src/metadata/IMetadataTag.ts +113 -113
  71. package/src/metadata/Metadata.ts +534 -534
  72. package/src/metadata/MetadataConstant.ts +3 -3
  73. package/src/metadata/MetadataObject.ts +131 -131
  74. package/src/metadata/MetadataProperty.ts +64 -64
  75. package/src/module.ts +1946 -1946
  76. package/src/programmers/ApplicationProgrammer.ts +55 -55
  77. package/src/programmers/AssertCloneProgrammer.ts +70 -70
  78. package/src/programmers/AssertParseProgrammer.ts +65 -65
  79. package/src/programmers/AssertProgrammer.ts +232 -232
  80. package/src/programmers/AssertPruneProgrammer.ts +67 -67
  81. package/src/programmers/AssertStringifyProgrammer.ts +71 -71
  82. package/src/programmers/CheckerProgrammer.ts +893 -893
  83. package/src/programmers/CloneProgrammer.ts +386 -386
  84. package/src/programmers/FeatureProgrammer.ts +505 -505
  85. package/src/programmers/IsCloneProgrammer.ts +80 -80
  86. package/src/programmers/IsParseProgrammer.ts +74 -74
  87. package/src/programmers/IsProgrammer.ts +200 -200
  88. package/src/programmers/IsPruneProgrammer.ts +75 -75
  89. package/src/programmers/IsStringifyProgrammer.ts +81 -81
  90. package/src/programmers/PruneProgrammer.ts +341 -341
  91. package/src/programmers/RandomProgrammer.ts +391 -391
  92. package/src/programmers/StringifyProgrammer.ts +795 -795
  93. package/src/programmers/ValidateCloneProgrammer.ts +90 -90
  94. package/src/programmers/ValidateParseProgrammer.ts +69 -69
  95. package/src/programmers/ValidateProgrammer.ts +266 -266
  96. package/src/programmers/ValidatePruneProgrammer.ts +83 -83
  97. package/src/programmers/ValidateStringifyProgrammer.ts +89 -89
  98. package/src/programmers/helpers/AtomicPredicator.ts +31 -31
  99. package/src/programmers/helpers/CloneJoiner.ts +134 -134
  100. package/src/programmers/helpers/FunctionImporeter.ts +55 -55
  101. package/src/programmers/helpers/IExpressionEntry.ts +12 -12
  102. package/src/programmers/helpers/OptionPredicator.ts +19 -19
  103. package/src/programmers/helpers/PruneJoiner.ts +52 -52
  104. package/src/programmers/helpers/RandomJoiner.ts +149 -149
  105. package/src/programmers/helpers/RandomRanger.ts +216 -216
  106. package/src/programmers/helpers/StringifyJoinder.ts +114 -114
  107. package/src/programmers/helpers/StringifyPredicator.ts +18 -18
  108. package/src/programmers/helpers/UnionExplorer.ts +274 -274
  109. package/src/programmers/helpers/UnionPredicator.ts +81 -81
  110. package/src/programmers/internal/application_array.ts +37 -37
  111. package/src/programmers/internal/application_boolean.ts +17 -17
  112. package/src/programmers/internal/application_constant.ts +29 -29
  113. package/src/programmers/internal/application_default.ts +17 -17
  114. package/src/programmers/internal/application_default_string.ts +32 -32
  115. package/src/programmers/internal/application_native.ts +29 -29
  116. package/src/programmers/internal/application_number.ts +70 -70
  117. package/src/programmers/internal/application_object.ts +153 -153
  118. package/src/programmers/internal/application_schema.ts +184 -184
  119. package/src/programmers/internal/application_string.ts +41 -41
  120. package/src/programmers/internal/application_templates.ts +27 -27
  121. package/src/programmers/internal/application_tuple.ts +29 -29
  122. package/src/programmers/internal/check_array.ts +22 -22
  123. package/src/programmers/internal/check_array_length.ts +44 -44
  124. package/src/programmers/internal/check_bigint.ts +64 -64
  125. package/src/programmers/internal/check_dynamic_properties.ts +197 -197
  126. package/src/programmers/internal/check_everything.ts +28 -28
  127. package/src/programmers/internal/check_native.ts +21 -21
  128. package/src/programmers/internal/check_number.ts +145 -145
  129. package/src/programmers/internal/check_object.ts +48 -48
  130. package/src/programmers/internal/check_string.ts +24 -24
  131. package/src/programmers/internal/check_string_tags.ts +63 -63
  132. package/src/programmers/internal/check_template.ts +50 -50
  133. package/src/programmers/internal/check_union_array_like.ts +260 -260
  134. package/src/programmers/internal/check_union_tuple.ts +33 -33
  135. package/src/programmers/internal/decode_union_object.ts +73 -73
  136. package/src/programmers/internal/feature_object_entries.ts +59 -59
  137. package/src/programmers/internal/metadata_to_pattern.ts +31 -31
  138. package/src/programmers/internal/prune_object_properties.ts +60 -60
  139. package/src/programmers/internal/stringify_dynamic_properties.ts +165 -165
  140. package/src/programmers/internal/stringify_native.ts +8 -8
  141. package/src/programmers/internal/stringify_regular_properties.ts +81 -81
  142. package/src/programmers/internal/template_to_pattern.ts +15 -15
  143. package/src/schemas/IJsonApplication.ts +9 -9
  144. package/src/schemas/IJsonComponents.ts +26 -26
  145. package/src/schemas/IJsonSchema.ts +127 -127
  146. package/src/transform.ts +21 -21
  147. package/src/transformers/CallExpressionTransformer.ts +172 -172
  148. package/src/transformers/ExpressionWithArgumentTransformer.ts +66 -66
  149. package/src/transformers/FileTransformer.ts +49 -49
  150. package/src/transformers/IProject.ts +11 -11
  151. package/src/transformers/ITransformOptions.ts +62 -62
  152. package/src/transformers/ImportTransformer.ts +60 -60
  153. package/src/transformers/NodeTransformer.ts +19 -19
  154. package/src/transformers/features/miscellaneous/ApplicationTransformer.ts +120 -120
  155. package/src/transformers/features/miscellaneous/AssertCloneTransformer.ts +9 -9
  156. package/src/transformers/features/miscellaneous/AssertPruneTransformer.ts +9 -9
  157. package/src/transformers/features/miscellaneous/CloneTransformer.ts +9 -9
  158. package/src/transformers/features/miscellaneous/CreateAssertCloneTransformer.ts +9 -9
  159. package/src/transformers/features/miscellaneous/CreateAssertPruneTransformer.ts +9 -9
  160. package/src/transformers/features/miscellaneous/CreateCloneTransformer.ts +9 -9
  161. package/src/transformers/features/miscellaneous/CreateIsCloneTransformer.ts +9 -9
  162. package/src/transformers/features/miscellaneous/CreateIsPruneTransformer.ts +9 -9
  163. package/src/transformers/features/miscellaneous/CreatePruneTransformer.ts +9 -9
  164. package/src/transformers/features/miscellaneous/CreateRandomGenerator.ts +42 -42
  165. package/src/transformers/features/miscellaneous/CreateValidateCloneTransformer.ts +9 -9
  166. package/src/transformers/features/miscellaneous/CreateValidatePruneTransformer.ts +9 -9
  167. package/src/transformers/features/miscellaneous/IsCloneTransformer.ts +9 -9
  168. package/src/transformers/features/miscellaneous/IsPruneTransformer.ts +9 -9
  169. package/src/transformers/features/miscellaneous/MetadataTransformer.ts +55 -55
  170. package/src/transformers/features/miscellaneous/PruneTransformer.ts +9 -9
  171. package/src/transformers/features/miscellaneous/RandomTransformer.ts +48 -48
  172. package/src/transformers/features/miscellaneous/ValidateCloneTransformer.ts +9 -9
  173. package/src/transformers/features/miscellaneous/ValidatePruneTransformer.ts +9 -9
  174. package/src/transformers/features/parsers/AssertParseTransformer.ts +9 -9
  175. package/src/transformers/features/parsers/CreateAssertParseTransformer.ts +9 -9
  176. package/src/transformers/features/parsers/CreateIsParseTransformer.ts +9 -9
  177. package/src/transformers/features/parsers/CreateValidateParseTransformer.ts +9 -9
  178. package/src/transformers/features/parsers/IsParseTransformer.ts +9 -9
  179. package/src/transformers/features/parsers/ValidateParseTransformer.ts +9 -9
  180. package/src/transformers/features/stringifiers/AssertStringifyTransformer.ts +10 -10
  181. package/src/transformers/features/stringifiers/CreateAssertStringifyTransformer.ts +9 -9
  182. package/src/transformers/features/stringifiers/CreateIsStringifyTransformer.ts +9 -9
  183. package/src/transformers/features/stringifiers/CreateStringifyTransformer.ts +9 -9
  184. package/src/transformers/features/stringifiers/CreateValidateStringifyProgrammer.ts +11 -11
  185. package/src/transformers/features/stringifiers/IsStringifyTransformer.ts +9 -9
  186. package/src/transformers/features/stringifiers/StringifyTransformer.ts +9 -9
  187. package/src/transformers/features/stringifiers/ValidateStringifyTransformer.ts +10 -10
  188. package/src/transformers/features/validators/AssertTransformer.ts +11 -11
  189. package/src/transformers/features/validators/CreateAssertTransformer.ts +12 -12
  190. package/src/transformers/features/validators/CreateIsTransformer.ts +10 -10
  191. package/src/transformers/features/validators/CreateValidateTransformer.ts +12 -12
  192. package/src/transformers/features/validators/IsTransformer.ts +10 -10
  193. package/src/transformers/features/validators/ValidateTransformer.ts +11 -11
  194. package/src/transformers/internal/GenericTransformer.ts +99 -99
  195. package/src/typings/Atomic.ts +17 -17
  196. package/src/typings/ClassProperties.ts +5 -5
  197. package/src/typings/OmitNever.ts +3 -3
  198. package/src/typings/SpecialFields.ts +3 -3
  199. package/src/typings/Writable.ts +11 -11
  200. package/src/utils/ArrayUtil.ts +49 -49
  201. package/src/utils/Escaper.ts +50 -50
  202. package/src/utils/MapUtil.ts +14 -14
  203. package/src/utils/PatternUtil.ts +30 -30
  204. package/src/utils/RandomGenerator.ts +90 -90
  205. package/src/utils/Singleton.ts +17 -17
@@ -1,265 +1,265 @@
1
- import ts from "typescript";
2
-
3
- import { IMetadataTag } from "../metadata/IMetadataTag";
4
- import { Metadata } from "../metadata/Metadata";
5
-
6
- export namespace MetadataTagFactory {
7
- export function generate(
8
- identifier: () => string,
9
- metadata: Metadata,
10
- tagList: ts.JSDocTagInfo[],
11
- ): IMetadataTag[] {
12
- const output: IMetadataTag[] = [];
13
- for (const tag of tagList) {
14
- const elem: IMetadataTag | null = parse(
15
- identifier,
16
- metadata,
17
- tag,
18
- output,
19
- );
20
- if (elem !== null) output.push(elem);
21
- }
22
- return output;
23
- }
24
-
25
- function parse(
26
- identifier: () => string,
27
- metadata: Metadata,
28
- tag: ts.JSDocTagInfo,
29
- output: IMetadataTag[],
30
- ): IMetadataTag | null {
31
- const closure = PARSER[tag.name];
32
- if (closure === undefined) return null;
33
-
34
- const text = (tag.text || [])[0]?.text;
35
- if (text === undefined)
36
- throw new Error(`${LABEL}: no tag value on ${identifier()}`);
37
-
38
- return closure(identifier, metadata, text, output);
39
- }
40
- }
41
-
42
- const PARSER: Record<
43
- string,
44
- (
45
- identifier: () => string,
46
- metadata: Metadata,
47
- text: string,
48
- output: IMetadataTag[],
49
- ) => IMetadataTag | null
50
- > = {
51
- /* -----------------------------------------------------------
52
- ARRAY
53
- ----------------------------------------------------------- */
54
- items: (identifier, metadata, text, output) => {
55
- validate(identifier, metadata, output, "items", "array", ["minItems"]);
56
- return {
57
- kind: "items",
58
- value: parse_number(identifier, text),
59
- };
60
- },
61
- minItems: (identifier, metadata, text, output) => {
62
- validate(identifier, metadata, output, "minItems", "array", ["items"]);
63
- return {
64
- kind: "minItems",
65
- value: parse_number(identifier, text),
66
- };
67
- },
68
- maxItems: (identifier, metadata, text, output) => {
69
- validate(identifier, metadata, output, "maxItems", "array", ["items"]);
70
- return {
71
- kind: "maxItems",
72
- value: parse_number(identifier, text),
73
- };
74
- },
75
-
76
- /* -----------------------------------------------------------
77
- NUMBER
78
- ----------------------------------------------------------- */
79
- type: (identifier, metadata, text, output) => {
80
- validate(identifier, metadata, output, "type", "number", []);
81
- if (text !== "int" && text !== "uint")
82
- throw new Error(`${LABEL}: invalid type tag on "${identifier()}".`);
83
- return { kind: "type", value: text };
84
- },
85
- minimum: (identifier, metadata, text, output) => {
86
- validate(identifier, metadata, output, "minimum", "number", [
87
- "exclusiveMinimum",
88
- ]);
89
- return {
90
- kind: "minimum",
91
- value: parse_number(identifier, text),
92
- };
93
- },
94
- maximum: (identifier, metadata, text, output) => {
95
- validate(identifier, metadata, output, "maximum", "number", [
96
- "exclusiveMaximum",
97
- ]);
98
- return {
99
- kind: "maximum",
100
- value: parse_number(identifier, text),
101
- };
102
- },
103
- exclusiveMinimum: (identifier, metadata, text, output) => {
104
- validate(identifier, metadata, output, "exclusiveMinimum", "number", [
105
- "minimum",
106
- ]);
107
- return {
108
- kind: "exclusiveMinimum",
109
- value: parse_number(identifier, text),
110
- };
111
- },
112
- exclusiveMaximum: (identifier, metadata, text, output) => {
113
- validate(identifier, metadata, output, "exclusiveMaximum", "number", [
114
- "maximum",
115
- ]);
116
- return {
117
- kind: "exclusiveMaximum",
118
- value: parse_number(identifier, text),
119
- };
120
- },
121
- multipleOf: (identifier, metadata, text, output) => {
122
- validate(identifier, metadata, output, "multipleOf", "number", [
123
- "step",
124
- ]);
125
- return {
126
- kind: "multipleOf",
127
- value: parse_number(identifier, text),
128
- };
129
- },
130
- step: (identifier, metadata, text, output) => {
131
- validate(identifier, metadata, output, "step", "number", [
132
- "multipleOf",
133
- ]);
134
-
135
- const minimum: boolean = output.some(
136
- (tag) => tag.kind === "minimum" || tag.kind === "exclusiveMinimum",
137
- );
138
- if (minimum === undefined)
139
- throw new Error(
140
- `${LABEL}: step requires minimum or exclusiveMinimum tag on "${identifier()}".`,
141
- );
142
-
143
- return {
144
- kind: "step",
145
- value: parse_number(identifier, text),
146
- };
147
- },
148
-
149
- /* -----------------------------------------------------------
150
- STRING
151
- ----------------------------------------------------------- */
152
- format: (identifier, metadata, value, output) => {
153
- validate(identifier, metadata, output, "format", "string", ["pattern"]);
154
-
155
- // Ignore arbitrary @format values in the internal metadata,
156
- // these are currently only supported on the typia.application() API.
157
- if (FORMATS.has(value) === false) return null;
158
-
159
- return {
160
- kind: "format",
161
- value: value as "uuid",
162
- };
163
- },
164
- pattern: (identifier, metadata, value, output) => {
165
- validate(identifier, metadata, output, "pattern", "string", ["format"]);
166
- return {
167
- kind: "pattern",
168
- value,
169
- };
170
- },
171
- length: (identifier, metadata, text, output) => {
172
- validate(identifier, metadata, output, "length", "string", [
173
- "minLength",
174
- "maxLength",
175
- ]);
176
- return {
177
- kind: "length",
178
- value: parse_number(identifier, text),
179
- };
180
- },
181
- minLength: (identifier, metadata, text, output) => {
182
- validate(identifier, metadata, output, "minLength", "string", [
183
- "length",
184
- ]);
185
- return {
186
- kind: "minLength",
187
- value: parse_number(identifier, text),
188
- };
189
- },
190
- maxLength: (identifier, metadata, text, output) => {
191
- validate(identifier, metadata, output, "maxLength", "string", [
192
- "length",
193
- ]);
194
- return {
195
- kind: "maxLength",
196
- value: parse_number(identifier, text),
197
- };
198
- },
199
- };
200
-
201
- function parse_number(identifier: () => string, str: string): number {
202
- const value: number = Number(str);
203
- if (isNaN(value) === true)
204
- throw new Error(`${LABEL}: invalid number on "${identifier()}".`);
205
- return value;
206
- }
207
-
208
- const LABEL = "Error on typia.MetadataTagFactory.generate()";
209
- const FORMATS = new Set(["uuid", "email", "url", "mobile", "ipv4", "ipv6"]);
210
-
211
- const WRONG_TYPE = (
212
- tag: string,
213
- type: "string" | "number" | "array",
214
- identifier: () => string,
215
- ) => `${LABEL}: ${tag} requires ${type} type, but no "${identifier()}".`;
216
-
217
- function validate(
218
- identifier: () => string,
219
- metadata: Metadata,
220
- output: IMetadataTag[],
221
- kind: IMetadataTag["kind"],
222
- type: "array" | "string" | "number",
223
- neighbors: IMetadataTag["kind"][],
224
- ): void {
225
- // TYPE CHECKING
226
- if (type === "array") {
227
- if (has_array(metadata) === false)
228
- throw new Error(WRONG_TYPE(kind, "array", identifier));
229
- } else if (has_atomic(metadata, type) === false)
230
- throw new Error(WRONG_TYPE(kind, type, identifier));
231
-
232
- // DUPLICATED TAG
233
- if (output.some((tag) => tag.kind === kind))
234
- throw new Error(
235
- `${LABEL}: duplicated ${kind} tags on "${identifier()}".`,
236
- );
237
-
238
- // NEIGHBOR TAG
239
- for (const name of neighbors)
240
- if (output.some((tag) => tag.kind === name))
241
- throw new Error(
242
- `${LABEL}: ${kind} and ${name} tags on "${identifier()}".`,
243
- );
244
- }
245
-
246
- function has_atomic(metadata: Metadata, type: "string" | "number"): boolean {
247
- const valid =
248
- type === "number"
249
- ? (atom: string) => atom === type || atom === "bigint"
250
- : (atom: string) => atom === type;
251
- return (
252
- metadata.atomics.find((atom) => valid(atom)) !== undefined ||
253
- metadata.arrays.some((child) => has_atomic(child, type)) ||
254
- metadata.tuples.some((tuple) =>
255
- tuple.some((child) => has_atomic(child, type)),
256
- )
257
- );
258
- }
259
-
260
- function has_array(metadata: Metadata): boolean {
261
- return (
262
- metadata.arrays.length !== 0 ||
263
- metadata.tuples.some((tuple) => tuple.some((child) => has_array(child)))
264
- );
265
- }
1
+ import ts from "typescript";
2
+
3
+ import { IMetadataTag } from "../metadata/IMetadataTag";
4
+ import { Metadata } from "../metadata/Metadata";
5
+
6
+ export namespace MetadataTagFactory {
7
+ export function generate(
8
+ identifier: () => string,
9
+ metadata: Metadata,
10
+ tagList: ts.JSDocTagInfo[],
11
+ ): IMetadataTag[] {
12
+ const output: IMetadataTag[] = [];
13
+ for (const tag of tagList) {
14
+ const elem: IMetadataTag | null = parse(
15
+ identifier,
16
+ metadata,
17
+ tag,
18
+ output,
19
+ );
20
+ if (elem !== null) output.push(elem);
21
+ }
22
+ return output;
23
+ }
24
+
25
+ function parse(
26
+ identifier: () => string,
27
+ metadata: Metadata,
28
+ tag: ts.JSDocTagInfo,
29
+ output: IMetadataTag[],
30
+ ): IMetadataTag | null {
31
+ const closure = PARSER[tag.name];
32
+ if (closure === undefined) return null;
33
+
34
+ const text = (tag.text || [])[0]?.text;
35
+ if (text === undefined)
36
+ throw new Error(`${LABEL}: no tag value on ${identifier()}`);
37
+
38
+ return closure(identifier, metadata, text, output);
39
+ }
40
+ }
41
+
42
+ const PARSER: Record<
43
+ string,
44
+ (
45
+ identifier: () => string,
46
+ metadata: Metadata,
47
+ text: string,
48
+ output: IMetadataTag[],
49
+ ) => IMetadataTag | null
50
+ > = {
51
+ /* -----------------------------------------------------------
52
+ ARRAY
53
+ ----------------------------------------------------------- */
54
+ items: (identifier, metadata, text, output) => {
55
+ validate(identifier, metadata, output, "items", "array", ["minItems"]);
56
+ return {
57
+ kind: "items",
58
+ value: parse_number(identifier, text),
59
+ };
60
+ },
61
+ minItems: (identifier, metadata, text, output) => {
62
+ validate(identifier, metadata, output, "minItems", "array", ["items"]);
63
+ return {
64
+ kind: "minItems",
65
+ value: parse_number(identifier, text),
66
+ };
67
+ },
68
+ maxItems: (identifier, metadata, text, output) => {
69
+ validate(identifier, metadata, output, "maxItems", "array", ["items"]);
70
+ return {
71
+ kind: "maxItems",
72
+ value: parse_number(identifier, text),
73
+ };
74
+ },
75
+
76
+ /* -----------------------------------------------------------
77
+ NUMBER
78
+ ----------------------------------------------------------- */
79
+ type: (identifier, metadata, text, output) => {
80
+ validate(identifier, metadata, output, "type", "number", []);
81
+ if (text !== "int" && text !== "uint")
82
+ throw new Error(`${LABEL}: invalid type tag on "${identifier()}".`);
83
+ return { kind: "type", value: text };
84
+ },
85
+ minimum: (identifier, metadata, text, output) => {
86
+ validate(identifier, metadata, output, "minimum", "number", [
87
+ "exclusiveMinimum",
88
+ ]);
89
+ return {
90
+ kind: "minimum",
91
+ value: parse_number(identifier, text),
92
+ };
93
+ },
94
+ maximum: (identifier, metadata, text, output) => {
95
+ validate(identifier, metadata, output, "maximum", "number", [
96
+ "exclusiveMaximum",
97
+ ]);
98
+ return {
99
+ kind: "maximum",
100
+ value: parse_number(identifier, text),
101
+ };
102
+ },
103
+ exclusiveMinimum: (identifier, metadata, text, output) => {
104
+ validate(identifier, metadata, output, "exclusiveMinimum", "number", [
105
+ "minimum",
106
+ ]);
107
+ return {
108
+ kind: "exclusiveMinimum",
109
+ value: parse_number(identifier, text),
110
+ };
111
+ },
112
+ exclusiveMaximum: (identifier, metadata, text, output) => {
113
+ validate(identifier, metadata, output, "exclusiveMaximum", "number", [
114
+ "maximum",
115
+ ]);
116
+ return {
117
+ kind: "exclusiveMaximum",
118
+ value: parse_number(identifier, text),
119
+ };
120
+ },
121
+ multipleOf: (identifier, metadata, text, output) => {
122
+ validate(identifier, metadata, output, "multipleOf", "number", [
123
+ "step",
124
+ ]);
125
+ return {
126
+ kind: "multipleOf",
127
+ value: parse_number(identifier, text),
128
+ };
129
+ },
130
+ step: (identifier, metadata, text, output) => {
131
+ validate(identifier, metadata, output, "step", "number", [
132
+ "multipleOf",
133
+ ]);
134
+
135
+ const minimum: boolean = output.some(
136
+ (tag) => tag.kind === "minimum" || tag.kind === "exclusiveMinimum",
137
+ );
138
+ if (minimum === undefined)
139
+ throw new Error(
140
+ `${LABEL}: step requires minimum or exclusiveMinimum tag on "${identifier()}".`,
141
+ );
142
+
143
+ return {
144
+ kind: "step",
145
+ value: parse_number(identifier, text),
146
+ };
147
+ },
148
+
149
+ /* -----------------------------------------------------------
150
+ STRING
151
+ ----------------------------------------------------------- */
152
+ format: (identifier, metadata, value, output) => {
153
+ validate(identifier, metadata, output, "format", "string", ["pattern"]);
154
+
155
+ // Ignore arbitrary @format values in the internal metadata,
156
+ // these are currently only supported on the typia.application() API.
157
+ if (FORMATS.has(value) === false) return null;
158
+
159
+ return {
160
+ kind: "format",
161
+ value: value as "uuid",
162
+ };
163
+ },
164
+ pattern: (identifier, metadata, value, output) => {
165
+ validate(identifier, metadata, output, "pattern", "string", ["format"]);
166
+ return {
167
+ kind: "pattern",
168
+ value,
169
+ };
170
+ },
171
+ length: (identifier, metadata, text, output) => {
172
+ validate(identifier, metadata, output, "length", "string", [
173
+ "minLength",
174
+ "maxLength",
175
+ ]);
176
+ return {
177
+ kind: "length",
178
+ value: parse_number(identifier, text),
179
+ };
180
+ },
181
+ minLength: (identifier, metadata, text, output) => {
182
+ validate(identifier, metadata, output, "minLength", "string", [
183
+ "length",
184
+ ]);
185
+ return {
186
+ kind: "minLength",
187
+ value: parse_number(identifier, text),
188
+ };
189
+ },
190
+ maxLength: (identifier, metadata, text, output) => {
191
+ validate(identifier, metadata, output, "maxLength", "string", [
192
+ "length",
193
+ ]);
194
+ return {
195
+ kind: "maxLength",
196
+ value: parse_number(identifier, text),
197
+ };
198
+ },
199
+ };
200
+
201
+ function parse_number(identifier: () => string, str: string): number {
202
+ const value: number = Number(str);
203
+ if (isNaN(value) === true)
204
+ throw new Error(`${LABEL}: invalid number on "${identifier()}".`);
205
+ return value;
206
+ }
207
+
208
+ const LABEL = "Error on typia.MetadataTagFactory.generate()";
209
+ const FORMATS = new Set(["uuid", "email", "url", "mobile", "ipv4", "ipv6"]);
210
+
211
+ const WRONG_TYPE = (
212
+ tag: string,
213
+ type: "string" | "number" | "array",
214
+ identifier: () => string,
215
+ ) => `${LABEL}: ${tag} requires ${type} type, but no "${identifier()}".`;
216
+
217
+ function validate(
218
+ identifier: () => string,
219
+ metadata: Metadata,
220
+ output: IMetadataTag[],
221
+ kind: IMetadataTag["kind"],
222
+ type: "array" | "string" | "number",
223
+ neighbors: IMetadataTag["kind"][],
224
+ ): void {
225
+ // TYPE CHECKING
226
+ if (type === "array") {
227
+ if (has_array(metadata) === false)
228
+ throw new Error(WRONG_TYPE(kind, "array", identifier));
229
+ } else if (has_atomic(metadata, type) === false)
230
+ throw new Error(WRONG_TYPE(kind, type, identifier));
231
+
232
+ // DUPLICATED TAG
233
+ if (output.some((tag) => tag.kind === kind))
234
+ throw new Error(
235
+ `${LABEL}: duplicated ${kind} tags on "${identifier()}".`,
236
+ );
237
+
238
+ // NEIGHBOR TAG
239
+ for (const name of neighbors)
240
+ if (output.some((tag) => tag.kind === name))
241
+ throw new Error(
242
+ `${LABEL}: ${kind} and ${name} tags on "${identifier()}".`,
243
+ );
244
+ }
245
+
246
+ function has_atomic(metadata: Metadata, type: "string" | "number"): boolean {
247
+ const valid =
248
+ type === "number"
249
+ ? (atom: string) => atom === type || atom === "bigint"
250
+ : (atom: string) => atom === type;
251
+ return (
252
+ metadata.atomics.find((atom) => valid(atom)) !== undefined ||
253
+ metadata.arrays.some((child) => has_atomic(child, type)) ||
254
+ metadata.tuples.some((tuple) =>
255
+ tuple.some((child) => has_atomic(child, type)),
256
+ )
257
+ );
258
+ }
259
+
260
+ function has_array(metadata: Metadata): boolean {
261
+ return (
262
+ metadata.arrays.length !== 0 ||
263
+ metadata.tuples.some((tuple) => tuple.some((child) => has_array(child)))
264
+ );
265
+ }
@@ -1,60 +1,60 @@
1
- import ts from "typescript";
2
-
3
- export namespace StatementFactory {
4
- export function constant(name: string, initializer?: ts.Expression) {
5
- return ts.factory.createVariableStatement(
6
- undefined,
7
- ts.factory.createVariableDeclarationList(
8
- [
9
- ts.factory.createVariableDeclaration(
10
- name,
11
- undefined,
12
- undefined,
13
- initializer,
14
- ),
15
- ],
16
- ts.NodeFlags.Const,
17
- ),
18
- );
19
- }
20
-
21
- export function transpile(script: string) {
22
- return ts.factory.createExpressionStatement(
23
- ts.factory.createIdentifier(ts.transpile(script)),
24
- );
25
- }
26
-
27
- // export function require(variable: string, location: string) {
28
- // return ts.factory.createImportDeclaration(
29
- // undefined,
30
- // undefined,
31
- // ts.factory.createImportClause(
32
- // false,
33
- // undefined,
34
- // ts.factory.createNamespaceImport(
35
- // ts.factory.createIdentifier(variable),
36
- // ),
37
- // ),
38
- // ts.factory.createStringLiteral(location),
39
- // );
40
- // }
41
-
42
- // export function importModulo(variable: string, location: string) {
43
- // return ts.factory.createImportDeclaration(
44
- // undefined,
45
- // undefined,
46
- // ts.factory.createImportClause(
47
- // false,
48
- // undefined,
49
- // ts.factory.createNamedImports([
50
- // ts.factory.createImportSpecifier(
51
- // false,
52
- // undefined,
53
- // ts.factory.createIdentifier(variable),
54
- // ),
55
- // ]),
56
- // ),
57
- // ts.factory.createStringLiteral(location),
58
- // );
59
- // }
60
- }
1
+ import ts from "typescript";
2
+
3
+ export namespace StatementFactory {
4
+ export function constant(name: string, initializer?: ts.Expression) {
5
+ return ts.factory.createVariableStatement(
6
+ undefined,
7
+ ts.factory.createVariableDeclarationList(
8
+ [
9
+ ts.factory.createVariableDeclaration(
10
+ name,
11
+ undefined,
12
+ undefined,
13
+ initializer,
14
+ ),
15
+ ],
16
+ ts.NodeFlags.Const,
17
+ ),
18
+ );
19
+ }
20
+
21
+ export function transpile(script: string) {
22
+ return ts.factory.createExpressionStatement(
23
+ ts.factory.createIdentifier(ts.transpile(script)),
24
+ );
25
+ }
26
+
27
+ // export function require(variable: string, location: string) {
28
+ // return ts.factory.createImportDeclaration(
29
+ // undefined,
30
+ // undefined,
31
+ // ts.factory.createImportClause(
32
+ // false,
33
+ // undefined,
34
+ // ts.factory.createNamespaceImport(
35
+ // ts.factory.createIdentifier(variable),
36
+ // ),
37
+ // ),
38
+ // ts.factory.createStringLiteral(location),
39
+ // );
40
+ // }
41
+
42
+ // export function importModulo(variable: string, location: string) {
43
+ // return ts.factory.createImportDeclaration(
44
+ // undefined,
45
+ // undefined,
46
+ // ts.factory.createImportClause(
47
+ // false,
48
+ // undefined,
49
+ // ts.factory.createNamedImports([
50
+ // ts.factory.createImportSpecifier(
51
+ // false,
52
+ // undefined,
53
+ // ts.factory.createIdentifier(variable),
54
+ // ),
55
+ // ]),
56
+ // ),
57
+ // ts.factory.createStringLiteral(location),
58
+ // );
59
+ // }
60
+ }