@futdevpro/fsm-dynamo 1.16.30 → 1.16.33

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 (578) 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/_modules/game/_collections/audio-mixer.util.d.ts +55 -0
  18. package/build/_modules/game/_collections/audio-mixer.util.d.ts.map +1 -0
  19. package/build/_modules/game/_collections/audio-mixer.util.js +114 -0
  20. package/build/_modules/game/_collections/audio-mixer.util.js.map +1 -0
  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 +21 -0
  26. package/build/_modules/game/_enums/audio-channel.enum.d.ts.map +1 -0
  27. package/build/_modules/game/_enums/audio-channel.enum.js +25 -0
  28. package/build/_modules/game/_enums/audio-channel.enum.js.map +1 -0
  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-settings.interface.d.ts +23 -0
  34. package/build/_modules/game/_models/audio-mixer-settings.interface.d.ts.map +1 -0
  35. package/build/_modules/game/_models/audio-mixer-settings.interface.js +3 -0
  36. package/build/_modules/game/_models/audio-mixer-settings.interface.js.map +1 -0
  37. package/build/_modules/game/_models/audio-mixer-state.interface.d.ts +19 -0
  38. package/build/_modules/game/_models/audio-mixer-state.interface.d.ts.map +1 -0
  39. package/build/_modules/game/_models/audio-mixer-state.interface.js +3 -0
  40. package/build/_modules/game/_models/audio-mixer-state.interface.js.map +1 -0
  41. package/build/_modules/game/_models/audio-mixer.control-model.d.ts +123 -0
  42. package/build/_modules/game/_models/audio-mixer.control-model.d.ts.map +1 -0
  43. package/build/_modules/game/_models/audio-mixer.control-model.js +312 -0
  44. package/build/_modules/game/_models/audio-mixer.control-model.js.map +1 -0
  45. package/build/_modules/game/_models/audio-scale.interface.d.ts +18 -0
  46. package/build/_modules/game/_models/audio-scale.interface.d.ts.map +1 -0
  47. package/build/_modules/game/_models/audio-scale.interface.js +3 -0
  48. package/build/_modules/game/_models/audio-scale.interface.js.map +1 -0
  49. package/build/_modules/game/_models/seeded-random-state.interface.d.ts +17 -0
  50. package/build/_modules/game/_models/seeded-random-state.interface.d.ts.map +1 -0
  51. package/build/_modules/game/_models/seeded-random-state.interface.js +3 -0
  52. package/build/_modules/game/_models/seeded-random-state.interface.js.map +1 -0
  53. package/build/_modules/game/_models/seeded-random.control-model.d.ts +125 -0
  54. package/build/_modules/game/_models/seeded-random.control-model.d.ts.map +1 -0
  55. package/build/_modules/game/_models/seeded-random.control-model.js +263 -0
  56. package/build/_modules/game/_models/seeded-random.control-model.js.map +1 -0
  57. package/build/_modules/game/index.d.ts +11 -0
  58. package/build/_modules/game/index.d.ts.map +1 -0
  59. package/build/_modules/game/index.js +17 -0
  60. package/build/_modules/game/index.js.map +1 -0
  61. package/build/_modules/socket/_models/sck-socket-event.control-model.js +1 -1
  62. package/eslint.config.js +4 -4
  63. package/nodemon.json +22 -22
  64. package/package.json +11 -2
  65. package/scripts/crypto/CRYPTO-STABILITY-SOLUTION.md +196 -196
  66. package/scripts/crypto/README.md +113 -113
  67. package/scripts/crypto/demo-crypto-stability.js +120 -120
  68. package/scripts/crypto/stress-test-crypto.js +379 -379
  69. package/scripts/run-coverage-tests.js +24 -24
  70. package/spec/support/helpers/ts-node-helper.js +9 -9
  71. package/spec/support/jasmine.coverage.json +23 -23
  72. package/spec/support/jasmine.json +24 -24
  73. package/src/_collections/constants/data-sizes.const.ts +40 -40
  74. package/src/_collections/constants/error-defaults.const.ts +20 -20
  75. package/src/_collections/constants/global-settings.const.ts +24 -24
  76. package/src/_collections/constants/numbers.const.ts +40 -40
  77. package/src/_collections/constants/times.const.ts +45 -45
  78. package/src/_collections/utils/array.util.spec.ts +306 -306
  79. package/src/_collections/utils/array.util.ts +813 -813
  80. package/src/_collections/utils/async.util.spec.ts +354 -354
  81. package/src/_collections/utils/async.util.ts +197 -197
  82. package/src/_collections/utils/data.util.spec.ts +345 -345
  83. package/src/_collections/utils/data.util.ts +226 -226
  84. package/src/_collections/utils/json-error-helper.util.spec.ts +521 -521
  85. package/src/_collections/utils/json-error-helper.util.ts +301 -301
  86. package/src/_collections/utils/log.util.spec.ts +975 -975
  87. package/src/_collections/utils/log.util.ts +667 -667
  88. package/src/_collections/utils/math/box-bounds.spec.ts +73 -73
  89. package/src/_collections/utils/math/box-bounds.util.ts +183 -183
  90. package/src/_collections/utils/math/math.util.spec.ts +94 -94
  91. package/src/_collections/utils/math/math.util.ts +141 -141
  92. package/src/_collections/utils/math/random.util.spec.ts +82 -82
  93. package/src/_collections/utils/math/random.util.ts +139 -139
  94. package/src/_collections/utils/math/trigonometry.util.spec.ts +57 -57
  95. package/src/_collections/utils/math/trigonometry.util.ts +102 -102
  96. package/src/_collections/utils/math/vector2.util.spec.ts +94 -94
  97. package/src/_collections/utils/math/vector2.util.ts +653 -653
  98. package/src/_collections/utils/object.util.spec.ts +646 -646
  99. package/src/_collections/utils/regex/password-regex.util.spec.ts +51 -51
  100. package/src/_collections/utils/regex/password-regex.util.ts +65 -65
  101. package/src/_collections/utils/regex/regex.util.spec.ts +42 -42
  102. package/src/_collections/utils/regex/regex.util.ts +6 -6
  103. package/src/_collections/utils/regex/username-regex.util.spec.ts +61 -61
  104. package/src/_collections/utils/regex/username-regex.util.ts +35 -35
  105. package/src/_collections/utils/round-list.util.spec.ts +79 -79
  106. package/src/_collections/utils/round-list.util.ts +162 -162
  107. package/src/_collections/utils/stack.util.spec.ts +372 -372
  108. package/src/_collections/utils/stack.util.ts +164 -164
  109. package/src/_collections/utils/string-case.util.spec.ts +441 -441
  110. package/src/_collections/utils/string-case.util.ts +362 -362
  111. package/src/_collections/utils/string.util.spec.ts +975 -975
  112. package/src/_collections/utils/string.util.ts +449 -449
  113. package/src/_collections/utils/time.util.spec.ts +50 -50
  114. package/src/_collections/utils/time.util.ts +481 -481
  115. package/src/_collections/utils/type-cloning-facility.util.spec.ts +51 -51
  116. package/src/_collections/utils/type-cloning-facility.util.ts +168 -168
  117. package/src/_collections/utils/utilities.util.spec.ts +201 -201
  118. package/src/_collections/utils/utilities.util.ts +68 -68
  119. package/src/_collections/utils/uuid.util.spec.ts +30 -30
  120. package/src/_collections/utils/uuid.util.ts +50 -50
  121. package/src/_enums/basic-property-type.enum.ts +20 -20
  122. package/src/_enums/data-model-type.enum.ts +29 -29
  123. package/src/_enums/environment-flag.enum.ts +28 -28
  124. package/src/_enums/error-level.enum.ts +43 -43
  125. package/src/_enums/http/http-call-type.enum.ts +43 -43
  126. package/src/_enums/http/http-event-type.enum.ts +40 -40
  127. package/src/_enums/http/http-response-type.enum.ts +18 -18
  128. package/src/_enums/log-style.enum.ts +44 -44
  129. package/src/_enums/server-connection-status.enum.ts +6 -6
  130. package/src/_enums/time/day-of-week.enum.ts +55 -55
  131. package/src/_enums/time/month.enum.ts +25 -25
  132. package/src/_enums/time/relative-date.enum.ts +24 -24
  133. package/src/_models/control-models/data-model-params.control-model.spec.ts +133 -133
  134. package/src/_models/control-models/data-model-params.control-model.ts +352 -352
  135. package/src/_models/control-models/data-property-params.control-model.spec.ts +93 -93
  136. package/src/_models/control-models/data-property-params.control-model.ts +210 -210
  137. package/src/_models/control-models/error.control-model.spec.ts +912 -912
  138. package/src/_models/control-models/error.control-model.ts +1274 -1274
  139. package/src/_models/control-models/http/http-error-response.control-model.spec.ts +116 -116
  140. package/src/_models/control-models/http/http-error-response.control-model.ts +52 -52
  141. package/src/_models/control-models/http/http-headers.control-model.spec.ts +25 -25
  142. package/src/_models/control-models/http/http-headers.control-model.ts +124 -124
  143. package/src/_models/control-models/http/http-response.model-base.spec.ts +46 -46
  144. package/src/_models/control-models/http/http-response.model-base.ts +57 -57
  145. package/src/_models/control-models/poll.control-model.spec.ts +63 -63
  146. package/src/_models/control-models/poll.control-model.ts +151 -151
  147. package/src/_models/control-models/range-value.control-model.spec.ts +187 -187
  148. package/src/_models/control-models/range-value.control-model.ts +289 -289
  149. package/src/_models/control-models/server-status.control-model.spec.ts +66 -66
  150. package/src/_models/control-models/server-status.control-model.ts +94 -94
  151. package/src/_models/control-models/service-endpoint-settings-base.control-model.spec.ts +145 -145
  152. package/src/_models/control-models/service-endpoint-settings-base.control-model.ts +186 -186
  153. package/src/_models/data-models/errors.data-model.spec.ts +71 -71
  154. package/src/_models/data-models/errors.data-model.ts +175 -175
  155. package/src/_models/data-models/metadata.data-model.spec.ts +184 -184
  156. package/src/_models/data-models/metadata.data-model.ts +153 -153
  157. package/src/_models/interfaces/box-bounds.interface.ts +7 -7
  158. package/src/_models/interfaces/environment/global-log-settings.interface.ts +86 -86
  159. package/src/_models/interfaces/environment/global-settings.interface.ts +47 -47
  160. package/src/_models/interfaces/error-defaults.interface.ts +11 -11
  161. package/src/_models/interfaces/paged.interface.ts +12 -12
  162. package/src/_models/interfaces/random-weight.interface.ts +7 -7
  163. package/src/_models/interfaces/route-settings.interface.ts +15 -15
  164. package/src/_models/interfaces/search-query.interface.ts +23 -23
  165. package/src/_models/interfaces/search-result.interface.ts +5 -5
  166. package/src/_models/interfaces/server-error-statistics.interface.ts +24 -24
  167. package/src/_models/interfaces/vector2.interface.ts +20 -20
  168. package/src/_models/types/db-filter.type.ts +110 -110
  169. package/src/_models/types/db-sort.type.ts +4 -4
  170. package/src/_models/types/ds-filter.type.ts +68 -68
  171. package/src/_models/types/ds-sort.type.ts +21 -21
  172. package/src/_modules/ai/_collections/ai-model-ref.util.ts +88 -88
  173. package/src/_modules/ai/_collections/ai-model-registry.util.spec.ts +37 -37
  174. package/src/_modules/ai/_collections/ai-model-registry.util.ts +30 -30
  175. package/src/_modules/ai/_enums/ai-message-role.enum.ts +7 -7
  176. package/src/_modules/ai/_enums/ai-model-type.enum.ts +7 -7
  177. package/src/_modules/ai/_enums/ai-provider.enum.ts +7 -7
  178. package/src/_modules/ai/_models/ai-call-settings.interface.ts +84 -84
  179. package/src/_modules/ai/_models/ai-embedding-request.interface.ts +20 -20
  180. package/src/_modules/ai/_models/ai-embedding-response.interface.ts +26 -26
  181. package/src/_modules/ai/_models/ai-llm-request.interface.ts +24 -24
  182. package/src/_modules/ai/_models/ai-llm-response.interface.ts +30 -30
  183. package/src/_modules/ai/_models/ai-message.interface.ts +12 -12
  184. package/src/_modules/ai/_models/ai-model-capabilities.interface.ts +35 -35
  185. package/src/_modules/ai/_models/ai-model-info.interface.ts +63 -63
  186. package/src/_modules/ai/_models/ai-model-settings-schema.interface.ts +52 -52
  187. package/src/_modules/ai/_models/ai-provider-capabilities.interface.ts +28 -28
  188. package/src/_modules/ai/_models/ai-settings.interface.ts +17 -17
  189. package/src/_modules/ai/_models/ai-tool-call.interface.ts +18 -18
  190. package/src/_modules/ai/_models/ai-tool-handler.type.ts +11 -11
  191. package/src/_modules/ai/_models/ai-tool-result.interface.ts +16 -16
  192. package/src/_modules/ai/_models/ai-tool.interface.ts +16 -16
  193. package/src/_modules/ai/_models/ai-user-provider-config.control-model.ts +29 -29
  194. package/src/_modules/ai/_modules/anthropic/_collections/aai-models.const.ts +135 -135
  195. package/src/_modules/ai/_modules/anthropic/_enums/aai-model.enum.ts +19 -19
  196. package/src/_modules/ai/_modules/anthropic/_models/aai-call-settings.control-model.spec.ts +28 -28
  197. package/src/_modules/ai/_modules/anthropic/_models/aai-call-settings.control-model.ts +23 -23
  198. package/src/_modules/ai/_modules/anthropic/_models/aai-client-options.interface.ts +10 -10
  199. package/src/_modules/ai/_modules/anthropic/_models/aai-settings.control-model.spec.ts +22 -22
  200. package/src/_modules/ai/_modules/anthropic/_models/aai-settings.control-model.ts +27 -27
  201. package/src/_modules/ai/_modules/anthropic/_models/aai-user-provider-config.control-model.ts +20 -20
  202. package/src/_modules/ai/_modules/anthropic/index.ts +14 -14
  203. package/src/_modules/ai/_modules/document-ai/_models/dai-embedding-info.interface.ts +12 -12
  204. package/src/_modules/ai/_modules/document-ai/_models/dai-vector-search-params.interface.ts +22 -22
  205. package/src/_modules/ai/_modules/document-ai/index.ts +4 -4
  206. package/src/_modules/ai/_modules/fdp-ai/_collections/fdpai-models.const.ts +40 -40
  207. package/src/_modules/ai/_modules/fdp-ai/_enums/fdpai-model.enum.ts +6 -6
  208. package/src/_modules/ai/_modules/fdp-ai/_models/fdpai-call-settings.control-model.ts +19 -19
  209. package/src/_modules/ai/_modules/fdp-ai/_models/fdpai-client-options.interface.ts +11 -11
  210. package/src/_modules/ai/_modules/fdp-ai/_models/fdpai-settings.control-model.ts +24 -24
  211. package/src/_modules/ai/_modules/fdp-ai/_models/fdpai-user-provider-config.control-model.ts +20 -20
  212. package/src/_modules/ai/_modules/fdp-ai/index.ts +11 -11
  213. package/src/_modules/ai/_modules/google-ai/_collections/gai-models.const.ts +161 -161
  214. package/src/_modules/ai/_modules/google-ai/_enums/gai-model.enum.ts +16 -16
  215. package/src/_modules/ai/_modules/google-ai/_models/gai-call-settings.control-model.spec.ts +28 -28
  216. package/src/_modules/ai/_modules/google-ai/_models/gai-call-settings.control-model.ts +21 -21
  217. package/src/_modules/ai/_modules/google-ai/_models/gai-client-options.interface.ts +8 -8
  218. package/src/_modules/ai/_modules/google-ai/_models/gai-settings.control-model.spec.ts +22 -22
  219. package/src/_modules/ai/_modules/google-ai/_models/gai-settings.control-model.ts +25 -25
  220. package/src/_modules/ai/_modules/google-ai/_models/gai-user-provider-config.control-model.ts +20 -20
  221. package/src/_modules/ai/_modules/google-ai/index.ts +14 -14
  222. package/src/_modules/ai/_modules/local-ai/_collections/lai-models.const.ts +59 -59
  223. package/src/_modules/ai/_modules/local-ai/_enums/lai-model.enum.ts +6 -6
  224. package/src/_modules/ai/_modules/local-ai/_models/lai-call-settings.control-model.spec.ts +28 -28
  225. package/src/_modules/ai/_modules/local-ai/_models/lai-call-settings.control-model.ts +18 -18
  226. package/src/_modules/ai/_modules/local-ai/_models/lai-client-options.interface.ts +9 -9
  227. package/src/_modules/ai/_modules/local-ai/_models/lai-settings.control-model.spec.ts +22 -22
  228. package/src/_modules/ai/_modules/local-ai/_models/lai-settings.control-model.ts +23 -23
  229. package/src/_modules/ai/_modules/local-ai/index.ts +14 -14
  230. package/src/_modules/ai/_modules/open-ai/_collections/oai-embedding-model-dimensions.const.ts +7 -7
  231. package/src/_modules/ai/_modules/open-ai/_collections/oai-models.const.ts +404 -404
  232. package/src/_modules/ai/_modules/open-ai/_enums/oai-model.enum.ts +179 -179
  233. package/src/_modules/ai/_modules/open-ai/_models/oai-call-settings.control-model.spec.ts +28 -28
  234. package/src/_modules/ai/_modules/open-ai/_models/oai-call-settings.control-model.ts +21 -21
  235. package/src/_modules/ai/_modules/open-ai/_models/oai-client-options.interface.ts +81 -81
  236. package/src/_modules/ai/_modules/open-ai/_models/oai-embedding-info.interface.ts +13 -13
  237. package/src/_modules/ai/_modules/open-ai/_models/oai-settings.control-model.spec.ts +22 -22
  238. package/src/_modules/ai/_modules/open-ai/_models/oai-settings.control-model.ts +25 -25
  239. package/src/_modules/ai/_modules/open-ai/_models/oai-user-provider-config.control-model.ts +21 -21
  240. package/src/_modules/ai/_modules/open-ai/index.ts +28 -28
  241. package/src/_modules/ai/index.ts +27 -27
  242. package/src/_modules/ci-tools/_enums/cit-ci-result-code.enum.ts +11 -11
  243. package/src/_modules/ci-tools/_enums/cit-ci-step-result-code.enum.ts +9 -9
  244. package/src/_modules/ci-tools/_models/cit-ci-result-info.data-models.spec.ts +58 -58
  245. package/src/_modules/ci-tools/_models/cit-ci-result-info.data-models.ts +77 -77
  246. package/src/_modules/ci-tools/_models/cit-ci-step-result.interface.ts +12 -12
  247. package/src/_modules/ci-tools/index.ts +8 -8
  248. package/src/_modules/crypto/_collections/crypto.util.simple.spec.ts +512 -512
  249. package/src/_modules/crypto/index.ts +13 -13
  250. package/src/_modules/custom-data/_collections/cud-module-settings.const.ts +21 -21
  251. package/src/_modules/custom-data/_models/cud.data-model.spec.ts +38 -38
  252. package/src/_modules/custom-data/_models/cud.data-model.ts +39 -39
  253. package/src/_modules/custom-data/index.ts +10 -10
  254. package/src/_modules/data-handler/_models/data-handler-settings.control-model.spec.ts +110 -110
  255. package/src/_modules/data-handler/_models/data-handler-settings.control-model.ts +110 -110
  256. package/src/_modules/data-handler/_models/data-handler.control-model.spec.ts +473 -473
  257. package/src/_modules/data-handler/_models/data-handler.control-model.ts +486 -486
  258. package/src/_modules/data-handler/_models/data-list-handler.control-model.spec.ts +263 -263
  259. package/src/_modules/data-handler/_models/data-list-handler.control-model.ts +252 -252
  260. package/src/_modules/data-handler/_models/data-search-handler.control-model.spec.ts +417 -417
  261. package/src/_modules/data-handler/_models/data-search-handler.control-model.ts +390 -390
  262. package/src/_modules/data-handler/_models/list-collector-data-handler.control-model.spec.ts +374 -374
  263. package/src/_modules/data-handler/_models/list-collector-data-handler.control-model.ts +274 -274
  264. package/src/_modules/data-handler/index.ts +6 -6
  265. package/src/_modules/game/_collections/audio-mixer.util.spec.ts +198 -0
  266. package/src/_modules/game/_collections/audio-mixer.util.ts +143 -0
  267. package/src/_modules/game/_collections/audio-scale.util.spec.ts +140 -0
  268. package/src/_modules/game/_collections/audio-scale.util.ts +129 -0
  269. package/src/_modules/game/_enums/audio-channel.enum.ts +22 -0
  270. package/src/_modules/game/_models/audio-mixer-config.interface.ts +45 -0
  271. package/src/_modules/game/_models/audio-mixer-settings.interface.ts +28 -0
  272. package/src/_modules/game/_models/audio-mixer-state.interface.ts +23 -0
  273. package/src/_modules/game/_models/audio-mixer.control-model.spec.ts +306 -0
  274. package/src/_modules/game/_models/audio-mixer.control-model.ts +378 -0
  275. package/src/_modules/game/_models/audio-scale.interface.ts +21 -0
  276. package/src/_modules/game/_models/seeded-random-state.interface.ts +21 -0
  277. package/src/_modules/game/_models/seeded-random.control-model.spec.ts +290 -0
  278. package/src/_modules/game/_models/seeded-random.control-model.ts +311 -0
  279. package/src/_modules/game/index.ts +15 -0
  280. package/src/_modules/location/_collections/assets/country-codes-ISO-3166.json +3239 -3239
  281. package/src/_modules/location/_collections/assets/country-divisions-ISO-3166-all-list.json +19035 -19035
  282. package/src/_modules/location/_collections/assets/country-divisions-ISO-3166.json +4993 -4993
  283. package/src/_modules/location/_collections/assets/country-phone-codes.json +1203 -1203
  284. package/src/_modules/location/_collections/assets/country-subdivisions/afghanistan.json +137 -137
  285. package/src/_modules/location/_collections/assets/country-subdivisions/albania.json +49 -49
  286. package/src/_modules/location/_collections/assets/country-subdivisions/algeria.json +193 -193
  287. package/src/_modules/location/_collections/assets/country-subdivisions/andorra.json +29 -29
  288. package/src/_modules/location/_collections/assets/country-subdivisions/angola.json +73 -73
  289. package/src/_modules/location/_collections/assets/country-subdivisions/antigua-and-barbuda.json +33 -33
  290. package/src/_modules/location/_collections/assets/country-subdivisions/argentina.json +97 -97
  291. package/src/_modules/location/_collections/assets/country-subdivisions/armenia.json +45 -45
  292. package/src/_modules/location/_collections/assets/country-subdivisions/australia.json +33 -33
  293. package/src/_modules/location/_collections/assets/country-subdivisions/austria.json +37 -37
  294. package/src/_modules/location/_collections/assets/country-subdivisions/azerbaijan.json +5 -5
  295. package/src/_modules/location/_collections/assets/country-subdivisions/bahamas.json +125 -125
  296. package/src/_modules/location/_collections/assets/country-subdivisions/bahrain.json +21 -21
  297. package/src/_modules/location/_collections/assets/country-subdivisions/bangladesh.json +29 -29
  298. package/src/_modules/location/_collections/assets/country-subdivisions/barbados.json +45 -45
  299. package/src/_modules/location/_collections/assets/country-subdivisions/belarus.json +29 -29
  300. package/src/_modules/location/_collections/assets/country-subdivisions/belgium.json +13 -13
  301. package/src/_modules/location/_collections/assets/country-subdivisions/belize.json +25 -25
  302. package/src/_modules/location/_collections/assets/country-subdivisions/benin.json +49 -49
  303. package/src/_modules/location/_collections/assets/country-subdivisions/bhutan.json +81 -81
  304. package/src/_modules/location/_collections/assets/country-subdivisions/bolivia.json +37 -37
  305. package/src/_modules/location/_collections/assets/country-subdivisions/bosnia-and-herzegovina.json +13 -13
  306. package/src/_modules/location/_collections/assets/country-subdivisions/botswana.json +65 -65
  307. package/src/_modules/location/_collections/assets/country-subdivisions/brazil.json +109 -109
  308. package/src/_modules/location/_collections/assets/country-subdivisions/brunei-darussalam.json +17 -17
  309. package/src/_modules/location/_collections/assets/country-subdivisions/bulgaria.json +113 -113
  310. package/src/_modules/location/_collections/assets/country-subdivisions/burkina-faso.json +53 -53
  311. package/src/_modules/location/_collections/assets/country-subdivisions/burundi.json +69 -69
  312. package/src/_modules/location/_collections/assets/country-subdivisions/cambodia.json +97 -97
  313. package/src/_modules/location/_collections/assets/country-subdivisions/cameroon.json +41 -41
  314. package/src/_modules/location/_collections/assets/country-subdivisions/canada.json +79 -79
  315. package/src/_modules/location/_collections/assets/country-subdivisions/cape-verde.json +9 -9
  316. package/src/_modules/location/_collections/assets/country-subdivisions/central-african-republic.json +69 -69
  317. package/src/_modules/location/_collections/assets/country-subdivisions/chad.json +89 -89
  318. package/src/_modules/location/_collections/assets/country-subdivisions/chile.json +61 -61
  319. package/src/_modules/location/_collections/assets/country-subdivisions/china.json +205 -205
  320. package/src/_modules/location/_collections/assets/country-subdivisions/colombia.json +133 -133
  321. package/src/_modules/location/_collections/assets/country-subdivisions/comoros.json +13 -13
  322. package/src/_modules/location/_collections/assets/country-subdivisions/congo-the-democratic-republic-of-the.json +45 -45
  323. package/src/_modules/location/_collections/assets/country-subdivisions/congo.json +49 -49
  324. package/src/_modules/location/_collections/assets/country-subdivisions/costa-rica.json +29 -29
  325. package/src/_modules/location/_collections/assets/country-subdivisions/cote-d-ivoire-republic-of.json +77 -77
  326. package/src/_modules/location/_collections/assets/country-subdivisions/croatia.json +85 -85
  327. package/src/_modules/location/_collections/assets/country-subdivisions/cuba.json +65 -65
  328. package/src/_modules/location/_collections/assets/country-subdivisions/cyprus.json +25 -25
  329. package/src/_modules/location/_collections/assets/country-subdivisions/czech-republic.json +57 -57
  330. package/src/_modules/location/_collections/assets/country-subdivisions/denmark.json +21 -21
  331. package/src/_modules/location/_collections/assets/country-subdivisions/djibouti.json +25 -25
  332. package/src/_modules/location/_collections/assets/country-subdivisions/dominica.json +41 -41
  333. package/src/_modules/location/_collections/assets/country-subdivisions/dominican-republic.json +41 -41
  334. package/src/_modules/location/_collections/assets/country-subdivisions/ecuador.json +97 -97
  335. package/src/_modules/location/_collections/assets/country-subdivisions/egypt.json +117 -117
  336. package/src/_modules/location/_collections/assets/country-subdivisions/el-salvador.json +57 -57
  337. package/src/_modules/location/_collections/assets/country-subdivisions/equatorial-guinea.json +9 -9
  338. package/src/_modules/location/_collections/assets/country-subdivisions/eritrea.json +25 -25
  339. package/src/_modules/location/_collections/assets/country-subdivisions/estonia.json +61 -61
  340. package/src/_modules/location/_collections/assets/country-subdivisions/ethiopia.json +45 -45
  341. package/src/_modules/location/_collections/assets/country-subdivisions/fiji.json +21 -21
  342. package/src/_modules/location/_collections/assets/country-subdivisions/finland.json +77 -77
  343. package/src/_modules/location/_collections/assets/country-subdivisions/france.json +133 -133
  344. package/src/_modules/location/_collections/assets/country-subdivisions/gabon.json +37 -37
  345. package/src/_modules/location/_collections/assets/country-subdivisions/gambia.json +25 -25
  346. package/src/_modules/location/_collections/assets/country-subdivisions/georgia.json +49 -49
  347. package/src/_modules/location/_collections/assets/country-subdivisions/germany.json +65 -65
  348. package/src/_modules/location/_collections/assets/country-subdivisions/ghana.json +41 -41
  349. package/src/_modules/location/_collections/assets/country-subdivisions/greece.json +53 -53
  350. package/src/_modules/location/_collections/assets/country-subdivisions/greenland.json +17 -17
  351. package/src/_modules/location/_collections/assets/country-subdivisions/grenada.json +29 -29
  352. package/src/_modules/location/_collections/assets/country-subdivisions/guatemala.json +89 -89
  353. package/src/_modules/location/_collections/assets/country-subdivisions/guinea-bissau.json +13 -13
  354. package/src/_modules/location/_collections/assets/country-subdivisions/guinea.json +33 -33
  355. package/src/_modules/location/_collections/assets/country-subdivisions/guyana.json +41 -41
  356. package/src/_modules/location/_collections/assets/country-subdivisions/haiti.json +41 -41
  357. package/src/_modules/location/_collections/assets/country-subdivisions/honduras.json +73 -73
  358. package/src/_modules/location/_collections/assets/country-subdivisions/hong-kong.json +4 -4
  359. package/src/_modules/location/_collections/assets/country-subdivisions/hungary.json +173 -173
  360. package/src/_modules/location/_collections/assets/country-subdivisions/iceland.json +37 -37
  361. package/src/_modules/location/_collections/assets/country-subdivisions/india.json +181 -181
  362. package/src/_modules/location/_collections/assets/country-subdivisions/indonesia.json +29 -29
  363. package/src/_modules/location/_collections/assets/country-subdivisions/iran-islamic-republic-of.json +125 -125
  364. package/src/_modules/location/_collections/assets/country-subdivisions/iraq.json +73 -73
  365. package/src/_modules/location/_collections/assets/country-subdivisions/ireland.json +17 -17
  366. package/src/_modules/location/_collections/assets/country-subdivisions/israel.json +25 -25
  367. package/src/_modules/location/_collections/assets/country-subdivisions/italy.json +81 -81
  368. package/src/_modules/location/_collections/assets/country-subdivisions/jamaica.json +57 -57
  369. package/src/_modules/location/_collections/assets/country-subdivisions/japan.json +189 -189
  370. package/src/_modules/location/_collections/assets/country-subdivisions/jordan.json +49 -49
  371. package/src/_modules/location/_collections/assets/country-subdivisions/kazakhstan.json +65 -65
  372. package/src/_modules/location/_collections/assets/country-subdivisions/kenya.json +33 -33
  373. package/src/_modules/location/_collections/assets/country-subdivisions/kiribati.json +13 -13
  374. package/src/_modules/location/_collections/assets/country-subdivisions/korea-democratic-people-s-republic-of.json +45 -45
  375. package/src/_modules/location/_collections/assets/country-subdivisions/korea-republic-of.json +69 -69
  376. package/src/_modules/location/_collections/assets/country-subdivisions/kuwait.json +25 -25
  377. package/src/_modules/location/_collections/assets/country-subdivisions/kyrgyzstan.json +33 -33
  378. package/src/_modules/location/_collections/assets/country-subdivisions/lao-people-s-democratic-republic.json +73 -73
  379. package/src/_modules/location/_collections/assets/country-subdivisions/latvia.json +477 -477
  380. package/src/_modules/location/_collections/assets/country-subdivisions/lebanon.json +33 -33
  381. package/src/_modules/location/_collections/assets/country-subdivisions/lesotho.json +41 -41
  382. package/src/_modules/location/_collections/assets/country-subdivisions/liberia.json +61 -61
  383. package/src/_modules/location/_collections/assets/country-subdivisions/libyan-arab-jamahiriya.json +89 -89
  384. package/src/_modules/location/_collections/assets/country-subdivisions/liechtenstein.json +45 -45
  385. package/src/_modules/location/_collections/assets/country-subdivisions/lithuania.json +41 -41
  386. package/src/_modules/location/_collections/assets/country-subdivisions/luxembourg.json +13 -13
  387. package/src/_modules/location/_collections/assets/country-subdivisions/macedonia-the-former-yugoslav-republic-of.json +337 -337
  388. package/src/_modules/location/_collections/assets/country-subdivisions/madagascar.json +25 -25
  389. package/src/_modules/location/_collections/assets/country-subdivisions/malawi.json +13 -13
  390. package/src/_modules/location/_collections/assets/country-subdivisions/malaysia.json +81 -81
  391. package/src/_modules/location/_collections/assets/country-subdivisions/maldives.json +33 -33
  392. package/src/_modules/location/_collections/assets/country-subdivisions/mali.json +37 -37
  393. package/src/_modules/location/_collections/assets/country-subdivisions/malta.json +273 -273
  394. package/src/_modules/location/_collections/assets/country-subdivisions/marshall-islands.json +9 -9
  395. package/src/_modules/location/_collections/assets/country-subdivisions/mauritania.json +53 -53
  396. package/src/_modules/location/_collections/assets/country-subdivisions/mauritius.json +69 -69
  397. package/src/_modules/location/_collections/assets/country-subdivisions/mexico.json +161 -161
  398. package/src/_modules/location/_collections/assets/country-subdivisions/micronesia-federated-states-of.json +17 -17
  399. package/src/_modules/location/_collections/assets/country-subdivisions/moldova-republic-of.json +149 -149
  400. package/src/_modules/location/_collections/assets/country-subdivisions/monaco.json +69 -69
  401. package/src/_modules/location/_collections/assets/country-subdivisions/mongolia.json +89 -89
  402. package/src/_modules/location/_collections/assets/country-subdivisions/montenegro.json +93 -93
  403. package/src/_modules/location/_collections/assets/country-subdivisions/morocco.json +65 -65
  404. package/src/_modules/location/_collections/assets/country-subdivisions/mozambique.json +45 -45
  405. package/src/_modules/location/_collections/assets/country-subdivisions/myanmar.json +57 -57
  406. package/src/_modules/location/_collections/assets/country-subdivisions/namibia.json +57 -57
  407. package/src/_modules/location/_collections/assets/country-subdivisions/nauru.json +57 -57
  408. package/src/_modules/location/_collections/assets/country-subdivisions/nepal.json +21 -21
  409. package/src/_modules/location/_collections/assets/country-subdivisions/netherlands.json +91 -91
  410. package/src/_modules/location/_collections/assets/country-subdivisions/new-zealand.json +111 -111
  411. package/src/_modules/location/_collections/assets/country-subdivisions/nicaragua.json +69 -69
  412. package/src/_modules/location/_collections/assets/country-subdivisions/niger.json +33 -33
  413. package/src/_modules/location/_collections/assets/country-subdivisions/nigeria.json +149 -149
  414. package/src/_modules/location/_collections/assets/country-subdivisions/norway.json +85 -85
  415. package/src/_modules/location/_collections/assets/country-subdivisions/oman.json +37 -37
  416. package/src/_modules/location/_collections/assets/country-subdivisions/pakistan.json +33 -33
  417. package/src/_modules/location/_collections/assets/country-subdivisions/palau.json +65 -65
  418. package/src/_modules/location/_collections/assets/country-subdivisions/palestinian-territory-occupied.json +65 -65
  419. package/src/_modules/location/_collections/assets/country-subdivisions/panama.json +53 -53
  420. package/src/_modules/location/_collections/assets/country-subdivisions/papua-new-guinea.json +81 -81
  421. package/src/_modules/location/_collections/assets/country-subdivisions/paraguay.json +73 -73
  422. package/src/_modules/location/_collections/assets/country-subdivisions/peru.json +105 -105
  423. package/src/_modules/location/_collections/assets/country-subdivisions/philippines.json +69 -69
  424. package/src/_modules/location/_collections/assets/country-subdivisions/poland.json +65 -65
  425. package/src/_modules/location/_collections/assets/country-subdivisions/portugal.json +81 -81
  426. package/src/_modules/location/_collections/assets/country-subdivisions/qatar.json +29 -29
  427. package/src/_modules/location/_collections/assets/country-subdivisions/romania.json +169 -169
  428. package/src/_modules/location/_collections/assets/country-subdivisions/russian-federation.json +499 -499
  429. package/src/_modules/location/_collections/assets/country-subdivisions/rwanda.json +21 -21
  430. package/src/_modules/location/_collections/assets/country-subdivisions/saint-helena-ascension-and-tristan-da-cunha.json +13 -13
  431. package/src/_modules/location/_collections/assets/country-subdivisions/saint-kitts-and-nevis.json +9 -9
  432. package/src/_modules/location/_collections/assets/country-subdivisions/saint-lucia.json +45 -45
  433. package/src/_modules/location/_collections/assets/country-subdivisions/saint-vincent-and-the-grenadines.json +25 -25
  434. package/src/_modules/location/_collections/assets/country-subdivisions/samoa.json +45 -45
  435. package/src/_modules/location/_collections/assets/country-subdivisions/san-marino.json +37 -37
  436. package/src/_modules/location/_collections/assets/country-subdivisions/sao-tome-and-principe.json +9 -9
  437. package/src/_modules/location/_collections/assets/country-subdivisions/saudi-arabia.json +53 -53
  438. package/src/_modules/location/_collections/assets/country-subdivisions/senegal.json +57 -57
  439. package/src/_modules/location/_collections/assets/country-subdivisions/serbia.json +9 -9
  440. package/src/_modules/location/_collections/assets/country-subdivisions/seychelles.json +101 -101
  441. package/src/_modules/location/_collections/assets/country-subdivisions/sierra-leone.json +17 -17
  442. package/src/_modules/location/_collections/assets/country-subdivisions/singapore.json +21 -21
  443. package/src/_modules/location/_collections/assets/country-subdivisions/slovakia.json +33 -33
  444. package/src/_modules/location/_collections/assets/country-subdivisions/slovenia.json +841 -841
  445. package/src/_modules/location/_collections/assets/country-subdivisions/solomon-islands.json +41 -41
  446. package/src/_modules/location/_collections/assets/country-subdivisions/somalia.json +73 -73
  447. package/src/_modules/location/_collections/assets/country-subdivisions/south-africa.json +37 -37
  448. package/src/_modules/location/_collections/assets/country-subdivisions/south-sudan.json +41 -41
  449. package/src/_modules/location/_collections/assets/country-subdivisions/spain.json +346 -346
  450. package/src/_modules/location/_collections/assets/country-subdivisions/sri-lanka.json +37 -37
  451. package/src/_modules/location/_collections/assets/country-subdivisions/sudan.json +69 -69
  452. package/src/_modules/location/_collections/assets/country-subdivisions/suriname.json +41 -41
  453. package/src/_modules/location/_collections/assets/country-subdivisions/swaziland.json +17 -17
  454. package/src/_modules/location/_collections/assets/country-subdivisions/sweden.json +85 -85
  455. package/src/_modules/location/_collections/assets/country-subdivisions/switzerland.json +105 -105
  456. package/src/_modules/location/_collections/assets/country-subdivisions/syrian-arab-republic.json +57 -57
  457. package/src/_modules/location/_collections/assets/country-subdivisions/taiwan-province-of-china.json +93 -93
  458. package/src/_modules/location/_collections/assets/country-subdivisions/tajikistan.json +17 -17
  459. package/src/_modules/location/_collections/assets/country-subdivisions/tanzania-united-republic-of.json +105 -105
  460. package/src/_modules/location/_collections/assets/country-subdivisions/thailand.json +313 -313
  461. package/src/_modules/location/_collections/assets/country-subdivisions/timor-leste.json +53 -53
  462. package/src/_modules/location/_collections/assets/country-subdivisions/togo.json +21 -21
  463. package/src/_modules/location/_collections/assets/country-subdivisions/tonga.json +21 -21
  464. package/src/_modules/location/_collections/assets/country-subdivisions/trinidad-and-tobago.json +65 -65
  465. package/src/_modules/location/_collections/assets/country-subdivisions/tunisia.json +97 -97
  466. package/src/_modules/location/_collections/assets/country-subdivisions/turkey.json +325 -325
  467. package/src/_modules/location/_collections/assets/country-subdivisions/turkmenistan.json +25 -25
  468. package/src/_modules/location/_collections/assets/country-subdivisions/tuvalu.json +33 -33
  469. package/src/_modules/location/_collections/assets/country-subdivisions/uganda.json +17 -17
  470. package/src/_modules/location/_collections/assets/country-subdivisions/ukraine.json +109 -109
  471. package/src/_modules/location/_collections/assets/country-subdivisions/united-arab-emirates.json +29 -29
  472. package/src/_modules/location/_collections/assets/country-subdivisions/united-kingdom.json +1196 -1196
  473. package/src/_modules/location/_collections/assets/country-subdivisions/united-states-minor-outlying-islands.json +37 -37
  474. package/src/_modules/location/_collections/assets/country-subdivisions/united-states.json +286 -286
  475. package/src/_modules/location/_collections/assets/country-subdivisions/uruguay.json +77 -77
  476. package/src/_modules/location/_collections/assets/country-subdivisions/uzbekistan.json +57 -57
  477. package/src/_modules/location/_collections/assets/country-subdivisions/vanuatu.json +25 -25
  478. package/src/_modules/location/_collections/assets/country-subdivisions/venezuela.json +101 -101
  479. package/src/_modules/location/_collections/assets/country-subdivisions/viet-nam.json +257 -257
  480. package/src/_modules/location/_collections/assets/country-subdivisions/yemen.json +85 -85
  481. package/src/_modules/location/_collections/assets/country-subdivisions/zambia.json +37 -37
  482. package/src/_modules/location/_collections/assets/country-subdivisions/zimbabwe.json +41 -41
  483. package/src/_modules/location/_collections/loc-country-divisions.const.ts +10 -10
  484. package/src/_modules/location/_collections/loc-country-isos.const.ts +8 -8
  485. package/src/_modules/location/_collections/loc-regions.util.spec.ts +61 -61
  486. package/src/_modules/location/_collections/loc-regions.util.ts +137 -137
  487. package/src/_modules/location/_collections/loc.util.spec.ts +52 -52
  488. package/src/_modules/location/_collections/loc.util.ts +74 -74
  489. package/src/_modules/location/_enums/loc-region.enum.ts +14 -14
  490. package/src/_modules/location/_enums/loc-sub-region.enum.ts +31 -31
  491. package/src/_modules/location/_enums/loc-subdivision-region-type.enum.ts +47 -47
  492. package/src/_modules/location/_models/loc-coordinates.interface.ts +7 -7
  493. package/src/_modules/location/_models/loc-country-division.interface.ts +8 -8
  494. package/src/_modules/location/_models/loc-country-iso.interface.ts +23 -23
  495. package/src/_modules/location/_models/loc-country-phone-code.interface.ts +9 -9
  496. package/src/_modules/location/_models/loc-division-collection.interface.ts +12 -12
  497. package/src/_modules/location/_models/loc-division-region-data.interface.ts +9 -9
  498. package/src/_modules/location/_models/loc-geo-ip-location.interface.ts +27 -27
  499. package/src/_modules/location/index.ts +22 -22
  500. package/src/_modules/messaging/README.md +279 -279
  501. package/src/_modules/messaging/_collections/msg-module-settings.const.ts +46 -46
  502. package/src/_modules/messaging/_enums/msg-attachment-type.enum.ts +26 -26
  503. package/src/_modules/messaging/_enums/msg-delivery-status.enum.ts +17 -17
  504. package/src/_modules/messaging/_enums/msg-event-key.enum.ts +31 -31
  505. package/src/_modules/messaging/_enums/msg-participant-role.enum.ts +20 -20
  506. package/src/_modules/messaging/_enums/msg-provider-type.enum.ts +7 -7
  507. package/src/_modules/messaging/_enums/msg-type.enum.ts +23 -23
  508. package/src/_modules/messaging/_models/msg-attachment.interface.ts +46 -46
  509. package/src/_modules/messaging/_models/msg-conversation.data-model.spec.ts +69 -69
  510. package/src/_modules/messaging/_models/msg-conversation.data-model.ts +96 -96
  511. package/src/_modules/messaging/_models/msg-mention.interface.ts +29 -29
  512. package/src/_modules/messaging/_models/msg-message.data-model.spec.ts +79 -79
  513. package/src/_modules/messaging/_models/msg-message.data-model.ts +127 -127
  514. package/src/_modules/messaging/_models/msg-participant.interface.ts +46 -46
  515. package/src/_modules/messaging/_models/msg-reaction.interface.ts +20 -20
  516. package/src/_modules/messaging/_models/msg-thread-info.interface.ts +35 -35
  517. package/src/_modules/messaging/_modules/agent/_enums/agt-process-step-type.enum.ts +35 -35
  518. package/src/_modules/messaging/_modules/agent/_enums/agt-tool-status.enum.ts +23 -23
  519. package/src/_modules/messaging/_modules/agent/_models/agt-process-step.interface.ts +55 -55
  520. package/src/_modules/messaging/_modules/agent/_models/agt-reasoning-info.interface.ts +26 -26
  521. package/src/_modules/messaging/_modules/agent/_models/agt-tool-usage.interface.ts +37 -37
  522. package/src/_modules/messaging/_modules/agent/index.ts +8 -8
  523. package/src/_modules/messaging/index.ts +28 -28
  524. package/src/_modules/pipe/_collections/pip-transforms.const.ts +42 -42
  525. package/src/_modules/pipe/_collections/utils/pip-country-pipe.util.spec.ts +47 -47
  526. package/src/_modules/pipe/_collections/utils/pip-country-pipe.util.ts +41 -41
  527. package/src/_modules/pipe/_collections/utils/pip-custom-pipe.util.spec.ts +39 -39
  528. package/src/_modules/pipe/_collections/utils/pip-custom-pipe.util.ts +30 -30
  529. package/src/_modules/pipe/_collections/utils/pip-division-pipe.util.spec.ts +41 -41
  530. package/src/_modules/pipe/_collections/utils/pip-division-pipe.util.ts +36 -36
  531. package/src/_modules/pipe/_collections/utils/pip-json-pipe.util.spec.ts +62 -62
  532. package/src/_modules/pipe/_collections/utils/pip-json-pipe.util.ts +17 -17
  533. package/src/_modules/pipe/_collections/utils/pip-list-pipe.util.spec.ts +34 -34
  534. package/src/_modules/pipe/_collections/utils/pip-list-pipe.util.ts +25 -25
  535. package/src/_modules/pipe/_collections/utils/pip-multi-pipe-pipe.util.spec.ts +67 -67
  536. package/src/_modules/pipe/_collections/utils/pip-multi-pipe-pipe.util.ts +226 -226
  537. package/src/_modules/pipe/_collections/utils/pip-obj-key-pipe.util.spec.ts +28 -28
  538. package/src/_modules/pipe/_collections/utils/pip-obj-key-pipe.util.ts +21 -21
  539. package/src/_modules/pipe/_collections/utils/pip-range-pipe.util.spec.ts +59 -59
  540. package/src/_modules/pipe/_collections/utils/pip-range-pipe.util.ts +106 -106
  541. package/src/_modules/pipe/_collections/utils/pip-region-pipe.util.spec.ts +31 -31
  542. package/src/_modules/pipe/_collections/utils/pip-region-pipe.util.ts +35 -35
  543. package/src/_modules/pipe/_collections/utils/pip-replace-pipe.util.spec.ts +44 -44
  544. package/src/_modules/pipe/_collections/utils/pip-replace-pipe.util.ts +23 -23
  545. package/src/_modules/pipe/_collections/utils/pip-slider-pipe.util.spec.ts +21 -21
  546. package/src/_modules/pipe/_collections/utils/pip-slider-pipe.util.ts +33 -33
  547. package/src/_modules/pipe/_collections/utils/pip-smart-replace-pipe.util.spec.ts +62 -62
  548. package/src/_modules/pipe/_collections/utils/pip-smart-replace-pipe.util.ts +80 -80
  549. package/src/_modules/pipe/_enums/pip-range-pipe-setting.enum.ts +15 -15
  550. package/src/_modules/pipe/_enums/pip.enum.ts +65 -65
  551. package/src/_modules/pipe/_models/pip-multi-pipe-settings.type.ts +8 -8
  552. package/src/_modules/pipe/_models/pip-transforms.interface.ts +30 -30
  553. package/src/_modules/pipe/index.ts +30 -30
  554. package/src/_modules/socket/_enums/sck-event-key.enum.ts +21 -21
  555. package/src/_modules/socket/_models/sck-client-params.control-model.spec.ts +67 -67
  556. package/src/_modules/socket/_models/sck-client-params.control-model.ts +50 -50
  557. package/src/_modules/socket/_models/sck-socket-event.control-model.spec.ts +66 -66
  558. package/src/_modules/socket/_models/sck-socket-event.control-model.ts +172 -172
  559. package/src/_modules/socket/_services/sck-client.service-base.spec.ts +99 -99
  560. package/src/_modules/socket/_services/sck-client.service-base.ts +353 -353
  561. package/src/_modules/socket/index.ts +14 -14
  562. package/src/_modules/test/_collections/tst-module-settings.const.ts +67 -67
  563. package/src/_modules/test/index.ts +5 -5
  564. package/src/_modules/usage/_collections/usg-module-settings.const.ts +33 -33
  565. package/src/_modules/usage/_models/usg-action.control-model.spec.ts +27 -27
  566. package/src/_modules/usage/_models/usg-action.control-model.ts +28 -28
  567. package/src/_modules/usage/_models/usg-daily-usage-data.control-model.spec.ts +36 -36
  568. package/src/_modules/usage/_models/usg-daily-usage-data.control-model.ts +35 -35
  569. package/src/_modules/usage/_models/usg-data.control-model.spec.ts +41 -41
  570. package/src/_modules/usage/_models/usg-data.control-model.ts +35 -35
  571. package/src/_modules/usage/_models/usg-session.data-model.spec.ts +97 -97
  572. package/src/_modules/usage/_models/usg-session.data-model.ts +72 -72
  573. package/src/_modules/usage/index.ts +11 -11
  574. package/src/index.ts +104 -104
  575. package/tsconfig.app.json +12 -12
  576. package/tsconfig.json +31 -31
  577. package/tsconfig.test.json +16 -16
  578. package/tslint.json +153 -153
@@ -0,0 +1,312 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.DyFM_AudioMixer_ControlModel = void 0;
4
+ const error_control_model_1 = require("../../../_models/control-models/error.control-model");
5
+ const audio_scale_util_1 = require("../_collections/audio-scale.util");
6
+ /**
7
+ * **Csatorna- es skala-agnosztikus** jatek-audio mixer: a projekt deklaralja a sajat
8
+ * csatornait es szamabrazolasat, a modell pedig kezeli az allapotot es kiszamolja az
9
+ * effektiv hangerot.
10
+ *
11
+ * **Miert letezik a `DyFM_AudioMixer_Util` (round-1) mellett:** az a util negy FIX csatornara
12
+ * (`music` / `ambience` / `effects`) es `0..1` skalara epul. Ez a Prototyper harom prototipusara
13
+ * igaz, de a **Hero Coordinator** csatornai `music` / `dialog` / `interface`, az ertekei pedig
14
+ * `0-100` egeszek. A fix alak ott csatorna-vesztessel es kotelezo adat-migracioval jarna.
15
+ * Ez a modell mindkettot kiszolgalja; a round-1 alak `createClassic()` presetkent tovabb el.
16
+ *
17
+ * **Rendereles-agnosztikus:** NINCS DOM, Web Audio, Angular vagy Node fuggese. A tenyleges
18
+ * lejatszas (HTMLAudioElement, Web Audio `GainNode`, vagy barmi mas) a fogyasztoe — ez a
19
+ * **modell + szamitas**.
20
+ *
21
+ * **Hasznalat (Hero Coordinator-stilus, 0-100 egesz):**
22
+ * ```typescript
23
+ * const mixer = DyFM_AudioMixer_ControlModel.createPercent(['music', 'dialog', 'interface'], {
24
+ * music: 36, dialog: 84, interface: 68,
25
+ * }, 72);
26
+ *
27
+ * let state = mixer.merge(JSON.parse(localStorage.getItem('audio') ?? 'null'));
28
+ * gainNode.gain.value = mixer.getEffectiveVolume(state, 'interface'); // MINDIG 0..1
29
+ *
30
+ * state = mixer.withChannelVolume(state, 'music', 40); // a sajat skalajan adjuk meg
31
+ * localStorage.setItem('audio', JSON.stringify(state));
32
+ * ```
33
+ *
34
+ * **Hasznalat (Prototyper-stilus, 0..1):**
35
+ * ```typescript
36
+ * const mixer = DyFM_AudioMixer_ControlModel.createClassic();
37
+ * const state = DyFM_AudioMixer_ControlModel.fromClassicSettings(legacySettings);
38
+ * ```
39
+ */
40
+ class DyFM_AudioMixer_ControlModel {
41
+ /** A `master` fenntartott nev — nem lehet sima csatorna, mert minden csatornara szorzodik. */
42
+ static masterChannel = 'master';
43
+ /** A validalt, sajat peldany-config (a hivo altal atadott objektumtol fuggetlen masolat). */
44
+ config;
45
+ /**
46
+ * A config validalasa **konstruktor-idoben** tortenik: egy elgepelt csatorna-nev vagy hianyzo
47
+ * skala igy a jatek inditasakor derul ki, nem hangleajatszas kozben.
48
+ */
49
+ constructor(config) {
50
+ if (!config || !Array.isArray(config.channels) || !config.channels.length) {
51
+ throw new error_control_model_1.DyFM_Error({
52
+ errorCode: 'DYFM-AUDIO-MIXER-001',
53
+ message: 'DyFM_AudioMixer_ControlModel: config.channels must be a non-empty string array',
54
+ additionalContent: { config: config },
55
+ });
56
+ }
57
+ const seen = [];
58
+ for (const channel of config.channels) {
59
+ if (typeof channel !== 'string' || !channel.length) {
60
+ throw new error_control_model_1.DyFM_Error({
61
+ errorCode: 'DYFM-AUDIO-MIXER-002',
62
+ message: 'DyFM_AudioMixer_ControlModel: every channel name must be a non-empty string',
63
+ additionalContent: { channels: config.channels },
64
+ });
65
+ }
66
+ if (channel === DyFM_AudioMixer_ControlModel.masterChannel) {
67
+ throw new error_control_model_1.DyFM_Error({
68
+ errorCode: 'DYFM-AUDIO-MIXER-003',
69
+ message: 'DyFM_AudioMixer_ControlModel: "master" is reserved and must not be listed in channels',
70
+ additionalContent: { channels: config.channels },
71
+ });
72
+ }
73
+ if (seen.includes(channel)) {
74
+ throw new error_control_model_1.DyFM_Error({
75
+ errorCode: 'DYFM-AUDIO-MIXER-004',
76
+ message: 'DyFM_AudioMixer_ControlModel: duplicate channel name',
77
+ additionalContent: { channel: channel, channels: config.channels },
78
+ });
79
+ }
80
+ seen.push(channel);
81
+ }
82
+ const scale = config.scale && typeof config.scale.max === 'number'
83
+ ? { max: config.scale.max, integer: config.scale.integer === true }
84
+ : audio_scale_util_1.DyFM_AudioScale_Util.getUnitScale();
85
+ this.config = {
86
+ channels: [...config.channels],
87
+ scale: scale,
88
+ defaults: config.defaults ? { ...config.defaults } : {},
89
+ defaultMaster: config.defaultMaster,
90
+ defaultChannelVolume: config.defaultChannelVolume,
91
+ };
92
+ }
93
+ /**
94
+ * A round-1 `DyFM_AudioMixer_Settings` alakjaval egyenerteku mixer (`music` / `ambience` /
95
+ * `effects`, `0..1` skala, 0.8 default). A Prototyper-stilusu fogyasztoknak.
96
+ */
97
+ static createClassic() {
98
+ return new DyFM_AudioMixer_ControlModel({
99
+ channels: ['music', 'ambience', 'effects'],
100
+ scale: audio_scale_util_1.DyFM_AudioScale_Util.getUnitScale(),
101
+ defaultMaster: audio_scale_util_1.DyFM_AudioScale_Util.defaultRatio,
102
+ defaultChannelVolume: audio_scale_util_1.DyFM_AudioScale_Util.defaultRatio,
103
+ });
104
+ }
105
+ /**
106
+ * `0-100` egesz skalaju mixer tetszoleges csatorna-keszlettel — a Hero Coordinator-stilusu
107
+ * fogyasztoknak, akik igy **adat-migracio nelkul** vehetik hasznalatba a bedrock modellt.
108
+ */
109
+ static createPercent(channels, defaults, defaultMaster) {
110
+ return new DyFM_AudioMixer_ControlModel({
111
+ channels: channels,
112
+ scale: audio_scale_util_1.DyFM_AudioScale_Util.getPercentScale(),
113
+ defaults: defaults,
114
+ defaultMaster: defaultMaster,
115
+ });
116
+ }
117
+ /** A round-1 fix alakot atalakitja a nyitott allapot-alakra (migracios hid). */
118
+ static fromClassicSettings(settings) {
119
+ const safe = settings ?? {};
120
+ const scale = audio_scale_util_1.DyFM_AudioScale_Util.getUnitScale();
121
+ return {
122
+ master: audio_scale_util_1.DyFM_AudioScale_Util.toUnit(safe.master, scale),
123
+ channels: {
124
+ music: audio_scale_util_1.DyFM_AudioScale_Util.toUnit(safe.music, scale),
125
+ ambience: audio_scale_util_1.DyFM_AudioScale_Util.toUnit(safe.ambience, scale),
126
+ effects: audio_scale_util_1.DyFM_AudioScale_Util.toUnit(safe.effects, scale),
127
+ },
128
+ muted: safe.muted === true,
129
+ };
130
+ }
131
+ /**
132
+ * A nyitott allapot-alakot visszaalakitja a round-1 fix alakra (migracios hid visszafele).
133
+ *
134
+ * **Peldany-metodus**, mert a helyes konverziohoz ismerni kell a peldany skalajat: egy
135
+ * `0-100`-as allapotot igy is `0..1`-re normalizal, ahogy a round-1 alak varja. (Statikus
136
+ * valtozatban ez nemaan rossz erteket adna.)
137
+ *
138
+ * A klasszikus keszleten kivuli csatornak (pl. `dialog`) **elvesznek** — ez a round-1 alak
139
+ * korlatja, nem a konverzioe.
140
+ */
141
+ toClassicSettings(state) {
142
+ const safe = this.merge(state);
143
+ const scale = this.config.scale;
144
+ return {
145
+ master: audio_scale_util_1.DyFM_AudioScale_Util.toUnit(safe.master, scale),
146
+ music: audio_scale_util_1.DyFM_AudioScale_Util.toUnit(safe.channels['music'], scale),
147
+ ambience: audio_scale_util_1.DyFM_AudioScale_Util.toUnit(safe.channels['ambience'], scale),
148
+ effects: audio_scale_util_1.DyFM_AudioScale_Util.toUnit(safe.channels['effects'], scale),
149
+ muted: safe.muted === true,
150
+ };
151
+ }
152
+ /** A peldany configja (masolat — a mutalasa nem hat vissza a modellre). */
153
+ getConfig() {
154
+ return {
155
+ channels: [...this.config.channels],
156
+ scale: { max: this.config.scale.max, integer: this.config.scale.integer },
157
+ defaults: { ...this.config.defaults },
158
+ defaultMaster: this.config.defaultMaster,
159
+ defaultChannelVolume: this.config.defaultChannelVolume,
160
+ };
161
+ }
162
+ /** A deklaralt csatorna-nevek (a `master` nelkul). */
163
+ getChannels() {
164
+ return [...this.config.channels];
165
+ }
166
+ /** Igaz, ha a nev a deklaralt csatornak kozott van (a `master` NEM az). */
167
+ hasChannel(channel) {
168
+ return this.config.channels.includes(channel);
169
+ }
170
+ /**
171
+ * Alapertelmezett allapot a **sajat skalan**. Minden hivas UJ objektumot ad vissza, hogy a
172
+ * hivo szabadon mutalhassa.
173
+ */
174
+ getDefaults() {
175
+ const channels = {};
176
+ for (const channel of this.config.channels) {
177
+ channels[channel] = this.getDefaultChannelVolume(channel);
178
+ }
179
+ return {
180
+ master: this.getDefaultMaster(),
181
+ channels: channels,
182
+ muted: false,
183
+ };
184
+ }
185
+ /**
186
+ * Reszleges / hianyzo / serult allapotbol teljes, ervenyes allapotot allit elo: a hianyzo
187
+ * csatornak a defaultot kapjak, az ertekek a sajat skalara szorulnak.
188
+ *
189
+ * **Ez a migracios biztositek:** egy regi payload, ami meg nem ismert egy kesobb bevezetett
190
+ * csatornat, igy is betoltheto marad. A **nem deklaralt** csatornak kiesnek — igy egy
191
+ * eltavolitott csatorna nem szivarog vissza a mentesbol. Serult (NaN / nem-szam) ertek eseten
192
+ * a csatorna DEFAULT-jat kapja, nem 0-t — egy hibas mentes ne nemitson el csendben.
193
+ *
194
+ * **Figyelem:** ez a nyitott (`channels` rekord) alakot varja. A round-1 LAPOS alakot
195
+ * (`{ master, music, ambience, effects, muted }`) eloszor a `fromClassicSettings()`-szel
196
+ * kell atalakitani — kulonben a csatornak a defaultot kapjak.
197
+ */
198
+ merge(partial) {
199
+ const defaults = this.getDefaults();
200
+ if (!partial) {
201
+ return defaults;
202
+ }
203
+ const source = partial.channels ?? {};
204
+ const channels = {};
205
+ for (const channel of this.config.channels) {
206
+ const raw = source[channel];
207
+ channels[channel] = raw === undefined || raw === null
208
+ ? defaults.channels[channel]
209
+ : audio_scale_util_1.DyFM_AudioScale_Util.clampToScale(raw, this.config.scale, defaults.channels[channel]);
210
+ }
211
+ const master = partial.master === undefined || partial.master === null
212
+ ? defaults.master
213
+ : audio_scale_util_1.DyFM_AudioScale_Util.clampToScale(partial.master, this.config.scale, defaults.master);
214
+ return {
215
+ master: master,
216
+ channels: channels,
217
+ muted: partial.muted === true,
218
+ };
219
+ }
220
+ /**
221
+ * Egy csatorna **effektiv** hangereje `0..1`-ben — ezt varja a `HTMLAudioElement.volume` es a
222
+ * Web Audio `GainNode.gain.value`, fuggetlenul attol, milyen skalan tarol a projekt.
223
+ *
224
+ * A csatorna sajat erteke szorozva a master-rel; nemitas eseten mindig 0. A `'master'` nevre
225
+ * a master sajat (normalizalt) erteket adja vissza, nem negyzetre emelve.
226
+ *
227
+ * **Dob**, ha a csatorna nincs deklaralva — egy elgepelt csatorna-nev igy nem nemul el
228
+ * csendben, hanem azonnal kiderul (`core-rich-error-handling`).
229
+ */
230
+ getEffectiveVolume(state, channel) {
231
+ if (channel !== DyFM_AudioMixer_ControlModel.masterChannel && !this.hasChannel(channel)) {
232
+ throw new error_control_model_1.DyFM_Error({
233
+ errorCode: 'DYFM-AUDIO-MIXER-005',
234
+ message: 'DyFM_AudioMixer_ControlModel.getEffectiveVolume: unknown channel',
235
+ additionalContent: { channel: channel, declaredChannels: this.config.channels },
236
+ });
237
+ }
238
+ const safe = this.merge(state);
239
+ if (safe.muted) {
240
+ return 0;
241
+ }
242
+ const masterUnit = audio_scale_util_1.DyFM_AudioScale_Util.toUnit(safe.master, this.config.scale);
243
+ if (channel === DyFM_AudioMixer_ControlModel.masterChannel) {
244
+ return masterUnit;
245
+ }
246
+ const channelUnit = audio_scale_util_1.DyFM_AudioScale_Util.toUnit(safe.channels[channel], this.config.scale);
247
+ return audio_scale_util_1.DyFM_AudioScale_Util.clampUnit(channelUnit * masterUnit);
248
+ }
249
+ /**
250
+ * Egy csatorna hangerejenek beallitasa a **sajat skalan** — UJ allapot-objektumot ad vissza
251
+ * (immutable update), hogy signal-/state-alapu tarolokban is biztonsagos legyen.
252
+ */
253
+ withChannelVolume(state, channel, volume) {
254
+ if (!this.hasChannel(channel)) {
255
+ throw new error_control_model_1.DyFM_Error({
256
+ errorCode: 'DYFM-AUDIO-MIXER-006',
257
+ message: 'DyFM_AudioMixer_ControlModel.withChannelVolume: unknown channel',
258
+ additionalContent: { channel: channel, declaredChannels: this.config.channels },
259
+ });
260
+ }
261
+ const next = this.merge(state);
262
+ next.channels[channel] = audio_scale_util_1.DyFM_AudioScale_Util.clampToScale(volume, this.config.scale);
263
+ return next;
264
+ }
265
+ /** A master beallitasa a **sajat skalan** — UJ allapot-objektumot ad vissza. */
266
+ withMasterVolume(state, volume) {
267
+ const next = this.merge(state);
268
+ next.master = audio_scale_util_1.DyFM_AudioScale_Util.clampToScale(volume, this.config.scale);
269
+ return next;
270
+ }
271
+ /** Nemitas beallitasa — UJ allapot-objektumot ad vissza. */
272
+ withMuted(state, muted) {
273
+ const next = this.merge(state);
274
+ next.muted = muted === true;
275
+ return next;
276
+ }
277
+ /** Ket allapot ertek szerinti egyezese (mentes-szukseg / change-detection dontesehez). */
278
+ isEqual(a, b) {
279
+ const left = this.merge(a);
280
+ const right = this.merge(b);
281
+ if (left.master !== right.master || left.muted !== right.muted) {
282
+ return false;
283
+ }
284
+ for (const channel of this.config.channels) {
285
+ if (left.channels[channel] !== right.channels[channel]) {
286
+ return false;
287
+ }
288
+ }
289
+ return true;
290
+ }
291
+ /** A master alapertelmezese a sajat skalan (config, kulonben a maximum 80%-a). */
292
+ getDefaultMaster() {
293
+ if (typeof this.config.defaultMaster === 'number' && !Number.isNaN(this.config.defaultMaster)) {
294
+ return audio_scale_util_1.DyFM_AudioScale_Util.clampToScale(this.config.defaultMaster, this.config.scale);
295
+ }
296
+ return audio_scale_util_1.DyFM_AudioScale_Util.fromUnit(audio_scale_util_1.DyFM_AudioScale_Util.defaultRatio, this.config.scale);
297
+ }
298
+ /** Egy csatorna alapertelmezese a sajat skalan (per-csatorna, kulonben kozos, kulonben 80%). */
299
+ getDefaultChannelVolume(channel) {
300
+ const perChannel = (this.config.defaults ?? {})[channel];
301
+ if (typeof perChannel === 'number' && !Number.isNaN(perChannel)) {
302
+ return audio_scale_util_1.DyFM_AudioScale_Util.clampToScale(perChannel, this.config.scale);
303
+ }
304
+ if (typeof this.config.defaultChannelVolume === 'number'
305
+ && !Number.isNaN(this.config.defaultChannelVolume)) {
306
+ return audio_scale_util_1.DyFM_AudioScale_Util.clampToScale(this.config.defaultChannelVolume, this.config.scale);
307
+ }
308
+ return audio_scale_util_1.DyFM_AudioScale_Util.fromUnit(audio_scale_util_1.DyFM_AudioScale_Util.defaultRatio, this.config.scale);
309
+ }
310
+ }
311
+ exports.DyFM_AudioMixer_ControlModel = DyFM_AudioMixer_ControlModel;
312
+ //# sourceMappingURL=audio-mixer.control-model.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"audio-mixer.control-model.js","sourceRoot":"","sources":["../../../../src/_modules/game/_models/audio-mixer.control-model.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,18 @@
1
+ /**
2
+ * Egy audio-mixer csatorna-ertekeinek **skalaja** — a projekt sajat szamabrazolasa.
3
+ *
4
+ * **Miert kell:** a flotta ket kulonbozo skalat hasznal. A Prototyper prototipusai `0..1`
5
+ * lebegopontos erteket tarolnak, a Hero Coordinator viszont `0-100` egeszet (`Math.round`-dal
6
+ * clampelve, igy is van elmentve a localStorage-ban). Ha a bedrock egyetlen skalat kenyszeritene,
7
+ * az egyik oldalnak **adatot kellene migralnia** — ezt kerulik el ezek a leirok.
8
+ *
9
+ * A modell befele mindig `0..1`-re normalizal (a lejatszo API-k ezt varjak), kifele viszont a
10
+ * projekt sajat skalajan tarol es ad vissza.
11
+ */
12
+ export interface DyFM_AudioScale {
13
+ /** A csatorna-ertek maximuma a projekt sajat skalajan (pl. `1` vagy `100`). */
14
+ max: number;
15
+ /** Ha `true`, a sajat skalara visszaalakitott ertek egeszre kerekitodik (0-100 UI-hoz). */
16
+ integer: boolean;
17
+ }
18
+ //# sourceMappingURL=audio-scale.interface.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"audio-scale.interface.d.ts","sourceRoot":"","sources":["../../../../src/_modules/game/_models/audio-scale.interface.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,MAAM,WAAW,eAAe;IAE9B,+EAA+E;IAC/E,GAAG,EAAE,MAAM,CAAC;IAEZ,2FAA2F;IAC3F,OAAO,EAAE,OAAO,CAAC;CAClB"}
@@ -0,0 +1,3 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ //# sourceMappingURL=audio-scale.interface.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"audio-scale.interface.js","sourceRoot":"","sources":["../../../../src/_modules/game/_models/audio-scale.interface.ts"],"names":[],"mappings":""}
@@ -0,0 +1,17 @@
1
+ /**
2
+ * A `DyFM_SeededRandom` teljes belso allapota — 4 db 32-bites egesz (sfc32).
3
+ *
4
+ * Tisztan JSON-serializalhato, tehat **a jatek save-payload resze lehet**: a mentes utan
5
+ * visszatoltve a veletlen-sorozat PONTOSAN ott folytatodik, ahol abbamaradt.
6
+ */
7
+ export interface DyFM_SeededRandom_State {
8
+ /** sfc32 allapot-szo #1. */
9
+ a: number;
10
+ /** sfc32 allapot-szo #2. */
11
+ b: number;
12
+ /** sfc32 allapot-szo #3. */
13
+ c: number;
14
+ /** sfc32 counter-szo. */
15
+ d: number;
16
+ }
17
+ //# sourceMappingURL=seeded-random-state.interface.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"seeded-random-state.interface.d.ts","sourceRoot":"","sources":["../../../../src/_modules/game/_models/seeded-random-state.interface.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB;IACtC,4BAA4B;IAC5B,CAAC,EAAE,MAAM,CAAC;IAEV,4BAA4B;IAC5B,CAAC,EAAE,MAAM,CAAC;IAEV,4BAA4B;IAC5B,CAAC,EAAE,MAAM,CAAC;IAEV,yBAAyB;IACzB,CAAC,EAAE,MAAM,CAAC;CACX"}
@@ -0,0 +1,3 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ //# sourceMappingURL=seeded-random-state.interface.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"seeded-random-state.interface.js","sourceRoot":"","sources":["../../../../src/_modules/game/_models/seeded-random-state.interface.ts"],"names":[],"mappings":""}
@@ -0,0 +1,125 @@
1
+ import { DyFM_RandomWeight } from '../../../_models/interfaces/random-weight.interface';
2
+ import { DyFM_SeededRandom_State } from './seeded-random-state.interface';
3
+ /**
4
+ * Determinisztikus, **seed-elt** veletlenszam-generator mentheto allapottal.
5
+ *
6
+ * **Miert letezik:** a `DyFM_Random` `Math.random()`-ra epul — gyors es kenyelmes, de
7
+ * NEM reprodukalhato es nincs allapota. A flotta harom jateka ezert epitett maganak sajat
8
+ * PRNG-t (`sm-random.service.ts`, `random-seed.service.ts`, Portalhold `worldSeed`).
9
+ * Ez az osztaly az egysegesitett valtozat.
10
+ *
11
+ * **Algoritmus:** sfc32 (Small Fast Counting) — 128 bites allapot (4x32 bit), kivalo
12
+ * statisztikai minoseg, gyors, es az allapota trivialisan serializalhato. A string-seedet
13
+ * cyrb128 hash-eli 4x32 bitre, tehat `'my-world-seed'` es `42` egyarant ervenyes seed.
14
+ *
15
+ * **Mire jo (a jatekon tul):**
16
+ * - reprodukalhato vilag-generalas es mentheto RNG-allapot,
17
+ * - **determinisztikus e2e/QA** — ugyanaz a seed ugyanazt a jatekmenetet adja,
18
+ * - perf-osszemeres azonos bemeneten,
19
+ * - mock-adat es teszt-fixture stabil generalasa.
20
+ *
21
+ * **Hasznalat:**
22
+ * ```typescript
23
+ * const rng = DyFM_SeededRandom.fromSeed('world-42');
24
+ * const damage: number = rng.nextInt(5, 15);
25
+ * const loot = rng.getRandomWeighted([
26
+ * { chance: 0.7, result: 'common' },
27
+ * { chance: 0.3, result: 'rare' },
28
+ * ]);
29
+ *
30
+ * // mentes
31
+ * save.rngState = rng.getState();
32
+ *
33
+ * // betoltes — a sorozat ott folytatodik, ahol abbamaradt
34
+ * const restored = DyFM_SeededRandom.fromState(save.rngState);
35
+ * ```
36
+ *
37
+ * **Fontos:** ket kulon instance NEM befolyasolja egymast; ha determinisztikus alrendszereket
38
+ * akarsz (pl. vilag-generalas kulon a harci dobasoktol), adj mindegyiknek sajat instance-ot.
39
+ */
40
+ export declare class DyFM_SeededRandom {
41
+ /** 2^32 — a 32 bites egeszek normalizalasahoz. */
42
+ private static readonly uint32Range;
43
+ /** sfc32 allapot-szo #1. */
44
+ private a;
45
+ /** sfc32 allapot-szo #2. */
46
+ private b;
47
+ /** sfc32 allapot-szo #3. */
48
+ private c;
49
+ /** sfc32 counter-szo. */
50
+ private d;
51
+ /**
52
+ * Kozvetlen allapotbol epit. A tipikus belepesi pont a `fromSeed()` / `fromState()`
53
+ * statikus factory.
54
+ */
55
+ constructor(state: DyFM_SeededRandom_State);
56
+ /**
57
+ * Generator letrehozasa seed-bol. A seed lehet string (pl. mentett `worldSeed`) vagy szam.
58
+ * Ugyanaz a seed MINDIG ugyanazt a sorozatot adja.
59
+ */
60
+ static fromSeed(seed: string | number): DyFM_SeededRandom;
61
+ /** Generator letrehozasa korabban elmentett allapotbol (save-betoltes). */
62
+ static fromState(state: DyFM_SeededRandom_State): DyFM_SeededRandom;
63
+ /**
64
+ * String seed -> 4x32 bites allapot (cyrb128). Determinisztikus es jol szoro:
65
+ * a `'a'` es `'b'` seed teljesen kulonbozo sorozatot ad.
66
+ */
67
+ private static hashSeed;
68
+ /** A generator teljes allapotanak masolata — ezt kell a save-payloadba tenni. */
69
+ getState(): DyFM_SeededRandom_State;
70
+ /** Allapot visszatoltese — a sorozat innentol az elmentett ponton folytatodik. */
71
+ setState(state: DyFM_SeededRandom_State): void;
72
+ /**
73
+ * Fuggetlen masolat az AKTUALIS allapotrol — a klon ugyanazt a sorozatot folytatja,
74
+ * de a ket instance tovabbiakban nem befolyasolja egymast.
75
+ *
76
+ * Tipikus hasznalat: „mi lenne, ha" elore-szimulacio a fo-jatekmenet elrontasa nelkul.
77
+ */
78
+ clone(): DyFM_SeededRandom;
79
+ /**
80
+ * A kovetkezo veletlen lebegopontos szam a `[0, 1)` tartomanybol (sfc32 mag).
81
+ * Minden mas metodus erre epul.
82
+ */
83
+ nextFloat(): number;
84
+ /**
85
+ * Veletlen egesz a `[min, max]` tartomanybol (mindket veg ZART) — a `DyFM_Random.getRandomInt`
86
+ * seedelt parja. Ha `max < min`, a ket erteket felcsereli.
87
+ */
88
+ nextInt(min: number, max: number): number;
89
+ /** A `DyFM_Random.getRandomInt` API-paritas alias — l. `nextInt`. */
90
+ getRandomInt(min: number, max: number): number;
91
+ /** Veletlen lebegopontos szam a `[min, max)` tartomanybol. */
92
+ nextRange(min: number, max: number): number;
93
+ /**
94
+ * Veletlen logikai ertek. A `chance` a `true` valoszinusege (0..1; default 0.5).
95
+ */
96
+ nextBool(chance?: number): boolean;
97
+ /**
98
+ * Veletlen elem a listabol (`null`, ha a lista ures) — a `DyFM_Random.getRandomListElement`
99
+ * seedelt parja.
100
+ */
101
+ getRandomListElement<T>(list: T[]): T | null;
102
+ /**
103
+ * Sulyozott veletlen elem (`null`, ha a lista ures) — a `DyFM_Random.getRandomWeighted`
104
+ * seedelt parja.
105
+ *
106
+ * **Elteres a `DyFM_Random`-tol:** ez a valtozat NEM mutalja a bemeneti tombot
107
+ * (a statikus verzio helyben rendez es atirja a `chance` ertekeket).
108
+ */
109
+ getRandomWeighted<T>(weights: DyFM_RandomWeight<T>[]): T | null;
110
+ /**
111
+ * Sulyozott veletlen egesz — a `DyFM_Random.getRandomWeightedInt` seedelt parja.
112
+ * Ha a sulyozas nem ad talalatot, `nextInt(min, max)`-ra esik vissza.
113
+ */
114
+ getRandomWeightedInt(min: number, max: number, weights: DyFM_RandomWeight<number>[]): number;
115
+ /**
116
+ * Fisher-Yates keveres — UJ tombot ad vissza, a bemenetet nem mutalja.
117
+ */
118
+ shuffle<T>(list: T[]): T[];
119
+ /**
120
+ * `count` darab KULONBOZO elem kivalasztasa a listabol (sorrendje veletlen).
121
+ * Ha `count` nagyobb a lista hosszanal, a teljes (megkevert) listat adja vissza.
122
+ */
123
+ pick<T>(list: T[], count: number): T[];
124
+ }
125
+ //# sourceMappingURL=seeded-random.control-model.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"seeded-random.control-model.d.ts","sourceRoot":"","sources":["../../../../src/_modules/game/_models/seeded-random.control-model.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qDAAqD,CAAC;AAExF,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAG1E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,qBAAa,iBAAiB;IAE5B,kDAAkD;IAClD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAsB;IAEzD,4BAA4B;IAC5B,OAAO,CAAC,CAAC,CAAS;IAElB,4BAA4B;IAC5B,OAAO,CAAC,CAAC,CAAS;IAElB,4BAA4B;IAC5B,OAAO,CAAC,CAAC,CAAS;IAElB,yBAAyB;IACzB,OAAO,CAAC,CAAC,CAAS;IAElB;;;OAGG;gBACS,KAAK,EAAE,uBAAuB;IAgB1C;;;OAGG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,iBAAiB;IAYzD,2EAA2E;IAC3E,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,uBAAuB,GAAG,iBAAiB;IAInE;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ;IA4BvB,iFAAiF;IACjF,QAAQ,IAAI,uBAAuB;IAInC,kFAAkF;IAClF,QAAQ,CAAC,KAAK,EAAE,uBAAuB,GAAG,IAAI;IAgB9C;;;;;OAKG;IACH,KAAK,IAAI,iBAAiB;IAI1B;;;OAGG;IACH,SAAS,IAAI,MAAM;IAiBnB;;;OAGG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM;IAOzC,qEAAqE;IACrE,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM;IAI9C,8DAA8D;IAC9D,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM;IAO3C;;OAEG;IACH,QAAQ,CAAC,MAAM,GAAE,MAAY,GAAG,OAAO;IAIvC;;;OAGG;IACH,oBAAoB,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,GAAG,IAAI;IAQ5C;;;;;;OAMG;IACH,iBAAiB,CAAC,CAAC,EAAE,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,IAAI;IA2B/D;;;OAGG;IACH,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,CAAC,MAAM,CAAC,EAAE,GAAG,MAAM;IAU5F;;OAEG;IACH,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE;IAiB1B;;;OAGG;IACH,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,EAAE;CAOvC"}