@futdevpro/fsm-dynamo 1.16.31 → 1.16.34

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 (560) hide show
  1. package/.cursor/rules/__assistant_guide.mdc +30 -30
  2. package/.cursor/rules/_ag_backend-structure.mdc +85 -85
  3. package/.cursor/rules/_ag_backend.mdc +16 -16
  4. package/.cursor/rules/_ag_frontend-structure.mdc +86 -86
  5. package/.cursor/rules/_ag_frontend.mdc +39 -39
  6. package/.cursor/rules/_ag_import-rules.mdc +44 -44
  7. package/.cursor/rules/_ag_naming.mdc +115 -115
  8. package/.cursor/rules/_ag_should-be.mdc +6 -6
  9. package/.cursor/rules/ai_development_guide.md +60 -60
  10. package/.cursor/rules/cursor-rules.md +160 -160
  11. package/.cursor/rules/default-command.mdc +464 -464
  12. package/.cursor/rules/error_code_pattern.md +39 -39
  13. package/.cursor/rules/saved rule mcp server use.md +15 -15
  14. package/.vscode/settings.json +11 -11
  15. package/LICENSE +21 -21
  16. package/__documentations/2026-06-22-dyfm-error-extends-error.md +109 -109
  17. package/build/_models/data-models/errors.data-model.d.ts +22 -0
  18. package/build/_models/data-models/errors.data-model.d.ts.map +1 -1
  19. package/build/_models/data-models/errors.data-model.js +24 -0
  20. package/build/_models/data-models/errors.data-model.js.map +1 -1
  21. package/build/_modules/game/_collections/audio-scale.util.d.ts +57 -0
  22. package/build/_modules/game/_collections/audio-scale.util.d.ts.map +1 -0
  23. package/build/_modules/game/_collections/audio-scale.util.js +105 -0
  24. package/build/_modules/game/_collections/audio-scale.util.js.map +1 -0
  25. package/build/_modules/game/_enums/audio-channel.enum.d.ts +8 -4
  26. package/build/_modules/game/_enums/audio-channel.enum.d.ts.map +1 -1
  27. package/build/_modules/game/_enums/audio-channel.enum.js +8 -4
  28. package/build/_modules/game/_enums/audio-channel.enum.js.map +1 -1
  29. package/build/_modules/game/_models/audio-mixer-config.interface.d.ts +37 -0
  30. package/build/_modules/game/_models/audio-mixer-config.interface.d.ts.map +1 -0
  31. package/build/_modules/game/_models/audio-mixer-config.interface.js +3 -0
  32. package/build/_modules/game/_models/audio-mixer-config.interface.js.map +1 -0
  33. package/build/_modules/game/_models/audio-mixer-state.interface.d.ts +19 -0
  34. package/build/_modules/game/_models/audio-mixer-state.interface.d.ts.map +1 -0
  35. package/build/_modules/game/_models/audio-mixer-state.interface.js +3 -0
  36. package/build/_modules/game/_models/audio-mixer-state.interface.js.map +1 -0
  37. package/build/_modules/game/_models/audio-mixer.control-model.d.ts +123 -0
  38. package/build/_modules/game/_models/audio-mixer.control-model.d.ts.map +1 -0
  39. package/build/_modules/game/_models/audio-mixer.control-model.js +312 -0
  40. package/build/_modules/game/_models/audio-mixer.control-model.js.map +1 -0
  41. package/build/_modules/game/_models/audio-scale.interface.d.ts +18 -0
  42. package/build/_modules/game/_models/audio-scale.interface.d.ts.map +1 -0
  43. package/build/_modules/game/_models/audio-scale.interface.js +3 -0
  44. package/build/_modules/game/_models/audio-scale.interface.js.map +1 -0
  45. package/build/_modules/game/index.d.ts +5 -0
  46. package/build/_modules/game/index.d.ts.map +1 -1
  47. package/build/_modules/game/index.js +5 -0
  48. package/build/_modules/game/index.js.map +1 -1
  49. package/build/_modules/socket/_models/sck-socket-event.control-model.js +1 -1
  50. package/eslint.config.js +4 -4
  51. package/nodemon.json +22 -22
  52. package/package.json +1 -1
  53. package/scripts/crypto/CRYPTO-STABILITY-SOLUTION.md +196 -196
  54. package/scripts/crypto/README.md +113 -113
  55. package/scripts/crypto/demo-crypto-stability.js +120 -120
  56. package/scripts/crypto/stress-test-crypto.js +379 -379
  57. package/scripts/run-coverage-tests.js +24 -24
  58. package/spec/support/helpers/ts-node-helper.js +9 -9
  59. package/spec/support/jasmine.coverage.json +23 -23
  60. package/spec/support/jasmine.json +24 -24
  61. package/src/_collections/constants/data-sizes.const.ts +40 -40
  62. package/src/_collections/constants/error-defaults.const.ts +20 -20
  63. package/src/_collections/constants/global-settings.const.ts +24 -24
  64. package/src/_collections/constants/numbers.const.ts +40 -40
  65. package/src/_collections/constants/times.const.ts +45 -45
  66. package/src/_collections/utils/array.util.spec.ts +306 -306
  67. package/src/_collections/utils/array.util.ts +813 -813
  68. package/src/_collections/utils/async.util.spec.ts +354 -354
  69. package/src/_collections/utils/async.util.ts +197 -197
  70. package/src/_collections/utils/data.util.spec.ts +345 -345
  71. package/src/_collections/utils/data.util.ts +226 -226
  72. package/src/_collections/utils/json-error-helper.util.spec.ts +521 -521
  73. package/src/_collections/utils/json-error-helper.util.ts +301 -301
  74. package/src/_collections/utils/log.util.spec.ts +975 -975
  75. package/src/_collections/utils/log.util.ts +667 -667
  76. package/src/_collections/utils/math/box-bounds.spec.ts +73 -73
  77. package/src/_collections/utils/math/box-bounds.util.ts +183 -183
  78. package/src/_collections/utils/math/math.util.spec.ts +94 -94
  79. package/src/_collections/utils/math/math.util.ts +141 -141
  80. package/src/_collections/utils/math/random.util.spec.ts +82 -82
  81. package/src/_collections/utils/math/random.util.ts +139 -139
  82. package/src/_collections/utils/math/trigonometry.util.spec.ts +57 -57
  83. package/src/_collections/utils/math/trigonometry.util.ts +102 -102
  84. package/src/_collections/utils/math/vector2.util.spec.ts +94 -94
  85. package/src/_collections/utils/math/vector2.util.ts +653 -653
  86. package/src/_collections/utils/object.util.spec.ts +646 -646
  87. package/src/_collections/utils/regex/password-regex.util.spec.ts +51 -51
  88. package/src/_collections/utils/regex/password-regex.util.ts +65 -65
  89. package/src/_collections/utils/regex/regex.util.spec.ts +42 -42
  90. package/src/_collections/utils/regex/regex.util.ts +6 -6
  91. package/src/_collections/utils/regex/username-regex.util.spec.ts +61 -61
  92. package/src/_collections/utils/regex/username-regex.util.ts +35 -35
  93. package/src/_collections/utils/round-list.util.spec.ts +79 -79
  94. package/src/_collections/utils/round-list.util.ts +162 -162
  95. package/src/_collections/utils/stack.util.spec.ts +372 -372
  96. package/src/_collections/utils/stack.util.ts +164 -164
  97. package/src/_collections/utils/string-case.util.spec.ts +441 -441
  98. package/src/_collections/utils/string-case.util.ts +362 -362
  99. package/src/_collections/utils/string.util.spec.ts +975 -975
  100. package/src/_collections/utils/string.util.ts +449 -449
  101. package/src/_collections/utils/time.util.spec.ts +50 -50
  102. package/src/_collections/utils/time.util.ts +481 -481
  103. package/src/_collections/utils/type-cloning-facility.util.spec.ts +51 -51
  104. package/src/_collections/utils/type-cloning-facility.util.ts +168 -168
  105. package/src/_collections/utils/utilities.util.spec.ts +201 -201
  106. package/src/_collections/utils/utilities.util.ts +68 -68
  107. package/src/_collections/utils/uuid.util.spec.ts +30 -30
  108. package/src/_collections/utils/uuid.util.ts +50 -50
  109. package/src/_enums/basic-property-type.enum.ts +20 -20
  110. package/src/_enums/data-model-type.enum.ts +29 -29
  111. package/src/_enums/environment-flag.enum.ts +28 -28
  112. package/src/_enums/error-level.enum.ts +43 -43
  113. package/src/_enums/http/http-call-type.enum.ts +43 -43
  114. package/src/_enums/http/http-event-type.enum.ts +40 -40
  115. package/src/_enums/http/http-response-type.enum.ts +18 -18
  116. package/src/_enums/log-style.enum.ts +44 -44
  117. package/src/_enums/server-connection-status.enum.ts +6 -6
  118. package/src/_enums/time/day-of-week.enum.ts +55 -55
  119. package/src/_enums/time/month.enum.ts +25 -25
  120. package/src/_enums/time/relative-date.enum.ts +24 -24
  121. package/src/_models/control-models/data-model-params.control-model.spec.ts +133 -133
  122. package/src/_models/control-models/data-model-params.control-model.ts +352 -352
  123. package/src/_models/control-models/data-property-params.control-model.spec.ts +93 -93
  124. package/src/_models/control-models/data-property-params.control-model.ts +210 -210
  125. package/src/_models/control-models/error.control-model.spec.ts +912 -912
  126. package/src/_models/control-models/error.control-model.ts +1274 -1274
  127. package/src/_models/control-models/http/http-error-response.control-model.spec.ts +116 -116
  128. package/src/_models/control-models/http/http-error-response.control-model.ts +52 -52
  129. package/src/_models/control-models/http/http-headers.control-model.spec.ts +25 -25
  130. package/src/_models/control-models/http/http-headers.control-model.ts +124 -124
  131. package/src/_models/control-models/http/http-response.model-base.spec.ts +46 -46
  132. package/src/_models/control-models/http/http-response.model-base.ts +57 -57
  133. package/src/_models/control-models/poll.control-model.spec.ts +63 -63
  134. package/src/_models/control-models/poll.control-model.ts +151 -151
  135. package/src/_models/control-models/range-value.control-model.spec.ts +187 -187
  136. package/src/_models/control-models/range-value.control-model.ts +289 -289
  137. package/src/_models/control-models/server-status.control-model.spec.ts +66 -66
  138. package/src/_models/control-models/server-status.control-model.ts +94 -94
  139. package/src/_models/control-models/service-endpoint-settings-base.control-model.spec.ts +145 -145
  140. package/src/_models/control-models/service-endpoint-settings-base.control-model.ts +186 -186
  141. package/src/_models/data-models/errors.data-model.spec.ts +71 -71
  142. package/src/_models/data-models/errors.data-model.ts +200 -175
  143. package/src/_models/data-models/metadata.data-model.spec.ts +184 -184
  144. package/src/_models/data-models/metadata.data-model.ts +153 -153
  145. package/src/_models/interfaces/box-bounds.interface.ts +7 -7
  146. package/src/_models/interfaces/environment/global-log-settings.interface.ts +86 -86
  147. package/src/_models/interfaces/environment/global-settings.interface.ts +47 -47
  148. package/src/_models/interfaces/error-defaults.interface.ts +11 -11
  149. package/src/_models/interfaces/paged.interface.ts +12 -12
  150. package/src/_models/interfaces/random-weight.interface.ts +7 -7
  151. package/src/_models/interfaces/route-settings.interface.ts +15 -15
  152. package/src/_models/interfaces/search-query.interface.ts +23 -23
  153. package/src/_models/interfaces/search-result.interface.ts +5 -5
  154. package/src/_models/interfaces/server-error-statistics.interface.ts +24 -24
  155. package/src/_models/interfaces/vector2.interface.ts +20 -20
  156. package/src/_models/types/db-filter.type.ts +110 -110
  157. package/src/_models/types/db-sort.type.ts +4 -4
  158. package/src/_models/types/ds-filter.type.ts +68 -68
  159. package/src/_models/types/ds-sort.type.ts +21 -21
  160. package/src/_modules/ai/_collections/ai-model-ref.util.ts +88 -88
  161. package/src/_modules/ai/_collections/ai-model-registry.util.spec.ts +37 -37
  162. package/src/_modules/ai/_collections/ai-model-registry.util.ts +30 -30
  163. package/src/_modules/ai/_enums/ai-message-role.enum.ts +7 -7
  164. package/src/_modules/ai/_enums/ai-model-type.enum.ts +7 -7
  165. package/src/_modules/ai/_enums/ai-provider.enum.ts +7 -7
  166. package/src/_modules/ai/_models/ai-call-settings.interface.ts +84 -84
  167. package/src/_modules/ai/_models/ai-embedding-request.interface.ts +20 -20
  168. package/src/_modules/ai/_models/ai-embedding-response.interface.ts +26 -26
  169. package/src/_modules/ai/_models/ai-llm-request.interface.ts +24 -24
  170. package/src/_modules/ai/_models/ai-llm-response.interface.ts +30 -30
  171. package/src/_modules/ai/_models/ai-message.interface.ts +12 -12
  172. package/src/_modules/ai/_models/ai-model-capabilities.interface.ts +35 -35
  173. package/src/_modules/ai/_models/ai-model-info.interface.ts +63 -63
  174. package/src/_modules/ai/_models/ai-model-settings-schema.interface.ts +52 -52
  175. package/src/_modules/ai/_models/ai-provider-capabilities.interface.ts +28 -28
  176. package/src/_modules/ai/_models/ai-settings.interface.ts +17 -17
  177. package/src/_modules/ai/_models/ai-tool-call.interface.ts +18 -18
  178. package/src/_modules/ai/_models/ai-tool-handler.type.ts +11 -11
  179. package/src/_modules/ai/_models/ai-tool-result.interface.ts +16 -16
  180. package/src/_modules/ai/_models/ai-tool.interface.ts +16 -16
  181. package/src/_modules/ai/_models/ai-user-provider-config.control-model.ts +29 -29
  182. package/src/_modules/ai/_modules/anthropic/_collections/aai-models.const.ts +135 -135
  183. package/src/_modules/ai/_modules/anthropic/_enums/aai-model.enum.ts +19 -19
  184. package/src/_modules/ai/_modules/anthropic/_models/aai-call-settings.control-model.spec.ts +28 -28
  185. package/src/_modules/ai/_modules/anthropic/_models/aai-call-settings.control-model.ts +23 -23
  186. package/src/_modules/ai/_modules/anthropic/_models/aai-client-options.interface.ts +10 -10
  187. package/src/_modules/ai/_modules/anthropic/_models/aai-settings.control-model.spec.ts +22 -22
  188. package/src/_modules/ai/_modules/anthropic/_models/aai-settings.control-model.ts +27 -27
  189. package/src/_modules/ai/_modules/anthropic/_models/aai-user-provider-config.control-model.ts +20 -20
  190. package/src/_modules/ai/_modules/anthropic/index.ts +14 -14
  191. package/src/_modules/ai/_modules/document-ai/_models/dai-embedding-info.interface.ts +12 -12
  192. package/src/_modules/ai/_modules/document-ai/_models/dai-vector-search-params.interface.ts +22 -22
  193. package/src/_modules/ai/_modules/document-ai/index.ts +4 -4
  194. package/src/_modules/ai/_modules/fdp-ai/_collections/fdpai-models.const.ts +40 -40
  195. package/src/_modules/ai/_modules/fdp-ai/_enums/fdpai-model.enum.ts +6 -6
  196. package/src/_modules/ai/_modules/fdp-ai/_models/fdpai-call-settings.control-model.ts +19 -19
  197. package/src/_modules/ai/_modules/fdp-ai/_models/fdpai-client-options.interface.ts +11 -11
  198. package/src/_modules/ai/_modules/fdp-ai/_models/fdpai-settings.control-model.ts +24 -24
  199. package/src/_modules/ai/_modules/fdp-ai/_models/fdpai-user-provider-config.control-model.ts +20 -20
  200. package/src/_modules/ai/_modules/fdp-ai/index.ts +11 -11
  201. package/src/_modules/ai/_modules/google-ai/_collections/gai-models.const.ts +161 -161
  202. package/src/_modules/ai/_modules/google-ai/_enums/gai-model.enum.ts +16 -16
  203. package/src/_modules/ai/_modules/google-ai/_models/gai-call-settings.control-model.spec.ts +28 -28
  204. package/src/_modules/ai/_modules/google-ai/_models/gai-call-settings.control-model.ts +21 -21
  205. package/src/_modules/ai/_modules/google-ai/_models/gai-client-options.interface.ts +8 -8
  206. package/src/_modules/ai/_modules/google-ai/_models/gai-settings.control-model.spec.ts +22 -22
  207. package/src/_modules/ai/_modules/google-ai/_models/gai-settings.control-model.ts +25 -25
  208. package/src/_modules/ai/_modules/google-ai/_models/gai-user-provider-config.control-model.ts +20 -20
  209. package/src/_modules/ai/_modules/google-ai/index.ts +14 -14
  210. package/src/_modules/ai/_modules/local-ai/_collections/lai-models.const.ts +59 -59
  211. package/src/_modules/ai/_modules/local-ai/_enums/lai-model.enum.ts +6 -6
  212. package/src/_modules/ai/_modules/local-ai/_models/lai-call-settings.control-model.spec.ts +28 -28
  213. package/src/_modules/ai/_modules/local-ai/_models/lai-call-settings.control-model.ts +18 -18
  214. package/src/_modules/ai/_modules/local-ai/_models/lai-client-options.interface.ts +9 -9
  215. package/src/_modules/ai/_modules/local-ai/_models/lai-settings.control-model.spec.ts +22 -22
  216. package/src/_modules/ai/_modules/local-ai/_models/lai-settings.control-model.ts +23 -23
  217. package/src/_modules/ai/_modules/local-ai/index.ts +14 -14
  218. package/src/_modules/ai/_modules/open-ai/_collections/oai-embedding-model-dimensions.const.ts +7 -7
  219. package/src/_modules/ai/_modules/open-ai/_collections/oai-models.const.ts +404 -404
  220. package/src/_modules/ai/_modules/open-ai/_enums/oai-model.enum.ts +179 -179
  221. package/src/_modules/ai/_modules/open-ai/_models/oai-call-settings.control-model.spec.ts +28 -28
  222. package/src/_modules/ai/_modules/open-ai/_models/oai-call-settings.control-model.ts +21 -21
  223. package/src/_modules/ai/_modules/open-ai/_models/oai-client-options.interface.ts +81 -81
  224. package/src/_modules/ai/_modules/open-ai/_models/oai-embedding-info.interface.ts +13 -13
  225. package/src/_modules/ai/_modules/open-ai/_models/oai-settings.control-model.spec.ts +22 -22
  226. package/src/_modules/ai/_modules/open-ai/_models/oai-settings.control-model.ts +25 -25
  227. package/src/_modules/ai/_modules/open-ai/_models/oai-user-provider-config.control-model.ts +21 -21
  228. package/src/_modules/ai/_modules/open-ai/index.ts +28 -28
  229. package/src/_modules/ai/index.ts +27 -27
  230. package/src/_modules/ci-tools/_enums/cit-ci-result-code.enum.ts +11 -11
  231. package/src/_modules/ci-tools/_enums/cit-ci-step-result-code.enum.ts +9 -9
  232. package/src/_modules/ci-tools/_models/cit-ci-result-info.data-models.spec.ts +58 -58
  233. package/src/_modules/ci-tools/_models/cit-ci-result-info.data-models.ts +77 -77
  234. package/src/_modules/ci-tools/_models/cit-ci-step-result.interface.ts +12 -12
  235. package/src/_modules/ci-tools/index.ts +8 -8
  236. package/src/_modules/crypto/_collections/crypto.util.simple.spec.ts +512 -512
  237. package/src/_modules/crypto/index.ts +13 -13
  238. package/src/_modules/custom-data/_collections/cud-module-settings.const.ts +21 -21
  239. package/src/_modules/custom-data/_models/cud.data-model.spec.ts +38 -38
  240. package/src/_modules/custom-data/_models/cud.data-model.ts +39 -39
  241. package/src/_modules/custom-data/index.ts +10 -10
  242. package/src/_modules/data-handler/_models/data-handler-settings.control-model.spec.ts +110 -110
  243. package/src/_modules/data-handler/_models/data-handler-settings.control-model.ts +110 -110
  244. package/src/_modules/data-handler/_models/data-handler.control-model.spec.ts +473 -473
  245. package/src/_modules/data-handler/_models/data-handler.control-model.ts +486 -486
  246. package/src/_modules/data-handler/_models/data-list-handler.control-model.spec.ts +263 -263
  247. package/src/_modules/data-handler/_models/data-list-handler.control-model.ts +252 -252
  248. package/src/_modules/data-handler/_models/data-search-handler.control-model.spec.ts +417 -417
  249. package/src/_modules/data-handler/_models/data-search-handler.control-model.ts +390 -390
  250. package/src/_modules/data-handler/_models/list-collector-data-handler.control-model.spec.ts +374 -374
  251. package/src/_modules/data-handler/_models/list-collector-data-handler.control-model.ts +274 -274
  252. package/src/_modules/data-handler/index.ts +6 -6
  253. package/src/_modules/game/_collections/audio-scale.util.spec.ts +140 -0
  254. package/src/_modules/game/_collections/audio-scale.util.ts +129 -0
  255. package/src/_modules/game/_enums/audio-channel.enum.ts +8 -4
  256. package/src/_modules/game/_models/audio-mixer-config.interface.ts +45 -0
  257. package/src/_modules/game/_models/audio-mixer-state.interface.ts +23 -0
  258. package/src/_modules/game/_models/audio-mixer.control-model.spec.ts +306 -0
  259. package/src/_modules/game/_models/audio-mixer.control-model.ts +378 -0
  260. package/src/_modules/game/_models/audio-scale.interface.ts +21 -0
  261. package/src/_modules/game/index.ts +5 -0
  262. package/src/_modules/location/_collections/assets/country-codes-ISO-3166.json +3239 -3239
  263. package/src/_modules/location/_collections/assets/country-divisions-ISO-3166-all-list.json +19035 -19035
  264. package/src/_modules/location/_collections/assets/country-divisions-ISO-3166.json +4993 -4993
  265. package/src/_modules/location/_collections/assets/country-phone-codes.json +1203 -1203
  266. package/src/_modules/location/_collections/assets/country-subdivisions/afghanistan.json +137 -137
  267. package/src/_modules/location/_collections/assets/country-subdivisions/albania.json +49 -49
  268. package/src/_modules/location/_collections/assets/country-subdivisions/algeria.json +193 -193
  269. package/src/_modules/location/_collections/assets/country-subdivisions/andorra.json +29 -29
  270. package/src/_modules/location/_collections/assets/country-subdivisions/angola.json +73 -73
  271. package/src/_modules/location/_collections/assets/country-subdivisions/antigua-and-barbuda.json +33 -33
  272. package/src/_modules/location/_collections/assets/country-subdivisions/argentina.json +97 -97
  273. package/src/_modules/location/_collections/assets/country-subdivisions/armenia.json +45 -45
  274. package/src/_modules/location/_collections/assets/country-subdivisions/australia.json +33 -33
  275. package/src/_modules/location/_collections/assets/country-subdivisions/austria.json +37 -37
  276. package/src/_modules/location/_collections/assets/country-subdivisions/azerbaijan.json +5 -5
  277. package/src/_modules/location/_collections/assets/country-subdivisions/bahamas.json +125 -125
  278. package/src/_modules/location/_collections/assets/country-subdivisions/bahrain.json +21 -21
  279. package/src/_modules/location/_collections/assets/country-subdivisions/bangladesh.json +29 -29
  280. package/src/_modules/location/_collections/assets/country-subdivisions/barbados.json +45 -45
  281. package/src/_modules/location/_collections/assets/country-subdivisions/belarus.json +29 -29
  282. package/src/_modules/location/_collections/assets/country-subdivisions/belgium.json +13 -13
  283. package/src/_modules/location/_collections/assets/country-subdivisions/belize.json +25 -25
  284. package/src/_modules/location/_collections/assets/country-subdivisions/benin.json +49 -49
  285. package/src/_modules/location/_collections/assets/country-subdivisions/bhutan.json +81 -81
  286. package/src/_modules/location/_collections/assets/country-subdivisions/bolivia.json +37 -37
  287. package/src/_modules/location/_collections/assets/country-subdivisions/bosnia-and-herzegovina.json +13 -13
  288. package/src/_modules/location/_collections/assets/country-subdivisions/botswana.json +65 -65
  289. package/src/_modules/location/_collections/assets/country-subdivisions/brazil.json +109 -109
  290. package/src/_modules/location/_collections/assets/country-subdivisions/brunei-darussalam.json +17 -17
  291. package/src/_modules/location/_collections/assets/country-subdivisions/bulgaria.json +113 -113
  292. package/src/_modules/location/_collections/assets/country-subdivisions/burkina-faso.json +53 -53
  293. package/src/_modules/location/_collections/assets/country-subdivisions/burundi.json +69 -69
  294. package/src/_modules/location/_collections/assets/country-subdivisions/cambodia.json +97 -97
  295. package/src/_modules/location/_collections/assets/country-subdivisions/cameroon.json +41 -41
  296. package/src/_modules/location/_collections/assets/country-subdivisions/canada.json +79 -79
  297. package/src/_modules/location/_collections/assets/country-subdivisions/cape-verde.json +9 -9
  298. package/src/_modules/location/_collections/assets/country-subdivisions/central-african-republic.json +69 -69
  299. package/src/_modules/location/_collections/assets/country-subdivisions/chad.json +89 -89
  300. package/src/_modules/location/_collections/assets/country-subdivisions/chile.json +61 -61
  301. package/src/_modules/location/_collections/assets/country-subdivisions/china.json +205 -205
  302. package/src/_modules/location/_collections/assets/country-subdivisions/colombia.json +133 -133
  303. package/src/_modules/location/_collections/assets/country-subdivisions/comoros.json +13 -13
  304. package/src/_modules/location/_collections/assets/country-subdivisions/congo-the-democratic-republic-of-the.json +45 -45
  305. package/src/_modules/location/_collections/assets/country-subdivisions/congo.json +49 -49
  306. package/src/_modules/location/_collections/assets/country-subdivisions/costa-rica.json +29 -29
  307. package/src/_modules/location/_collections/assets/country-subdivisions/cote-d-ivoire-republic-of.json +77 -77
  308. package/src/_modules/location/_collections/assets/country-subdivisions/croatia.json +85 -85
  309. package/src/_modules/location/_collections/assets/country-subdivisions/cuba.json +65 -65
  310. package/src/_modules/location/_collections/assets/country-subdivisions/cyprus.json +25 -25
  311. package/src/_modules/location/_collections/assets/country-subdivisions/czech-republic.json +57 -57
  312. package/src/_modules/location/_collections/assets/country-subdivisions/denmark.json +21 -21
  313. package/src/_modules/location/_collections/assets/country-subdivisions/djibouti.json +25 -25
  314. package/src/_modules/location/_collections/assets/country-subdivisions/dominica.json +41 -41
  315. package/src/_modules/location/_collections/assets/country-subdivisions/dominican-republic.json +41 -41
  316. package/src/_modules/location/_collections/assets/country-subdivisions/ecuador.json +97 -97
  317. package/src/_modules/location/_collections/assets/country-subdivisions/egypt.json +117 -117
  318. package/src/_modules/location/_collections/assets/country-subdivisions/el-salvador.json +57 -57
  319. package/src/_modules/location/_collections/assets/country-subdivisions/equatorial-guinea.json +9 -9
  320. package/src/_modules/location/_collections/assets/country-subdivisions/eritrea.json +25 -25
  321. package/src/_modules/location/_collections/assets/country-subdivisions/estonia.json +61 -61
  322. package/src/_modules/location/_collections/assets/country-subdivisions/ethiopia.json +45 -45
  323. package/src/_modules/location/_collections/assets/country-subdivisions/fiji.json +21 -21
  324. package/src/_modules/location/_collections/assets/country-subdivisions/finland.json +77 -77
  325. package/src/_modules/location/_collections/assets/country-subdivisions/france.json +133 -133
  326. package/src/_modules/location/_collections/assets/country-subdivisions/gabon.json +37 -37
  327. package/src/_modules/location/_collections/assets/country-subdivisions/gambia.json +25 -25
  328. package/src/_modules/location/_collections/assets/country-subdivisions/georgia.json +49 -49
  329. package/src/_modules/location/_collections/assets/country-subdivisions/germany.json +65 -65
  330. package/src/_modules/location/_collections/assets/country-subdivisions/ghana.json +41 -41
  331. package/src/_modules/location/_collections/assets/country-subdivisions/greece.json +53 -53
  332. package/src/_modules/location/_collections/assets/country-subdivisions/greenland.json +17 -17
  333. package/src/_modules/location/_collections/assets/country-subdivisions/grenada.json +29 -29
  334. package/src/_modules/location/_collections/assets/country-subdivisions/guatemala.json +89 -89
  335. package/src/_modules/location/_collections/assets/country-subdivisions/guinea-bissau.json +13 -13
  336. package/src/_modules/location/_collections/assets/country-subdivisions/guinea.json +33 -33
  337. package/src/_modules/location/_collections/assets/country-subdivisions/guyana.json +41 -41
  338. package/src/_modules/location/_collections/assets/country-subdivisions/haiti.json +41 -41
  339. package/src/_modules/location/_collections/assets/country-subdivisions/honduras.json +73 -73
  340. package/src/_modules/location/_collections/assets/country-subdivisions/hong-kong.json +4 -4
  341. package/src/_modules/location/_collections/assets/country-subdivisions/hungary.json +173 -173
  342. package/src/_modules/location/_collections/assets/country-subdivisions/iceland.json +37 -37
  343. package/src/_modules/location/_collections/assets/country-subdivisions/india.json +181 -181
  344. package/src/_modules/location/_collections/assets/country-subdivisions/indonesia.json +29 -29
  345. package/src/_modules/location/_collections/assets/country-subdivisions/iran-islamic-republic-of.json +125 -125
  346. package/src/_modules/location/_collections/assets/country-subdivisions/iraq.json +73 -73
  347. package/src/_modules/location/_collections/assets/country-subdivisions/ireland.json +17 -17
  348. package/src/_modules/location/_collections/assets/country-subdivisions/israel.json +25 -25
  349. package/src/_modules/location/_collections/assets/country-subdivisions/italy.json +81 -81
  350. package/src/_modules/location/_collections/assets/country-subdivisions/jamaica.json +57 -57
  351. package/src/_modules/location/_collections/assets/country-subdivisions/japan.json +189 -189
  352. package/src/_modules/location/_collections/assets/country-subdivisions/jordan.json +49 -49
  353. package/src/_modules/location/_collections/assets/country-subdivisions/kazakhstan.json +65 -65
  354. package/src/_modules/location/_collections/assets/country-subdivisions/kenya.json +33 -33
  355. package/src/_modules/location/_collections/assets/country-subdivisions/kiribati.json +13 -13
  356. package/src/_modules/location/_collections/assets/country-subdivisions/korea-democratic-people-s-republic-of.json +45 -45
  357. package/src/_modules/location/_collections/assets/country-subdivisions/korea-republic-of.json +69 -69
  358. package/src/_modules/location/_collections/assets/country-subdivisions/kuwait.json +25 -25
  359. package/src/_modules/location/_collections/assets/country-subdivisions/kyrgyzstan.json +33 -33
  360. package/src/_modules/location/_collections/assets/country-subdivisions/lao-people-s-democratic-republic.json +73 -73
  361. package/src/_modules/location/_collections/assets/country-subdivisions/latvia.json +477 -477
  362. package/src/_modules/location/_collections/assets/country-subdivisions/lebanon.json +33 -33
  363. package/src/_modules/location/_collections/assets/country-subdivisions/lesotho.json +41 -41
  364. package/src/_modules/location/_collections/assets/country-subdivisions/liberia.json +61 -61
  365. package/src/_modules/location/_collections/assets/country-subdivisions/libyan-arab-jamahiriya.json +89 -89
  366. package/src/_modules/location/_collections/assets/country-subdivisions/liechtenstein.json +45 -45
  367. package/src/_modules/location/_collections/assets/country-subdivisions/lithuania.json +41 -41
  368. package/src/_modules/location/_collections/assets/country-subdivisions/luxembourg.json +13 -13
  369. package/src/_modules/location/_collections/assets/country-subdivisions/macedonia-the-former-yugoslav-republic-of.json +337 -337
  370. package/src/_modules/location/_collections/assets/country-subdivisions/madagascar.json +25 -25
  371. package/src/_modules/location/_collections/assets/country-subdivisions/malawi.json +13 -13
  372. package/src/_modules/location/_collections/assets/country-subdivisions/malaysia.json +81 -81
  373. package/src/_modules/location/_collections/assets/country-subdivisions/maldives.json +33 -33
  374. package/src/_modules/location/_collections/assets/country-subdivisions/mali.json +37 -37
  375. package/src/_modules/location/_collections/assets/country-subdivisions/malta.json +273 -273
  376. package/src/_modules/location/_collections/assets/country-subdivisions/marshall-islands.json +9 -9
  377. package/src/_modules/location/_collections/assets/country-subdivisions/mauritania.json +53 -53
  378. package/src/_modules/location/_collections/assets/country-subdivisions/mauritius.json +69 -69
  379. package/src/_modules/location/_collections/assets/country-subdivisions/mexico.json +161 -161
  380. package/src/_modules/location/_collections/assets/country-subdivisions/micronesia-federated-states-of.json +17 -17
  381. package/src/_modules/location/_collections/assets/country-subdivisions/moldova-republic-of.json +149 -149
  382. package/src/_modules/location/_collections/assets/country-subdivisions/monaco.json +69 -69
  383. package/src/_modules/location/_collections/assets/country-subdivisions/mongolia.json +89 -89
  384. package/src/_modules/location/_collections/assets/country-subdivisions/montenegro.json +93 -93
  385. package/src/_modules/location/_collections/assets/country-subdivisions/morocco.json +65 -65
  386. package/src/_modules/location/_collections/assets/country-subdivisions/mozambique.json +45 -45
  387. package/src/_modules/location/_collections/assets/country-subdivisions/myanmar.json +57 -57
  388. package/src/_modules/location/_collections/assets/country-subdivisions/namibia.json +57 -57
  389. package/src/_modules/location/_collections/assets/country-subdivisions/nauru.json +57 -57
  390. package/src/_modules/location/_collections/assets/country-subdivisions/nepal.json +21 -21
  391. package/src/_modules/location/_collections/assets/country-subdivisions/netherlands.json +91 -91
  392. package/src/_modules/location/_collections/assets/country-subdivisions/new-zealand.json +111 -111
  393. package/src/_modules/location/_collections/assets/country-subdivisions/nicaragua.json +69 -69
  394. package/src/_modules/location/_collections/assets/country-subdivisions/niger.json +33 -33
  395. package/src/_modules/location/_collections/assets/country-subdivisions/nigeria.json +149 -149
  396. package/src/_modules/location/_collections/assets/country-subdivisions/norway.json +85 -85
  397. package/src/_modules/location/_collections/assets/country-subdivisions/oman.json +37 -37
  398. package/src/_modules/location/_collections/assets/country-subdivisions/pakistan.json +33 -33
  399. package/src/_modules/location/_collections/assets/country-subdivisions/palau.json +65 -65
  400. package/src/_modules/location/_collections/assets/country-subdivisions/palestinian-territory-occupied.json +65 -65
  401. package/src/_modules/location/_collections/assets/country-subdivisions/panama.json +53 -53
  402. package/src/_modules/location/_collections/assets/country-subdivisions/papua-new-guinea.json +81 -81
  403. package/src/_modules/location/_collections/assets/country-subdivisions/paraguay.json +73 -73
  404. package/src/_modules/location/_collections/assets/country-subdivisions/peru.json +105 -105
  405. package/src/_modules/location/_collections/assets/country-subdivisions/philippines.json +69 -69
  406. package/src/_modules/location/_collections/assets/country-subdivisions/poland.json +65 -65
  407. package/src/_modules/location/_collections/assets/country-subdivisions/portugal.json +81 -81
  408. package/src/_modules/location/_collections/assets/country-subdivisions/qatar.json +29 -29
  409. package/src/_modules/location/_collections/assets/country-subdivisions/romania.json +169 -169
  410. package/src/_modules/location/_collections/assets/country-subdivisions/russian-federation.json +499 -499
  411. package/src/_modules/location/_collections/assets/country-subdivisions/rwanda.json +21 -21
  412. package/src/_modules/location/_collections/assets/country-subdivisions/saint-helena-ascension-and-tristan-da-cunha.json +13 -13
  413. package/src/_modules/location/_collections/assets/country-subdivisions/saint-kitts-and-nevis.json +9 -9
  414. package/src/_modules/location/_collections/assets/country-subdivisions/saint-lucia.json +45 -45
  415. package/src/_modules/location/_collections/assets/country-subdivisions/saint-vincent-and-the-grenadines.json +25 -25
  416. package/src/_modules/location/_collections/assets/country-subdivisions/samoa.json +45 -45
  417. package/src/_modules/location/_collections/assets/country-subdivisions/san-marino.json +37 -37
  418. package/src/_modules/location/_collections/assets/country-subdivisions/sao-tome-and-principe.json +9 -9
  419. package/src/_modules/location/_collections/assets/country-subdivisions/saudi-arabia.json +53 -53
  420. package/src/_modules/location/_collections/assets/country-subdivisions/senegal.json +57 -57
  421. package/src/_modules/location/_collections/assets/country-subdivisions/serbia.json +9 -9
  422. package/src/_modules/location/_collections/assets/country-subdivisions/seychelles.json +101 -101
  423. package/src/_modules/location/_collections/assets/country-subdivisions/sierra-leone.json +17 -17
  424. package/src/_modules/location/_collections/assets/country-subdivisions/singapore.json +21 -21
  425. package/src/_modules/location/_collections/assets/country-subdivisions/slovakia.json +33 -33
  426. package/src/_modules/location/_collections/assets/country-subdivisions/slovenia.json +841 -841
  427. package/src/_modules/location/_collections/assets/country-subdivisions/solomon-islands.json +41 -41
  428. package/src/_modules/location/_collections/assets/country-subdivisions/somalia.json +73 -73
  429. package/src/_modules/location/_collections/assets/country-subdivisions/south-africa.json +37 -37
  430. package/src/_modules/location/_collections/assets/country-subdivisions/south-sudan.json +41 -41
  431. package/src/_modules/location/_collections/assets/country-subdivisions/spain.json +346 -346
  432. package/src/_modules/location/_collections/assets/country-subdivisions/sri-lanka.json +37 -37
  433. package/src/_modules/location/_collections/assets/country-subdivisions/sudan.json +69 -69
  434. package/src/_modules/location/_collections/assets/country-subdivisions/suriname.json +41 -41
  435. package/src/_modules/location/_collections/assets/country-subdivisions/swaziland.json +17 -17
  436. package/src/_modules/location/_collections/assets/country-subdivisions/sweden.json +85 -85
  437. package/src/_modules/location/_collections/assets/country-subdivisions/switzerland.json +105 -105
  438. package/src/_modules/location/_collections/assets/country-subdivisions/syrian-arab-republic.json +57 -57
  439. package/src/_modules/location/_collections/assets/country-subdivisions/taiwan-province-of-china.json +93 -93
  440. package/src/_modules/location/_collections/assets/country-subdivisions/tajikistan.json +17 -17
  441. package/src/_modules/location/_collections/assets/country-subdivisions/tanzania-united-republic-of.json +105 -105
  442. package/src/_modules/location/_collections/assets/country-subdivisions/thailand.json +313 -313
  443. package/src/_modules/location/_collections/assets/country-subdivisions/timor-leste.json +53 -53
  444. package/src/_modules/location/_collections/assets/country-subdivisions/togo.json +21 -21
  445. package/src/_modules/location/_collections/assets/country-subdivisions/tonga.json +21 -21
  446. package/src/_modules/location/_collections/assets/country-subdivisions/trinidad-and-tobago.json +65 -65
  447. package/src/_modules/location/_collections/assets/country-subdivisions/tunisia.json +97 -97
  448. package/src/_modules/location/_collections/assets/country-subdivisions/turkey.json +325 -325
  449. package/src/_modules/location/_collections/assets/country-subdivisions/turkmenistan.json +25 -25
  450. package/src/_modules/location/_collections/assets/country-subdivisions/tuvalu.json +33 -33
  451. package/src/_modules/location/_collections/assets/country-subdivisions/uganda.json +17 -17
  452. package/src/_modules/location/_collections/assets/country-subdivisions/ukraine.json +109 -109
  453. package/src/_modules/location/_collections/assets/country-subdivisions/united-arab-emirates.json +29 -29
  454. package/src/_modules/location/_collections/assets/country-subdivisions/united-kingdom.json +1196 -1196
  455. package/src/_modules/location/_collections/assets/country-subdivisions/united-states-minor-outlying-islands.json +37 -37
  456. package/src/_modules/location/_collections/assets/country-subdivisions/united-states.json +286 -286
  457. package/src/_modules/location/_collections/assets/country-subdivisions/uruguay.json +77 -77
  458. package/src/_modules/location/_collections/assets/country-subdivisions/uzbekistan.json +57 -57
  459. package/src/_modules/location/_collections/assets/country-subdivisions/vanuatu.json +25 -25
  460. package/src/_modules/location/_collections/assets/country-subdivisions/venezuela.json +101 -101
  461. package/src/_modules/location/_collections/assets/country-subdivisions/viet-nam.json +257 -257
  462. package/src/_modules/location/_collections/assets/country-subdivisions/yemen.json +85 -85
  463. package/src/_modules/location/_collections/assets/country-subdivisions/zambia.json +37 -37
  464. package/src/_modules/location/_collections/assets/country-subdivisions/zimbabwe.json +41 -41
  465. package/src/_modules/location/_collections/loc-country-divisions.const.ts +10 -10
  466. package/src/_modules/location/_collections/loc-country-isos.const.ts +8 -8
  467. package/src/_modules/location/_collections/loc-regions.util.spec.ts +61 -61
  468. package/src/_modules/location/_collections/loc-regions.util.ts +137 -137
  469. package/src/_modules/location/_collections/loc.util.spec.ts +52 -52
  470. package/src/_modules/location/_collections/loc.util.ts +74 -74
  471. package/src/_modules/location/_enums/loc-region.enum.ts +14 -14
  472. package/src/_modules/location/_enums/loc-sub-region.enum.ts +31 -31
  473. package/src/_modules/location/_enums/loc-subdivision-region-type.enum.ts +47 -47
  474. package/src/_modules/location/_models/loc-coordinates.interface.ts +7 -7
  475. package/src/_modules/location/_models/loc-country-division.interface.ts +8 -8
  476. package/src/_modules/location/_models/loc-country-iso.interface.ts +23 -23
  477. package/src/_modules/location/_models/loc-country-phone-code.interface.ts +9 -9
  478. package/src/_modules/location/_models/loc-division-collection.interface.ts +12 -12
  479. package/src/_modules/location/_models/loc-division-region-data.interface.ts +9 -9
  480. package/src/_modules/location/_models/loc-geo-ip-location.interface.ts +27 -27
  481. package/src/_modules/location/index.ts +22 -22
  482. package/src/_modules/messaging/README.md +279 -279
  483. package/src/_modules/messaging/_collections/msg-module-settings.const.ts +46 -46
  484. package/src/_modules/messaging/_enums/msg-attachment-type.enum.ts +26 -26
  485. package/src/_modules/messaging/_enums/msg-delivery-status.enum.ts +17 -17
  486. package/src/_modules/messaging/_enums/msg-event-key.enum.ts +31 -31
  487. package/src/_modules/messaging/_enums/msg-participant-role.enum.ts +20 -20
  488. package/src/_modules/messaging/_enums/msg-provider-type.enum.ts +7 -7
  489. package/src/_modules/messaging/_enums/msg-type.enum.ts +23 -23
  490. package/src/_modules/messaging/_models/msg-attachment.interface.ts +46 -46
  491. package/src/_modules/messaging/_models/msg-conversation.data-model.spec.ts +69 -69
  492. package/src/_modules/messaging/_models/msg-conversation.data-model.ts +96 -96
  493. package/src/_modules/messaging/_models/msg-mention.interface.ts +29 -29
  494. package/src/_modules/messaging/_models/msg-message.data-model.spec.ts +79 -79
  495. package/src/_modules/messaging/_models/msg-message.data-model.ts +127 -127
  496. package/src/_modules/messaging/_models/msg-participant.interface.ts +46 -46
  497. package/src/_modules/messaging/_models/msg-reaction.interface.ts +20 -20
  498. package/src/_modules/messaging/_models/msg-thread-info.interface.ts +35 -35
  499. package/src/_modules/messaging/_modules/agent/_enums/agt-process-step-type.enum.ts +35 -35
  500. package/src/_modules/messaging/_modules/agent/_enums/agt-tool-status.enum.ts +23 -23
  501. package/src/_modules/messaging/_modules/agent/_models/agt-process-step.interface.ts +55 -55
  502. package/src/_modules/messaging/_modules/agent/_models/agt-reasoning-info.interface.ts +26 -26
  503. package/src/_modules/messaging/_modules/agent/_models/agt-tool-usage.interface.ts +37 -37
  504. package/src/_modules/messaging/_modules/agent/index.ts +8 -8
  505. package/src/_modules/messaging/index.ts +28 -28
  506. package/src/_modules/pipe/_collections/pip-transforms.const.ts +42 -42
  507. package/src/_modules/pipe/_collections/utils/pip-country-pipe.util.spec.ts +47 -47
  508. package/src/_modules/pipe/_collections/utils/pip-country-pipe.util.ts +41 -41
  509. package/src/_modules/pipe/_collections/utils/pip-custom-pipe.util.spec.ts +39 -39
  510. package/src/_modules/pipe/_collections/utils/pip-custom-pipe.util.ts +30 -30
  511. package/src/_modules/pipe/_collections/utils/pip-division-pipe.util.spec.ts +41 -41
  512. package/src/_modules/pipe/_collections/utils/pip-division-pipe.util.ts +36 -36
  513. package/src/_modules/pipe/_collections/utils/pip-json-pipe.util.spec.ts +62 -62
  514. package/src/_modules/pipe/_collections/utils/pip-json-pipe.util.ts +17 -17
  515. package/src/_modules/pipe/_collections/utils/pip-list-pipe.util.spec.ts +34 -34
  516. package/src/_modules/pipe/_collections/utils/pip-list-pipe.util.ts +25 -25
  517. package/src/_modules/pipe/_collections/utils/pip-multi-pipe-pipe.util.spec.ts +67 -67
  518. package/src/_modules/pipe/_collections/utils/pip-multi-pipe-pipe.util.ts +226 -226
  519. package/src/_modules/pipe/_collections/utils/pip-obj-key-pipe.util.spec.ts +28 -28
  520. package/src/_modules/pipe/_collections/utils/pip-obj-key-pipe.util.ts +21 -21
  521. package/src/_modules/pipe/_collections/utils/pip-range-pipe.util.spec.ts +59 -59
  522. package/src/_modules/pipe/_collections/utils/pip-range-pipe.util.ts +106 -106
  523. package/src/_modules/pipe/_collections/utils/pip-region-pipe.util.spec.ts +31 -31
  524. package/src/_modules/pipe/_collections/utils/pip-region-pipe.util.ts +35 -35
  525. package/src/_modules/pipe/_collections/utils/pip-replace-pipe.util.spec.ts +44 -44
  526. package/src/_modules/pipe/_collections/utils/pip-replace-pipe.util.ts +23 -23
  527. package/src/_modules/pipe/_collections/utils/pip-slider-pipe.util.spec.ts +21 -21
  528. package/src/_modules/pipe/_collections/utils/pip-slider-pipe.util.ts +33 -33
  529. package/src/_modules/pipe/_collections/utils/pip-smart-replace-pipe.util.spec.ts +62 -62
  530. package/src/_modules/pipe/_collections/utils/pip-smart-replace-pipe.util.ts +80 -80
  531. package/src/_modules/pipe/_enums/pip-range-pipe-setting.enum.ts +15 -15
  532. package/src/_modules/pipe/_enums/pip.enum.ts +65 -65
  533. package/src/_modules/pipe/_models/pip-multi-pipe-settings.type.ts +8 -8
  534. package/src/_modules/pipe/_models/pip-transforms.interface.ts +30 -30
  535. package/src/_modules/pipe/index.ts +30 -30
  536. package/src/_modules/socket/_enums/sck-event-key.enum.ts +21 -21
  537. package/src/_modules/socket/_models/sck-client-params.control-model.spec.ts +67 -67
  538. package/src/_modules/socket/_models/sck-client-params.control-model.ts +50 -50
  539. package/src/_modules/socket/_models/sck-socket-event.control-model.spec.ts +66 -66
  540. package/src/_modules/socket/_models/sck-socket-event.control-model.ts +172 -172
  541. package/src/_modules/socket/_services/sck-client.service-base.spec.ts +99 -99
  542. package/src/_modules/socket/_services/sck-client.service-base.ts +353 -353
  543. package/src/_modules/socket/index.ts +14 -14
  544. package/src/_modules/test/_collections/tst-module-settings.const.ts +67 -67
  545. package/src/_modules/test/index.ts +5 -5
  546. package/src/_modules/usage/_collections/usg-module-settings.const.ts +33 -33
  547. package/src/_modules/usage/_models/usg-action.control-model.spec.ts +27 -27
  548. package/src/_modules/usage/_models/usg-action.control-model.ts +28 -28
  549. package/src/_modules/usage/_models/usg-daily-usage-data.control-model.spec.ts +36 -36
  550. package/src/_modules/usage/_models/usg-daily-usage-data.control-model.ts +35 -35
  551. package/src/_modules/usage/_models/usg-data.control-model.spec.ts +41 -41
  552. package/src/_modules/usage/_models/usg-data.control-model.ts +35 -35
  553. package/src/_modules/usage/_models/usg-session.data-model.spec.ts +97 -97
  554. package/src/_modules/usage/_models/usg-session.data-model.ts +72 -72
  555. package/src/_modules/usage/index.ts +11 -11
  556. package/src/index.ts +104 -104
  557. package/tsconfig.app.json +12 -12
  558. package/tsconfig.json +31 -31
  559. package/tsconfig.test.json +16 -16
  560. package/tslint.json +153 -153
@@ -1,975 +1,975 @@
1
-
2
- import { DyFM_String } from './string.util';
3
-
4
- describe('| DyFM_String', () => {
5
- describe('| breakTrim', () => {
6
- it('| should remove spaces from the start and end of the string', () => {
7
- const result = DyFM_String.breakTrim(' hello world ');
8
- expect(result).toBe('hello world');
9
- });
10
-
11
- it('| should remove newline characters from the start and end of the string', () => {
12
- const result = DyFM_String.breakTrim('\nhello world\n');
13
- expect(result).toBe('hello world');
14
- });
15
-
16
- it('| should remove carriage return characters from the start and end of the string', () => {
17
- const result = DyFM_String.breakTrim('\rhello world\r');
18
- expect(result).toBe('hello world');
19
- });
20
-
21
- it('| should remove all types of line breaks from the start and end of the string', () => {
22
- const result = DyFM_String.breakTrim('\r\nhello world\r\n');
23
- expect(result).toBe('hello world');
24
- });
25
-
26
- it('| should return an empty string if the input is only spaces and line breaks', () => {
27
- const result = DyFM_String.breakTrim(' \r\n ');
28
- expect(result).toBe('');
29
- });
30
-
31
- it('| should not alter a string that has no spaces or line breaks at the start or end', () => {
32
- const result = DyFM_String.breakTrim('hello world');
33
- expect(result).toBe('hello world');
34
- });
35
-
36
- it('| should handle an empty string input', () => {
37
- const result = DyFM_String.breakTrim('');
38
- expect(result).toBe('');
39
- });
40
- });
41
-
42
- describe('| nestedBracketSplit', () => {
43
- it('| should handle simple bracket extraction with replacement', () => {
44
- const input = 'hello (world) test';
45
- const result = DyFM_String.nestedBracketSplit(input, '(', ')', 10, '...');
46
- expect(result).toEqual(['hello ... test', 'world']);
47
- });
48
-
49
- it('| should handle multiple brackets at the same level', () => {
50
- const input = 'start (first) middle (second) end';
51
- const result = DyFM_String.nestedBracketSplit(input, '(', ')', 10, '...');
52
- expect(result).toEqual(['start ... middle ... end', 'first', 'second']);
53
- });
54
-
55
- it('| should handle nested brackets according to the example', () => {
56
- const input = 'asdasd (and other things) around (and layered things (and more layers) around) around';
57
- const result = DyFM_String.nestedBracketSplit(input, '(', ')', 2, '...');
58
- expect(result).toEqual([
59
- 'asdasd ... around ... around',
60
- 'and other things',
61
- 'and layered things ... around',
62
- 'and more layers'
63
- ]);
64
- });
65
-
66
- it('| should respect maxDepth parameter', () => {
67
- const input = 'text (level1 (level2 (level3) level2) level1) text';
68
- const result = DyFM_String.nestedBracketSplit(input, '(', ')', 1, '...');
69
- expect(result).toEqual([
70
- 'text ... text',
71
- 'level1 (level2 (level3) level2) level1'
72
- ]);
73
- });
74
-
75
- it('| should handle empty replacement string', () => {
76
- const input = 'hello (world) test';
77
- const result = DyFM_String.nestedBracketSplit(input, '(', ')', 10, '');
78
- expect(result).toEqual(['hello test', 'world']);
79
- });
80
-
81
- it('| should handle string with no brackets', () => {
82
- const input = 'hello world test';
83
- const result = DyFM_String.nestedBracketSplit(input, '(', ')', 10, '...');
84
- expect(result).toEqual(['hello world test']);
85
- });
86
-
87
- it('| should handle empty string', () => {
88
- const input = '';
89
- const result = DyFM_String.nestedBracketSplit(input, '(', ')', 10, '...');
90
- expect(result).toEqual(['']);
91
- });
92
-
93
- it('| should handle unmatched opening bracket', () => {
94
- const input = 'hello (world test';
95
- const result = DyFM_String.nestedBracketSplit(input, '(', ')', 10, '...');
96
- expect(result).toEqual(['hello (world test']);
97
- });
98
-
99
- it('| should handle unmatched closing bracket', () => {
100
- const input = 'hello world) test';
101
- const result = DyFM_String.nestedBracketSplit(input, '(', ')', 10, '...');
102
- expect(result).toEqual(['hello world) test']);
103
- });
104
-
105
- it('| should handle custom bracket characters', () => {
106
- const input = 'start [first] middle [second] end';
107
- const result = DyFM_String.nestedBracketSplit(input, '[', ']', 10, '...');
108
- expect(result).toEqual(['start ... middle ... end', 'first', 'second']);
109
- });
110
-
111
- it('| should handle multi-character brackets', () => {
112
- const input = 'start {{first}} middle {{second}} end';
113
- const result = DyFM_String.nestedBracketSplit(input, '{{', '}}', 10, '...');
114
- expect(result).toEqual(['start ... middle ... end', 'first', 'second']);
115
- });
116
-
117
- it('| should handle deeply nested brackets with maxDepth', () => {
118
- const input = 'text (a (b (c (d) c) b) a) text';
119
- const result = DyFM_String.nestedBracketSplit(input, '(', ')', 3, '...');
120
- expect(result).toEqual([
121
- 'text ... text',
122
- 'a ... a',
123
- 'b ... b',
124
- 'c (d) c'
125
- ]);
126
- });
127
-
128
- it('| should handle same character for opening and closing bracket', () => {
129
- const input = "start 'first quote' middle 'second quote' end";
130
- const result = DyFM_String.nestedBracketSplit(input, "'", "'", 10, '...');
131
- expect(result).toEqual(["start ... middle ... end", 'first quote', 'second quote']);
132
- });
133
-
134
- it('| should handle nested same character brackets', () => {
135
- const input = "text 'outer 'inner' outer' text";
136
- const result = DyFM_String.nestedBracketSplit(input, "'", "'", 2, '...');
137
- expect(result).toEqual([
138
- 'text ... text',
139
- 'outer ... outer',
140
- 'inner'
141
- ]);
142
- });
143
-
144
- it('| should handle multiple levels of same character brackets', () => {
145
- const input = "start 'level1 'level2 'level3' level2' level1' end";
146
- const result = DyFM_String.nestedBracketSplit(input, "'", "'", 3, '...');
147
- expect(result).toEqual([
148
- 'start ... end',
149
- 'level1 ... level1',
150
- 'level2 ... level2',
151
- 'level3'
152
- ]);
153
- });
154
-
155
- it('| should handle empty content between same character brackets', () => {
156
- const input = "text '' more text";
157
- const result = DyFM_String.nestedBracketSplit(input, "'", "'", 10, '...');
158
- expect(result).toEqual(['text ... more text', '']);
159
- });
160
-
161
- it('| should handle single same character bracket (unmatched)', () => {
162
- const input = "text 'unmatched quote";
163
- const result = DyFM_String.nestedBracketSplit(input, "'", "'", 10, '...');
164
- expect(result).toEqual(["text 'unmatched quote"]);
165
- });
166
-
167
- it('| should handle alternating same character brackets', () => {
168
- const input = "text 'first' normal 'second' normal 'third' text";
169
- const result = DyFM_String.nestedBracketSplit(input, "'", "'", 10, '...');
170
- expect(result).toEqual(['text ... normal ... normal ... text', 'first', 'second', 'third']);
171
- });
172
-
173
- it('| should respect maxDepth with same character brackets', () => {
174
- const input = "text 'a 'b 'c' b' a' text";
175
- const result = DyFM_String.nestedBracketSplit(input, "'", "'", 1, '...');
176
- expect(result).toEqual([
177
- 'text ... text',
178
- "a 'b 'c' b' a"
179
- ]);
180
- });
181
- });
182
-
183
- describe('| nestedBracketSplit - replaceContents variations', () => {
184
- it('| should handle empty replaceContents (no replacement)', () => {
185
- const input = 'hello (world) test';
186
- const result = DyFM_String.nestedBracketSplit(input, '(', ')', 10, '');
187
- expect(result).toEqual(['hello test', 'world']);
188
- });
189
-
190
- it('| should handle undefined replaceContents (no replacement)', () => {
191
- const input = 'hello (world) test';
192
- const result = DyFM_String.nestedBracketSplit(input, '(', ')', 10);
193
- expect(result).toEqual(['hello (world) test', 'world']);
194
- });
195
-
196
- it('| should handle multiple brackets with empty replaceContents', () => {
197
- const input = 'start (first) middle (second) end';
198
- const result = DyFM_String.nestedBracketSplit(input, '(', ')', 10, '');
199
- expect(result).toEqual(['start middle end', 'first', 'second']);
200
- });
201
-
202
- it('| should handle nested brackets with empty replaceContents', () => {
203
- const input = 'text (outer (inner) outer) text';
204
- const result = DyFM_String.nestedBracketSplit(input, '(', ')', 2, '');
205
- expect(result).toEqual(['text text', 'outer outer', 'inner']);
206
- });
207
- });
208
-
209
- describe('| nestedBracketSplitDetailed', () => {
210
- it('| should return detailed information for simple nested brackets', () => {
211
- const input = 'hello (world) test';
212
- const result = DyFM_String.nestedBracketSplitDetailed(input, '(', ')', 10, '...');
213
- expect(result).toEqual([
214
- { content: 'hello ... test', level: 0, brackets: null },
215
- { content: 'world', level: 1, brackets: { opening: '(', closing: ')' } }
216
- ]);
217
- });
218
-
219
- it('| should handle nested brackets with detailed level information', () => {
220
- const input = 'asdasd (and other things) around (and layered things (and more layers) around) around';
221
- const result = DyFM_String.nestedBracketSplitDetailed(input, '(', ')', 2, '...');
222
- expect(result).toEqual([
223
- { content: 'asdasd ... around ... around', level: 0, brackets: null },
224
- { content: 'and other things', level: 1, brackets: { opening: '(', closing: ')' } },
225
- { content: 'and layered things ... around', level: 1, brackets: { opening: '(', closing: ')' } },
226
- { content: 'and more layers', level: 2, brackets: { opening: '(', closing: ')' } }
227
- ]);
228
- });
229
-
230
- it('| should handle same character brackets with detailed info', () => {
231
- const input = "text 'quoted content' end";
232
- const result = DyFM_String.nestedBracketSplitDetailed(input, "'", "'", 10, '...');
233
- expect(result).toEqual([
234
- { content: 'text ... end', level: 0, brackets: null },
235
- { content: 'quoted content', level: 1, brackets: { opening: "'", closing: "'" } }
236
- ]);
237
- });
238
-
239
- it('| should respect maxDepth with detailed levels', () => {
240
- const input = 'text (a (b (c) b) a) text';
241
- const result = DyFM_String.nestedBracketSplitDetailed(input, '(', ')', 2, '...');
242
- expect(result).toEqual([
243
- { content: 'text ... text', level: 0, brackets: null },
244
- { content: 'a ... a', level: 1, brackets: { opening: '(', closing: ')' } },
245
- { content: 'b (c) b', level: 2, brackets: { opening: '(', closing: ')' } }
246
- ]);
247
- });
248
-
249
- it('| should handle no brackets case', () => {
250
- const input = 'plain text with no brackets';
251
- const result = DyFM_String.nestedBracketSplitDetailed(input, '(', ')', 10, '...');
252
- expect(result).toEqual([
253
- { content: 'plain text with no brackets', level: 0, brackets: null }
254
- ]);
255
- });
256
-
257
- it('| should handle empty replaceContents (no replacement)', () => {
258
- const input = 'hello (world) test';
259
- const result = DyFM_String.nestedBracketSplitDetailed(input, '(', ')', 10, '');
260
- expect(result).toEqual([
261
- { content: 'hello test', level: 0, brackets: null },
262
- { content: 'world', level: 1, brackets: { opening: '(', closing: ')' } }
263
- ]);
264
- });
265
-
266
- it('| should handle undefined replaceContents (no replacement)', () => {
267
- const input = 'hello (world) test';
268
- const result = DyFM_String.nestedBracketSplitDetailed(input, '(', ')', 10);
269
- expect(result).toEqual([
270
- { content: 'hello (world) test', level: 0, brackets: null },
271
- { content: 'world', level: 1, brackets: { opening: '(', closing: ')' } }
272
- ]);
273
- });
274
-
275
- it('| should handle nested brackets with empty replaceContents', () => {
276
- const input = 'text (outer (inner) outer) text';
277
- const result = DyFM_String.nestedBracketSplitDetailed(input, '(', ')', 2, '');
278
- expect(result).toEqual([
279
- { content: 'text text', level: 0, brackets: null },
280
- { content: 'outer outer', level: 1, brackets: { opening: '(', closing: ')' } },
281
- { content: 'inner', level: 2, brackets: { opening: '(', closing: ')' } }
282
- ]);
283
- });
284
- });
285
-
286
- describe('| multiBracketSplit', () => {
287
- const standardBrackets = [
288
- { opening: '(', closing: ')' },
289
- { opening: '[', closing: ']' },
290
- { opening: '{', closing: '}' }
291
- ];
292
-
293
- it('| should handle multiple bracket types at the same level', () => {
294
- const input = 'text (round) and [square] with {curly} brackets';
295
- const result = DyFM_String.multiBracketSplit(input, standardBrackets, 10, '...');
296
- expect(result).toEqual([
297
- 'text ... and ... with ... brackets',
298
- 'round',
299
- 'square',
300
- 'curly'
301
- ]);
302
- });
303
-
304
- it('| should handle mixed nested brackets according to the example', () => {
305
- const input = 'text (round) and [square] with {curly (nested)} brackets';
306
- const result = DyFM_String.multiBracketSplit(input, standardBrackets, 2, '...');
307
- expect(result).toEqual([
308
- 'text ... and ... with ... brackets',
309
- 'round',
310
- 'square',
311
- 'curly ...',
312
- 'nested'
313
- ]);
314
- });
315
-
316
- it('| should handle deeply nested mixed brackets', () => {
317
- const input = 'start {outer [middle (inner) middle] outer} end';
318
- const result = DyFM_String.multiBracketSplit(input, standardBrackets, 3, '...');
319
- expect(result).toEqual([
320
- 'start ... end',
321
- 'outer ... outer',
322
- 'middle ... middle',
323
- 'inner'
324
- ]);
325
- });
326
-
327
- it('| should respect maxDepth with mixed brackets', () => {
328
- const input = 'text {a [b (c) b] a} text';
329
- const result = DyFM_String.multiBracketSplit(input, standardBrackets, 1, '...');
330
- expect(result).toEqual([
331
- 'text ... text',
332
- 'a [b (c) b] a'
333
- ]);
334
- });
335
-
336
- it('| should handle empty bracket contents', () => {
337
- const input = 'text () and [] with {} brackets';
338
- const result = DyFM_String.multiBracketSplit(input, standardBrackets, 10, '...');
339
- expect(result).toEqual([
340
- 'text ... and ... with ... brackets',
341
- '',
342
- '',
343
- ''
344
- ]);
345
- });
346
-
347
- it('| should handle unmatched brackets gracefully', () => {
348
- const input = 'text (unmatched and [incomplete';
349
- const result = DyFM_String.multiBracketSplit(input, standardBrackets, 10, '...');
350
- expect(result).toEqual(['text (unmatched and [incomplete']);
351
- });
352
-
353
- it('| should handle same character brackets in the array', () => {
354
- const quoteBrackets = [
355
- { opening: "'", closing: "'" },
356
- { opening: '"', closing: '"' }
357
- ];
358
- const input = "text 'single quoted' and \"double quoted\" content";
359
- const result = DyFM_String.multiBracketSplit(input, quoteBrackets, 10, '...');
360
- expect(result).toEqual([
361
- 'text ... and ... content',
362
- 'single quoted',
363
- 'double quoted'
364
- ]);
365
- });
366
-
367
- it('| should handle multi-character brackets', () => {
368
- const customBrackets = [
369
- { opening: '{{', closing: '}}' },
370
- { opening: '[[', closing: ']]' },
371
- { opening: '()', closing: ')(' }
372
- ];
373
- const input = 'text {{double curly}} and [[double square]] with ()reversed)( brackets';
374
- const result = DyFM_String.multiBracketSplit(input, customBrackets, 10, '...');
375
- expect(result).toEqual([
376
- 'text ... and ... with ... brackets',
377
- 'double curly',
378
- 'double square',
379
- 'reversed'
380
- ]);
381
- });
382
-
383
- it('| should handle complex nesting with different bracket types', () => {
384
- const input = 'start (round [square {curly [inner]} square] round) end';
385
- const result = DyFM_String.multiBracketSplit(input, standardBrackets, 4, '...');
386
- expect(result).toEqual([
387
- 'start ... end',
388
- 'round ... round',
389
- 'square ... square',
390
- 'curly ...',
391
- 'inner'
392
- ]);
393
- });
394
-
395
- it('| should handle no brackets', () => {
396
- const input = 'plain text with no brackets';
397
- const result = DyFM_String.multiBracketSplit(input, standardBrackets, 10, '...');
398
- expect(result).toEqual(['plain text with no brackets']);
399
- });
400
-
401
- it('| should handle empty string', () => {
402
- const input = '';
403
- const result = DyFM_String.multiBracketSplit(input, standardBrackets, 10, '...');
404
- expect(result).toEqual(['']);
405
- });
406
-
407
- it('| should handle empty brackets array', () => {
408
- const input = 'text (with) brackets [but] no {bracket} definitions';
409
- const result = DyFM_String.multiBracketSplit(input, [], 10, '...');
410
- expect(result).toEqual(['text (with) brackets [but] no {bracket} definitions']);
411
- });
412
-
413
- it('| should handle overlapping bracket patterns', () => {
414
- const overlappingBrackets = [
415
- { opening: '(', closing: ')' },
416
- { opening: '((', closing: '))' }
417
- ];
418
- const input = 'text ((double)) and (single) brackets';
419
- const result = DyFM_String.multiBracketSplit(input, overlappingBrackets, 10, '...');
420
- expect(result).toEqual([
421
- 'text ... and ... brackets',
422
- 'double',
423
- 'single'
424
- ]);
425
- });
426
-
427
- it('| should handle brackets with same opening but different closing', () => {
428
- const mixedBrackets = [
429
- { opening: '<', closing: '>' },
430
- { opening: '<', closing: '/>' }
431
- ];
432
- const input = 'text <tag/> and <content> here';
433
- const result = DyFM_String.multiBracketSplit(input, mixedBrackets, 10, '...');
434
- expect(result).toEqual([
435
- 'text ... and ... here',
436
- 'tag',
437
- 'content'
438
- ]);
439
- });
440
-
441
- it('| should maintain proper bracket matching with mixed types', () => {
442
- const input = 'text (round [square) wrong] correct';
443
- const result = DyFM_String.multiBracketSplit(input, standardBrackets, 10, '...');
444
- expect(result).toEqual([
445
- 'text ... wrong] correct',
446
- 'round [square'
447
- ]);
448
- });
449
- });
450
-
451
- describe('| multiBracketSplit - replaceContents variations', () => {
452
- const standardBrackets = [
453
- { opening: '(', closing: ')' },
454
- { opening: '[', closing: ']' },
455
- { opening: '{', closing: '}' }
456
- ];
457
-
458
- it('| should handle empty replaceContents (no replacement)', () => {
459
- const input = 'text (round) and [square] with {curly} brackets';
460
- const result = DyFM_String.multiBracketSplit(input, standardBrackets, 10, '');
461
- expect(result).toEqual([
462
- 'text and with brackets',
463
- 'round',
464
- 'square',
465
- 'curly'
466
- ]);
467
- });
468
-
469
- it('| should handle undefined replaceContents (no replacement)', () => {
470
- const input = 'text (round) and [square] with {curly} brackets';
471
- const result = DyFM_String.multiBracketSplit(input, standardBrackets, 10);
472
- expect(result).toEqual([
473
- 'text (round) and [square] with {curly} brackets',
474
- 'round',
475
- 'square',
476
- 'curly'
477
- ]);
478
- });
479
-
480
- it('| should handle nested brackets with empty replaceContents', () => {
481
- const input = 'text (round) and [square] with {curly (nested)} brackets';
482
- const result = DyFM_String.multiBracketSplit(input, standardBrackets, 2, '');
483
- expect(result).toEqual([
484
- 'text and with brackets',
485
- 'round',
486
- 'square',
487
- 'curly ',
488
- 'nested'
489
- ]);
490
- });
491
- });
492
-
493
- describe('| multiBracketSplitDetailed', () => {
494
- const standardBrackets = [
495
- { opening: '(', closing: ')' },
496
- { opening: '[', closing: ']' },
497
- { opening: '{', closing: '}' }
498
- ];
499
-
500
- it('| should return detailed information for simple bracket extraction', () => {
501
- const input = 'text (round) end';
502
- const result = DyFM_String.multiBracketSplitDetailed(input, standardBrackets, 10, '...');
503
- expect(result).toEqual([
504
- { content: 'text ... end', level: 0, brackets: null },
505
- { content: 'round', level: 1, brackets: { opening: '(', closing: ')' } }
506
- ]);
507
- });
508
-
509
- it('| should handle multiple bracket types with detailed info', () => {
510
- const input = 'text (round) and [square] with {curly} brackets';
511
- const result = DyFM_String.multiBracketSplitDetailed(input, standardBrackets, 10, '...');
512
- expect(result).toEqual([
513
- { content: 'text ... and ... with ... brackets', level: 0, brackets: null },
514
- { content: 'round', level: 1, brackets: { opening: '(', closing: ')' } },
515
- { content: 'square', level: 1, brackets: { opening: '[', closing: ']' } },
516
- { content: 'curly', level: 1, brackets: { opening: '{', closing: '}' } }
517
- ]);
518
- });
519
-
520
- it('| should handle nested brackets with detailed level information', () => {
521
- const input = 'text (round) and [square] with {curly (nested)} brackets';
522
- const result = DyFM_String.multiBracketSplitDetailed(input, standardBrackets, 2, '...');
523
- expect(result).toEqual([
524
- { content: 'text ... and ... with ... brackets', level: 0, brackets: null },
525
- { content: 'round', level: 1, brackets: { opening: '(', closing: ')' } },
526
- { content: 'square', level: 1, brackets: { opening: '[', closing: ']' } },
527
- { content: 'curly ...', level: 1, brackets: { opening: '{', closing: '}' } },
528
- { content: 'nested', level: 2, brackets: { opening: '(', closing: ')' } }
529
- ]);
530
- });
531
-
532
- it('| should handle deeply nested brackets with correct levels', () => {
533
- const input = 'start {outer [middle (inner) middle] outer} end';
534
- const result = DyFM_String.multiBracketSplitDetailed(input, standardBrackets, 3, '...');
535
- expect(result).toEqual([
536
- { content: 'start ... end', level: 0, brackets: null },
537
- { content: 'outer ... outer', level: 1, brackets: { opening: '{', closing: '}' } },
538
- { content: 'middle ... middle', level: 2, brackets: { opening: '[', closing: ']' } },
539
- { content: 'inner', level: 3, brackets: { opening: '(', closing: ')' } }
540
- ]);
541
- });
542
-
543
- it('| should respect maxDepth and show correct levels', () => {
544
- const input = 'text {a [b (c) b] a} text';
545
- const result = DyFM_String.multiBracketSplitDetailed(input, standardBrackets, 2, '...');
546
- expect(result).toEqual([
547
- { content: 'text ... text', level: 0, brackets: null },
548
- { content: 'a ... a', level: 1, brackets: { opening: '{', closing: '}' } },
549
- { content: 'b (c) b', level: 2, brackets: { opening: '[', closing: ']' } }
550
- ]);
551
- });
552
-
553
- it('| should handle empty brackets with detailed info', () => {
554
- const input = 'text () and [] with {} brackets';
555
- const result = DyFM_String.multiBracketSplitDetailed(input, standardBrackets, 10, '...');
556
- expect(result).toEqual([
557
- { content: 'text ... and ... with ... brackets', level: 0, brackets: null },
558
- { content: '', level: 1, brackets: { opening: '(', closing: ')' } },
559
- { content: '', level: 1, brackets: { opening: '[', closing: ']' } },
560
- { content: '', level: 1, brackets: { opening: '{', closing: '}' } }
561
- ]);
562
- });
563
-
564
- it('| should handle custom bracket types with detailed info', () => {
565
- const customBrackets = [
566
- { opening: '{{', closing: '}}' },
567
- { opening: '[[', closing: ']]' }
568
- ];
569
- const input = 'text {{double curly}} and [[double square]] content';
570
- const result = DyFM_String.multiBracketSplitDetailed(input, customBrackets, 10, '...');
571
- expect(result).toEqual([
572
- { content: 'text ... and ... content', level: 0, brackets: null },
573
- { content: 'double curly', level: 1, brackets: { opening: '{{', closing: '}}' } },
574
- { content: 'double square', level: 1, brackets: { opening: '[[', closing: ']]' } }
575
- ]);
576
- });
577
-
578
- it('| should handle same character brackets with detailed info', () => {
579
- const quoteBrackets = [
580
- { opening: "'", closing: "'" },
581
- { opening: '"', closing: '"' }
582
- ];
583
- const input = "text 'single quoted' and \"double quoted\" content";
584
- const result = DyFM_String.multiBracketSplitDetailed(input, quoteBrackets, 10, '...');
585
- expect(result).toEqual([
586
- { content: 'text ... and ... content', level: 0, brackets: null },
587
- { content: 'single quoted', level: 1, brackets: { opening: "'", closing: "'" } },
588
- { content: 'double quoted', level: 1, brackets: { opening: '"', closing: '"' } }
589
- ]);
590
- });
591
-
592
- it('| should handle no brackets case', () => {
593
- const input = 'plain text with no brackets';
594
- const result = DyFM_String.multiBracketSplitDetailed(input, standardBrackets, 10, '...');
595
- expect(result).toEqual([
596
- { content: 'plain text with no brackets', level: 0, brackets: null }
597
- ]);
598
- });
599
-
600
- it('| should handle empty brackets array', () => {
601
- const input = 'text (with) brackets [but] no {bracket} definitions';
602
- const result = DyFM_String.multiBracketSplitDetailed(input, [], 10, '...');
603
- expect(result).toEqual([
604
- { content: 'text (with) brackets [but] no {bracket} definitions', level: 0, brackets: null }
605
- ]);
606
- });
607
-
608
- it('| should handle empty string', () => {
609
- const input = '';
610
- const result = DyFM_String.multiBracketSplitDetailed(input, standardBrackets, 10, '...');
611
- expect(result).toEqual([
612
- { content: '', level: 0, brackets: null }
613
- ]);
614
- });
615
-
616
- it('| should show bracket type for each extracted content', () => {
617
- const mixedBrackets = [
618
- { opening: '<', closing: '>' },
619
- { opening: '(', closing: ')' },
620
- { opening: '[', closing: ']' }
621
- ];
622
- const input = 'start <tag> middle (paren) end [array] finish';
623
- const result = DyFM_String.multiBracketSplitDetailed(input, mixedBrackets, 10, '...');
624
- expect(result).toEqual([
625
- { content: 'start ... middle ... end ... finish', level: 0, brackets: null },
626
- { content: 'tag', level: 1, brackets: { opening: '<', closing: '>' } },
627
- { content: 'paren', level: 1, brackets: { opening: '(', closing: ')' } },
628
- { content: 'array', level: 1, brackets: { opening: '[', closing: ']' } }
629
- ]);
630
- });
631
-
632
- it('| should handle complex nested scenario with multiple bracket types', () => {
633
- const input = 'text (a [b {c (d) c} b] a) text';
634
- const result = DyFM_String.multiBracketSplitDetailed(input, standardBrackets, 4, '...');
635
- expect(result).toEqual([
636
- { content: 'text ... text', level: 0, brackets: null },
637
- { content: 'a ... a', level: 1, brackets: { opening: '(', closing: ')' } },
638
- { content: 'b ... b', level: 2, brackets: { opening: '[', closing: ']' } },
639
- { content: 'c ... c', level: 3, brackets: { opening: '{', closing: '}' } },
640
- { content: 'd', level: 4, brackets: { opening: '(', closing: ')' } }
641
- ]);
642
- });
643
- });
644
-
645
- describe('| multiBracketSplitDetailed - replaceContents variations', () => {
646
- const standardBrackets = [
647
- { opening: '(', closing: ')' },
648
- { opening: '[', closing: ']' },
649
- { opening: '{', closing: '}' }
650
- ];
651
-
652
- it('| should handle empty replaceContents (no replacement)', () => {
653
- const input = 'text (round) and [square] brackets';
654
- const result = DyFM_String.multiBracketSplitDetailed(input, standardBrackets, 10, '');
655
- expect(result).toEqual([
656
- { content: 'text and brackets', level: 0, brackets: null },
657
- { content: 'round', level: 1, brackets: { opening: '(', closing: ')' } },
658
- { content: 'square', level: 1, brackets: { opening: '[', closing: ']' } }
659
- ]);
660
- });
661
-
662
- it('| should handle undefined replaceContents (no replacement)', () => {
663
- const input = 'text (round) and [square] brackets';
664
- const result = DyFM_String.multiBracketSplitDetailed(input, standardBrackets, 10);
665
- expect(result).toEqual([
666
- { content: 'text (round) and [square] brackets', level: 0, brackets: null },
667
- { content: 'round', level: 1, brackets: { opening: '(', closing: ')' } },
668
- { content: 'square', level: 1, brackets: { opening: '[', closing: ']' } }
669
- ]);
670
- });
671
-
672
- it('| should handle nested brackets with empty replaceContents', () => {
673
- const input = 'text {curly (nested) content} end';
674
- const result = DyFM_String.multiBracketSplitDetailed(input, standardBrackets, 2, '');
675
- expect(result).toEqual([
676
- { content: 'text end', level: 0, brackets: null },
677
- { content: 'curly content', level: 1, brackets: { opening: '{', closing: '}' } },
678
- { content: 'nested', level: 2, brackets: { opening: '(', closing: ')' } }
679
- ]);
680
- });
681
- });
682
-
683
- // JSON and code fence extraction tests
684
- describe('| JSON and code fence extraction', () => {
685
- it('| should extract from plain JSON object with nested object', () => {
686
- const brackets = [
687
- { opening: '{', closing: '}' }
688
- ];
689
- const input = 'before {"name":"John","age":30,"nested":{"flag":true}} after';
690
- const result = DyFM_String.multiBracketSplitDetailed(input, brackets, 3, '...');
691
- expect(result).toEqual([
692
- { content: 'before ... after', level: 0, brackets: null },
693
- { content: '"name":"John","age":30,"nested":...', level: 1, brackets: { opening: '{', closing: '}' } },
694
- { content: '"flag":true', level: 2, brackets: { opening: '{', closing: '}' } }
695
- ]);
696
- });
697
-
698
- it('| should extract JSON inside code fence json``` ... ```', () => {
699
- const brackets = [
700
- { opening: 'json```', closing: '```' },
701
- { opening: '{', closing: '}' }
702
- ];
703
- const input = 'pre json```{"x":1,"y":{"z":2}}``` post';
704
- const result = DyFM_String.multiBracketSplitDetailed(input, brackets, 3, '...');
705
- expect(result).toEqual([
706
- { content: 'pre ... post', level: 0, brackets: null },
707
- { content: '...', level: 1, brackets: { opening: 'json```', closing: '```' } },
708
- { content: '"x":1,"y":...', level: 2, brackets: { opening: '{', closing: '}' } },
709
- { content: '"z":2', level: 3, brackets: { opening: '{', closing: '}' } }
710
- ]);
711
- });
712
-
713
- it('| should handle deeply nested JSON object within a property', () => {
714
- const brackets = [
715
- { opening: '{', closing: '}' }
716
- ];
717
- const input = 'wrap {"outer":{"mid":{"inner":42}}} done';
718
- const result = DyFM_String.multiBracketSplitDetailed(input, brackets, 3, '...');
719
- expect(result).toEqual([
720
- { content: 'wrap ... done', level: 0, brackets: null },
721
- { content: '"outer":...', level: 1, brackets: { opening: '{', closing: '}' } },
722
- { content: '"mid":...', level: 2, brackets: { opening: '{', closing: '}' } },
723
- { content: '"inner":42', level: 3, brackets: { opening: '{', closing: '}' } }
724
- ]);
725
- });
726
-
727
- it('| should process when a JSON string value contains code fence pattern json``` ... ```', () => {
728
- const brackets = [
729
- { opening: 'json```', closing: '```' },
730
- { opening: '{', closing: '}' }
731
- ];
732
- const input = 'before {"note":"see json```X``` inside","data":{"raw":"json```Y```"}} after';
733
- const result = DyFM_String.multiBracketSplitDetailed(input, brackets, 4, '...');
734
- expect(result).toEqual([
735
- { content: 'before ... after', level: 0, brackets: null },
736
- { content: '"note":"see ... inside","data":...', level: 1, brackets: { opening: '{', closing: '}' } },
737
- { content: 'X', level: 2, brackets: { opening: 'json```', closing: '```' } },
738
- { content: '"raw":"..."', level: 2, brackets: { opening: '{', closing: '}' } },
739
- { content: 'Y', level: 3, brackets: { opening: 'json```', closing: '```' } }
740
- ]);
741
- });
742
- });
743
-
744
- // Script/method extraction tests
745
- describe('| script/method extraction', () => {
746
- it('| should extract simple method arguments with parentheses', () => {
747
- const input = 'prefix doSomething(arg1, arg2) suffix';
748
- const result = DyFM_String.nestedBracketSplit(input, '(', ')', 2, '...');
749
- expect(result).toEqual([
750
- 'prefix doSomething... suffix',
751
- 'arg1, arg2'
752
- ]);
753
- });
754
-
755
- it('| should handle nested method calls', () => {
756
- const input = 'call outer(inner(a, b), c)';
757
- const result = DyFM_String.nestedBracketSplit(input, '(', ')', 3, '...');
758
- expect(result).toEqual([
759
- 'call outer...',
760
- 'inner..., c',
761
- 'a, b'
762
- ]);
763
- });
764
-
765
- it('| should extract quoted args inside a method call', () => {
766
- const brackets = [
767
- { opening: '(', closing: ')' },
768
- { opening: '"', closing: '"' }
769
- ];
770
- const input = 'run fn("a, b", 3) end';
771
- const result = DyFM_String.multiBracketSplitDetailed(input, brackets, 3, '...');
772
- expect(result).toEqual([
773
- { content: 'run fn... end', level: 0, brackets: null },
774
- { content: '..., 3', level: 1, brackets: { opening: '(', closing: ')' } },
775
- { content: 'a, b', level: 2, brackets: { opening: '"', closing: '"' } }
776
- ]);
777
- });
778
-
779
- it('| should handle JSON literal and inner helper call as arguments', () => {
780
- const brackets = [
781
- { opening: '(', closing: ')' },
782
- { opening: '{', closing: '}' },
783
- { opening: '"', closing: '"' }
784
- ];
785
- const input = 'call api({id:1, meta:{ok:true}}, helper("x")) done';
786
- const result = DyFM_String.multiBracketSplitDetailed(input, brackets, 4, '...');
787
- expect(result).toEqual([
788
- { content: 'call api... done', level: 0, brackets: null },
789
- { content: '..., helper...', level: 1, brackets: { opening: '(', closing: ')' } },
790
- { content: 'id:1, meta:...', level: 2, brackets: { opening: '{', closing: '}' } },
791
- { content: '...', level: 2, brackets: { opening: '(', closing: ')' } },
792
- { content: 'ok:true', level: 3, brackets: { opening: '{', closing: '}' } },
793
- { content: 'x', level: 3, brackets: { opening: '"', closing: '"' } }
794
- ]);
795
- });
796
-
797
- it('| should process code fence marker inside a quoted argument', () => {
798
- const brackets = [
799
- { opening: '(', closing: ')' },
800
- { opening: 'json```', closing: '```' },
801
- { opening: '"', closing: '"' }
802
- ];
803
- const input = 'run method("see json```{a:1}``` here", 0)';
804
- const result = DyFM_String.multiBracketSplitDetailed(input, brackets, 4, '...');
805
- expect(result).toEqual([
806
- { content: 'run method...', level: 0, brackets: null },
807
- { content: '..., 0', level: 1, brackets: { opening: '(', closing: ')' } },
808
- { content: 'see ... here', level: 2, brackets: { opening: '"', closing: '"' } },
809
- { content: '{a:1}', level: 3, brackets: { opening: 'json```', closing: '```' } }
810
- ]);
811
- });
812
- });
813
-
814
- describe('| anyNameToShortCode', () => {
815
- it('| should convert space-separated name to short code', () => {
816
- const result = DyFM_String.anyNameToShortCode('John Doe');
817
- expect(result).toBe('JD');
818
- });
819
-
820
- it('| should convert camelCase name to short code', () => {
821
- const result = DyFM_String.anyNameToShortCode('JohnDoe');
822
- expect(result).toBe('JD');
823
- });
824
-
825
- it('| should convert underscore-separated name to short code', () => {
826
- const result = DyFM_String.anyNameToShortCode('John_Doe');
827
- expect(result).toBe('JD');
828
- });
829
-
830
- it('| should convert camelCase starting with lowercase to short code', () => {
831
- const result = DyFM_String.anyNameToShortCode('johnDoe');
832
- expect(result).toBe('JD');
833
- });
834
-
835
- it('| should convert lowercase underscore-separated name to short code', () => {
836
- const result = DyFM_String.anyNameToShortCode('john_doe');
837
- expect(result).toBe('JD');
838
- });
839
-
840
- it('| should convert hyphen-separated name to short code', () => {
841
- const result = DyFM_String.anyNameToShortCode('john-doe');
842
- expect(result).toBe('JD');
843
- });
844
-
845
- it('| should handle single word name', () => {
846
- const result = DyFM_String.anyNameToShortCode('John');
847
- expect(result).toBe('J');
848
- });
849
-
850
- it('| should handle single lowercase word', () => {
851
- const result = DyFM_String.anyNameToShortCode('john');
852
- expect(result).toBe('J');
853
- });
854
-
855
- it('| should handle three words', () => {
856
- const result = DyFM_String.anyNameToShortCode('John Michael Doe');
857
- expect(result).toBe('JMD');
858
- });
859
-
860
- it('| should handle mixed separators', () => {
861
- const result = DyFM_String.anyNameToShortCode('John_Michael-Doe');
862
- expect(result).toBe('JMD');
863
- });
864
-
865
- it('| should handle camelCase with multiple words', () => {
866
- const result = DyFM_String.anyNameToShortCode('JohnMichaelDoe');
867
- expect(result).toBe('JMD');
868
- });
869
-
870
- it('| should handle mixed camelCase and separators', () => {
871
- const result = DyFM_String.anyNameToShortCode('JohnMichael_Doe');
872
- expect(result).toBe('JMD');
873
- });
874
-
875
- it('| should handle name with multiple spaces', () => {
876
- const result = DyFM_String.anyNameToShortCode('John Doe');
877
- expect(result).toBe('JD');
878
- });
879
-
880
- it('| should handle name with multiple underscores', () => {
881
- const result = DyFM_String.anyNameToShortCode('John___Doe');
882
- expect(result).toBe('JD');
883
- });
884
-
885
- it('| should handle name with multiple hyphens', () => {
886
- const result = DyFM_String.anyNameToShortCode('John---Doe');
887
- expect(result).toBe('JD');
888
- });
889
-
890
- it('| should handle name with mixed separators and spaces', () => {
891
- const result = DyFM_String.anyNameToShortCode('John _- Doe');
892
- expect(result).toBe('JD');
893
- });
894
-
895
- it('| should handle empty string', () => {
896
- const result = DyFM_String.anyNameToShortCode('');
897
- expect(result).toBe('');
898
- });
899
-
900
- it('| should handle string with only spaces', () => {
901
- const result = DyFM_String.anyNameToShortCode(' ');
902
- expect(result).toBe('');
903
- });
904
-
905
- it('| should handle string with only separators', () => {
906
- const result = DyFM_String.anyNameToShortCode('___---');
907
- expect(result).toBe('');
908
- });
909
-
910
- it('| should handle name with leading and trailing spaces', () => {
911
- const result = DyFM_String.anyNameToShortCode(' John Doe ');
912
- expect(result).toBe('JD');
913
- });
914
-
915
- it('| should handle name with leading and trailing separators', () => {
916
- const result = DyFM_String.anyNameToShortCode('_John_Doe_');
917
- expect(result).toBe('JD');
918
- });
919
-
920
- it('| should handle all uppercase name', () => {
921
- const result = DyFM_String.anyNameToShortCode('JOHN DOE');
922
- expect(result).toBe('JD');
923
- });
924
-
925
- it('| should handle all uppercase camelCase', () => {
926
- const result = DyFM_String.anyNameToShortCode('JOHNDOE');
927
- expect(result).toBe('J');
928
- });
929
-
930
- it('| should handle name with numbers', () => {
931
- const result = DyFM_String.anyNameToShortCode('John2 Doe3');
932
- expect(result).toBe('JD');
933
- });
934
-
935
- it('| should handle name starting with number', () => {
936
- const result = DyFM_String.anyNameToShortCode('2John Doe');
937
- expect(result).toBe('JD');
938
- });
939
-
940
- it('| should handle complex camelCase with numbers', () => {
941
- const result = DyFM_String.anyNameToShortCode('john2Doe3Smith');
942
- expect(result).toBe('JDS');
943
- });
944
-
945
- it('| should handle single character', () => {
946
- const result = DyFM_String.anyNameToShortCode('J');
947
- expect(result).toBe('J');
948
- });
949
-
950
- it('| should handle name with special characters', () => {
951
- const result = DyFM_String.anyNameToShortCode('John@Doe#Smith');
952
- expect(result).toBe('JDS');
953
- });
954
-
955
- it('| should handle very long camelCase name', () => {
956
- const result = DyFM_String.anyNameToShortCode('ThisIsAVeryLongCamelCaseName');
957
- expect(result).toBe('TIAVLCCN');
958
- });
959
-
960
- it('| should handle name with consecutive uppercase letters', () => {
961
- const result = DyFM_String.anyNameToShortCode('XMLParser');
962
- expect(result).toBe('XP');
963
- });
964
-
965
- it('| should handle name with acronym at start', () => {
966
- const result = DyFM_String.anyNameToShortCode('HTMLDocument');
967
- expect(result).toBe('HD');
968
- });
969
-
970
- it('| should handle name with acronym in middle', () => {
971
- const result = DyFM_String.anyNameToShortCode('MyHTMLParser');
972
- expect(result).toBe('MHP');
973
- });
974
- });
975
- });
1
+
2
+ import { DyFM_String } from './string.util';
3
+
4
+ describe('| DyFM_String', () => {
5
+ describe('| breakTrim', () => {
6
+ it('| should remove spaces from the start and end of the string', () => {
7
+ const result = DyFM_String.breakTrim(' hello world ');
8
+ expect(result).toBe('hello world');
9
+ });
10
+
11
+ it('| should remove newline characters from the start and end of the string', () => {
12
+ const result = DyFM_String.breakTrim('\nhello world\n');
13
+ expect(result).toBe('hello world');
14
+ });
15
+
16
+ it('| should remove carriage return characters from the start and end of the string', () => {
17
+ const result = DyFM_String.breakTrim('\rhello world\r');
18
+ expect(result).toBe('hello world');
19
+ });
20
+
21
+ it('| should remove all types of line breaks from the start and end of the string', () => {
22
+ const result = DyFM_String.breakTrim('\r\nhello world\r\n');
23
+ expect(result).toBe('hello world');
24
+ });
25
+
26
+ it('| should return an empty string if the input is only spaces and line breaks', () => {
27
+ const result = DyFM_String.breakTrim(' \r\n ');
28
+ expect(result).toBe('');
29
+ });
30
+
31
+ it('| should not alter a string that has no spaces or line breaks at the start or end', () => {
32
+ const result = DyFM_String.breakTrim('hello world');
33
+ expect(result).toBe('hello world');
34
+ });
35
+
36
+ it('| should handle an empty string input', () => {
37
+ const result = DyFM_String.breakTrim('');
38
+ expect(result).toBe('');
39
+ });
40
+ });
41
+
42
+ describe('| nestedBracketSplit', () => {
43
+ it('| should handle simple bracket extraction with replacement', () => {
44
+ const input = 'hello (world) test';
45
+ const result = DyFM_String.nestedBracketSplit(input, '(', ')', 10, '...');
46
+ expect(result).toEqual(['hello ... test', 'world']);
47
+ });
48
+
49
+ it('| should handle multiple brackets at the same level', () => {
50
+ const input = 'start (first) middle (second) end';
51
+ const result = DyFM_String.nestedBracketSplit(input, '(', ')', 10, '...');
52
+ expect(result).toEqual(['start ... middle ... end', 'first', 'second']);
53
+ });
54
+
55
+ it('| should handle nested brackets according to the example', () => {
56
+ const input = 'asdasd (and other things) around (and layered things (and more layers) around) around';
57
+ const result = DyFM_String.nestedBracketSplit(input, '(', ')', 2, '...');
58
+ expect(result).toEqual([
59
+ 'asdasd ... around ... around',
60
+ 'and other things',
61
+ 'and layered things ... around',
62
+ 'and more layers'
63
+ ]);
64
+ });
65
+
66
+ it('| should respect maxDepth parameter', () => {
67
+ const input = 'text (level1 (level2 (level3) level2) level1) text';
68
+ const result = DyFM_String.nestedBracketSplit(input, '(', ')', 1, '...');
69
+ expect(result).toEqual([
70
+ 'text ... text',
71
+ 'level1 (level2 (level3) level2) level1'
72
+ ]);
73
+ });
74
+
75
+ it('| should handle empty replacement string', () => {
76
+ const input = 'hello (world) test';
77
+ const result = DyFM_String.nestedBracketSplit(input, '(', ')', 10, '');
78
+ expect(result).toEqual(['hello test', 'world']);
79
+ });
80
+
81
+ it('| should handle string with no brackets', () => {
82
+ const input = 'hello world test';
83
+ const result = DyFM_String.nestedBracketSplit(input, '(', ')', 10, '...');
84
+ expect(result).toEqual(['hello world test']);
85
+ });
86
+
87
+ it('| should handle empty string', () => {
88
+ const input = '';
89
+ const result = DyFM_String.nestedBracketSplit(input, '(', ')', 10, '...');
90
+ expect(result).toEqual(['']);
91
+ });
92
+
93
+ it('| should handle unmatched opening bracket', () => {
94
+ const input = 'hello (world test';
95
+ const result = DyFM_String.nestedBracketSplit(input, '(', ')', 10, '...');
96
+ expect(result).toEqual(['hello (world test']);
97
+ });
98
+
99
+ it('| should handle unmatched closing bracket', () => {
100
+ const input = 'hello world) test';
101
+ const result = DyFM_String.nestedBracketSplit(input, '(', ')', 10, '...');
102
+ expect(result).toEqual(['hello world) test']);
103
+ });
104
+
105
+ it('| should handle custom bracket characters', () => {
106
+ const input = 'start [first] middle [second] end';
107
+ const result = DyFM_String.nestedBracketSplit(input, '[', ']', 10, '...');
108
+ expect(result).toEqual(['start ... middle ... end', 'first', 'second']);
109
+ });
110
+
111
+ it('| should handle multi-character brackets', () => {
112
+ const input = 'start {{first}} middle {{second}} end';
113
+ const result = DyFM_String.nestedBracketSplit(input, '{{', '}}', 10, '...');
114
+ expect(result).toEqual(['start ... middle ... end', 'first', 'second']);
115
+ });
116
+
117
+ it('| should handle deeply nested brackets with maxDepth', () => {
118
+ const input = 'text (a (b (c (d) c) b) a) text';
119
+ const result = DyFM_String.nestedBracketSplit(input, '(', ')', 3, '...');
120
+ expect(result).toEqual([
121
+ 'text ... text',
122
+ 'a ... a',
123
+ 'b ... b',
124
+ 'c (d) c'
125
+ ]);
126
+ });
127
+
128
+ it('| should handle same character for opening and closing bracket', () => {
129
+ const input = "start 'first quote' middle 'second quote' end";
130
+ const result = DyFM_String.nestedBracketSplit(input, "'", "'", 10, '...');
131
+ expect(result).toEqual(["start ... middle ... end", 'first quote', 'second quote']);
132
+ });
133
+
134
+ it('| should handle nested same character brackets', () => {
135
+ const input = "text 'outer 'inner' outer' text";
136
+ const result = DyFM_String.nestedBracketSplit(input, "'", "'", 2, '...');
137
+ expect(result).toEqual([
138
+ 'text ... text',
139
+ 'outer ... outer',
140
+ 'inner'
141
+ ]);
142
+ });
143
+
144
+ it('| should handle multiple levels of same character brackets', () => {
145
+ const input = "start 'level1 'level2 'level3' level2' level1' end";
146
+ const result = DyFM_String.nestedBracketSplit(input, "'", "'", 3, '...');
147
+ expect(result).toEqual([
148
+ 'start ... end',
149
+ 'level1 ... level1',
150
+ 'level2 ... level2',
151
+ 'level3'
152
+ ]);
153
+ });
154
+
155
+ it('| should handle empty content between same character brackets', () => {
156
+ const input = "text '' more text";
157
+ const result = DyFM_String.nestedBracketSplit(input, "'", "'", 10, '...');
158
+ expect(result).toEqual(['text ... more text', '']);
159
+ });
160
+
161
+ it('| should handle single same character bracket (unmatched)', () => {
162
+ const input = "text 'unmatched quote";
163
+ const result = DyFM_String.nestedBracketSplit(input, "'", "'", 10, '...');
164
+ expect(result).toEqual(["text 'unmatched quote"]);
165
+ });
166
+
167
+ it('| should handle alternating same character brackets', () => {
168
+ const input = "text 'first' normal 'second' normal 'third' text";
169
+ const result = DyFM_String.nestedBracketSplit(input, "'", "'", 10, '...');
170
+ expect(result).toEqual(['text ... normal ... normal ... text', 'first', 'second', 'third']);
171
+ });
172
+
173
+ it('| should respect maxDepth with same character brackets', () => {
174
+ const input = "text 'a 'b 'c' b' a' text";
175
+ const result = DyFM_String.nestedBracketSplit(input, "'", "'", 1, '...');
176
+ expect(result).toEqual([
177
+ 'text ... text',
178
+ "a 'b 'c' b' a"
179
+ ]);
180
+ });
181
+ });
182
+
183
+ describe('| nestedBracketSplit - replaceContents variations', () => {
184
+ it('| should handle empty replaceContents (no replacement)', () => {
185
+ const input = 'hello (world) test';
186
+ const result = DyFM_String.nestedBracketSplit(input, '(', ')', 10, '');
187
+ expect(result).toEqual(['hello test', 'world']);
188
+ });
189
+
190
+ it('| should handle undefined replaceContents (no replacement)', () => {
191
+ const input = 'hello (world) test';
192
+ const result = DyFM_String.nestedBracketSplit(input, '(', ')', 10);
193
+ expect(result).toEqual(['hello (world) test', 'world']);
194
+ });
195
+
196
+ it('| should handle multiple brackets with empty replaceContents', () => {
197
+ const input = 'start (first) middle (second) end';
198
+ const result = DyFM_String.nestedBracketSplit(input, '(', ')', 10, '');
199
+ expect(result).toEqual(['start middle end', 'first', 'second']);
200
+ });
201
+
202
+ it('| should handle nested brackets with empty replaceContents', () => {
203
+ const input = 'text (outer (inner) outer) text';
204
+ const result = DyFM_String.nestedBracketSplit(input, '(', ')', 2, '');
205
+ expect(result).toEqual(['text text', 'outer outer', 'inner']);
206
+ });
207
+ });
208
+
209
+ describe('| nestedBracketSplitDetailed', () => {
210
+ it('| should return detailed information for simple nested brackets', () => {
211
+ const input = 'hello (world) test';
212
+ const result = DyFM_String.nestedBracketSplitDetailed(input, '(', ')', 10, '...');
213
+ expect(result).toEqual([
214
+ { content: 'hello ... test', level: 0, brackets: null },
215
+ { content: 'world', level: 1, brackets: { opening: '(', closing: ')' } }
216
+ ]);
217
+ });
218
+
219
+ it('| should handle nested brackets with detailed level information', () => {
220
+ const input = 'asdasd (and other things) around (and layered things (and more layers) around) around';
221
+ const result = DyFM_String.nestedBracketSplitDetailed(input, '(', ')', 2, '...');
222
+ expect(result).toEqual([
223
+ { content: 'asdasd ... around ... around', level: 0, brackets: null },
224
+ { content: 'and other things', level: 1, brackets: { opening: '(', closing: ')' } },
225
+ { content: 'and layered things ... around', level: 1, brackets: { opening: '(', closing: ')' } },
226
+ { content: 'and more layers', level: 2, brackets: { opening: '(', closing: ')' } }
227
+ ]);
228
+ });
229
+
230
+ it('| should handle same character brackets with detailed info', () => {
231
+ const input = "text 'quoted content' end";
232
+ const result = DyFM_String.nestedBracketSplitDetailed(input, "'", "'", 10, '...');
233
+ expect(result).toEqual([
234
+ { content: 'text ... end', level: 0, brackets: null },
235
+ { content: 'quoted content', level: 1, brackets: { opening: "'", closing: "'" } }
236
+ ]);
237
+ });
238
+
239
+ it('| should respect maxDepth with detailed levels', () => {
240
+ const input = 'text (a (b (c) b) a) text';
241
+ const result = DyFM_String.nestedBracketSplitDetailed(input, '(', ')', 2, '...');
242
+ expect(result).toEqual([
243
+ { content: 'text ... text', level: 0, brackets: null },
244
+ { content: 'a ... a', level: 1, brackets: { opening: '(', closing: ')' } },
245
+ { content: 'b (c) b', level: 2, brackets: { opening: '(', closing: ')' } }
246
+ ]);
247
+ });
248
+
249
+ it('| should handle no brackets case', () => {
250
+ const input = 'plain text with no brackets';
251
+ const result = DyFM_String.nestedBracketSplitDetailed(input, '(', ')', 10, '...');
252
+ expect(result).toEqual([
253
+ { content: 'plain text with no brackets', level: 0, brackets: null }
254
+ ]);
255
+ });
256
+
257
+ it('| should handle empty replaceContents (no replacement)', () => {
258
+ const input = 'hello (world) test';
259
+ const result = DyFM_String.nestedBracketSplitDetailed(input, '(', ')', 10, '');
260
+ expect(result).toEqual([
261
+ { content: 'hello test', level: 0, brackets: null },
262
+ { content: 'world', level: 1, brackets: { opening: '(', closing: ')' } }
263
+ ]);
264
+ });
265
+
266
+ it('| should handle undefined replaceContents (no replacement)', () => {
267
+ const input = 'hello (world) test';
268
+ const result = DyFM_String.nestedBracketSplitDetailed(input, '(', ')', 10);
269
+ expect(result).toEqual([
270
+ { content: 'hello (world) test', level: 0, brackets: null },
271
+ { content: 'world', level: 1, brackets: { opening: '(', closing: ')' } }
272
+ ]);
273
+ });
274
+
275
+ it('| should handle nested brackets with empty replaceContents', () => {
276
+ const input = 'text (outer (inner) outer) text';
277
+ const result = DyFM_String.nestedBracketSplitDetailed(input, '(', ')', 2, '');
278
+ expect(result).toEqual([
279
+ { content: 'text text', level: 0, brackets: null },
280
+ { content: 'outer outer', level: 1, brackets: { opening: '(', closing: ')' } },
281
+ { content: 'inner', level: 2, brackets: { opening: '(', closing: ')' } }
282
+ ]);
283
+ });
284
+ });
285
+
286
+ describe('| multiBracketSplit', () => {
287
+ const standardBrackets = [
288
+ { opening: '(', closing: ')' },
289
+ { opening: '[', closing: ']' },
290
+ { opening: '{', closing: '}' }
291
+ ];
292
+
293
+ it('| should handle multiple bracket types at the same level', () => {
294
+ const input = 'text (round) and [square] with {curly} brackets';
295
+ const result = DyFM_String.multiBracketSplit(input, standardBrackets, 10, '...');
296
+ expect(result).toEqual([
297
+ 'text ... and ... with ... brackets',
298
+ 'round',
299
+ 'square',
300
+ 'curly'
301
+ ]);
302
+ });
303
+
304
+ it('| should handle mixed nested brackets according to the example', () => {
305
+ const input = 'text (round) and [square] with {curly (nested)} brackets';
306
+ const result = DyFM_String.multiBracketSplit(input, standardBrackets, 2, '...');
307
+ expect(result).toEqual([
308
+ 'text ... and ... with ... brackets',
309
+ 'round',
310
+ 'square',
311
+ 'curly ...',
312
+ 'nested'
313
+ ]);
314
+ });
315
+
316
+ it('| should handle deeply nested mixed brackets', () => {
317
+ const input = 'start {outer [middle (inner) middle] outer} end';
318
+ const result = DyFM_String.multiBracketSplit(input, standardBrackets, 3, '...');
319
+ expect(result).toEqual([
320
+ 'start ... end',
321
+ 'outer ... outer',
322
+ 'middle ... middle',
323
+ 'inner'
324
+ ]);
325
+ });
326
+
327
+ it('| should respect maxDepth with mixed brackets', () => {
328
+ const input = 'text {a [b (c) b] a} text';
329
+ const result = DyFM_String.multiBracketSplit(input, standardBrackets, 1, '...');
330
+ expect(result).toEqual([
331
+ 'text ... text',
332
+ 'a [b (c) b] a'
333
+ ]);
334
+ });
335
+
336
+ it('| should handle empty bracket contents', () => {
337
+ const input = 'text () and [] with {} brackets';
338
+ const result = DyFM_String.multiBracketSplit(input, standardBrackets, 10, '...');
339
+ expect(result).toEqual([
340
+ 'text ... and ... with ... brackets',
341
+ '',
342
+ '',
343
+ ''
344
+ ]);
345
+ });
346
+
347
+ it('| should handle unmatched brackets gracefully', () => {
348
+ const input = 'text (unmatched and [incomplete';
349
+ const result = DyFM_String.multiBracketSplit(input, standardBrackets, 10, '...');
350
+ expect(result).toEqual(['text (unmatched and [incomplete']);
351
+ });
352
+
353
+ it('| should handle same character brackets in the array', () => {
354
+ const quoteBrackets = [
355
+ { opening: "'", closing: "'" },
356
+ { opening: '"', closing: '"' }
357
+ ];
358
+ const input = "text 'single quoted' and \"double quoted\" content";
359
+ const result = DyFM_String.multiBracketSplit(input, quoteBrackets, 10, '...');
360
+ expect(result).toEqual([
361
+ 'text ... and ... content',
362
+ 'single quoted',
363
+ 'double quoted'
364
+ ]);
365
+ });
366
+
367
+ it('| should handle multi-character brackets', () => {
368
+ const customBrackets = [
369
+ { opening: '{{', closing: '}}' },
370
+ { opening: '[[', closing: ']]' },
371
+ { opening: '()', closing: ')(' }
372
+ ];
373
+ const input = 'text {{double curly}} and [[double square]] with ()reversed)( brackets';
374
+ const result = DyFM_String.multiBracketSplit(input, customBrackets, 10, '...');
375
+ expect(result).toEqual([
376
+ 'text ... and ... with ... brackets',
377
+ 'double curly',
378
+ 'double square',
379
+ 'reversed'
380
+ ]);
381
+ });
382
+
383
+ it('| should handle complex nesting with different bracket types', () => {
384
+ const input = 'start (round [square {curly [inner]} square] round) end';
385
+ const result = DyFM_String.multiBracketSplit(input, standardBrackets, 4, '...');
386
+ expect(result).toEqual([
387
+ 'start ... end',
388
+ 'round ... round',
389
+ 'square ... square',
390
+ 'curly ...',
391
+ 'inner'
392
+ ]);
393
+ });
394
+
395
+ it('| should handle no brackets', () => {
396
+ const input = 'plain text with no brackets';
397
+ const result = DyFM_String.multiBracketSplit(input, standardBrackets, 10, '...');
398
+ expect(result).toEqual(['plain text with no brackets']);
399
+ });
400
+
401
+ it('| should handle empty string', () => {
402
+ const input = '';
403
+ const result = DyFM_String.multiBracketSplit(input, standardBrackets, 10, '...');
404
+ expect(result).toEqual(['']);
405
+ });
406
+
407
+ it('| should handle empty brackets array', () => {
408
+ const input = 'text (with) brackets [but] no {bracket} definitions';
409
+ const result = DyFM_String.multiBracketSplit(input, [], 10, '...');
410
+ expect(result).toEqual(['text (with) brackets [but] no {bracket} definitions']);
411
+ });
412
+
413
+ it('| should handle overlapping bracket patterns', () => {
414
+ const overlappingBrackets = [
415
+ { opening: '(', closing: ')' },
416
+ { opening: '((', closing: '))' }
417
+ ];
418
+ const input = 'text ((double)) and (single) brackets';
419
+ const result = DyFM_String.multiBracketSplit(input, overlappingBrackets, 10, '...');
420
+ expect(result).toEqual([
421
+ 'text ... and ... brackets',
422
+ 'double',
423
+ 'single'
424
+ ]);
425
+ });
426
+
427
+ it('| should handle brackets with same opening but different closing', () => {
428
+ const mixedBrackets = [
429
+ { opening: '<', closing: '>' },
430
+ { opening: '<', closing: '/>' }
431
+ ];
432
+ const input = 'text <tag/> and <content> here';
433
+ const result = DyFM_String.multiBracketSplit(input, mixedBrackets, 10, '...');
434
+ expect(result).toEqual([
435
+ 'text ... and ... here',
436
+ 'tag',
437
+ 'content'
438
+ ]);
439
+ });
440
+
441
+ it('| should maintain proper bracket matching with mixed types', () => {
442
+ const input = 'text (round [square) wrong] correct';
443
+ const result = DyFM_String.multiBracketSplit(input, standardBrackets, 10, '...');
444
+ expect(result).toEqual([
445
+ 'text ... wrong] correct',
446
+ 'round [square'
447
+ ]);
448
+ });
449
+ });
450
+
451
+ describe('| multiBracketSplit - replaceContents variations', () => {
452
+ const standardBrackets = [
453
+ { opening: '(', closing: ')' },
454
+ { opening: '[', closing: ']' },
455
+ { opening: '{', closing: '}' }
456
+ ];
457
+
458
+ it('| should handle empty replaceContents (no replacement)', () => {
459
+ const input = 'text (round) and [square] with {curly} brackets';
460
+ const result = DyFM_String.multiBracketSplit(input, standardBrackets, 10, '');
461
+ expect(result).toEqual([
462
+ 'text and with brackets',
463
+ 'round',
464
+ 'square',
465
+ 'curly'
466
+ ]);
467
+ });
468
+
469
+ it('| should handle undefined replaceContents (no replacement)', () => {
470
+ const input = 'text (round) and [square] with {curly} brackets';
471
+ const result = DyFM_String.multiBracketSplit(input, standardBrackets, 10);
472
+ expect(result).toEqual([
473
+ 'text (round) and [square] with {curly} brackets',
474
+ 'round',
475
+ 'square',
476
+ 'curly'
477
+ ]);
478
+ });
479
+
480
+ it('| should handle nested brackets with empty replaceContents', () => {
481
+ const input = 'text (round) and [square] with {curly (nested)} brackets';
482
+ const result = DyFM_String.multiBracketSplit(input, standardBrackets, 2, '');
483
+ expect(result).toEqual([
484
+ 'text and with brackets',
485
+ 'round',
486
+ 'square',
487
+ 'curly ',
488
+ 'nested'
489
+ ]);
490
+ });
491
+ });
492
+
493
+ describe('| multiBracketSplitDetailed', () => {
494
+ const standardBrackets = [
495
+ { opening: '(', closing: ')' },
496
+ { opening: '[', closing: ']' },
497
+ { opening: '{', closing: '}' }
498
+ ];
499
+
500
+ it('| should return detailed information for simple bracket extraction', () => {
501
+ const input = 'text (round) end';
502
+ const result = DyFM_String.multiBracketSplitDetailed(input, standardBrackets, 10, '...');
503
+ expect(result).toEqual([
504
+ { content: 'text ... end', level: 0, brackets: null },
505
+ { content: 'round', level: 1, brackets: { opening: '(', closing: ')' } }
506
+ ]);
507
+ });
508
+
509
+ it('| should handle multiple bracket types with detailed info', () => {
510
+ const input = 'text (round) and [square] with {curly} brackets';
511
+ const result = DyFM_String.multiBracketSplitDetailed(input, standardBrackets, 10, '...');
512
+ expect(result).toEqual([
513
+ { content: 'text ... and ... with ... brackets', level: 0, brackets: null },
514
+ { content: 'round', level: 1, brackets: { opening: '(', closing: ')' } },
515
+ { content: 'square', level: 1, brackets: { opening: '[', closing: ']' } },
516
+ { content: 'curly', level: 1, brackets: { opening: '{', closing: '}' } }
517
+ ]);
518
+ });
519
+
520
+ it('| should handle nested brackets with detailed level information', () => {
521
+ const input = 'text (round) and [square] with {curly (nested)} brackets';
522
+ const result = DyFM_String.multiBracketSplitDetailed(input, standardBrackets, 2, '...');
523
+ expect(result).toEqual([
524
+ { content: 'text ... and ... with ... brackets', level: 0, brackets: null },
525
+ { content: 'round', level: 1, brackets: { opening: '(', closing: ')' } },
526
+ { content: 'square', level: 1, brackets: { opening: '[', closing: ']' } },
527
+ { content: 'curly ...', level: 1, brackets: { opening: '{', closing: '}' } },
528
+ { content: 'nested', level: 2, brackets: { opening: '(', closing: ')' } }
529
+ ]);
530
+ });
531
+
532
+ it('| should handle deeply nested brackets with correct levels', () => {
533
+ const input = 'start {outer [middle (inner) middle] outer} end';
534
+ const result = DyFM_String.multiBracketSplitDetailed(input, standardBrackets, 3, '...');
535
+ expect(result).toEqual([
536
+ { content: 'start ... end', level: 0, brackets: null },
537
+ { content: 'outer ... outer', level: 1, brackets: { opening: '{', closing: '}' } },
538
+ { content: 'middle ... middle', level: 2, brackets: { opening: '[', closing: ']' } },
539
+ { content: 'inner', level: 3, brackets: { opening: '(', closing: ')' } }
540
+ ]);
541
+ });
542
+
543
+ it('| should respect maxDepth and show correct levels', () => {
544
+ const input = 'text {a [b (c) b] a} text';
545
+ const result = DyFM_String.multiBracketSplitDetailed(input, standardBrackets, 2, '...');
546
+ expect(result).toEqual([
547
+ { content: 'text ... text', level: 0, brackets: null },
548
+ { content: 'a ... a', level: 1, brackets: { opening: '{', closing: '}' } },
549
+ { content: 'b (c) b', level: 2, brackets: { opening: '[', closing: ']' } }
550
+ ]);
551
+ });
552
+
553
+ it('| should handle empty brackets with detailed info', () => {
554
+ const input = 'text () and [] with {} brackets';
555
+ const result = DyFM_String.multiBracketSplitDetailed(input, standardBrackets, 10, '...');
556
+ expect(result).toEqual([
557
+ { content: 'text ... and ... with ... brackets', level: 0, brackets: null },
558
+ { content: '', level: 1, brackets: { opening: '(', closing: ')' } },
559
+ { content: '', level: 1, brackets: { opening: '[', closing: ']' } },
560
+ { content: '', level: 1, brackets: { opening: '{', closing: '}' } }
561
+ ]);
562
+ });
563
+
564
+ it('| should handle custom bracket types with detailed info', () => {
565
+ const customBrackets = [
566
+ { opening: '{{', closing: '}}' },
567
+ { opening: '[[', closing: ']]' }
568
+ ];
569
+ const input = 'text {{double curly}} and [[double square]] content';
570
+ const result = DyFM_String.multiBracketSplitDetailed(input, customBrackets, 10, '...');
571
+ expect(result).toEqual([
572
+ { content: 'text ... and ... content', level: 0, brackets: null },
573
+ { content: 'double curly', level: 1, brackets: { opening: '{{', closing: '}}' } },
574
+ { content: 'double square', level: 1, brackets: { opening: '[[', closing: ']]' } }
575
+ ]);
576
+ });
577
+
578
+ it('| should handle same character brackets with detailed info', () => {
579
+ const quoteBrackets = [
580
+ { opening: "'", closing: "'" },
581
+ { opening: '"', closing: '"' }
582
+ ];
583
+ const input = "text 'single quoted' and \"double quoted\" content";
584
+ const result = DyFM_String.multiBracketSplitDetailed(input, quoteBrackets, 10, '...');
585
+ expect(result).toEqual([
586
+ { content: 'text ... and ... content', level: 0, brackets: null },
587
+ { content: 'single quoted', level: 1, brackets: { opening: "'", closing: "'" } },
588
+ { content: 'double quoted', level: 1, brackets: { opening: '"', closing: '"' } }
589
+ ]);
590
+ });
591
+
592
+ it('| should handle no brackets case', () => {
593
+ const input = 'plain text with no brackets';
594
+ const result = DyFM_String.multiBracketSplitDetailed(input, standardBrackets, 10, '...');
595
+ expect(result).toEqual([
596
+ { content: 'plain text with no brackets', level: 0, brackets: null }
597
+ ]);
598
+ });
599
+
600
+ it('| should handle empty brackets array', () => {
601
+ const input = 'text (with) brackets [but] no {bracket} definitions';
602
+ const result = DyFM_String.multiBracketSplitDetailed(input, [], 10, '...');
603
+ expect(result).toEqual([
604
+ { content: 'text (with) brackets [but] no {bracket} definitions', level: 0, brackets: null }
605
+ ]);
606
+ });
607
+
608
+ it('| should handle empty string', () => {
609
+ const input = '';
610
+ const result = DyFM_String.multiBracketSplitDetailed(input, standardBrackets, 10, '...');
611
+ expect(result).toEqual([
612
+ { content: '', level: 0, brackets: null }
613
+ ]);
614
+ });
615
+
616
+ it('| should show bracket type for each extracted content', () => {
617
+ const mixedBrackets = [
618
+ { opening: '<', closing: '>' },
619
+ { opening: '(', closing: ')' },
620
+ { opening: '[', closing: ']' }
621
+ ];
622
+ const input = 'start <tag> middle (paren) end [array] finish';
623
+ const result = DyFM_String.multiBracketSplitDetailed(input, mixedBrackets, 10, '...');
624
+ expect(result).toEqual([
625
+ { content: 'start ... middle ... end ... finish', level: 0, brackets: null },
626
+ { content: 'tag', level: 1, brackets: { opening: '<', closing: '>' } },
627
+ { content: 'paren', level: 1, brackets: { opening: '(', closing: ')' } },
628
+ { content: 'array', level: 1, brackets: { opening: '[', closing: ']' } }
629
+ ]);
630
+ });
631
+
632
+ it('| should handle complex nested scenario with multiple bracket types', () => {
633
+ const input = 'text (a [b {c (d) c} b] a) text';
634
+ const result = DyFM_String.multiBracketSplitDetailed(input, standardBrackets, 4, '...');
635
+ expect(result).toEqual([
636
+ { content: 'text ... text', level: 0, brackets: null },
637
+ { content: 'a ... a', level: 1, brackets: { opening: '(', closing: ')' } },
638
+ { content: 'b ... b', level: 2, brackets: { opening: '[', closing: ']' } },
639
+ { content: 'c ... c', level: 3, brackets: { opening: '{', closing: '}' } },
640
+ { content: 'd', level: 4, brackets: { opening: '(', closing: ')' } }
641
+ ]);
642
+ });
643
+ });
644
+
645
+ describe('| multiBracketSplitDetailed - replaceContents variations', () => {
646
+ const standardBrackets = [
647
+ { opening: '(', closing: ')' },
648
+ { opening: '[', closing: ']' },
649
+ { opening: '{', closing: '}' }
650
+ ];
651
+
652
+ it('| should handle empty replaceContents (no replacement)', () => {
653
+ const input = 'text (round) and [square] brackets';
654
+ const result = DyFM_String.multiBracketSplitDetailed(input, standardBrackets, 10, '');
655
+ expect(result).toEqual([
656
+ { content: 'text and brackets', level: 0, brackets: null },
657
+ { content: 'round', level: 1, brackets: { opening: '(', closing: ')' } },
658
+ { content: 'square', level: 1, brackets: { opening: '[', closing: ']' } }
659
+ ]);
660
+ });
661
+
662
+ it('| should handle undefined replaceContents (no replacement)', () => {
663
+ const input = 'text (round) and [square] brackets';
664
+ const result = DyFM_String.multiBracketSplitDetailed(input, standardBrackets, 10);
665
+ expect(result).toEqual([
666
+ { content: 'text (round) and [square] brackets', level: 0, brackets: null },
667
+ { content: 'round', level: 1, brackets: { opening: '(', closing: ')' } },
668
+ { content: 'square', level: 1, brackets: { opening: '[', closing: ']' } }
669
+ ]);
670
+ });
671
+
672
+ it('| should handle nested brackets with empty replaceContents', () => {
673
+ const input = 'text {curly (nested) content} end';
674
+ const result = DyFM_String.multiBracketSplitDetailed(input, standardBrackets, 2, '');
675
+ expect(result).toEqual([
676
+ { content: 'text end', level: 0, brackets: null },
677
+ { content: 'curly content', level: 1, brackets: { opening: '{', closing: '}' } },
678
+ { content: 'nested', level: 2, brackets: { opening: '(', closing: ')' } }
679
+ ]);
680
+ });
681
+ });
682
+
683
+ // JSON and code fence extraction tests
684
+ describe('| JSON and code fence extraction', () => {
685
+ it('| should extract from plain JSON object with nested object', () => {
686
+ const brackets = [
687
+ { opening: '{', closing: '}' }
688
+ ];
689
+ const input = 'before {"name":"John","age":30,"nested":{"flag":true}} after';
690
+ const result = DyFM_String.multiBracketSplitDetailed(input, brackets, 3, '...');
691
+ expect(result).toEqual([
692
+ { content: 'before ... after', level: 0, brackets: null },
693
+ { content: '"name":"John","age":30,"nested":...', level: 1, brackets: { opening: '{', closing: '}' } },
694
+ { content: '"flag":true', level: 2, brackets: { opening: '{', closing: '}' } }
695
+ ]);
696
+ });
697
+
698
+ it('| should extract JSON inside code fence json``` ... ```', () => {
699
+ const brackets = [
700
+ { opening: 'json```', closing: '```' },
701
+ { opening: '{', closing: '}' }
702
+ ];
703
+ const input = 'pre json```{"x":1,"y":{"z":2}}``` post';
704
+ const result = DyFM_String.multiBracketSplitDetailed(input, brackets, 3, '...');
705
+ expect(result).toEqual([
706
+ { content: 'pre ... post', level: 0, brackets: null },
707
+ { content: '...', level: 1, brackets: { opening: 'json```', closing: '```' } },
708
+ { content: '"x":1,"y":...', level: 2, brackets: { opening: '{', closing: '}' } },
709
+ { content: '"z":2', level: 3, brackets: { opening: '{', closing: '}' } }
710
+ ]);
711
+ });
712
+
713
+ it('| should handle deeply nested JSON object within a property', () => {
714
+ const brackets = [
715
+ { opening: '{', closing: '}' }
716
+ ];
717
+ const input = 'wrap {"outer":{"mid":{"inner":42}}} done';
718
+ const result = DyFM_String.multiBracketSplitDetailed(input, brackets, 3, '...');
719
+ expect(result).toEqual([
720
+ { content: 'wrap ... done', level: 0, brackets: null },
721
+ { content: '"outer":...', level: 1, brackets: { opening: '{', closing: '}' } },
722
+ { content: '"mid":...', level: 2, brackets: { opening: '{', closing: '}' } },
723
+ { content: '"inner":42', level: 3, brackets: { opening: '{', closing: '}' } }
724
+ ]);
725
+ });
726
+
727
+ it('| should process when a JSON string value contains code fence pattern json``` ... ```', () => {
728
+ const brackets = [
729
+ { opening: 'json```', closing: '```' },
730
+ { opening: '{', closing: '}' }
731
+ ];
732
+ const input = 'before {"note":"see json```X``` inside","data":{"raw":"json```Y```"}} after';
733
+ const result = DyFM_String.multiBracketSplitDetailed(input, brackets, 4, '...');
734
+ expect(result).toEqual([
735
+ { content: 'before ... after', level: 0, brackets: null },
736
+ { content: '"note":"see ... inside","data":...', level: 1, brackets: { opening: '{', closing: '}' } },
737
+ { content: 'X', level: 2, brackets: { opening: 'json```', closing: '```' } },
738
+ { content: '"raw":"..."', level: 2, brackets: { opening: '{', closing: '}' } },
739
+ { content: 'Y', level: 3, brackets: { opening: 'json```', closing: '```' } }
740
+ ]);
741
+ });
742
+ });
743
+
744
+ // Script/method extraction tests
745
+ describe('| script/method extraction', () => {
746
+ it('| should extract simple method arguments with parentheses', () => {
747
+ const input = 'prefix doSomething(arg1, arg2) suffix';
748
+ const result = DyFM_String.nestedBracketSplit(input, '(', ')', 2, '...');
749
+ expect(result).toEqual([
750
+ 'prefix doSomething... suffix',
751
+ 'arg1, arg2'
752
+ ]);
753
+ });
754
+
755
+ it('| should handle nested method calls', () => {
756
+ const input = 'call outer(inner(a, b), c)';
757
+ const result = DyFM_String.nestedBracketSplit(input, '(', ')', 3, '...');
758
+ expect(result).toEqual([
759
+ 'call outer...',
760
+ 'inner..., c',
761
+ 'a, b'
762
+ ]);
763
+ });
764
+
765
+ it('| should extract quoted args inside a method call', () => {
766
+ const brackets = [
767
+ { opening: '(', closing: ')' },
768
+ { opening: '"', closing: '"' }
769
+ ];
770
+ const input = 'run fn("a, b", 3) end';
771
+ const result = DyFM_String.multiBracketSplitDetailed(input, brackets, 3, '...');
772
+ expect(result).toEqual([
773
+ { content: 'run fn... end', level: 0, brackets: null },
774
+ { content: '..., 3', level: 1, brackets: { opening: '(', closing: ')' } },
775
+ { content: 'a, b', level: 2, brackets: { opening: '"', closing: '"' } }
776
+ ]);
777
+ });
778
+
779
+ it('| should handle JSON literal and inner helper call as arguments', () => {
780
+ const brackets = [
781
+ { opening: '(', closing: ')' },
782
+ { opening: '{', closing: '}' },
783
+ { opening: '"', closing: '"' }
784
+ ];
785
+ const input = 'call api({id:1, meta:{ok:true}}, helper("x")) done';
786
+ const result = DyFM_String.multiBracketSplitDetailed(input, brackets, 4, '...');
787
+ expect(result).toEqual([
788
+ { content: 'call api... done', level: 0, brackets: null },
789
+ { content: '..., helper...', level: 1, brackets: { opening: '(', closing: ')' } },
790
+ { content: 'id:1, meta:...', level: 2, brackets: { opening: '{', closing: '}' } },
791
+ { content: '...', level: 2, brackets: { opening: '(', closing: ')' } },
792
+ { content: 'ok:true', level: 3, brackets: { opening: '{', closing: '}' } },
793
+ { content: 'x', level: 3, brackets: { opening: '"', closing: '"' } }
794
+ ]);
795
+ });
796
+
797
+ it('| should process code fence marker inside a quoted argument', () => {
798
+ const brackets = [
799
+ { opening: '(', closing: ')' },
800
+ { opening: 'json```', closing: '```' },
801
+ { opening: '"', closing: '"' }
802
+ ];
803
+ const input = 'run method("see json```{a:1}``` here", 0)';
804
+ const result = DyFM_String.multiBracketSplitDetailed(input, brackets, 4, '...');
805
+ expect(result).toEqual([
806
+ { content: 'run method...', level: 0, brackets: null },
807
+ { content: '..., 0', level: 1, brackets: { opening: '(', closing: ')' } },
808
+ { content: 'see ... here', level: 2, brackets: { opening: '"', closing: '"' } },
809
+ { content: '{a:1}', level: 3, brackets: { opening: 'json```', closing: '```' } }
810
+ ]);
811
+ });
812
+ });
813
+
814
+ describe('| anyNameToShortCode', () => {
815
+ it('| should convert space-separated name to short code', () => {
816
+ const result = DyFM_String.anyNameToShortCode('John Doe');
817
+ expect(result).toBe('JD');
818
+ });
819
+
820
+ it('| should convert camelCase name to short code', () => {
821
+ const result = DyFM_String.anyNameToShortCode('JohnDoe');
822
+ expect(result).toBe('JD');
823
+ });
824
+
825
+ it('| should convert underscore-separated name to short code', () => {
826
+ const result = DyFM_String.anyNameToShortCode('John_Doe');
827
+ expect(result).toBe('JD');
828
+ });
829
+
830
+ it('| should convert camelCase starting with lowercase to short code', () => {
831
+ const result = DyFM_String.anyNameToShortCode('johnDoe');
832
+ expect(result).toBe('JD');
833
+ });
834
+
835
+ it('| should convert lowercase underscore-separated name to short code', () => {
836
+ const result = DyFM_String.anyNameToShortCode('john_doe');
837
+ expect(result).toBe('JD');
838
+ });
839
+
840
+ it('| should convert hyphen-separated name to short code', () => {
841
+ const result = DyFM_String.anyNameToShortCode('john-doe');
842
+ expect(result).toBe('JD');
843
+ });
844
+
845
+ it('| should handle single word name', () => {
846
+ const result = DyFM_String.anyNameToShortCode('John');
847
+ expect(result).toBe('J');
848
+ });
849
+
850
+ it('| should handle single lowercase word', () => {
851
+ const result = DyFM_String.anyNameToShortCode('john');
852
+ expect(result).toBe('J');
853
+ });
854
+
855
+ it('| should handle three words', () => {
856
+ const result = DyFM_String.anyNameToShortCode('John Michael Doe');
857
+ expect(result).toBe('JMD');
858
+ });
859
+
860
+ it('| should handle mixed separators', () => {
861
+ const result = DyFM_String.anyNameToShortCode('John_Michael-Doe');
862
+ expect(result).toBe('JMD');
863
+ });
864
+
865
+ it('| should handle camelCase with multiple words', () => {
866
+ const result = DyFM_String.anyNameToShortCode('JohnMichaelDoe');
867
+ expect(result).toBe('JMD');
868
+ });
869
+
870
+ it('| should handle mixed camelCase and separators', () => {
871
+ const result = DyFM_String.anyNameToShortCode('JohnMichael_Doe');
872
+ expect(result).toBe('JMD');
873
+ });
874
+
875
+ it('| should handle name with multiple spaces', () => {
876
+ const result = DyFM_String.anyNameToShortCode('John Doe');
877
+ expect(result).toBe('JD');
878
+ });
879
+
880
+ it('| should handle name with multiple underscores', () => {
881
+ const result = DyFM_String.anyNameToShortCode('John___Doe');
882
+ expect(result).toBe('JD');
883
+ });
884
+
885
+ it('| should handle name with multiple hyphens', () => {
886
+ const result = DyFM_String.anyNameToShortCode('John---Doe');
887
+ expect(result).toBe('JD');
888
+ });
889
+
890
+ it('| should handle name with mixed separators and spaces', () => {
891
+ const result = DyFM_String.anyNameToShortCode('John _- Doe');
892
+ expect(result).toBe('JD');
893
+ });
894
+
895
+ it('| should handle empty string', () => {
896
+ const result = DyFM_String.anyNameToShortCode('');
897
+ expect(result).toBe('');
898
+ });
899
+
900
+ it('| should handle string with only spaces', () => {
901
+ const result = DyFM_String.anyNameToShortCode(' ');
902
+ expect(result).toBe('');
903
+ });
904
+
905
+ it('| should handle string with only separators', () => {
906
+ const result = DyFM_String.anyNameToShortCode('___---');
907
+ expect(result).toBe('');
908
+ });
909
+
910
+ it('| should handle name with leading and trailing spaces', () => {
911
+ const result = DyFM_String.anyNameToShortCode(' John Doe ');
912
+ expect(result).toBe('JD');
913
+ });
914
+
915
+ it('| should handle name with leading and trailing separators', () => {
916
+ const result = DyFM_String.anyNameToShortCode('_John_Doe_');
917
+ expect(result).toBe('JD');
918
+ });
919
+
920
+ it('| should handle all uppercase name', () => {
921
+ const result = DyFM_String.anyNameToShortCode('JOHN DOE');
922
+ expect(result).toBe('JD');
923
+ });
924
+
925
+ it('| should handle all uppercase camelCase', () => {
926
+ const result = DyFM_String.anyNameToShortCode('JOHNDOE');
927
+ expect(result).toBe('J');
928
+ });
929
+
930
+ it('| should handle name with numbers', () => {
931
+ const result = DyFM_String.anyNameToShortCode('John2 Doe3');
932
+ expect(result).toBe('JD');
933
+ });
934
+
935
+ it('| should handle name starting with number', () => {
936
+ const result = DyFM_String.anyNameToShortCode('2John Doe');
937
+ expect(result).toBe('JD');
938
+ });
939
+
940
+ it('| should handle complex camelCase with numbers', () => {
941
+ const result = DyFM_String.anyNameToShortCode('john2Doe3Smith');
942
+ expect(result).toBe('JDS');
943
+ });
944
+
945
+ it('| should handle single character', () => {
946
+ const result = DyFM_String.anyNameToShortCode('J');
947
+ expect(result).toBe('J');
948
+ });
949
+
950
+ it('| should handle name with special characters', () => {
951
+ const result = DyFM_String.anyNameToShortCode('John@Doe#Smith');
952
+ expect(result).toBe('JDS');
953
+ });
954
+
955
+ it('| should handle very long camelCase name', () => {
956
+ const result = DyFM_String.anyNameToShortCode('ThisIsAVeryLongCamelCaseName');
957
+ expect(result).toBe('TIAVLCCN');
958
+ });
959
+
960
+ it('| should handle name with consecutive uppercase letters', () => {
961
+ const result = DyFM_String.anyNameToShortCode('XMLParser');
962
+ expect(result).toBe('XP');
963
+ });
964
+
965
+ it('| should handle name with acronym at start', () => {
966
+ const result = DyFM_String.anyNameToShortCode('HTMLDocument');
967
+ expect(result).toBe('HD');
968
+ });
969
+
970
+ it('| should handle name with acronym in middle', () => {
971
+ const result = DyFM_String.anyNameToShortCode('MyHTMLParser');
972
+ expect(result).toBe('MHP');
973
+ });
974
+ });
975
+ });