@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
@@ -4,56 +4,56 @@ export {};
4
4
 
5
5
  <script lang="ts">
6
6
  import { onDestroy } from 'svelte';
7
- import { captureFocus, lockBodyScroll, pushEscapeHandler } from '../../_internal/overlay.ts';
8
7
  import { devWarn } from '../../utilities/dev-warn.ts';
9
8
  import { overflowFade } from '../../utilities/attachments.ts';
10
9
  import { classNames } from '../../utilities/class-names.ts';
11
- import { restoreFocusTo } from '../../utilities/focus.ts';
10
+ import { useReducedMotion } from '../../utilities/use-reduced-motion.svelte.ts';
12
11
  import { createFocusTrap } from '../focus-trap/index.ts';
12
+ import { createSlidingDialogState } from '../_internal/create-sliding-dialog-state.svelte.ts';
13
13
  const titleId = $props.id();
14
14
  let { open = $bindable(false), title, role = 'dialog', dismissOnBackdropClick = true, dismissOnEscape = true, closeButtonVisible = true, class: className, children, footer, triggerRef = null, describedById, onDismiss, } = $props();
15
15
  let dialogElement = $state();
16
+ let panelElement = $state();
16
17
  let bodyElement = $state();
17
18
  // `mounted` is false during SSR and becomes true after the first client-side effect.
18
19
  // The dialog renders only when mounted (client) or when open (SSR with open=true).
19
20
  // This keeps the <dialog> absent from SSR HTML when closed, while letting the client
20
21
  // keep the element mounted so dialogElement.close() fires correctly.
21
22
  let mounted = $state(false);
22
- // Element that had focus before the dialog opened. Captured each time the dialog
23
- // transitions from closed → open so focus can be restored to wherever the user
24
- // came from, even if the consumer didn't supply an explicit `triggerRef`.
25
- let capturedFocus = null;
26
- // Refcounted body scroll lock. Acquired when `open` transitions to true and
27
- // released on close OR on destroy (defensive — both fire on close-then-unmount,
28
- // and idempotence is guaranteed by checking `releaseBodyScrollLock !== null`).
29
- let releaseBodyScrollLock = null;
30
- // Escape-stack handle. Modal handles its own Escape via the native <dialog>
31
- // `cancel` event, but pushing a no-op handler keeps non-dialog overlays
32
- // above us from accidentally swallowing the keystroke (per OVERLAY-POLICY).
33
- let releaseEscapeHandler = null;
34
- function acquireLock() {
35
- if (releaseBodyScrollLock !== null)
36
- return;
37
- releaseBodyScrollLock = lockBodyScroll();
38
- }
39
- function releaseLock() {
40
- releaseBodyScrollLock?.();
41
- releaseBodyScrollLock = null;
42
- }
43
- function acquireEscapeHandler() {
44
- if (releaseEscapeHandler !== null)
45
- return;
46
- releaseEscapeHandler = pushEscapeHandler(() => {
47
- // No-op: the native <dialog> cancel event handles ESC dismissal. We
48
- // push this handler purely to participate in the escape-stack ordering
49
- // so non-dialog overlays above us route their own ESC correctly.
50
- });
51
- }
52
- function releaseEscape() {
53
- releaseEscapeHandler?.();
54
- releaseEscapeHandler = null;
55
- }
23
+ const reducedMotion = useReducedMotion();
56
24
  const bodyOverflowFade = overflowFade();
25
+ // Owns focus capture/restore, body scroll lock, escape-stack participation
26
+ // (a no-op handler — Modal handles Escape via the native <dialog> `cancel`
27
+ // event, but still needs a stack entry so non-dialog overlays above it
28
+ // route their own Escape correctly per OVERLAY-POLICY), and — the piece
29
+ // Modal previously lacked entirely — a real exit-transition grace period.
30
+ // This is the same shared mechanism Drawer and Sheet already use, so all
31
+ // three dialog-based overlays animate symmetrically in and out.
32
+ const dialogState = createSlidingDialogState({
33
+ getOpen: () => open,
34
+ setOpen: (nextOpen) => {
35
+ open = nextOpen;
36
+ },
37
+ getDialogElement: () => dialogElement,
38
+ getPanelElement: () => panelElement,
39
+ getReducedMotion: () => reducedMotion.current,
40
+ getTriggerRef: () => triggerRef,
41
+ onOpen: () => {
42
+ // Initial focus strategy:
43
+ // 1. If a child carries `autofocus`, the native dialog already focused it.
44
+ // 2. Otherwise, focus the body container (tabindex=-1) so initial focus
45
+ // lands on meaningful content rather than the close-X button — which
46
+ // would otherwise be the first sequentially-focusable element.
47
+ // Check both the HTML attribute (set by static markup) and the DOM property
48
+ // (set by Svelte 5's $.autofocus() helper, which sets element.autofocus = true
49
+ // rather than the attribute). The attribute selector alone misses the Svelte case.
50
+ const hasExplicitAutofocus = dialogElement?.querySelector('[autofocus]') !== null ||
51
+ Array.from(dialogElement?.querySelectorAll('*') ?? []).some((el) => el.autofocus === true);
52
+ if (!hasExplicitAutofocus && bodyElement) {
53
+ bodyElement.focus();
54
+ }
55
+ },
56
+ });
57
57
  $effect(() => {
58
58
  mounted = true;
59
59
  });
@@ -68,65 +68,18 @@ $effect(() => {
68
68
  }
69
69
  });
70
70
  $effect(() => {
71
- if (!dialogElement)
72
- return;
73
- if (open && !dialogElement.open) {
74
- capturedFocus = captureFocus();
75
- dialogElement.showModal();
76
- acquireLock();
77
- acquireEscapeHandler();
78
- // Initial focus strategy:
79
- // 1. If a child carries `autofocus`, the native dialog already focused it.
80
- // 2. Otherwise, focus the body container (tabindex=-1) so initial focus
81
- // lands on meaningful content rather than the close-X button — which
82
- // would otherwise be the first sequentially-focusable element.
83
- // Check both the HTML attribute (set by static markup) and the DOM property
84
- // (set by Svelte 5's $.autofocus() helper, which sets element.autofocus = true
85
- // rather than the attribute). The attribute selector alone misses the Svelte case.
86
- const hasExplicitAutofocus = dialogElement.querySelector('[autofocus]') !== null ||
87
- Array.from(dialogElement.querySelectorAll('*')).some((el) => el.autofocus === true);
88
- if (!hasExplicitAutofocus && bodyElement) {
89
- bodyElement.focus();
90
- }
91
- }
92
- else if (!open && dialogElement.open) {
93
- // Only close if the dialog is actually open — close() throws InvalidStateError
94
- // if called on a dialog that was never opened.
95
- dialogElement.close();
96
- }
71
+ dialogState.syncOpenState();
97
72
  });
98
- function returnFocus() {
99
- // Iterate the local candidate list; the first that passes the connection
100
- // /ownership check wins. No fallback to document.body — if both candidates
101
- // are gone, leave focus where the browser put it.
102
- const candidates = [triggerRef, capturedFocus];
103
- for (const candidate of candidates) {
104
- if (restoreFocusTo(candidate))
105
- break;
106
- }
107
- capturedFocus = null;
108
- }
109
73
  // Single source of truth for all user-initiated dismissal paths: Escape, backdrop click,
110
- // and the close-X button. State flips FIRST so a thrown callback does not leave the
111
- // dialog open. Callbacks are not awaited; sync throws propagate to the caller.
74
+ // and the close-X button. `open` flips FIRST (inside requestClose) so a thrown callback
75
+ // does not leave the dialog's reactive state open. Callbacks are not awaited; sync throws
76
+ // propagate to the caller.
112
77
  function dismiss() {
113
- open = false;
78
+ dialogState.requestClose();
114
79
  onDismiss?.();
115
80
  }
116
- function handleClose() {
117
- // Fired on the native 'close' event — may be triggered by dismiss() (via dialogElement.close())
118
- // or by parent-driven open = false. Only restores focus; does NOT call onDismiss here
119
- // so parent-driven closes do not fire the callback.
120
- open = false;
121
- releaseLock();
122
- releaseEscape();
123
- returnFocus();
124
- }
125
81
  onDestroy(() => {
126
- // Defensive — close-then-unmount and unmount-while-open both land here.
127
- // The release functions are idempotent so a double-release is impossible.
128
- releaseLock();
129
- releaseEscape();
82
+ dialogState.destroy();
130
83
  });
131
84
  function handleBackdropClick(event) {
132
85
  if (dismissOnBackdropClick && event.target === dialogElement) {
@@ -136,8 +89,9 @@ function handleBackdropClick(event) {
136
89
  function handleNativeCancel(event) {
137
90
  // Escape key fires the native 'cancel' event on <dialog>. We prevent the default
138
91
  // so the browser doesn't close the dialog through its own mechanism — we route
139
- // exclusively through dismiss() → open = false → $effect → dialogElement.close()
140
- // → 'close' event → handleClose. This ensures exactly one close path for Escape.
92
+ // exclusively through dismiss() → requestClose() → the exit transition → the real
93
+ // 'close' event → dialogState.handleClose(). This ensures exactly one close path
94
+ // for Escape.
141
95
  event.preventDefault();
142
96
  if (!dismissOnEscape)
143
97
  return;
@@ -153,25 +107,31 @@ function handleNativeCancel(event) {
153
107
  aria-modal="true"
154
108
  aria-labelledby={titleId}
155
109
  {...describedById ? { 'aria-describedby': describedById } : {}}
156
- onclose={handleClose}
110
+ data-cinder-closing={dialogState.isClosing ? '' : undefined}
111
+ onclose={() => dialogState.handleClose()}
157
112
  onclick={handleBackdropClick}
158
113
  oncancel={handleNativeCancel}
159
114
  >
160
- {#if open}
115
+ {#if dialogState.renderPanel}
161
116
  <!--
162
117
  The native <dialog> opened with showModal() already traps focus in
163
118
  supporting browsers. The shared focus-trap is a defence-in-depth fallback
164
119
  that keeps Tab / Shift+Tab cycling inside the panel; it carefully filters
165
120
  hidden/inert/disabled/`tabindex="-1"` elements. Modal owns its own initial
166
- focus (the body container, below) and focus restoration (returnFocus), so
167
- the trap runs with `manageInitialFocus: false` and `restoreFocus: false` —
168
- without the former the trap would yank focus off the body onto the close
169
- button on the next microtask.
121
+ focus (the body container, below) and focus restoration (via
122
+ `dialogState`'s `getTriggerRef`), so the trap runs with
123
+ `manageInitialFocus: false` and `restoreFocus: false` — without the
124
+ former the trap would yank focus off the body onto the close button on
125
+ the next microtask. `active` also drops during the closing transition
126
+ so the trap stops enforcing tab-containment while the panel fades out.
170
127
  -->
171
128
  <div
129
+ bind:this={panelElement}
172
130
  class="cinder-modal__panel"
131
+ data-cinder-closing={dialogState.isClosing ? '' : undefined}
132
+ inert={dialogState.isClosing}
173
133
  {@attach createFocusTrap({
174
- active: () => open,
134
+ active: () => open && !dialogState.isClosing,
175
135
  restoreFocus: false,
176
136
  manageInitialFocus: false,
177
137
  })}
@@ -182,7 +142,7 @@ function handleNativeCancel(event) {
182
142
 
183
143
  <div
184
144
  bind:this={bodyElement}
185
- class="cinder-modal__body"
145
+ class="cinder-modal__body cinder-_scroll-fade"
186
146
  tabindex="-1"
187
147
  {@attach bodyOverflowFade}
188
148
  >
@@ -47,6 +47,9 @@
47
47
 
48
48
  .cinder-multi-select__trigger:focus-visible {
49
49
  outline: var(--cinder-ring-width) solid transparent;
50
+ /* Ring replaces the border while focused rather than stacking on it — the two
51
+ together read as one heavier shape than either was designed to be. */
52
+ border-color: transparent;
50
53
  box-shadow: var(--_cinder-focus-ring-shadow);
51
54
  }
52
55
 
@@ -123,24 +126,15 @@
123
126
  }
124
127
 
125
128
  .cinder-multi-select__panel {
126
- position: absolute;
127
- inset-inline: 0;
128
- top: calc(100% + var(--cinder-space-1));
129
129
  z-index: var(--cinder-z-popover);
130
130
  margin: 0;
131
131
  padding: var(--cinder-space-1);
132
132
  min-inline-size: 0;
133
- max-inline-size: 100%;
134
133
  display: flex;
135
134
  flex-direction: column;
136
135
  gap: var(--cinder-space-1);
137
136
  }
138
137
 
139
- .cinder-multi-select__panel[data-cinder-direction='up'] {
140
- top: auto;
141
- bottom: calc(100% + var(--cinder-space-1));
142
- }
143
-
144
138
  .cinder-multi-select__filter {
145
139
  min-height: 2rem;
146
140
  font-size: var(--cinder-text-sm);
@@ -288,7 +282,7 @@
288
282
  }
289
283
 
290
284
  .cinder-multi-select__error {
291
- color: var(--cinder-danger);
285
+ color: var(--cinder-color-danger-fg);
292
286
  }
293
287
 
294
288
  .cinder-multi-select__error:not([data-cinder-error]) {
@@ -7,10 +7,13 @@ import ChevronDown from 'lucide-svelte/icons/chevron-down';
7
7
  import { tick, untrack } from 'svelte';
8
8
  import CheckboxIndicatorShell from '../_internal/checkbox-indicator-shell.svelte';
9
9
  import { createCommandListState } from '../_internal/create-command-list-state.svelte.ts';
10
+ import { createAnchoredOverlay } from '../../_internal/anchored-overlay.svelte.ts';
10
11
  import { resolveFieldControl } from '../../_internal/field-control.ts';
11
12
  import { getFormFieldContext } from '../../_internal/form-field-context.ts';
12
13
  import FormFieldFrame from '../../_internal/form-field-frame.svelte';
13
14
  import { classNames } from '../../utilities/class-names.ts';
15
+ import { createPortalAttachment } from '../portal/index.ts';
16
+ import { findNearestOpenTopLayer } from '../portal/portal.utilities.svelte.ts';
14
17
  let { id, items, selectedIds = $bindable([]), name, label, placeholder = 'Select options', description, error, warning, disabled, readonly = false, required, filterable = false, filter, selectionFeedback = 'fixed', direction = 'down', class: className, 'aria-describedby': consumerDescribedBy, } = $props();
15
18
  const context = getFormFieldContext();
16
19
  const warningId = $derived(warning ? `${id}-warning` : undefined);
@@ -60,6 +63,42 @@ let listboxElement = $state(null);
60
63
  let validityProxyElement = $state(null);
61
64
  let nativeError = $state('');
62
65
  let resetSyncTimeout;
66
+ // The panel is portaled out of the DOM subtree it renders in (see
67
+ // `panelPortalAttachment` below) so an ancestor with `overflow: hidden` — or any
68
+ // ancestor establishing a new containing block — cannot clip it. `position: fixed`
69
+ // (via `_floating-surface`/Floating UI) only escapes that containment when the panel
70
+ // is no longer a DOM descendant of the trigger's clipped ancestor. `widthMode:
71
+ // 'match-anchor'` preserves the prior
72
+ // full-trigger-width CSS behavior (`inset-inline: 0`); `direction` maps directly to a
73
+ // Floating UI placement, and `flip` (always active in `createAnchoredOverlay`) upgrades
74
+ // the previous purely author-controlled `direction` into collision-aware placement.
75
+ const anchoredOverlay = createAnchoredOverlay({
76
+ open: () => open,
77
+ anchor: () => triggerElement,
78
+ panel: () => panelElement,
79
+ placement: () => (direction === 'up' ? 'top-start' : 'bottom-start'),
80
+ offset: () => 4,
81
+ widthMode: () => 'match-anchor',
82
+ });
83
+ const panelPortalAttachment = createPortalAttachment({
84
+ // Escaping to `document.body` unconditionally would render the panel BEHIND a
85
+ // native <dialog> or open [popover] ancestor's top layer, since regular DOM
86
+ // content can never out-stack the top layer regardless of z-index. Prefer the
87
+ // nearest enclosing open top-layer container (matching Popover/SpeedDial/
88
+ // NavigationBar) and fall back to document.body only when there isn't one.
89
+ target: () => {
90
+ if (!triggerElement)
91
+ return document.body;
92
+ try {
93
+ return findNearestOpenTopLayer(triggerElement) ?? document.body;
94
+ }
95
+ catch {
96
+ return document.body;
97
+ }
98
+ },
99
+ source: () => controlElement,
100
+ inheritAttributes: true,
101
+ });
63
102
  const triggerAriaInvalid = $derived(field.ariaInvalid ?? (nativeError ? true : undefined));
64
103
  const combinedError = $derived(error || nativeError || undefined);
65
104
  const triggerDescribedBy = $derived.by(() => {
@@ -350,9 +389,13 @@ $effect(() => {
350
389
  {#if open}
351
390
  <div
352
391
  bind:this={panelElement}
392
+ {@attach panelPortalAttachment}
353
393
  id={`${id}-popover`}
354
394
  class="cinder-_floating-surface cinder-multi-select__panel"
355
395
  data-cinder-direction={direction}
396
+ data-cinder-placement={anchoredOverlay.resolvedPlacement}
397
+ data-cinder-position-ready={anchoredOverlay.positionReady}
398
+ style={anchoredOverlay.positionStyle}
356
399
  data-cinder-open
357
400
  >
358
401
  {#if filterable}
@@ -51,6 +51,9 @@
51
51
 
52
52
  .cinder-navigation-item:focus-visible {
53
53
  outline: var(--cinder-ring-width) solid transparent;
54
+ /* Ring replaces the border while focused rather than stacking on it — the two
55
+ together read as one heavier shape than either was designed to be. */
56
+ border-color: transparent;
54
57
  box-shadow: var(--_cinder-focus-ring-shadow);
55
58
  }
56
59
 
@@ -93,6 +93,9 @@
93
93
  .cinder-pagination__step:focus-visible,
94
94
  .cinder-pagination__page:focus-visible {
95
95
  outline: var(--cinder-ring-width) solid transparent;
96
+ /* Ring replaces the border while focused rather than stacking on it — the two
97
+ together read as one heavier shape than either was designed to be. */
98
+ border-color: transparent;
96
99
  box-shadow: var(--_cinder-focus-ring-shadow);
97
100
  }
98
101
 
@@ -31,6 +31,21 @@
31
31
  border: 1px solid var(--cinder-border);
32
32
  border-radius: var(--cinder-radius-md);
33
33
  background: var(--cinder-surface);
34
+ /* Same inset-shadow affordance as data-grid's
35
+ * `--_cinder-data-grid-overflow-shadow` (data-grid.css), driven by
36
+ * `overflowShadow('inline')` (utilities/attachments.ts). The
37
+ * inline-start edge of this shadow sits directly behind the opaque
38
+ * sticky corner/row-header below (both paint above a scroll container's
39
+ * own box-shadow decoration), so in practice only the inline-end edge is
40
+ * ever visible — which is also the only edge that needs it, since the
41
+ * row header is always-visible chrome, not scrolling content. */
42
+ box-shadow: var(--_cinder-permission-matrix-scroll-shadow, none);
43
+ }
44
+
45
+ .cinder-permission-matrix__scroll[data-cinder-overflows-inline] {
46
+ --_cinder-permission-matrix-scroll-shadow:
47
+ inset 1rem 0 1rem -1rem color-mix(in srgb, var(--cinder-text) 28%, transparent),
48
+ inset -1rem 0 1rem -1rem color-mix(in srgb, var(--cinder-text) 28%, transparent);
34
49
  }
35
50
 
36
51
  .cinder-permission-matrix__table {
@@ -10,6 +10,7 @@ import Check from 'lucide-svelte/icons/check';
10
10
  import LockKeyhole from 'lucide-svelte/icons/lock-keyhole';
11
11
  import Minus from 'lucide-svelte/icons/minus';
12
12
  import { classNames } from '../../utilities/class-names.ts';
13
+ import { overflowShadow } from '../../utilities/attachments.ts';
13
14
  let { label, description, rows, columns, getCellState, onCellClick, stateLabels, rowHeaderLabel = 'Scope', loading = false, class: customClassName, empty, loadingContent, id, ...rest } = $props();
14
15
  const generatedId = $props.id();
15
16
  const rootId = $derived(id ?? generatedId);
@@ -53,7 +54,11 @@ function cellLabel(row, column, state) {
53
54
  {#if empty}{@render empty()}{:else}No matrix data{/if}
54
55
  </div>
55
56
  {:else}
56
- <div class="cinder-permission-matrix__scroll" data-cinder-scroll-container>
57
+ <div
58
+ class="cinder-permission-matrix__scroll"
59
+ data-cinder-scroll-container
60
+ {@attach overflowShadow('inline')}
61
+ >
57
62
  <table class="cinder-permission-matrix__table">
58
63
  <caption class="cinder-sr-only">{label}</caption>
59
64
  <thead>
@@ -103,6 +103,6 @@
103
103
  .cinder-phone-input-field__error {
104
104
  margin: 0;
105
105
  font-size: var(--cinder-text-xs);
106
- color: var(--cinder-danger);
106
+ color: var(--cinder-color-danger-fg);
107
107
  }
108
108
  }
@@ -62,8 +62,16 @@
62
62
 
63
63
  .cinder-pin-input__segment:focus-visible {
64
64
  outline: var(--cinder-ring-width) solid transparent;
65
+ /* Ring replaces the border while focused rather than stacking on it — the two
66
+ together read as one heavier shape than either was designed to be. This rule
67
+ previously ALSO strengthened the border to --cinder-border-strong on focus,
68
+ which is the exact double-treatment decision 7 is about: a segment got a
69
+ heavier border AND a ring simultaneously. The strengthened border is dropped
70
+ rather than kept, so the ring is the only focus affordance; the unfocused
71
+ segments beside it keep their resting borders, which is what makes the
72
+ focused one read. Hover still steps up to --cinder-border-strong above. */
73
+ border-color: transparent;
65
74
  box-shadow: var(--_cinder-focus-ring-shadow);
66
- border-color: var(--cinder-border-strong);
67
75
  }
68
76
 
69
77
  .cinder-pin-input[aria-invalid='true'] .cinder-pin-input__segment {
@@ -91,6 +99,6 @@
91
99
  .cinder-pin-input-field__error {
92
100
  margin: 0;
93
101
  font-size: var(--cinder-text-xs);
94
- color: var(--cinder-danger);
102
+ color: var(--cinder-color-danger-fg);
95
103
  }
96
104
  }
@@ -27,7 +27,7 @@
27
27
  }
28
28
 
29
29
  .cinder-qr-code__placeholder[data-cinder-state='error'] {
30
- color: var(--cinder-danger);
30
+ color: var(--cinder-color-danger-fg);
31
31
  border: 1px solid var(--cinder-danger);
32
32
  background: var(--cinder-color-danger-bg, var(--cinder-surface-inset));
33
33
  }
@@ -45,7 +45,7 @@
45
45
  .cinder-radio-group__error {
46
46
  font-size: var(--cinder-text-xs);
47
47
  line-height: var(--cinder-leading-normal);
48
- color: var(--cinder-danger);
48
+ color: var(--cinder-color-danger-fg);
49
49
  margin: 0;
50
50
  }
51
51
 
@@ -114,6 +114,6 @@
114
114
  .cinder-rating-field__error {
115
115
  margin: 0;
116
116
  font-size: var(--cinder-text-xs);
117
- color: var(--cinder-danger);
117
+ color: var(--cinder-color-danger-fg);
118
118
  }
119
119
  }
@@ -46,7 +46,7 @@
46
46
 
47
47
  .cinder-schema-form__error {
48
48
  margin: 0;
49
- color: var(--cinder-danger);
49
+ color: var(--cinder-color-danger-fg);
50
50
  font-size: var(--cinder-text-sm);
51
51
  }
52
52
 
@@ -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);
@@ -26,6 +26,14 @@
26
26
  "enum": ["article", "aside", "div", "li", "main", "nav", "ol", "pre", "section", "ul"],
27
27
  "description": "Element tag to render. Defaults to `'div'`."
28
28
  },
29
+ "scrollFadeVisible": {
30
+ "type": "boolean",
31
+ "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`."
32
+ },
33
+ "dragToScroll": {
34
+ "type": "boolean",
35
+ "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'`."
36
+ },
29
37
  "class": {
30
38
  "type": "string",
31
39
  "description": "Additional classes merged onto the scroll viewport."
@@ -30,6 +30,16 @@ const schema = {
30
30
  enum: ['article', 'aside', 'div', 'li', 'main', 'nav', 'ol', 'pre', 'section', 'ul'],
31
31
  description: "Element tag to render. Defaults to `'div'`.",
32
32
  },
33
+ scrollFadeVisible: {
34
+ type: 'boolean',
35
+ description:
36
+ "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`.",
37
+ },
38
+ dragToScroll: {
39
+ type: 'boolean',
40
+ description:
41
+ "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'`.",
42
+ },
33
43
  class: {
34
44
  type: 'string',
35
45
  description: 'Additional classes merged onto the scroll viewport.',
@@ -1,11 +1,50 @@
1
1
  <script lang="ts" module>
2
2
  const explicitRegionElements = new Set(['div', 'pre']);
3
+ const noopScrollFadeAttachment = () => { };
3
4
  export {};
4
5
  </script>
5
6
 
6
7
  <script lang="ts">
8
+ import { overflowFadeEdges } from '../../utilities/attachments.ts';
7
9
  import { classNames } from '../../utilities/class-names.ts';
8
- let { direction = 'vertical', maxHeight, maxWidth, label, tabindex = 0, as = 'div', class: className, children, ...rest } = $props();
10
+ import { devWarn } from '../../utilities/dev-warn.ts';
11
+ import { useDragScroll } from '../../utilities/use-drag-scroll.svelte.ts';
12
+ import { useFinePointer } from '../../utilities/use-fine-pointer.svelte.ts';
13
+ import { useReducedMotion } from '../../utilities/use-reduced-motion.svelte.ts';
14
+ let { direction = 'vertical', maxHeight, maxWidth, label, tabindex = 0, as = 'div', dragToScroll = false, class: className, scrollFadeVisible = false, children, ...rest } = $props();
15
+ // No single trailing edge exists on two independent scroll axes at once —
16
+ // `direction="both"` never gets a fade, regardless of scrollFadeVisible.
17
+ const scrollFadeAxis = $derived(scrollFadeVisible && direction === 'vertical'
18
+ ? 'block'
19
+ : scrollFadeVisible && direction === 'horizontal'
20
+ ? 'inline'
21
+ : undefined);
22
+ const scrollFadeClass = $derived(scrollFadeAxis === 'block'
23
+ ? 'cinder-_scroll-fade'
24
+ : scrollFadeAxis === 'inline'
25
+ ? 'cinder-_scroll-fade-inline-end'
26
+ : undefined);
27
+ // Memoized on `scrollFadeAxis` so the attachment's identity stays stable
28
+ // across unrelated re-renders — Svelte tears down and re-runs an
29
+ // attachment whenever its reference changes.
30
+ const scrollFadeAttachment = $derived(scrollFadeAxis ? overflowFadeEdges(scrollFadeAxis) : noopScrollFadeAttachment);
31
+ const finePointer = useFinePointer();
32
+ const reducedMotion = useReducedMotion();
33
+ $effect(() => {
34
+ if (dragToScroll && direction === 'both') {
35
+ devWarn('[cinder/ScrollArea] `dragToScroll` is not supported with `direction="both"` yet; it is being ignored.');
36
+ }
37
+ });
38
+ // `axis` is captured once, like `useResizeObserver`'s `box` option — if a
39
+ // consumer changes `direction` after mount, a fresh instance (a keyed
40
+ // `{#key direction}` around the component) picks up the new axis, matching
41
+ // that existing attachment's documented behavior for the same reason.
42
+ // Momentum and rubber-band are exactly the inertial motion
43
+ // `prefers-reduced-motion` is about — see Carousel's identical gating.
44
+ const dragScroll = useDragScroll({
45
+ axis: direction === 'horizontal' ? 'x' : 'y',
46
+ enabled: () => dragToScroll && direction !== 'both' && finePointer.current && !reducedMotion.current,
47
+ });
9
48
  const normalizedAriaLabel = $derived(typeof label === 'string' && label.trim().length > 0 ? label.trim() : undefined);
10
49
  // `aria-labelledby` reaches the element through `...rest`. Treat it the same as
11
50
  // the `label` prop for landmark purposes: a neutral element (`div`/`pre`) with an
@@ -22,13 +61,16 @@ const role = $derived(hasAccessibleName && explicitRegionElements.has(as) ? 'reg
22
61
  <svelte:element
23
62
  this={as}
24
63
  {...rest}
25
- class={classNames('cinder-scroll-area', className)}
64
+ class={classNames('cinder-scroll-area', scrollFadeClass, className)}
26
65
  data-cinder-direction={direction}
66
+ data-cinder-drag-to-scroll={dragToScroll && direction !== 'both' ? '' : undefined}
27
67
  {role}
28
68
  aria-label={normalizedAriaLabel}
29
69
  {tabindex}
30
70
  style:max-block-size={maxHeight}
31
71
  style:max-inline-size={maxWidth}
72
+ {@attach scrollFadeAttachment}
73
+ {@attach dragScroll}
32
74
  >
33
75
  {@render children()}
34
76
  </svelte:element>
@@ -50,6 +50,23 @@ export type ScrollAreaProps = Omit<
50
50
  tabindex?: number;
51
51
  /** Element tag to render. Defaults to `'div'`. */
52
52
  as?: ScrollAreaElement;
53
+ /**
54
+ * Show a scroll-driven edge fade on the trailing edge of `direction`
55
+ * (`'vertical'` fades the bottom; `'horizontal'` fades the inline-end
56
+ * edge). Opt-in and presentation-only — never the sole signal that content
57
+ * scrolls; the native scrollbar this component always renders remains the
58
+ * authoritative affordance. Has no effect when `direction` is `'both'`
59
+ * (there is no single trailing edge to fade on two independent axes at
60
+ * once). Defaults to `false`.
61
+ */
62
+ scrollFadeVisible?: boolean;
63
+ /**
64
+ * Enables fine-pointer (mouse) click-and-drag scrolling, with momentum.
65
+ * Default `false` — drag-to-scroll on a text-bearing pane is a preference,
66
+ * not a default; keyboard scrolling (arrow keys, Page Up/Down, Home/End)
67
+ * is unaffected either way. Not supported when `direction` is `'both'`.
68
+ */
69
+ dragToScroll?: boolean;
53
70
  /** Additional classes merged onto the scroll viewport. */
54
71
  class?: string;
55
72
  /** Scrollable content. */