typia 3.6.10 → 3.7.0-dev.20230331

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 (260) hide show
  1. package/lib/factories/MetadataTagFactory.js +140 -132
  2. package/lib/factories/MetadataTagFactory.js.map +1 -1
  3. package/lib/functional/$dictionary.d.ts +1 -0
  4. package/lib/functional/$dictionary.js +14 -0
  5. package/lib/functional/$dictionary.js.map +1 -0
  6. package/lib/functional/$is_custom.d.ts +2 -0
  7. package/lib/functional/$is_custom.js +12 -0
  8. package/lib/functional/$is_custom.js.map +1 -0
  9. package/lib/functional/Namespace.js +2 -0
  10. package/lib/functional/Namespace.js.map +1 -1
  11. package/lib/module.d.ts +25 -0
  12. package/lib/module.js +12 -1
  13. package/lib/module.js.map +1 -1
  14. package/lib/programmers/CheckerProgrammer.d.ts +2 -2
  15. package/lib/programmers/CheckerProgrammer.js +22 -22
  16. package/lib/programmers/CheckerProgrammer.js.map +1 -1
  17. package/lib/programmers/CloneProgrammer.js +2 -2
  18. package/lib/programmers/CloneProgrammer.js.map +1 -1
  19. package/lib/programmers/FeatureProgrammer.d.ts +3 -2
  20. package/lib/programmers/FeatureProgrammer.js +5 -5
  21. package/lib/programmers/FeatureProgrammer.js.map +1 -1
  22. package/lib/programmers/IsProgrammer.d.ts +1 -1
  23. package/lib/programmers/IsProgrammer.js +2 -2
  24. package/lib/programmers/IsProgrammer.js.map +1 -1
  25. package/lib/programmers/PruneProgrammer.js +2 -2
  26. package/lib/programmers/PruneProgrammer.js.map +1 -1
  27. package/lib/programmers/StringifyProgrammer.js +6 -6
  28. package/lib/programmers/StringifyProgrammer.js.map +1 -1
  29. package/lib/programmers/helpers/UnionExplorer.d.ts +7 -7
  30. package/lib/programmers/helpers/UnionExplorer.js +6 -6
  31. package/lib/programmers/helpers/UnionExplorer.js.map +1 -1
  32. package/lib/programmers/internal/check_array.js +36 -7
  33. package/lib/programmers/internal/check_array.js.map +1 -1
  34. package/lib/programmers/internal/check_bigint.d.ts +3 -1
  35. package/lib/programmers/internal/check_bigint.js +90 -61
  36. package/lib/programmers/internal/check_bigint.js.map +1 -1
  37. package/lib/programmers/internal/check_custom.d.ts +4 -0
  38. package/lib/programmers/internal/check_custom.js +30 -0
  39. package/lib/programmers/internal/check_custom.js.map +1 -0
  40. package/lib/programmers/internal/check_number.js +104 -75
  41. package/lib/programmers/internal/check_number.js.map +1 -1
  42. package/lib/programmers/internal/check_string.js +4 -3
  43. package/lib/programmers/internal/check_string.js.map +1 -1
  44. package/lib/programmers/internal/check_union_array_like.d.ts +2 -2
  45. package/lib/programmers/internal/check_union_array_like.js +4 -4
  46. package/lib/programmers/internal/check_union_array_like.js.map +1 -1
  47. package/lib/programmers/internal/check_union_tuple.js +2 -2
  48. package/lib/programmers/internal/check_union_tuple.js.map +1 -1
  49. package/lib/programmers/internal/feature_object_entries.js +1 -1
  50. package/lib/programmers/internal/feature_object_entries.js.map +1 -1
  51. package/lib/typings/Customizable.d.ts +7 -0
  52. package/lib/typings/Customizable.js +3 -0
  53. package/lib/typings/Customizable.js.map +1 -0
  54. package/package.json +1 -1
  55. package/src/IRandomGenerator.ts +17 -17
  56. package/src/IValidation.ts +21 -21
  57. package/src/Primitive.ts +104 -104
  58. package/src/TypeGuardError.ts +36 -36
  59. package/src/executable/TypiaGenerateWizard.ts +87 -87
  60. package/src/executable/TypiaSetupWizard.ts +152 -152
  61. package/src/executable/setup/ArgumentParser.ts +91 -91
  62. package/src/executable/setup/CommandExecutor.ts +8 -8
  63. package/src/executable/setup/FileRetriever.ts +33 -33
  64. package/src/executable/setup/PackageManager.ts +92 -92
  65. package/src/executable/setup/PluginConfigurator.ts +99 -99
  66. package/src/executable/typia.ts +38 -38
  67. package/src/factories/CommentFactory.ts +10 -10
  68. package/src/factories/ExpressionFactory.ts +77 -77
  69. package/src/factories/IdentifierFactory.ts +73 -73
  70. package/src/factories/LiteralFactory.ts +44 -44
  71. package/src/factories/MetadataCollection.ts +122 -122
  72. package/src/factories/MetadataFactory.ts +51 -51
  73. package/src/factories/MetadataTagFactory.ts +302 -276
  74. package/src/factories/StatementFactory.ts +60 -60
  75. package/src/factories/TemplateFactory.ts +56 -56
  76. package/src/factories/TypeFactory.ts +129 -129
  77. package/src/factories/TypiaFileFactory.ts +120 -120
  78. package/src/factories/ValueFactory.ts +12 -12
  79. package/src/factories/internal/metadata/MetadataHelper.ts +12 -12
  80. package/src/factories/internal/metadata/emplace_metadata_object.ts +142 -142
  81. package/src/factories/internal/metadata/explore_metadata.ts +92 -92
  82. package/src/factories/internal/metadata/iterate_metadata.ts +80 -80
  83. package/src/factories/internal/metadata/iterate_metadata_array.ts +29 -29
  84. package/src/factories/internal/metadata/iterate_metadata_atomic.ts +59 -59
  85. package/src/factories/internal/metadata/iterate_metadata_coalesce.ts +33 -33
  86. package/src/factories/internal/metadata/iterate_metadata_constant.ts +58 -58
  87. package/src/factories/internal/metadata/iterate_metadata_map.ts +41 -41
  88. package/src/factories/internal/metadata/iterate_metadata_native.ts +222 -222
  89. package/src/factories/internal/metadata/iterate_metadata_object.ts +48 -48
  90. package/src/factories/internal/metadata/iterate_metadata_resolve.ts +27 -27
  91. package/src/factories/internal/metadata/iterate_metadata_set.ts +33 -33
  92. package/src/factories/internal/metadata/iterate_metadata_template.ts +38 -38
  93. package/src/factories/internal/metadata/iterate_metadata_tuple.ts +45 -45
  94. package/src/factories/internal/metadata/iterate_metadata_union.ts +59 -59
  95. package/src/functional/$any.ts +3 -3
  96. package/src/functional/$dictionary.ts +17 -0
  97. package/src/functional/$every.ts +11 -11
  98. package/src/functional/$guard.ts +35 -35
  99. package/src/functional/$is_between.ts +7 -7
  100. package/src/functional/$is_custom.ts +14 -0
  101. package/src/functional/$is_date.ts +4 -4
  102. package/src/functional/$is_datetime.ts +3 -3
  103. package/src/functional/$is_email.ts +5 -5
  104. package/src/functional/$is_ipv4.ts +5 -5
  105. package/src/functional/$is_ipv6.ts +5 -5
  106. package/src/functional/$is_url.ts +5 -5
  107. package/src/functional/$is_uuid.ts +5 -5
  108. package/src/functional/$join.ts +50 -50
  109. package/src/functional/$number.ts +12 -12
  110. package/src/functional/$report.ts +15 -15
  111. package/src/functional/$rest.ts +3 -3
  112. package/src/functional/$string.ts +37 -37
  113. package/src/functional/$tail.ts +6 -6
  114. package/src/functional/Namespace.ts +127 -125
  115. package/src/index.ts +4 -4
  116. package/src/metadata/IJsDocTagInfo.ts +10 -10
  117. package/src/metadata/IMetadata.ts +25 -25
  118. package/src/metadata/IMetadataApplication.ts +7 -7
  119. package/src/metadata/IMetadataConstant.ts +16 -16
  120. package/src/metadata/IMetadataEntry.ts +6 -6
  121. package/src/metadata/IMetadataObject.ts +29 -29
  122. package/src/metadata/IMetadataProperty.ts +11 -11
  123. package/src/metadata/IMetadataTag.ts +105 -105
  124. package/src/metadata/Metadata.ts +534 -534
  125. package/src/metadata/MetadataConstant.ts +3 -3
  126. package/src/metadata/MetadataObject.ts +131 -131
  127. package/src/metadata/MetadataProperty.ts +64 -64
  128. package/src/module.ts +1986 -1946
  129. package/src/programmers/ApplicationProgrammer.ts +55 -55
  130. package/src/programmers/AssertCloneProgrammer.ts +70 -70
  131. package/src/programmers/AssertParseProgrammer.ts +65 -65
  132. package/src/programmers/AssertProgrammer.ts +232 -232
  133. package/src/programmers/AssertPruneProgrammer.ts +67 -67
  134. package/src/programmers/AssertStringifyProgrammer.ts +71 -71
  135. package/src/programmers/CheckerProgrammer.ts +923 -893
  136. package/src/programmers/CloneProgrammer.ts +388 -386
  137. package/src/programmers/FeatureProgrammer.ts +512 -505
  138. package/src/programmers/IsCloneProgrammer.ts +80 -80
  139. package/src/programmers/IsParseProgrammer.ts +74 -74
  140. package/src/programmers/IsProgrammer.ts +201 -200
  141. package/src/programmers/IsPruneProgrammer.ts +75 -75
  142. package/src/programmers/IsStringifyProgrammer.ts +81 -81
  143. package/src/programmers/PruneProgrammer.ts +343 -341
  144. package/src/programmers/RandomProgrammer.ts +388 -388
  145. package/src/programmers/StringifyProgrammer.ts +801 -795
  146. package/src/programmers/ValidateCloneProgrammer.ts +90 -90
  147. package/src/programmers/ValidateParseProgrammer.ts +69 -69
  148. package/src/programmers/ValidateProgrammer.ts +266 -266
  149. package/src/programmers/ValidatePruneProgrammer.ts +83 -83
  150. package/src/programmers/ValidateStringifyProgrammer.ts +89 -89
  151. package/src/programmers/helpers/AtomicPredicator.ts +31 -31
  152. package/src/programmers/helpers/CloneJoiner.ts +134 -134
  153. package/src/programmers/helpers/FunctionImporeter.ts +55 -55
  154. package/src/programmers/helpers/IExpressionEntry.ts +12 -12
  155. package/src/programmers/helpers/OptionPredicator.ts +19 -19
  156. package/src/programmers/helpers/PruneJoiner.ts +52 -52
  157. package/src/programmers/helpers/RandomJoiner.ts +149 -149
  158. package/src/programmers/helpers/RandomRanger.ts +216 -216
  159. package/src/programmers/helpers/StringifyJoinder.ts +114 -114
  160. package/src/programmers/helpers/StringifyPredicator.ts +18 -18
  161. package/src/programmers/helpers/UnionExplorer.ts +281 -274
  162. package/src/programmers/helpers/UnionPredicator.ts +81 -81
  163. package/src/programmers/internal/application_array.ts +37 -37
  164. package/src/programmers/internal/application_boolean.ts +17 -17
  165. package/src/programmers/internal/application_constant.ts +29 -29
  166. package/src/programmers/internal/application_default.ts +17 -17
  167. package/src/programmers/internal/application_default_string.ts +32 -32
  168. package/src/programmers/internal/application_native.ts +29 -29
  169. package/src/programmers/internal/application_number.ts +73 -73
  170. package/src/programmers/internal/application_object.ts +153 -153
  171. package/src/programmers/internal/application_schema.ts +184 -184
  172. package/src/programmers/internal/application_string.ts +45 -45
  173. package/src/programmers/internal/application_templates.ts +27 -27
  174. package/src/programmers/internal/application_tuple.ts +29 -29
  175. package/src/programmers/internal/check_array.ts +31 -22
  176. package/src/programmers/internal/check_array_length.ts +44 -44
  177. package/src/programmers/internal/check_bigint.ts +84 -64
  178. package/src/programmers/internal/check_custom.ts +32 -0
  179. package/src/programmers/internal/check_dynamic_properties.ts +197 -197
  180. package/src/programmers/internal/check_everything.ts +28 -28
  181. package/src/programmers/internal/check_native.ts +21 -21
  182. package/src/programmers/internal/check_number.ts +155 -145
  183. package/src/programmers/internal/check_object.ts +48 -48
  184. package/src/programmers/internal/check_string.ts +30 -24
  185. package/src/programmers/internal/check_string_tags.ts +63 -63
  186. package/src/programmers/internal/check_template.ts +50 -50
  187. package/src/programmers/internal/check_union_array_like.ts +265 -260
  188. package/src/programmers/internal/check_union_tuple.ts +35 -33
  189. package/src/programmers/internal/decode_union_object.ts +73 -73
  190. package/src/programmers/internal/feature_object_entries.ts +60 -59
  191. package/src/programmers/internal/metadata_to_pattern.ts +31 -31
  192. package/src/programmers/internal/prune_object_properties.ts +60 -60
  193. package/src/programmers/internal/stringify_dynamic_properties.ts +165 -165
  194. package/src/programmers/internal/stringify_native.ts +8 -8
  195. package/src/programmers/internal/stringify_regular_properties.ts +81 -81
  196. package/src/programmers/internal/template_to_pattern.ts +15 -15
  197. package/src/schemas/IJsonApplication.ts +9 -9
  198. package/src/schemas/IJsonComponents.ts +26 -26
  199. package/src/schemas/IJsonSchema.ts +121 -121
  200. package/src/transform.ts +21 -21
  201. package/src/transformers/CallExpressionTransformer.ts +172 -172
  202. package/src/transformers/ExpressionWithArgumentTransformer.ts +66 -66
  203. package/src/transformers/FileTransformer.ts +49 -49
  204. package/src/transformers/IProject.ts +11 -11
  205. package/src/transformers/ITransformOptions.ts +62 -62
  206. package/src/transformers/ImportTransformer.ts +60 -60
  207. package/src/transformers/NodeTransformer.ts +19 -19
  208. package/src/transformers/features/miscellaneous/ApplicationTransformer.ts +120 -120
  209. package/src/transformers/features/miscellaneous/AssertCloneTransformer.ts +9 -9
  210. package/src/transformers/features/miscellaneous/AssertPruneTransformer.ts +9 -9
  211. package/src/transformers/features/miscellaneous/CloneTransformer.ts +9 -9
  212. package/src/transformers/features/miscellaneous/CreateAssertCloneTransformer.ts +9 -9
  213. package/src/transformers/features/miscellaneous/CreateAssertPruneTransformer.ts +9 -9
  214. package/src/transformers/features/miscellaneous/CreateCloneTransformer.ts +9 -9
  215. package/src/transformers/features/miscellaneous/CreateIsCloneTransformer.ts +9 -9
  216. package/src/transformers/features/miscellaneous/CreateIsPruneTransformer.ts +9 -9
  217. package/src/transformers/features/miscellaneous/CreatePruneTransformer.ts +9 -9
  218. package/src/transformers/features/miscellaneous/CreateRandomGenerator.ts +42 -42
  219. package/src/transformers/features/miscellaneous/CreateValidateCloneTransformer.ts +9 -9
  220. package/src/transformers/features/miscellaneous/CreateValidatePruneTransformer.ts +9 -9
  221. package/src/transformers/features/miscellaneous/IsCloneTransformer.ts +9 -9
  222. package/src/transformers/features/miscellaneous/IsPruneTransformer.ts +9 -9
  223. package/src/transformers/features/miscellaneous/MetadataTransformer.ts +55 -55
  224. package/src/transformers/features/miscellaneous/PruneTransformer.ts +9 -9
  225. package/src/transformers/features/miscellaneous/RandomTransformer.ts +48 -48
  226. package/src/transformers/features/miscellaneous/ValidateCloneTransformer.ts +9 -9
  227. package/src/transformers/features/miscellaneous/ValidatePruneTransformer.ts +9 -9
  228. package/src/transformers/features/parsers/AssertParseTransformer.ts +9 -9
  229. package/src/transformers/features/parsers/CreateAssertParseTransformer.ts +9 -9
  230. package/src/transformers/features/parsers/CreateIsParseTransformer.ts +9 -9
  231. package/src/transformers/features/parsers/CreateValidateParseTransformer.ts +9 -9
  232. package/src/transformers/features/parsers/IsParseTransformer.ts +9 -9
  233. package/src/transformers/features/parsers/ValidateParseTransformer.ts +9 -9
  234. package/src/transformers/features/stringifiers/AssertStringifyTransformer.ts +10 -10
  235. package/src/transformers/features/stringifiers/CreateAssertStringifyTransformer.ts +9 -9
  236. package/src/transformers/features/stringifiers/CreateIsStringifyTransformer.ts +9 -9
  237. package/src/transformers/features/stringifiers/CreateStringifyTransformer.ts +9 -9
  238. package/src/transformers/features/stringifiers/CreateValidateStringifyProgrammer.ts +11 -11
  239. package/src/transformers/features/stringifiers/IsStringifyTransformer.ts +9 -9
  240. package/src/transformers/features/stringifiers/StringifyTransformer.ts +9 -9
  241. package/src/transformers/features/stringifiers/ValidateStringifyTransformer.ts +10 -10
  242. package/src/transformers/features/validators/AssertTransformer.ts +11 -11
  243. package/src/transformers/features/validators/CreateAssertTransformer.ts +12 -12
  244. package/src/transformers/features/validators/CreateIsTransformer.ts +10 -10
  245. package/src/transformers/features/validators/CreateValidateTransformer.ts +12 -12
  246. package/src/transformers/features/validators/IsTransformer.ts +10 -10
  247. package/src/transformers/features/validators/ValidateTransformer.ts +11 -11
  248. package/src/transformers/internal/GenericTransformer.ts +99 -99
  249. package/src/typings/Atomic.ts +17 -17
  250. package/src/typings/ClassProperties.ts +5 -5
  251. package/src/typings/Customizable.ts +7 -0
  252. package/src/typings/OmitNever.ts +3 -3
  253. package/src/typings/SpecialFields.ts +3 -3
  254. package/src/typings/Writable.ts +11 -11
  255. package/src/utils/ArrayUtil.ts +49 -49
  256. package/src/utils/Escaper.ts +50 -50
  257. package/src/utils/MapUtil.ts +14 -14
  258. package/src/utils/PatternUtil.ts +30 -30
  259. package/src/utils/RandomGenerator.ts +96 -96
  260. package/src/utils/Singleton.ts +17 -17
@@ -1,152 +1,152 @@
1
- import fs from "fs";
2
- import path from "path";
3
-
4
- import { ArgumentParser } from "./setup/ArgumentParser";
5
- import { CommandExecutor } from "./setup/CommandExecutor";
6
- import { PackageManager } from "./setup/PackageManager";
7
- import { PluginConfigurator } from "./setup/PluginConfigurator";
8
-
9
- export namespace TypiaSetupWizard {
10
- export interface IArguments {
11
- compiler: "ts-patch" | "ttypescript";
12
- manager: "npm" | "pnpm" | "yarn";
13
- project: string | null;
14
- }
15
-
16
- export async function setup(): Promise<void> {
17
- console.log("----------------------------------------");
18
- console.log(" Typia Setup Wizard");
19
- console.log("----------------------------------------");
20
-
21
- // PREPARE ASSETS
22
- const pack: PackageManager = await PackageManager.mount();
23
- const args: IArguments = await ArgumentParser.parse(pack)(true)(
24
- inquiry,
25
- );
26
-
27
- // INSTALL TYPESCRIPT
28
- pack.install({ dev: true, modulo: "typescript", version: "4.9.5" });
29
- args.project ??= (() => {
30
- CommandExecutor.run("npx tsc --init", false);
31
- return (args.project = "tsconfig.json");
32
- })();
33
- pack.install({ dev: true, modulo: "ts-node" });
34
-
35
- // INSTALL COMPILER
36
- pack.install({ dev: true, modulo: args.compiler });
37
- if (args.compiler === "ts-patch") {
38
- await pack.save((data) => {
39
- data.scripts ??= {};
40
- if (
41
- typeof data.scripts.prepare === "string" &&
42
- data.scripts.prepare.indexOf("ts-patch install") === -1
43
- )
44
- data.scripts.prepare =
45
- "ts-patch install && " + data.scripts.prepare;
46
- else data.scripts.prepare = "ts-patch install";
47
- });
48
- CommandExecutor.run("npm run prepare", false);
49
- }
50
-
51
- // INSTALL AND CONFIGURE TYPIA
52
- pack.install({ dev: false, modulo: "typia" });
53
- await PluginConfigurator.configure(pack, args);
54
- }
55
-
56
- const inquiry: ArgumentParser.Inquiry<IArguments> = async (
57
- pack,
58
- command,
59
- prompt,
60
- action,
61
- ) => {
62
- // PREPARE ASSETS
63
- command.option("--compiler [compiler]", "compiler type");
64
- command.option("--manager [manager", "package manager");
65
- command.option("--project [project]", "tsconfig.json file location");
66
-
67
- // INTERNAL PROCEDURES
68
- const questioned = { value: false };
69
- const select =
70
- (name: string) =>
71
- (message: string) =>
72
- async <Choice extends string>(
73
- choices: Choice[],
74
- ): Promise<Choice> => {
75
- questioned.value = true;
76
- return (
77
- await prompt()({
78
- type: "list",
79
- name: name,
80
- message: message,
81
- choices: choices,
82
- })
83
- )[name];
84
- };
85
- const configure = async () => {
86
- const fileList: string[] = await (
87
- await fs.promises.readdir(process.cwd())
88
- )
89
- .filter(
90
- (str) =>
91
- str.substring(0, 8) === "tsconfig" &&
92
- str.substring(str.length - 5) === ".json",
93
- )
94
- .sort((x, y) =>
95
- x === "tsconfig.json"
96
- ? -1
97
- : y === "tsconfig.json"
98
- ? 1
99
- : x < y
100
- ? -1
101
- : 1,
102
- );
103
- if (fileList.length === 0) {
104
- if (process.cwd() !== pack.directory)
105
- throw new Error(`Unable to find "tsconfig.json" file.`);
106
- return null;
107
- } else if (fileList.length === 1) return fileList[0];
108
- return select("tsconfig")("TS Config File")(fileList);
109
- };
110
-
111
- // DO CONSTRUCT
112
- return action(async (options) => {
113
- if (options.compiler === undefined) {
114
- console.log(COMPILER_DESCRIPTION);
115
- options.compiler = await select("compiler")(`Compiler`)(
116
- is_nest_cli(pack)
117
- ? ["ts-patch" as const, "ttypescript" as const]
118
- : ["ttypescript" as const, "ts-patch" as const],
119
- );
120
- }
121
- options.manager ??= await select("manager")("Package Manager")([
122
- "npm" as const,
123
- "pnpm" as const,
124
- "yarn" as const,
125
- ]);
126
- pack.manager = options.manager;
127
- options.project ??= await configure();
128
-
129
- if (questioned.value) console.log("");
130
- return options as IArguments;
131
- });
132
- };
133
-
134
- function is_nest_cli(pack: PackageManager): boolean {
135
- return (
136
- (typeof pack.data.scripts?.build === "string" &&
137
- pack.data.scripts.build.indexOf("nest build") !== -1) ||
138
- fs.existsSync(path.join(pack.directory, "nest-cli.json"))
139
- );
140
- }
141
- }
142
-
143
- const COMPILER_DESCRIPTION = [
144
- `About compiler, if you adapt "ttypescript", you should use "ttsc" instead.`,
145
- ``,
146
- `Otherwise, you choose "ts-patch", you can use the original "tsc" command.`,
147
- `However, the "ts-patch" hacks "node_modules/typescript" source code.`,
148
- `Also, whenever update "typescript", you've to run "npm run prepare" command.`,
149
- ``,
150
- `By the way, when using "@nest/cli", you must just choose "ts-patch".`,
151
- ``,
152
- ].join("\n");
1
+ import fs from "fs";
2
+ import path from "path";
3
+
4
+ import { ArgumentParser } from "./setup/ArgumentParser";
5
+ import { CommandExecutor } from "./setup/CommandExecutor";
6
+ import { PackageManager } from "./setup/PackageManager";
7
+ import { PluginConfigurator } from "./setup/PluginConfigurator";
8
+
9
+ export namespace TypiaSetupWizard {
10
+ export interface IArguments {
11
+ compiler: "ts-patch" | "ttypescript";
12
+ manager: "npm" | "pnpm" | "yarn";
13
+ project: string | null;
14
+ }
15
+
16
+ export async function setup(): Promise<void> {
17
+ console.log("----------------------------------------");
18
+ console.log(" Typia Setup Wizard");
19
+ console.log("----------------------------------------");
20
+
21
+ // PREPARE ASSETS
22
+ const pack: PackageManager = await PackageManager.mount();
23
+ const args: IArguments = await ArgumentParser.parse(pack)(true)(
24
+ inquiry,
25
+ );
26
+
27
+ // INSTALL TYPESCRIPT
28
+ pack.install({ dev: true, modulo: "typescript", version: "4.9.5" });
29
+ args.project ??= (() => {
30
+ CommandExecutor.run("npx tsc --init", false);
31
+ return (args.project = "tsconfig.json");
32
+ })();
33
+ pack.install({ dev: true, modulo: "ts-node" });
34
+
35
+ // INSTALL COMPILER
36
+ pack.install({ dev: true, modulo: args.compiler });
37
+ if (args.compiler === "ts-patch") {
38
+ await pack.save((data) => {
39
+ data.scripts ??= {};
40
+ if (
41
+ typeof data.scripts.prepare === "string" &&
42
+ data.scripts.prepare.indexOf("ts-patch install") === -1
43
+ )
44
+ data.scripts.prepare =
45
+ "ts-patch install && " + data.scripts.prepare;
46
+ else data.scripts.prepare = "ts-patch install";
47
+ });
48
+ CommandExecutor.run("npm run prepare", false);
49
+ }
50
+
51
+ // INSTALL AND CONFIGURE TYPIA
52
+ pack.install({ dev: false, modulo: "typia" });
53
+ await PluginConfigurator.configure(pack, args);
54
+ }
55
+
56
+ const inquiry: ArgumentParser.Inquiry<IArguments> = async (
57
+ pack,
58
+ command,
59
+ prompt,
60
+ action,
61
+ ) => {
62
+ // PREPARE ASSETS
63
+ command.option("--compiler [compiler]", "compiler type");
64
+ command.option("--manager [manager", "package manager");
65
+ command.option("--project [project]", "tsconfig.json file location");
66
+
67
+ // INTERNAL PROCEDURES
68
+ const questioned = { value: false };
69
+ const select =
70
+ (name: string) =>
71
+ (message: string) =>
72
+ async <Choice extends string>(
73
+ choices: Choice[],
74
+ ): Promise<Choice> => {
75
+ questioned.value = true;
76
+ return (
77
+ await prompt()({
78
+ type: "list",
79
+ name: name,
80
+ message: message,
81
+ choices: choices,
82
+ })
83
+ )[name];
84
+ };
85
+ const configure = async () => {
86
+ const fileList: string[] = await (
87
+ await fs.promises.readdir(process.cwd())
88
+ )
89
+ .filter(
90
+ (str) =>
91
+ str.substring(0, 8) === "tsconfig" &&
92
+ str.substring(str.length - 5) === ".json",
93
+ )
94
+ .sort((x, y) =>
95
+ x === "tsconfig.json"
96
+ ? -1
97
+ : y === "tsconfig.json"
98
+ ? 1
99
+ : x < y
100
+ ? -1
101
+ : 1,
102
+ );
103
+ if (fileList.length === 0) {
104
+ if (process.cwd() !== pack.directory)
105
+ throw new Error(`Unable to find "tsconfig.json" file.`);
106
+ return null;
107
+ } else if (fileList.length === 1) return fileList[0];
108
+ return select("tsconfig")("TS Config File")(fileList);
109
+ };
110
+
111
+ // DO CONSTRUCT
112
+ return action(async (options) => {
113
+ if (options.compiler === undefined) {
114
+ console.log(COMPILER_DESCRIPTION);
115
+ options.compiler = await select("compiler")(`Compiler`)(
116
+ is_nest_cli(pack)
117
+ ? ["ts-patch" as const, "ttypescript" as const]
118
+ : ["ttypescript" as const, "ts-patch" as const],
119
+ );
120
+ }
121
+ options.manager ??= await select("manager")("Package Manager")([
122
+ "npm" as const,
123
+ "pnpm" as const,
124
+ "yarn" as const,
125
+ ]);
126
+ pack.manager = options.manager;
127
+ options.project ??= await configure();
128
+
129
+ if (questioned.value) console.log("");
130
+ return options as IArguments;
131
+ });
132
+ };
133
+
134
+ function is_nest_cli(pack: PackageManager): boolean {
135
+ return (
136
+ (typeof pack.data.scripts?.build === "string" &&
137
+ pack.data.scripts.build.indexOf("nest build") !== -1) ||
138
+ fs.existsSync(path.join(pack.directory, "nest-cli.json"))
139
+ );
140
+ }
141
+ }
142
+
143
+ const COMPILER_DESCRIPTION = [
144
+ `About compiler, if you adapt "ttypescript", you should use "ttsc" instead.`,
145
+ ``,
146
+ `Otherwise, you choose "ts-patch", you can use the original "tsc" command.`,
147
+ `However, the "ts-patch" hacks "node_modules/typescript" source code.`,
148
+ `Also, whenever update "typescript", you've to run "npm run prepare" command.`,
149
+ ``,
150
+ `By the way, when using "@nest/cli", you must just choose "ts-patch".`,
151
+ ``,
152
+ ].join("\n");
@@ -1,91 +1,91 @@
1
- import type CommanderModule from "commander";
2
- import type * as InquirerModule from "inquirer";
3
- import path from "path";
4
-
5
- import { FileRetriever } from "./FileRetriever";
6
- import { PackageManager } from "./PackageManager";
7
-
8
- export namespace ArgumentParser {
9
- export type Inquiry<T> = (
10
- pack: PackageManager,
11
- command: CommanderModule.Command,
12
- prompt: (
13
- opt?: InquirerModule.StreamOptions,
14
- ) => InquirerModule.PromptModule,
15
- action: (closure: (options: Partial<T>) => Promise<T>) => Promise<T>,
16
- ) => Promise<T>;
17
-
18
- export const parse =
19
- (pack: PackageManager) =>
20
- (erase: boolean) =>
21
- async <T>(
22
- inquiry: (
23
- pack: PackageManager,
24
- command: CommanderModule.Command,
25
- prompt: (
26
- opt?: InquirerModule.StreamOptions,
27
- ) => InquirerModule.PromptModule,
28
- action: (
29
- closure: (options: Partial<T>) => Promise<T>,
30
- ) => Promise<T>,
31
- ) => Promise<T>,
32
- ): Promise<T> => {
33
- // INSTALL TEMPORARY PACKAGES
34
- const newbie = {
35
- commander: pack.install({
36
- dev: true,
37
- modulo: "commander",
38
- version: "10.0.0",
39
- silent: true,
40
- }),
41
- inquirer: pack.install({
42
- dev: true,
43
- modulo: "inquirer",
44
- version: "8.2.5",
45
- silent: true,
46
- }),
47
- };
48
-
49
- // LOAD INSTALLED MODULES
50
- const { program: command }: typeof CommanderModule =
51
- await FileRetriever.require(
52
- path.join("node_modules", "commander"),
53
- )(pack.directory);
54
- const { createPromptModule: prompt }: typeof InquirerModule =
55
- await FileRetriever.require(
56
- path.join("node_modules", "inquirer"),
57
- )(pack.directory);
58
-
59
- // TAKE OPTIONS
60
- const action = (closure: (options: Partial<T>) => Promise<T>) =>
61
- new Promise<T>((resolve, reject) => {
62
- command.action(async (options) => {
63
- try {
64
- resolve(await closure(options));
65
- } catch (exp) {
66
- reject(exp);
67
- }
68
- });
69
- command.parseAsync().catch(reject);
70
- });
71
- const output: T | Error = await (async () => {
72
- try {
73
- return await inquiry(pack, command, prompt, action);
74
- } catch (error) {
75
- return error as Error;
76
- }
77
- })();
78
-
79
- // REMOVE TEMPORARY PACKAGES
80
- if (erase === true) {
81
- if (newbie.commander)
82
- pack.erase({ modulo: "commander", silent: true });
83
- if (newbie.inquirer)
84
- pack.erase({ modulo: "inquirer", silent: true });
85
- }
86
-
87
- // RETURNS
88
- if (output instanceof Error) throw output;
89
- return output;
90
- };
91
- }
1
+ import type CommanderModule from "commander";
2
+ import type * as InquirerModule from "inquirer";
3
+ import path from "path";
4
+
5
+ import { FileRetriever } from "./FileRetriever";
6
+ import { PackageManager } from "./PackageManager";
7
+
8
+ export namespace ArgumentParser {
9
+ export type Inquiry<T> = (
10
+ pack: PackageManager,
11
+ command: CommanderModule.Command,
12
+ prompt: (
13
+ opt?: InquirerModule.StreamOptions,
14
+ ) => InquirerModule.PromptModule,
15
+ action: (closure: (options: Partial<T>) => Promise<T>) => Promise<T>,
16
+ ) => Promise<T>;
17
+
18
+ export const parse =
19
+ (pack: PackageManager) =>
20
+ (erase: boolean) =>
21
+ async <T>(
22
+ inquiry: (
23
+ pack: PackageManager,
24
+ command: CommanderModule.Command,
25
+ prompt: (
26
+ opt?: InquirerModule.StreamOptions,
27
+ ) => InquirerModule.PromptModule,
28
+ action: (
29
+ closure: (options: Partial<T>) => Promise<T>,
30
+ ) => Promise<T>,
31
+ ) => Promise<T>,
32
+ ): Promise<T> => {
33
+ // INSTALL TEMPORARY PACKAGES
34
+ const newbie = {
35
+ commander: pack.install({
36
+ dev: true,
37
+ modulo: "commander",
38
+ version: "10.0.0",
39
+ silent: true,
40
+ }),
41
+ inquirer: pack.install({
42
+ dev: true,
43
+ modulo: "inquirer",
44
+ version: "8.2.5",
45
+ silent: true,
46
+ }),
47
+ };
48
+
49
+ // LOAD INSTALLED MODULES
50
+ const { program: command }: typeof CommanderModule =
51
+ await FileRetriever.require(
52
+ path.join("node_modules", "commander"),
53
+ )(pack.directory);
54
+ const { createPromptModule: prompt }: typeof InquirerModule =
55
+ await FileRetriever.require(
56
+ path.join("node_modules", "inquirer"),
57
+ )(pack.directory);
58
+
59
+ // TAKE OPTIONS
60
+ const action = (closure: (options: Partial<T>) => Promise<T>) =>
61
+ new Promise<T>((resolve, reject) => {
62
+ command.action(async (options) => {
63
+ try {
64
+ resolve(await closure(options));
65
+ } catch (exp) {
66
+ reject(exp);
67
+ }
68
+ });
69
+ command.parseAsync().catch(reject);
70
+ });
71
+ const output: T | Error = await (async () => {
72
+ try {
73
+ return await inquiry(pack, command, prompt, action);
74
+ } catch (error) {
75
+ return error as Error;
76
+ }
77
+ })();
78
+
79
+ // REMOVE TEMPORARY PACKAGES
80
+ if (erase === true) {
81
+ if (newbie.commander)
82
+ pack.erase({ modulo: "commander", silent: true });
83
+ if (newbie.inquirer)
84
+ pack.erase({ modulo: "inquirer", silent: true });
85
+ }
86
+
87
+ // RETURNS
88
+ if (output instanceof Error) throw output;
89
+ return output;
90
+ };
91
+ }
@@ -1,8 +1,8 @@
1
- import cp from "child_process";
2
-
3
- export namespace CommandExecutor {
4
- export function run(str: string, silent: boolean): void {
5
- if (silent === false) console.log(str);
6
- cp.execSync(str, { stdio: "ignore" });
7
- }
8
- }
1
+ import cp from "child_process";
2
+
3
+ export namespace CommandExecutor {
4
+ export function run(str: string, silent: boolean): void {
5
+ if (silent === false) console.log(str);
6
+ cp.execSync(str, { stdio: "ignore" });
7
+ }
8
+ }
@@ -1,33 +1,33 @@
1
- import fs from "fs";
2
- import path from "path";
3
-
4
- export namespace FileRetriever {
5
- export const directory =
6
- (name: string) =>
7
- (dir: string, depth: number = 0): string | null => {
8
- const location: string = path.join(dir, name);
9
- if (fs.existsSync(location)) return dir;
10
- else if (depth > 2) return null;
11
- return directory(name)(path.join(dir, ".."), depth + 1);
12
- };
13
-
14
- export const file =
15
- (name: string) =>
16
- (directory: string, depth: number = 0): string | null => {
17
- const location: string = path.join(directory, name);
18
- if (fs.existsSync(location)) return location;
19
- else if (depth > 2) return null;
20
- return file(name)(path.join(directory, ".."), depth + 1);
21
- };
22
-
23
- export const require =
24
- (name: string) =>
25
- async (directory: string, depth: number = 0) => {
26
- const location: string | null = file(name)(directory, depth);
27
- if (location === null)
28
- throw new Error(
29
- `Unable to find installed module. Please report to the nestia - https://github.com/samchon/nestia/issues`,
30
- );
31
- return import(location);
32
- };
33
- }
1
+ import fs from "fs";
2
+ import path from "path";
3
+
4
+ export namespace FileRetriever {
5
+ export const directory =
6
+ (name: string) =>
7
+ (dir: string, depth: number = 0): string | null => {
8
+ const location: string = path.join(dir, name);
9
+ if (fs.existsSync(location)) return dir;
10
+ else if (depth > 2) return null;
11
+ return directory(name)(path.join(dir, ".."), depth + 1);
12
+ };
13
+
14
+ export const file =
15
+ (name: string) =>
16
+ (directory: string, depth: number = 0): string | null => {
17
+ const location: string = path.join(directory, name);
18
+ if (fs.existsSync(location)) return location;
19
+ else if (depth > 2) return null;
20
+ return file(name)(path.join(directory, ".."), depth + 1);
21
+ };
22
+
23
+ export const require =
24
+ (name: string) =>
25
+ async (directory: string, depth: number = 0) => {
26
+ const location: string | null = file(name)(directory, depth);
27
+ if (location === null)
28
+ throw new Error(
29
+ `Unable to find installed module. Please report to the nestia - https://github.com/samchon/nestia/issues`,
30
+ );
31
+ return import(location);
32
+ };
33
+ }