@design-edito/tools 0.4.5 → 0.4.6

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 (415) hide show
  1. package/TODO.md +269 -0
  2. package/agnostic/arrays/dedupe/index.js +9 -7
  3. package/agnostic/arrays/dedupe/index.test.js +24 -0
  4. package/agnostic/arrays/find-duplicates/index.js +34 -22
  5. package/agnostic/arrays/find-duplicates/index.test.js +31 -0
  6. package/agnostic/arrays/index.d.ts +2 -2
  7. package/agnostic/arrays/index.js +2 -2
  8. package/agnostic/arrays/is-array-of/index.js +28 -26
  9. package/agnostic/arrays/is-array-of/index.test.js +56 -0
  10. package/agnostic/arrays/make/index.js +11 -6
  11. package/agnostic/arrays/make/index.test.js +10 -0
  12. package/agnostic/arrays/random-pick/index.js +38 -22
  13. package/agnostic/arrays/random-pick/index.test.js +23 -0
  14. package/agnostic/arrays/shuffle/index.js +15 -11
  15. package/agnostic/arrays/shuffle/index.test.js +14 -0
  16. package/agnostic/booleans/is-falsy/index.js +24 -15
  17. package/agnostic/booleans/is-falsy/index.test.js +26 -0
  18. package/agnostic/colors/channels/index.js +139 -936
  19. package/agnostic/colors/channels/index.test.js +64 -0
  20. package/agnostic/colors/contrast/index.js +24 -643
  21. package/agnostic/colors/contrast/index.test.js +21 -0
  22. package/agnostic/colors/convert/index.js +811 -837
  23. package/agnostic/colors/convert/index.test.js +98 -0
  24. package/agnostic/colors/cssColorsMap.js +153 -0
  25. package/agnostic/colors/distance/index.js +66 -538
  26. package/agnostic/colors/distance/index.test.js +21 -0
  27. package/agnostic/colors/grayscale/index.js +95 -872
  28. package/agnostic/colors/grayscale/index.test.js +34 -0
  29. package/agnostic/colors/index.d.ts +2 -2
  30. package/agnostic/colors/index.js +2 -2
  31. package/agnostic/colors/invert/index.js +34 -719
  32. package/agnostic/colors/invert/index.test.js +31 -0
  33. package/agnostic/colors/lerp/index.js +75 -804
  34. package/agnostic/colors/lerp/index.test.js +55 -0
  35. package/agnostic/colors/luminance/index.js +17 -625
  36. package/agnostic/colors/luminance/index.test.js +30 -0
  37. package/agnostic/colors/palette/index.js +83 -917
  38. package/agnostic/colors/palette/index.test.js +35 -0
  39. package/agnostic/colors/rotate/index.js +35 -835
  40. package/agnostic/colors/rotate/index.test.js +45 -0
  41. package/agnostic/colors/tidy/index.js +79 -530
  42. package/agnostic/colors/tidy/index.test.js +45 -0
  43. package/agnostic/colors/typechecks/index.js +188 -250
  44. package/agnostic/colors/typechecks/index.test.js +113 -0
  45. package/agnostic/colors/types.js +1 -0
  46. package/agnostic/css/bem/index.js +134 -171
  47. package/agnostic/css/clss/index.js +64 -29
  48. package/agnostic/css/clss/index.test.js +60 -0
  49. package/agnostic/css/generate-nice-color/index.js +26 -71
  50. package/agnostic/css/generate-nice-color/index.test.js +8 -0
  51. package/agnostic/css/index.d.ts +2 -2
  52. package/agnostic/css/index.js +2 -2
  53. package/agnostic/css/is-valid-css-class-name/index.js +14 -8
  54. package/agnostic/css/is-valid-css-class-name/index.test.js +36 -0
  55. package/agnostic/css/scale/index.js +37 -50
  56. package/agnostic/css/scale/index.test.js +71 -0
  57. package/agnostic/css/styles-set/index.js +151 -178
  58. package/agnostic/errors/index.d.ts +1 -1
  59. package/agnostic/errors/index.js +1 -1
  60. package/agnostic/errors/register/index.js +45 -49
  61. package/agnostic/errors/unknown-to-string/index.js +17 -10
  62. package/agnostic/errors/unknown-to-string/index.test.js +35 -0
  63. package/agnostic/html/get-node-ancestors/index.js +29 -29
  64. package/agnostic/html/get-node-ancestors/index.test.js +58 -0
  65. package/agnostic/html/get-position-inside-parent/index.js +13 -8
  66. package/agnostic/html/get-position-inside-parent/index.test.js +56 -0
  67. package/agnostic/html/hyper-json/cast/index.js +128 -2931
  68. package/agnostic/html/hyper-json/index.js +23 -2954
  69. package/agnostic/html/hyper-json/method/index.js +10 -14
  70. package/agnostic/html/hyper-json/serialize/index.js +88 -222
  71. package/agnostic/html/hyper-json/smart-tags/coalesced/add/index.js +14 -2938
  72. package/agnostic/html/hyper-json/smart-tags/coalesced/addclass/index.js +27 -2937
  73. package/agnostic/html/hyper-json/smart-tags/coalesced/and/index.js +13 -2938
  74. package/agnostic/html/hyper-json/smart-tags/coalesced/append/index.js +34 -2938
  75. package/agnostic/html/hyper-json/smart-tags/coalesced/at/index.js +42 -2935
  76. package/agnostic/html/hyper-json/smart-tags/coalesced/call/index.js +47 -2937
  77. package/agnostic/html/hyper-json/smart-tags/coalesced/clone/index.js +10 -2939
  78. package/agnostic/html/hyper-json/smart-tags/coalesced/deleteproperties/index.js +45 -2936
  79. package/agnostic/html/hyper-json/smart-tags/coalesced/equals/index.js +22 -2938
  80. package/agnostic/html/hyper-json/smart-tags/coalesced/getattribute/index.js +26 -2938
  81. package/agnostic/html/hyper-json/smart-tags/coalesced/getproperties/index.js +19 -2938
  82. package/agnostic/html/hyper-json/smart-tags/coalesced/getproperty/index.js +67 -2935
  83. package/agnostic/html/hyper-json/smart-tags/coalesced/hjparse/index.js +21 -2937
  84. package/agnostic/html/hyper-json/smart-tags/coalesced/hjstringify/index.js +89 -2938
  85. package/agnostic/html/hyper-json/smart-tags/coalesced/if/index.js +20 -2938
  86. package/agnostic/html/hyper-json/smart-tags/coalesced/index.d.ts +18 -18
  87. package/agnostic/html/hyper-json/smart-tags/coalesced/index.js +18 -18
  88. package/agnostic/html/hyper-json/smart-tags/coalesced/initialize/index.js +37 -2938
  89. package/agnostic/html/hyper-json/smart-tags/coalesced/join/index.js +16 -2938
  90. package/agnostic/html/hyper-json/smart-tags/coalesced/length/index.js +21 -2938
  91. package/agnostic/html/hyper-json/smart-tags/coalesced/map/index.js +31 -2938
  92. package/agnostic/html/hyper-json/smart-tags/coalesced/negate/index.js +10 -2939
  93. package/agnostic/html/hyper-json/smart-tags/coalesced/notrailing/index.js +33 -2938
  94. package/agnostic/html/hyper-json/smart-tags/coalesced/or/index.js +13 -2938
  95. package/agnostic/html/hyper-json/smart-tags/coalesced/pickrandom/index.js +17 -2938
  96. package/agnostic/html/hyper-json/smart-tags/coalesced/populate/index.js +59 -2938
  97. package/agnostic/html/hyper-json/smart-tags/coalesced/print/index.js +23 -2938
  98. package/agnostic/html/hyper-json/smart-tags/coalesced/push/index.js +10 -2939
  99. package/agnostic/html/hyper-json/smart-tags/coalesced/pusheach/index.js +26 -2938
  100. package/agnostic/html/hyper-json/smart-tags/coalesced/recordtoarray/index.js +10 -2939
  101. package/agnostic/html/hyper-json/smart-tags/coalesced/removeattribute/index.js +53 -2935
  102. package/agnostic/html/hyper-json/smart-tags/coalesced/removeclass/index.js +27 -2937
  103. package/agnostic/html/hyper-json/smart-tags/coalesced/renameproperty/index.js +31 -2937
  104. package/agnostic/html/hyper-json/smart-tags/coalesced/replace/index.js +55 -2940
  105. package/agnostic/html/hyper-json/smart-tags/coalesced/select/index.js +29 -2935
  106. package/agnostic/html/hyper-json/smart-tags/coalesced/set/index.js +29 -2938
  107. package/agnostic/html/hyper-json/smart-tags/coalesced/setattribute/index.js +53 -2935
  108. package/agnostic/html/hyper-json/smart-tags/coalesced/setproperty/index.js +232 -2936
  109. package/agnostic/html/hyper-json/smart-tags/coalesced/sorton/index.js +89 -2936
  110. package/agnostic/html/hyper-json/smart-tags/coalesced/split/index.js +20 -2938
  111. package/agnostic/html/hyper-json/smart-tags/coalesced/spread/index.js +23 -2939
  112. package/agnostic/html/hyper-json/smart-tags/coalesced/toarray/index.js +11 -2939
  113. package/agnostic/html/hyper-json/smart-tags/coalesced/toboolean/index.js +11 -2939
  114. package/agnostic/html/hyper-json/smart-tags/coalesced/toelement/index.js +17 -2938
  115. package/agnostic/html/hyper-json/smart-tags/coalesced/toggleclass/index.js +27 -2937
  116. package/agnostic/html/hyper-json/smart-tags/coalesced/tonodelist/index.js +11 -2939
  117. package/agnostic/html/hyper-json/smart-tags/coalesced/tonull/index.js +10 -2939
  118. package/agnostic/html/hyper-json/smart-tags/coalesced/tonumber/index.js +11 -2939
  119. package/agnostic/html/hyper-json/smart-tags/coalesced/torecord/index.js +11 -2939
  120. package/agnostic/html/hyper-json/smart-tags/coalesced/toref/index.js +11 -2939
  121. package/agnostic/html/hyper-json/smart-tags/coalesced/tostring/index.js +11 -2939
  122. package/agnostic/html/hyper-json/smart-tags/coalesced/totext/index.js +11 -2939
  123. package/agnostic/html/hyper-json/smart-tags/coalesced/transformselected/index.js +84 -2938
  124. package/agnostic/html/hyper-json/smart-tags/coalesced/trim/index.js +14 -2938
  125. package/agnostic/html/hyper-json/smart-tags/index.js +28 -181
  126. package/agnostic/html/hyper-json/smart-tags/isolated/any/index.js +12 -195
  127. package/agnostic/html/hyper-json/smart-tags/isolated/array/index.js +12 -195
  128. package/agnostic/html/hyper-json/smart-tags/isolated/boolean/index.js +12 -2939
  129. package/agnostic/html/hyper-json/smart-tags/isolated/element/index.js +24 -2938
  130. package/agnostic/html/hyper-json/smart-tags/isolated/get/index.js +18 -2938
  131. package/agnostic/html/hyper-json/smart-tags/isolated/guess/index.js +56 -2937
  132. package/agnostic/html/hyper-json/smart-tags/isolated/index.d.ts +1 -1
  133. package/agnostic/html/hyper-json/smart-tags/isolated/index.js +1 -1
  134. package/agnostic/html/hyper-json/smart-tags/isolated/nodelist/index.js +18 -2938
  135. package/agnostic/html/hyper-json/smart-tags/isolated/null/index.js +9 -193
  136. package/agnostic/html/hyper-json/smart-tags/isolated/number/index.js +16 -2938
  137. package/agnostic/html/hyper-json/smart-tags/isolated/record/index.js +12 -2938
  138. package/agnostic/html/hyper-json/smart-tags/isolated/ref/index.js +40 -2935
  139. package/agnostic/html/hyper-json/smart-tags/isolated/string/index.js +16 -2938
  140. package/agnostic/html/hyper-json/smart-tags/isolated/text/index.js +18 -2938
  141. package/agnostic/html/hyper-json/transformer/index.js +112 -148
  142. package/agnostic/html/hyper-json/tree/index.js +411 -2928
  143. package/agnostic/html/hyper-json/types/index.js +27 -18
  144. package/agnostic/html/hyper-json/utils/index.js +497 -2921
  145. package/agnostic/html/index.d.ts +2 -2
  146. package/agnostic/html/index.js +2 -2
  147. package/agnostic/html/insert-node/index.js +27 -16
  148. package/agnostic/html/insert-node/index.test.js +73 -0
  149. package/agnostic/html/placeholders/index.js +26 -29
  150. package/agnostic/html/replace-in-element/index.js +31 -48
  151. package/agnostic/html/replace-in-element/index.test.js +80 -0
  152. package/agnostic/html/selector-to-element/index.js +53 -39
  153. package/agnostic/html/selector-to-element/index.test.js +69 -0
  154. package/agnostic/html/string-to-nodes/index.js +24 -25
  155. package/agnostic/html/string-to-nodes/index.test.js +54 -0
  156. package/agnostic/index.d.ts +6 -6
  157. package/agnostic/index.js +6 -6
  158. package/agnostic/misc/assert/index.js +60 -66
  159. package/agnostic/misc/cast/index.js +123 -57
  160. package/agnostic/misc/cast/index.test.js +134 -0
  161. package/agnostic/misc/connection/index.js +55 -36
  162. package/agnostic/misc/connection/index.test.js +143 -0
  163. package/agnostic/misc/crawler/index.js +68 -46
  164. package/agnostic/misc/crawler/index.test.js +56 -0
  165. package/agnostic/misc/crossenv/detect-runtime/index.js +41 -13
  166. package/agnostic/misc/crossenv/detect-runtime/index.test.js +24 -0
  167. package/agnostic/misc/crossenv/types.js +21 -14
  168. package/agnostic/misc/crossenv/window/index.js +45 -24
  169. package/agnostic/misc/crossenv/window/index.test.js +24 -0
  170. package/agnostic/misc/data-size/index.js +182 -294
  171. package/agnostic/misc/data-size/index.test.js +100 -0
  172. package/agnostic/misc/data-size/types.js +1 -0
  173. package/agnostic/misc/index.d.ts +5 -5
  174. package/agnostic/misc/index.js +5 -5
  175. package/agnostic/misc/is-constructor-function/index.js +12 -6
  176. package/agnostic/misc/is-constructor-function/index.test.js +36 -0
  177. package/agnostic/misc/is-nullish/index.js +24 -11
  178. package/agnostic/misc/is-nullish/index.test.js +44 -0
  179. package/agnostic/misc/logs/logger/index.js +115 -140
  180. package/agnostic/misc/logs/make-text-block/index.js +13 -13
  181. package/agnostic/misc/logs/styles/index.js +29 -48
  182. package/agnostic/misc/lorem-ipsum/index.js +51 -201
  183. package/agnostic/misc/lorem-ipsum/index.test.js +49 -0
  184. package/agnostic/misc/normalize-extension/index.js +99 -88
  185. package/agnostic/misc/normalize-extension/index.test.js +40 -0
  186. package/agnostic/misc/outcome/index.js +20 -14
  187. package/agnostic/misc/outcome/index.test.js +40 -0
  188. package/agnostic/numbers/absolute-modulo/index.js +9 -6
  189. package/agnostic/numbers/absolute-modulo/index.test.js +23 -0
  190. package/agnostic/numbers/approximate-rational/index.js +86 -69
  191. package/agnostic/numbers/approximate-rational/index.test.js +90 -0
  192. package/agnostic/numbers/clamp/index.js +12 -8
  193. package/agnostic/numbers/clamp/index.test.js +24 -0
  194. package/agnostic/numbers/geometric-progressions/index.js +25 -16
  195. package/agnostic/numbers/geometric-progressions/index.test.js +45 -0
  196. package/agnostic/numbers/index.d.ts +2 -2
  197. package/agnostic/numbers/index.js +2 -2
  198. package/agnostic/numbers/interpolate/index.js +25 -10
  199. package/agnostic/numbers/interpolate/index.test.js +40 -0
  200. package/agnostic/numbers/round/index.js +30 -15
  201. package/agnostic/numbers/round/index.test.js +56 -0
  202. package/agnostic/objects/deep-get-property/index.js +30 -27
  203. package/agnostic/objects/deep-get-property/index.test.js +59 -0
  204. package/agnostic/objects/enums/is-in-enum/index.js +17 -11
  205. package/agnostic/objects/enums/is-in-enum/index.test.js +100 -0
  206. package/agnostic/objects/flatten-getters/index.js +15 -14
  207. package/agnostic/objects/flatten-getters/index.test.js +78 -0
  208. package/agnostic/objects/index.d.ts +2 -2
  209. package/agnostic/objects/index.js +2 -2
  210. package/agnostic/objects/is-object/index.js +16 -9
  211. package/agnostic/objects/is-object/index.test.js +60 -0
  212. package/agnostic/objects/is-record/index.js +12 -7
  213. package/agnostic/objects/is-record/index.test.js +48 -0
  214. package/agnostic/objects/record-format/index.js +18 -12
  215. package/agnostic/objects/record-format/index.test.js +92 -0
  216. package/agnostic/objects/record-map/index.js +16 -11
  217. package/agnostic/objects/record-map/index.test.js +56 -0
  218. package/agnostic/objects/sort-keys/index.js +15 -11
  219. package/agnostic/objects/sort-keys/index.test.js +37 -0
  220. package/agnostic/objects/validation/index.js +21 -8
  221. package/agnostic/objects/validation/index.test.js +72 -0
  222. package/agnostic/optim/index.d.ts +1 -1
  223. package/agnostic/optim/index.js +1 -1
  224. package/agnostic/optim/memoize/index.js +24 -16
  225. package/agnostic/optim/memoize/index.test.js +30 -0
  226. package/agnostic/optim/throttle-debounce/index.js +120 -102
  227. package/agnostic/optim/throttle-debounce/index.test.js +44 -0
  228. package/agnostic/optim/throttle-debounce/types.js +1 -0
  229. package/agnostic/random/hex-char/index.js +8 -10
  230. package/agnostic/random/hex-char/index.test.js +20 -0
  231. package/agnostic/random/index.d.ts +1 -1
  232. package/agnostic/random/index.js +1 -1
  233. package/agnostic/random/random/index.js +17 -14
  234. package/agnostic/random/random/index.test.js +73 -0
  235. package/agnostic/random/uuid/index.js +28 -20
  236. package/agnostic/random/uuid/index.test.js +45 -0
  237. package/agnostic/regexps/index.js +126 -84
  238. package/agnostic/regexps/index.test.js +108 -0
  239. package/agnostic/sanitization/file-name/index.js +24 -8
  240. package/agnostic/sanitization/file-name/index.test.js +23 -0
  241. package/agnostic/sanitization/html/index.js +172 -122
  242. package/agnostic/sanitization/path/index.js +23 -15
  243. package/agnostic/sanitization/path/index.test.js +18 -0
  244. package/agnostic/sanitization/types.js +1 -0
  245. package/agnostic/sanitization/user-input/index.js +36 -24
  246. package/agnostic/sanitization/user-input/index.test.js +31 -0
  247. package/agnostic/strings/char-codes/index.js +123 -55
  248. package/agnostic/strings/matches/index.js +35 -16
  249. package/agnostic/strings/normalize-indent/index.js +34 -16
  250. package/agnostic/strings/parse-table/index.js +153 -86
  251. package/agnostic/strings/replace-all/index.js +36 -15
  252. package/agnostic/strings/to-alphanum/index.js +23 -8
  253. package/agnostic/strings/trim/index.js +22 -9
  254. package/agnostic/time/dates/format-date/index.js +140 -72
  255. package/agnostic/time/duration/index.js +106 -140
  256. package/agnostic/time/timeout/index.js +24 -16
  257. package/agnostic/time/transitions/index.js +200 -158
  258. package/agnostic/time/wait/index.js +10 -8
  259. package/agnostic/typescript/types.js +1 -0
  260. package/components/BeforeAfter/index.controlled.js +95 -0
  261. package/components/BeforeAfter/index.js +54 -189
  262. package/components/BeforeAfter/utils.js +9 -0
  263. package/components/Disclaimer/index.js +50 -110
  264. package/components/Drawer/index.js +81 -196
  265. package/components/EventListener/index.js +29 -80
  266. package/components/Gallery/index.js +146 -221
  267. package/components/Gallery/utils.js +12 -0
  268. package/components/Image/index.js +66 -293
  269. package/components/IntersectionObserver/index.js +62 -110
  270. package/components/Overlayer/index.js +59 -103
  271. package/components/Paginator/index.js +124 -155
  272. package/components/ResizeObserver/index.js +66 -119
  273. package/components/ResizeObserver/style.module.css +0 -0
  274. package/components/Scrllgngn/index.js +171 -468
  275. package/components/ScrollListener/index.js +97 -276
  276. package/components/ScrollListener/utils.js +51 -0
  277. package/components/Sequencer/index.controlled.js +67 -0
  278. package/components/Sequencer/index.js +105 -262
  279. package/components/ShadowRoot/index.js +42 -96
  280. package/components/Subtitles/index.js +107 -244
  281. package/components/Subtitles/types.js +1 -0
  282. package/components/Subtitles/utils.js +102 -0
  283. package/components/Theatre/index.js +88 -136
  284. package/components/UIModule/index.js +156 -199
  285. package/components/Video/index.js +292 -857
  286. package/components/Video/utils.js +137 -0
  287. package/components/_WIP_AudioQuote/index.js +1 -0
  288. package/components/_WIP_Icon/index.js +1 -0
  289. package/components/index.d.ts +5 -5
  290. package/components/index.js +5 -5
  291. package/components/public-classnames.js +18 -0
  292. package/components/utils/index.js +11 -11
  293. package/components/utils/types.js +1 -0
  294. package/index.d.ts +1 -1
  295. package/index.js +1 -1
  296. package/node/@aws-s3/index.test.js +6 -0
  297. package/node/@aws-s3/storage/directory/copy-dir/index.js +66 -72
  298. package/node/@aws-s3/storage/directory/index.d.ts +2 -2
  299. package/node/@aws-s3/storage/directory/index.js +2 -2
  300. package/node/@aws-s3/storage/directory/list/index.js +32 -42
  301. package/node/@aws-s3/storage/directory/move-dir/index.js +68 -86
  302. package/node/@aws-s3/storage/directory/remove-dir/index.js +56 -67
  303. package/node/@aws-s3/storage/file/copy/index.js +41 -53
  304. package/node/@aws-s3/storage/file/download/index.js +29 -40
  305. package/node/@aws-s3/storage/file/exists/index.js +35 -43
  306. package/node/@aws-s3/storage/file/index.d.ts +1 -1
  307. package/node/@aws-s3/storage/file/index.js +1 -1
  308. package/node/@aws-s3/storage/file/move/index.js +57 -63
  309. package/node/@aws-s3/storage/file/remove/index.js +35 -43
  310. package/node/@aws-s3/storage/file/stat/index.js +33 -47
  311. package/node/@aws-s3/storage/file/upload/index.js +52 -63
  312. package/node/@design-edito/index.js +1 -0
  313. package/node/@express/@multer/index.js +61 -55
  314. package/node/@google-cloud/storage/bucket/get-metadata/index.js +25 -29
  315. package/node/@google-cloud/storage/directory/copy-dir/index.js +35 -41
  316. package/node/@google-cloud/storage/directory/index.d.ts +1 -1
  317. package/node/@google-cloud/storage/directory/index.js +1 -1
  318. package/node/@google-cloud/storage/directory/list/index.js +28 -35
  319. package/node/@google-cloud/storage/directory/move-dir/index.js +43 -42
  320. package/node/@google-cloud/storage/directory/remove-dir/index.js +34 -38
  321. package/node/@google-cloud/storage/file/copy/index.js +35 -40
  322. package/node/@google-cloud/storage/file/download/index.js +27 -34
  323. package/node/@google-cloud/storage/file/exists/index.js +25 -31
  324. package/node/@google-cloud/storage/file/generate-signed-url/index.js +33 -35
  325. package/node/@google-cloud/storage/file/get-metadata/index.js +28 -31
  326. package/node/@google-cloud/storage/file/get-permissions/index.js +25 -31
  327. package/node/@google-cloud/storage/file/index.d.ts +2 -2
  328. package/node/@google-cloud/storage/file/index.js +2 -2
  329. package/node/@google-cloud/storage/file/move/index.js +38 -42
  330. package/node/@google-cloud/storage/file/remove/index.js +34 -35
  331. package/node/@google-cloud/storage/file/revoke-signed-urls/index.js +32 -95
  332. package/node/@google-cloud/storage/file/stat/index.js +34 -38
  333. package/node/@google-cloud/storage/file/update-metadata/index.js +30 -31
  334. package/node/@google-cloud/storage/file/upload/index.js +44 -46
  335. package/node/@google-cloud/storage/index.d.ts +1 -1
  336. package/node/@google-cloud/storage/index.js +1 -1
  337. package/node/cloud-storage/clients/index.js +35 -15
  338. package/node/cloud-storage/operations/copy-dir/index.js +30 -203
  339. package/node/cloud-storage/operations/copy-file/index.js +30 -152
  340. package/node/cloud-storage/operations/download-file/index.js +30 -103
  341. package/node/cloud-storage/operations/exists-file/index.js +30 -103
  342. package/node/cloud-storage/operations/index.d.ts +2 -2
  343. package/node/cloud-storage/operations/index.js +2 -2
  344. package/node/cloud-storage/operations/list-dir/index.js +29 -98
  345. package/node/cloud-storage/operations/move-dir/index.js +30 -169
  346. package/node/cloud-storage/operations/move-file/index.js +30 -157
  347. package/node/cloud-storage/operations/remove-dir/index.js +29 -159
  348. package/node/cloud-storage/operations/remove-file/index.js +29 -121
  349. package/node/cloud-storage/operations/stat-file/index.js +29 -124
  350. package/node/cloud-storage/operations/upload-file/index.js +30 -162
  351. package/node/encryption/@aes-256-gcm/buffer/index.js +31 -72
  352. package/node/encryption/@aes-256-gcm/uint8-array/index.js +55 -55
  353. package/node/encryption/key/index.js +19 -12
  354. package/node/files/index.d.ts +1 -1
  355. package/node/files/index.js +1 -1
  356. package/node/files/is-in-directory/index.js +11 -8
  357. package/node/files/read-write/index.js +11 -15
  358. package/node/files/subpaths/index.js +156 -121
  359. package/node/ftps/directory/copy-dir/index.js +55 -62
  360. package/node/ftps/directory/list/index.js +24 -29
  361. package/node/ftps/directory/move-dir/index.js +38 -38
  362. package/node/ftps/directory/remove-dir/index.js +39 -42
  363. package/node/ftps/file/copy/index.js +42 -47
  364. package/node/ftps/file/download/index.js +29 -34
  365. package/node/ftps/file/exists/index.js +38 -36
  366. package/node/ftps/file/index.d.ts +2 -2
  367. package/node/ftps/file/index.js +2 -2
  368. package/node/ftps/file/move/index.js +46 -44
  369. package/node/ftps/file/remove/index.js +36 -39
  370. package/node/ftps/file/stat/index.js +30 -38
  371. package/node/ftps/file/upload/index.js +40 -44
  372. package/node/images/create/index.js +10 -562
  373. package/node/images/format/index.js +264 -815
  374. package/node/images/metadata/index.js +10 -571
  375. package/node/images/transform/index.js +169 -1022
  376. package/node/images/transform/operations/blur/index.js +11 -24
  377. package/node/images/transform/operations/brighten/index.js +11 -24
  378. package/node/images/transform/operations/extend/index.js +25 -589
  379. package/node/images/transform/operations/extract/index.js +15 -28
  380. package/node/images/transform/operations/flatten/index.js +20 -584
  381. package/node/images/transform/operations/flip/index.js +2 -6
  382. package/node/images/transform/operations/flop/index.js +2 -6
  383. package/node/images/transform/operations/hue/index.js +13 -26
  384. package/node/images/transform/operations/index.d.ts +5 -5
  385. package/node/images/transform/operations/index.js +5 -5
  386. package/node/images/transform/operations/level/index.js +14 -30
  387. package/node/images/transform/operations/lighten/index.js +13 -26
  388. package/node/images/transform/operations/normalize/index.js +14 -27
  389. package/node/images/transform/operations/overlay/index.js +89 -673
  390. package/node/images/transform/operations/resize/index.js +46 -610
  391. package/node/images/transform/operations/rotate/index.js +20 -584
  392. package/node/images/transform/operations/saturate/index.js +14 -27
  393. package/node/images/types.js +34 -31
  394. package/node/images/utils/index.js +84 -568
  395. package/node/index.d.ts +5 -5
  396. package/node/index.js +5 -5
  397. package/node/process/on-exit/index.js +45 -26
  398. package/node/process/prompt-continue/index.js +29 -14
  399. package/node/process/spawner/index.js +104 -134
  400. package/node/sftp/directory/copy-dir/index.js +52 -60
  401. package/node/sftp/directory/index.d.ts +1 -1
  402. package/node/sftp/directory/index.js +1 -1
  403. package/node/sftp/directory/list/index.js +22 -29
  404. package/node/sftp/directory/move-dir/index.js +35 -35
  405. package/node/sftp/directory/remove-dir/index.js +39 -42
  406. package/node/sftp/file/copy/index.js +37 -45
  407. package/node/sftp/file/download/index.js +26 -32
  408. package/node/sftp/file/exists/index.js +29 -29
  409. package/node/sftp/file/index.d.ts +1 -1
  410. package/node/sftp/file/index.js +1 -1
  411. package/node/sftp/file/move/index.js +39 -38
  412. package/node/sftp/file/remove/index.js +31 -34
  413. package/node/sftp/file/stat/index.js +26 -37
  414. package/node/sftp/file/upload/index.js +34 -38
  415. package/package.json +1 -1
@@ -1,104 +1,60 @@
1
- // src/agnostic/css/clss/index.ts
2
- function clss(blockNames, options) {
3
- const blockNamesArr = Array.isArray(blockNames) ? blockNames : [blockNames];
4
- return (eltNames = null, modNames = []) => {
5
- const eltNamesArr = Array.isArray(eltNames) ? eltNames : [eltNames];
6
- const modNamesArr = (Array.isArray(modNames) ? modNames : [modNames]).map((modName) => {
7
- if (typeof modName === "string") return modName;
8
- const trueModNames = Object.entries(modName).filter((entry) => entry[1] === true).map(([key]) => key);
9
- return trueModNames;
10
- }).flat();
11
- const outputClassesArr = [];
12
- blockNamesArr.forEach((compName) => {
13
- eltNamesArr.forEach((eltName) => {
14
- const targetPublicClss = eltName === null ? compName : `${compName}__${eltName}`;
15
- const targetPrivateClss = eltName === null ? options?.cssModule[options.cssModuleRoot ?? "root"] : options?.cssModule[eltName];
16
- outputClassesArr.push(targetPublicClss);
17
- if (targetPrivateClss !== void 0) outputClassesArr.push(targetPrivateClss);
18
- modNamesArr.forEach((modName) => {
19
- const targetModifiedPublicClss = `${targetPublicClss}--${modName}`;
20
- const targetModifiedPrivateClss = eltName === null ? options?.cssModule[`${options.cssModuleRoot ?? "root"}--${modName}`] : options?.cssModule[`${eltName}--${modName}`];
21
- outputClassesArr.push(targetModifiedPublicClss);
22
- if (targetModifiedPrivateClss !== void 0) outputClassesArr.push(targetModifiedPrivateClss);
23
- });
24
- });
25
- });
26
- return outputClassesArr.join(" ");
27
- };
28
- }
29
-
30
- // src/agnostic/misc/is-nullish/index.ts
31
- var nullishValues = [null, void 0];
32
-
33
- // src/agnostic/booleans/is-falsy/index.ts
34
- var falsyValues = [...nullishValues, false, "", 0, -0, NaN];
35
- if (typeof BigInt === "function") falsyValues.push(BigInt(0));
36
- function isFalsy(val) {
37
- return falsyValues.includes(val);
38
- }
39
-
40
- // src/components/utils/index.tsx
41
- function mergeClassNames(...names) {
42
- return names.map((name) => {
43
- if (typeof name !== "string" && !Array.isArray(name)) return false;
44
- if (Array.isArray(name)) return mergeClassNames(...name);
45
- if (name.trim() === "") return false;
46
- return name.trim();
47
- }).filter((name) => typeof name === "string").join(" ");
48
- }
49
-
50
- // src/components/public-classnames.ts
51
- var overlayer = "dsed-overlayer";
52
-
53
- // src/components/Overlayer/index.tsx
54
- import cssModule from "./styles.module.css";
55
- import { jsx, jsxs } from "react/jsx-runtime";
56
- var Overlayer = ({
57
- overlays,
58
- children,
59
- className
60
- }) => {
61
- const c = clss(overlayer, { cssModule });
62
- const rootClss = mergeClassNames(c(), className);
63
- const baseClss = c("base");
64
- return /* @__PURE__ */ jsxs("div", { className: rootClss, children: [
65
- /* @__PURE__ */ jsx("div", { className: baseClss, children }),
66
- overlays?.map(({
67
- content,
68
- xPercent = 0,
69
- yPercent = 0,
70
- justify
71
- }) => {
72
- const overlayClss = c("overlay");
73
- let computedTranslateX;
74
- if (typeof justify === "number") {
75
- computedTranslateX = `-${justify}%`;
76
- } else if (justify === "center") {
77
- computedTranslateX = "-50%";
78
- } else if (justify === "left") {
79
- computedTranslateX = "0%";
80
- } else if (justify === "right") {
81
- computedTranslateX = "-100%";
82
- } else {
83
- computedTranslateX = "-50%";
84
- }
85
- const overlayCustomProps = {
86
- "--PRIVATE-left": `${xPercent}%`,
87
- "--PRIVATE-top": `${yPercent}%`,
88
- "--PRIVATE-translate-x": computedTranslateX
89
- };
90
- if (isFalsy(content)) return null;
91
- return /* @__PURE__ */ jsx(
92
- "div",
93
- {
94
- className: overlayClss,
95
- style: overlayCustomProps,
96
- children: content
97
- }
98
- );
99
- })
100
- ] });
101
- };
102
- export {
103
- Overlayer
1
+ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
2
+ import { clss } from '../../agnostic/css/clss/index.js';
3
+ import { isFalsy } from '../../agnostic/booleans/is-falsy/index.js';
4
+ import { mergeClassNames } from '../utils/index.js';
5
+ import { overlayer as publicClassname } from '../public-classnames.js';
6
+ import cssModule from './styles.module.css';
7
+ /**
8
+ * Absolute positioning overlay component. Renders a base content layer and
9
+ * stacks one or more overlays on top of it, each independently positioned via
10
+ * percentage coordinates and a justify alignment.
11
+ *
12
+ * ### Child elements
13
+ * - `__base` — wrapping `<div>` that contains `children`.
14
+ * - `__overlay` one `<div>` per entry in `overlays` (falsy `content` entries
15
+ * are omitted).
16
+ *
17
+ * ### CSS custom properties on each overlay element
18
+ * - `--PRIVATE-left` — derived from `xPercent` (e.g. `42%`). Used internally
19
+ * to set the horizontal anchor position.
20
+ * - `--PRIVATE-top` derived from `yPercent` (e.g. `10%`). Used internally
21
+ * to set the vertical anchor position.
22
+ * - `--PRIVATE-translate-x` derived from `justify`. Used internally to shift
23
+ * the overlay relative to its anchor.
24
+ *
25
+ * @param props - Component properties.
26
+ * @see {@link Props}
27
+ * @returns A root `<div>` containing the base layer and all positioned overlay elements.
28
+ */
29
+ export const Overlayer = ({ overlays, children, className }) => {
30
+ const c = clss(publicClassname, { cssModule });
31
+ const rootClss = mergeClassNames(c(), className);
32
+ const baseClss = c('base');
33
+ return _jsxs("div", { className: rootClss, children: [_jsx("div", { className: baseClss, children: children }), overlays?.map(({ content, xPercent = 0, yPercent = 0, justify }) => {
34
+ const overlayClss = c('overlay');
35
+ let computedTranslateX;
36
+ if (typeof justify === 'number') {
37
+ computedTranslateX = `-${justify}%`;
38
+ }
39
+ else if (justify === 'center') {
40
+ computedTranslateX = '-50%';
41
+ }
42
+ else if (justify === 'left') {
43
+ computedTranslateX = '0%';
44
+ }
45
+ else if (justify === 'right') {
46
+ computedTranslateX = '-100%';
47
+ }
48
+ else {
49
+ computedTranslateX = '-50%';
50
+ }
51
+ const overlayCustomProps = {
52
+ '--PRIVATE-left': `${xPercent}%`,
53
+ '--PRIVATE-top': `${yPercent}%`,
54
+ '--PRIVATE-translate-x': computedTranslateX
55
+ };
56
+ if (isFalsy(content))
57
+ return null;
58
+ return _jsx("div", { className: overlayClss, style: overlayCustomProps, children: content });
59
+ })] });
104
60
  };
@@ -1,157 +1,126 @@
1
- // src/components/Paginator/index.tsx
2
- import {
3
- useEffect,
4
- useRef,
5
- Children,
6
- useState
7
- } from "react";
8
-
9
- // src/agnostic/css/clss/index.ts
10
- function clss(blockNames, options) {
11
- const blockNamesArr = Array.isArray(blockNames) ? blockNames : [blockNames];
12
- return (eltNames = null, modNames = []) => {
13
- const eltNamesArr = Array.isArray(eltNames) ? eltNames : [eltNames];
14
- const modNamesArr = (Array.isArray(modNames) ? modNames : [modNames]).map((modName) => {
15
- if (typeof modName === "string") return modName;
16
- const trueModNames = Object.entries(modName).filter((entry) => entry[1] === true).map(([key]) => key);
17
- return trueModNames;
18
- }).flat();
19
- const outputClassesArr = [];
20
- blockNamesArr.forEach((compName) => {
21
- eltNamesArr.forEach((eltName) => {
22
- const targetPublicClss = eltName === null ? compName : `${compName}__${eltName}`;
23
- const targetPrivateClss = eltName === null ? options?.cssModule[options.cssModuleRoot ?? "root"] : options?.cssModule[eltName];
24
- outputClassesArr.push(targetPublicClss);
25
- if (targetPrivateClss !== void 0) outputClassesArr.push(targetPrivateClss);
26
- modNamesArr.forEach((modName) => {
27
- const targetModifiedPublicClss = `${targetPublicClss}--${modName}`;
28
- const targetModifiedPrivateClss = eltName === null ? options?.cssModule[`${options.cssModuleRoot ?? "root"}--${modName}`] : options?.cssModule[`${eltName}--${modName}`];
29
- outputClassesArr.push(targetModifiedPublicClss);
30
- if (targetModifiedPrivateClss !== void 0) outputClassesArr.push(targetModifiedPrivateClss);
1
+ import { jsx as _jsx } from "react/jsx-runtime";
2
+ import { useEffect, useRef, Children, useState } from 'react';
3
+ import { clss } from '../../agnostic/css/clss/index.js';
4
+ import { mergeClassNames } from '../utils/index.js';
5
+ import { paginator as publicClassName } from '../public-classnames.js';
6
+ import cssModule from './styles.module.css';
7
+ /**
8
+ * A scroll-driven pagination component that tracks which child page is currently
9
+ * visible in the viewport and the direction of scroll.
10
+ *
11
+ * Each direct child is wrapped in a page slot and observed via
12
+ * {@link IntersectionObserver}. Page slots receive `'prev'`, `'curr'`, or `'next'`
13
+ * positional modifier classes based on their visibility.
14
+ *
15
+ * @param props - Component properties.
16
+ * @see {@link Props}
17
+ *
18
+ * @returns A root div containing a pages wrapper, with each child isolated in
19
+ * its own observed page slot div.
20
+ *
21
+ * @remarks
22
+ * - Scroll direction is throttled to one update per 100ms and only dispatched
23
+ * when the direction actually changes, using an internal ref to avoid stale
24
+ * closure comparisons.
25
+ * - Page visibility is tracked via a single {@link IntersectionObserver} instance
26
+ * that is recreated when `thresholdOffsetPercent` or `children` change.
27
+ * - `currCount` on each {@link PageState} increments each time a page transitions
28
+ * into the `'curr'` position, making it useful as a re-entry counter.
29
+ */
30
+ export const Paginator = ({ thresholdOffsetPercent, stateHandlers, className, children }) => {
31
+ // State, refs, effects
32
+ const [pagesState, setPagesState] = useState(new Map());
33
+ const [directionState, setDirectionState] = useState(null);
34
+ const pagesRef = useRef(null);
35
+ const directionRef = useRef(null);
36
+ // State change handlers
37
+ useEffect(() => {
38
+ stateHandlers?.pageChanged?.(Array
39
+ .from(pagesState)
40
+ .map(([, state]) => state));
41
+ }, [pagesState]);
42
+ useEffect(() => {
43
+ stateHandlers?.directionChanged?.(directionState);
44
+ }, [directionState]);
45
+ // Catch scroll direction listening on scroll events
46
+ useEffect(() => {
47
+ let lastCall = 0;
48
+ let lastScrollY = window.scrollY;
49
+ const handleScroll = (e) => {
50
+ const now = Date.now();
51
+ if (now - lastCall < 100)
52
+ return;
53
+ lastCall = now;
54
+ const currentScrollY = window.scrollY;
55
+ const direction = currentScrollY > lastScrollY ? 'forwards' : 'backwards';
56
+ lastScrollY = currentScrollY;
57
+ if (direction !== directionRef.current) {
58
+ directionRef.current = direction;
59
+ setDirectionState(direction);
60
+ }
61
+ };
62
+ window.addEventListener('scroll', handleScroll);
63
+ window.addEventListener('resize', handleScroll);
64
+ return () => {
65
+ window.removeEventListener('scroll', handleScroll);
66
+ window.removeEventListener('resize', handleScroll);
67
+ };
68
+ }, []);
69
+ // Detect active pages with Intersection Observer
70
+ useEffect(() => {
71
+ if (pagesRef.current === null)
72
+ return;
73
+ const pages = Array.from(pagesRef.current.children);
74
+ const observerRootMargin = `-${thresholdOffsetPercent ?? 0}%`
75
+ + ' 0px'
76
+ + ` -${100 - (thresholdOffsetPercent ?? 0)}%`
77
+ + ' 0px';
78
+ const observer = new IntersectionObserver(entries => {
79
+ setPagesState(prevState => {
80
+ const nextState = new Map(prevState);
81
+ entries.forEach(entry => {
82
+ const index = pageIndexMap.get(entry.target);
83
+ if (index === undefined)
84
+ return;
85
+ const prev = prevState.get(index);
86
+ const position = entry.isIntersecting
87
+ ? 'curr'
88
+ : entry.boundingClientRect.bottom < (entry.rootBounds?.top ?? 0)
89
+ ? 'prev'
90
+ : 'next';
91
+ const currCount = position === 'curr'
92
+ && prev?.position !== 'curr'
93
+ ? (prev?.currCount ?? 0) + 1
94
+ : (prev?.currCount ?? 0);
95
+ nextState.set(index, { position, currCount });
96
+ });
97
+ return nextState;
98
+ });
99
+ }, { rootMargin: observerRootMargin });
100
+ const pageIndexMap = new Map();
101
+ pages.forEach((page, index) => {
102
+ pageIndexMap.set(page, index);
103
+ observer.observe(page);
31
104
  });
32
- });
33
- });
34
- return outputClassesArr.join(" ");
35
- };
36
- }
37
-
38
- // src/components/utils/index.tsx
39
- function mergeClassNames(...names) {
40
- return names.map((name) => {
41
- if (typeof name !== "string" && !Array.isArray(name)) return false;
42
- if (Array.isArray(name)) return mergeClassNames(...name);
43
- if (name.trim() === "") return false;
44
- return name.trim();
45
- }).filter((name) => typeof name === "string").join(" ");
46
- }
47
-
48
- // src/components/public-classnames.ts
49
- var paginator = "dsed-paginator";
50
-
51
- // src/components/Paginator/index.tsx
52
- import cssModule from "./styles.module.css";
53
- import { jsx } from "react/jsx-runtime";
54
- var Paginator = ({
55
- thresholdOffsetPercent,
56
- stateHandlers,
57
- className,
58
- children
59
- }) => {
60
- const [pagesState, setPagesState] = useState(/* @__PURE__ */ new Map());
61
- const [directionState, setDirectionState] = useState(null);
62
- const pagesRef = useRef(null);
63
- const directionRef = useRef(null);
64
- useEffect(() => {
65
- stateHandlers?.pageChanged?.(Array.from(pagesState).map(([, state]) => state));
66
- }, [pagesState]);
67
- useEffect(() => {
68
- stateHandlers?.directionChanged?.(directionState);
69
- }, [directionState]);
70
- useEffect(() => {
71
- let lastCall = 0;
72
- let lastScrollY = window.scrollY;
73
- const handleScroll = (e) => {
74
- const now = Date.now();
75
- if (now - lastCall < 100) return;
76
- lastCall = now;
77
- const currentScrollY = window.scrollY;
78
- const direction = currentScrollY > lastScrollY ? "forwards" : "backwards";
79
- lastScrollY = currentScrollY;
80
- if (direction !== directionRef.current) {
81
- directionRef.current = direction;
82
- setDirectionState(direction);
83
- }
84
- };
85
- window.addEventListener("scroll", handleScroll);
86
- window.addEventListener("resize", handleScroll);
87
- return () => {
88
- window.removeEventListener("scroll", handleScroll);
89
- window.removeEventListener("resize", handleScroll);
90
- };
91
- }, []);
92
- useEffect(() => {
93
- if (pagesRef.current === null) return;
94
- const pages = Array.from(pagesRef.current.children);
95
- const observerRootMargin = `-${thresholdOffsetPercent ?? 0}% 0px -${100 - (thresholdOffsetPercent ?? 0)}% 0px`;
96
- const observer = new IntersectionObserver((entries) => {
97
- setPagesState((prevState) => {
98
- const nextState = new Map(prevState);
99
- entries.forEach((entry) => {
100
- const index = pageIndexMap.get(entry.target);
101
- if (index === void 0) return;
102
- const prev = prevState.get(index);
103
- const position = entry.isIntersecting ? "curr" : entry.boundingClientRect.bottom < (entry.rootBounds?.top ?? 0) ? "prev" : "next";
104
- const currCount = position === "curr" && prev?.position !== "curr" ? (prev?.currCount ?? 0) + 1 : prev?.currCount ?? 0;
105
- nextState.set(index, { position, currCount });
106
- });
107
- return nextState;
108
- });
109
- }, { rootMargin: observerRootMargin });
110
- const pageIndexMap = /* @__PURE__ */ new Map();
111
- pages.forEach((page, index) => {
112
- pageIndexMap.set(page, index);
113
- observer.observe(page);
114
- });
115
- return () => observer.disconnect();
116
- }, [thresholdOffsetPercent, children]);
117
- const c = clss(paginator, { cssModule });
118
- const rootClss = mergeClassNames(
119
- c(null, {
120
- forwards: directionState === "forwards",
121
- backwards: directionState === "backwards"
122
- }),
123
- className
124
- );
125
- const pagesClss = c("pages");
126
- const childrenArr = Children.toArray(children);
127
- return /* @__PURE__ */ jsx("div", { className: rootClss, children: /* @__PURE__ */ jsx(
128
- "div",
129
- {
130
- className: pagesClss,
131
- ref: pagesRef,
132
- children: childrenArr.map((child, pos) => {
133
- const state = pagesState.get(pos);
134
- const pageClss = c("page", {
135
- first: pos === 0,
136
- last: pos === childrenArr.length - 1,
137
- prev: state?.position === "prev",
138
- curr: state?.position === "curr",
139
- next: state?.position === "next"
140
- });
141
- return /* @__PURE__ */ jsx(
142
- "div",
143
- {
144
- className: pageClss,
145
- "data-page": pos,
146
- "data-curr-count": state?.currCount ?? 0,
147
- children: child
148
- },
149
- pos
150
- );
151
- })
152
- }
153
- ) });
154
- };
155
- export {
156
- Paginator
105
+ return () => observer.disconnect();
106
+ }, [thresholdOffsetPercent, children]);
107
+ // Rendering
108
+ const c = clss(publicClassName, { cssModule });
109
+ const rootClss = mergeClassNames(c(null, {
110
+ forwards: directionState === 'forwards',
111
+ backwards: directionState === 'backwards'
112
+ }), className);
113
+ const pagesClss = c('pages');
114
+ const childrenArr = Children.toArray(children);
115
+ return _jsx("div", { className: rootClss, children: _jsx("div", { className: pagesClss, ref: pagesRef, children: childrenArr.map((child, pos) => {
116
+ const state = pagesState.get(pos);
117
+ const pageClss = c('page', {
118
+ first: pos === 0,
119
+ last: pos === childrenArr.length - 1,
120
+ prev: state?.position === 'prev',
121
+ curr: state?.position === 'curr',
122
+ next: state?.position === 'next'
123
+ });
124
+ return _jsx("div", { className: pageClss, "data-page": pos, "data-curr-count": state?.currCount ?? 0, children: child }, pos);
125
+ }) }) });
157
126
  };
@@ -1,122 +1,69 @@
1
- // src/components/ResizeObserver/index.tsx
2
- import {
3
- useRef,
4
- useEffect,
5
- useState
6
- } from "react";
7
-
8
- // src/agnostic/css/clss/index.ts
9
- function clss(blockNames, options) {
10
- const blockNamesArr = Array.isArray(blockNames) ? blockNames : [blockNames];
11
- return (eltNames = null, modNames = []) => {
12
- const eltNamesArr = Array.isArray(eltNames) ? eltNames : [eltNames];
13
- const modNamesArr = (Array.isArray(modNames) ? modNames : [modNames]).map((modName) => {
14
- if (typeof modName === "string") return modName;
15
- const trueModNames = Object.entries(modName).filter((entry) => entry[1] === true).map(([key]) => key);
16
- return trueModNames;
17
- }).flat();
18
- const outputClassesArr = [];
19
- blockNamesArr.forEach((compName) => {
20
- eltNamesArr.forEach((eltName) => {
21
- const targetPublicClss = eltName === null ? compName : `${compName}__${eltName}`;
22
- const targetPrivateClss = eltName === null ? options?.cssModule[options.cssModuleRoot ?? "root"] : options?.cssModule[eltName];
23
- outputClassesArr.push(targetPublicClss);
24
- if (targetPrivateClss !== void 0) outputClassesArr.push(targetPrivateClss);
25
- modNamesArr.forEach((modName) => {
26
- const targetModifiedPublicClss = `${targetPublicClss}--${modName}`;
27
- const targetModifiedPrivateClss = eltName === null ? options?.cssModule[`${options.cssModuleRoot ?? "root"}--${modName}`] : options?.cssModule[`${eltName}--${modName}`];
28
- outputClassesArr.push(targetModifiedPublicClss);
29
- if (targetModifiedPrivateClss !== void 0) outputClassesArr.push(targetModifiedPrivateClss);
1
+ import { jsx as _jsx } from "react/jsx-runtime";
2
+ import { useRef, useEffect, useState } from 'react';
3
+ import { clss } from '../../agnostic/css/clss/index.js';
4
+ import { mergeClassNames } from '../utils/index.js';
5
+ import { resizeObserver as publicClassName } from '../public-classnames.js';
6
+ import cssModule from './style.module.css';
7
+ /**
8
+ * Component that observes its own size changes and exposes the dimensions.
9
+ * Updates are exposed both via data attributes (e.g., `data-width`) and CSS custom properties
10
+ * (e.g., `--<prefix>-width`, `--<prefix>-width-px`) for styling or scripting purposes.
11
+ * @param props - Component properties
12
+ * @see {@link Props}
13
+ * @returns A div wrapping `children`, with resize observation applied.
14
+ */
15
+ export const ResizeObserverComponent = ({ className, onResized, children }) => {
16
+ // Refs, effects & handlers
17
+ const [roEntry, setRoEntry] = useState();
18
+ const rootRef = useRef(null);
19
+ const observerRef = useRef(null);
20
+ const createObserver = () => {
21
+ const root = rootRef.current;
22
+ observerRef.current?.disconnect();
23
+ if (root === null)
24
+ return;
25
+ observerRef.current = new ResizeObserver(entries => {
26
+ const firstEntry = entries[0];
27
+ if (firstEntry !== undefined) {
28
+ const boundingClientRect = firstEntry.target.getBoundingClientRect();
29
+ const fullEntry = {
30
+ entry: firstEntry,
31
+ boundingClientRect
32
+ };
33
+ setRoEntry(fullEntry);
34
+ if (onResized === undefined)
35
+ return;
36
+ onResized(fullEntry);
37
+ }
30
38
  });
31
- });
32
- });
33
- return outputClassesArr.join(" ");
34
- };
35
- }
36
-
37
- // src/components/utils/index.tsx
38
- function mergeClassNames(...names) {
39
- return names.map((name) => {
40
- if (typeof name !== "string" && !Array.isArray(name)) return false;
41
- if (Array.isArray(name)) return mergeClassNames(...name);
42
- if (name.trim() === "") return false;
43
- return name.trim();
44
- }).filter((name) => typeof name === "string").join(" ");
45
- }
46
-
47
- // src/components/public-classnames.ts
48
- var resizeObserver = "dsed-resize-observer";
49
-
50
- // src/components/ResizeObserver/index.tsx
51
- import cssModule from "./style.module.css";
52
- import { jsx } from "react/jsx-runtime";
53
- var ResizeObserverComponent = ({
54
- className,
55
- onResized,
56
- children
57
- }) => {
58
- const [roEntry, setRoEntry] = useState();
59
- const rootRef = useRef(null);
60
- const observerRef = useRef(null);
61
- const createObserver = () => {
62
- const root = rootRef.current;
63
- observerRef.current?.disconnect();
64
- if (root === null) return;
65
- observerRef.current = new ResizeObserver((entries) => {
66
- const firstEntry = entries[0];
67
- if (firstEntry !== void 0) {
68
- const boundingClientRect = firstEntry.target.getBoundingClientRect();
69
- const fullEntry = {
70
- entry: firstEntry,
71
- boundingClientRect
72
- };
73
- setRoEntry(fullEntry);
74
- if (onResized === void 0) return;
75
- onResized(fullEntry);
76
- }
77
- });
78
- observerRef.current.observe(root);
79
- };
80
- useEffect(() => {
81
- createObserver();
82
- return () => observerRef.current?.disconnect();
83
- }, [onResized]);
84
- const {
85
- x,
86
- y,
87
- top,
88
- left,
89
- bottom,
90
- right,
91
- width,
92
- height
93
- } = roEntry?.entry.contentRect ?? {};
94
- const contentRect = { x, y, top, left, bottom, right, width, height };
95
- const dataAttributes = Object.entries(contentRect).reduce((acc, [key, val]) => {
96
- if (val === void 0) return acc;
97
- return { ...acc, [`data-${key}`]: val.toString() };
98
- }, {});
99
- const cssCustomProps = Object.entries(contentRect).reduce((acc, [key, val]) => {
100
- if (val === void 0) return acc;
101
- return {
102
- ...acc,
103
- [`--${resizeObserver}-${key}`]: val.toString(),
104
- [`--${resizeObserver}-${key}-px`]: `${val.toString()}px`
39
+ observerRef.current.observe(root);
105
40
  };
106
- }, {});
107
- const c = clss(resizeObserver, { cssModule });
108
- const rootClss = mergeClassNames(c(null), className);
109
- return /* @__PURE__ */ jsx(
110
- "div",
111
- {
112
- ...dataAttributes,
113
- className: rootClss,
114
- ref: rootRef,
115
- style: { ...cssCustomProps },
116
- children
117
- }
118
- );
119
- };
120
- export {
121
- ResizeObserverComponent
41
+ useEffect(() => {
42
+ createObserver();
43
+ return () => observerRef.current?.disconnect();
44
+ }, [onResized]);
45
+ // Data attributes, CSS custom props & Rendering
46
+ const { x, y, top, left, bottom, right, width, height } = roEntry?.entry.contentRect ?? {};
47
+ const contentRect = { x, y, top, left, bottom, right, width, height };
48
+ const dataAttributes = Object
49
+ .entries(contentRect)
50
+ .reduce((acc, [key, val]) => {
51
+ if (val === undefined)
52
+ return acc;
53
+ return { ...acc, [`data-${key}`]: val.toString() };
54
+ }, {});
55
+ const cssCustomProps = Object
56
+ .entries(contentRect)
57
+ .reduce((acc, [key, val]) => {
58
+ if (val === undefined)
59
+ return acc;
60
+ return {
61
+ ...acc,
62
+ [`--${publicClassName}-${key}`]: val.toString(),
63
+ [`--${publicClassName}-${key}-px`]: `${val.toString()}px`
64
+ };
65
+ }, {});
66
+ const c = clss(publicClassName, { cssModule });
67
+ const rootClss = mergeClassNames(c(null), className);
68
+ return _jsx("div", { ...dataAttributes, className: rootClss, ref: rootRef, style: { ...cssCustomProps }, children: children });
122
69
  };
File without changes