typia 7.3.0-dev.20241213 → 7.3.0

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 +1 -1
  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 +76 -76
  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 +81 -81
  254. package/src/programmers/llm/LlmApplicationProgrammer.ts +277 -277
  255. package/src/programmers/llm/LlmModelPredicator.ts +127 -127
  256. package/src/programmers/llm/LlmParametersProgrammer.ts +90 -90
  257. package/src/programmers/llm/LlmSchemaProgrammer.ts +143 -143
  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 +115 -115
  394. package/src/transformers/features/llm/LlmApplicationTransformer.ts +113 -113
  395. package/src/transformers/features/llm/LlmParametersTransformer.ts +89 -89
  396. package/src/transformers/features/llm/LlmSchemaTransformer.ts +130 -130
  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,411 +1,411 @@
1
- import { IMetadataTypeTag } from "../schemas/metadata/IMetadataTypeTag";
2
- import { Metadata } from "../schemas/metadata/Metadata";
3
- import { MetadataObjectType } from "../schemas/metadata/MetadataObjectType";
4
- import { MetadataProperty } from "../schemas/metadata/MetadataProperty";
5
-
6
- import { MetadataFactory } from "./MetadataFactory";
7
- import { MetadataTypeTagSchemaFactory } from "./MetadataTypeTagSchemaFactory";
8
-
9
- export namespace MetadataTypeTagFactory {
10
- export const is = (obj: MetadataObjectType): boolean => {
11
- if (obj.properties.length !== 1) return false;
12
-
13
- const top: MetadataProperty = obj.properties[0]!;
14
- if (top.key.isSoleLiteral() === false) return false;
15
- else if (top.key.getSoleLiteral() !== "typia.tag") return false;
16
-
17
- const value: Metadata = top.value;
18
- if (
19
- value.size() !== 1 ||
20
- value.objects.length !== 1 ||
21
- value.isRequired() === true ||
22
- value.nullable === true
23
- )
24
- return false;
25
-
26
- const tag: MetadataObjectType = top.value.objects[0]!.type;
27
- const statics: string[] = tag.properties
28
- .map((p) => p.key.getSoleLiteral()!)
29
- .filter((str) => str !== null);
30
- if (ESSENTIAL_FIELDS.some((f) => !statics.includes(f))) return false;
31
- return true;
32
- };
33
-
34
- export const analyze = (props: {
35
- errors: MetadataFactory.IError[];
36
- type: "boolean" | "bigint" | "number" | "string" | "array" | "object";
37
- objects: MetadataObjectType[];
38
- explore: MetadataFactory.IExplore;
39
- }): IMetadataTypeTag[] => {
40
- const messages: string[] = [];
41
- const report = (next: {
42
- property: string | null;
43
- message: string;
44
- }): false => {
45
- messages.push(
46
- `the property ${
47
- next.property === null
48
- ? `["typia.tag"]`
49
- : `["typia.tag.${next.property}"]`
50
- } ${next.message}.`,
51
- );
52
- return false;
53
- };
54
-
55
- //----
56
- // VALIDATION PROCESS
57
- //----
58
- const filtered: MetadataObjectType[] = props.objects.filter((obj) => {
59
- // ONLY ONE PROPERTY
60
- if (obj.properties.length !== 1) return false;
61
-
62
- // THE TAG.TYPE PROPERTY MUST BE
63
- const top: MetadataProperty = obj.properties[0]!;
64
- if (
65
- top.key.getSoleLiteral() !== "typia.tag" ||
66
- top.value.size() !== 1 ||
67
- top.value.objects.length !== 1
68
- )
69
- return false;
70
- else if (top.value.optional === false)
71
- return report({
72
- property: null,
73
- message: "must be optional object",
74
- });
75
-
76
- // CHECK LIST OF PROPERTIES
77
- const tag: MetadataObjectType = top.value.objects[0]!.type;
78
- const statics: string[] = tag.properties
79
- .map((p) => p.key.getSoleLiteral()!)
80
- .filter((str) => str !== null);
81
- if (ESSENTIAL_FIELDS.some((f) => !statics.includes(f)))
82
- return report({
83
- property: null,
84
- message: `must have at least three properties - ${ESSENTIAL_FIELDS.map(
85
- (str) => `'${str}'`,
86
- ).join(", ")}`,
87
- });
88
-
89
- const each: boolean[] = tag.properties.map((p) => {
90
- const key: string | null = p.key.getSoleLiteral();
91
- if (key === null) return true;
92
- else if (FIELDS.includes(key) === false) return true;
93
- return validate_property({
94
- report,
95
- key,
96
- value: p.value,
97
- });
98
- });
99
- return each.every((v) => v === true);
100
- });
101
- if (filtered.length === 0) return [];
102
-
103
- //----
104
- // CONSTRUCT TYPE TAGS
105
- //----
106
- // CREATE 1ST
107
- const tagList: Array<ITypeTag | null> = filtered.map((object) =>
108
- create_metadata_type_tag({
109
- report,
110
- object,
111
- }),
112
- );
113
-
114
- const output: IMetadataTypeTag[] = [];
115
- for (const tag of tagList)
116
- if (tag !== null)
117
- output.push({
118
- target: tag.target.some((str) => str === props.type)
119
- ? props.type
120
- : null!,
121
- name: tag.name,
122
- kind: tag.kind,
123
- value: tag.value,
124
- validate: tag.validate[props.type]!,
125
- exclusive: tag.exclusive,
126
- schema: tag.schema,
127
- });
128
- validate({
129
- report,
130
- type: props.type,
131
- tags: output,
132
- });
133
-
134
- if (messages.length > 0) {
135
- props.errors.push({
136
- name: [props.type, ...props.objects.map((o) => o.name)].join(" & "),
137
- explore: props.explore,
138
- messages,
139
- });
140
- return [];
141
- }
142
- return output;
143
- };
144
-
145
- export const validate = (props: {
146
- report: (next: { property: string | null; message: string }) => false;
147
- type: "boolean" | "bigint" | "number" | "string" | "array" | "object";
148
- tags: IMetadataTypeTag[];
149
- }): boolean => {
150
- let success: boolean = true;
151
- for (const tag of props.tags)
152
- if (tag.target !== props.type) {
153
- success &&= props.report({
154
- property: null,
155
- message: `target must constains ${props.type} type`,
156
- });
157
- }
158
-
159
- props.tags.forEach((tag, i) => {
160
- if (tag.exclusive === false) return;
161
- else if (tag.exclusive === true) {
162
- const some: boolean = props.tags.some(
163
- (opposite, j) => i !== j && opposite.kind === tag.kind,
164
- );
165
- if (some === true)
166
- success &&= props.report({
167
- property: null,
168
- message: `kind '${tag.kind}' can't be duplicated`,
169
- });
170
- } else if (Array.isArray(tag.exclusive)) {
171
- const some: IMetadataTypeTag | undefined = props.tags.find(
172
- (opposite, j) =>
173
- i !== j &&
174
- opposite.kind === tag.kind &&
175
- (tag.exclusive as string[]).includes(opposite.name),
176
- );
177
- if (some !== undefined)
178
- success ??= props.report({
179
- property: null,
180
- message: `kind '${tag.kind}' can't be used with '${some.name}'`,
181
- });
182
- }
183
- });
184
- return success;
185
- };
186
-
187
- const validate_property = (props: {
188
- report: (next: { property: string | null; message: string }) => false;
189
- key: string;
190
- value: Metadata;
191
- }): boolean => {
192
- if (
193
- // TARGET
194
- props.key === "target" &&
195
- (props.value.constants.length !== 1 ||
196
- props.value.constants[0]!.values.length !== props.value.size() ||
197
- props.value.constants[0]!.values.some(
198
- (v) =>
199
- v.value !== "boolean" &&
200
- v.value !== "bigint" &&
201
- v.value !== "number" &&
202
- v.value !== "string" &&
203
- v.value !== "array" &&
204
- v.value !== "object",
205
- ))
206
- )
207
- return props.report({
208
- property: props.key,
209
- message: `must be one of 'boolean', 'bigint', 'number', 'string', 'array', 'object'`,
210
- });
211
- else if (
212
- // KIND
213
- props.key === "kind" &&
214
- (props.value.size() !== 1 ||
215
- props.value.constants.length !== 1 ||
216
- props.value.constants[0]!.type !== "string" ||
217
- props.value.constants[0]!.values.length !== 1)
218
- )
219
- return props.report({
220
- property: props.key,
221
- message: "must be a string literal type",
222
- });
223
- else if (
224
- // VALUE
225
- props.key === "value" &&
226
- (props.value.size() > 1 ||
227
- (props.value.size() !== 0 &&
228
- (props.value.constants.length !== 1 ||
229
- props.value.constants[0]!.values.length !== 1)))
230
- )
231
- return props.report({
232
- property: props.key,
233
- message: "must be a constant literal type or undefined value",
234
- });
235
- else if (props.key === "exclusive") return get_exclusive(props) !== null;
236
- else if (props.key === "validate") {
237
- //----
238
- // VALIDATE
239
- //----
240
- // UNDEFINED CASE
241
- if (
242
- props.value.size() === 0 &&
243
- props.value.isRequired() === false &&
244
- props.value.nullable === false
245
- )
246
- return true;
247
-
248
- // STRING CASE
249
- if (
250
- props.value.size() === 1 &&
251
- props.value.constants.length === 1 &&
252
- props.value.constants[0]!.type === "string" &&
253
- (props.value.constants[0]!.values.length === 1) === true
254
- )
255
- return true;
256
-
257
- // RECORD<TARGET, STRING>
258
- const target: string[] | undefined =
259
- props.value.objects[0]?.type.properties
260
- .map((p) => p.key.getSoleLiteral()!)
261
- .filter((str) => str !== null) as string[] | undefined;
262
- if (target === undefined)
263
- return props.report({
264
- property: "target",
265
- message: `must be one of 'boolean', 'bigint', 'number', 'string', 'array', 'object`,
266
- });
267
- const variadic: boolean =
268
- props.value.size() === 1 &&
269
- props.value.objects.length === 1 &&
270
- props.value.objects[0]!.type.properties.every(
271
- (vp) =>
272
- vp.value.size() === 1 &&
273
- vp.value.isRequired() &&
274
- vp.value.nullable === false &&
275
- vp.value.constants.length === 1 &&
276
- vp.value.constants[0]!.type === "string" &&
277
- vp.value.constants[0]!.values.length === 1 &&
278
- target.includes(vp.key.getSoleLiteral()!),
279
- );
280
- if (variadic === false)
281
- return props.report({
282
- property: props.key,
283
- message: `must be a string literal type or Record<Target, string> type.`,
284
- });
285
- }
286
- return true;
287
- };
288
-
289
- const create_metadata_type_tag = (props: {
290
- report: (next: { property: string | null; message: string }) => false;
291
- object: MetadataObjectType;
292
- }): ITypeTag | null => {
293
- const find = (key: string): MetadataProperty | undefined =>
294
- props.object.properties[0]?.value.objects[0]?.type.properties.find(
295
- (p) => p.key.getSoleLiteral() === key,
296
- );
297
-
298
- const target = find("target")!.value.constants[0]!.values.map(
299
- (v) => v.value,
300
- ) as ITypeTag["target"];
301
- const kind: string = find("kind")!.value.constants[0]!.values[0]!
302
- .value as string;
303
- const value: boolean | bigint | number | string | undefined =
304
- find("value")?.value.constants[0]?.values[0]!.value;
305
- const exclusive: string[] | boolean | null = get_exclusive({
306
- report: props.report,
307
- key: "exclusive",
308
- value: find("exclusive")?.value,
309
- });
310
- if (exclusive === null) return null;
311
-
312
- const validate: Record<string, string> = (() => {
313
- const validate = find("validate")?.value;
314
- if (!validate || validate.size() === 0) return {};
315
- else if (validate.constants.length)
316
- return Object.fromEntries(
317
- target.map((t) => [
318
- t,
319
- validate.constants[0]!.values[0]!.value as string,
320
- ]),
321
- );
322
- return Object.fromEntries(
323
- validate.objects[0]!.type.properties.map((p) => [
324
- p.key.getSoleLiteral()!,
325
- p.value.constants[0]!.values[0]!.value as string,
326
- ]),
327
- );
328
- })();
329
- const schema: object | undefined = (() => {
330
- const p: Metadata | undefined = find("schema")?.value;
331
- if (p === undefined) return undefined;
332
- else if (p.size() === 0 && p.isRequired() === false) return undefined;
333
- else if (
334
- p.size() === 1 &&
335
- p.nullable === false &&
336
- p.isRequired() === true &&
337
- p.any === false
338
- )
339
- return MetadataTypeTagSchemaFactory.object({
340
- report: (message) =>
341
- props.report({
342
- property: "schema",
343
- message,
344
- }),
345
- object: p.objects[0]!.type,
346
- });
347
- props.report({
348
- property: "schema",
349
- message: "must be an object type",
350
- });
351
- return undefined;
352
- })();
353
- return {
354
- name: props.object.name,
355
- target,
356
- kind,
357
- value,
358
- validate,
359
- exclusive: exclusive ?? false,
360
- schema,
361
- };
362
- };
363
-
364
- const get_exclusive = (props: {
365
- report: (next: { property: string | null; message: string }) => false;
366
- key: string;
367
- value: Metadata | undefined;
368
- }): boolean | string[] | null => {
369
- if (props.value === undefined) return false;
370
- else if (
371
- props.value.size() === 1 &&
372
- props.value.constants.length === 1 &&
373
- props.value.constants[0]!.type === "boolean" &&
374
- props.value.constants[0]!.values.length === 1
375
- )
376
- return props.value.constants[0]!.values[0]!.value as boolean;
377
- else if (
378
- props.value.size() === 1 &&
379
- props.value.tuples.length === 1 &&
380
- props.value.tuples[0]!.type.elements.every(
381
- (elem) =>
382
- elem.size() === 1 &&
383
- elem.constants.length === 1 &&
384
- elem.constants[0]!.type === "string" &&
385
- elem.constants[0]!.values.length === 1,
386
- )
387
- )
388
- return props.value.tuples[0]!.type.elements.map(
389
- (elem) => elem.constants[0]!.values[0]!.value as string,
390
- );
391
- props.report({
392
- property: props.key,
393
- message:
394
- "must a boolean literal type or a tuple of string literal types.",
395
- });
396
- return null;
397
- };
398
- }
399
-
400
- interface ITypeTag {
401
- name: string;
402
- target: Array<"bigint" | "number" | "string" | "array" | "object">;
403
- kind: string;
404
- value?: undefined | boolean | bigint | number | string;
405
- validate: Record<string, string>;
406
- exclusive: boolean | string[];
407
- schema?: undefined | any;
408
- }
409
-
410
- const ESSENTIAL_FIELDS = ["target", "kind", "value"];
411
- const FIELDS = [...ESSENTIAL_FIELDS, "validate", "exclusive"];
1
+ import { IMetadataTypeTag } from "../schemas/metadata/IMetadataTypeTag";
2
+ import { Metadata } from "../schemas/metadata/Metadata";
3
+ import { MetadataObjectType } from "../schemas/metadata/MetadataObjectType";
4
+ import { MetadataProperty } from "../schemas/metadata/MetadataProperty";
5
+
6
+ import { MetadataFactory } from "./MetadataFactory";
7
+ import { MetadataTypeTagSchemaFactory } from "./MetadataTypeTagSchemaFactory";
8
+
9
+ export namespace MetadataTypeTagFactory {
10
+ export const is = (obj: MetadataObjectType): boolean => {
11
+ if (obj.properties.length !== 1) return false;
12
+
13
+ const top: MetadataProperty = obj.properties[0]!;
14
+ if (top.key.isSoleLiteral() === false) return false;
15
+ else if (top.key.getSoleLiteral() !== "typia.tag") return false;
16
+
17
+ const value: Metadata = top.value;
18
+ if (
19
+ value.size() !== 1 ||
20
+ value.objects.length !== 1 ||
21
+ value.isRequired() === true ||
22
+ value.nullable === true
23
+ )
24
+ return false;
25
+
26
+ const tag: MetadataObjectType = top.value.objects[0]!.type;
27
+ const statics: string[] = tag.properties
28
+ .map((p) => p.key.getSoleLiteral()!)
29
+ .filter((str) => str !== null);
30
+ if (ESSENTIAL_FIELDS.some((f) => !statics.includes(f))) return false;
31
+ return true;
32
+ };
33
+
34
+ export const analyze = (props: {
35
+ errors: MetadataFactory.IError[];
36
+ type: "boolean" | "bigint" | "number" | "string" | "array" | "object";
37
+ objects: MetadataObjectType[];
38
+ explore: MetadataFactory.IExplore;
39
+ }): IMetadataTypeTag[] => {
40
+ const messages: string[] = [];
41
+ const report = (next: {
42
+ property: string | null;
43
+ message: string;
44
+ }): false => {
45
+ messages.push(
46
+ `the property ${
47
+ next.property === null
48
+ ? `["typia.tag"]`
49
+ : `["typia.tag.${next.property}"]`
50
+ } ${next.message}.`,
51
+ );
52
+ return false;
53
+ };
54
+
55
+ //----
56
+ // VALIDATION PROCESS
57
+ //----
58
+ const filtered: MetadataObjectType[] = props.objects.filter((obj) => {
59
+ // ONLY ONE PROPERTY
60
+ if (obj.properties.length !== 1) return false;
61
+
62
+ // THE TAG.TYPE PROPERTY MUST BE
63
+ const top: MetadataProperty = obj.properties[0]!;
64
+ if (
65
+ top.key.getSoleLiteral() !== "typia.tag" ||
66
+ top.value.size() !== 1 ||
67
+ top.value.objects.length !== 1
68
+ )
69
+ return false;
70
+ else if (top.value.optional === false)
71
+ return report({
72
+ property: null,
73
+ message: "must be optional object",
74
+ });
75
+
76
+ // CHECK LIST OF PROPERTIES
77
+ const tag: MetadataObjectType = top.value.objects[0]!.type;
78
+ const statics: string[] = tag.properties
79
+ .map((p) => p.key.getSoleLiteral()!)
80
+ .filter((str) => str !== null);
81
+ if (ESSENTIAL_FIELDS.some((f) => !statics.includes(f)))
82
+ return report({
83
+ property: null,
84
+ message: `must have at least three properties - ${ESSENTIAL_FIELDS.map(
85
+ (str) => `'${str}'`,
86
+ ).join(", ")}`,
87
+ });
88
+
89
+ const each: boolean[] = tag.properties.map((p) => {
90
+ const key: string | null = p.key.getSoleLiteral();
91
+ if (key === null) return true;
92
+ else if (FIELDS.includes(key) === false) return true;
93
+ return validate_property({
94
+ report,
95
+ key,
96
+ value: p.value,
97
+ });
98
+ });
99
+ return each.every((v) => v === true);
100
+ });
101
+ if (filtered.length === 0) return [];
102
+
103
+ //----
104
+ // CONSTRUCT TYPE TAGS
105
+ //----
106
+ // CREATE 1ST
107
+ const tagList: Array<ITypeTag | null> = filtered.map((object) =>
108
+ create_metadata_type_tag({
109
+ report,
110
+ object,
111
+ }),
112
+ );
113
+
114
+ const output: IMetadataTypeTag[] = [];
115
+ for (const tag of tagList)
116
+ if (tag !== null)
117
+ output.push({
118
+ target: tag.target.some((str) => str === props.type)
119
+ ? props.type
120
+ : null!,
121
+ name: tag.name,
122
+ kind: tag.kind,
123
+ value: tag.value,
124
+ validate: tag.validate[props.type]!,
125
+ exclusive: tag.exclusive,
126
+ schema: tag.schema,
127
+ });
128
+ validate({
129
+ report,
130
+ type: props.type,
131
+ tags: output,
132
+ });
133
+
134
+ if (messages.length > 0) {
135
+ props.errors.push({
136
+ name: [props.type, ...props.objects.map((o) => o.name)].join(" & "),
137
+ explore: props.explore,
138
+ messages,
139
+ });
140
+ return [];
141
+ }
142
+ return output;
143
+ };
144
+
145
+ export const validate = (props: {
146
+ report: (next: { property: string | null; message: string }) => false;
147
+ type: "boolean" | "bigint" | "number" | "string" | "array" | "object";
148
+ tags: IMetadataTypeTag[];
149
+ }): boolean => {
150
+ let success: boolean = true;
151
+ for (const tag of props.tags)
152
+ if (tag.target !== props.type) {
153
+ success &&= props.report({
154
+ property: null,
155
+ message: `target must constains ${props.type} type`,
156
+ });
157
+ }
158
+
159
+ props.tags.forEach((tag, i) => {
160
+ if (tag.exclusive === false) return;
161
+ else if (tag.exclusive === true) {
162
+ const some: boolean = props.tags.some(
163
+ (opposite, j) => i !== j && opposite.kind === tag.kind,
164
+ );
165
+ if (some === true)
166
+ success &&= props.report({
167
+ property: null,
168
+ message: `kind '${tag.kind}' can't be duplicated`,
169
+ });
170
+ } else if (Array.isArray(tag.exclusive)) {
171
+ const some: IMetadataTypeTag | undefined = props.tags.find(
172
+ (opposite, j) =>
173
+ i !== j &&
174
+ opposite.kind === tag.kind &&
175
+ (tag.exclusive as string[]).includes(opposite.name),
176
+ );
177
+ if (some !== undefined)
178
+ success ??= props.report({
179
+ property: null,
180
+ message: `kind '${tag.kind}' can't be used with '${some.name}'`,
181
+ });
182
+ }
183
+ });
184
+ return success;
185
+ };
186
+
187
+ const validate_property = (props: {
188
+ report: (next: { property: string | null; message: string }) => false;
189
+ key: string;
190
+ value: Metadata;
191
+ }): boolean => {
192
+ if (
193
+ // TARGET
194
+ props.key === "target" &&
195
+ (props.value.constants.length !== 1 ||
196
+ props.value.constants[0]!.values.length !== props.value.size() ||
197
+ props.value.constants[0]!.values.some(
198
+ (v) =>
199
+ v.value !== "boolean" &&
200
+ v.value !== "bigint" &&
201
+ v.value !== "number" &&
202
+ v.value !== "string" &&
203
+ v.value !== "array" &&
204
+ v.value !== "object",
205
+ ))
206
+ )
207
+ return props.report({
208
+ property: props.key,
209
+ message: `must be one of 'boolean', 'bigint', 'number', 'string', 'array', 'object'`,
210
+ });
211
+ else if (
212
+ // KIND
213
+ props.key === "kind" &&
214
+ (props.value.size() !== 1 ||
215
+ props.value.constants.length !== 1 ||
216
+ props.value.constants[0]!.type !== "string" ||
217
+ props.value.constants[0]!.values.length !== 1)
218
+ )
219
+ return props.report({
220
+ property: props.key,
221
+ message: "must be a string literal type",
222
+ });
223
+ else if (
224
+ // VALUE
225
+ props.key === "value" &&
226
+ (props.value.size() > 1 ||
227
+ (props.value.size() !== 0 &&
228
+ (props.value.constants.length !== 1 ||
229
+ props.value.constants[0]!.values.length !== 1)))
230
+ )
231
+ return props.report({
232
+ property: props.key,
233
+ message: "must be a constant literal type or undefined value",
234
+ });
235
+ else if (props.key === "exclusive") return get_exclusive(props) !== null;
236
+ else if (props.key === "validate") {
237
+ //----
238
+ // VALIDATE
239
+ //----
240
+ // UNDEFINED CASE
241
+ if (
242
+ props.value.size() === 0 &&
243
+ props.value.isRequired() === false &&
244
+ props.value.nullable === false
245
+ )
246
+ return true;
247
+
248
+ // STRING CASE
249
+ if (
250
+ props.value.size() === 1 &&
251
+ props.value.constants.length === 1 &&
252
+ props.value.constants[0]!.type === "string" &&
253
+ (props.value.constants[0]!.values.length === 1) === true
254
+ )
255
+ return true;
256
+
257
+ // RECORD<TARGET, STRING>
258
+ const target: string[] | undefined =
259
+ props.value.objects[0]?.type.properties
260
+ .map((p) => p.key.getSoleLiteral()!)
261
+ .filter((str) => str !== null) as string[] | undefined;
262
+ if (target === undefined)
263
+ return props.report({
264
+ property: "target",
265
+ message: `must be one of 'boolean', 'bigint', 'number', 'string', 'array', 'object`,
266
+ });
267
+ const variadic: boolean =
268
+ props.value.size() === 1 &&
269
+ props.value.objects.length === 1 &&
270
+ props.value.objects[0]!.type.properties.every(
271
+ (vp) =>
272
+ vp.value.size() === 1 &&
273
+ vp.value.isRequired() &&
274
+ vp.value.nullable === false &&
275
+ vp.value.constants.length === 1 &&
276
+ vp.value.constants[0]!.type === "string" &&
277
+ vp.value.constants[0]!.values.length === 1 &&
278
+ target.includes(vp.key.getSoleLiteral()!),
279
+ );
280
+ if (variadic === false)
281
+ return props.report({
282
+ property: props.key,
283
+ message: `must be a string literal type or Record<Target, string> type.`,
284
+ });
285
+ }
286
+ return true;
287
+ };
288
+
289
+ const create_metadata_type_tag = (props: {
290
+ report: (next: { property: string | null; message: string }) => false;
291
+ object: MetadataObjectType;
292
+ }): ITypeTag | null => {
293
+ const find = (key: string): MetadataProperty | undefined =>
294
+ props.object.properties[0]?.value.objects[0]?.type.properties.find(
295
+ (p) => p.key.getSoleLiteral() === key,
296
+ );
297
+
298
+ const target = find("target")!.value.constants[0]!.values.map(
299
+ (v) => v.value,
300
+ ) as ITypeTag["target"];
301
+ const kind: string = find("kind")!.value.constants[0]!.values[0]!
302
+ .value as string;
303
+ const value: boolean | bigint | number | string | undefined =
304
+ find("value")?.value.constants[0]?.values[0]!.value;
305
+ const exclusive: string[] | boolean | null = get_exclusive({
306
+ report: props.report,
307
+ key: "exclusive",
308
+ value: find("exclusive")?.value,
309
+ });
310
+ if (exclusive === null) return null;
311
+
312
+ const validate: Record<string, string> = (() => {
313
+ const validate = find("validate")?.value;
314
+ if (!validate || validate.size() === 0) return {};
315
+ else if (validate.constants.length)
316
+ return Object.fromEntries(
317
+ target.map((t) => [
318
+ t,
319
+ validate.constants[0]!.values[0]!.value as string,
320
+ ]),
321
+ );
322
+ return Object.fromEntries(
323
+ validate.objects[0]!.type.properties.map((p) => [
324
+ p.key.getSoleLiteral()!,
325
+ p.value.constants[0]!.values[0]!.value as string,
326
+ ]),
327
+ );
328
+ })();
329
+ const schema: object | undefined = (() => {
330
+ const p: Metadata | undefined = find("schema")?.value;
331
+ if (p === undefined) return undefined;
332
+ else if (p.size() === 0 && p.isRequired() === false) return undefined;
333
+ else if (
334
+ p.size() === 1 &&
335
+ p.nullable === false &&
336
+ p.isRequired() === true &&
337
+ p.any === false
338
+ )
339
+ return MetadataTypeTagSchemaFactory.object({
340
+ report: (message) =>
341
+ props.report({
342
+ property: "schema",
343
+ message,
344
+ }),
345
+ object: p.objects[0]!.type,
346
+ });
347
+ props.report({
348
+ property: "schema",
349
+ message: "must be an object type",
350
+ });
351
+ return undefined;
352
+ })();
353
+ return {
354
+ name: props.object.name,
355
+ target,
356
+ kind,
357
+ value,
358
+ validate,
359
+ exclusive: exclusive ?? false,
360
+ schema,
361
+ };
362
+ };
363
+
364
+ const get_exclusive = (props: {
365
+ report: (next: { property: string | null; message: string }) => false;
366
+ key: string;
367
+ value: Metadata | undefined;
368
+ }): boolean | string[] | null => {
369
+ if (props.value === undefined) return false;
370
+ else if (
371
+ props.value.size() === 1 &&
372
+ props.value.constants.length === 1 &&
373
+ props.value.constants[0]!.type === "boolean" &&
374
+ props.value.constants[0]!.values.length === 1
375
+ )
376
+ return props.value.constants[0]!.values[0]!.value as boolean;
377
+ else if (
378
+ props.value.size() === 1 &&
379
+ props.value.tuples.length === 1 &&
380
+ props.value.tuples[0]!.type.elements.every(
381
+ (elem) =>
382
+ elem.size() === 1 &&
383
+ elem.constants.length === 1 &&
384
+ elem.constants[0]!.type === "string" &&
385
+ elem.constants[0]!.values.length === 1,
386
+ )
387
+ )
388
+ return props.value.tuples[0]!.type.elements.map(
389
+ (elem) => elem.constants[0]!.values[0]!.value as string,
390
+ );
391
+ props.report({
392
+ property: props.key,
393
+ message:
394
+ "must a boolean literal type or a tuple of string literal types.",
395
+ });
396
+ return null;
397
+ };
398
+ }
399
+
400
+ interface ITypeTag {
401
+ name: string;
402
+ target: Array<"bigint" | "number" | "string" | "array" | "object">;
403
+ kind: string;
404
+ value?: undefined | boolean | bigint | number | string;
405
+ validate: Record<string, string>;
406
+ exclusive: boolean | string[];
407
+ schema?: undefined | any;
408
+ }
409
+
410
+ const ESSENTIAL_FIELDS = ["target", "kind", "value"];
411
+ const FIELDS = [...ESSENTIAL_FIELDS, "validate", "exclusive"];