@lostgradient/cinder 0.20.0 → 0.21.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (342) hide show
  1. package/CHANGELOG.md +162 -0
  2. package/components.json +1 -1
  3. package/dist/components/alert-dialog/index.js +481 -162
  4. package/dist/components/approval-card/approval-card.css +3 -0
  5. package/dist/components/approval-card/index.js +402 -119
  6. package/dist/components/area-chart/index.js +252 -1
  7. package/dist/components/autocomplete/index.js +124 -40
  8. package/dist/components/avatar-group/index.js +185 -81
  9. package/dist/components/bar-chart/index.js +252 -1
  10. package/dist/components/button/button.css +13 -3
  11. package/dist/components/calendar/calendar.css +3 -0
  12. package/dist/components/carousel/carousel.css +40 -6
  13. package/dist/components/carousel/carousel.schema.js +43 -2
  14. package/dist/components/carousel/carousel.svelte.d.ts +25 -4
  15. package/dist/components/carousel/carousel.types.d.ts +43 -2
  16. package/dist/components/carousel/carousel.variables.js +7 -2
  17. package/dist/components/carousel/index.d.ts +1 -1
  18. package/dist/components/carousel/index.js +2018 -351
  19. package/dist/components/checkbox/checkbox.css +1 -1
  20. package/dist/components/checkbox-group/checkbox-group.css +1 -1
  21. package/dist/components/chip/chip.css +3 -0
  22. package/dist/components/code-block/code-block.css +35 -2
  23. package/dist/components/code-block/code-block.schema.js +9 -1
  24. package/dist/components/code-block/code-block.types.d.ts +8 -0
  25. package/dist/components/code-block/index.js +263 -4
  26. package/dist/components/color-field/color-field.css +1 -1
  27. package/dist/components/color-picker/color-picker.css +1 -1
  28. package/dist/components/combobox/combobox.css +4 -1
  29. package/dist/components/combobox/index.js +124 -40
  30. package/dist/components/command-menu/index.js +20 -17
  31. package/dist/components/confirm-dialog/index.js +497 -178
  32. package/dist/components/connection-indicator/connection-indicator.css +3 -2
  33. package/dist/components/context-menu/index.js +124 -40
  34. package/dist/components/copy-button/copy-button.css +4 -1
  35. package/dist/components/data-grid/data-grid.css +3 -0
  36. package/dist/components/data-table/index.js +252 -1
  37. package/dist/components/date-picker/date-picker.css +1 -1
  38. package/dist/components/date-picker/index.js +124 -40
  39. package/dist/components/date-range-field/date-range-field.css +7 -1
  40. package/dist/components/date-range-field/index.js +124 -40
  41. package/dist/components/diff-statistics/diff-statistics.css +2 -2
  42. package/dist/components/drawer/drawer.css +20 -12
  43. package/dist/components/drawer/index.js +106 -25
  44. package/dist/components/dropdown/dropdown.css +1 -1
  45. package/dist/components/dropdown/index.js +124 -40
  46. package/dist/components/dropdown-menu/index.js +20 -17
  47. package/dist/components/event-stream-viewer/event-stream-viewer.css +29 -4
  48. package/dist/components/event-stream-viewer/event-stream-viewer.variables.js +5 -2
  49. package/dist/components/event-timeline/event-timeline.css +3 -0
  50. package/dist/components/event-timeline/index.js +124 -40
  51. package/dist/components/focus-trap/index.js +105 -24
  52. package/dist/components/form-field/form-field.css +1 -1
  53. package/dist/components/hover-card/hover-card.css +45 -1
  54. package/dist/components/hover-card/index.js +144 -19
  55. package/dist/components/inline-loading/inline-loading.css +2 -2
  56. package/dist/components/input/input.css +1 -1
  57. package/dist/components/invocation-rule-builder/index.js +124 -40
  58. package/dist/components/invocation-rule-builder/invocation-rule-builder.css +18 -0
  59. package/dist/components/json-editor/json-editor.css +4 -1
  60. package/dist/components/json-schema-editor/index.js +152 -68
  61. package/dist/components/json-viewer/json-viewer.css +5 -2
  62. package/dist/components/kanban-board/index.js +2 -2
  63. package/dist/components/kanban-board/kanban-board.css +1 -1
  64. package/dist/components/line-chart/index.js +252 -1
  65. package/dist/components/marquee/marquee.css +3 -0
  66. package/dist/components/matrix-chart/index.js +252 -1
  67. package/dist/components/menu-bar/index.js +20 -17
  68. package/dist/components/menu-bar/menu-bar.css +3 -0
  69. package/dist/components/meter/index.js +13 -3
  70. package/dist/components/modal/index.js +447 -130
  71. package/dist/components/modal/modal.css +56 -24
  72. package/dist/components/multi-select/index.js +3553 -467
  73. package/dist/components/multi-select/multi-select.css +4 -10
  74. package/dist/components/navigation-bar/index.js +20 -17
  75. package/dist/components/navigation-item/navigation-item.css +3 -0
  76. package/dist/components/pagination/pagination.css +3 -0
  77. package/dist/components/permission-matrix/index.js +252 -1
  78. package/dist/components/permission-matrix/permission-matrix.css +15 -0
  79. package/dist/components/phone-input/phone-input.css +1 -1
  80. package/dist/components/pin-input/pin-input.css +10 -2
  81. package/dist/components/popover/index.js +124 -40
  82. package/dist/components/qr-code/qr-code.css +1 -1
  83. package/dist/components/radio-group/radio-group.css +1 -1
  84. package/dist/components/rating/rating.css +1 -1
  85. package/dist/components/schema-form/schema-form.css +1 -1
  86. package/dist/components/scroll-area/index.js +526 -22
  87. package/dist/components/scroll-area/scroll-area.css +30 -0
  88. package/dist/components/scroll-area/scroll-area.schema.js +9 -1
  89. package/dist/components/scroll-area/scroll-area.types.d.ts +17 -0
  90. package/dist/components/secret-value-field/secret-value-field.css +11 -1
  91. package/dist/components/segmented-control/segmented-control.css +12 -2
  92. package/dist/components/select/select.css +4 -1
  93. package/dist/components/selection-popover/index.js +149 -40
  94. package/dist/components/selection-popover/selection-popover.css +3 -0
  95. package/dist/components/selection-popover/virtual-keyboard-dismissal.svelte.d.ts +14 -0
  96. package/dist/components/sheet/index.js +106 -25
  97. package/dist/components/sheet/sheet.css +20 -12
  98. package/dist/components/sidebar/index.js +106 -25
  99. package/dist/components/sortable-list/index.js +2 -2
  100. package/dist/components/sortable-list/sortable-list.css +14 -9
  101. package/dist/components/speed-dial/index.js +20 -17
  102. package/dist/components/statistic/statistic.css +2 -2
  103. package/dist/components/statistic-group/statistic-group.css +2 -2
  104. package/dist/components/status-dot/status-dot.css +2 -2
  105. package/dist/components/table/index.js +252 -1
  106. package/dist/components/table/table.css +15 -0
  107. package/dist/components/tag-input/tag-input.css +1 -1
  108. package/dist/components/team-section/index.js +193 -89
  109. package/dist/components/textarea/textarea.css +4 -1
  110. package/dist/components/time-field/time-field.css +4 -1
  111. package/dist/components/tooltip/index.js +130 -46
  112. package/dist/components/tooltip/tooltip.schema.js +7 -3
  113. package/dist/components/tooltip/tooltip.types.d.ts +20 -2
  114. package/dist/components/transfer-list/index.js +253 -1
  115. package/dist/components/transfer-list/transfer-list.css +18 -0
  116. package/dist/index.js +22861 -22220
  117. package/dist/server/components/alert-dialog/index.js +7 -4
  118. package/dist/server/components/approval-card/index.js +9 -8
  119. package/dist/server/components/area-chart/index.js +6 -4
  120. package/dist/server/components/autocomplete/index.js +7 -7
  121. package/dist/server/components/avatar-group/index.js +7 -7
  122. package/dist/server/components/bar-chart/index.js +6 -4
  123. package/dist/server/components/carousel/index.js +6 -2
  124. package/dist/server/components/code-block/index.js +5 -3
  125. package/dist/server/components/combobox/index.js +8 -8
  126. package/dist/server/components/command-menu/index.js +5 -5
  127. package/dist/server/components/confirm-dialog/index.js +7 -4
  128. package/dist/server/components/context-menu/index.js +7 -7
  129. package/dist/server/components/data-table/index.js +5 -3
  130. package/dist/server/components/date-picker/index.js +8 -8
  131. package/dist/server/components/date-range-field/index.js +8 -8
  132. package/dist/server/components/drawer/index.js +4 -4
  133. package/dist/server/components/dropdown/index.js +7 -7
  134. package/dist/server/components/dropdown-menu/index.js +6 -6
  135. package/dist/server/components/event-timeline/index.js +6 -6
  136. package/dist/server/components/focus-trap/index.js +3 -3
  137. package/dist/server/components/hover-card/index.js +7 -6
  138. package/dist/server/components/invocation-rule-builder/index.js +8 -8
  139. package/dist/server/components/json-schema-editor/index.js +6 -6
  140. package/dist/server/components/kanban-board/index.js +2 -2
  141. package/dist/server/components/line-chart/index.js +6 -4
  142. package/dist/server/components/matrix-chart/index.js +6 -4
  143. package/dist/server/components/menu-bar/index.js +6 -6
  144. package/dist/server/components/meter/index.js +1 -1
  145. package/dist/server/components/modal/index.js +7 -4
  146. package/dist/server/components/multi-select/index.js +9 -2
  147. package/dist/server/components/navigation-bar/index.js +5 -5
  148. package/dist/server/components/permission-matrix/index.js +4 -2
  149. package/dist/server/components/popover/index.js +7 -7
  150. package/dist/server/components/portal/index.js +3 -3
  151. package/dist/server/components/run-step-timeline/index.js +1 -1
  152. package/dist/server/components/scroll-area/index.js +8 -2
  153. package/dist/server/components/selection-popover/index.js +6 -6
  154. package/dist/server/components/sheet/index.js +3 -3
  155. package/dist/server/components/sidebar/index.js +5 -5
  156. package/dist/server/components/sortable-list/index.js +2 -2
  157. package/dist/server/components/speed-dial/index.js +6 -6
  158. package/dist/server/components/speed-dial-action/index.js +4 -4
  159. package/dist/server/components/table/index.js +5 -3
  160. package/dist/server/components/team-section/index.js +7 -7
  161. package/dist/server/components/toast-region/index.js +3 -3
  162. package/dist/server/components/tooltip/index.js +6 -6
  163. package/dist/server/components/transfer-list/index.js +4 -2
  164. package/dist/server/index.js +69 -68
  165. package/dist/server/{index.server-dvd8t7ds.js → index.server-01bz4wmw.js} +1 -1
  166. package/dist/server/{index.server-gbj2zt1q.js → index.server-03ndc3td.js} +1 -1
  167. package/dist/server/{index.server-1qr1qkjb.js → index.server-0p1z1kbs.js} +1 -1
  168. package/dist/server/{index.server-b36zkjsr.js → index.server-1cnz5ax1.js} +30 -6
  169. package/dist/server/{index.server-xtx9sey2.js → index.server-2bw5fqwh.js} +1 -1
  170. package/dist/server/{index.server-v3t6v21s.js → index.server-2eb8pcev.js} +1 -1
  171. package/dist/server/{index.server-2n185esx.js → index.server-2h45p8kd.js} +2 -2
  172. package/dist/server/{index.server-3gm8s994.js → index.server-2k0cnsm4.js} +30 -2
  173. package/dist/server/{index.server-jwrnsnxk.js → index.server-2qydtmtp.js} +1 -1
  174. package/dist/server/{index.server-4bdnshs1.js → index.server-3e8n2sry.js} +2 -2
  175. package/dist/server/{index.server-dpyw7nad.js → index.server-4sr9f5r0.js} +1 -1
  176. package/dist/server/{index.server-rxvbt0y3.js → index.server-4w0rydct.js} +1 -1
  177. package/dist/server/{index.server-znrr9zve.js → index.server-6184qc69.js} +1 -1
  178. package/dist/server/{index.server-mw3z3nfz.js → index.server-64dvhh7s.js} +8 -2
  179. package/dist/server/{index.server-w9tnnse5.js → index.server-6771g0q4.js} +4 -4
  180. package/dist/server/{index.server-jxy33axv.js → index.server-6e5cj9hs.js} +1 -1
  181. package/dist/server/{index.server-gp0jh4cx.js → index.server-6z6s8qz8.js} +1 -1
  182. package/dist/server/{index.server-jj0tkfqp.js → index.server-72d0qgdy.js} +3 -3
  183. package/dist/server/{index.server-x93qnzqm.js → index.server-77p0jy71.js} +1 -1
  184. package/dist/server/{index.server-cepvcyxn.js → index.server-7kez94sz.js} +17 -6
  185. package/dist/server/{index.server-rd908evp.js → index.server-7sxx7645.js} +2 -2
  186. package/dist/server/{index.server-1br18a82.js → index.server-8t53gqe7.js} +3 -3
  187. package/dist/server/{index.server-jnp8yqgj.js → index.server-8w95jmf1.js} +1 -1
  188. package/dist/server/{index.server-g8j7wnpa.js → index.server-9emgn750.js} +1 -1
  189. package/dist/server/{index.server-zt8d7yer.js → index.server-9n2bc545.js} +1 -1
  190. package/dist/server/{index.server-bprjmaxb.js → index.server-a5w1wy5w.js} +1 -1
  191. package/dist/server/{index.server-t6dkkfxk.js → index.server-a5zsgn3k.js} +1 -1
  192. package/dist/server/{index.server-nsqx19rk.js → index.server-a8gpnzgg.js} +6 -6
  193. package/dist/server/{index.server-edx404az.js → index.server-ayhcc6z5.js} +1 -1
  194. package/dist/server/{index.server-z53avp9h.js → index.server-b7pq5xpd.js} +1 -1
  195. package/dist/server/{index.server-aerjcjgw.js → index.server-cptwpqbr.js} +1 -1
  196. package/dist/server/{index.server-85dr75be.js → index.server-d70brw24.js} +1 -1
  197. package/dist/server/{index.server-wsbwydct.js → index.server-fd3az8g2.js} +3 -3
  198. package/dist/server/{index.server-429t1qje.js → index.server-fka21791.js} +2 -2
  199. package/dist/server/{index.server-vb58jd7c.js → index.server-grq89cv5.js} +1 -1
  200. package/dist/server/{index.server-74g52t91.js → index.server-hxjkfdp2.js} +1 -1
  201. package/dist/server/{index.server-r5y5t888.js → index.server-j4akck2w.js} +1 -1
  202. package/dist/server/{index.server-sqtgjjc3.js → index.server-j57zek3p.js} +1 -1
  203. package/dist/server/index.server-ja3fmd29.js +211 -0
  204. package/dist/server/{index.server-66amt15s.js → index.server-kszs0qx5.js} +25 -2
  205. package/dist/server/{index.server-f02vwrw5.js → index.server-nbq0tmx1.js} +26 -16
  206. package/dist/server/{index.server-ktwnf9vg.js → index.server-nbspp00m.js} +1 -1
  207. package/dist/server/{index.server-xanhe43k.js → index.server-pee1wa4g.js} +1 -1
  208. package/dist/server/{index.server-dqt9we67.js → index.server-q7r53g7z.js} +1 -1
  209. package/dist/server/{index.server-1xq7j9dj.js → index.server-scdk1we9.js} +6 -6
  210. package/dist/server/{index.server-rgcepyhr.js → index.server-sfbna82r.js} +1 -1
  211. package/dist/server/{index.server-dpe08kr7.js → index.server-sgjc9gkq.js} +1 -1
  212. package/dist/server/{index.server-wm3t5yw7.js → index.server-sxkkaj8b.js} +13 -3
  213. package/dist/server/{index.server-r147w5z4.js → index.server-td8rx9dz.js} +1 -1
  214. package/dist/server/{index.server-3g76h7z7.js → index.server-th1tsad4.js} +62 -26
  215. package/dist/server/{index.server-ak9pqjfw.js → index.server-tpny5pjk.js} +224 -91
  216. package/dist/server/{index.server-8wb8g3w1.js → index.server-tvj0x3qy.js} +1 -1
  217. package/dist/server/{index.server-vqb9m9hq.js → index.server-w2jwyz17.js} +2 -2
  218. package/dist/server/{index.server-29sg0ywf.js → index.server-w5f4ex0f.js} +9 -6
  219. package/dist/server/{index.server-5p5r6t6n.js → index.server-w8phxx00.js} +1 -1
  220. package/dist/server/{index.server-tj2erfba.js → index.server-x6hbm4je.js} +2 -2
  221. package/dist/server/{index.server-7r9d6g1c.js → index.server-xqbes4jd.js} +6 -6
  222. package/dist/server/{index.server-j15z5xn7.js → index.server-xsh52hjt.js} +1 -1
  223. package/dist/server/{index.server-k1625sfw.js → index.server-y8m06g9p.js} +1 -1
  224. package/dist/server/{index.server-32p6dz3e.js → index.server-ybb5ery2.js} +1 -1
  225. package/dist/server/{index.server-1p7b8y48.js → index.server-yhjecwfj.js} +6 -6
  226. package/dist/server/{index.server-4nh4arvs.js → index.server-zfxb12hm.js} +30 -48
  227. package/dist/utilities/attachments.d.ts +63 -1
  228. package/dist/utilities/drag-scroll-physics.d.ts +48 -0
  229. package/dist/utilities/use-drag-scroll.svelte.d.ts +26 -0
  230. package/dist/utilities/use-drag-scroll.types.d.ts +15 -0
  231. package/dist/utilities/use-fine-pointer.svelte.d.ts +12 -0
  232. package/dist/utilities/use-fine-pointer.types.d.ts +4 -0
  233. package/package.json +2 -2
  234. package/src/_internal/anchored-overlay.svelte.ts +48 -26
  235. package/src/components/_sortable-item.svelte +21 -2
  236. package/src/components/approval-card/approval-card.css +3 -0
  237. package/src/components/avatar-group/avatar-group.svelte +46 -17
  238. package/src/components/button/button.css +13 -3
  239. package/src/components/calendar/calendar.css +3 -0
  240. package/src/components/carousel/carousel.css +40 -6
  241. package/src/components/carousel/carousel.examples.json +6 -0
  242. package/src/components/carousel/carousel.schema.json +42 -1
  243. package/src/components/carousel/carousel.schema.ts +49 -1
  244. package/src/components/carousel/carousel.svelte +311 -136
  245. package/src/components/carousel/carousel.types.ts +47 -2
  246. package/src/components/carousel/carousel.variables.json +6 -1
  247. package/src/components/carousel/carousel.variables.ts +6 -1
  248. package/src/components/carousel/index.ts +1 -0
  249. package/src/components/checkbox/checkbox.css +1 -1
  250. package/src/components/checkbox-group/checkbox-group.css +1 -1
  251. package/src/components/chip/chip.css +3 -0
  252. package/src/components/code-block/code-block.css +35 -2
  253. package/src/components/code-block/code-block.schema.json +4 -0
  254. package/src/components/code-block/code-block.schema.ts +5 -0
  255. package/src/components/code-block/code-block.svelte +12 -2
  256. package/src/components/code-block/code-block.types.ts +8 -0
  257. package/src/components/color-field/color-field.css +1 -1
  258. package/src/components/color-picker/color-picker.css +1 -1
  259. package/src/components/combobox/combobox.css +4 -1
  260. package/src/components/connection-indicator/connection-indicator.css +3 -2
  261. package/src/components/copy-button/copy-button.css +4 -1
  262. package/src/components/data-grid/data-grid.css +3 -0
  263. package/src/components/date-picker/date-picker.css +1 -1
  264. package/src/components/date-range-field/date-range-field.css +7 -1
  265. package/src/components/diff-statistics/diff-statistics.css +2 -2
  266. package/src/components/drawer/drawer.css +20 -12
  267. package/src/components/drawer/drawer.svelte +5 -1
  268. package/src/components/dropdown/dropdown.css +1 -1
  269. package/src/components/event-stream-viewer/event-stream-viewer.css +29 -4
  270. package/src/components/event-stream-viewer/event-stream-viewer.variables.json +1 -1
  271. package/src/components/event-stream-viewer/event-stream-viewer.variables.ts +4 -1
  272. package/src/components/event-timeline/event-timeline.css +3 -0
  273. package/src/components/form-field/form-field.css +1 -1
  274. package/src/components/hover-card/hover-card.css +45 -1
  275. package/src/components/hover-card/hover-card.svelte +64 -2
  276. package/src/components/inline-loading/inline-loading.css +2 -2
  277. package/src/components/input/input.css +1 -1
  278. package/src/components/invocation-rule-builder/invocation-rule-builder.css +18 -0
  279. package/src/components/json-editor/json-editor.css +4 -1
  280. package/src/components/json-viewer/json-viewer.css +5 -2
  281. package/src/components/kanban-board/kanban-board.css +1 -1
  282. package/src/components/marquee/marquee.css +3 -0
  283. package/src/components/menu-bar/menu-bar.css +3 -0
  284. package/src/components/meter/meter.svelte +19 -4
  285. package/src/components/meter/meter.types.ts +4 -0
  286. package/src/components/modal/modal.css +56 -24
  287. package/src/components/modal/modal.svelte +59 -99
  288. package/src/components/multi-select/multi-select.css +4 -10
  289. package/src/components/multi-select/multi-select.svelte +43 -0
  290. package/src/components/navigation-item/navigation-item.css +3 -0
  291. package/src/components/pagination/pagination.css +3 -0
  292. package/src/components/permission-matrix/permission-matrix.css +15 -0
  293. package/src/components/permission-matrix/permission-matrix.svelte +6 -1
  294. package/src/components/phone-input/phone-input.css +1 -1
  295. package/src/components/pin-input/pin-input.css +10 -2
  296. package/src/components/qr-code/qr-code.css +1 -1
  297. package/src/components/radio-group/radio-group.css +1 -1
  298. package/src/components/rating/rating.css +1 -1
  299. package/src/components/schema-form/schema-form.css +1 -1
  300. package/src/components/scroll-area/scroll-area.css +30 -0
  301. package/src/components/scroll-area/scroll-area.schema.json +8 -0
  302. package/src/components/scroll-area/scroll-area.schema.ts +10 -0
  303. package/src/components/scroll-area/scroll-area.svelte +44 -2
  304. package/src/components/scroll-area/scroll-area.types.ts +17 -0
  305. package/src/components/secret-value-field/secret-value-field.css +11 -1
  306. package/src/components/segmented-control/segmented-control.css +12 -2
  307. package/src/components/select/select.css +4 -1
  308. package/src/components/selection-popover/selection-popover.css +3 -0
  309. package/src/components/selection-popover/selection-popover.svelte +32 -0
  310. package/src/components/selection-popover/virtual-keyboard-dismissal.svelte.ts +16 -0
  311. package/src/components/sheet/sheet.css +20 -12
  312. package/src/components/sheet/sheet.svelte +1 -1
  313. package/src/components/sortable-list/sortable-list.css +14 -9
  314. package/src/components/statistic/statistic.css +2 -2
  315. package/src/components/statistic-group/statistic-group.css +2 -2
  316. package/src/components/status-dot/status-dot.css +2 -2
  317. package/src/components/table/table.css +15 -0
  318. package/src/components/table/table.svelte +2 -0
  319. package/src/components/tag-input/tag-input.css +1 -1
  320. package/src/components/textarea/textarea.css +4 -1
  321. package/src/components/time-field/time-field.css +4 -1
  322. package/src/components/tooltip/tooltip.schema.json +6 -2
  323. package/src/components/tooltip/tooltip.schema.ts +8 -2
  324. package/src/components/tooltip/tooltip.svelte +124 -23
  325. package/src/components/tooltip/tooltip.types.ts +20 -2
  326. package/src/components/transfer-list/transfer-list.css +18 -0
  327. package/src/components/transfer-list/transfer-list.svelte +3 -0
  328. package/src/styles/components/_control-item.css +3 -0
  329. package/src/styles/components/_field-label.css +1 -1
  330. package/src/styles/components/_input-frame.css +3 -0
  331. package/src/styles/components/_scroll-fade.css +317 -0
  332. package/src/styles/components/_status-surface.css +21 -1
  333. package/src/styles/components.css +5 -0
  334. package/src/styles/index.css +1 -0
  335. package/src/styles/tokens-base.css +207 -69
  336. package/src/styles/utilities.css +10 -1
  337. package/src/utilities/attachments.ts +202 -26
  338. package/src/utilities/drag-scroll-physics.ts +82 -0
  339. package/src/utilities/use-drag-scroll.svelte.ts +186 -0
  340. package/src/utilities/use-drag-scroll.types.ts +17 -0
  341. package/src/utilities/use-fine-pointer.svelte.ts +23 -0
  342. package/src/utilities/use-fine-pointer.types.ts +4 -0
@@ -113,7 +113,33 @@ export function createClickOutside(options: ClickOutsideOptions): Attachment<HTM
113
113
 
114
114
  /**
115
115
  * Marks scroll containers that have more content below the visible area.
116
- * Intended for overlay bodies that show a bottom mask fade while scrollable.
116
+ * Intended for overlay bodies that show a bottom fade (opaque overlay, never
117
+ * a mask — see `_scroll-fade.css`) while scrollable.
118
+ *
119
+ * Only `node` itself is observed with `ResizeObserver` — it catches the
120
+ * container's own box changing (viewport resize, a sidebar collapsing, a
121
+ * layout pass). Because `node` scrolls (`overflow-y: auto` with a fixed/flex
122
+ * height), content growing or shrinking INSIDE it does not resize `node`'s
123
+ * own box, so that case is covered separately by a `MutationObserver` that
124
+ * schedules a re-measure directly on any child/text/relevant-attribute
125
+ * change. Re-measuring `scrollHeight`/`clientHeight` is a cheap property
126
+ * read, so the mutation callback does not need an observer of its own.
127
+ *
128
+ * This replaces an earlier version that additionally registered a
129
+ * `ResizeObserver` on every descendant (`node.querySelectorAll('*')`,
130
+ * re-synced on every mutation) to catch a size change that occurs without a
131
+ * DOM mutation. That is fine for a handful of nodes in a Modal body, but
132
+ * registers thousands of observers on a long scroll surface such as a chat
133
+ * timeline. Dropping that exhaustive case for a large, real perf win is a
134
+ * deliberate trade-off — the common version of it, an `<img src>` swap (a
135
+ * lazy-load library resolving an attachment thumbnail, for example), IS
136
+ * still covered: `src` is in the `attributeFilter` below, so it schedules a
137
+ * re-measure like any other tracked mutation. What remains uncovered is
138
+ * narrower — a genuinely mutation-less size change, such as a `<canvas>`
139
+ * redraw or a webfont finishing load and reflowing existing text — which is
140
+ * rare enough that every path this attachment is actually exercised through
141
+ * (content added/removed, text/attribute changes, scrolling, container
142
+ * resize) is still covered.
117
143
  */
118
144
  export function overflowFade(): Attachment<HTMLElement> {
119
145
  return (node) => {
@@ -147,41 +173,192 @@ export function overflowFade(): Attachment<HTMLElement> {
147
173
  };
148
174
 
149
175
  const resizeObserver = new ResizeObserver(scheduleUpdate);
150
- const observedElements = new Set<Element>();
151
- const observeElement = (element: Element) => {
152
- if (observedElements.has(element)) return;
153
- resizeObserver.observe(element);
154
- observedElements.add(element);
176
+ resizeObserver.observe(node);
177
+
178
+ const mutationObserver =
179
+ typeof MutationObserver === 'undefined' ? null : new MutationObserver(scheduleUpdate);
180
+
181
+ mutationObserver?.observe(node, {
182
+ childList: true,
183
+ subtree: true,
184
+ characterData: true,
185
+ attributes: true,
186
+ attributeFilter: ['hidden', 'class', 'style', 'aria-hidden', 'src'],
187
+ });
188
+
189
+ node.addEventListener('scroll', scheduleUpdate, { passive: true });
190
+ update();
191
+
192
+ return () => {
193
+ if (frame) cancelFrame(frame);
194
+ resizeObserver.disconnect();
195
+ mutationObserver?.disconnect();
196
+ node.removeEventListener('scroll', scheduleUpdate);
155
197
  };
156
- const syncObservedElements = () => {
157
- const currentElements = new Set<Element>([node, ...node.querySelectorAll('*')]);
158
- for (const element of observedElements) {
159
- if (!currentElements.has(element)) {
160
- resizeObserver.unobserve(element);
161
- observedElements.delete(element);
162
- }
163
- }
164
- for (const element of currentElements) {
165
- observeElement(element);
166
- }
198
+ };
199
+ }
200
+
201
+ /** Which scroll axis {@link overflowShadow} measures and reports. */
202
+ export type OverflowShadowAxis = 'inline' | 'block';
203
+
204
+ const OVERFLOW_SHADOW_ATTRIBUTE: Record<OverflowShadowAxis, string> = {
205
+ inline: 'data-cinder-overflows-inline',
206
+ block: 'data-cinder-overflows-block',
207
+ };
208
+
209
+ /**
210
+ * Marks scroll containers that have MORE content than fits on the given
211
+ * axis, in EITHER direction — unlike {@link overflowFade}, this is not
212
+ * scroll-position-aware (no `scroll` listener, no "am I at the end"
213
+ * suppression). It backs the data-grid `--_cinder-data-grid-overflow-shadow`
214
+ * inset-shadow affordance (see `data-grid.css`), which paints BOTH edges
215
+ * whenever content overflows, regardless of current scroll position — the
216
+ * inset shadow is decoration on the scroll container's own (non-scrolling)
217
+ * box, so it stays pinned at the true edges as content scrolls underneath.
218
+ *
219
+ * `node`'s own box is observed with `ResizeObserver` (container resize), and
220
+ * content changes are caught by a `MutationObserver` that schedules a
221
+ * re-measure directly — the same lean design as `overflowFade`, see its doc
222
+ * comment for the full rationale.
223
+ */
224
+ export function overflowShadow(axis: OverflowShadowAxis): Attachment<HTMLElement> {
225
+ const attributeName = OVERFLOW_SHADOW_ATTRIBUTE[axis];
226
+
227
+ return (node) => {
228
+ if (typeof ResizeObserver === 'undefined') {
229
+ node.removeAttribute(attributeName);
230
+ return;
231
+ }
232
+
233
+ const update = () => {
234
+ const overflows =
235
+ axis === 'inline'
236
+ ? node.scrollWidth - node.clientWidth > 1
237
+ : node.scrollHeight - node.clientHeight > 1;
238
+ node.toggleAttribute(attributeName, overflows);
239
+ };
240
+
241
+ const requestFrame =
242
+ typeof requestAnimationFrame === 'function'
243
+ ? requestAnimationFrame
244
+ : (callback: FrameRequestCallback) => window.setTimeout(() => callback(performance.now()));
245
+ const cancelFrame =
246
+ typeof cancelAnimationFrame === 'function'
247
+ ? cancelAnimationFrame
248
+ : (handle: number) => window.clearTimeout(handle);
249
+
250
+ let frame = 0;
251
+ const scheduleUpdate = () => {
252
+ if (frame) return;
253
+ frame = requestFrame(() => {
254
+ frame = 0;
255
+ update();
256
+ });
167
257
  };
168
258
 
169
- syncObservedElements();
259
+ const resizeObserver = new ResizeObserver(scheduleUpdate);
260
+ resizeObserver.observe(node);
261
+
262
+ const mutationObserver =
263
+ typeof MutationObserver === 'undefined' ? null : new MutationObserver(scheduleUpdate);
264
+
265
+ mutationObserver?.observe(node, {
266
+ childList: true,
267
+ subtree: true,
268
+ characterData: true,
269
+ attributes: true,
270
+ attributeFilter: ['hidden', 'class', 'style', 'aria-hidden', 'src'],
271
+ });
272
+
273
+ update();
274
+
275
+ return () => {
276
+ if (frame) cancelFrame(frame);
277
+ resizeObserver.disconnect();
278
+ mutationObserver?.disconnect();
279
+ };
280
+ };
281
+ }
282
+
283
+ /** Which scroll axis {@link overflowFadeEdges} measures and reports. */
284
+ export type OverflowFadeEdgesAxis = 'block' | 'inline';
285
+
286
+ const OVERFLOW_FADE_START_ATTRIBUTE: Record<OverflowFadeEdgesAxis, string> = {
287
+ block: 'data-cinder-overflows-start',
288
+ inline: 'data-cinder-overflows-inline-start',
289
+ };
290
+ const OVERFLOW_FADE_END_ATTRIBUTE: Record<OverflowFadeEdgesAxis, string> = {
291
+ block: 'data-cinder-overflows',
292
+ inline: 'data-cinder-overflows-inline-end',
293
+ };
294
+
295
+ /**
296
+ * Marks a scroll container that has more content on EITHER side of the given
297
+ * axis — the fallback driver for a both-edges `_scroll-fade.css` recipe
298
+ * (`.cinder-_scroll-fade` + `.cinder-_scroll-fade-start` for block, or the
299
+ * `-inline-start`/`-inline-end` pair for inline). Unlike {@link overflowFade}
300
+ * (single, block-end-only edge), this reports each edge independently based
301
+ * on real scroll position: the start edge fades in once scrolled away from
302
+ * the very start, and the end edge fades out once scrolled to the very end —
303
+ * so a container that is fully scrolled to one edge never shows a fade
304
+ * toward content that is not there.
305
+ *
306
+ * Shares the same lean container-ResizeObserver + content-MutationObserver +
307
+ * passive-scroll-listener design as {@link overflowFade}; see its doc
308
+ * comment for the full perf rationale.
309
+ */
310
+ export function overflowFadeEdges(axis: OverflowFadeEdgesAxis): Attachment<HTMLElement> {
311
+ const startAttribute = OVERFLOW_FADE_START_ATTRIBUTE[axis];
312
+ const endAttribute = OVERFLOW_FADE_END_ATTRIBUTE[axis];
313
+
314
+ return (node) => {
315
+ if (typeof ResizeObserver === 'undefined') {
316
+ node.removeAttribute(startAttribute);
317
+ node.removeAttribute(endAttribute);
318
+ return;
319
+ }
320
+
321
+ const update = () => {
322
+ const scrollPosition = axis === 'block' ? node.scrollTop : node.scrollLeft;
323
+ const contentExtent = axis === 'block' ? node.scrollHeight : node.scrollWidth;
324
+ const viewportExtent = axis === 'block' ? node.clientHeight : node.clientWidth;
325
+ const overflows = contentExtent - viewportExtent > 1;
326
+ const atStart = scrollPosition <= 1;
327
+ const atEnd = scrollPosition + viewportExtent >= contentExtent - 1;
328
+ node.toggleAttribute(startAttribute, overflows && !atStart);
329
+ node.toggleAttribute(endAttribute, overflows && !atEnd);
330
+ };
331
+
332
+ const requestFrame =
333
+ typeof requestAnimationFrame === 'function'
334
+ ? requestAnimationFrame
335
+ : (callback: FrameRequestCallback) => window.setTimeout(() => callback(performance.now()));
336
+ const cancelFrame =
337
+ typeof cancelAnimationFrame === 'function'
338
+ ? cancelAnimationFrame
339
+ : (handle: number) => window.clearTimeout(handle);
340
+
341
+ let frame = 0;
342
+ const scheduleUpdate = () => {
343
+ if (frame) return;
344
+ frame = requestFrame(() => {
345
+ frame = 0;
346
+ update();
347
+ });
348
+ };
349
+
350
+ const resizeObserver = new ResizeObserver(scheduleUpdate);
351
+ resizeObserver.observe(node);
170
352
 
171
353
  const mutationObserver =
172
- typeof MutationObserver === 'undefined'
173
- ? null
174
- : new MutationObserver(() => {
175
- syncObservedElements();
176
- scheduleUpdate();
177
- });
354
+ typeof MutationObserver === 'undefined' ? null : new MutationObserver(scheduleUpdate);
178
355
 
179
356
  mutationObserver?.observe(node, {
180
357
  childList: true,
181
358
  subtree: true,
182
359
  characterData: true,
183
360
  attributes: true,
184
- attributeFilter: ['hidden', 'class', 'style', 'aria-hidden'],
361
+ attributeFilter: ['hidden', 'class', 'style', 'aria-hidden', 'src'],
185
362
  });
186
363
 
187
364
  node.addEventListener('scroll', scheduleUpdate, { passive: true });
@@ -190,7 +367,6 @@ export function overflowFade(): Attachment<HTMLElement> {
190
367
  return () => {
191
368
  if (frame) cancelFrame(frame);
192
369
  resizeObserver.disconnect();
193
- observedElements.clear();
194
370
  mutationObserver?.disconnect();
195
371
  node.removeEventListener('scroll', scheduleUpdate);
196
372
  };
@@ -0,0 +1,82 @@
1
+ /**
2
+ * Pure inertia/snap math for pointer-drag scrolling (Carousel, ScrollArea).
3
+ * No DOM access — see `use-drag-scroll.svelte.ts` for the attachment that
4
+ * drives a real scroll position with these functions.
5
+ */
6
+
7
+ /** Per-frame velocity decay factor for released momentum. Closer to 1 coasts longer. */
8
+ export const DRAG_FRICTION = 0.95;
9
+ /**
10
+ * Damping constant (per second) for smoothing the virtual scroll position
11
+ * toward its target. High enough that the visible position tracks the
12
+ * target closely every frame — this is a responsive follow, not an easing
13
+ * animation; `DRAG_FRICTION` alone supplies the coast/glide feel.
14
+ */
15
+ export const DRAG_DAMPING = 20;
16
+ /** Below this per-frame speed, released momentum reads as fully stopped. */
17
+ export const DRAG_SETTLE_VELOCITY_EPSILON = 0.01;
18
+
19
+ /**
20
+ * Exponentially smooths `current` toward `target`, scaled by elapsed time so
21
+ * the motion is frame-rate independent.
22
+ */
23
+ export function damp(
24
+ current: number,
25
+ target: number,
26
+ dampingConstant: number,
27
+ deltaTimeMs: number,
28
+ ): number {
29
+ if (dampingConstant <= 0 || deltaTimeMs <= 0) return current;
30
+ const t = 1 - Math.exp(-dampingConstant * (deltaTimeMs / 1000));
31
+ return current + (target - current) * t;
32
+ }
33
+
34
+ /**
35
+ * Predicts the resting position of an object at `current` moving at
36
+ * `velocity`, decaying geometrically at `friction` per frame. `friction`
37
+ * must be in `[0, 1)` — outside that range the projection cannot converge,
38
+ * so `current` is returned unchanged.
39
+ */
40
+ export function project(current: number, velocity: number, friction: number): number {
41
+ if (friction <= 0 || friction >= 1) return current;
42
+ return current + (velocity * friction) / (1 - friction);
43
+ }
44
+
45
+ /**
46
+ * The inverse of `project`: the initial velocity needed for a `friction`-decaying
47
+ * trajectory to travel exactly `distance` before coming to rest. Used to snap a
48
+ * released drag onto a specific point by feeding the result back through the
49
+ * same damping physics that already governs the coast.
50
+ */
51
+ export function dragSnap(distance: number, friction: number): number {
52
+ if (friction <= 0 || friction >= 1) return 0;
53
+ return (distance * (1 - friction)) / friction;
54
+ }
55
+
56
+ /**
57
+ * Picks the snap position nearest `position` from `snapPositions`. Returns
58
+ * `null` when `snapPositions` is empty.
59
+ */
60
+ export function snapSelect(position: number, snapPositions: readonly number[]): number | null {
61
+ return snapPositions.reduce<number | null>((nearest, candidate) => {
62
+ if (nearest === null) return candidate;
63
+ return Math.abs(candidate - position) < Math.abs(nearest - position) ? candidate : nearest;
64
+ }, null);
65
+ }
66
+
67
+ /**
68
+ * Whether a release at `distance` from the nearest snap point should snap at
69
+ * all. `'mandatory'` always snaps (matches CSS `scroll-snap-type: x mandatory`,
70
+ * the default everywhere this engine attaches). `'proximity'` only snaps
71
+ * within a third of the snapport — far enough from a snap point reads as an
72
+ * intentional stop between slides, not toward one.
73
+ */
74
+ export function shouldSnap(
75
+ distance: number,
76
+ snapportSize: number,
77
+ mode: 'mandatory' | 'proximity' = 'mandatory',
78
+ ): boolean {
79
+ if (mode === 'mandatory') return true;
80
+ if (snapportSize <= 0) return false;
81
+ return Math.abs(distance) <= snapportSize / 3;
82
+ }
@@ -0,0 +1,186 @@
1
+ import { DRAG_DAMPING, DRAG_FRICTION, DRAG_SETTLE_VELOCITY_EPSILON, damp, dragSnap, project, shouldSnap, snapSelect, } from './drag-scroll-physics.ts';
2
+ const DRAG_THRESHOLD_PX = 10;
3
+ /**
4
+ * Fine-pointer (mouse) drag-to-scroll for a native scroll container along a
5
+ * single axis, in the house attachment style of `useResizeObserver`:
6
+ * `(node) => cleanup`. Owns pointer capture, a rAF-driven momentum ticker,
7
+ * and the `scroll-snap-type` swap that lets the physics run without the
8
+ * browser's native snapping fighting it.
9
+ *
10
+ * Touch and pen are untouched — they already pan the native scroller, and
11
+ * layering this engine under them would double-handle the gesture; a
12
+ * hardware-level `pointerType === 'mouse'` check enforces that. The `enabled`
13
+ * option is the caller's responsibility for everything else this shouldn't
14
+ * run under — a `(hover: hover) and (pointer: fine)` `MediaQuery` (never a
15
+ * bare `matchMedia` call) and `!prefersReducedMotion`, since momentum and
16
+ * rubber-band are exactly the inertial motion that preference is about.
17
+ *
18
+ * Snap points are supplied by the caller (`getSnapPositions`) rather than
19
+ * inferred from DOM shape, so this stays reusable across consumers with
20
+ * different child structures (Carousel's slides, ScrollArea's arbitrary
21
+ * content). Omit it for a non-snapping scroller — momentum still applies,
22
+ * it just coasts to a natural stop instead of snapping.
23
+ */
24
+ export function useDragScroll(options = {}) {
25
+ const { enabled = () => true, snapMode = 'mandatory', axis = 'x', onSettle, getSnapPositions, } = options;
26
+ const scrollProperty = axis === 'x' ? 'scrollLeft' : 'scrollTop';
27
+ const clientSizeProperty = axis === 'x' ? 'clientWidth' : 'clientHeight';
28
+ const clientAxisProperty = axis === 'x' ? 'clientX' : 'clientY';
29
+ const movementAxisProperty = axis === 'x' ? 'movementX' : 'movementY';
30
+ return (node) => {
31
+ let pointerId = null;
32
+ let startClientPosition = 0;
33
+ let target = 0;
34
+ let virtualScroll = 0;
35
+ let velocity = 0;
36
+ let dragged = false;
37
+ let rafId = null;
38
+ let lastFrameTime = 0;
39
+ let originalSnapType = '';
40
+ let dragSuppressTimer = null;
41
+ function tick(now) {
42
+ const frameDeltaMs = lastFrameTime === 0 ? 16 : now - lastFrameTime;
43
+ lastFrameTime = now;
44
+ if (pointerId === null) {
45
+ // Released: friction decays velocity toward zero each frame.
46
+ velocity *= DRAG_FRICTION;
47
+ target += velocity;
48
+ }
49
+ virtualScroll = damp(virtualScroll, target, DRAG_DAMPING, frameDeltaMs);
50
+ // Direct property assignment is always an immediate jump, unlike
51
+ // `scrollTo({ behavior })` — `'smooth'` is the only standardized
52
+ // non-default value, so there's no portable way to *force* instant via
53
+ // the options object across browsers.
54
+ node[scrollProperty] = virtualScroll;
55
+ const settled = pointerId === null && Math.abs(velocity) < DRAG_SETTLE_VELOCITY_EPSILON;
56
+ if (settled) {
57
+ rafId = null;
58
+ lastFrameTime = 0;
59
+ node.removeAttribute('data-cinder-dragging');
60
+ restoreSnapType();
61
+ onSettle?.();
62
+ return;
63
+ }
64
+ rafId = requestAnimationFrame(tick);
65
+ }
66
+ function startTicker() {
67
+ if (rafId !== null)
68
+ return;
69
+ lastFrameTime = 0;
70
+ rafId = requestAnimationFrame(tick);
71
+ }
72
+ function stopTicker() {
73
+ if (rafId !== null)
74
+ cancelAnimationFrame(rafId);
75
+ rafId = null;
76
+ lastFrameTime = 0;
77
+ }
78
+ function suppressSnapType() {
79
+ originalSnapType = node.style.scrollSnapType;
80
+ node.style.scrollSnapType = 'none';
81
+ }
82
+ function restoreSnapType() {
83
+ node.style.scrollSnapType = originalSnapType;
84
+ }
85
+ function suppressNextClick() {
86
+ node.setAttribute('data-cinder-dragged', '');
87
+ // Cleared on the next macrotask, after the resulting `click` — capture-phase
88
+ // listener below reads the attribute synchronously during that event.
89
+ if (dragSuppressTimer !== null)
90
+ clearTimeout(dragSuppressTimer);
91
+ dragSuppressTimer = setTimeout(() => {
92
+ dragSuppressTimer = null;
93
+ node.removeAttribute('data-cinder-dragged');
94
+ }, 0);
95
+ }
96
+ function onClickCapture(event) {
97
+ if (node.hasAttribute('data-cinder-dragged')) {
98
+ event.preventDefault();
99
+ event.stopPropagation();
100
+ }
101
+ }
102
+ function onPointerMove(event) {
103
+ if (event.pointerId !== pointerId)
104
+ return;
105
+ const clientPosition = event[clientAxisProperty];
106
+ const dragDistance = clientPosition - startClientPosition;
107
+ if (!dragged && Math.abs(dragDistance) > DRAG_THRESHOLD_PX) {
108
+ dragged = true;
109
+ node.setAttribute('data-cinder-dragging', '');
110
+ }
111
+ if (!dragged)
112
+ return;
113
+ // Dragging the pointer forward reveals content behind it — the scroll
114
+ // position decreases as the finger/cursor moves in the positive direction.
115
+ const scrollDelta = -event[movementAxisProperty];
116
+ target += scrollDelta;
117
+ velocity += scrollDelta;
118
+ }
119
+ function onPointerUp(event) {
120
+ if (event.pointerId !== pointerId)
121
+ return;
122
+ window.removeEventListener('pointermove', onPointerMove);
123
+ window.removeEventListener('pointerup', onPointerUp);
124
+ window.removeEventListener('pointercancel', onPointerUp);
125
+ if ('releasePointerCapture' in node && node.hasPointerCapture(event.pointerId)) {
126
+ node.releasePointerCapture(event.pointerId);
127
+ }
128
+ pointerId = null;
129
+ if (!dragged) {
130
+ stopTicker();
131
+ node.removeAttribute('data-cinder-dragging');
132
+ restoreSnapType();
133
+ return;
134
+ }
135
+ suppressNextClick();
136
+ const snapPositions = getSnapPositions?.();
137
+ if (snapPositions && snapPositions.length > 0) {
138
+ const projected = project(target, velocity, DRAG_FRICTION);
139
+ const snapTarget = snapSelect(projected, snapPositions);
140
+ if (snapTarget !== null &&
141
+ shouldSnap(snapTarget - projected, node[clientSizeProperty], snapMode)) {
142
+ // `target` stays where it is — the ticker below applies `velocity`
143
+ // to it every frame, and `dragSnap` sizes that velocity so those
144
+ // frame-by-frame additions sum to exactly `snapTarget - target`.
145
+ // Jumping `target` to `snapTarget` directly here would double the
146
+ // distance: the ticker would then add the same span again on top.
147
+ velocity = dragSnap(snapTarget - target, DRAG_FRICTION);
148
+ }
149
+ }
150
+ // The ticker (already running) carries the release through to settle,
151
+ // snapped or not.
152
+ }
153
+ function onPointerDown(event) {
154
+ if (event.pointerType !== 'mouse')
155
+ return;
156
+ if (!enabled())
157
+ return;
158
+ pointerId = event.pointerId;
159
+ startClientPosition = event[clientAxisProperty];
160
+ const startScroll = node[scrollProperty];
161
+ target = startScroll;
162
+ virtualScroll = startScroll;
163
+ velocity = 0;
164
+ dragged = false;
165
+ suppressSnapType();
166
+ if ('setPointerCapture' in node)
167
+ node.setPointerCapture(event.pointerId);
168
+ window.addEventListener('pointermove', onPointerMove);
169
+ window.addEventListener('pointerup', onPointerUp);
170
+ window.addEventListener('pointercancel', onPointerUp);
171
+ startTicker();
172
+ }
173
+ node.addEventListener('pointerdown', onPointerDown);
174
+ node.addEventListener('click', onClickCapture, { capture: true });
175
+ return () => {
176
+ node.removeEventListener('pointerdown', onPointerDown);
177
+ node.removeEventListener('click', onClickCapture, { capture: true });
178
+ window.removeEventListener('pointermove', onPointerMove);
179
+ window.removeEventListener('pointerup', onPointerUp);
180
+ window.removeEventListener('pointercancel', onPointerUp);
181
+ stopTicker();
182
+ if (dragSuppressTimer !== null)
183
+ clearTimeout(dragSuppressTimer);
184
+ };
185
+ };
186
+ }
@@ -0,0 +1,17 @@
1
+ import type { Attachment } from 'svelte/attachments';
2
+
3
+ export type UseDragScrollOptions = {
4
+ /**
5
+ * Getter for whether the drag engine may attach. Defaults to `() => true`.
6
+ * Callers gate this on a fine-pointer media query and
7
+ * `prefers-reduced-motion` — momentum and rubber-band are exactly the
8
+ * inertial motion that preference is about.
9
+ */
10
+ enabled?: () => boolean;
11
+ /** `'mandatory'` (default) always snaps on release; `'proximity'` only within a third of the snapport. */
12
+ snapMode?: 'mandatory' | 'proximity';
13
+ /** Called once the virtual scroll position settles after a released drag. */
14
+ onSettle?: () => void;
15
+ };
16
+
17
+ export type DragScrollAttachment = Attachment<HTMLElement>;
@@ -0,0 +1,23 @@
1
+ import { MediaQuery } from 'svelte/reactivity';
2
+ /**
3
+ * Reactive `(hover: hover) and (pointer: fine)` watcher backed by Svelte's
4
+ * `MediaQuery` — never a bare `matchMedia` call (`check-no-inline-match-media.ts`).
5
+ * `true` when the primary input is a mouse with hover support, so a fine-pointer
6
+ * enhancement (e.g. `useDragScroll`) may attach. Touch and pen devices, and any
7
+ * device without hover, read `false` — they already pan native scrollers directly.
8
+ *
9
+ * SSR-safe: on the server, `svelte/reactivity` resolves to a stub that returns
10
+ * `false`. As a defensive backstop for a client build loaded without a DOM, this
11
+ * also returns `false` when `window.matchMedia` is unavailable.
12
+ */
13
+ export function useFinePointer() {
14
+ if (typeof window === 'undefined' || typeof window.matchMedia !== 'function') {
15
+ return { current: false };
16
+ }
17
+ const query = new MediaQuery('(hover: hover) and (pointer: fine)', false);
18
+ return {
19
+ get current() {
20
+ return query.current;
21
+ },
22
+ };
23
+ }
@@ -0,0 +1,4 @@
1
+ export type UseFinePointer = {
2
+ /** Reactive boolean — `true` when the primary pointer is a mouse with hover support. */
3
+ readonly current: boolean;
4
+ };