typia 7.4.2 → 7.5.0-dev.20241218

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 (445) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +148 -148
  3. package/lib/executable/typia.js +0 -0
  4. package/package.json +3 -3
  5. package/src/IRandomGenerator.ts +49 -49
  6. package/src/IReadableURLSearchParams.ts +9 -9
  7. package/src/IValidation.ts +21 -21
  8. package/src/executable/TypiaGenerateWizard.ts +83 -83
  9. package/src/executable/TypiaPatchWizard.ts +45 -45
  10. package/src/executable/TypiaSetupWizard.ts +179 -179
  11. package/src/executable/setup/ArgumentParser.ts +42 -42
  12. package/src/executable/setup/FileRetriever.ts +19 -19
  13. package/src/executable/setup/PackageManager.ts +87 -87
  14. package/src/factories/ExpressionFactory.ts +216 -216
  15. package/src/factories/IdentifierFactory.ts +89 -89
  16. package/src/factories/JsonMetadataFactory.ts +83 -83
  17. package/src/factories/LiteralFactory.ts +52 -52
  18. package/src/factories/MetadataCollection.ts +278 -278
  19. package/src/factories/MetadataCommentTagFactory.ts +650 -650
  20. package/src/factories/MetadataFactory.ts +404 -404
  21. package/src/factories/MetadataTypeTagFactory.ts +411 -411
  22. package/src/factories/MetadataTypeTagSchemaFactory.ts +82 -82
  23. package/src/factories/NumericRangeFactory.ts +72 -72
  24. package/src/factories/ProtobufFactory.ts +875 -875
  25. package/src/factories/StatementFactory.ts +90 -90
  26. package/src/factories/TemplateFactory.ts +64 -64
  27. package/src/factories/TypeFactory.ts +140 -140
  28. package/src/factories/internal/metadata/IMetadataIteratorProps.ts +17 -17
  29. package/src/factories/internal/metadata/MetadataHelper.ts +21 -21
  30. package/src/factories/internal/metadata/emplace_metadata_alias.ts +33 -33
  31. package/src/factories/internal/metadata/emplace_metadata_array_type.ts +39 -39
  32. package/src/factories/internal/metadata/emplace_metadata_object.ts +208 -208
  33. package/src/factories/internal/metadata/emplace_metadata_tuple.ts +57 -57
  34. package/src/factories/internal/metadata/explore_metadata.ts +31 -31
  35. package/src/factories/internal/metadata/iterate_metadata.ts +54 -54
  36. package/src/factories/internal/metadata/iterate_metadata_alias.ts +33 -33
  37. package/src/factories/internal/metadata/iterate_metadata_array.ts +63 -63
  38. package/src/factories/internal/metadata/iterate_metadata_atomic.ts +62 -62
  39. package/src/factories/internal/metadata/iterate_metadata_coalesce.ts +28 -28
  40. package/src/factories/internal/metadata/iterate_metadata_collection.ts +146 -146
  41. package/src/factories/internal/metadata/iterate_metadata_comment_tags.ts +32 -32
  42. package/src/factories/internal/metadata/iterate_metadata_constant.ts +76 -76
  43. package/src/factories/internal/metadata/iterate_metadata_escape.ts +49 -49
  44. package/src/factories/internal/metadata/iterate_metadata_function.ts +91 -91
  45. package/src/factories/internal/metadata/iterate_metadata_intersection.ts +213 -213
  46. package/src/factories/internal/metadata/iterate_metadata_map.ts +57 -57
  47. package/src/factories/internal/metadata/iterate_metadata_native.ts +255 -255
  48. package/src/factories/internal/metadata/iterate_metadata_object.ts +35 -35
  49. package/src/factories/internal/metadata/iterate_metadata_set.ts +57 -57
  50. package/src/factories/internal/metadata/iterate_metadata_sort.ts +87 -87
  51. package/src/factories/internal/metadata/iterate_metadata_template.ts +41 -41
  52. package/src/factories/internal/metadata/iterate_metadata_tuple.ts +26 -26
  53. package/src/factories/internal/metadata/iterate_metadata_union.ts +19 -19
  54. package/src/functional.ts +750 -750
  55. package/src/http.ts +1047 -1047
  56. package/src/internal/_IProtobufWriter.ts +18 -18
  57. package/src/internal/_ProtobufReader.ts +194 -194
  58. package/src/internal/_ProtobufSizer.ts +145 -145
  59. package/src/internal/_ProtobufWriter.ts +145 -145
  60. package/src/internal/_accessExpressionAsString.ts +46 -46
  61. package/src/internal/_assertGuard.ts +13 -13
  62. package/src/internal/_functionalTypeGuardErrorFactory.ts +4 -4
  63. package/src/internal/_httpFormDataReadArray.ts +4 -4
  64. package/src/internal/_httpFormDataReadBigint.ts +18 -18
  65. package/src/internal/_httpFormDataReadBlob.ts +10 -10
  66. package/src/internal/_httpFormDataReadBoolean.ts +16 -16
  67. package/src/internal/_httpFormDataReadFile.ts +10 -10
  68. package/src/internal/_httpFormDataReadNumber.ts +15 -15
  69. package/src/internal/_httpFormDataReadString.ts +10 -10
  70. package/src/internal/_httpHeaderReadBigint.ts +10 -10
  71. package/src/internal/_httpHeaderReadBoolean.ts +8 -8
  72. package/src/internal/_httpHeaderReadNumber.ts +7 -7
  73. package/src/internal/_httpParameterReadBigint.ts +10 -10
  74. package/src/internal/_httpParameterReadBoolean.ts +8 -8
  75. package/src/internal/_httpParameterReadNumber.ts +7 -7
  76. package/src/internal/_httpParameterReadString.ts +2 -2
  77. package/src/internal/_httpQueryParseURLSearchParams.ts +12 -12
  78. package/src/internal/_httpQueryReadArray.ts +4 -4
  79. package/src/internal/_httpQueryReadBigint.ts +12 -12
  80. package/src/internal/_httpQueryReadBoolean.ts +14 -14
  81. package/src/internal/_httpQueryReadNumber.ts +9 -9
  82. package/src/internal/_httpQueryReadString.ts +4 -4
  83. package/src/internal/_isBetween.ts +2 -2
  84. package/src/internal/_isBigintString.ts +8 -8
  85. package/src/internal/_isFormatByte.ts +7 -7
  86. package/src/internal/_isFormatDate.ts +3 -3
  87. package/src/internal/_isFormatDateTime.ts +4 -4
  88. package/src/internal/_isFormatDuration.ts +4 -4
  89. package/src/internal/_isFormatEmail.ts +4 -4
  90. package/src/internal/_isFormatHostname.ts +4 -4
  91. package/src/internal/_isFormatIdnEmail.ts +4 -4
  92. package/src/internal/_isFormatIdnHostname.ts +4 -4
  93. package/src/internal/_isFormatIpv4.ts +4 -4
  94. package/src/internal/_isFormatIpv6.ts +4 -4
  95. package/src/internal/_isFormatIri.ts +3 -3
  96. package/src/internal/_isFormatIriReference.ts +4 -4
  97. package/src/internal/_isFormatJsonPointer.ts +3 -3
  98. package/src/internal/_isFormatPassword.ts +1 -1
  99. package/src/internal/_isFormatRegex.ts +8 -8
  100. package/src/internal/_isFormatRelativeJsonPointer.ts +4 -4
  101. package/src/internal/_isFormatTime.ts +4 -4
  102. package/src/internal/_isFormatUri.ts +6 -6
  103. package/src/internal/_isFormatUriReference.ts +5 -5
  104. package/src/internal/_isFormatUriTemplate.ts +4 -4
  105. package/src/internal/_isFormatUrl.ts +4 -4
  106. package/src/internal/_isFormatUuid.ts +3 -3
  107. package/src/internal/_isTypeFloat.ts +5 -5
  108. package/src/internal/_isTypeInt32.ts +5 -5
  109. package/src/internal/_isTypeInt64.ts +5 -5
  110. package/src/internal/_isTypeUint32.ts +5 -5
  111. package/src/internal/_isTypeUint64.ts +5 -5
  112. package/src/internal/_isUniqueItems.ts +159 -159
  113. package/src/internal/_jsonStringifyNumber.ts +12 -12
  114. package/src/internal/_jsonStringifyRest.ts +3 -3
  115. package/src/internal/_jsonStringifyString.ts +42 -42
  116. package/src/internal/_jsonStringifyTail.ts +2 -2
  117. package/src/internal/_llmApplicationFinalize.ts +20 -20
  118. package/src/internal/_miscCloneAny.ts +46 -46
  119. package/src/internal/_notationAny.ts +37 -37
  120. package/src/internal/_notationCamel.ts +13 -13
  121. package/src/internal/_notationPascal.ts +8 -8
  122. package/src/internal/_notationSnake.ts +43 -43
  123. package/src/internal/_randomArray.ts +21 -21
  124. package/src/internal/_randomBigint.ts +6 -6
  125. package/src/internal/_randomBoolean.ts +1 -1
  126. package/src/internal/_randomFormatByte.ts +3 -3
  127. package/src/internal/_randomFormatDate.ts +18 -18
  128. package/src/internal/_randomFormatDatetime.ts +16 -16
  129. package/src/internal/_randomFormatDuration.ts +27 -27
  130. package/src/internal/_randomFormatEmail.ts +11 -11
  131. package/src/internal/_randomFormatHostname.ts +6 -6
  132. package/src/internal/_randomFormatIdnEmail.ts +3 -3
  133. package/src/internal/_randomFormatIdnHostname.ts +3 -3
  134. package/src/internal/_randomFormatIpv4.ts +11 -11
  135. package/src/internal/_randomFormatIpv6.ts +11 -11
  136. package/src/internal/_randomFormatIri.ts +3 -3
  137. package/src/internal/_randomFormatIriReference.ts +3 -3
  138. package/src/internal/_randomFormatJsonPointer.ts +7 -7
  139. package/src/internal/_randomFormatPassword.ts +8 -8
  140. package/src/internal/_randomFormatRegex.ts +4 -4
  141. package/src/internal/_randomFormatRelativeJsonPointer.ts +8 -8
  142. package/src/internal/_randomFormatTime.ts +14 -14
  143. package/src/internal/_randomFormatUri.ts +3 -3
  144. package/src/internal/_randomFormatUriReference.ts +3 -3
  145. package/src/internal/_randomFormatUriTemplate.ts +3 -3
  146. package/src/internal/_randomFormatUrl.ts +11 -11
  147. package/src/internal/_randomFormatUuid.ts +6 -6
  148. package/src/internal/_randomInteger.ts +47 -47
  149. package/src/internal/_randomNumber.ts +74 -74
  150. package/src/internal/_randomPattern.ts +10 -10
  151. package/src/internal/_randomPick.ts +9 -9
  152. package/src/internal/_randomString.ts +24 -24
  153. package/src/internal/_throwTypeGuardError.ts +5 -5
  154. package/src/internal/_validateReport.ts +13 -13
  155. package/src/internal/private/__notationCapitalize.ts +2 -2
  156. package/src/internal/private/__notationUnsnake.ts +24 -24
  157. package/src/json.ts +752 -752
  158. package/src/llm.ts +481 -481
  159. package/src/misc.ts +658 -658
  160. package/src/module.ts +937 -937
  161. package/src/notations.ts +827 -827
  162. package/src/programmers/AssertProgrammer.ts +454 -454
  163. package/src/programmers/CheckerProgrammer.ts +1617 -1617
  164. package/src/programmers/FeatureProgrammer.ts +622 -622
  165. package/src/programmers/ImportProgrammer.ts +185 -185
  166. package/src/programmers/IsProgrammer.ts +273 -273
  167. package/src/programmers/RandomProgrammer.ts +1190 -1190
  168. package/src/programmers/TypiaProgrammer.ts +174 -174
  169. package/src/programmers/ValidateProgrammer.ts +439 -439
  170. package/src/programmers/functional/FunctionalAssertFunctionProgrammer.ts +153 -153
  171. package/src/programmers/functional/FunctionalAssertParametersProgrammer.ts +125 -125
  172. package/src/programmers/functional/FunctionalAssertReturnProgrammer.ts +115 -115
  173. package/src/programmers/functional/FunctionalIsFunctionProgrammer.ts +72 -72
  174. package/src/programmers/functional/FunctionalIsParametersProgrammer.ts +113 -113
  175. package/src/programmers/functional/FunctionalIsReturnProgrammer.ts +116 -116
  176. package/src/programmers/functional/FunctionalValidateFunctionProgrammer.ts +119 -119
  177. package/src/programmers/functional/FunctionalValidateParametersProgrammer.ts +274 -274
  178. package/src/programmers/functional/FunctionalValidateReturnProgrammer.ts +135 -135
  179. package/src/programmers/functional/internal/FunctionalGeneralProgrammer.ts +34 -34
  180. package/src/programmers/helpers/AtomicPredicator.ts +35 -35
  181. package/src/programmers/helpers/CloneJoiner.ts +143 -143
  182. package/src/programmers/helpers/FunctionProgrammer.ts +67 -67
  183. package/src/programmers/helpers/HttpMetadataUtil.ts +21 -21
  184. package/src/programmers/helpers/NotationJoiner.ts +144 -144
  185. package/src/programmers/helpers/OptionPredicator.ts +15 -15
  186. package/src/programmers/helpers/ProtobufUtil.ts +228 -228
  187. package/src/programmers/helpers/PruneJoiner.ts +148 -148
  188. package/src/programmers/helpers/RandomJoiner.ts +168 -168
  189. package/src/programmers/helpers/StringifyJoinder.ts +115 -115
  190. package/src/programmers/helpers/StringifyPredicator.ts +13 -13
  191. package/src/programmers/helpers/UnionExplorer.ts +372 -372
  192. package/src/programmers/helpers/UnionPredicator.ts +79 -79
  193. package/src/programmers/helpers/disable_function_programmer_declare.ts +32 -32
  194. package/src/programmers/http/HttpAssertFormDataProgrammer.ts +99 -99
  195. package/src/programmers/http/HttpAssertHeadersProgrammer.ts +99 -99
  196. package/src/programmers/http/HttpAssertQueryProgrammer.ts +105 -105
  197. package/src/programmers/http/HttpFormDataProgrammer.ts +308 -308
  198. package/src/programmers/http/HttpHeadersProgrammer.ts +400 -400
  199. package/src/programmers/http/HttpIsFormDataProgrammer.ts +108 -108
  200. package/src/programmers/http/HttpIsHeadersProgrammer.ts +108 -108
  201. package/src/programmers/http/HttpIsQueryProgrammer.ts +114 -114
  202. package/src/programmers/http/HttpParameterProgrammer.ts +115 -115
  203. package/src/programmers/http/HttpQueryProgrammer.ts +336 -336
  204. package/src/programmers/http/HttpValidateFormDataProgrammer.ts +92 -92
  205. package/src/programmers/http/HttpValidateHeadersProgrammer.ts +92 -92
  206. package/src/programmers/http/HttpValidateQueryProgrammer.ts +98 -98
  207. package/src/programmers/internal/check_array_length.ts +47 -47
  208. package/src/programmers/internal/check_bigint.ts +50 -50
  209. package/src/programmers/internal/check_dynamic_key.ts +201 -201
  210. package/src/programmers/internal/check_dynamic_properties.ts +208 -208
  211. package/src/programmers/internal/check_everything.ts +23 -23
  212. package/src/programmers/internal/check_native.ts +27 -27
  213. package/src/programmers/internal/check_number.ts +112 -112
  214. package/src/programmers/internal/check_object.ts +75 -75
  215. package/src/programmers/internal/check_string.ts +50 -50
  216. package/src/programmers/internal/check_template.ts +48 -48
  217. package/src/programmers/internal/check_union_array_like.ts +335 -335
  218. package/src/programmers/internal/decode_union_object.ts +116 -116
  219. package/src/programmers/internal/feature_object_entries.ts +61 -61
  220. package/src/programmers/internal/json_schema_alias.ts +47 -47
  221. package/src/programmers/internal/json_schema_array.ts +45 -45
  222. package/src/programmers/internal/json_schema_bigint.ts +15 -15
  223. package/src/programmers/internal/json_schema_boolean.ts +15 -15
  224. package/src/programmers/internal/json_schema_constant.ts +26 -26
  225. package/src/programmers/internal/json_schema_description.ts +12 -12
  226. package/src/programmers/internal/json_schema_discriminator.ts +35 -35
  227. package/src/programmers/internal/json_schema_escaped.ts +82 -82
  228. package/src/programmers/internal/json_schema_native.ts +33 -33
  229. package/src/programmers/internal/json_schema_number.ts +15 -15
  230. package/src/programmers/internal/json_schema_object.ts +158 -158
  231. package/src/programmers/internal/json_schema_plugin.ts +18 -18
  232. package/src/programmers/internal/json_schema_station.ts +182 -182
  233. package/src/programmers/internal/json_schema_string.ts +15 -15
  234. package/src/programmers/internal/json_schema_template.ts +55 -55
  235. package/src/programmers/internal/json_schema_title.ts +20 -20
  236. package/src/programmers/internal/json_schema_tuple.ts +35 -35
  237. package/src/programmers/internal/metadata_to_pattern.ts +42 -42
  238. package/src/programmers/internal/postfix_of_tuple.ts +5 -5
  239. package/src/programmers/internal/prune_object_properties.ts +71 -71
  240. package/src/programmers/internal/stringify_dynamic_properties.ts +162 -162
  241. package/src/programmers/internal/stringify_regular_properties.ts +81 -81
  242. package/src/programmers/internal/template_to_pattern.ts +23 -23
  243. package/src/programmers/internal/wrap_metadata_rest_tuple.ts +23 -23
  244. package/src/programmers/json/JsonApplicationProgrammer.ts +279 -279
  245. package/src/programmers/json/JsonAssertParseProgrammer.ts +113 -113
  246. package/src/programmers/json/JsonAssertStringifyProgrammer.ts +115 -115
  247. package/src/programmers/json/JsonIsParseProgrammer.ts +114 -114
  248. package/src/programmers/json/JsonIsStringifyProgrammer.ts +108 -108
  249. package/src/programmers/json/JsonSchemasProgrammer.ts +91 -91
  250. package/src/programmers/json/JsonStringifyProgrammer.ts +1124 -1124
  251. package/src/programmers/json/JsonValidateParseProgrammer.ts +105 -105
  252. package/src/programmers/json/JsonValidateStringifyProgrammer.ts +124 -124
  253. package/src/programmers/llm/LlmApplicationOfValidateProgrammer.ts +90 -90
  254. package/src/programmers/llm/LlmApplicationProgrammer.ts +280 -280
  255. package/src/programmers/llm/LlmModelPredicator.ts +127 -127
  256. package/src/programmers/llm/LlmParametersProgrammer.ts +93 -93
  257. package/src/programmers/llm/LlmSchemaProgrammer.ts +192 -192
  258. package/src/programmers/misc/MiscAssertCloneProgrammer.ts +95 -95
  259. package/src/programmers/misc/MiscAssertPruneProgrammer.ts +116 -116
  260. package/src/programmers/misc/MiscCloneProgrammer.ts +1032 -1032
  261. package/src/programmers/misc/MiscIsCloneProgrammer.ts +99 -99
  262. package/src/programmers/misc/MiscIsPruneProgrammer.ts +97 -97
  263. package/src/programmers/misc/MiscLiteralsProgrammer.ts +80 -80
  264. package/src/programmers/misc/MiscPruneProgrammer.ts +728 -728
  265. package/src/programmers/misc/MiscValidateCloneProgrammer.ts +111 -111
  266. package/src/programmers/misc/MiscValidatePruneProgrammer.ts +113 -113
  267. package/src/programmers/notations/NotationAssertGeneralProgrammer.ts +101 -101
  268. package/src/programmers/notations/NotationGeneralProgrammer.ts +984 -984
  269. package/src/programmers/notations/NotationIsGeneralProgrammer.ts +105 -105
  270. package/src/programmers/notations/NotationValidateGeneralProgrammer.ts +119 -119
  271. package/src/programmers/protobuf/ProtobufAssertDecodeProgrammer.ts +98 -98
  272. package/src/programmers/protobuf/ProtobufAssertEncodeProgrammer.ts +102 -102
  273. package/src/programmers/protobuf/ProtobufDecodeProgrammer.ts +654 -654
  274. package/src/programmers/protobuf/ProtobufEncodeProgrammer.ts +945 -945
  275. package/src/programmers/protobuf/ProtobufIsDecodeProgrammer.ts +109 -109
  276. package/src/programmers/protobuf/ProtobufIsEncodeProgrammer.ts +98 -98
  277. package/src/programmers/protobuf/ProtobufMessageProgrammer.ts +179 -179
  278. package/src/programmers/protobuf/ProtobufValidateDecodeProgrammer.ts +92 -92
  279. package/src/programmers/protobuf/ProtobufValidateEncodeProgrammer.ts +119 -119
  280. package/src/protobuf.ts +868 -868
  281. package/src/reflect.ts +57 -57
  282. package/src/schemas/json/IJsonApplication.ts +73 -73
  283. package/src/schemas/json/IJsonSchemaCollection.ts +29 -29
  284. package/src/schemas/json/__IJsonApplication.ts +63 -63
  285. package/src/schemas/llm/ILlmApplicationOfValidate.ts +55 -55
  286. package/src/schemas/llm/ILlmFunctionOfValidate.ts +39 -39
  287. package/src/schemas/metadata/IMetadata.ts +35 -35
  288. package/src/schemas/metadata/IMetadataAlias.ts +6 -6
  289. package/src/schemas/metadata/IMetadataAliasType.ts +12 -12
  290. package/src/schemas/metadata/IMetadataApplication.ts +7 -7
  291. package/src/schemas/metadata/IMetadataArray.ts +6 -6
  292. package/src/schemas/metadata/IMetadataComponents.ts +11 -11
  293. package/src/schemas/metadata/IMetadataConstantValue.ts +11 -11
  294. package/src/schemas/metadata/IMetadataDictionary.ts +11 -11
  295. package/src/schemas/metadata/IMetadataMap.ts +8 -8
  296. package/src/schemas/metadata/IMetadataNative.ts +6 -6
  297. package/src/schemas/metadata/IMetadataObject.ts +6 -6
  298. package/src/schemas/metadata/IMetadataObjectType.ts +13 -13
  299. package/src/schemas/metadata/IMetadataSet.ts +7 -7
  300. package/src/schemas/metadata/IMetadataTemplate.ts +7 -7
  301. package/src/schemas/metadata/IMetadataTuple.ts +6 -6
  302. package/src/schemas/metadata/IMetadataTypeTag.ts +16 -16
  303. package/src/schemas/metadata/Metadata.ts +669 -669
  304. package/src/schemas/metadata/MetadataAlias.ts +46 -46
  305. package/src/schemas/metadata/MetadataAliasType.ts +63 -63
  306. package/src/schemas/metadata/MetadataApplication.ts +44 -44
  307. package/src/schemas/metadata/MetadataArray.ts +49 -49
  308. package/src/schemas/metadata/MetadataAtomic.ts +87 -87
  309. package/src/schemas/metadata/MetadataComponents.ts +98 -98
  310. package/src/schemas/metadata/MetadataConstantValue.ts +62 -62
  311. package/src/schemas/metadata/MetadataMap.ts +48 -48
  312. package/src/schemas/metadata/MetadataNative.ts +44 -44
  313. package/src/schemas/metadata/MetadataObject.ts +48 -48
  314. package/src/schemas/metadata/MetadataObjectType.ts +149 -149
  315. package/src/schemas/metadata/MetadataParameter.ts +54 -54
  316. package/src/schemas/metadata/MetadataProperty.ts +59 -59
  317. package/src/schemas/metadata/MetadataSet.ts +45 -45
  318. package/src/schemas/metadata/MetadataTemplate.ts +80 -80
  319. package/src/schemas/metadata/MetadataTuple.ts +32 -32
  320. package/src/schemas/protobuf/IProtobufProperty.ts +6 -6
  321. package/src/schemas/protobuf/IProtobufPropertyType.ts +37 -37
  322. package/src/schemas/protobuf/IProtobufSchema.ts +50 -50
  323. package/src/tags/Example.ts +24 -24
  324. package/src/tags/Examples.ts +16 -16
  325. package/src/tags/Format.ts +50 -50
  326. package/src/tags/JsonSchemaPlugin.ts +8 -8
  327. package/src/tags/Sequence.ts +10 -10
  328. package/src/tags/TagBase.ts +82 -82
  329. package/src/tags/Type.ts +32 -32
  330. package/src/tags/UniqueItems.ts +14 -14
  331. package/src/tags/index.ts +21 -21
  332. package/src/transform.ts +35 -35
  333. package/src/transformers/CallExpressionTransformer.ts +547 -547
  334. package/src/transformers/FileTransformer.ts +136 -136
  335. package/src/transformers/IProgrammerProps.ts +11 -11
  336. package/src/transformers/ITransformOptions.ts +62 -62
  337. package/src/transformers/ITransformProps.ts +9 -9
  338. package/src/transformers/ITypiaContext.ts +18 -18
  339. package/src/transformers/ImportTransformer.ts +81 -81
  340. package/src/transformers/NodeTransformer.ts +17 -17
  341. package/src/transformers/TransformerError.ts +60 -60
  342. package/src/transformers/features/AssertTransformer.ts +24 -24
  343. package/src/transformers/features/CreateAssertTransformer.ts +24 -24
  344. package/src/transformers/features/CreateIsTransformer.ts +18 -18
  345. package/src/transformers/features/CreateRandomTransformer.ts +43 -43
  346. package/src/transformers/features/CreateValidateTransformer.ts +18 -18
  347. package/src/transformers/features/IsTransformer.ts +18 -18
  348. package/src/transformers/features/RandomTransformer.ts +41 -41
  349. package/src/transformers/features/ValidateTransformer.ts +18 -18
  350. package/src/transformers/features/functional/FunctionalGenericTransformer.ts +57 -57
  351. package/src/transformers/features/http/CreateHttpAssertFormDataTransformer.ts +13 -13
  352. package/src/transformers/features/http/CreateHttpAssertHeadersTransformer.ts +13 -13
  353. package/src/transformers/features/http/CreateHttpAssertQueryTransformer.ts +13 -13
  354. package/src/transformers/features/http/CreateHttpFormDataTransformer.ts +13 -13
  355. package/src/transformers/features/http/CreateHttpHeadersTransformer.ts +13 -13
  356. package/src/transformers/features/http/CreateHttpIsFormDataTransformer.ts +13 -13
  357. package/src/transformers/features/http/CreateHttpIsHeadersTransformer.ts +13 -13
  358. package/src/transformers/features/http/CreateHttpIsQueryTransformer.ts +13 -13
  359. package/src/transformers/features/http/CreateHttpParameterTransformer.ts +13 -13
  360. package/src/transformers/features/http/CreateHttpQueryTransformer.ts +13 -13
  361. package/src/transformers/features/http/CreateHttpValidateFormDataTransformer.ts +13 -13
  362. package/src/transformers/features/http/CreateHttpValidateHeadersTransformer.ts +13 -13
  363. package/src/transformers/features/http/CreateHttpValidateQueryTransformer.ts +13 -13
  364. package/src/transformers/features/http/HttpAssertFormDataTransformer.ts +13 -13
  365. package/src/transformers/features/http/HttpAssertHeadersTransformer.ts +13 -13
  366. package/src/transformers/features/http/HttpAssertQueryTransformer.ts +13 -13
  367. package/src/transformers/features/http/HttpFormDataTransformer.ts +13 -13
  368. package/src/transformers/features/http/HttpHeadersTransformer.ts +13 -13
  369. package/src/transformers/features/http/HttpIsFormDataTransformer.ts +13 -13
  370. package/src/transformers/features/http/HttpIsHeadersTransformer.ts +13 -13
  371. package/src/transformers/features/http/HttpIsQueryTransformer.ts +13 -13
  372. package/src/transformers/features/http/HttpParameterTransformer.ts +13 -13
  373. package/src/transformers/features/http/HttpQueryTransformer.ts +13 -13
  374. package/src/transformers/features/http/HttpValidateFormDataTransformer.ts +13 -13
  375. package/src/transformers/features/http/HttpValidateHeadersTransformer.ts +13 -13
  376. package/src/transformers/features/http/HttpValidateQueryTransformer.ts +13 -13
  377. package/src/transformers/features/json/JsonApplicationTransformer.ts +105 -105
  378. package/src/transformers/features/json/JsonAssertParseTransformer.ts +13 -13
  379. package/src/transformers/features/json/JsonAssertStringifyTransformer.ts +13 -13
  380. package/src/transformers/features/json/JsonCreateAssertParseTransformer.ts +13 -13
  381. package/src/transformers/features/json/JsonCreateAssertStringifyTransformer.ts +13 -13
  382. package/src/transformers/features/json/JsonCreateIsParseTransformer.ts +13 -13
  383. package/src/transformers/features/json/JsonCreateIsStringifyTransformer.ts +13 -13
  384. package/src/transformers/features/json/JsonCreateStringifyTransformer.ts +13 -13
  385. package/src/transformers/features/json/JsonCreateValidateParseTransformer.ts +13 -13
  386. package/src/transformers/features/json/JsonCreateValidateStringifyProgrammer.ts +13 -13
  387. package/src/transformers/features/json/JsonIsParseTransformer.ts +13 -13
  388. package/src/transformers/features/json/JsonIsStringifyTransformer.ts +13 -13
  389. package/src/transformers/features/json/JsonSchemasTransformer.ts +143 -143
  390. package/src/transformers/features/json/JsonStringifyTransformer.ts +13 -13
  391. package/src/transformers/features/json/JsonValidateParseTransformer.ts +13 -13
  392. package/src/transformers/features/json/JsonValidateStringifyTransformer.ts +13 -13
  393. package/src/transformers/features/llm/LlmApplicationOfValidateTransformer.ts +121 -121
  394. package/src/transformers/features/llm/LlmApplicationTransformer.ts +118 -118
  395. package/src/transformers/features/llm/LlmParametersTransformer.ts +94 -94
  396. package/src/transformers/features/llm/LlmSchemaTransformer.ts +135 -135
  397. package/src/transformers/features/misc/MiscAssertCloneTransformer.ts +13 -13
  398. package/src/transformers/features/misc/MiscAssertPruneTransformer.ts +13 -13
  399. package/src/transformers/features/misc/MiscCloneTransformer.ts +13 -13
  400. package/src/transformers/features/misc/MiscCreateAssertCloneTransformer.ts +13 -13
  401. package/src/transformers/features/misc/MiscCreateAssertPruneTransformer.ts +13 -13
  402. package/src/transformers/features/misc/MiscCreateCloneTransformer.ts +13 -13
  403. package/src/transformers/features/misc/MiscCreateIsCloneTransformer.ts +13 -13
  404. package/src/transformers/features/misc/MiscCreateIsPruneTransformer.ts +13 -13
  405. package/src/transformers/features/misc/MiscCreatePruneTransformer.ts +13 -13
  406. package/src/transformers/features/misc/MiscCreateValidateCloneTransformer.ts +13 -13
  407. package/src/transformers/features/misc/MiscCreateValidatePruneTransformer.ts +13 -13
  408. package/src/transformers/features/misc/MiscIsCloneTransformer.ts +13 -13
  409. package/src/transformers/features/misc/MiscIsPruneTransformer.ts +13 -13
  410. package/src/transformers/features/misc/MiscLiteralsTransformer.ts +35 -35
  411. package/src/transformers/features/misc/MiscPruneTransformer.ts +13 -13
  412. package/src/transformers/features/misc/MiscValidateCloneTransformer.ts +13 -13
  413. package/src/transformers/features/misc/MiscValidatePruneTransformer.ts +13 -13
  414. package/src/transformers/features/notations/NotationAssertGeneralTransformer.ts +20 -20
  415. package/src/transformers/features/notations/NotationCreateAssertGeneralTransformer.ts +20 -20
  416. package/src/transformers/features/notations/NotationCreateGeneralTransformer.ts +20 -20
  417. package/src/transformers/features/notations/NotationCreateIsGeneralTransformer.ts +20 -20
  418. package/src/transformers/features/notations/NotationCreateValidateGeneralTransformer.ts +20 -20
  419. package/src/transformers/features/notations/NotationGeneralTransformer.ts +18 -18
  420. package/src/transformers/features/notations/NotationIsGeneralTransformer.ts +20 -20
  421. package/src/transformers/features/notations/NotationValidateGeneralTransformer.ts +20 -20
  422. package/src/transformers/features/protobuf/ProtobufAssertDecodeTransformer.ts +13 -13
  423. package/src/transformers/features/protobuf/ProtobufAssertEncodeTransformer.ts +13 -13
  424. package/src/transformers/features/protobuf/ProtobufCreateAssertDecodeTransformer.ts +13 -13
  425. package/src/transformers/features/protobuf/ProtobufCreateAssertEncodeTransformer.ts +13 -13
  426. package/src/transformers/features/protobuf/ProtobufCreateDecodeTransformer.ts +13 -13
  427. package/src/transformers/features/protobuf/ProtobufCreateEncodeTransformer.ts +13 -13
  428. package/src/transformers/features/protobuf/ProtobufCreateIsDecodeTransformer.ts +13 -13
  429. package/src/transformers/features/protobuf/ProtobufCreateIsEncodeTransformer.ts +13 -13
  430. package/src/transformers/features/protobuf/ProtobufCreateValidateDecodeTransformer.ts +13 -13
  431. package/src/transformers/features/protobuf/ProtobufCreateValidateEncodeTransformer.ts +13 -13
  432. package/src/transformers/features/protobuf/ProtobufDecodeTransformer.ts +13 -13
  433. package/src/transformers/features/protobuf/ProtobufEncodeTransformer.ts +13 -13
  434. package/src/transformers/features/protobuf/ProtobufIsDecodeTransformer.ts +13 -13
  435. package/src/transformers/features/protobuf/ProtobufIsEncodeTransformer.ts +13 -13
  436. package/src/transformers/features/protobuf/ProtobufMessageTransformer.ts +35 -35
  437. package/src/transformers/features/protobuf/ProtobufValidateDecodeTransformer.ts +13 -13
  438. package/src/transformers/features/protobuf/ProtobufValidateEncodeTransformer.ts +13 -13
  439. package/src/transformers/features/reflect/ReflectMetadataTransformer.ts +69 -69
  440. package/src/transformers/features/reflect/ReflectNameTransformer.ts +82 -82
  441. package/src/transformers/internal/GenericTransformer.ts +101 -101
  442. package/src/utils/MapUtil.ts +14 -14
  443. package/src/utils/NamingConvention.ts +94 -94
  444. package/src/utils/ProtobufNameEncoder.ts +32 -32
  445. package/src/utils/StringUtil.ts +16 -16
@@ -1,1124 +1,1124 @@
1
- import ts from "typescript";
2
-
3
- import { ExpressionFactory } from "../../factories/ExpressionFactory";
4
- import { IdentifierFactory } from "../../factories/IdentifierFactory";
5
- import { JsonMetadataFactory } from "../../factories/JsonMetadataFactory";
6
- import { MetadataCollection } from "../../factories/MetadataCollection";
7
- import { StatementFactory } from "../../factories/StatementFactory";
8
- import { TypeFactory } from "../../factories/TypeFactory";
9
- import { ValueFactory } from "../../factories/ValueFactory";
10
-
11
- import { Metadata } from "../../schemas/metadata/Metadata";
12
- import { MetadataArray } from "../../schemas/metadata/MetadataArray";
13
- import { MetadataAtomic } from "../../schemas/metadata/MetadataAtomic";
14
- import { MetadataObjectType } from "../../schemas/metadata/MetadataObjectType";
15
- import { MetadataTuple } from "../../schemas/metadata/MetadataTuple";
16
- import { MetadataTupleType } from "../../schemas/metadata/MetadataTupleType";
17
-
18
- import { IProgrammerProps } from "../../transformers/IProgrammerProps";
19
- import { ITypiaContext } from "../../transformers/ITypiaContext";
20
-
21
- import { Atomic } from "../../typings/Atomic";
22
-
23
- import { FeatureProgrammer } from "../FeatureProgrammer";
24
- import { IsProgrammer } from "../IsProgrammer";
25
- import { AtomicPredicator } from "../helpers/AtomicPredicator";
26
- import { FunctionProgrammer } from "../helpers/FunctionProgrammer";
27
- import { OptionPredicator } from "../helpers/OptionPredicator";
28
- import { StringifyJoiner } from "../helpers/StringifyJoinder";
29
- import { StringifyPredicator } from "../helpers/StringifyPredicator";
30
- import { UnionExplorer } from "../helpers/UnionExplorer";
31
- import { check_native } from "../internal/check_native";
32
- import { decode_union_object } from "../internal/decode_union_object";
33
- import { postfix_of_tuple } from "../internal/postfix_of_tuple";
34
- import { wrap_metadata_rest_tuple } from "../internal/wrap_metadata_rest_tuple";
35
-
36
- export namespace JsonStringifyProgrammer {
37
- /* -----------------------------------------------------------
38
- WRITER
39
- ----------------------------------------------------------- */
40
- export const decompose = (props: {
41
- validated: boolean;
42
- context: ITypiaContext;
43
- functor: FunctionProgrammer;
44
- type: ts.Type;
45
- name: string | undefined;
46
- }): FeatureProgrammer.IDecomposed => {
47
- const config: FeatureProgrammer.IConfig = configure(props);
48
- if (props.validated === false)
49
- config.addition = (collection) =>
50
- IsProgrammer.write_function_statements({
51
- context: props.context,
52
- functor: props.functor,
53
- collection,
54
- });
55
- const composed: FeatureProgrammer.IComposed = FeatureProgrammer.compose({
56
- ...props,
57
- config,
58
- });
59
- return {
60
- functions: composed.functions,
61
- statements: composed.statements,
62
- arrow: ts.factory.createArrowFunction(
63
- undefined,
64
- undefined,
65
- composed.parameters,
66
- composed.response,
67
- undefined,
68
- composed.body,
69
- ),
70
- };
71
- };
72
-
73
- export const write = (props: IProgrammerProps): ts.CallExpression => {
74
- const functor: FunctionProgrammer = new FunctionProgrammer(
75
- props.modulo.getText(),
76
- );
77
- const result: FeatureProgrammer.IDecomposed = decompose({
78
- ...props,
79
- validated: false,
80
- functor,
81
- });
82
- return FeatureProgrammer.writeDecomposed({
83
- modulo: props.modulo,
84
- functor,
85
- result,
86
- });
87
- };
88
-
89
- const write_array_functions = (props: {
90
- config: FeatureProgrammer.IConfig;
91
- functor: FunctionProgrammer;
92
- collection: MetadataCollection;
93
- }): ts.VariableStatement[] =>
94
- props.collection
95
- .arrays()
96
- .filter((a) => a.recursive)
97
- .map((type, i) =>
98
- StatementFactory.constant({
99
- name: `${props.config.prefix}a${i}`,
100
- value: ts.factory.createArrowFunction(
101
- undefined,
102
- undefined,
103
- FeatureProgrammer.parameterDeclarations({
104
- config: props.config,
105
- type: TypeFactory.keyword("any"),
106
- input: ts.factory.createIdentifier("input"),
107
- }),
108
- TypeFactory.keyword("any"),
109
- undefined,
110
- decode_array_inline({
111
- config: props.config,
112
- functor: props.functor,
113
- input: ts.factory.createIdentifier("input"),
114
- array: MetadataArray.create({
115
- type,
116
- tags: [],
117
- }),
118
- explore: {
119
- tracable: props.config.trace,
120
- source: "function",
121
- from: "array",
122
- postfix: "",
123
- },
124
- }),
125
- ),
126
- }),
127
- );
128
-
129
- const write_tuple_functions = (props: {
130
- context: ITypiaContext;
131
- config: FeatureProgrammer.IConfig;
132
- functor: FunctionProgrammer;
133
- collection: MetadataCollection;
134
- }): ts.VariableStatement[] =>
135
- props.collection
136
- .tuples()
137
- .filter((t) => t.recursive)
138
- .map((tuple, i) =>
139
- StatementFactory.constant({
140
- name: `${props.config.prefix}t${i}`,
141
- value: ts.factory.createArrowFunction(
142
- undefined,
143
- undefined,
144
- FeatureProgrammer.parameterDeclarations({
145
- config: props.config,
146
- type: TypeFactory.keyword("any"),
147
- input: ts.factory.createIdentifier("input"),
148
- }),
149
- TypeFactory.keyword("any"),
150
- undefined,
151
- decode_tuple_inline({
152
- context: props.context,
153
- config: props.config,
154
- functor: props.functor,
155
- input: ts.factory.createIdentifier("input"),
156
- tuple,
157
- explore: {
158
- tracable: props.config.trace,
159
- source: "function",
160
- from: "array",
161
- postfix: "",
162
- },
163
- }),
164
- ),
165
- }),
166
- );
167
-
168
- /* -----------------------------------------------------------
169
- DECODERS
170
- ----------------------------------------------------------- */
171
- const decode = (props: {
172
- context: ITypiaContext;
173
- config: FeatureProgrammer.IConfig;
174
- functor: FunctionProgrammer;
175
- input: ts.Expression;
176
- metadata: Metadata;
177
- explore: FeatureProgrammer.IExplore;
178
- }): ts.Expression => {
179
- // ANY TYPE
180
- if (props.metadata.any === true)
181
- return wrap_required({
182
- input: props.input,
183
- metadata: props.metadata,
184
- explore: props.explore,
185
- expression: wrap_functional({
186
- input: props.input,
187
- metadata: props.metadata,
188
- explore: props.explore,
189
- expression: ts.factory.createCallExpression(
190
- ts.factory.createIdentifier("JSON.stringify"),
191
- undefined,
192
- [props.input],
193
- ),
194
- }),
195
- });
196
-
197
- // ONLY NULL OR UNDEFINED
198
- const size: number = props.metadata.size();
199
- if (
200
- size === 0 &&
201
- (props.metadata.isRequired() === false ||
202
- props.metadata.nullable === true)
203
- ) {
204
- if (
205
- props.metadata.isRequired() === false &&
206
- props.metadata.nullable === true
207
- )
208
- return props.explore.from === "array"
209
- ? ts.factory.createStringLiteral("null")
210
- : ts.factory.createConditionalExpression(
211
- ts.factory.createStrictEquality(
212
- ts.factory.createNull(),
213
- props.input,
214
- ),
215
- undefined,
216
- ts.factory.createStringLiteral("null"),
217
- undefined,
218
- ts.factory.createIdentifier("undefined"),
219
- );
220
- else if (props.metadata.isRequired() === false)
221
- return props.explore.from === "array"
222
- ? ts.factory.createStringLiteral("null")
223
- : ts.factory.createIdentifier("undefined");
224
- else return ts.factory.createStringLiteral("null");
225
- }
226
-
227
- //----
228
- // LIST UP UNION TYPES
229
- //----
230
- const unions: IUnion[] = [];
231
-
232
- // toJSON() METHOD
233
- if (props.metadata.escaped !== null)
234
- unions.push({
235
- type: "resolved",
236
- is:
237
- props.metadata.escaped.original.size() === 1 &&
238
- props.metadata.escaped.original.natives[0]?.name === "Date"
239
- ? () =>
240
- check_native({
241
- name: "Date",
242
- input: props.input,
243
- })
244
- : () =>
245
- IsProgrammer.decode_to_json({
246
- checkNull: false,
247
- input: props.input,
248
- }),
249
- value: () =>
250
- decode_to_json({
251
- ...props,
252
- metadata: props.metadata.escaped!.returns,
253
- }),
254
- });
255
- else if (props.metadata.functions.length)
256
- unions.push({
257
- type: "functional",
258
- is: () => IsProgrammer.decode_functional(props.input),
259
- value: () => decode_functional(props.explore),
260
- });
261
-
262
- // TEMPLATES
263
- if (props.metadata.templates.length)
264
- if (AtomicPredicator.template(props.metadata)) {
265
- const partial = Metadata.initialize();
266
- partial.atomics.push(
267
- MetadataAtomic.create({ type: "string", tags: [] }),
268
- ),
269
- unions.push({
270
- type: "template literal",
271
- is: () =>
272
- IsProgrammer.decode({
273
- ...props,
274
- metadata: partial,
275
- }),
276
- value: () =>
277
- decode_atomic({
278
- ...props,
279
- type: "string",
280
- }),
281
- });
282
- }
283
-
284
- // CONSTANTS
285
- for (const constant of props.metadata.constants)
286
- if (
287
- AtomicPredicator.constant({
288
- metadata: props.metadata,
289
- name: constant.type,
290
- }) === false
291
- )
292
- continue;
293
- else if (constant.type !== "string")
294
- unions.push({
295
- type: "atomic",
296
- is: () =>
297
- IsProgrammer.decode({
298
- ...props,
299
- metadata: (() => {
300
- const partial = Metadata.initialize();
301
- partial.atomics.push(
302
- MetadataAtomic.create({
303
- type: constant.type,
304
- tags: [],
305
- }),
306
- );
307
- return partial;
308
- })(),
309
- }),
310
- value: () =>
311
- decode_atomic({
312
- ...props,
313
- type: constant.type,
314
- }),
315
- });
316
- else if (props.metadata.templates.length === 0)
317
- unions.push({
318
- type: "const string",
319
- is: () =>
320
- IsProgrammer.decode({
321
- ...props,
322
- metadata: (() => {
323
- const partial = Metadata.initialize();
324
- partial.atomics.push(
325
- MetadataAtomic.create({
326
- type: "string",
327
- tags: [],
328
- }),
329
- );
330
- return partial;
331
- })(),
332
- }),
333
- value: () =>
334
- decode_constant_string({
335
- ...props,
336
- values: [...constant.values.map((v) => v.value)] as string[],
337
- }),
338
- });
339
-
340
- /// ATOMICS
341
- for (const a of props.metadata.atomics)
342
- if (
343
- AtomicPredicator.atomic({
344
- metadata: props.metadata,
345
- name: a.type,
346
- })
347
- )
348
- unions.push({
349
- type: "atomic",
350
- is: () =>
351
- IsProgrammer.decode({
352
- ...props,
353
- metadata: (() => {
354
- const partial = Metadata.initialize();
355
- partial.atomics.push(a);
356
- return partial;
357
- })(),
358
- }),
359
- value: () =>
360
- decode_atomic({
361
- ...props,
362
- type: a.type,
363
- }),
364
- });
365
-
366
- // TUPLES
367
- for (const tuple of props.metadata.tuples)
368
- unions.push({
369
- type: "tuple",
370
- is: () =>
371
- IsProgrammer.decode({
372
- ...props,
373
- metadata: (() => {
374
- const partial = Metadata.initialize();
375
- partial.tuples.push(tuple);
376
- return partial;
377
- })(),
378
- }),
379
- value: () =>
380
- decode_tuple({
381
- ...props,
382
- tuple,
383
- }),
384
- });
385
-
386
- // ARRAYS
387
- if (props.metadata.arrays.length) {
388
- const value: () => ts.Expression =
389
- props.metadata.arrays.length === 1
390
- ? () =>
391
- decode_array({
392
- ...props,
393
- array: props.metadata.arrays[0]!,
394
- explore: {
395
- ...props.explore,
396
- from: "array",
397
- },
398
- })
399
- : props.metadata.arrays.some((elem) => elem.type.value.any)
400
- ? () =>
401
- ts.factory.createCallExpression(
402
- ts.factory.createIdentifier("JSON.stringify"),
403
- undefined,
404
- [props.input],
405
- )
406
- : () =>
407
- explore_arrays({
408
- ...props,
409
- arrays: props.metadata.arrays,
410
- explore: {
411
- ...props.explore,
412
- from: "array",
413
- },
414
- });
415
-
416
- unions.push({
417
- type: "array",
418
- is: () => ExpressionFactory.isArray(props.input),
419
- value,
420
- });
421
- }
422
-
423
- // BUILT-IN CLASSES
424
- if (props.metadata.natives.length)
425
- for (const native of props.metadata.natives)
426
- unions.push({
427
- type: "object",
428
- is: () =>
429
- check_native({
430
- name: native.name,
431
- input: props.input,
432
- }),
433
- value: () =>
434
- AtomicPredicator.native(native.name)
435
- ? decode_atomic({
436
- ...props,
437
- type: native.name.toLowerCase() as Atomic.Literal,
438
- })
439
- : ts.factory.createStringLiteral("{}"),
440
- });
441
-
442
- // SETS
443
- if (props.metadata.sets.length)
444
- unions.push({
445
- type: "object",
446
- is: () => ExpressionFactory.isInstanceOf("Set", props.input),
447
- value: () => ts.factory.createStringLiteral("{}"),
448
- });
449
-
450
- // MAPS
451
- if (props.metadata.maps.length)
452
- unions.push({
453
- type: "object",
454
- is: () => ExpressionFactory.isInstanceOf("Map", props.input),
455
- value: () => ts.factory.createStringLiteral("{}"),
456
- });
457
-
458
- // OBJECTS
459
- if (props.metadata.objects.length)
460
- unions.push({
461
- type: "object",
462
- is: () =>
463
- ExpressionFactory.isObject({
464
- checkNull: true,
465
- checkArray: props.metadata.objects.some((object) =>
466
- object.type.properties.every(
467
- (prop) => !prop.key.isSoleLiteral() || !prop.value.isRequired(),
468
- ),
469
- ),
470
- input: props.input,
471
- }),
472
- value: () =>
473
- explore_objects({
474
- ...props,
475
- explore: {
476
- ...props.explore,
477
- from: "object",
478
- },
479
- }),
480
- });
481
-
482
- //----
483
- // RETURNS
484
- //----
485
- // CHECK NULL AND UNDEFINED
486
- const wrapper = (output: ts.Expression) =>
487
- wrap_required({
488
- input: props.input,
489
- metadata: props.metadata,
490
- explore: props.explore,
491
- expression: wrap_nullable({
492
- input: props.input,
493
- metadata: props.metadata,
494
- expression: output,
495
- }),
496
- });
497
-
498
- // DIRECT RETURN
499
- if (unions.length === 0)
500
- return ts.factory.createCallExpression(
501
- ts.factory.createIdentifier("JSON.stringify"),
502
- undefined,
503
- [props.input],
504
- );
505
- else if (unions.length === 1) return wrapper(unions[0]!.value());
506
-
507
- // RETURN WITH TYPE CHECKING
508
- return wrapper(
509
- ts.factory.createCallExpression(
510
- ts.factory.createArrowFunction(
511
- undefined,
512
- undefined,
513
- [],
514
- undefined,
515
- undefined,
516
- iterate({
517
- context: props.context,
518
- functor: props.functor,
519
- input: props.input,
520
- expected: props.metadata.getName(),
521
- unions,
522
- }),
523
- ),
524
- undefined,
525
- undefined,
526
- ),
527
- );
528
- };
529
-
530
- const decode_object = (props: {
531
- functor: FunctionProgrammer;
532
- input: ts.Expression;
533
- object: MetadataObjectType;
534
- explore: FeatureProgrammer.IExplore;
535
- }): ts.CallExpression =>
536
- FeatureProgrammer.decode_object({
537
- config: {
538
- trace: false,
539
- path: false,
540
- prefix: PREFIX,
541
- },
542
- functor: props.functor,
543
- object: props.object,
544
- input: props.input,
545
- explore: props.explore,
546
- });
547
-
548
- const decode_array = (props: {
549
- config: FeatureProgrammer.IConfig;
550
- functor: FunctionProgrammer;
551
- input: ts.Expression;
552
- array: MetadataArray;
553
- explore: FeatureProgrammer.IExplore;
554
- }) =>
555
- props.array.type.recursive
556
- ? ts.factory.createCallExpression(
557
- ts.factory.createIdentifier(
558
- props.functor.useLocal(
559
- `${props.config.prefix}a${props.array.type.index}`,
560
- ),
561
- ),
562
- undefined,
563
- FeatureProgrammer.argumentsArray({
564
- config: props.config,
565
- input: props.input,
566
- explore: {
567
- ...props.explore,
568
- source: "function",
569
- from: "array",
570
- },
571
- }),
572
- )
573
- : decode_array_inline(props);
574
-
575
- const decode_array_inline = (props: {
576
- config: FeatureProgrammer.IConfig;
577
- functor: FunctionProgrammer;
578
- input: ts.Expression;
579
- array: MetadataArray;
580
- explore: FeatureProgrammer.IExplore;
581
- }) =>
582
- FeatureProgrammer.decode_array({
583
- config: props.config,
584
- functor: props.functor,
585
- combiner: StringifyJoiner.array,
586
- array: props.array,
587
- input: props.input,
588
- explore: props.explore,
589
- });
590
-
591
- const decode_tuple = (props: {
592
- context: ITypiaContext;
593
- config: FeatureProgrammer.IConfig;
594
- functor: FunctionProgrammer;
595
- input: ts.Expression;
596
- tuple: MetadataTuple;
597
- explore: FeatureProgrammer.IExplore;
598
- }): ts.Expression =>
599
- props.tuple.type.recursive
600
- ? ts.factory.createCallExpression(
601
- ts.factory.createIdentifier(
602
- props.functor.useLocal(
603
- `${props.config.prefix}t${props.tuple.type.index}`,
604
- ),
605
- ),
606
- undefined,
607
- FeatureProgrammer.argumentsArray({
608
- config: props.config,
609
- explore: {
610
- ...props.explore,
611
- source: "function",
612
- },
613
- input: props.input,
614
- }),
615
- )
616
- : decode_tuple_inline({
617
- ...props,
618
- tuple: props.tuple.type,
619
- });
620
-
621
- const decode_tuple_inline = (props: {
622
- context: ITypiaContext;
623
- config: FeatureProgrammer.IConfig;
624
- functor: FunctionProgrammer;
625
- input: ts.Expression;
626
- tuple: MetadataTupleType;
627
- explore: FeatureProgrammer.IExplore;
628
- }): ts.Expression => {
629
- const elements: ts.Expression[] = props.tuple.elements
630
- .filter((elem) => elem.rest === null)
631
- .map((elem, index) =>
632
- decode({
633
- ...props,
634
- input: ts.factory.createElementAccessExpression(props.input, index),
635
- metadata: elem,
636
- explore: {
637
- ...props.explore,
638
- from: "array",
639
- postfix: props.explore.postfix.length
640
- ? `${postfix_of_tuple(props.explore.postfix)}[${index}]"`
641
- : `"[${index}]"`,
642
- },
643
- }),
644
- );
645
- const rest = (() => {
646
- if (props.tuple.elements.length === 0) return null;
647
- const last = props.tuple.elements.at(-1)!;
648
- if (last.rest === null) return null;
649
-
650
- const code = decode({
651
- ...props,
652
- input: ts.factory.createCallExpression(
653
- IdentifierFactory.access(props.input, "slice"),
654
- undefined,
655
- [ExpressionFactory.number(props.tuple.elements.length - 1)],
656
- ),
657
- metadata: wrap_metadata_rest_tuple(props.tuple.elements.at(-1)!.rest!),
658
- explore: {
659
- ...props.explore,
660
- start: props.tuple.elements.length - 1,
661
- },
662
- });
663
- return ts.factory.createCallExpression(
664
- props.context.importer.internal("jsonStringifyRest"),
665
- undefined,
666
- [code],
667
- );
668
- })();
669
- return StringifyJoiner.tuple({
670
- elements,
671
- rest,
672
- });
673
- };
674
-
675
- const decode_atomic = (props: {
676
- context: ITypiaContext;
677
- input: ts.Expression;
678
- type: string;
679
- explore: FeatureProgrammer.IExplore;
680
- }): ts.Expression => {
681
- if (props.type === "string")
682
- return ts.factory.createCallExpression(
683
- props.context.importer.internal("jsonStringifyString"),
684
- undefined,
685
- [props.input],
686
- );
687
- else if (
688
- props.type === "number" &&
689
- OptionPredicator.numeric(props.context.options)
690
- )
691
- props = {
692
- ...props,
693
- input: ts.factory.createCallExpression(
694
- props.context.importer.internal("jsonStringifyNumber"),
695
- undefined,
696
- [props.input],
697
- ),
698
- };
699
-
700
- return props.explore.from !== "top"
701
- ? props.input
702
- : ts.factory.createCallExpression(
703
- IdentifierFactory.access(props.input, "toString"),
704
- undefined,
705
- undefined,
706
- );
707
- };
708
-
709
- const decode_constant_string = (props: {
710
- context: ITypiaContext;
711
- functor: FunctionProgrammer;
712
- input: ts.Expression;
713
- values: string[];
714
- explore: FeatureProgrammer.IExplore;
715
- }): ts.Expression => {
716
- if (props.values.every((v) => !StringifyPredicator.require_escape(v)))
717
- return [
718
- ts.factory.createStringLiteral('"'),
719
- props.input,
720
- ts.factory.createStringLiteral('"'),
721
- ].reduce((x, y) => ts.factory.createAdd(x, y));
722
- return decode_atomic({
723
- ...props,
724
- type: "string",
725
- });
726
- };
727
-
728
- const decode_to_json = (props: {
729
- context: ITypiaContext;
730
- config: FeatureProgrammer.IConfig;
731
- functor: FunctionProgrammer;
732
- input: ts.Expression;
733
- metadata: Metadata;
734
- explore: FeatureProgrammer.IExplore;
735
- }): ts.Expression => {
736
- return decode({
737
- ...props,
738
- input: ts.factory.createCallExpression(
739
- IdentifierFactory.access(props.input, "toJSON"),
740
- undefined,
741
- [],
742
- ),
743
- });
744
- };
745
-
746
- const decode_functional = (explore: FeatureProgrammer.IExplore) =>
747
- explore.from === "array"
748
- ? ts.factory.createStringLiteral("null")
749
- : ts.factory.createIdentifier("undefined");
750
-
751
- /* -----------------------------------------------------------
752
- EXPLORERS
753
- ----------------------------------------------------------- */
754
- const explore_objects = (props: {
755
- config: FeatureProgrammer.IConfig;
756
- functor: FunctionProgrammer;
757
- input: ts.Expression;
758
- metadata: Metadata;
759
- explore: FeatureProgrammer.IExplore;
760
- }) =>
761
- props.metadata.objects.length === 1
762
- ? decode_object({
763
- functor: props.functor,
764
- input: props.input,
765
- object: props.metadata.objects[0]!.type,
766
- explore: props.explore,
767
- })
768
- : ts.factory.createCallExpression(
769
- ts.factory.createIdentifier(
770
- props.functor.useLocal(`${PREFIX}u${props.metadata.union_index!}`),
771
- ),
772
- undefined,
773
- FeatureProgrammer.argumentsArray(props),
774
- );
775
-
776
- const explore_arrays = (props: {
777
- context: ITypiaContext;
778
- config: FeatureProgrammer.IConfig;
779
- functor: FunctionProgrammer;
780
- input: ts.Expression;
781
- arrays: MetadataArray[];
782
- explore: FeatureProgrammer.IExplore;
783
- }): ts.Expression =>
784
- explore_array_like_union_types({
785
- ...props,
786
- elements: props.arrays,
787
- factory: (next) =>
788
- UnionExplorer.array({
789
- config: {
790
- checker: (v) =>
791
- IsProgrammer.decode({
792
- context: props.context,
793
- functor: props.functor,
794
- metadata: v.definition,
795
- input: v.input,
796
- explore: v.explore,
797
- }),
798
- decoder: (v) =>
799
- decode_array({
800
- config: props.config,
801
- functor: props.functor,
802
- input: v.input,
803
- array: v.definition,
804
- explore: v.explore,
805
- }),
806
- empty: ts.factory.createStringLiteral("[]"),
807
- success: ts.factory.createTrue(),
808
- failure: (v) =>
809
- create_throw_error({
810
- context: props.context,
811
- functor: props.functor,
812
- expected: v.expected,
813
- input: v.input,
814
- }),
815
- },
816
- parameters: next.parameters,
817
- input: next.input,
818
- arrays: next.definitions,
819
- explore: next.explore,
820
- }),
821
- //(next.parameters)(next.input, next.elements, next.explore),
822
- });
823
-
824
- const explore_array_like_union_types = <
825
- T extends MetadataArray | MetadataTuple,
826
- >(props: {
827
- config: FeatureProgrammer.IConfig;
828
- functor: FunctionProgrammer;
829
- factory: (next: {
830
- parameters: ts.ParameterDeclaration[];
831
- input: ts.Expression;
832
- definitions: T[];
833
- explore: FeatureProgrammer.IExplore;
834
- }) => ts.ArrowFunction;
835
- input: ts.Expression;
836
- elements: T[];
837
- explore: FeatureProgrammer.IExplore;
838
- }): ts.Expression => {
839
- const arrow = (next: {
840
- parameters: ts.ParameterDeclaration[];
841
- explore: FeatureProgrammer.IExplore;
842
- input: ts.Expression;
843
- }): ts.ArrowFunction =>
844
- props.factory({
845
- definitions: props.elements,
846
- parameters: next.parameters,
847
- input: next.input,
848
- explore: next.explore,
849
- });
850
- if (props.elements.every((e) => e.type.recursive === false))
851
- ts.factory.createCallExpression(
852
- arrow({
853
- parameters: [],
854
- explore: props.explore,
855
- input: props.input,
856
- }),
857
- undefined,
858
- [],
859
- );
860
-
861
- const arrayExplore: FeatureProgrammer.IExplore = {
862
- ...props.explore,
863
- source: "function",
864
- from: "array",
865
- };
866
- return ts.factory.createCallExpression(
867
- ts.factory.createIdentifier(
868
- props.functor.emplaceUnion(
869
- props.config.prefix,
870
- props.elements.map((e) => e.type.name).join(" | "),
871
- () =>
872
- arrow({
873
- parameters: FeatureProgrammer.parameterDeclarations({
874
- config: props.config,
875
- type: TypeFactory.keyword("any"),
876
- input: ts.factory.createIdentifier("input"),
877
- }),
878
- explore: {
879
- ...arrayExplore,
880
- postfix: "",
881
- },
882
- input: ts.factory.createIdentifier("input"),
883
- }),
884
- ),
885
- ),
886
- undefined,
887
- FeatureProgrammer.argumentsArray({
888
- config: props.config,
889
- explore: arrayExplore,
890
- input: props.input,
891
- }),
892
- );
893
- };
894
-
895
- /* -----------------------------------------------------------
896
- RETURN SCRIPTS
897
- ----------------------------------------------------------- */
898
- const wrap_required = (props: {
899
- input: ts.Expression;
900
- metadata: Metadata;
901
- explore: FeatureProgrammer.IExplore;
902
- expression: ts.Expression;
903
- }): ts.Expression => {
904
- if (props.metadata.isRequired() === true && props.metadata.any === false)
905
- return props.expression;
906
- return ts.factory.createConditionalExpression(
907
- ts.factory.createStrictInequality(
908
- ts.factory.createIdentifier("undefined"),
909
- props.input,
910
- ),
911
- undefined,
912
- props.expression,
913
- undefined,
914
- props.explore.from === "array"
915
- ? ts.factory.createStringLiteral("null")
916
- : ts.factory.createIdentifier("undefined"),
917
- );
918
- };
919
-
920
- const wrap_nullable = (props: {
921
- input: ts.Expression;
922
- metadata: Metadata;
923
- expression: ts.Expression;
924
- }): ts.Expression => {
925
- if (props.metadata.nullable === false) return props.expression;
926
- return ts.factory.createConditionalExpression(
927
- ts.factory.createStrictInequality(ts.factory.createNull(), props.input),
928
- undefined,
929
- props.expression,
930
- undefined,
931
- ts.factory.createStringLiteral("null"),
932
- );
933
- };
934
-
935
- const wrap_functional = (props: {
936
- input: ts.Expression;
937
- metadata: Metadata;
938
- explore: FeatureProgrammer.IExplore;
939
- expression: ts.Expression;
940
- }): ts.Expression => {
941
- if (props.metadata.functions.length === 0) return props.expression;
942
- return ts.factory.createConditionalExpression(
943
- ts.factory.createStrictInequality(
944
- ts.factory.createStringLiteral("function"),
945
- ValueFactory.TYPEOF(props.input),
946
- ),
947
- undefined,
948
- props.expression,
949
- undefined,
950
- decode_functional(props.explore),
951
- );
952
- };
953
-
954
- const iterate = (props: {
955
- context: ITypiaContext;
956
- functor: FunctionProgrammer;
957
- input: ts.Expression;
958
- unions: IUnion[];
959
- expected: string;
960
- }) =>
961
- ts.factory.createBlock(
962
- [
963
- ...props.unions.map((u) =>
964
- ts.factory.createIfStatement(
965
- u.is(),
966
- ts.factory.createReturnStatement(u.value()),
967
- ),
968
- ),
969
- create_throw_error(props),
970
- ],
971
- true,
972
- );
973
-
974
- /* -----------------------------------------------------------
975
- CONFIGURATIONS
976
- ----------------------------------------------------------- */
977
- const PREFIX = "_s";
978
-
979
- const configure = (props: {
980
- context: ITypiaContext;
981
- functor: FunctionProgrammer;
982
- }): FeatureProgrammer.IConfig => {
983
- const config: FeatureProgrammer.IConfig<ts.Expression> = {
984
- types: {
985
- input: (type, name) =>
986
- ts.factory.createTypeReferenceNode(
987
- name ??
988
- TypeFactory.getFullName({ checker: props.context.checker, type }),
989
- ),
990
- output: () => TypeFactory.keyword("string"),
991
- },
992
- prefix: PREFIX,
993
- trace: false,
994
- path: false,
995
- initializer,
996
- decoder: (next) =>
997
- decode({
998
- context: props.context,
999
- functor: props.functor,
1000
- config,
1001
- metadata: next.metadata,
1002
- input: next.input,
1003
- explore: next.explore,
1004
- }),
1005
- objector: {
1006
- checker: (next) =>
1007
- IsProgrammer.decode({
1008
- context: props.context,
1009
- functor: props.functor,
1010
- metadata: next.metadata,
1011
- input: next.input,
1012
- explore: next.explore,
1013
- }),
1014
- decoder: (next) =>
1015
- decode_object({
1016
- functor: props.functor,
1017
- input: next.input,
1018
- object: next.object,
1019
- explore: next.explore,
1020
- }),
1021
- joiner: (next) =>
1022
- StringifyJoiner.object({
1023
- ...next,
1024
- context: props.context,
1025
- }),
1026
- unionizer: (next) =>
1027
- decode_union_object({
1028
- checker: (v) =>
1029
- IsProgrammer.decode_object({
1030
- context: props.context,
1031
- functor: props.functor,
1032
- input: v.input,
1033
- object: v.object,
1034
- explore: v.explore,
1035
- }),
1036
- decoder: (v) =>
1037
- decode_object({
1038
- functor: props.functor,
1039
- input: v.input,
1040
- object: v.object,
1041
- explore: v.explore,
1042
- }),
1043
- success: (exp) => exp,
1044
- escaper: (v) =>
1045
- create_throw_error({
1046
- context: props.context,
1047
- functor: props.functor,
1048
- expected: v.expected,
1049
- input: v.input,
1050
- }),
1051
- objects: next.objects,
1052
- explore: next.explore,
1053
- input: next.input,
1054
- }),
1055
- failure: (next) =>
1056
- create_throw_error({
1057
- context: props.context,
1058
- functor: props.functor,
1059
- expected: next.expected,
1060
- input: next.input,
1061
- }),
1062
- },
1063
- generator: {
1064
- arrays: (collection) =>
1065
- write_array_functions({
1066
- config,
1067
- functor: props.functor,
1068
- collection,
1069
- }),
1070
- tuples: (collection) =>
1071
- write_tuple_functions({
1072
- config,
1073
- context: props.context,
1074
- functor: props.functor,
1075
- collection,
1076
- }),
1077
- },
1078
- };
1079
- return config;
1080
- };
1081
-
1082
- const initializer: FeatureProgrammer.IConfig["initializer"] = (props) =>
1083
- JsonMetadataFactory.analyze({
1084
- method: props.functor.method,
1085
- checker: props.context.checker,
1086
- transformer: props.context.transformer,
1087
- type: props.type,
1088
- });
1089
-
1090
- const create_throw_error = (props: {
1091
- context: ITypiaContext;
1092
- functor: FunctionProgrammer;
1093
- expected: string;
1094
- input: ts.Expression;
1095
- }) =>
1096
- ts.factory.createExpressionStatement(
1097
- ts.factory.createCallExpression(
1098
- props.context.importer.internal("throwTypeGuardError"),
1099
- [],
1100
- [
1101
- ts.factory.createObjectLiteralExpression(
1102
- [
1103
- ts.factory.createPropertyAssignment(
1104
- "method",
1105
- ts.factory.createStringLiteral(props.functor.method),
1106
- ),
1107
- ts.factory.createPropertyAssignment(
1108
- "expected",
1109
- ts.factory.createStringLiteral(props.expected),
1110
- ),
1111
- ts.factory.createPropertyAssignment("value", props.input),
1112
- ],
1113
- true,
1114
- ),
1115
- ],
1116
- ),
1117
- );
1118
- }
1119
-
1120
- interface IUnion {
1121
- type: string;
1122
- is: () => ts.Expression;
1123
- value: () => ts.Expression;
1124
- }
1
+ import ts from "typescript";
2
+
3
+ import { ExpressionFactory } from "../../factories/ExpressionFactory";
4
+ import { IdentifierFactory } from "../../factories/IdentifierFactory";
5
+ import { JsonMetadataFactory } from "../../factories/JsonMetadataFactory";
6
+ import { MetadataCollection } from "../../factories/MetadataCollection";
7
+ import { StatementFactory } from "../../factories/StatementFactory";
8
+ import { TypeFactory } from "../../factories/TypeFactory";
9
+ import { ValueFactory } from "../../factories/ValueFactory";
10
+
11
+ import { Metadata } from "../../schemas/metadata/Metadata";
12
+ import { MetadataArray } from "../../schemas/metadata/MetadataArray";
13
+ import { MetadataAtomic } from "../../schemas/metadata/MetadataAtomic";
14
+ import { MetadataObjectType } from "../../schemas/metadata/MetadataObjectType";
15
+ import { MetadataTuple } from "../../schemas/metadata/MetadataTuple";
16
+ import { MetadataTupleType } from "../../schemas/metadata/MetadataTupleType";
17
+
18
+ import { IProgrammerProps } from "../../transformers/IProgrammerProps";
19
+ import { ITypiaContext } from "../../transformers/ITypiaContext";
20
+
21
+ import { Atomic } from "../../typings/Atomic";
22
+
23
+ import { FeatureProgrammer } from "../FeatureProgrammer";
24
+ import { IsProgrammer } from "../IsProgrammer";
25
+ import { AtomicPredicator } from "../helpers/AtomicPredicator";
26
+ import { FunctionProgrammer } from "../helpers/FunctionProgrammer";
27
+ import { OptionPredicator } from "../helpers/OptionPredicator";
28
+ import { StringifyJoiner } from "../helpers/StringifyJoinder";
29
+ import { StringifyPredicator } from "../helpers/StringifyPredicator";
30
+ import { UnionExplorer } from "../helpers/UnionExplorer";
31
+ import { check_native } from "../internal/check_native";
32
+ import { decode_union_object } from "../internal/decode_union_object";
33
+ import { postfix_of_tuple } from "../internal/postfix_of_tuple";
34
+ import { wrap_metadata_rest_tuple } from "../internal/wrap_metadata_rest_tuple";
35
+
36
+ export namespace JsonStringifyProgrammer {
37
+ /* -----------------------------------------------------------
38
+ WRITER
39
+ ----------------------------------------------------------- */
40
+ export const decompose = (props: {
41
+ validated: boolean;
42
+ context: ITypiaContext;
43
+ functor: FunctionProgrammer;
44
+ type: ts.Type;
45
+ name: string | undefined;
46
+ }): FeatureProgrammer.IDecomposed => {
47
+ const config: FeatureProgrammer.IConfig = configure(props);
48
+ if (props.validated === false)
49
+ config.addition = (collection) =>
50
+ IsProgrammer.write_function_statements({
51
+ context: props.context,
52
+ functor: props.functor,
53
+ collection,
54
+ });
55
+ const composed: FeatureProgrammer.IComposed = FeatureProgrammer.compose({
56
+ ...props,
57
+ config,
58
+ });
59
+ return {
60
+ functions: composed.functions,
61
+ statements: composed.statements,
62
+ arrow: ts.factory.createArrowFunction(
63
+ undefined,
64
+ undefined,
65
+ composed.parameters,
66
+ composed.response,
67
+ undefined,
68
+ composed.body,
69
+ ),
70
+ };
71
+ };
72
+
73
+ export const write = (props: IProgrammerProps): ts.CallExpression => {
74
+ const functor: FunctionProgrammer = new FunctionProgrammer(
75
+ props.modulo.getText(),
76
+ );
77
+ const result: FeatureProgrammer.IDecomposed = decompose({
78
+ ...props,
79
+ validated: false,
80
+ functor,
81
+ });
82
+ return FeatureProgrammer.writeDecomposed({
83
+ modulo: props.modulo,
84
+ functor,
85
+ result,
86
+ });
87
+ };
88
+
89
+ const write_array_functions = (props: {
90
+ config: FeatureProgrammer.IConfig;
91
+ functor: FunctionProgrammer;
92
+ collection: MetadataCollection;
93
+ }): ts.VariableStatement[] =>
94
+ props.collection
95
+ .arrays()
96
+ .filter((a) => a.recursive)
97
+ .map((type, i) =>
98
+ StatementFactory.constant({
99
+ name: `${props.config.prefix}a${i}`,
100
+ value: ts.factory.createArrowFunction(
101
+ undefined,
102
+ undefined,
103
+ FeatureProgrammer.parameterDeclarations({
104
+ config: props.config,
105
+ type: TypeFactory.keyword("any"),
106
+ input: ts.factory.createIdentifier("input"),
107
+ }),
108
+ TypeFactory.keyword("any"),
109
+ undefined,
110
+ decode_array_inline({
111
+ config: props.config,
112
+ functor: props.functor,
113
+ input: ts.factory.createIdentifier("input"),
114
+ array: MetadataArray.create({
115
+ type,
116
+ tags: [],
117
+ }),
118
+ explore: {
119
+ tracable: props.config.trace,
120
+ source: "function",
121
+ from: "array",
122
+ postfix: "",
123
+ },
124
+ }),
125
+ ),
126
+ }),
127
+ );
128
+
129
+ const write_tuple_functions = (props: {
130
+ context: ITypiaContext;
131
+ config: FeatureProgrammer.IConfig;
132
+ functor: FunctionProgrammer;
133
+ collection: MetadataCollection;
134
+ }): ts.VariableStatement[] =>
135
+ props.collection
136
+ .tuples()
137
+ .filter((t) => t.recursive)
138
+ .map((tuple, i) =>
139
+ StatementFactory.constant({
140
+ name: `${props.config.prefix}t${i}`,
141
+ value: ts.factory.createArrowFunction(
142
+ undefined,
143
+ undefined,
144
+ FeatureProgrammer.parameterDeclarations({
145
+ config: props.config,
146
+ type: TypeFactory.keyword("any"),
147
+ input: ts.factory.createIdentifier("input"),
148
+ }),
149
+ TypeFactory.keyword("any"),
150
+ undefined,
151
+ decode_tuple_inline({
152
+ context: props.context,
153
+ config: props.config,
154
+ functor: props.functor,
155
+ input: ts.factory.createIdentifier("input"),
156
+ tuple,
157
+ explore: {
158
+ tracable: props.config.trace,
159
+ source: "function",
160
+ from: "array",
161
+ postfix: "",
162
+ },
163
+ }),
164
+ ),
165
+ }),
166
+ );
167
+
168
+ /* -----------------------------------------------------------
169
+ DECODERS
170
+ ----------------------------------------------------------- */
171
+ const decode = (props: {
172
+ context: ITypiaContext;
173
+ config: FeatureProgrammer.IConfig;
174
+ functor: FunctionProgrammer;
175
+ input: ts.Expression;
176
+ metadata: Metadata;
177
+ explore: FeatureProgrammer.IExplore;
178
+ }): ts.Expression => {
179
+ // ANY TYPE
180
+ if (props.metadata.any === true)
181
+ return wrap_required({
182
+ input: props.input,
183
+ metadata: props.metadata,
184
+ explore: props.explore,
185
+ expression: wrap_functional({
186
+ input: props.input,
187
+ metadata: props.metadata,
188
+ explore: props.explore,
189
+ expression: ts.factory.createCallExpression(
190
+ ts.factory.createIdentifier("JSON.stringify"),
191
+ undefined,
192
+ [props.input],
193
+ ),
194
+ }),
195
+ });
196
+
197
+ // ONLY NULL OR UNDEFINED
198
+ const size: number = props.metadata.size();
199
+ if (
200
+ size === 0 &&
201
+ (props.metadata.isRequired() === false ||
202
+ props.metadata.nullable === true)
203
+ ) {
204
+ if (
205
+ props.metadata.isRequired() === false &&
206
+ props.metadata.nullable === true
207
+ )
208
+ return props.explore.from === "array"
209
+ ? ts.factory.createStringLiteral("null")
210
+ : ts.factory.createConditionalExpression(
211
+ ts.factory.createStrictEquality(
212
+ ts.factory.createNull(),
213
+ props.input,
214
+ ),
215
+ undefined,
216
+ ts.factory.createStringLiteral("null"),
217
+ undefined,
218
+ ts.factory.createIdentifier("undefined"),
219
+ );
220
+ else if (props.metadata.isRequired() === false)
221
+ return props.explore.from === "array"
222
+ ? ts.factory.createStringLiteral("null")
223
+ : ts.factory.createIdentifier("undefined");
224
+ else return ts.factory.createStringLiteral("null");
225
+ }
226
+
227
+ //----
228
+ // LIST UP UNION TYPES
229
+ //----
230
+ const unions: IUnion[] = [];
231
+
232
+ // toJSON() METHOD
233
+ if (props.metadata.escaped !== null)
234
+ unions.push({
235
+ type: "resolved",
236
+ is:
237
+ props.metadata.escaped.original.size() === 1 &&
238
+ props.metadata.escaped.original.natives[0]?.name === "Date"
239
+ ? () =>
240
+ check_native({
241
+ name: "Date",
242
+ input: props.input,
243
+ })
244
+ : () =>
245
+ IsProgrammer.decode_to_json({
246
+ checkNull: false,
247
+ input: props.input,
248
+ }),
249
+ value: () =>
250
+ decode_to_json({
251
+ ...props,
252
+ metadata: props.metadata.escaped!.returns,
253
+ }),
254
+ });
255
+ else if (props.metadata.functions.length)
256
+ unions.push({
257
+ type: "functional",
258
+ is: () => IsProgrammer.decode_functional(props.input),
259
+ value: () => decode_functional(props.explore),
260
+ });
261
+
262
+ // TEMPLATES
263
+ if (props.metadata.templates.length)
264
+ if (AtomicPredicator.template(props.metadata)) {
265
+ const partial = Metadata.initialize();
266
+ partial.atomics.push(
267
+ MetadataAtomic.create({ type: "string", tags: [] }),
268
+ ),
269
+ unions.push({
270
+ type: "template literal",
271
+ is: () =>
272
+ IsProgrammer.decode({
273
+ ...props,
274
+ metadata: partial,
275
+ }),
276
+ value: () =>
277
+ decode_atomic({
278
+ ...props,
279
+ type: "string",
280
+ }),
281
+ });
282
+ }
283
+
284
+ // CONSTANTS
285
+ for (const constant of props.metadata.constants)
286
+ if (
287
+ AtomicPredicator.constant({
288
+ metadata: props.metadata,
289
+ name: constant.type,
290
+ }) === false
291
+ )
292
+ continue;
293
+ else if (constant.type !== "string")
294
+ unions.push({
295
+ type: "atomic",
296
+ is: () =>
297
+ IsProgrammer.decode({
298
+ ...props,
299
+ metadata: (() => {
300
+ const partial = Metadata.initialize();
301
+ partial.atomics.push(
302
+ MetadataAtomic.create({
303
+ type: constant.type,
304
+ tags: [],
305
+ }),
306
+ );
307
+ return partial;
308
+ })(),
309
+ }),
310
+ value: () =>
311
+ decode_atomic({
312
+ ...props,
313
+ type: constant.type,
314
+ }),
315
+ });
316
+ else if (props.metadata.templates.length === 0)
317
+ unions.push({
318
+ type: "const string",
319
+ is: () =>
320
+ IsProgrammer.decode({
321
+ ...props,
322
+ metadata: (() => {
323
+ const partial = Metadata.initialize();
324
+ partial.atomics.push(
325
+ MetadataAtomic.create({
326
+ type: "string",
327
+ tags: [],
328
+ }),
329
+ );
330
+ return partial;
331
+ })(),
332
+ }),
333
+ value: () =>
334
+ decode_constant_string({
335
+ ...props,
336
+ values: [...constant.values.map((v) => v.value)] as string[],
337
+ }),
338
+ });
339
+
340
+ /// ATOMICS
341
+ for (const a of props.metadata.atomics)
342
+ if (
343
+ AtomicPredicator.atomic({
344
+ metadata: props.metadata,
345
+ name: a.type,
346
+ })
347
+ )
348
+ unions.push({
349
+ type: "atomic",
350
+ is: () =>
351
+ IsProgrammer.decode({
352
+ ...props,
353
+ metadata: (() => {
354
+ const partial = Metadata.initialize();
355
+ partial.atomics.push(a);
356
+ return partial;
357
+ })(),
358
+ }),
359
+ value: () =>
360
+ decode_atomic({
361
+ ...props,
362
+ type: a.type,
363
+ }),
364
+ });
365
+
366
+ // TUPLES
367
+ for (const tuple of props.metadata.tuples)
368
+ unions.push({
369
+ type: "tuple",
370
+ is: () =>
371
+ IsProgrammer.decode({
372
+ ...props,
373
+ metadata: (() => {
374
+ const partial = Metadata.initialize();
375
+ partial.tuples.push(tuple);
376
+ return partial;
377
+ })(),
378
+ }),
379
+ value: () =>
380
+ decode_tuple({
381
+ ...props,
382
+ tuple,
383
+ }),
384
+ });
385
+
386
+ // ARRAYS
387
+ if (props.metadata.arrays.length) {
388
+ const value: () => ts.Expression =
389
+ props.metadata.arrays.length === 1
390
+ ? () =>
391
+ decode_array({
392
+ ...props,
393
+ array: props.metadata.arrays[0]!,
394
+ explore: {
395
+ ...props.explore,
396
+ from: "array",
397
+ },
398
+ })
399
+ : props.metadata.arrays.some((elem) => elem.type.value.any)
400
+ ? () =>
401
+ ts.factory.createCallExpression(
402
+ ts.factory.createIdentifier("JSON.stringify"),
403
+ undefined,
404
+ [props.input],
405
+ )
406
+ : () =>
407
+ explore_arrays({
408
+ ...props,
409
+ arrays: props.metadata.arrays,
410
+ explore: {
411
+ ...props.explore,
412
+ from: "array",
413
+ },
414
+ });
415
+
416
+ unions.push({
417
+ type: "array",
418
+ is: () => ExpressionFactory.isArray(props.input),
419
+ value,
420
+ });
421
+ }
422
+
423
+ // BUILT-IN CLASSES
424
+ if (props.metadata.natives.length)
425
+ for (const native of props.metadata.natives)
426
+ unions.push({
427
+ type: "object",
428
+ is: () =>
429
+ check_native({
430
+ name: native.name,
431
+ input: props.input,
432
+ }),
433
+ value: () =>
434
+ AtomicPredicator.native(native.name)
435
+ ? decode_atomic({
436
+ ...props,
437
+ type: native.name.toLowerCase() as Atomic.Literal,
438
+ })
439
+ : ts.factory.createStringLiteral("{}"),
440
+ });
441
+
442
+ // SETS
443
+ if (props.metadata.sets.length)
444
+ unions.push({
445
+ type: "object",
446
+ is: () => ExpressionFactory.isInstanceOf("Set", props.input),
447
+ value: () => ts.factory.createStringLiteral("{}"),
448
+ });
449
+
450
+ // MAPS
451
+ if (props.metadata.maps.length)
452
+ unions.push({
453
+ type: "object",
454
+ is: () => ExpressionFactory.isInstanceOf("Map", props.input),
455
+ value: () => ts.factory.createStringLiteral("{}"),
456
+ });
457
+
458
+ // OBJECTS
459
+ if (props.metadata.objects.length)
460
+ unions.push({
461
+ type: "object",
462
+ is: () =>
463
+ ExpressionFactory.isObject({
464
+ checkNull: true,
465
+ checkArray: props.metadata.objects.some((object) =>
466
+ object.type.properties.every(
467
+ (prop) => !prop.key.isSoleLiteral() || !prop.value.isRequired(),
468
+ ),
469
+ ),
470
+ input: props.input,
471
+ }),
472
+ value: () =>
473
+ explore_objects({
474
+ ...props,
475
+ explore: {
476
+ ...props.explore,
477
+ from: "object",
478
+ },
479
+ }),
480
+ });
481
+
482
+ //----
483
+ // RETURNS
484
+ //----
485
+ // CHECK NULL AND UNDEFINED
486
+ const wrapper = (output: ts.Expression) =>
487
+ wrap_required({
488
+ input: props.input,
489
+ metadata: props.metadata,
490
+ explore: props.explore,
491
+ expression: wrap_nullable({
492
+ input: props.input,
493
+ metadata: props.metadata,
494
+ expression: output,
495
+ }),
496
+ });
497
+
498
+ // DIRECT RETURN
499
+ if (unions.length === 0)
500
+ return ts.factory.createCallExpression(
501
+ ts.factory.createIdentifier("JSON.stringify"),
502
+ undefined,
503
+ [props.input],
504
+ );
505
+ else if (unions.length === 1) return wrapper(unions[0]!.value());
506
+
507
+ // RETURN WITH TYPE CHECKING
508
+ return wrapper(
509
+ ts.factory.createCallExpression(
510
+ ts.factory.createArrowFunction(
511
+ undefined,
512
+ undefined,
513
+ [],
514
+ undefined,
515
+ undefined,
516
+ iterate({
517
+ context: props.context,
518
+ functor: props.functor,
519
+ input: props.input,
520
+ expected: props.metadata.getName(),
521
+ unions,
522
+ }),
523
+ ),
524
+ undefined,
525
+ undefined,
526
+ ),
527
+ );
528
+ };
529
+
530
+ const decode_object = (props: {
531
+ functor: FunctionProgrammer;
532
+ input: ts.Expression;
533
+ object: MetadataObjectType;
534
+ explore: FeatureProgrammer.IExplore;
535
+ }): ts.CallExpression =>
536
+ FeatureProgrammer.decode_object({
537
+ config: {
538
+ trace: false,
539
+ path: false,
540
+ prefix: PREFIX,
541
+ },
542
+ functor: props.functor,
543
+ object: props.object,
544
+ input: props.input,
545
+ explore: props.explore,
546
+ });
547
+
548
+ const decode_array = (props: {
549
+ config: FeatureProgrammer.IConfig;
550
+ functor: FunctionProgrammer;
551
+ input: ts.Expression;
552
+ array: MetadataArray;
553
+ explore: FeatureProgrammer.IExplore;
554
+ }) =>
555
+ props.array.type.recursive
556
+ ? ts.factory.createCallExpression(
557
+ ts.factory.createIdentifier(
558
+ props.functor.useLocal(
559
+ `${props.config.prefix}a${props.array.type.index}`,
560
+ ),
561
+ ),
562
+ undefined,
563
+ FeatureProgrammer.argumentsArray({
564
+ config: props.config,
565
+ input: props.input,
566
+ explore: {
567
+ ...props.explore,
568
+ source: "function",
569
+ from: "array",
570
+ },
571
+ }),
572
+ )
573
+ : decode_array_inline(props);
574
+
575
+ const decode_array_inline = (props: {
576
+ config: FeatureProgrammer.IConfig;
577
+ functor: FunctionProgrammer;
578
+ input: ts.Expression;
579
+ array: MetadataArray;
580
+ explore: FeatureProgrammer.IExplore;
581
+ }) =>
582
+ FeatureProgrammer.decode_array({
583
+ config: props.config,
584
+ functor: props.functor,
585
+ combiner: StringifyJoiner.array,
586
+ array: props.array,
587
+ input: props.input,
588
+ explore: props.explore,
589
+ });
590
+
591
+ const decode_tuple = (props: {
592
+ context: ITypiaContext;
593
+ config: FeatureProgrammer.IConfig;
594
+ functor: FunctionProgrammer;
595
+ input: ts.Expression;
596
+ tuple: MetadataTuple;
597
+ explore: FeatureProgrammer.IExplore;
598
+ }): ts.Expression =>
599
+ props.tuple.type.recursive
600
+ ? ts.factory.createCallExpression(
601
+ ts.factory.createIdentifier(
602
+ props.functor.useLocal(
603
+ `${props.config.prefix}t${props.tuple.type.index}`,
604
+ ),
605
+ ),
606
+ undefined,
607
+ FeatureProgrammer.argumentsArray({
608
+ config: props.config,
609
+ explore: {
610
+ ...props.explore,
611
+ source: "function",
612
+ },
613
+ input: props.input,
614
+ }),
615
+ )
616
+ : decode_tuple_inline({
617
+ ...props,
618
+ tuple: props.tuple.type,
619
+ });
620
+
621
+ const decode_tuple_inline = (props: {
622
+ context: ITypiaContext;
623
+ config: FeatureProgrammer.IConfig;
624
+ functor: FunctionProgrammer;
625
+ input: ts.Expression;
626
+ tuple: MetadataTupleType;
627
+ explore: FeatureProgrammer.IExplore;
628
+ }): ts.Expression => {
629
+ const elements: ts.Expression[] = props.tuple.elements
630
+ .filter((elem) => elem.rest === null)
631
+ .map((elem, index) =>
632
+ decode({
633
+ ...props,
634
+ input: ts.factory.createElementAccessExpression(props.input, index),
635
+ metadata: elem,
636
+ explore: {
637
+ ...props.explore,
638
+ from: "array",
639
+ postfix: props.explore.postfix.length
640
+ ? `${postfix_of_tuple(props.explore.postfix)}[${index}]"`
641
+ : `"[${index}]"`,
642
+ },
643
+ }),
644
+ );
645
+ const rest = (() => {
646
+ if (props.tuple.elements.length === 0) return null;
647
+ const last = props.tuple.elements.at(-1)!;
648
+ if (last.rest === null) return null;
649
+
650
+ const code = decode({
651
+ ...props,
652
+ input: ts.factory.createCallExpression(
653
+ IdentifierFactory.access(props.input, "slice"),
654
+ undefined,
655
+ [ExpressionFactory.number(props.tuple.elements.length - 1)],
656
+ ),
657
+ metadata: wrap_metadata_rest_tuple(props.tuple.elements.at(-1)!.rest!),
658
+ explore: {
659
+ ...props.explore,
660
+ start: props.tuple.elements.length - 1,
661
+ },
662
+ });
663
+ return ts.factory.createCallExpression(
664
+ props.context.importer.internal("jsonStringifyRest"),
665
+ undefined,
666
+ [code],
667
+ );
668
+ })();
669
+ return StringifyJoiner.tuple({
670
+ elements,
671
+ rest,
672
+ });
673
+ };
674
+
675
+ const decode_atomic = (props: {
676
+ context: ITypiaContext;
677
+ input: ts.Expression;
678
+ type: string;
679
+ explore: FeatureProgrammer.IExplore;
680
+ }): ts.Expression => {
681
+ if (props.type === "string")
682
+ return ts.factory.createCallExpression(
683
+ props.context.importer.internal("jsonStringifyString"),
684
+ undefined,
685
+ [props.input],
686
+ );
687
+ else if (
688
+ props.type === "number" &&
689
+ OptionPredicator.numeric(props.context.options)
690
+ )
691
+ props = {
692
+ ...props,
693
+ input: ts.factory.createCallExpression(
694
+ props.context.importer.internal("jsonStringifyNumber"),
695
+ undefined,
696
+ [props.input],
697
+ ),
698
+ };
699
+
700
+ return props.explore.from !== "top"
701
+ ? props.input
702
+ : ts.factory.createCallExpression(
703
+ IdentifierFactory.access(props.input, "toString"),
704
+ undefined,
705
+ undefined,
706
+ );
707
+ };
708
+
709
+ const decode_constant_string = (props: {
710
+ context: ITypiaContext;
711
+ functor: FunctionProgrammer;
712
+ input: ts.Expression;
713
+ values: string[];
714
+ explore: FeatureProgrammer.IExplore;
715
+ }): ts.Expression => {
716
+ if (props.values.every((v) => !StringifyPredicator.require_escape(v)))
717
+ return [
718
+ ts.factory.createStringLiteral('"'),
719
+ props.input,
720
+ ts.factory.createStringLiteral('"'),
721
+ ].reduce((x, y) => ts.factory.createAdd(x, y));
722
+ return decode_atomic({
723
+ ...props,
724
+ type: "string",
725
+ });
726
+ };
727
+
728
+ const decode_to_json = (props: {
729
+ context: ITypiaContext;
730
+ config: FeatureProgrammer.IConfig;
731
+ functor: FunctionProgrammer;
732
+ input: ts.Expression;
733
+ metadata: Metadata;
734
+ explore: FeatureProgrammer.IExplore;
735
+ }): ts.Expression => {
736
+ return decode({
737
+ ...props,
738
+ input: ts.factory.createCallExpression(
739
+ IdentifierFactory.access(props.input, "toJSON"),
740
+ undefined,
741
+ [],
742
+ ),
743
+ });
744
+ };
745
+
746
+ const decode_functional = (explore: FeatureProgrammer.IExplore) =>
747
+ explore.from === "array"
748
+ ? ts.factory.createStringLiteral("null")
749
+ : ts.factory.createIdentifier("undefined");
750
+
751
+ /* -----------------------------------------------------------
752
+ EXPLORERS
753
+ ----------------------------------------------------------- */
754
+ const explore_objects = (props: {
755
+ config: FeatureProgrammer.IConfig;
756
+ functor: FunctionProgrammer;
757
+ input: ts.Expression;
758
+ metadata: Metadata;
759
+ explore: FeatureProgrammer.IExplore;
760
+ }) =>
761
+ props.metadata.objects.length === 1
762
+ ? decode_object({
763
+ functor: props.functor,
764
+ input: props.input,
765
+ object: props.metadata.objects[0]!.type,
766
+ explore: props.explore,
767
+ })
768
+ : ts.factory.createCallExpression(
769
+ ts.factory.createIdentifier(
770
+ props.functor.useLocal(`${PREFIX}u${props.metadata.union_index!}`),
771
+ ),
772
+ undefined,
773
+ FeatureProgrammer.argumentsArray(props),
774
+ );
775
+
776
+ const explore_arrays = (props: {
777
+ context: ITypiaContext;
778
+ config: FeatureProgrammer.IConfig;
779
+ functor: FunctionProgrammer;
780
+ input: ts.Expression;
781
+ arrays: MetadataArray[];
782
+ explore: FeatureProgrammer.IExplore;
783
+ }): ts.Expression =>
784
+ explore_array_like_union_types({
785
+ ...props,
786
+ elements: props.arrays,
787
+ factory: (next) =>
788
+ UnionExplorer.array({
789
+ config: {
790
+ checker: (v) =>
791
+ IsProgrammer.decode({
792
+ context: props.context,
793
+ functor: props.functor,
794
+ metadata: v.definition,
795
+ input: v.input,
796
+ explore: v.explore,
797
+ }),
798
+ decoder: (v) =>
799
+ decode_array({
800
+ config: props.config,
801
+ functor: props.functor,
802
+ input: v.input,
803
+ array: v.definition,
804
+ explore: v.explore,
805
+ }),
806
+ empty: ts.factory.createStringLiteral("[]"),
807
+ success: ts.factory.createTrue(),
808
+ failure: (v) =>
809
+ create_throw_error({
810
+ context: props.context,
811
+ functor: props.functor,
812
+ expected: v.expected,
813
+ input: v.input,
814
+ }),
815
+ },
816
+ parameters: next.parameters,
817
+ input: next.input,
818
+ arrays: next.definitions,
819
+ explore: next.explore,
820
+ }),
821
+ //(next.parameters)(next.input, next.elements, next.explore),
822
+ });
823
+
824
+ const explore_array_like_union_types = <
825
+ T extends MetadataArray | MetadataTuple,
826
+ >(props: {
827
+ config: FeatureProgrammer.IConfig;
828
+ functor: FunctionProgrammer;
829
+ factory: (next: {
830
+ parameters: ts.ParameterDeclaration[];
831
+ input: ts.Expression;
832
+ definitions: T[];
833
+ explore: FeatureProgrammer.IExplore;
834
+ }) => ts.ArrowFunction;
835
+ input: ts.Expression;
836
+ elements: T[];
837
+ explore: FeatureProgrammer.IExplore;
838
+ }): ts.Expression => {
839
+ const arrow = (next: {
840
+ parameters: ts.ParameterDeclaration[];
841
+ explore: FeatureProgrammer.IExplore;
842
+ input: ts.Expression;
843
+ }): ts.ArrowFunction =>
844
+ props.factory({
845
+ definitions: props.elements,
846
+ parameters: next.parameters,
847
+ input: next.input,
848
+ explore: next.explore,
849
+ });
850
+ if (props.elements.every((e) => e.type.recursive === false))
851
+ ts.factory.createCallExpression(
852
+ arrow({
853
+ parameters: [],
854
+ explore: props.explore,
855
+ input: props.input,
856
+ }),
857
+ undefined,
858
+ [],
859
+ );
860
+
861
+ const arrayExplore: FeatureProgrammer.IExplore = {
862
+ ...props.explore,
863
+ source: "function",
864
+ from: "array",
865
+ };
866
+ return ts.factory.createCallExpression(
867
+ ts.factory.createIdentifier(
868
+ props.functor.emplaceUnion(
869
+ props.config.prefix,
870
+ props.elements.map((e) => e.type.name).join(" | "),
871
+ () =>
872
+ arrow({
873
+ parameters: FeatureProgrammer.parameterDeclarations({
874
+ config: props.config,
875
+ type: TypeFactory.keyword("any"),
876
+ input: ts.factory.createIdentifier("input"),
877
+ }),
878
+ explore: {
879
+ ...arrayExplore,
880
+ postfix: "",
881
+ },
882
+ input: ts.factory.createIdentifier("input"),
883
+ }),
884
+ ),
885
+ ),
886
+ undefined,
887
+ FeatureProgrammer.argumentsArray({
888
+ config: props.config,
889
+ explore: arrayExplore,
890
+ input: props.input,
891
+ }),
892
+ );
893
+ };
894
+
895
+ /* -----------------------------------------------------------
896
+ RETURN SCRIPTS
897
+ ----------------------------------------------------------- */
898
+ const wrap_required = (props: {
899
+ input: ts.Expression;
900
+ metadata: Metadata;
901
+ explore: FeatureProgrammer.IExplore;
902
+ expression: ts.Expression;
903
+ }): ts.Expression => {
904
+ if (props.metadata.isRequired() === true && props.metadata.any === false)
905
+ return props.expression;
906
+ return ts.factory.createConditionalExpression(
907
+ ts.factory.createStrictInequality(
908
+ ts.factory.createIdentifier("undefined"),
909
+ props.input,
910
+ ),
911
+ undefined,
912
+ props.expression,
913
+ undefined,
914
+ props.explore.from === "array"
915
+ ? ts.factory.createStringLiteral("null")
916
+ : ts.factory.createIdentifier("undefined"),
917
+ );
918
+ };
919
+
920
+ const wrap_nullable = (props: {
921
+ input: ts.Expression;
922
+ metadata: Metadata;
923
+ expression: ts.Expression;
924
+ }): ts.Expression => {
925
+ if (props.metadata.nullable === false) return props.expression;
926
+ return ts.factory.createConditionalExpression(
927
+ ts.factory.createStrictInequality(ts.factory.createNull(), props.input),
928
+ undefined,
929
+ props.expression,
930
+ undefined,
931
+ ts.factory.createStringLiteral("null"),
932
+ );
933
+ };
934
+
935
+ const wrap_functional = (props: {
936
+ input: ts.Expression;
937
+ metadata: Metadata;
938
+ explore: FeatureProgrammer.IExplore;
939
+ expression: ts.Expression;
940
+ }): ts.Expression => {
941
+ if (props.metadata.functions.length === 0) return props.expression;
942
+ return ts.factory.createConditionalExpression(
943
+ ts.factory.createStrictInequality(
944
+ ts.factory.createStringLiteral("function"),
945
+ ValueFactory.TYPEOF(props.input),
946
+ ),
947
+ undefined,
948
+ props.expression,
949
+ undefined,
950
+ decode_functional(props.explore),
951
+ );
952
+ };
953
+
954
+ const iterate = (props: {
955
+ context: ITypiaContext;
956
+ functor: FunctionProgrammer;
957
+ input: ts.Expression;
958
+ unions: IUnion[];
959
+ expected: string;
960
+ }) =>
961
+ ts.factory.createBlock(
962
+ [
963
+ ...props.unions.map((u) =>
964
+ ts.factory.createIfStatement(
965
+ u.is(),
966
+ ts.factory.createReturnStatement(u.value()),
967
+ ),
968
+ ),
969
+ create_throw_error(props),
970
+ ],
971
+ true,
972
+ );
973
+
974
+ /* -----------------------------------------------------------
975
+ CONFIGURATIONS
976
+ ----------------------------------------------------------- */
977
+ const PREFIX = "_s";
978
+
979
+ const configure = (props: {
980
+ context: ITypiaContext;
981
+ functor: FunctionProgrammer;
982
+ }): FeatureProgrammer.IConfig => {
983
+ const config: FeatureProgrammer.IConfig<ts.Expression> = {
984
+ types: {
985
+ input: (type, name) =>
986
+ ts.factory.createTypeReferenceNode(
987
+ name ??
988
+ TypeFactory.getFullName({ checker: props.context.checker, type }),
989
+ ),
990
+ output: () => TypeFactory.keyword("string"),
991
+ },
992
+ prefix: PREFIX,
993
+ trace: false,
994
+ path: false,
995
+ initializer,
996
+ decoder: (next) =>
997
+ decode({
998
+ context: props.context,
999
+ functor: props.functor,
1000
+ config,
1001
+ metadata: next.metadata,
1002
+ input: next.input,
1003
+ explore: next.explore,
1004
+ }),
1005
+ objector: {
1006
+ checker: (next) =>
1007
+ IsProgrammer.decode({
1008
+ context: props.context,
1009
+ functor: props.functor,
1010
+ metadata: next.metadata,
1011
+ input: next.input,
1012
+ explore: next.explore,
1013
+ }),
1014
+ decoder: (next) =>
1015
+ decode_object({
1016
+ functor: props.functor,
1017
+ input: next.input,
1018
+ object: next.object,
1019
+ explore: next.explore,
1020
+ }),
1021
+ joiner: (next) =>
1022
+ StringifyJoiner.object({
1023
+ ...next,
1024
+ context: props.context,
1025
+ }),
1026
+ unionizer: (next) =>
1027
+ decode_union_object({
1028
+ checker: (v) =>
1029
+ IsProgrammer.decode_object({
1030
+ context: props.context,
1031
+ functor: props.functor,
1032
+ input: v.input,
1033
+ object: v.object,
1034
+ explore: v.explore,
1035
+ }),
1036
+ decoder: (v) =>
1037
+ decode_object({
1038
+ functor: props.functor,
1039
+ input: v.input,
1040
+ object: v.object,
1041
+ explore: v.explore,
1042
+ }),
1043
+ success: (exp) => exp,
1044
+ escaper: (v) =>
1045
+ create_throw_error({
1046
+ context: props.context,
1047
+ functor: props.functor,
1048
+ expected: v.expected,
1049
+ input: v.input,
1050
+ }),
1051
+ objects: next.objects,
1052
+ explore: next.explore,
1053
+ input: next.input,
1054
+ }),
1055
+ failure: (next) =>
1056
+ create_throw_error({
1057
+ context: props.context,
1058
+ functor: props.functor,
1059
+ expected: next.expected,
1060
+ input: next.input,
1061
+ }),
1062
+ },
1063
+ generator: {
1064
+ arrays: (collection) =>
1065
+ write_array_functions({
1066
+ config,
1067
+ functor: props.functor,
1068
+ collection,
1069
+ }),
1070
+ tuples: (collection) =>
1071
+ write_tuple_functions({
1072
+ config,
1073
+ context: props.context,
1074
+ functor: props.functor,
1075
+ collection,
1076
+ }),
1077
+ },
1078
+ };
1079
+ return config;
1080
+ };
1081
+
1082
+ const initializer: FeatureProgrammer.IConfig["initializer"] = (props) =>
1083
+ JsonMetadataFactory.analyze({
1084
+ method: props.functor.method,
1085
+ checker: props.context.checker,
1086
+ transformer: props.context.transformer,
1087
+ type: props.type,
1088
+ });
1089
+
1090
+ const create_throw_error = (props: {
1091
+ context: ITypiaContext;
1092
+ functor: FunctionProgrammer;
1093
+ expected: string;
1094
+ input: ts.Expression;
1095
+ }) =>
1096
+ ts.factory.createExpressionStatement(
1097
+ ts.factory.createCallExpression(
1098
+ props.context.importer.internal("throwTypeGuardError"),
1099
+ [],
1100
+ [
1101
+ ts.factory.createObjectLiteralExpression(
1102
+ [
1103
+ ts.factory.createPropertyAssignment(
1104
+ "method",
1105
+ ts.factory.createStringLiteral(props.functor.method),
1106
+ ),
1107
+ ts.factory.createPropertyAssignment(
1108
+ "expected",
1109
+ ts.factory.createStringLiteral(props.expected),
1110
+ ),
1111
+ ts.factory.createPropertyAssignment("value", props.input),
1112
+ ],
1113
+ true,
1114
+ ),
1115
+ ],
1116
+ ),
1117
+ );
1118
+ }
1119
+
1120
+ interface IUnion {
1121
+ type: string;
1122
+ is: () => ts.Expression;
1123
+ value: () => ts.Expression;
1124
+ }