@futdevpro/fsm-dynamo 1.14.10 → 1.14.11

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 (185) hide show
  1. package/build/_collections/constants/data-sizes.const.d.ts +3 -3
  2. package/build/_collections/constants/data-sizes.const.d.ts.map +1 -1
  3. package/build/_collections/constants/data-sizes.const.js +4 -3
  4. package/build/_collections/constants/data-sizes.const.js.map +1 -1
  5. package/build/_collections/utils/array.util.d.ts +189 -0
  6. package/build/_collections/utils/array.util.d.ts.map +1 -1
  7. package/build/_collections/utils/array.util.js +189 -0
  8. package/build/_collections/utils/array.util.js.map +1 -1
  9. package/build/_collections/utils/async.util.d.ts +29 -0
  10. package/build/_collections/utils/async.util.d.ts.map +1 -1
  11. package/build/_collections/utils/async.util.js +40 -0
  12. package/build/_collections/utils/async.util.js.map +1 -1
  13. package/build/_collections/utils/json-error-helper.util.d.ts +38 -0
  14. package/build/_collections/utils/json-error-helper.util.d.ts.map +1 -1
  15. package/build/_collections/utils/json-error-helper.util.js +38 -0
  16. package/build/_collections/utils/json-error-helper.util.js.map +1 -1
  17. package/build/_collections/utils/log.util.d.ts +195 -5
  18. package/build/_collections/utils/log.util.d.ts.map +1 -1
  19. package/build/_collections/utils/log.util.js +195 -5
  20. package/build/_collections/utils/log.util.js.map +1 -1
  21. package/build/_collections/utils/math/box-bounds.util.d.ts +36 -0
  22. package/build/_collections/utils/math/box-bounds.util.d.ts.map +1 -1
  23. package/build/_collections/utils/math/box-bounds.util.js +36 -0
  24. package/build/_collections/utils/math/box-bounds.util.js.map +1 -1
  25. package/build/_collections/utils/math/math.util.d.ts +48 -12
  26. package/build/_collections/utils/math/math.util.d.ts.map +1 -1
  27. package/build/_collections/utils/math/math.util.js +48 -14
  28. package/build/_collections/utils/math/math.util.js.map +1 -1
  29. package/build/_collections/utils/math/math.util.spec.js +0 -9
  30. package/build/_collections/utils/math/math.util.spec.js.map +1 -1
  31. package/build/_collections/utils/math/random.util.d.ts +30 -0
  32. package/build/_collections/utils/math/random.util.d.ts.map +1 -1
  33. package/build/_collections/utils/math/random.util.js +30 -0
  34. package/build/_collections/utils/math/random.util.js.map +1 -1
  35. package/build/_collections/utils/math/trigonometry.util.d.ts +30 -0
  36. package/build/_collections/utils/math/trigonometry.util.d.ts.map +1 -1
  37. package/build/_collections/utils/math/trigonometry.util.js +30 -0
  38. package/build/_collections/utils/math/trigonometry.util.js.map +1 -1
  39. package/build/_collections/utils/math/vector2.util.d.ts +247 -17
  40. package/build/_collections/utils/math/vector2.util.d.ts.map +1 -1
  41. package/build/_collections/utils/math/vector2.util.js +247 -19
  42. package/build/_collections/utils/math/vector2.util.js.map +1 -1
  43. package/build/_collections/utils/regex/password-regex.util.d.ts +12 -0
  44. package/build/_collections/utils/regex/password-regex.util.d.ts.map +1 -1
  45. package/build/_collections/utils/regex/password-regex.util.js +12 -0
  46. package/build/_collections/utils/regex/password-regex.util.js.map +1 -1
  47. package/build/_collections/utils/round-list.util.d.ts +39 -0
  48. package/build/_collections/utils/round-list.util.d.ts.map +1 -1
  49. package/build/_collections/utils/round-list.util.js +39 -0
  50. package/build/_collections/utils/round-list.util.js.map +1 -1
  51. package/build/_collections/utils/stack.util.d.ts +19 -0
  52. package/build/_collections/utils/stack.util.d.ts.map +1 -1
  53. package/build/_collections/utils/stack.util.js +19 -0
  54. package/build/_collections/utils/stack.util.js.map +1 -1
  55. package/build/_collections/utils/string.util.d.ts +17 -0
  56. package/build/_collections/utils/string.util.d.ts.map +1 -1
  57. package/build/_collections/utils/string.util.js +17 -0
  58. package/build/_collections/utils/string.util.js.map +1 -1
  59. package/build/_collections/utils/time.util.d.ts +136 -0
  60. package/build/_collections/utils/time.util.d.ts.map +1 -1
  61. package/build/_collections/utils/time.util.js +136 -0
  62. package/build/_collections/utils/time.util.js.map +1 -1
  63. package/build/_collections/utils/utilities.util.d.ts +17 -1
  64. package/build/_collections/utils/utilities.util.d.ts.map +1 -1
  65. package/build/_collections/utils/utilities.util.js +17 -1
  66. package/build/_collections/utils/utilities.util.js.map +1 -1
  67. package/build/_collections/utils/uuid.util.d.ts +6 -0
  68. package/build/_collections/utils/uuid.util.d.ts.map +1 -1
  69. package/build/_collections/utils/uuid.util.js +6 -0
  70. package/build/_collections/utils/uuid.util.js.map +1 -1
  71. package/build/_enums/data-model-type.enum.d.ts +6 -0
  72. package/build/_enums/data-model-type.enum.d.ts.map +1 -1
  73. package/build/_enums/data-model-type.enum.js +6 -0
  74. package/build/_enums/data-model-type.enum.js.map +1 -1
  75. package/build/_enums/http/http-call-type.enum.d.ts +8 -0
  76. package/build/_enums/http/http-call-type.enum.d.ts.map +1 -1
  77. package/build/_enums/http/http-call-type.enum.js +8 -0
  78. package/build/_enums/http/http-call-type.enum.js.map +1 -1
  79. package/build/_enums/http/http-event-type.enum.d.ts +5 -0
  80. package/build/_enums/http/http-event-type.enum.d.ts.map +1 -1
  81. package/build/_enums/http/http-event-type.enum.js +5 -0
  82. package/build/_enums/http/http-event-type.enum.js.map +1 -1
  83. package/build/_enums/time/day-of-week.enum.d.ts +14 -1
  84. package/build/_enums/time/day-of-week.enum.d.ts.map +1 -1
  85. package/build/_enums/time/day-of-week.enum.js +14 -1
  86. package/build/_enums/time/day-of-week.enum.js.map +1 -1
  87. package/build/_models/control-models/data-model-params.control-model.d.ts.map +1 -1
  88. package/build/_models/control-models/data-model-params.control-model.js +11 -1
  89. package/build/_models/control-models/data-model-params.control-model.js.map +1 -1
  90. package/build/_models/control-models/data-property-params.control-model.d.ts +8 -0
  91. package/build/_models/control-models/data-property-params.control-model.d.ts.map +1 -1
  92. package/build/_models/control-models/data-property-params.control-model.js +8 -0
  93. package/build/_models/control-models/data-property-params.control-model.js.map +1 -1
  94. package/build/_models/control-models/http/http-error-response.control-model.d.ts +25 -0
  95. package/build/_models/control-models/http/http-error-response.control-model.d.ts.map +1 -1
  96. package/build/_models/control-models/http/http-error-response.control-model.js +25 -0
  97. package/build/_models/control-models/http/http-error-response.control-model.js.map +1 -1
  98. package/build/_models/control-models/http/http-headers.control-model.d.ts +8 -0
  99. package/build/_models/control-models/http/http-headers.control-model.d.ts.map +1 -1
  100. package/build/_models/control-models/http/http-headers.control-model.js +8 -0
  101. package/build/_models/control-models/http/http-headers.control-model.js.map +1 -1
  102. package/build/_models/control-models/http/http-response.model-base.d.ts +9 -0
  103. package/build/_models/control-models/http/http-response.model-base.d.ts.map +1 -1
  104. package/build/_models/control-models/http/http-response.model-base.js +9 -0
  105. package/build/_models/control-models/http/http-response.model-base.js.map +1 -1
  106. package/build/_models/control-models/poll.control-model.d.ts +18 -0
  107. package/build/_models/control-models/poll.control-model.d.ts.map +1 -1
  108. package/build/_models/control-models/poll.control-model.js +18 -0
  109. package/build/_models/control-models/poll.control-model.js.map +1 -1
  110. package/build/_models/control-models/range-value.control-model.d.ts +141 -0
  111. package/build/_models/control-models/range-value.control-model.d.ts.map +1 -1
  112. package/build/_models/control-models/range-value.control-model.js +141 -0
  113. package/build/_models/control-models/range-value.control-model.js.map +1 -1
  114. package/build/_models/control-models/server-status.control-model.d.ts +10 -0
  115. package/build/_models/control-models/server-status.control-model.d.ts.map +1 -1
  116. package/build/_models/control-models/server-status.control-model.js +10 -0
  117. package/build/_models/control-models/server-status.control-model.js.map +1 -1
  118. package/build/_models/control-models/service-endpoint-settings-base.control-model.d.ts +12 -0
  119. package/build/_models/control-models/service-endpoint-settings-base.control-model.d.ts.map +1 -1
  120. package/build/_models/control-models/service-endpoint-settings-base.control-model.js +12 -0
  121. package/build/_models/control-models/service-endpoint-settings-base.control-model.js.map +1 -1
  122. package/build/_models/data-models/errors.data-model.d.ts +10 -0
  123. package/build/_models/data-models/errors.data-model.d.ts.map +1 -1
  124. package/build/_models/data-models/errors.data-model.js +10 -0
  125. package/build/_models/data-models/errors.data-model.js.map +1 -1
  126. package/build/_models/data-models/metadata.data-model.d.ts +26 -0
  127. package/build/_models/data-models/metadata.data-model.d.ts.map +1 -1
  128. package/build/_models/data-models/metadata.data-model.js +26 -0
  129. package/build/_models/data-models/metadata.data-model.js.map +1 -1
  130. package/build/_modules/ci-tools/_models/cit-ci-result-info.data-models.d.ts +23 -0
  131. package/build/_modules/ci-tools/_models/cit-ci-result-info.data-models.d.ts.map +1 -1
  132. package/build/_modules/ci-tools/_models/cit-ci-result-info.data-models.js +23 -0
  133. package/build/_modules/ci-tools/_models/cit-ci-result-info.data-models.js.map +1 -1
  134. package/build/_modules/custom-data/_models/cud.data-model.d.ts +7 -0
  135. package/build/_modules/custom-data/_models/cud.data-model.d.ts.map +1 -1
  136. package/build/_modules/custom-data/_models/cud.data-model.js +7 -0
  137. package/build/_modules/custom-data/_models/cud.data-model.js.map +1 -1
  138. package/build/_modules/location/_collections/loc-regions.util.d.ts +33 -0
  139. package/build/_modules/location/_collections/loc-regions.util.d.ts.map +1 -1
  140. package/build/_modules/location/_collections/loc-regions.util.js +33 -0
  141. package/build/_modules/location/_collections/loc-regions.util.js.map +1 -1
  142. package/build/_modules/location/_collections/loc.util.d.ts +10 -0
  143. package/build/_modules/location/_collections/loc.util.d.ts.map +1 -1
  144. package/build/_modules/location/_collections/loc.util.js +10 -0
  145. package/build/_modules/location/_collections/loc.util.js.map +1 -1
  146. package/futdevpro-fsm-dynamo-01.14.11.tgz +0 -0
  147. package/package.json +1 -1
  148. package/src/_collections/constants/data-sizes.const.ts +4 -4
  149. package/src/_collections/utils/array.util.ts +189 -0
  150. package/src/_collections/utils/async.util.ts +40 -0
  151. package/src/_collections/utils/json-error-helper.util.ts +38 -0
  152. package/src/_collections/utils/log.util.ts +194 -4
  153. package/src/_collections/utils/math/box-bounds.util.ts +36 -0
  154. package/src/_collections/utils/math/math.util.spec.ts +0 -10
  155. package/src/_collections/utils/math/math.util.ts +48 -16
  156. package/src/_collections/utils/math/random.util.ts +30 -0
  157. package/src/_collections/utils/math/trigonometry.util.ts +30 -0
  158. package/src/_collections/utils/math/vector2.util.ts +254 -24
  159. package/src/_collections/utils/regex/password-regex.util.ts +12 -0
  160. package/src/_collections/utils/round-list.util.ts +39 -0
  161. package/src/_collections/utils/stack.util.ts +19 -0
  162. package/src/_collections/utils/string.util.ts +17 -0
  163. package/src/_collections/utils/time.util.ts +136 -0
  164. package/src/_collections/utils/utilities.util.ts +17 -1
  165. package/src/_collections/utils/uuid.util.ts +6 -0
  166. package/src/_enums/data-model-type.enum.ts +6 -0
  167. package/src/_enums/http/http-call-type.enum.ts +8 -0
  168. package/src/_enums/http/http-event-type.enum.ts +5 -0
  169. package/src/_enums/time/day-of-week.enum.ts +14 -1
  170. package/src/_models/control-models/data-model-params.control-model.ts +11 -1
  171. package/src/_models/control-models/data-property-params.control-model.ts +8 -0
  172. package/src/_models/control-models/http/http-error-response.control-model.ts +25 -0
  173. package/src/_models/control-models/http/http-headers.control-model.ts +8 -0
  174. package/src/_models/control-models/http/http-response.model-base.ts +9 -0
  175. package/src/_models/control-models/poll.control-model.ts +18 -0
  176. package/src/_models/control-models/range-value.control-model.ts +141 -0
  177. package/src/_models/control-models/server-status.control-model.ts +10 -0
  178. package/src/_models/control-models/service-endpoint-settings-base.control-model.ts +12 -0
  179. package/src/_models/data-models/errors.data-model.ts +10 -0
  180. package/src/_models/data-models/metadata.data-model.ts +27 -0
  181. package/src/_modules/ci-tools/_models/cit-ci-result-info.data-models.ts +23 -0
  182. package/src/_modules/custom-data/_models/cud.data-model.ts +7 -0
  183. package/src/_modules/location/_collections/loc-regions.util.ts +34 -1
  184. package/src/_modules/location/_collections/loc.util.ts +10 -0
  185. package/futdevpro-fsm-dynamo-01.14.10.tgz +0 -0
@@ -12,6 +12,14 @@ class DyFM_RoundList {
12
12
  * @param listLength
13
13
  * @param outboundIndex
14
14
  * @returns
15
+ *
16
+ * @example
17
+ * ```ts
18
+ * const listLength = 10;
19
+ * const outboundIndex = 15;
20
+ * const result = DyFM_RoundList.getOutboundedIndex(listLength, outboundIndex);
21
+ * console.log(result); // 5
22
+ * ```
15
23
  */
16
24
  static getOutboundedIndex(listLength, outboundIndex) {
17
25
  if (!listLength) {
@@ -33,6 +41,14 @@ class DyFM_RoundList {
33
41
  * @param length
34
42
  * @param oppositeOf
35
43
  * @returns
44
+ *
45
+ * @example
46
+ * ```ts
47
+ * const length = 10;
48
+ * const oppositeOf = 5;
49
+ * const result = DyFM_RoundList.getIndexOpposite(length, oppositeOf);
50
+ * console.log(result); // 0
51
+ * ```
36
52
  */
37
53
  static getIndexOpposite(length, oppositeOf) {
38
54
  const plusIndex = oppositeOf + Math.round(length / 2);
@@ -44,6 +60,14 @@ class DyFM_RoundList {
44
60
  * @param list
45
61
  * @param outboundIndex
46
62
  * @returns
63
+ *
64
+ * @example
65
+ * ```ts
66
+ * const list = [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 ];
67
+ * const outboundIndex = 15;
68
+ * const result = DyFM_RoundList.getListIndex(list, outboundIndex);
69
+ * console.log(result); // 5
70
+ * ```
47
71
  */
48
72
  static getListIndex(list, outboundIndex) {
49
73
  return list[this.getOutboundedIndex(list.length, outboundIndex)];
@@ -53,6 +77,14 @@ class DyFM_RoundList {
53
77
  * @param list
54
78
  * @param oppositeOf
55
79
  * @returns
80
+ *
81
+ * @example
82
+ * ```ts
83
+ * const list = [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 ];
84
+ * const oppositeOf = 5;
85
+ * const result = DyFM_RoundList.getListOpposite(list, oppositeOf);
86
+ * console.log(result); // 0
87
+ * ```
56
88
  */
57
89
  static getListOpposite(list, oppositeOf) {
58
90
  return list[this.getIndexOpposite(list.length, list.indexOf(oppositeOf))];
@@ -60,6 +92,13 @@ class DyFM_RoundList {
60
92
  /**
61
93
  * returns the last element of the list
62
94
  * returns null if the list is empty
95
+ *
96
+ * @example
97
+ * ```ts
98
+ * const list = [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 ];
99
+ * const result = DyFM_RoundList.getLast(list);
100
+ * console.log(result); // 10
101
+ * ```
63
102
  */
64
103
  static getLast(list) {
65
104
  if (0 < list.length) {
@@ -1 +1 @@
1
- {"version":3,"file":"round-list.util.js","sourceRoot":"","sources":["../../../src/_collections/utils/round-list.util.ts"],"names":[],"mappings":";;;AAEA;;;;GAIG;AACH,MAAa,cAAc;IACzB;;;;;OAKG;IACH,MAAM,CAAC,kBAAkB,CAAC,UAAkB,EAAE,aAAqB;QACjE,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;QAC/D,CAAC;QAED,IAAI,aAAa,GAAG,CAAC,EAAE,CAAC;YACtB,aAAa,GAAG,aAAa,GAAG,UAAU,CAAC;YAC3C,aAAa,GAAG,UAAU,GAAG,aAAa,CAAC;QAC7C,CAAC;QAED,IAAI,UAAU,IAAI,aAAa,EAAE,CAAC;YAChC,aAAa,GAAG,aAAa,GAAG,UAAU,CAAC;QAC7C,CAAC;QAED,OAAO,aAAa,CAAC;IACvB,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,gBAAgB,CAAC,MAAc,EAAE,UAAkB;QACxD,MAAM,SAAS,GAAG,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACtD,MAAM,GAAG,GAAG,IAAI,CAAC,kBAAkB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QAEvD,OAAO,GAAG,CAAC;IACb,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,YAAY,CAAI,IAAS,EAAE,aAAqB;QACrD,OAAO,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;IACnE,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,eAAe,CAAI,IAAS,EAAE,UAAa;QAChD,OAAO,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAC5E,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,OAAO,CAAI,IAAS;QACzB,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YACpB,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC/B,CAAC;aAAM,CAAC;YACN,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;CA8CF;AAnHD,wCAmHC"}
1
+ {"version":3,"file":"round-list.util.js","sourceRoot":"","sources":["../../../src/_collections/utils/round-list.util.ts"],"names":[],"mappings":";;;AAEA;;;;GAIG;AACH,MAAa,cAAc;IACzB;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,kBAAkB,CAAC,UAAkB,EAAE,aAAqB;QACjE,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;QAC/D,CAAC;QAED,IAAI,aAAa,GAAG,CAAC,EAAE,CAAC;YACtB,aAAa,GAAG,aAAa,GAAG,UAAU,CAAC;YAC3C,aAAa,GAAG,UAAU,GAAG,aAAa,CAAC;QAC7C,CAAC;QAED,IAAI,UAAU,IAAI,aAAa,EAAE,CAAC;YAChC,aAAa,GAAG,aAAa,GAAG,UAAU,CAAC;QAC7C,CAAC;QAED,OAAO,aAAa,CAAC;IACvB,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,gBAAgB,CAAC,MAAc,EAAE,UAAkB;QACxD,MAAM,SAAS,GAAG,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACtD,MAAM,GAAG,GAAG,IAAI,CAAC,kBAAkB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QAEvD,OAAO,GAAG,CAAC;IACb,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,YAAY,CAAI,IAAS,EAAE,aAAqB;QACrD,OAAO,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;IACnE,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,eAAe,CAAI,IAAS,EAAE,UAAa;QAChD,OAAO,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAC5E,CAAC;IAED;;;;;;;;;;OAUG;IACH,MAAM,CAAC,OAAO,CAAI,IAAS;QACzB,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YACpB,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC/B,CAAC;aAAM,CAAC;YACN,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;CA8CF;AA1JD,wCA0JC"}
@@ -1,8 +1,27 @@
1
1
  /**
2
2
  * Get the stack location of the constructor call
3
3
  * use it in the constructor of a class to get the stack location of the constructor call
4
+ * @param level - The level of the stack to get the location of
4
5
  * @returns The stack location of the constructor call
6
+ *
7
+ * @example
8
+ * ```ts
9
+ * const stackLocation = DyFM_getConstructionStackLocation();
10
+ * console.log(stackLocation); // The stack location of the constructor call
11
+ * ```
5
12
  */
6
13
  export declare function DyFM_getConstructionStackLocation(level?: number): string;
14
+ /**
15
+ * Get the stack location of the local call
16
+ * use it in the local function to get the stack location of the local call
17
+ * @param level - The level of the stack to get the location of
18
+ * @returns The stack location of the local call
19
+ *
20
+ * @example
21
+ * ```ts
22
+ * const stackLocation = DyFM_getLocalStackLocation(1);
23
+ * console.log(stackLocation); // The stack location of the local call
24
+ * ```
25
+ */
7
26
  export declare function DyFM_getLocalStackLocation(level?: number): string;
8
27
  //# sourceMappingURL=stack.util.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"stack.util.d.ts","sourceRoot":"","sources":["../../../src/_collections/utils/stack.util.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,iCAAiC,CAAC,KAAK,GAAE,MAAU,GAAG,MAAM,CAqE3E;AAED,wBAAgB,0BAA0B,CAAC,KAAK,GAAE,MAAU,GAAG,MAAM,CA+DpE"}
1
+ {"version":3,"file":"stack.util.d.ts","sourceRoot":"","sources":["../../../src/_collections/utils/stack.util.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,wBAAgB,iCAAiC,CAAC,KAAK,GAAE,MAAU,GAAG,MAAM,CAqE3E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,GAAE,MAAU,GAAG,MAAM,CA+DpE"}
@@ -6,7 +6,14 @@ const log_util_1 = require("./log.util");
6
6
  /**
7
7
  * Get the stack location of the constructor call
8
8
  * use it in the constructor of a class to get the stack location of the constructor call
9
+ * @param level - The level of the stack to get the location of
9
10
  * @returns The stack location of the constructor call
11
+ *
12
+ * @example
13
+ * ```ts
14
+ * const stackLocation = DyFM_getConstructionStackLocation();
15
+ * console.log(stackLocation); // The stack location of the constructor call
16
+ * ```
10
17
  */
11
18
  function DyFM_getConstructionStackLocation(level = 0) {
12
19
  let stack = new Error().stack;
@@ -61,6 +68,18 @@ function DyFM_getConstructionStackLocation(level = 0) {
61
68
  }
62
69
  return constructorLine;
63
70
  }
71
+ /**
72
+ * Get the stack location of the local call
73
+ * use it in the local function to get the stack location of the local call
74
+ * @param level - The level of the stack to get the location of
75
+ * @returns The stack location of the local call
76
+ *
77
+ * @example
78
+ * ```ts
79
+ * const stackLocation = DyFM_getLocalStackLocation(1);
80
+ * console.log(stackLocation); // The stack location of the local call
81
+ * ```
82
+ */
64
83
  function DyFM_getLocalStackLocation(level = 0) {
65
84
  let stack = new Error().stack;
66
85
  // Split the stack into lines and remove the first line (Error:) and the second line (DyFM_getLocalStackLocation)
@@ -1 +1 @@
1
- {"version":3,"file":"stack.util.js","sourceRoot":"","sources":["../../../src/_collections/utils/stack.util.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"stack.util.js","sourceRoot":"","sources":["../../../src/_collections/utils/stack.util.ts"],"names":[],"mappings":"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"}
@@ -125,6 +125,23 @@ export declare class DyFM_String {
125
125
  static multiBracketSplitDetailed(input: string, brackets: DyFM_String_BracketSettings[], maxDepth?: number, replaceContents?: string): DyFM_String_BracketDetailedResult[];
126
126
  /**
127
127
  * Helper method to extract multiple bracket types from a single string with detailed information
128
+ * @param input - The input string to extract the brackets from
129
+ * @param brackets - The brackets to extract
130
+ * @param replaceContents - The string to replace the brackets with
131
+ * @returns The modified string and the extracted brackets
132
+ *
133
+ * @example
134
+ * ```ts
135
+ * const input = 'text (round) and [square] with {curly (nested)} brackets';
136
+ * const brackets = [
137
+ * { opening: '(', closing: ')' },
138
+ * { opening: '[', closing: ']' },
139
+ * { opening: '{', closing: '}' }
140
+ * ];
141
+ * const result = DyFM_String.extractMultipleBracketsFromStringDetailed(input, brackets, '...');
142
+ * console.log(result);
143
+ * // Output: { modified: 'text ... and ... with ... brackets', extracted: [ { content: 'round', level: 1, brackets: { opening: '(', closing: ')' } }, { content: 'square', level: 1, brackets: { opening: '[', closing: ']' } }, { content: 'curly ...', level: 1, brackets: { opening: '{', closing: '}' } }, { content: 'nested', level: 2, brackets: { opening: '(', closing: ')' } } ] }
144
+ * ```
128
145
  */
129
146
  private static extractMultipleBracketsFromStringDetailed;
130
147
  }
@@ -1 +1 @@
1
- {"version":3,"file":"string.util.d.ts","sourceRoot":"","sources":["../../../src/_collections/utils/string.util.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iCAAiC;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,2BAA2B,GAAG,IAAI,CAAC;CAC9C;AAED;;GAEG;AACH,qBAAa,WAAW;IAEtB;;;;OAIG;IACH,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAIvC;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,MAAM,CAAC,kBAAkB,CACvB,KAAK,EAAE,MAAM,EACb,cAAc,EAAE,MAAM,EACtB,cAAc,EAAE,MAAM,EACtB,QAAQ,GAAE,MAAW,EACrB,eAAe,CAAC,EAAE,MAAM,GACvB,MAAM,EAAE;IAKX;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,MAAM,CAAC,0BAA0B,CAC/B,KAAK,EAAE,MAAM,EACb,cAAc,EAAE,MAAM,EACtB,cAAc,EAAE,MAAM,EACtB,QAAQ,GAAE,MAAW,EACrB,eAAe,CAAC,EAAE,MAAM,GACvB,iCAAiC,EAAE;IAKtC;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,MAAM,CAAC,iBAAiB,CACtB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,2BAA2B,EAAE,EACvC,QAAQ,GAAE,MAAW,EACrB,eAAe,CAAC,EAAE,MAAM,GACvB,MAAM,EAAE;IAKX;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,MAAM,CAAC,yBAAyB,CAC9B,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,2BAA2B,EAAE,EACvC,QAAQ,GAAE,MAAW,EACrB,eAAe,CAAC,EAAE,MAAM,GACvB,iCAAiC,EAAE;IA4EtC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,yCAAyC;CA2LzD"}
1
+ {"version":3,"file":"string.util.d.ts","sourceRoot":"","sources":["../../../src/_collections/utils/string.util.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iCAAiC;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,2BAA2B,GAAG,IAAI,CAAC;CAC9C;AAED;;GAEG;AACH,qBAAa,WAAW;IAEtB;;;;OAIG;IACH,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAIvC;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,MAAM,CAAC,kBAAkB,CACvB,KAAK,EAAE,MAAM,EACb,cAAc,EAAE,MAAM,EACtB,cAAc,EAAE,MAAM,EACtB,QAAQ,GAAE,MAAW,EACrB,eAAe,CAAC,EAAE,MAAM,GACvB,MAAM,EAAE;IAKX;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,MAAM,CAAC,0BAA0B,CAC/B,KAAK,EAAE,MAAM,EACb,cAAc,EAAE,MAAM,EACtB,cAAc,EAAE,MAAM,EACtB,QAAQ,GAAE,MAAW,EACrB,eAAe,CAAC,EAAE,MAAM,GACvB,iCAAiC,EAAE;IAKtC;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,MAAM,CAAC,iBAAiB,CACtB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,2BAA2B,EAAE,EACvC,QAAQ,GAAE,MAAW,EACrB,eAAe,CAAC,EAAE,MAAM,GACvB,MAAM,EAAE;IAKX;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,MAAM,CAAC,yBAAyB,CAC9B,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,2BAA2B,EAAE,EACvC,QAAQ,GAAE,MAAW,EACrB,eAAe,CAAC,EAAE,MAAM,GACvB,iCAAiC,EAAE;IA4EtC;;;;;;;;;;;;;;;;;;;OAmBG;IACH,OAAO,CAAC,MAAM,CAAC,yCAAyC;CA2LzD"}
@@ -192,6 +192,23 @@ class DyFM_String {
192
192
  }
193
193
  /**
194
194
  * Helper method to extract multiple bracket types from a single string with detailed information
195
+ * @param input - The input string to extract the brackets from
196
+ * @param brackets - The brackets to extract
197
+ * @param replaceContents - The string to replace the brackets with
198
+ * @returns The modified string and the extracted brackets
199
+ *
200
+ * @example
201
+ * ```ts
202
+ * const input = 'text (round) and [square] with {curly (nested)} brackets';
203
+ * const brackets = [
204
+ * { opening: '(', closing: ')' },
205
+ * { opening: '[', closing: ']' },
206
+ * { opening: '{', closing: '}' }
207
+ * ];
208
+ * const result = DyFM_String.extractMultipleBracketsFromStringDetailed(input, brackets, '...');
209
+ * console.log(result);
210
+ * // Output: { modified: 'text ... and ... with ... brackets', extracted: [ { content: 'round', level: 1, brackets: { opening: '(', closing: ')' } }, { content: 'square', level: 1, brackets: { opening: '[', closing: ']' } }, { content: 'curly ...', level: 1, brackets: { opening: '{', closing: '}' } }, { content: 'nested', level: 2, brackets: { opening: '(', closing: ')' } } ] }
211
+ * ```
195
212
  */
196
213
  static extractMultipleBracketsFromStringDetailed(input, brackets, replaceContents) {
197
214
  const extracted = [];
@@ -1 +1 @@
1
- {"version":3,"file":"string.util.js","sourceRoot":"","sources":["../../../src/_collections/utils/string.util.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"string.util.js","sourceRoot":"","sources":["../../../src/_collections/utils/string.util.ts"],"names":[],"mappings":"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"}
@@ -37,18 +37,39 @@ export declare class DyFM_Time {
37
37
  * Get the age of a person
38
38
  * @param birthDate - The birth date of the person
39
39
  * @returns The age of the person
40
+ *
41
+ * @example
42
+ * ```ts
43
+ * const birthDate = new Date('1990-01-01');
44
+ * const age = DyFM_Time.getAge(birthDate);
45
+ * console.log(age); // 31
46
+ * ```
40
47
  */
41
48
  static getAge(birthDate: Date | number | string): number;
42
49
  /**
43
50
  * returns the date as a number of years
44
51
  * @param date
45
52
  * @returns
53
+ *
54
+ * @example
55
+ * ```ts
56
+ * const date = new Date('2025-01-01');
57
+ * const year = DyFM_Time.getYear(date);
58
+ * console.log(year); // 2025
59
+ * ```
46
60
  */
47
61
  static getYear(date: Date | number | string): number;
48
62
  /**
49
63
  * returns the date as a number of hours
50
64
  * @param date
51
65
  * @returns
66
+ *
67
+ * @example
68
+ * ```ts
69
+ * const date = new Date('2025-01-01');
70
+ * const hour = DyFM_Time.getHour(date);
71
+ * console.log(hour); // 1
72
+ * ```
52
73
  */
53
74
  static getHour(date: Date | number | string): number;
54
75
  /**
@@ -56,77 +77,192 @@ export declare class DyFM_Time {
56
77
  * (with current date so this wont be accurate for days or months, only years)
57
78
  * @param date
58
79
  * @returns
80
+ *
81
+ * @example
82
+ * ```ts
83
+ * const age = 31;
84
+ * const date = DyFM_Time.getDateByAge(age);
85
+ * console.log(date); // 1990-01-01
86
+ * ```
59
87
  */
60
88
  static getDateByAge(age: number): Date;
61
89
  /**
62
90
  * returns the date x before the current date
63
91
  * @param relativeDate
64
92
  * @returns
93
+ *
94
+ * @example
95
+ * ```ts
96
+ * const date = DyFM_Time.getDateByRelativeDate(DyFM_RelativeDate.lastDay);
97
+ * ```
65
98
  */
66
99
  static getDateByRelativeDate(relativeDate: DyFM_RelativeDate, comparedTo?: Date): Date;
67
100
  /**
68
101
  * returns the date one hour ago
69
102
  * @returns
103
+ *
104
+ * @example
105
+ * ```ts
106
+ * const comparedTo = new Date('2025-01-01');
107
+ * const date = DyFM_Time.oneHourAgo(comparedTo);
108
+ * console.log(date); // 2024-12-31 23:00:00
109
+ * ```
70
110
  */
71
111
  static oneHourAgo(comparedTo?: Date): Date;
72
112
  /**
73
113
  * returns the date one day ago
74
114
  * @returns
115
+ *
116
+ * @example
117
+ * ```ts
118
+ * const comparedTo = new Date('2025-01-01');
119
+ * const date = DyFM_Time.oneDayAgo(comparedTo);
120
+ * console.log(date); // 2024-12-31
121
+ * ```
75
122
  */
76
123
  static oneDayAgo(comparedTo?: Date): Date;
77
124
  /**
78
125
  * returns the date one week ago
79
126
  * @returns
127
+ *
128
+ * @example
129
+ * ```ts
130
+ * const comparedTo = new Date('2025-01-01');
131
+ * const date = DyFM_Time.oneWeekAgo(comparedTo);
132
+ * console.log(date); // 2024-12-25
133
+ * ```
80
134
  */
81
135
  static oneWeekAgo(comparedTo?: Date): Date;
82
136
  /**
83
137
  * returns the date one month ago
84
138
  * @returns
139
+ *
140
+ * @example
141
+ * ```ts
142
+ * const comparedTo = new Date('2025-01-01');
143
+ * const date = DyFM_Time.oneMonthAgo(comparedTo);
144
+ * console.log(date); // 2024-12-01
145
+ * ```
85
146
  */
86
147
  static oneMonthAgo(comparedTo?: Date): Date;
87
148
  /**
88
149
  * returns the date one year ago
89
150
  * @returns
151
+ *
152
+ * @example
153
+ * ```ts
154
+ * const comparedTo = new Date('2025-01-01');
155
+ * const date = DyFM_Time.oneYearAgo(comparedTo);
156
+ * console.log(date); // 2024-01-01
157
+ * ```
90
158
  */
91
159
  static oneYearAgo(comparedTo?: Date): Date;
92
160
  /**
93
161
  * returns the date ten years ago
94
162
  * @returns
163
+ *
164
+ * @example
165
+ * ```ts
166
+ * const comparedTo = new Date('2025-01-01');
167
+ * const date = DyFM_Time.tenYearsAgo(comparedTo);
168
+ * console.log(date); // 2015-01-01
169
+ * ```
95
170
  */
96
171
  static tenYearsAgo(comparedTo?: Date): Date;
97
172
  /**
98
173
  * returns the DyFM_DayOfWeek type of the current day
99
174
  * @returns
175
+ *
176
+ * @example
177
+ * ```ts
178
+ * const today = DyFM_Time.getTodayOfWeek();
179
+ * console.log(today); // DyFM_DayOfWeek.monday
180
+ * ```
100
181
  */
101
182
  static getTodayOfWeek(): DyFM_DayOfWeek;
102
183
  /**
103
184
  * returns the days of the week from today to the end of the week in DyFM_DayOfWeek format
104
185
  * @returns
186
+ *
187
+ * @example
188
+ * ```ts
189
+ * const daysOfWeek = DyFM_Time.getDaysOfWeekFromToday();
190
+ * console.log(daysOfWeek); // [ DyFM_DayOfWeek.monday, DyFM_DayOfWeek.tuesday, DyFM_DayOfWeek.wednesday, DyFM_DayOfWeek.thursday, DyFM_DayOfWeek.friday, DyFM_DayOfWeek.saturday, DyFM_DayOfWeek.sunday ]
191
+ * ```
105
192
  */
106
193
  static getDaysOfWeekFromToday(): DyFM_DayOfWeek[];
107
194
  /**
108
195
  * returns the days of the week to today to the end of the week in DyFM_DayOfWeek format
109
196
  * @returns
197
+ *
198
+ * @example
199
+ * ```ts
200
+ * const daysOfWeek = DyFM_Time.getDaysOfWeekToToday();
201
+ * console.log(daysOfWeek); // [ DyFM_DayOfWeek.sunday, DyFM_DayOfWeek.saturday, DyFM_DayOfWeek.friday, DyFM_DayOfWeek.thursday, DyFM_DayOfWeek.wednesday, DyFM_DayOfWeek.tuesday, DyFM_DayOfWeek.monday ]
202
+ * ```
110
203
  */
111
204
  static getDaysOfWeekToToday(): DyFM_DayOfWeek[];
112
205
  /**
113
206
  * returns the DyFM_Month type of the current month
114
207
  * @returns
208
+ *
209
+ * @example
210
+ * ```ts
211
+ * const month = DyFM_Time.getCurrentMonth();
212
+ * console.log(month); // DyFM_Month.january
213
+ * ```
115
214
  */
116
215
  static getCurrentMonth(): DyFM_Month;
117
216
  /**
118
217
  * returns the number of days in the month
119
218
  * @param inYear this value is important for february if you want to know if it is a leap year
120
219
  * @returns
220
+ *
221
+ * @example
222
+ * ```ts
223
+ * const monthLength = DyFM_Time.getMonthLength(DyFM_Month.january);
224
+ * console.log(monthLength); // 31
225
+ * ```
121
226
  */
122
227
  static getMonthLength(month: DyFM_Month, inYear?: number): number;
123
228
  /**
124
229
  * returns year is leap or not
125
230
  * @param year
126
231
  * @returns
232
+ *
233
+ * @example
234
+ * ```ts
235
+ * const isLeapYear = DyFM_Time.isLeapYear(2024);
236
+ * console.log(isLeapYear); // true
237
+ * ```
127
238
  */
128
239
  static isLeapYear(year: number): boolean;
240
+ /**
241
+ * returns the duration string
242
+ * @param duration
243
+ * @param full
244
+ * @returns
245
+ *
246
+ * @example
247
+ * ```ts
248
+ * const duration = 1000;
249
+ * const durationString = DyFM_Time.getDurationString(duration);
250
+ * console.log(durationString); // 1s
251
+ * ```
252
+ */
129
253
  static getDurationString(duration: number, full?: boolean): string;
254
+ /**
255
+ * returns the time in the shortest string
256
+ * @param time
257
+ * @returns
258
+ *
259
+ * @example
260
+ * ```ts
261
+ * const time = 345;
262
+ * const timeString = DyFM_Time.getTimeInShortestString(time);
263
+ * console.log(timeString); // 345ms
264
+ * ```
265
+ */
130
266
  static getTimeInShortestString(time: number): string;
131
267
  }
132
268
  //# sourceMappingURL=time.util.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"time.util.d.ts","sourceRoot":"","sources":["../../../src/_collections/utils/time.util.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAIzE;;GAEG;AACH,qBAAa,SAAS;IAEpB;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,MAAM,QAAU;IAEhC;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,MAAM,SAAU;IAEhC;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,SAAQ;IAE5B;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,GAAG,SAAO;IAE1B;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,SAAQ;IAE5B;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,KAAK,SAAS;IAE9B;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,SAAQ;IAE5B;;;;OAIG;IACH,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM;IAIxD;;;;OAIG;IACH,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM;IAQpD;;;;OAIG;IACH,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM;IAQpD;;;;;OAKG;IACH,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAItC;;;;OAIG;IACH,MAAM,CAAC,qBAAqB,CAC1B,YAAY,EAAE,iBAAiB,EAC/B,UAAU,CAAC,EAAE,IAAI,GAChB,IAAI;IAyBP;;;OAGG;IACH,MAAM,CAAC,UAAU,CAAC,UAAU,GAAE,IAAiB,GAAG,IAAI;IAItD;;;OAGG;IACH,MAAM,CAAC,SAAS,CAAC,UAAU,GAAE,IAAiB,GAAG,IAAI;IAIrD;;;OAGG;IACH,MAAM,CAAC,UAAU,CAAC,UAAU,GAAE,IAAiB,GAAG,IAAI;IAItD;;;OAGG;IACH,MAAM,CAAC,WAAW,CAAC,UAAU,GAAE,IAAiB,GAAG,IAAI;IAIvD;;;OAGG;IACH,MAAM,CAAC,UAAU,CAAC,UAAU,GAAE,IAAiB,GAAG,IAAI;IAItD;;;OAGG;IACH,MAAM,CAAC,WAAW,CAAC,UAAU,GAAE,IAAiB,GAAG,IAAI;IAIvD;;;OAGG;IACH,MAAM,CAAC,cAAc,IAAI,cAAc;IAMvC;;;OAGG;IACH,MAAM,CAAC,sBAAsB,IAAI,cAAc,EAAE;IAQjD;;;OAGG;IACH,MAAM,CAAC,oBAAoB,IAAI,cAAc,EAAE;IAQ/C;;;OAGG;IACH,MAAM,CAAC,eAAe,IAAI,UAAU;IAMpC;;;;OAIG;IACH,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM;IAsBjE;;;;OAIG;IACH,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIxC,MAAM,CAAC,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM;IA0BlE,MAAM,CAAC,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;CAmBrD"}
1
+ {"version":3,"file":"time.util.d.ts","sourceRoot":"","sources":["../../../src/_collections/utils/time.util.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAIzE;;GAEG;AACH,qBAAa,SAAS;IAEpB;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,MAAM,QAAU;IAEhC;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,MAAM,SAAU;IAEhC;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,SAAQ;IAE5B;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,GAAG,SAAO;IAE1B;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,SAAQ;IAE5B;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,KAAK,SAAS;IAE9B;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,SAAQ;IAE5B;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM;IAIxD;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM;IAQpD;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM;IAQpD;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAItC;;;;;;;;;OASG;IACH,MAAM,CAAC,qBAAqB,CAC1B,YAAY,EAAE,iBAAiB,EAC/B,UAAU,CAAC,EAAE,IAAI,GAChB,IAAI;IAyBP;;;;;;;;;;OAUG;IACH,MAAM,CAAC,UAAU,CAAC,UAAU,GAAE,IAAiB,GAAG,IAAI;IAItD;;;;;;;;;;OAUG;IACH,MAAM,CAAC,SAAS,CAAC,UAAU,GAAE,IAAiB,GAAG,IAAI;IAIrD;;;;;;;;;;OAUG;IACH,MAAM,CAAC,UAAU,CAAC,UAAU,GAAE,IAAiB,GAAG,IAAI;IAItD;;;;;;;;;;OAUG;IACH,MAAM,CAAC,WAAW,CAAC,UAAU,GAAE,IAAiB,GAAG,IAAI;IAIvD;;;;;;;;;;OAUG;IACH,MAAM,CAAC,UAAU,CAAC,UAAU,GAAE,IAAiB,GAAG,IAAI;IAItD;;;;;;;;;;OAUG;IACH,MAAM,CAAC,WAAW,CAAC,UAAU,GAAE,IAAiB,GAAG,IAAI;IAIvD;;;;;;;;;OASG;IACH,MAAM,CAAC,cAAc,IAAI,cAAc;IAMvC;;;;;;;;;OASG;IACH,MAAM,CAAC,sBAAsB,IAAI,cAAc,EAAE;IAQjD;;;;;;;;;OASG;IACH,MAAM,CAAC,oBAAoB,IAAI,cAAc,EAAE;IAQ/C;;;;;;;;;OASG;IACH,MAAM,CAAC,eAAe,IAAI,UAAU;IAMpC;;;;;;;;;;OAUG;IACH,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM;IAsBjE;;;;;;;;;;OAUG;IACH,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIxC;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM;IA0BlE;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;CAmBrD"}