@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
@@ -2,24 +2,44 @@
2
2
  export {};
3
3
  </script>
4
4
 
5
- <script lang="ts">
5
+ <script lang="ts" generics="TSlide extends CarouselSlide = CarouselSlide">
6
6
  import { onDestroy, untrack } from 'svelte';
7
7
  import { SvelteSet } from 'svelte/reactivity';
8
+ import { observeTextDirection } from '../../_internal/text-direction.ts';
8
9
  import { classNames } from '../../utilities/class-names.ts';
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';
9
13
  import { useReducedMotion } from '../../utilities/use-reduced-motion.svelte.ts';
10
14
  import { useResizeObserver } from '../../utilities/use-resize-observer.svelte.ts';
11
15
  const reducedMotion = useReducedMotion();
16
+ const finePointer = useFinePointer();
12
17
  const descriptionId = $props.id();
13
- let { slides, activeIndex = $bindable(0), autoplay = false, autoplayInterval = 5000, label = 'Carousel', description, controlLabels, class: className, ...rest } = $props();
18
+ let { slides, activeIndex = $bindable(0), autoplay = false, autoplayInterval = 5000, loop = false, label = 'Carousel', description, controlLabels, indicators, indicatorLimit = 8, slidesPerView = 1, gap, align = 'start', onSlideChange, slide: slideSnippet, class: className, onkeydown: consumerOnKeydown, onmouseenter: consumerOnMouseEnter, onmouseleave: consumerOnMouseLeave, onfocusin: consumerOnFocusIn, onfocusout: consumerOnFocusOut, ...rest } = $props();
14
19
  let isHovered = $state(false);
15
20
  let hasFocusWithin = $state(false);
16
21
  let userPaused = $state(false);
17
- let isInteracting = $state(false);
18
- let isNativeScrolling = $state(false);
19
- let isAutoplayTransitioning = $state(false);
22
+ let motion = $state({ kind: 'idle' });
23
+ // `motion = {...}` always writes a fresh object, so an unconditional
24
+ // reassignment defeats Svelte's same-value skip (unlike the primitive
25
+ // flags this replaces) and can re-trigger an effect that both reads and
26
+ // writes it every run. Only assign when the value actually changed.
27
+ function setMotion(next) {
28
+ const unchanged = motion.kind === next.kind &&
29
+ (motion.kind !== 'programmatic' ||
30
+ (next.kind === 'programmatic' &&
31
+ motion.target === next.target &&
32
+ motion.source === next.source)) &&
33
+ (motion.kind !== 'user' || (next.kind === 'user' && motion.source === next.source));
34
+ if (!unchanged)
35
+ motion = next;
36
+ }
20
37
  let settledIndex = $state(untrack(() => (slides.length < 1 ? 0 : Math.max(0, Math.min(slides.length - 1, activeIndex)))));
38
+ // Mirrors the nearest slide on every scroll frame during 'user' motion, for
39
+ // cosmetic dot/aria-current styling only. `activeIndex` itself only writes
40
+ // back once the gesture settles — see `handleSettle`.
41
+ let visualIndex = $state(untrack(() => settledIndex));
21
42
  let viewportElement = $state(null);
22
- let programmaticTarget = null;
23
43
  const activePointerIds = new SvelteSet();
24
44
  let nativeScrollEndTimer = null;
25
45
  let scrollFrame = null;
@@ -34,9 +54,11 @@ const currentIndex = $derived.by(() => {
34
54
  return 0;
35
55
  return Math.max(0, Math.min(clampedLength - 1, activeIndex));
36
56
  });
37
- let deferredExternalIndex = null;
57
+ // Snapshotted at the moment a 'user' gesture begins; compared at settle to
58
+ // detect a parent-driven `activeIndex` change that landed mid-gesture, which
59
+ // wins over wherever the finger physically settled (see `handleSettle`).
38
60
  let observedActiveIndex = currentIndex;
39
- let internalActiveIndexUpdate = null;
61
+ const displayIndex = $derived(motion.kind === 'user' ? visualIndex : currentIndex);
40
62
  const slideIdentity = $derived(slides.map((slide) => slide.id).join('\u0000'));
41
63
  let previousSlideIdentity = untrack(() => slideIdentity);
42
64
  $effect(() => {
@@ -55,74 +77,111 @@ const shouldAutoplay = $derived(autoplay &&
55
77
  !reducedMotion.current &&
56
78
  !isHovered &&
57
79
  !hasFocusWithin &&
58
- !isInteracting &&
59
- !isNativeScrolling &&
80
+ activePointerIds.size === 0 &&
81
+ motion.kind !== 'user' &&
60
82
  !userPaused);
83
+ // `slidesPerView` above 1 makes more than one slide active/interactive at
84
+ // once. The range is index-derived (currentIndex .. currentIndex + n - 1),
85
+ // not measured from real layout — `'auto'` can't be sized in advance, so it
86
+ // behaves like a range of 1 (a single primary slide, e.g. for peek layouts).
87
+ const isMultiView = $derived(slidesPerView !== 1);
88
+ const visibleRangeSize = $derived(typeof slidesPerView === 'number' ? Math.max(1, Math.ceil(slidesPerView)) : 1);
89
+ const rangeEnd = $derived(Math.min(clampedLength - 1, currentIndex + visibleRangeSize - 1));
90
+ function isSlideInRange(index) {
91
+ return isInRangeOfAnchor(index, currentIndex);
92
+ }
93
+ // slidesPerView > 1 rotates a partial-width slide across the wrap boundary,
94
+ // leaving a visible gap — unsupported in v1 (see the devWarn effect below).
95
+ const effectiveLoop = $derived(loop && !isMultiView);
96
+ const resolvedSlideSize = $derived.by(() => {
97
+ if (!isMultiView)
98
+ return undefined;
99
+ if (slidesPerView === 'auto')
100
+ return 'auto';
101
+ return `calc((100% - (${slidesPerView} - 1) * var(--cinder-carousel-gap, var(--cinder-space-3))) / ${slidesPerView})`;
102
+ });
103
+ $effect(() => {
104
+ if (loop && isMultiView) {
105
+ devWarn('[cinder/Carousel] `loop` is not supported with `slidesPerView` greater than 1 yet; `loop` is being ignored.');
106
+ }
107
+ });
61
108
  const liveAnnouncement = $derived.by(() => {
62
109
  if (!slides[currentIndex])
63
110
  return '';
111
+ if (rangeEnd > currentIndex) {
112
+ return `Slides ${currentIndex + 1}–${rangeEnd + 1} of ${clampedLength}`;
113
+ }
64
114
  return `Slide ${currentIndex + 1} of ${clampedLength}: ${slides[currentIndex].label}`;
65
115
  });
116
+ const isAtStart = $derived(!effectiveLoop && currentIndex === 0);
117
+ const isAtEnd = $derived(!effectiveLoop && rangeEnd === clampedLength - 1);
118
+ const resolvedIndicators = $derived(indicators ?? (clampedLength > indicatorLimit ? 'counter' : 'dots'));
66
119
  $effect(() => {
67
120
  if (!shouldAutoplay)
68
121
  return;
69
122
  const timer = setInterval(() => {
70
123
  if (clampedLength < 2)
71
124
  return;
72
- isAutoplayTransitioning = true;
73
- goNext(true);
74
- if (programmaticTarget === null)
75
- isAutoplayTransitioning = false;
125
+ goNext('autoplay');
76
126
  }, autoplayInterval);
77
127
  return () => clearInterval(timer);
78
128
  });
79
- function goTo(index, immediate = false, fromAutoplay = false) {
129
+ function goTo(index, immediate = false, source = 'control') {
80
130
  if (clampedLength < 1)
81
131
  return;
82
- if (!fromAutoplay)
83
- isAutoplayTransitioning = false;
84
- const nextIndex = ((index % clampedLength) + clampedLength) % clampedLength;
85
- if (programmaticTarget !== null && viewportElement !== null) {
132
+ const nextIndex = effectiveLoop
133
+ ? ((index % clampedLength) + clampedLength) % clampedLength
134
+ : Math.max(0, Math.min(clampedLength - 1, index));
135
+ if (motion.kind === 'programmatic' && viewportElement !== null) {
86
136
  settledIndex = nearestVisibleSlideIndex(viewportElement);
87
137
  }
138
+ const changed = nextIndex !== activeIndex;
88
139
  activeIndex = nextIndex;
89
- scrollToActiveSlide(immediate ? 'auto' : undefined);
140
+ scrollToActiveSlide(immediate ? 'auto' : undefined, source);
141
+ if (changed) {
142
+ const slide = slides[nextIndex];
143
+ if (slide)
144
+ onSlideChange?.(nextIndex, slide);
145
+ }
90
146
  }
91
- function goPrevious() {
147
+ function goPrevious(source = 'control') {
92
148
  const nextIndex = (currentIndex - 1 + clampedLength) % clampedLength;
93
149
  const physicalDistance = Math.abs(initialSlideOrder(nextIndex) - initialSlideOrder(currentIndex));
94
- goTo(currentIndex - 1, clampedLength > 2 && physicalDistance > 1);
150
+ goTo(currentIndex - 1, clampedLength > 2 && physicalDistance > 1, source);
95
151
  }
96
- function goNext(fromAutoplay = false) {
152
+ function goNext(source = 'control') {
97
153
  const nextIndex = (currentIndex + 1) % clampedLength;
98
154
  const physicalDistance = Math.abs(initialSlideOrder(nextIndex) - initialSlideOrder(currentIndex));
99
- goTo(currentIndex + 1, clampedLength > 2 && physicalDistance > 1, fromAutoplay);
155
+ goTo(currentIndex + 1, clampedLength > 2 && physicalDistance > 1, source);
100
156
  }
101
157
  function onKeydown(event) {
158
+ consumerOnKeydown?.(event);
159
+ if (event.defaultPrevented)
160
+ return;
102
161
  if (clampedLength < 2)
103
162
  return;
104
163
  if (event.key === 'ArrowLeft') {
105
164
  event.preventDefault();
106
165
  focusCarouselRoot(event);
107
- goPrevious();
166
+ goPrevious('keyboard');
108
167
  return;
109
168
  }
110
169
  if (event.key === 'ArrowRight') {
111
170
  event.preventDefault();
112
171
  focusCarouselRoot(event);
113
- goNext();
172
+ goNext('keyboard');
114
173
  return;
115
174
  }
116
175
  if (event.key === 'Home') {
117
176
  event.preventDefault();
118
177
  focusCarouselRoot(event);
119
- goTo(0);
178
+ goTo(0, undefined, 'keyboard');
120
179
  return;
121
180
  }
122
181
  if (event.key === 'End') {
123
182
  event.preventDefault();
124
183
  focusCarouselRoot(event);
125
- goTo(clampedLength - 1);
184
+ goTo(clampedLength - 1, undefined, 'keyboard');
126
185
  }
127
186
  }
128
187
  function focusCarouselRoot(event) {
@@ -138,7 +197,20 @@ function focusCarouselRoot(event) {
138
197
  root.focus();
139
198
  }
140
199
  }
200
+ function onMouseEnter(event) {
201
+ consumerOnMouseEnter?.(event);
202
+ isHovered = true;
203
+ }
204
+ function onMouseLeave(event) {
205
+ consumerOnMouseLeave?.(event);
206
+ isHovered = false;
207
+ }
208
+ function onFocusIn(event) {
209
+ consumerOnFocusIn?.(event);
210
+ hasFocusWithin = true;
211
+ }
141
212
  function onFocusOut(event) {
213
+ consumerOnFocusOut?.(event);
142
214
  const nextFocus = event.relatedTarget;
143
215
  if (nextFocus instanceof Node && event.currentTarget instanceof HTMLElement) {
144
216
  if (event.currentTarget.contains(nextFocus))
@@ -151,15 +223,19 @@ function initialSlideOrder(index) {
151
223
  return 0;
152
224
  return (index - initialSlideIndex + slides.length) % slides.length;
153
225
  }
226
+ function isInRangeOfAnchor(index, anchor) {
227
+ const end = Math.min(clampedLength - 1, anchor + visibleRangeSize - 1);
228
+ return index >= anchor && index <= end;
229
+ }
154
230
  function isInteractionLayoutSlide(index) {
155
- if (index === currentIndex || index === settledIndex)
231
+ if (isInRangeOfAnchor(index, currentIndex) || isInRangeOfAnchor(index, settledIndex))
156
232
  return true;
157
233
  // Widen the layout window only once a pan or programmatic transition is
158
- // actually moving the track (isNativeScrolling / programmaticTarget), not
159
- // merely because a touch/pen pointer is down. A tap that never causes a
160
- // scroll event — including tapping the active slide's own link — must
161
- // not pop a taller neighbor's height in and back out.
162
- if (!(isNativeScrolling || programmaticTarget !== null))
234
+ // actually moving the track (motion.kind !== 'idle'), not merely because
235
+ // a touch/pen pointer is down. A tap that never causes a scroll event —
236
+ // including tapping the active slide's own link — must not pop a taller
237
+ // neighbor's height in and back out.
238
+ if (motion.kind === 'idle')
163
239
  return false;
164
240
  const currentOrder = initialSlideOrder(currentIndex);
165
241
  const settledOrder = initialSlideOrder(settledIndex);
@@ -168,7 +244,10 @@ function isInteractionLayoutSlide(index) {
168
244
  const slideOrder = initialSlideOrder(index);
169
245
  return slideOrder >= lowerBound && slideOrder <= upperBound;
170
246
  }
171
- function scrollToActiveSlide(behavior) {
247
+ function slideAnchor(rect) {
248
+ return align === 'center' ? rect.left + rect.width / 2 : rect.left;
249
+ }
250
+ function scrollToActiveSlide(behavior, source = 'external') {
172
251
  const viewport = viewportElement;
173
252
  if (viewport === null)
174
253
  return;
@@ -179,18 +258,19 @@ function scrollToActiveSlide(behavior) {
179
258
  const slideRect = slide.getBoundingClientRect();
180
259
  if (viewportRect.width === 0 || slideRect.width === 0)
181
260
  return;
182
- if (Math.abs(slideRect.left - viewportRect.left) <= 1) {
183
- programmaticTarget = null;
261
+ if (Math.abs(slideAnchor(slideRect) - slideAnchor(viewportRect)) <= 1) {
262
+ setMotion({ kind: 'idle' });
184
263
  settledIndex = currentIndex;
185
- deferredExternalIndex = null;
186
- isAutoplayTransitioning = false;
187
264
  return;
188
265
  }
189
- programmaticTarget = currentIndex;
266
+ setMotion({ kind: 'programmatic', target: currentIndex, source });
190
267
  const direction = typeof window !== 'undefined' ? window.getComputedStyle(viewport).direction : 'ltr';
268
+ // RTL is left at its existing left-edge destination — no test coverage to
269
+ // validate a centered RTL destination, matching the snapport-math scoping.
270
+ const centeringOffset = align === 'center' && direction !== 'rtl' ? (viewportRect.width - slideRect.width) / 2 : 0;
191
271
  const destination = direction === 'rtl'
192
272
  ? viewport.scrollLeft + slideRect.left - viewportRect.left
193
- : slide.offsetLeft;
273
+ : slide.offsetLeft - centeringOffset;
194
274
  if (typeof viewport.scrollTo === 'function') {
195
275
  viewport.scrollTo({
196
276
  left: destination,
@@ -202,13 +282,29 @@ function scrollToActiveSlide(behavior) {
202
282
  }
203
283
  }
204
284
  function nearestVisibleSlideIndex(viewport) {
205
- const viewportLeft = viewport.getBoundingClientRect().left;
285
+ // The comparison point is the snapport's leading edge (or, with
286
+ // `align: 'center'`, the viewport's center) — not the border-box edge —
287
+ // since a consumer-set `scroll-padding-inline-start` shrinks where a
288
+ // slide reads as "nearest". RTL stays at the border-box edge — no
289
+ // existing consumer sets scroll-padding, and there's no test coverage to
290
+ // validate a physical-side mapping for it yet.
291
+ const viewportRect = viewport.getBoundingClientRect();
292
+ const computed = typeof window !== 'undefined' ? window.getComputedStyle(viewport) : null;
293
+ const scrollPaddingInlineStart = computed
294
+ ? Number.parseFloat(computed.scrollPaddingInlineStart)
295
+ : Number.NaN;
296
+ const referencePoint = align === 'center'
297
+ ? viewportRect.left + viewportRect.width / 2
298
+ : computed?.direction !== 'rtl' && Number.isFinite(scrollPaddingInlineStart)
299
+ ? viewportRect.left + scrollPaddingInlineStart
300
+ : viewportRect.left;
206
301
  return [...viewport.children].reduce((nearestIndex, slide, index) => {
207
302
  const nearest = viewport.children[nearestIndex];
208
303
  if (!nearest)
209
304
  return index;
210
- return Math.abs(slide.getBoundingClientRect().left - viewportLeft) <
211
- Math.abs(nearest.getBoundingClientRect().left - viewportLeft)
305
+ const slidePoint = slideAnchor(slide.getBoundingClientRect());
306
+ const nearestPoint = slideAnchor(nearest.getBoundingClientRect());
307
+ return Math.abs(slidePoint - referencePoint) < Math.abs(nearestPoint - referencePoint)
212
308
  ? index
213
309
  : nearestIndex;
214
310
  }, 0);
@@ -228,10 +324,31 @@ const observeViewport = useResizeObserver((entries) => {
228
324
  if (inlineSize === cachedViewportInlineSize)
229
325
  return;
230
326
  cachedViewportInlineSize = inlineSize;
231
- if (!isInteracting && !isNativeScrolling && activePointerIds.size === 0) {
327
+ if (activePointerIds.size === 0 && motion.kind !== 'user') {
232
328
  scrollToActiveSlide('auto');
233
329
  }
234
330
  });
331
+ function getSlideSnapPositions() {
332
+ const viewport = viewportElement;
333
+ if (viewport === null)
334
+ return [];
335
+ return [...viewport.children].map((child) => {
336
+ const slide = child;
337
+ if (align !== 'center')
338
+ return slide.offsetLeft;
339
+ return slide.offsetLeft - (viewport.clientWidth - slide.offsetWidth) / 2;
340
+ });
341
+ }
342
+ // Fine-pointer (mouse) drag-to-scroll. Touch/pen are unaffected — they
343
+ // already pan the native scroller directly (see `onPointerDown` below).
344
+ // Reduced motion disables the engine entirely rather than just shortening
345
+ // durations: momentum and rubber-band are exactly the inertial motion that
346
+ // preference is about, and native scrolling with CSS snap stays fully
347
+ // usable without it.
348
+ const dragScroll = useDragScroll({
349
+ enabled: () => finePointer.current && !reducedMotion.current,
350
+ getSnapPositions: getSlideSnapPositions,
351
+ });
235
352
  function removePointerEndListeners() {
236
353
  if (typeof window === 'undefined')
237
354
  return;
@@ -240,29 +357,70 @@ function removePointerEndListeners() {
240
357
  }
241
358
  function finishPointerInteraction(event) {
242
359
  if (event.type === 'pointercancel') {
243
- scheduleNativeScrollEnd();
360
+ // A cancelled gesture still needs a settle grace period before autoplay
361
+ // resumes, even if no scroll event ever fired — which also means no
362
+ // `scrollend` will ever fire, so this can't defer to the native path
363
+ // the way a real scroll can.
364
+ if (motion.kind !== 'user')
365
+ observedActiveIndex = currentIndex;
366
+ setMotion({ kind: 'user', source: 'touch' });
367
+ scheduleFallbackSettle();
244
368
  }
245
369
  activePointerIds.delete(event.pointerId);
246
370
  if (activePointerIds.size > 0)
247
371
  return;
248
- isInteracting = false;
249
372
  removePointerEndListeners();
250
- if (isNativeScrolling)
373
+ if (motion.kind === 'user')
251
374
  scheduleNativeScrollEnd();
252
375
  }
376
+ function handleSettle() {
377
+ if (nativeScrollEndTimer !== null) {
378
+ clearTimeout(nativeScrollEndTimer);
379
+ nativeScrollEndTimer = null;
380
+ }
381
+ if (activePointerIds.size > 0)
382
+ return;
383
+ if (motion.kind !== 'user')
384
+ return;
385
+ setMotion({ kind: 'idle' });
386
+ if (viewportElement === null)
387
+ return;
388
+ if (currentIndex !== observedActiveIndex) {
389
+ // An external `activeIndex` update landed mid-gesture; it wins over
390
+ // wherever the finger physically settled, since it reflects a more
391
+ // recent, deliberate change than the in-flight drag.
392
+ settledIndex = currentIndex;
393
+ visualIndex = currentIndex;
394
+ scrollToActiveSlide('auto');
395
+ return;
396
+ }
397
+ const nextIndex = nearestVisibleSlideIndex(viewportElement);
398
+ settledIndex = nextIndex;
399
+ visualIndex = nextIndex;
400
+ if (nextIndex !== currentIndex && nextIndex >= 0 && nextIndex < clampedLength) {
401
+ transferFocusFromOutgoingSlide();
402
+ activeIndex = nextIndex;
403
+ const slide = slides[nextIndex];
404
+ if (slide)
405
+ onSlideChange?.(nextIndex, slide);
406
+ }
407
+ }
408
+ // Tier 2 (PLATFORM-POLICY.md): native `scrollend` owns settle detection when
409
+ // the viewport supports it (wired below); this debounce is the required
410
+ // fallback for environments without it (and stays the only path in tests,
411
+ // since happy-dom has no `onscrollend`).
253
412
  function scheduleNativeScrollEnd() {
254
- isNativeScrolling = true;
413
+ if (viewportElement !== null && 'onscrollend' in viewportElement)
414
+ return;
415
+ scheduleFallbackSettle();
416
+ }
417
+ // Unconditional variant of the debounce above, for settle paths that don't
418
+ // guarantee a resulting scroll (and therefore can't rely on `scrollend`
419
+ // ever firing) — a cancelled gesture with no scroll delta is the case.
420
+ function scheduleFallbackSettle() {
255
421
  if (nativeScrollEndTimer !== null)
256
422
  clearTimeout(nativeScrollEndTimer);
257
- nativeScrollEndTimer = setTimeout(() => {
258
- nativeScrollEndTimer = null;
259
- if (activePointerIds.size > 0)
260
- return;
261
- isNativeScrolling = false;
262
- settledIndex = viewportElement ? nearestVisibleSlideIndex(viewportElement) : currentIndex;
263
- if (programmaticTarget === null)
264
- isAutoplayTransitioning = false;
265
- }, 100);
423
+ nativeScrollEndTimer = setTimeout(handleSettle, 100);
266
424
  }
267
425
  function onPointerDown(event) {
268
426
  // Only touch and pen pointers can pan the native scroller. A mouse press
@@ -272,9 +430,9 @@ function onPointerDown(event) {
272
430
  // height for the duration of an ordinary click.
273
431
  if (event.pointerType !== 'touch' && event.pointerType !== 'pen')
274
432
  return;
275
- programmaticTarget = null;
276
- isAutoplayTransitioning = false;
277
- isInteracting = true;
433
+ // A pointer taking over always cancels any in-flight programmatic scroll.
434
+ if (motion.kind === 'programmatic')
435
+ setMotion({ kind: 'idle' });
278
436
  activePointerIds.add(event.pointerId);
279
437
  removePointerEndListeners();
280
438
  window.addEventListener('pointerup', finishPointerInteraction);
@@ -284,27 +442,29 @@ function onWheel(event) {
284
442
  const isHorizontallyDominant = Math.abs(event.deltaX) > Math.abs(event.deltaY);
285
443
  const isShiftScroll = event.shiftKey && Math.abs(event.deltaY) > 0;
286
444
  if (isHorizontallyDominant || isShiftScroll) {
287
- programmaticTarget = null;
288
- isAutoplayTransitioning = false;
445
+ if (motion.kind !== 'user')
446
+ observedActiveIndex = currentIndex;
447
+ setMotion({ kind: 'user', source: 'wheel' });
289
448
  scheduleNativeScrollEnd();
290
449
  }
291
450
  }
292
451
  function onWindowBlur() {
293
- const wasInteracting = isInteracting;
294
- const wasNativeScrolling = isNativeScrolling;
452
+ const hadPointers = activePointerIds.size > 0;
453
+ const wasUserMotion = motion.kind === 'user';
295
454
  activePointerIds.clear();
296
- isInteracting = false;
297
455
  removePointerEndListeners();
298
- if (wasNativeScrolling)
299
- scheduleNativeScrollEnd();
456
+ // Same reasoning as the pointercancel path: blur can interrupt a drag
457
+ // before any scroll has actually happened, so `scrollend` isn't
458
+ // guaranteed to ever fire.
459
+ if (wasUserMotion)
460
+ scheduleFallbackSettle();
300
461
  // Only relinquish programmatic/autoplay ownership if blur is actually
301
462
  // ending a tracked pointer interaction. An unrelated blur (e.g. focusing
302
463
  // browser chrome while a dot or autoplay transition is animating) must
303
464
  // not cancel that in-flight destination, or a subsequent intermediate
304
465
  // scroll event gets misread as native input and overwrites activeIndex.
305
- if (wasInteracting) {
306
- programmaticTarget = null;
307
- isAutoplayTransitioning = false;
466
+ if (hadPointers && motion.kind === 'programmatic') {
467
+ setMotion({ kind: 'idle' });
308
468
  }
309
469
  }
310
470
  $effect(() => {
@@ -324,29 +484,39 @@ function onViewportScroll() {
324
484
  const viewport = viewportElement;
325
485
  if (clampedLength < 2 || viewport === null)
326
486
  return;
487
+ if (motion.kind === 'programmatic') {
488
+ // Detect early arrival at the destination — the layout window and
489
+ // motion state can clear as soon as the geometry shows we're there,
490
+ // without waiting for the settle debounce/scrollend.
491
+ if (scrollFrame !== null)
492
+ return;
493
+ scrollFrame = requestAnimationFrame(() => {
494
+ scrollFrame = null;
495
+ const nextIndex = nearestVisibleSlideIndex(viewport);
496
+ visualIndex = nextIndex;
497
+ if (motion.kind === 'programmatic' && nextIndex === motion.target) {
498
+ settledIndex = nextIndex;
499
+ setMotion({ kind: 'idle' });
500
+ }
501
+ });
502
+ return;
503
+ }
504
+ if (motion.kind !== 'user') {
505
+ // A native `scroll` event carries no pointer-type info of its own —
506
+ // `useDragScroll` flags an active mouse drag on the node it's attached
507
+ // to, so that's the one case distinguishable from a touch pan here.
508
+ const source = viewport.hasAttribute('data-cinder-dragging')
509
+ ? 'drag'
510
+ : 'touch';
511
+ setMotion({ kind: 'user', source });
512
+ observedActiveIndex = currentIndex;
513
+ }
327
514
  scheduleNativeScrollEnd();
328
515
  if (scrollFrame !== null)
329
516
  return;
330
517
  scrollFrame = requestAnimationFrame(() => {
331
518
  scrollFrame = null;
332
- const nextIndex = nearestVisibleSlideIndex(viewport);
333
- if (programmaticTarget !== null) {
334
- if (nextIndex === programmaticTarget) {
335
- programmaticTarget = null;
336
- settledIndex = nextIndex;
337
- isAutoplayTransitioning = false;
338
- if (deferredExternalIndex === nextIndex)
339
- deferredExternalIndex = null;
340
- }
341
- return;
342
- }
343
- if (nextIndex !== currentIndex && nextIndex >= 0 && nextIndex < clampedLength) {
344
- if (deferredExternalIndex !== null)
345
- return;
346
- transferFocusFromOutgoingSlide();
347
- internalActiveIndexUpdate = nextIndex;
348
- activeIndex = nextIndex;
349
- }
519
+ visualIndex = nearestVisibleSlideIndex(viewport);
350
520
  });
351
521
  }
352
522
  function transferFocusFromOutgoingSlide() {
@@ -363,7 +533,7 @@ function transferFocusFromOutgoingSlide() {
363
533
  $effect(() => {
364
534
  if (viewportElement === null || clampedLength < 1)
365
535
  return;
366
- if (isInteracting || isNativeScrolling || activePointerIds.size > 0)
536
+ if (motion.kind === 'user' || activePointerIds.size > 0)
367
537
  return;
368
538
  const identityChanged = slideIdentity !== previousSlideIdentity;
369
539
  previousSlideIdentity = slideIdentity;
@@ -379,31 +549,21 @@ $effect(() => {
379
549
  scrollToActiveSlide();
380
550
  });
381
551
  $effect(() => {
382
- const index = currentIndex;
383
- if (index === observedActiveIndex)
384
- return;
385
- const isInternalUpdate = internalActiveIndexUpdate === index;
386
- internalActiveIndexUpdate = null;
387
- observedActiveIndex = index;
388
- if (!isInternalUpdate && (isInteracting || isNativeScrolling)) {
389
- deferredExternalIndex = index;
390
- }
552
+ const viewport = viewportElement;
553
+ if (viewport === null || !('onscrollend' in viewport))
554
+ return;
555
+ viewport.addEventListener('scrollend', handleSettle);
556
+ return () => viewport.removeEventListener('scrollend', handleSettle);
391
557
  });
392
558
  $effect(() => {
393
559
  const viewport = viewportElement;
394
- if (viewport === null || typeof MutationObserver === 'undefined')
560
+ if (viewport === null)
395
561
  return;
396
- const observer = new MutationObserver(() => {
397
- if (isInteracting || isNativeScrolling || activePointerIds.size > 0)
562
+ return observeTextDirection(viewport, () => {
563
+ if (motion.kind === 'user' || activePointerIds.size > 0)
398
564
  return;
399
565
  scrollToActiveSlide('auto');
400
566
  });
401
- let ancestor = viewport;
402
- while (ancestor !== null) {
403
- observer.observe(ancestor, { attributes: true, attributeFilter: ['dir'] });
404
- ancestor = ancestor.parentElement;
405
- }
406
- return () => observer.disconnect();
407
567
  });
408
568
  </script>
409
569
 
@@ -415,10 +575,13 @@ $effect(() => {
415
575
  aria-label={label}
416
576
  aria-describedby={description ? descriptionId : undefined}
417
577
  tabindex="0"
578
+ data-cinder-align={align === 'center' ? 'center' : undefined}
579
+ style:--cinder-carousel-slide-size={resolvedSlideSize}
580
+ style:--cinder-carousel-gap={isMultiView ? gap : undefined}
418
581
  onkeydown={onKeydown}
419
- onmouseenter={() => (isHovered = true)}
420
- onmouseleave={() => (isHovered = false)}
421
- onfocusin={() => (hasFocusWithin = true)}
582
+ onmouseenter={onMouseEnter}
583
+ onmouseleave={onMouseLeave}
584
+ onfocusin={onFocusIn}
422
585
  onfocusout={onFocusOut}
423
586
  >
424
587
  {#if description}
@@ -426,7 +589,9 @@ $effect(() => {
426
589
  {/if}
427
590
  <p
428
591
  class="cinder-carousel__sr-only"
429
- aria-live={shouldAutoplay || isAutoplayTransitioning ? 'off' : 'polite'}
592
+ aria-live={shouldAutoplay || (motion.kind === 'programmatic' && motion.source === 'autoplay')
593
+ ? 'off'
594
+ : 'polite'}
430
595
  aria-atomic="true"
431
596
  >
432
597
  {liveAnnouncement}
@@ -439,7 +604,9 @@ $effect(() => {
439
604
  aria-label={`${label} slides`}
440
605
  tabindex="0"
441
606
  bind:this={viewportElement}
607
+ style:gap={isMultiView ? 'var(--cinder-carousel-gap, var(--cinder-space-3))' : undefined}
442
608
  {@attach observeViewport}
609
+ {@attach dragScroll}
443
610
  onscroll={onViewportScroll}
444
611
  onpointerdown={onPointerDown}
445
612
  onwheel={onWheel}
@@ -451,19 +618,21 @@ $effect(() => {
451
618
  role="group"
452
619
  aria-roledescription="slide"
453
620
  aria-label={`${index + 1} of ${slides.length}: ${slide.label}`}
454
- aria-hidden={index === currentIndex ? undefined : 'true'}
455
- inert={index !== currentIndex}
621
+ aria-hidden={isSlideInRange(index) ? undefined : 'true'}
622
+ inert={!isSlideInRange(index)}
456
623
  data-cinder-collapsed={!isInteractionLayoutSlide(index) ? '' : undefined}
457
624
  style:order={initialSlideOrder(index)}
458
625
  >
459
- {#if slide.href}
626
+ {#if slideSnippet}
627
+ {@render slideSnippet(slide, { index, active: isSlideInRange(index) })}
628
+ {:else if slide.href}
460
629
  <a class="cinder-carousel__link" href={slide.href}>
461
630
  {#if slide.imageSrc}
462
631
  <img
463
632
  class="cinder-carousel__image"
464
633
  src={slide.imageSrc}
465
634
  alt={slide.imageAlt ?? slide.title ?? slide.label}
466
- loading={index === currentIndex ? 'eager' : 'lazy'}
635
+ loading={isSlideInRange(index) ? 'eager' : 'lazy'}
467
636
  />
468
637
  {/if}
469
638
  {#if slide.title}
@@ -482,7 +651,7 @@ $effect(() => {
482
651
  class="cinder-carousel__image"
483
652
  src={slide.imageSrc}
484
653
  alt={slide.imageAlt ?? slide.title ?? slide.label}
485
- loading={index === currentIndex ? 'eager' : 'lazy'}
654
+ loading={isSlideInRange(index) ? 'eager' : 'lazy'}
486
655
  />
487
656
  {/if}
488
657
  {#if slide.title}
@@ -505,16 +674,16 @@ $effect(() => {
505
674
  <button
506
675
  type="button"
507
676
  class="cinder-carousel__control"
508
- onclick={goPrevious}
509
- disabled={slides.length < 2}
677
+ onclick={() => goPrevious('control')}
678
+ disabled={slides.length < 2 || isAtStart}
510
679
  >
511
680
  {controlLabels?.previous ?? 'Previous'}
512
681
  </button>
513
682
  <button
514
683
  type="button"
515
684
  class="cinder-carousel__control"
516
- onclick={() => goNext()}
517
- disabled={slides.length < 2}
685
+ onclick={() => goNext('control')}
686
+ disabled={slides.length < 2 || isAtEnd}
518
687
  >
519
688
  {controlLabels?.next ?? 'Next'}
520
689
  </button>
@@ -531,20 +700,26 @@ $effect(() => {
531
700
  </button>
532
701
  {/if}
533
702
 
534
- <div
535
- class="cinder-carousel__dots"
536
- role="group"
537
- aria-label={controlLabels?.picker ?? 'Choose slide'}
538
- >
539
- {#each slides as slide, index (slide.id)}
540
- <button
541
- type="button"
542
- class="cinder-carousel__dot"
543
- aria-label={`Go to ${slide.label}`}
544
- aria-current={index === currentIndex ? 'true' : undefined}
545
- onclick={() => goTo(index)}
546
- ></button>
547
- {/each}
548
- </div>
703
+ {#if resolvedIndicators === 'dots'}
704
+ <div
705
+ class="cinder-carousel__dots"
706
+ role="group"
707
+ aria-label={controlLabels?.picker ?? 'Choose slide'}
708
+ >
709
+ {#each slides as slide, index (slide.id)}
710
+ <button
711
+ type="button"
712
+ class="cinder-carousel__dot"
713
+ aria-label={`Go to ${slide.label}`}
714
+ aria-current={index === displayIndex ? 'true' : undefined}
715
+ onclick={() => goTo(index, undefined, 'control')}
716
+ ></button>
717
+ {/each}
718
+ </div>
719
+ {:else if resolvedIndicators === 'counter'}
720
+ <div class="cinder-carousel__counter" aria-hidden="true">
721
+ {displayIndex + 1} / {clampedLength}
722
+ </div>
723
+ {/if}
549
724
  </div>
550
725
  </section>