@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
@@ -56,15 +56,498 @@ import"@lostgradient/cinder/scroll-area/styles";
56
56
 
57
57
  // src/components/scroll-area/scroll-area.svelte
58
58
  import"svelte/internal/disclose-version";
59
- import * as $ from "svelte/internal/client";
59
+ import * as $4 from "svelte/internal/client";
60
+
61
+ // src/_internal/overlay.ts
62
+ var escapeStack = [];
63
+ function pushEscapeHandler(handler) {
64
+ escapeStack.push(handler);
65
+ if (escapeStack.length === 1 && typeof window !== "undefined") {
66
+ window.addEventListener("keydown", onEscapeKeydown, { capture: true });
67
+ }
68
+ let released = false;
69
+ return () => {
70
+ if (released)
71
+ return;
72
+ released = true;
73
+ const index = escapeStack.lastIndexOf(handler);
74
+ if (index !== -1)
75
+ escapeStack.splice(index, 1);
76
+ if (escapeStack.length === 0 && typeof window !== "undefined") {
77
+ window.removeEventListener("keydown", onEscapeKeydown, { capture: true });
78
+ }
79
+ };
80
+ }
81
+ function onEscapeKeydown(event) {
82
+ if (event.key !== "Escape")
83
+ return;
84
+ const handler = escapeStack.at(-1);
85
+ if (!handler)
86
+ return;
87
+ handler(event);
88
+ }
89
+ var scrollLockCount = 0;
90
+ var originalBodyOverflow = null;
91
+ function lockBodyScroll() {
92
+ if (typeof document === "undefined")
93
+ return () => {};
94
+ if (scrollLockCount === 0) {
95
+ originalBodyOverflow = document.body.style.overflow;
96
+ document.body.style.overflow = "hidden";
97
+ }
98
+ scrollLockCount += 1;
99
+ let released = false;
100
+ return () => {
101
+ if (released)
102
+ return;
103
+ released = true;
104
+ scrollLockCount = Math.max(0, scrollLockCount - 1);
105
+ if (scrollLockCount === 0) {
106
+ document.body.style.overflow = originalBodyOverflow ?? "";
107
+ originalBodyOverflow = null;
108
+ }
109
+ };
110
+ }
111
+ function captureFocus() {
112
+ if (typeof document === "undefined")
113
+ return null;
114
+ const active = document.activeElement;
115
+ if (active && active !== document.body && active instanceof HTMLElement) {
116
+ return active;
117
+ }
118
+ return null;
119
+ }
120
+
121
+ // src/utilities/attachments.ts
122
+ function createBodyScrollLock() {
123
+ return () => {
124
+ const release = lockBodyScroll();
125
+ return release;
126
+ };
127
+ }
128
+ function isInsideEventPath(event, element) {
129
+ const path = event.composedPath();
130
+ return path.some((entry) => entry instanceof Node && element.contains(entry));
131
+ }
132
+ function createClickOutside(options) {
133
+ const { handler, enabled = true, eventType = "click", capture = true, ignoreRefs } = options;
134
+ return (node) => {
135
+ function handleEvent(event) {
136
+ const isEnabled = typeof enabled === "function" ? enabled() : enabled;
137
+ if (!isEnabled)
138
+ return;
139
+ if (event.type === "touchstart" && !event.cancelable)
140
+ return;
141
+ const target = event.target;
142
+ if (!(target instanceof Node)) {
143
+ handler();
144
+ return;
145
+ }
146
+ if (isInsideEventPath(event, node))
147
+ return;
148
+ if (ignoreRefs) {
149
+ for (const ref of ignoreRefs) {
150
+ const element = ref();
151
+ if (element && isInsideEventPath(event, element))
152
+ return;
153
+ }
154
+ }
155
+ handler();
156
+ }
157
+ document.addEventListener(eventType, handleEvent, capture);
158
+ return () => {
159
+ document.removeEventListener(eventType, handleEvent, capture);
160
+ };
161
+ };
162
+ }
163
+ function overflowFade() {
164
+ return (node) => {
165
+ if (typeof ResizeObserver === "undefined") {
166
+ node.removeAttribute("data-cinder-overflows");
167
+ return;
168
+ }
169
+ const update = () => {
170
+ const overflows = node.scrollHeight - node.clientHeight > 1;
171
+ const atBottom = node.scrollTop + node.clientHeight >= node.scrollHeight - 1;
172
+ node.toggleAttribute("data-cinder-overflows", overflows && !atBottom);
173
+ };
174
+ const requestFrame = typeof requestAnimationFrame === "function" ? requestAnimationFrame : (callback) => window.setTimeout(() => callback(performance.now()));
175
+ const cancelFrame = typeof cancelAnimationFrame === "function" ? cancelAnimationFrame : (handle) => window.clearTimeout(handle);
176
+ let frame = 0;
177
+ const scheduleUpdate = () => {
178
+ if (frame)
179
+ return;
180
+ frame = requestFrame(() => {
181
+ frame = 0;
182
+ update();
183
+ });
184
+ };
185
+ const resizeObserver = new ResizeObserver(scheduleUpdate);
186
+ resizeObserver.observe(node);
187
+ const mutationObserver = typeof MutationObserver === "undefined" ? null : new MutationObserver(scheduleUpdate);
188
+ mutationObserver?.observe(node, {
189
+ childList: true,
190
+ subtree: true,
191
+ characterData: true,
192
+ attributes: true,
193
+ attributeFilter: ["hidden", "class", "style", "aria-hidden", "src"]
194
+ });
195
+ node.addEventListener("scroll", scheduleUpdate, { passive: true });
196
+ update();
197
+ return () => {
198
+ if (frame)
199
+ cancelFrame(frame);
200
+ resizeObserver.disconnect();
201
+ mutationObserver?.disconnect();
202
+ node.removeEventListener("scroll", scheduleUpdate);
203
+ };
204
+ };
205
+ }
206
+ var OVERFLOW_SHADOW_ATTRIBUTE = {
207
+ inline: "data-cinder-overflows-inline",
208
+ block: "data-cinder-overflows-block"
209
+ };
210
+ function overflowShadow(axis) {
211
+ const attributeName = OVERFLOW_SHADOW_ATTRIBUTE[axis];
212
+ return (node) => {
213
+ if (typeof ResizeObserver === "undefined") {
214
+ node.removeAttribute(attributeName);
215
+ return;
216
+ }
217
+ const update = () => {
218
+ const overflows = axis === "inline" ? node.scrollWidth - node.clientWidth > 1 : node.scrollHeight - node.clientHeight > 1;
219
+ node.toggleAttribute(attributeName, overflows);
220
+ };
221
+ const requestFrame = typeof requestAnimationFrame === "function" ? requestAnimationFrame : (callback) => window.setTimeout(() => callback(performance.now()));
222
+ const cancelFrame = typeof cancelAnimationFrame === "function" ? cancelAnimationFrame : (handle) => window.clearTimeout(handle);
223
+ let frame = 0;
224
+ const scheduleUpdate = () => {
225
+ if (frame)
226
+ return;
227
+ frame = requestFrame(() => {
228
+ frame = 0;
229
+ update();
230
+ });
231
+ };
232
+ const resizeObserver = new ResizeObserver(scheduleUpdate);
233
+ resizeObserver.observe(node);
234
+ const mutationObserver = typeof MutationObserver === "undefined" ? null : new MutationObserver(scheduleUpdate);
235
+ mutationObserver?.observe(node, {
236
+ childList: true,
237
+ subtree: true,
238
+ characterData: true,
239
+ attributes: true,
240
+ attributeFilter: ["hidden", "class", "style", "aria-hidden", "src"]
241
+ });
242
+ update();
243
+ return () => {
244
+ if (frame)
245
+ cancelFrame(frame);
246
+ resizeObserver.disconnect();
247
+ mutationObserver?.disconnect();
248
+ };
249
+ };
250
+ }
251
+ var OVERFLOW_FADE_START_ATTRIBUTE = {
252
+ block: "data-cinder-overflows-start",
253
+ inline: "data-cinder-overflows-inline-start"
254
+ };
255
+ var OVERFLOW_FADE_END_ATTRIBUTE = {
256
+ block: "data-cinder-overflows",
257
+ inline: "data-cinder-overflows-inline-end"
258
+ };
259
+ function overflowFadeEdges(axis) {
260
+ const startAttribute = OVERFLOW_FADE_START_ATTRIBUTE[axis];
261
+ const endAttribute = OVERFLOW_FADE_END_ATTRIBUTE[axis];
262
+ return (node) => {
263
+ if (typeof ResizeObserver === "undefined") {
264
+ node.removeAttribute(startAttribute);
265
+ node.removeAttribute(endAttribute);
266
+ return;
267
+ }
268
+ const update = () => {
269
+ const scrollPosition = axis === "block" ? node.scrollTop : node.scrollLeft;
270
+ const contentExtent = axis === "block" ? node.scrollHeight : node.scrollWidth;
271
+ const viewportExtent = axis === "block" ? node.clientHeight : node.clientWidth;
272
+ const overflows = contentExtent - viewportExtent > 1;
273
+ const atStart = scrollPosition <= 1;
274
+ const atEnd = scrollPosition + viewportExtent >= contentExtent - 1;
275
+ node.toggleAttribute(startAttribute, overflows && !atStart);
276
+ node.toggleAttribute(endAttribute, overflows && !atEnd);
277
+ };
278
+ const requestFrame = typeof requestAnimationFrame === "function" ? requestAnimationFrame : (callback) => window.setTimeout(() => callback(performance.now()));
279
+ const cancelFrame = typeof cancelAnimationFrame === "function" ? cancelAnimationFrame : (handle) => window.clearTimeout(handle);
280
+ let frame = 0;
281
+ const scheduleUpdate = () => {
282
+ if (frame)
283
+ return;
284
+ frame = requestFrame(() => {
285
+ frame = 0;
286
+ update();
287
+ });
288
+ };
289
+ const resizeObserver = new ResizeObserver(scheduleUpdate);
290
+ resizeObserver.observe(node);
291
+ const mutationObserver = typeof MutationObserver === "undefined" ? null : new MutationObserver(scheduleUpdate);
292
+ mutationObserver?.observe(node, {
293
+ childList: true,
294
+ subtree: true,
295
+ characterData: true,
296
+ attributes: true,
297
+ attributeFilter: ["hidden", "class", "style", "aria-hidden", "src"]
298
+ });
299
+ node.addEventListener("scroll", scheduleUpdate, { passive: true });
300
+ update();
301
+ return () => {
302
+ if (frame)
303
+ cancelFrame(frame);
304
+ resizeObserver.disconnect();
305
+ mutationObserver?.disconnect();
306
+ node.removeEventListener("scroll", scheduleUpdate);
307
+ };
308
+ };
309
+ }
60
310
 
61
311
  // src/utilities/class-names.ts
62
312
  function classNames(...parts) {
63
313
  return parts.filter((part) => typeof part === "string" && part.length > 0).join(" ");
64
314
  }
65
315
 
316
+ // ../../node_modules/esm-env/true.js
317
+ var true_default = true;
318
+ // src/utilities/dev-warn.ts
319
+ function devWarn(message, ...args) {
320
+ if (!true_default)
321
+ return;
322
+ console.warn(message, ...args);
323
+ }
324
+
325
+ // src/utilities/use-drag-scroll.svelte.ts
326
+ import * as $ from "svelte/internal/client";
327
+
328
+ // src/utilities/drag-scroll-physics.ts
329
+ var DRAG_FRICTION = 0.95;
330
+ var DRAG_DAMPING = 20;
331
+ var DRAG_SETTLE_VELOCITY_EPSILON = 0.01;
332
+ function damp(current, target, dampingConstant, deltaTimeMs) {
333
+ if (dampingConstant <= 0 || deltaTimeMs <= 0)
334
+ return current;
335
+ const t = 1 - Math.exp(-dampingConstant * (deltaTimeMs / 1000));
336
+ return current + (target - current) * t;
337
+ }
338
+ function project(current, velocity, friction) {
339
+ if (friction <= 0 || friction >= 1)
340
+ return current;
341
+ return current + velocity * friction / (1 - friction);
342
+ }
343
+ function dragSnap(distance, friction) {
344
+ if (friction <= 0 || friction >= 1)
345
+ return 0;
346
+ return distance * (1 - friction) / friction;
347
+ }
348
+ function snapSelect(position, snapPositions) {
349
+ return snapPositions.reduce((nearest, candidate) => {
350
+ if (nearest === null)
351
+ return candidate;
352
+ return Math.abs(candidate - position) < Math.abs(nearest - position) ? candidate : nearest;
353
+ }, null);
354
+ }
355
+ function shouldSnap(distance, snapportSize, mode = "mandatory") {
356
+ if (mode === "mandatory")
357
+ return true;
358
+ if (snapportSize <= 0)
359
+ return false;
360
+ return Math.abs(distance) <= snapportSize / 3;
361
+ }
362
+
363
+ // src/utilities/use-drag-scroll.svelte.ts
364
+ var DRAG_THRESHOLD_PX = 10;
365
+ function useDragScroll(options = {}) {
366
+ const {
367
+ enabled = () => true,
368
+ snapMode = "mandatory",
369
+ axis = "x",
370
+ onSettle,
371
+ getSnapPositions
372
+ } = options;
373
+ const scrollProperty = axis === "x" ? "scrollLeft" : "scrollTop";
374
+ const clientSizeProperty = axis === "x" ? "clientWidth" : "clientHeight";
375
+ const clientAxisProperty = axis === "x" ? "clientX" : "clientY";
376
+ const movementAxisProperty = axis === "x" ? "movementX" : "movementY";
377
+ return (node) => {
378
+ let pointerId = null;
379
+ let startClientPosition = 0;
380
+ let target = 0;
381
+ let virtualScroll = 0;
382
+ let velocity = 0;
383
+ let dragged = false;
384
+ let rafId = null;
385
+ let lastFrameTime = 0;
386
+ let originalSnapType = "";
387
+ let dragSuppressTimer = null;
388
+ function tick(now) {
389
+ const frameDeltaMs = lastFrameTime === 0 ? 16 : now - lastFrameTime;
390
+ lastFrameTime = now;
391
+ if (pointerId === null) {
392
+ velocity *= DRAG_FRICTION;
393
+ target += velocity;
394
+ }
395
+ virtualScroll = damp(virtualScroll, target, DRAG_DAMPING, frameDeltaMs);
396
+ node[scrollProperty] = virtualScroll;
397
+ const settled = pointerId === null && Math.abs(velocity) < DRAG_SETTLE_VELOCITY_EPSILON;
398
+ if (settled) {
399
+ rafId = null;
400
+ lastFrameTime = 0;
401
+ node.removeAttribute("data-cinder-dragging");
402
+ restoreSnapType();
403
+ onSettle?.();
404
+ return;
405
+ }
406
+ rafId = requestAnimationFrame(tick);
407
+ }
408
+ function startTicker() {
409
+ if (rafId !== null)
410
+ return;
411
+ lastFrameTime = 0;
412
+ rafId = requestAnimationFrame(tick);
413
+ }
414
+ function stopTicker() {
415
+ if (rafId !== null)
416
+ cancelAnimationFrame(rafId);
417
+ rafId = null;
418
+ lastFrameTime = 0;
419
+ }
420
+ function suppressSnapType() {
421
+ originalSnapType = node.style.scrollSnapType;
422
+ node.style.scrollSnapType = "none";
423
+ }
424
+ function restoreSnapType() {
425
+ node.style.scrollSnapType = originalSnapType;
426
+ }
427
+ function suppressNextClick() {
428
+ node.setAttribute("data-cinder-dragged", "");
429
+ if (dragSuppressTimer !== null)
430
+ clearTimeout(dragSuppressTimer);
431
+ dragSuppressTimer = setTimeout(() => {
432
+ dragSuppressTimer = null;
433
+ node.removeAttribute("data-cinder-dragged");
434
+ }, 0);
435
+ }
436
+ function onClickCapture(event) {
437
+ if (node.hasAttribute("data-cinder-dragged")) {
438
+ event.preventDefault();
439
+ event.stopPropagation();
440
+ }
441
+ }
442
+ function onPointerMove(event) {
443
+ if (event.pointerId !== pointerId)
444
+ return;
445
+ const clientPosition = event[clientAxisProperty];
446
+ const dragDistance = clientPosition - startClientPosition;
447
+ if (!dragged && Math.abs(dragDistance) > DRAG_THRESHOLD_PX) {
448
+ dragged = true;
449
+ node.setAttribute("data-cinder-dragging", "");
450
+ }
451
+ if (!dragged)
452
+ return;
453
+ const scrollDelta = -event[movementAxisProperty];
454
+ target += scrollDelta;
455
+ velocity += scrollDelta;
456
+ }
457
+ function onPointerUp(event) {
458
+ if (event.pointerId !== pointerId)
459
+ return;
460
+ window.removeEventListener("pointermove", onPointerMove);
461
+ window.removeEventListener("pointerup", onPointerUp);
462
+ window.removeEventListener("pointercancel", onPointerUp);
463
+ if ("releasePointerCapture" in node && node.hasPointerCapture(event.pointerId)) {
464
+ node.releasePointerCapture(event.pointerId);
465
+ }
466
+ pointerId = null;
467
+ if (!dragged) {
468
+ stopTicker();
469
+ node.removeAttribute("data-cinder-dragging");
470
+ restoreSnapType();
471
+ return;
472
+ }
473
+ suppressNextClick();
474
+ const snapPositions = getSnapPositions?.();
475
+ if (snapPositions && snapPositions.length > 0) {
476
+ const projected = project(target, velocity, DRAG_FRICTION);
477
+ const snapTarget = snapSelect(projected, snapPositions);
478
+ if (snapTarget !== null && shouldSnap(snapTarget - projected, node[clientSizeProperty], snapMode)) {
479
+ velocity = dragSnap(snapTarget - target, DRAG_FRICTION);
480
+ }
481
+ }
482
+ }
483
+ function onPointerDown(event) {
484
+ if (event.pointerType !== "mouse")
485
+ return;
486
+ if (!enabled())
487
+ return;
488
+ pointerId = event.pointerId;
489
+ startClientPosition = event[clientAxisProperty];
490
+ const startScroll = node[scrollProperty];
491
+ target = startScroll;
492
+ virtualScroll = startScroll;
493
+ velocity = 0;
494
+ dragged = false;
495
+ suppressSnapType();
496
+ if ("setPointerCapture" in node)
497
+ node.setPointerCapture(event.pointerId);
498
+ window.addEventListener("pointermove", onPointerMove);
499
+ window.addEventListener("pointerup", onPointerUp);
500
+ window.addEventListener("pointercancel", onPointerUp);
501
+ startTicker();
502
+ }
503
+ node.addEventListener("pointerdown", onPointerDown);
504
+ node.addEventListener("click", onClickCapture, { capture: true });
505
+ return () => {
506
+ node.removeEventListener("pointerdown", onPointerDown);
507
+ node.removeEventListener("click", onClickCapture, { capture: true });
508
+ window.removeEventListener("pointermove", onPointerMove);
509
+ window.removeEventListener("pointerup", onPointerUp);
510
+ window.removeEventListener("pointercancel", onPointerUp);
511
+ stopTicker();
512
+ if (dragSuppressTimer !== null)
513
+ clearTimeout(dragSuppressTimer);
514
+ };
515
+ };
516
+ }
517
+
518
+ // src/utilities/use-fine-pointer.svelte.ts
519
+ import * as $2 from "svelte/internal/client";
520
+ import { MediaQuery } from "svelte/reactivity";
521
+ function useFinePointer() {
522
+ if (typeof window === "undefined" || typeof window.matchMedia !== "function") {
523
+ return { current: false };
524
+ }
525
+ const query = new MediaQuery("(hover: hover) and (pointer: fine)", false);
526
+ return {
527
+ get current() {
528
+ return query.current;
529
+ }
530
+ };
531
+ }
532
+
533
+ // src/utilities/use-reduced-motion.svelte.ts
534
+ import * as $3 from "svelte/internal/client";
535
+ import { MediaQuery as MediaQuery2 } from "svelte/reactivity";
536
+ function useReducedMotion() {
537
+ if (typeof window === "undefined" || typeof window.matchMedia !== "function") {
538
+ return { current: false };
539
+ }
540
+ const query = new MediaQuery2("(prefers-reduced-motion: reduce)", false);
541
+ return {
542
+ get current() {
543
+ return query.current;
544
+ }
545
+ };
546
+ }
547
+
66
548
  // src/components/scroll-area/scroll-area.svelte
67
549
  var explicitRegionElements = new Set(["div", "pre"]);
550
+ var noopScrollFadeAttachment = () => {};
68
551
  var rest_excludes = new Set([
69
552
  "$$slots",
70
553
  "$$events",
@@ -75,38 +558,59 @@ var rest_excludes = new Set([
75
558
  "label",
76
559
  "tabindex",
77
560
  "as",
561
+ "dragToScroll",
78
562
  "class",
563
+ "scrollFadeVisible",
79
564
  "children"
80
565
  ]);
81
566
  function Scroll_area($$anchor, $$props) {
82
- $.push($$props, true);
83
- let direction = $.prop($$props, "direction", 3, "vertical"), tabindex = $.prop($$props, "tabindex", 3, 0), as = $.prop($$props, "as", 3, "div"), rest = $.rest_props($$props, rest_excludes);
84
- const normalizedAriaLabel = $.derived(() => typeof $$props.label === "string" && $$props.label.trim().length > 0 ? $$props.label.trim() : undefined);
85
- const ariaLabelledby = $.derived(() => rest["aria-labelledby"]);
86
- const hasAccessibleName = $.derived(() => Boolean($.get(normalizedAriaLabel)) || typeof $.get(ariaLabelledby) === "string" && $.get(ariaLabelledby).trim().length > 0);
87
- const role = $.derived(() => $.get(hasAccessibleName) && explicitRegionElements.has(as()) ? "region" : undefined);
88
- var fragment = $.comment();
89
- var node = $.first_child(fragment);
90
- $.element(node, as, false, ($$element, $$anchor2) => {
91
- $.attribute_effect($$element, ($0) => ({
567
+ $4.push($$props, true);
568
+ let direction = $4.prop($$props, "direction", 3, "vertical"), tabindex = $4.prop($$props, "tabindex", 3, 0), as = $4.prop($$props, "as", 3, "div"), dragToScroll = $4.prop($$props, "dragToScroll", 3, false), scrollFadeVisible = $4.prop($$props, "scrollFadeVisible", 3, false), rest = $4.rest_props($$props, rest_excludes);
569
+ const scrollFadeAxis = $4.derived(() => scrollFadeVisible() && direction() === "vertical" ? "block" : scrollFadeVisible() && direction() === "horizontal" ? "inline" : undefined);
570
+ const scrollFadeClass = $4.derived(() => $4.get(scrollFadeAxis) === "block" ? "cinder-_scroll-fade" : $4.get(scrollFadeAxis) === "inline" ? "cinder-_scroll-fade-inline-end" : undefined);
571
+ const scrollFadeAttachment = $4.derived(() => $4.get(scrollFadeAxis) ? overflowFadeEdges($4.get(scrollFadeAxis)) : noopScrollFadeAttachment);
572
+ const finePointer = useFinePointer();
573
+ const reducedMotion = useReducedMotion();
574
+ $4.user_effect(() => {
575
+ if (dragToScroll() && direction() === "both") {
576
+ devWarn('[cinder/ScrollArea] `dragToScroll` is not supported with `direction="both"` yet; it is being ignored.');
577
+ }
578
+ });
579
+ const dragScroll = useDragScroll({
580
+ axis: direction() === "horizontal" ? "x" : "y",
581
+ enabled: () => dragToScroll() && direction() !== "both" && finePointer.current && !reducedMotion.current
582
+ });
583
+ const normalizedAriaLabel = $4.derived(() => typeof $$props.label === "string" && $$props.label.trim().length > 0 ? $$props.label.trim() : undefined);
584
+ const ariaLabelledby = $4.derived(() => rest["aria-labelledby"]);
585
+ const hasAccessibleName = $4.derived(() => Boolean($4.get(normalizedAriaLabel)) || typeof $4.get(ariaLabelledby) === "string" && $4.get(ariaLabelledby).trim().length > 0);
586
+ const role = $4.derived(() => $4.get(hasAccessibleName) && explicitRegionElements.has(as()) ? "region" : undefined);
587
+ var fragment = $4.comment();
588
+ var node = $4.first_child(fragment);
589
+ $4.element(node, as, false, ($$element, $$anchor2) => {
590
+ $4.attach($$element, () => $4.get(scrollFadeAttachment));
591
+ $4.attach($$element, () => dragScroll);
592
+ $4.attribute_effect($$element, ($0) => ({
92
593
  ...rest,
93
594
  class: $0,
94
595
  "data-cinder-direction": direction(),
95
- role: $.get(role),
96
- "aria-label": $.get(normalizedAriaLabel),
596
+ "data-cinder-drag-to-scroll": dragToScroll() && direction() !== "both" ? "" : undefined,
597
+ role: $4.get(role),
598
+ "aria-label": $4.get(normalizedAriaLabel),
97
599
  tabindex: tabindex(),
98
- [$.STYLE]: {
600
+ [$4.STYLE]: {
99
601
  "max-block-size": $$props.maxHeight,
100
602
  "max-inline-size": $$props.maxWidth
101
603
  }
102
- }), [() => classNames("cinder-scroll-area", $$props.class)]);
103
- var fragment_1 = $.comment();
104
- var node_1 = $.first_child(fragment_1);
105
- $.snippet(node_1, () => $$props.children);
106
- $.append($$anchor2, fragment_1);
604
+ }), [
605
+ () => classNames("cinder-scroll-area", $4.get(scrollFadeClass), $$props.class)
606
+ ]);
607
+ var fragment_1 = $4.comment();
608
+ var node_1 = $4.first_child(fragment_1);
609
+ $4.snippet(node_1, () => $$props.children);
610
+ $4.append($$anchor2, fragment_1);
107
611
  });
108
- $.append($$anchor, fragment);
109
- $.pop();
612
+ $4.append($$anchor, fragment);
613
+ $4.pop();
110
614
  }
111
615
 
112
616
  // src/components/scroll-area/index.ts
@@ -116,4 +620,4 @@ export {
116
620
  Scroll_area as ScrollArea
117
621
  };
118
622
 
119
- //# debugId=4284A12459693BE664756E2164756E21
623
+ //# debugId=C18ACFA0B40C90C664756E2164756E21
@@ -9,6 +9,17 @@
9
9
  * ======================================== */
10
10
 
11
11
  .cinder-scroll-area {
12
+ /* ScrollArea itself paints no background (the design thesis it shares
13
+ * with a native scrollbar: it never opts the page out of its own
14
+ * surface). `--_cinder-scroll-fade-color` therefore has no real value to
15
+ * inherit from this component and defaults to `--cinder-surface` — the
16
+ * library's most common ambient surface. Consumers placing ScrollArea
17
+ * against a different surface (e.g. inside a `--cinder-surface-raised`
18
+ * card) and using `scrollFadeVisible` should override it inline:
19
+ * `style="--_cinder-scroll-fade-color: var(--cinder-surface-raised)"`,
20
+ * the same documented escape hatch as `--_cinder-modal-close-ring`. */
21
+ --_cinder-scroll-fade-color: var(--cinder-surface);
22
+
12
23
  display: block;
13
24
  min-block-size: 0;
14
25
  min-inline-size: 0;
@@ -36,6 +47,25 @@
36
47
  overflow: auto;
37
48
  }
38
49
 
50
+ .cinder-scroll-area[data-cinder-dragging],
51
+ .cinder-scroll-area[data-cinder-dragging] * {
52
+ user-select: none;
53
+ -webkit-user-drag: none;
54
+ }
55
+
56
+ /* dragToScroll disables itself under prefers-reduced-motion (matches
57
+ useReducedMotion() in the Svelte module) — the grab/grabbing affordance
58
+ must not promise drag behavior it won't deliver. */
59
+ @media (hover: hover) and (pointer: fine) and (prefers-reduced-motion: no-preference) {
60
+ .cinder-scroll-area[data-cinder-drag-to-scroll] {
61
+ cursor: grab;
62
+ }
63
+
64
+ .cinder-scroll-area[data-cinder-dragging] {
65
+ cursor: grabbing;
66
+ }
67
+ }
68
+
39
69
  /* Chromium / Safari scrollbar theming. */
40
70
  .cinder-scroll-area::-webkit-scrollbar {
41
71
  inline-size: var(--cinder-scrollbar-size);
@@ -87,6 +87,14 @@ attribute so the landmark role and label stay coupled.`
87
87
  enum: ["article", "aside", "div", "li", "main", "nav", "ol", "pre", "section", "ul"],
88
88
  description: "Element tag to render. Defaults to `'div'`."
89
89
  },
90
+ scrollFadeVisible: {
91
+ type: "boolean",
92
+ description: "Show a scroll-driven edge fade on the trailing edge of `direction`\n(`'vertical'` fades the bottom; `'horizontal'` fades the inline-end\nedge). Opt-in and presentation-only — never the sole signal that content\nscrolls; the native scrollbar this component always renders remains the\nauthoritative affordance. Has no effect when `direction` is `'both'`\n(there is no single trailing edge to fade on two independent axes at\nonce). Defaults to `false`."
93
+ },
94
+ dragToScroll: {
95
+ type: "boolean",
96
+ description: "Enables fine-pointer (mouse) click-and-drag scrolling, with momentum.\nDefault `false` — drag-to-scroll on a text-bearing pane is a preference,\nnot a default; keyboard scrolling (arrow keys, Page Up/Down, Home/End)\nis unaffected either way. Not supported when `direction` is `'both'`."
97
+ },
90
98
  class: {
91
99
  type: "string",
92
100
  description: "Additional classes merged onto the scroll viewport."
@@ -109,4 +117,4 @@ export {
109
117
  scroll_area_schema_default as default
110
118
  };
111
119
 
112
- //# debugId=89E9925C4987967C64756E2164756E21
120
+ //# debugId=1970C2CB3C28AEDD64756E2164756E21
@@ -37,6 +37,23 @@ export type ScrollAreaProps = Omit<HTMLAttributes<HTMLElement>, 'class' | 'child
37
37
  tabindex?: number;
38
38
  /** Element tag to render. Defaults to `'div'`. */
39
39
  as?: ScrollAreaElement;
40
+ /**
41
+ * Show a scroll-driven edge fade on the trailing edge of `direction`
42
+ * (`'vertical'` fades the bottom; `'horizontal'` fades the inline-end
43
+ * edge). Opt-in and presentation-only — never the sole signal that content
44
+ * scrolls; the native scrollbar this component always renders remains the
45
+ * authoritative affordance. Has no effect when `direction` is `'both'`
46
+ * (there is no single trailing edge to fade on two independent axes at
47
+ * once). Defaults to `false`.
48
+ */
49
+ scrollFadeVisible?: boolean;
50
+ /**
51
+ * Enables fine-pointer (mouse) click-and-drag scrolling, with momentum.
52
+ * Default `false` — drag-to-scroll on a text-bearing pane is a preference,
53
+ * not a default; keyboard scrolling (arrow keys, Page Up/Down, Home/End)
54
+ * is unaffected either way. Not supported when `direction` is `'both'`.
55
+ */
56
+ dragToScroll?: boolean;
40
57
  /** Additional classes merged onto the scroll viewport. */
41
58
  class?: string;
42
59
  /** Scrollable content. */