stimeo-ui 0.14.0 → 0.16.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 (279) hide show
  1. package/CHANGELOG.md +212 -0
  2. package/README.md +120 -0
  3. package/dist/cable/index.js +123 -29
  4. package/dist/cable/index.js.map +1 -1
  5. package/dist/controllers/accordion_controller.d.ts +30 -3
  6. package/dist/controllers/accordion_controller.js +98 -9
  7. package/dist/controllers/accordion_controller.js.map +1 -1
  8. package/dist/controllers/alert_dialog_controller.d.ts +8 -7
  9. package/dist/controllers/alert_dialog_controller.js.map +1 -1
  10. package/dist/controllers/announcer_controller.d.ts +3 -2
  11. package/dist/controllers/announcer_controller.js +96 -62
  12. package/dist/controllers/announcer_controller.js.map +1 -1
  13. package/dist/controllers/auto_submit_controller.js +83 -7
  14. package/dist/controllers/auto_submit_controller.js.map +1 -1
  15. package/dist/controllers/avatar_controller.js +1 -1
  16. package/dist/controllers/avatar_controller.js.map +1 -1
  17. package/dist/controllers/breadcrumb_controller.d.ts +10 -7
  18. package/dist/controllers/breadcrumb_controller.js +38 -11
  19. package/dist/controllers/breadcrumb_controller.js.map +1 -1
  20. package/dist/controllers/bulk_select_controller.d.ts +4 -4
  21. package/dist/controllers/bulk_select_controller.js +7 -6
  22. package/dist/controllers/bulk_select_controller.js.map +1 -1
  23. package/dist/controllers/calendar_controller.d.ts +101 -23
  24. package/dist/controllers/calendar_controller.js +340 -123
  25. package/dist/controllers/calendar_controller.js.map +1 -1
  26. package/dist/controllers/carousel_controller.d.ts +67 -22
  27. package/dist/controllers/carousel_controller.js +263 -38
  28. package/dist/controllers/carousel_controller.js.map +1 -1
  29. package/dist/controllers/character_counter_controller.d.ts +1 -1
  30. package/dist/controllers/character_counter_controller.js +40 -2
  31. package/dist/controllers/character_counter_controller.js.map +1 -1
  32. package/dist/controllers/checkbox_controller.js +81 -12
  33. package/dist/controllers/checkbox_controller.js.map +1 -1
  34. package/dist/controllers/clipboard_controller.d.ts +28 -2
  35. package/dist/controllers/clipboard_controller.js +63 -5
  36. package/dist/controllers/clipboard_controller.js.map +1 -1
  37. package/dist/controllers/collapsible_controller.d.ts +25 -1
  38. package/dist/controllers/collapsible_controller.js +99 -14
  39. package/dist/controllers/collapsible_controller.js.map +1 -1
  40. package/dist/controllers/color_picker_controller.d.ts +29 -8
  41. package/dist/controllers/color_picker_controller.js +80 -34
  42. package/dist/controllers/color_picker_controller.js.map +1 -1
  43. package/dist/controllers/combobox_controller.d.ts +10 -1
  44. package/dist/controllers/combobox_controller.js +106 -16
  45. package/dist/controllers/combobox_controller.js.map +1 -1
  46. package/dist/controllers/command_palette_controller.d.ts +3 -3
  47. package/dist/controllers/command_palette_controller.js +35 -3
  48. package/dist/controllers/command_palette_controller.js.map +1 -1
  49. package/dist/controllers/conditional_fields_controller.js +85 -17
  50. package/dist/controllers/conditional_fields_controller.js.map +1 -1
  51. package/dist/controllers/confirm_controller.js +3 -0
  52. package/dist/controllers/confirm_controller.js.map +1 -1
  53. package/dist/controllers/context_menu_controller.d.ts +6 -0
  54. package/dist/controllers/context_menu_controller.js +32 -12
  55. package/dist/controllers/context_menu_controller.js.map +1 -1
  56. package/dist/controllers/count_up_controller.js.map +1 -1
  57. package/dist/controllers/countdown_controller.d.ts +30 -1
  58. package/dist/controllers/countdown_controller.js +129 -26
  59. package/dist/controllers/countdown_controller.js.map +1 -1
  60. package/dist/controllers/currency_input_controller.d.ts +77 -16
  61. package/dist/controllers/currency_input_controller.js +221 -67
  62. package/dist/controllers/currency_input_controller.js.map +1 -1
  63. package/dist/controllers/data_grid_controller.d.ts +63 -18
  64. package/dist/controllers/data_grid_controller.js +195 -29
  65. package/dist/controllers/data_grid_controller.js.map +1 -1
  66. package/dist/controllers/date_range_picker_controller.d.ts +41 -6
  67. package/dist/controllers/date_range_picker_controller.js +151 -30
  68. package/dist/controllers/date_range_picker_controller.js.map +1 -1
  69. package/dist/controllers/dialog_controller.d.ts +10 -3
  70. package/dist/controllers/dialog_controller.js +35 -8
  71. package/dist/controllers/dialog_controller.js.map +1 -1
  72. package/dist/controllers/direct_upload_controller.js +22 -4
  73. package/dist/controllers/direct_upload_controller.js.map +1 -1
  74. package/dist/controllers/dirty_form_controller.d.ts +2 -2
  75. package/dist/controllers/dirty_form_controller.js +46 -13
  76. package/dist/controllers/dirty_form_controller.js.map +1 -1
  77. package/dist/controllers/dismissible_controller.js +1 -0
  78. package/dist/controllers/dismissible_controller.js.map +1 -1
  79. package/dist/controllers/drawer_controller.d.ts +18 -10
  80. package/dist/controllers/drawer_controller.js +54 -19
  81. package/dist/controllers/drawer_controller.js.map +1 -1
  82. package/dist/controllers/dropdown_controller.d.ts +9 -3
  83. package/dist/controllers/dropdown_controller.js +36 -9
  84. package/dist/controllers/dropdown_controller.js.map +1 -1
  85. package/dist/controllers/editable_controller.js +34 -0
  86. package/dist/controllers/editable_controller.js.map +1 -1
  87. package/dist/controllers/file_dropzone_controller.js +144 -51
  88. package/dist/controllers/file_dropzone_controller.js.map +1 -1
  89. package/dist/controllers/filter_controller.d.ts +10 -4
  90. package/dist/controllers/filter_controller.js +20 -6
  91. package/dist/controllers/filter_controller.js.map +1 -1
  92. package/dist/controllers/flash_controller.d.ts +26 -6
  93. package/dist/controllers/flash_controller.js +432 -71
  94. package/dist/controllers/flash_controller.js.map +1 -1
  95. package/dist/controllers/focus_controller.js +1 -0
  96. package/dist/controllers/focus_controller.js.map +1 -1
  97. package/dist/controllers/form_field_controller.js +7 -5
  98. package/dist/controllers/form_field_controller.js.map +1 -1
  99. package/dist/controllers/form_validation_controller.js +19 -13
  100. package/dist/controllers/form_validation_controller.js.map +1 -1
  101. package/dist/controllers/frame_loading_controller.js +45 -8
  102. package/dist/controllers/frame_loading_controller.js.map +1 -1
  103. package/dist/controllers/highlight_controller.js +82 -25
  104. package/dist/controllers/highlight_controller.js.map +1 -1
  105. package/dist/controllers/hover_card_controller.d.ts +10 -2
  106. package/dist/controllers/hover_card_controller.js +40 -14
  107. package/dist/controllers/hover_card_controller.js.map +1 -1
  108. package/dist/controllers/idle_controller.d.ts +16 -3
  109. package/dist/controllers/idle_controller.js +90 -5
  110. package/dist/controllers/idle_controller.js.map +1 -1
  111. package/dist/controllers/input_mask_controller.d.ts +5 -2
  112. package/dist/controllers/input_mask_controller.js +65 -9
  113. package/dist/controllers/input_mask_controller.js.map +1 -1
  114. package/dist/controllers/intersection_controller.js +3 -0
  115. package/dist/controllers/intersection_controller.js.map +1 -1
  116. package/dist/controllers/lazy_frame_controller.js +11 -2
  117. package/dist/controllers/lazy_frame_controller.js.map +1 -1
  118. package/dist/controllers/listbox_controller.d.ts +50 -8
  119. package/dist/controllers/listbox_controller.js +203 -45
  120. package/dist/controllers/listbox_controller.js.map +1 -1
  121. package/dist/controllers/local_time_controller.js +10 -5
  122. package/dist/controllers/local_time_controller.js.map +1 -1
  123. package/dist/controllers/masonry_controller.d.ts +3 -3
  124. package/dist/controllers/masonry_controller.js +31 -15
  125. package/dist/controllers/masonry_controller.js.map +1 -1
  126. package/dist/controllers/menu_controller.d.ts +9 -3
  127. package/dist/controllers/menu_controller.js +45 -16
  128. package/dist/controllers/menu_controller.js.map +1 -1
  129. package/dist/controllers/menubar_controller.d.ts +11 -0
  130. package/dist/controllers/menubar_controller.js +58 -24
  131. package/dist/controllers/menubar_controller.js.map +1 -1
  132. package/dist/controllers/meter_controller.js +9 -5
  133. package/dist/controllers/meter_controller.js.map +1 -1
  134. package/dist/controllers/multi_select_controller.d.ts +18 -3
  135. package/dist/controllers/multi_select_controller.js +278 -104
  136. package/dist/controllers/multi_select_controller.js.map +1 -1
  137. package/dist/controllers/navigation_menu_controller.d.ts +11 -0
  138. package/dist/controllers/navigation_menu_controller.js +48 -15
  139. package/dist/controllers/navigation_menu_controller.js.map +1 -1
  140. package/dist/controllers/nested_form_controller.js +37 -8
  141. package/dist/controllers/nested_form_controller.js.map +1 -1
  142. package/dist/controllers/network_status_controller.js +9 -1
  143. package/dist/controllers/network_status_controller.js.map +1 -1
  144. package/dist/controllers/number_input_controller.d.ts +36 -8
  145. package/dist/controllers/number_input_controller.js +124 -21
  146. package/dist/controllers/number_input_controller.js.map +1 -1
  147. package/dist/controllers/optimistic_controller.js +42 -5
  148. package/dist/controllers/optimistic_controller.js.map +1 -1
  149. package/dist/controllers/otp_controller.d.ts +22 -7
  150. package/dist/controllers/otp_controller.js +198 -55
  151. package/dist/controllers/otp_controller.js.map +1 -1
  152. package/dist/controllers/overflow_indicator_controller.d.ts +8 -12
  153. package/dist/controllers/overflow_indicator_controller.js +115 -21
  154. package/dist/controllers/overflow_indicator_controller.js.map +1 -1
  155. package/dist/controllers/overflow_menu_controller.d.ts +26 -6
  156. package/dist/controllers/overflow_menu_controller.js +141 -44
  157. package/dist/controllers/overflow_menu_controller.js.map +1 -1
  158. package/dist/controllers/pagination_controller.d.ts +19 -11
  159. package/dist/controllers/pagination_controller.js +74 -28
  160. package/dist/controllers/pagination_controller.js.map +1 -1
  161. package/dist/controllers/password_reveal_controller.d.ts +15 -1
  162. package/dist/controllers/password_reveal_controller.js +59 -2
  163. package/dist/controllers/password_reveal_controller.js.map +1 -1
  164. package/dist/controllers/persist_controller.js +30 -8
  165. package/dist/controllers/persist_controller.js.map +1 -1
  166. package/dist/controllers/pointer_drag_controller.js +131 -52
  167. package/dist/controllers/pointer_drag_controller.js.map +1 -1
  168. package/dist/controllers/popover_controller.d.ts +9 -3
  169. package/dist/controllers/popover_controller.js +45 -11
  170. package/dist/controllers/popover_controller.js.map +1 -1
  171. package/dist/controllers/portal_controller.d.ts +1 -1
  172. package/dist/controllers/portal_controller.js +6 -2
  173. package/dist/controllers/portal_controller.js.map +1 -1
  174. package/dist/controllers/preview_guard_controller.js +16 -1
  175. package/dist/controllers/preview_guard_controller.js.map +1 -1
  176. package/dist/controllers/progress_controller.js +8 -4
  177. package/dist/controllers/progress_controller.js.map +1 -1
  178. package/dist/controllers/radio_group_controller.d.ts +6 -4
  179. package/dist/controllers/radio_group_controller.js +42 -17
  180. package/dist/controllers/radio_group_controller.js.map +1 -1
  181. package/dist/controllers/range_slider_controller.d.ts +49 -1
  182. package/dist/controllers/range_slider_controller.js +88 -42
  183. package/dist/controllers/range_slider_controller.js.map +1 -1
  184. package/dist/controllers/rating_controller.d.ts +14 -3
  185. package/dist/controllers/rating_controller.js +39 -15
  186. package/dist/controllers/rating_controller.js.map +1 -1
  187. package/dist/controllers/read_more_controller.d.ts +24 -2
  188. package/dist/controllers/read_more_controller.js +100 -7
  189. package/dist/controllers/read_more_controller.js.map +1 -1
  190. package/dist/controllers/reading_progress_controller.js +65 -19
  191. package/dist/controllers/reading_progress_controller.js.map +1 -1
  192. package/dist/controllers/relative_time_controller.js +10 -5
  193. package/dist/controllers/relative_time_controller.js.map +1 -1
  194. package/dist/controllers/resizable_controller.d.ts +16 -2
  195. package/dist/controllers/resizable_controller.js +82 -22
  196. package/dist/controllers/resizable_controller.js.map +1 -1
  197. package/dist/controllers/scroll_area_controller.js +75 -27
  198. package/dist/controllers/scroll_area_controller.js.map +1 -1
  199. package/dist/controllers/scroll_restore_controller.js +37 -16
  200. package/dist/controllers/scroll_restore_controller.js.map +1 -1
  201. package/dist/controllers/scroll_visibility_controller.js +49 -30
  202. package/dist/controllers/scroll_visibility_controller.js.map +1 -1
  203. package/dist/controllers/scrollspy_controller.d.ts +3 -2
  204. package/dist/controllers/scrollspy_controller.js +71 -26
  205. package/dist/controllers/scrollspy_controller.js.map +1 -1
  206. package/dist/controllers/separator_controller.d.ts +41 -14
  207. package/dist/controllers/separator_controller.js +66 -37
  208. package/dist/controllers/separator_controller.js.map +1 -1
  209. package/dist/controllers/sidebar_controller.d.ts +20 -3
  210. package/dist/controllers/sidebar_controller.js +77 -18
  211. package/dist/controllers/sidebar_controller.js.map +1 -1
  212. package/dist/controllers/skeleton_controller.js +6 -1
  213. package/dist/controllers/skeleton_controller.js.map +1 -1
  214. package/dist/controllers/slider_controller.d.ts +45 -7
  215. package/dist/controllers/slider_controller.js +82 -47
  216. package/dist/controllers/slider_controller.js.map +1 -1
  217. package/dist/controllers/smart_sticky_header_controller.js +60 -26
  218. package/dist/controllers/smart_sticky_header_controller.js.map +1 -1
  219. package/dist/controllers/sortable_controller.js +17 -2
  220. package/dist/controllers/sortable_controller.js.map +1 -1
  221. package/dist/controllers/spinner_controller.js +10 -2
  222. package/dist/controllers/spinner_controller.js.map +1 -1
  223. package/dist/controllers/step_indicator_controller.d.ts +19 -17
  224. package/dist/controllers/step_indicator_controller.js +18 -17
  225. package/dist/controllers/step_indicator_controller.js.map +1 -1
  226. package/dist/controllers/stepper_controller.d.ts +34 -9
  227. package/dist/controllers/stepper_controller.js +101 -19
  228. package/dist/controllers/stepper_controller.js.map +1 -1
  229. package/dist/controllers/stick_to_bottom_controller.d.ts +19 -0
  230. package/dist/controllers/stick_to_bottom_controller.js +104 -8
  231. package/dist/controllers/stick_to_bottom_controller.js.map +1 -1
  232. package/dist/controllers/submit_once_controller.d.ts +3 -2
  233. package/dist/controllers/submit_once_controller.js +45 -9
  234. package/dist/controllers/submit_once_controller.js.map +1 -1
  235. package/dist/controllers/switch_controller.d.ts +29 -7
  236. package/dist/controllers/switch_controller.js +101 -10
  237. package/dist/controllers/switch_controller.js.map +1 -1
  238. package/dist/controllers/tabs_controller.d.ts +12 -0
  239. package/dist/controllers/tabs_controller.js +21 -2
  240. package/dist/controllers/tabs_controller.js.map +1 -1
  241. package/dist/controllers/tags_input_controller.d.ts +15 -3
  242. package/dist/controllers/tags_input_controller.js +209 -59
  243. package/dist/controllers/tags_input_controller.js.map +1 -1
  244. package/dist/controllers/textarea_autosize_controller.js +29 -3
  245. package/dist/controllers/textarea_autosize_controller.js.map +1 -1
  246. package/dist/controllers/theme_controller.d.ts +20 -3
  247. package/dist/controllers/theme_controller.js +64 -14
  248. package/dist/controllers/theme_controller.js.map +1 -1
  249. package/dist/controllers/time_picker_controller.js +23 -8
  250. package/dist/controllers/time_picker_controller.js.map +1 -1
  251. package/dist/controllers/toast_controller.d.ts +55 -15
  252. package/dist/controllers/toast_controller.js +451 -105
  253. package/dist/controllers/toast_controller.js.map +1 -1
  254. package/dist/controllers/toggle_group_controller.d.ts +49 -7
  255. package/dist/controllers/toggle_group_controller.js +159 -23
  256. package/dist/controllers/toggle_group_controller.js.map +1 -1
  257. package/dist/controllers/toolbar_controller.js +32 -0
  258. package/dist/controllers/toolbar_controller.js.map +1 -1
  259. package/dist/controllers/tooltip_controller.d.ts +8 -0
  260. package/dist/controllers/tooltip_controller.js +39 -13
  261. package/dist/controllers/tooltip_controller.js.map +1 -1
  262. package/dist/controllers/transition_controller.js +4 -0
  263. package/dist/controllers/transition_controller.js.map +1 -1
  264. package/dist/controllers/tree_view_controller.d.ts +39 -8
  265. package/dist/controllers/tree_view_controller.js +169 -16
  266. package/dist/controllers/tree_view_controller.js.map +1 -1
  267. package/dist/index.d.ts +28 -1
  268. package/dist/index.js +5002 -1911
  269. package/dist/index.js.map +1 -1
  270. package/dist/inspector/cli.d.ts +72 -6
  271. package/dist/inspector/cli.js +262 -51
  272. package/dist/inspector/cli.js.map +1 -1
  273. package/dist/inspector/cli_bin.js +309 -51
  274. package/dist/inspector/cli_bin.js.map +1 -1
  275. package/dist/inspector/examples.json +40 -40
  276. package/dist/inspector/manifest.json +529 -61
  277. package/dist/positioning/index.js +2 -0
  278. package/dist/positioning/index.js.map +1 -1
  279. package/package.json +2 -2
@@ -72,7 +72,66 @@ function ownerOf(candidates, node) {
72
72
  return candidates[ownerIndex(candidates, node)] ?? null;
73
73
  }
74
74
 
75
+ // src/utils/owned_pointer_session.ts
76
+ var OwnedPointerSession = class {
77
+ #pointerId;
78
+ #owner;
79
+ #handlers;
80
+ #abort = new AbortController();
81
+ #active = true;
82
+ constructor(start, owner, handlers) {
83
+ this.#pointerId = start.pointerId;
84
+ this.#owner = owner;
85
+ this.#handlers = handlers;
86
+ const { signal } = this.#abort;
87
+ owner.ownerDocument.addEventListener("pointermove", this.#onMove, { signal });
88
+ owner.ownerDocument.addEventListener("pointerup", this.#onEndEvent, { signal });
89
+ owner.ownerDocument.addEventListener("pointercancel", this.#onEndEvent, { signal });
90
+ try {
91
+ owner.setPointerCapture?.(this.#pointerId);
92
+ } catch {
93
+ }
94
+ }
95
+ /** Releases capture and listeners, then reports the end exactly once. */
96
+ end() {
97
+ this.#finish("teardown");
98
+ }
99
+ #finish(kind) {
100
+ if (!this.#active) return;
101
+ this.#active = false;
102
+ this.#abort.abort();
103
+ try {
104
+ this.#owner.releasePointerCapture?.(this.#pointerId);
105
+ } catch {
106
+ }
107
+ this.#handlers.end?.(kind);
108
+ }
109
+ #owns(event) {
110
+ return this.#active && event.pointerId === this.#pointerId;
111
+ }
112
+ #onMove = (event) => {
113
+ if (this.#owns(event)) this.#handlers.move(event);
114
+ };
115
+ #onEndEvent = (event) => {
116
+ if (this.#owns(event)) this.#finish(event.type === "pointerup" ? "up" : "cancel");
117
+ };
118
+ };
119
+
120
+ // src/utils/transient_hooks.ts
121
+ var TransientHooks = class {
122
+ #attributes;
123
+ constructor(options) {
124
+ this.#attributes = options.attributes;
125
+ }
126
+ /** Drops the declared hooks from `element`; what it carries besides stays. */
127
+ reset(element) {
128
+ for (const attribute of this.#attributes) element.removeAttribute(attribute);
129
+ }
130
+ };
131
+
75
132
  // src/controllers/pointer_drag_controller.ts
133
+ var TRANSIENT_DRAG = new TransientHooks({ attributes: ["data-dragging"] });
134
+ var TRANSIENT_GRAB = new TransientHooks({ attributes: ["data-grabbed"] });
76
135
  var NATIVE_KEY_OWNERS = "input, textarea, select, button, a[href], summary, [contenteditable]";
77
136
  var PointerDragController = class _PointerDragController extends Controller {
78
137
  static targets = ["handle"];
@@ -93,14 +152,12 @@ var PointerDragController = class _PointerDragController extends Controller {
93
152
  #keyboard = null;
94
153
  /** Committed follow offset from past drops; a new drag's deltas add onto it. */
95
154
  #followBase = { x: 0, y: 0 };
96
- /** Aborts in-progress pointer-drag listeners on drag end / teardown. */
97
- #dragAbort = null;
98
155
  /** Decides whether a mid-session disconnect() is an in-page move or a detach. */
99
156
  #gate = new DetachGate();
100
157
  connect() {
101
158
  this.#gate.cancel();
102
- if (!this.#pointer) this.element.removeAttribute("data-dragging");
103
- if (!this.#keyboard) this.element.removeAttribute("data-grabbed");
159
+ if (!this.#pointer) TRANSIENT_DRAG.reset(this.element);
160
+ if (!this.#keyboard) TRANSIENT_GRAB.reset(this.element);
104
161
  if (this.followValue && !this.#pointer && !this.#keyboard) {
105
162
  this.#followBase = this.#parseFollowBase();
106
163
  }
@@ -170,15 +227,19 @@ var PointerDragController = class _PointerDragController extends Controller {
170
227
  }
171
228
  this.#teardownSessions();
172
229
  }
173
- /** Arms a pointer drag on a handle; `start` waits for the threshold. */
230
+ /**
231
+ * Arms a pointer drag on a handle; `start` waits for the threshold.
232
+ *
233
+ * @stimeoRuntimeOnly `disabled` decides whether this one pointer press starts a gesture.
234
+ */
174
235
  #onPointerDown = (event) => {
175
236
  if (this.disabledValue || this.#pointer || this.#keyboard || event.button !== 0) return;
176
237
  const handle = this.#handleFor(event.target);
177
238
  if (!handle) return;
178
239
  event.preventDefault();
179
240
  handle.focus();
180
- this.#pointer = {
181
- pointerId: event.pointerId,
241
+ const session = {
242
+ pointer: null,
182
243
  handle,
183
244
  originX: event.clientX,
184
245
  originY: event.clientY,
@@ -187,17 +248,18 @@ var PointerDragController = class _PointerDragController extends Controller {
187
248
  dy: 0,
188
249
  pointerType: this.#pointerTypeOf(event)
189
250
  };
190
- handle.setPointerCapture(event.pointerId);
191
- this.#dragAbort?.abort();
192
- const abort = new AbortController();
193
- this.#dragAbort = abort;
194
- document.addEventListener("pointermove", this.#onPointerMove, { signal: abort.signal });
195
- document.addEventListener("pointerup", this.#onPointerUp, { signal: abort.signal });
196
- document.addEventListener("pointercancel", this.#onPointerCancel, { signal: abort.signal });
251
+ session.pointer = new OwnedPointerSession(event, handle, {
252
+ move: (move) => this.#trackMove(session, move),
253
+ end: (kind) => this.#finishPointer(session, kind)
254
+ });
255
+ this.#pointer = session;
197
256
  };
198
- #onPointerMove = (event) => {
199
- const session = this.#pointer;
200
- if (!session || event.pointerId !== session.pointerId) return;
257
+ /**
258
+ * Applies one tracked move: threshold, hooks, follow offset, events.
259
+ *
260
+ * @stimeoRuntimeOnly `threshold` decides when this one pointer move starts the drag.
261
+ */
262
+ #trackMove(session, event) {
201
263
  const [dx, dy] = this.#filterAxis(
202
264
  event.clientX - session.originX,
203
265
  event.clientY - session.originY
@@ -216,25 +278,32 @@ var PointerDragController = class _PointerDragController extends Controller {
216
278
  this.dispatch("move", {
217
279
  detail: { dx, dy, x: event.clientX, y: event.clientY, pointerType: session.pointerType }
218
280
  });
219
- };
220
- #onPointerUp = (event) => {
221
- const session = this.#pointer;
222
- if (!session || event.pointerId !== session.pointerId) return;
281
+ }
282
+ /**
283
+ * Closes the session and reports only the outcome the caller does not own.
284
+ *
285
+ * A teardown (detach, Escape, mid-drag disable, `reset`) is announced by the
286
+ * path that asked for it, so this one stays silent; `pointerup` below the
287
+ * threshold was a plain click, and `pointercancel` is an OS gesture takeover.
288
+ */
289
+ #finishPointer(session, kind) {
223
290
  const { started, dx, dy, pointerType } = session;
224
- this.#endPointerSession();
225
- if (!started) return;
226
- this.#followCommit(dx, dy);
227
- this.dispatch("end", { detail: { dx, dy, pointerType } });
228
- };
229
- /** OS gesture / scroll takeover interrupted the drag: cancel, don't drop. */
230
- #onPointerCancel = (event) => {
231
- const session = this.#pointer;
232
- if (!session || event.pointerId !== session.pointerId) return;
233
- const { started, pointerType } = session;
234
- this.#endPointerSession();
235
- if (started) this.#dispatchCancel(pointerType);
236
- };
237
- /** Keyboard alternative: Space/Enter grab & drop, arrows move, Escape cancels. */
291
+ this.#pointer = null;
292
+ this.element.removeAttribute("data-dragging");
293
+ if (kind === "teardown" || !started) return;
294
+ if (kind === "up") {
295
+ this.#followCommit(dx, dy);
296
+ this.dispatch("end", { detail: { dx, dy, pointerType } });
297
+ return;
298
+ }
299
+ this.#dispatchCancel(pointerType);
300
+ }
301
+ /**
302
+ * Keyboard alternative: Space/Enter grab & drop, arrows move, Escape cancels.
303
+ *
304
+ * @stimeoRuntimeOnly `disabled` decides whether this one key is taken and `keyboardStep` is the
305
+ * distance of one keyboard move.
306
+ */
238
307
  #onKeydown = (event) => {
239
308
  if (this.disabledValue) return;
240
309
  const handle = this.#handleFor(event.target);
@@ -316,26 +385,19 @@ var PointerDragController = class _PointerDragController extends Controller {
316
385
  return null;
317
386
  }
318
387
  }
319
- /** Zeroes the delta on the locked axis (`axis` = x | y | both). */
388
+ /**
389
+ * Zeroes the delta on the locked axis (`axis` = x | y | both).
390
+ *
391
+ * @stimeoRuntimeOnly `axis` filters the offset of one move to the allowed direction.
392
+ */
320
393
  #filterAxis(dx, dy) {
321
394
  if (this.axisValue === "x") return [dx, 0];
322
395
  if (this.axisValue === "y") return [0, dy];
323
396
  return [dx, dy];
324
397
  }
325
- /** Releases capture + listeners and clears the pointer session and its hook. */
398
+ /** Silently closes a live pointer session; the caller announces the outcome. */
326
399
  #endPointerSession() {
327
- this.#releasePointerCapture();
328
- this.#pointer = null;
329
- this.#dragAbort?.abort();
330
- this.#dragAbort = null;
331
- this.element.removeAttribute("data-dragging");
332
- }
333
- /** Releases the pointer capture the active session set (idempotent, safe). */
334
- #releasePointerCapture() {
335
- const session = this.#pointer;
336
- if (session?.handle.hasPointerCapture(session.pointerId)) {
337
- session.handle.releasePointerCapture(session.pointerId);
338
- }
400
+ this.#pointer?.pointer?.end();
339
401
  }
340
402
  #clearKeyboardSession() {
341
403
  this.#keyboard?.handle.removeAttribute("data-grabbed");
@@ -372,18 +434,33 @@ var PointerDragController = class _PointerDragController extends Controller {
372
434
  this.#followReset();
373
435
  this.dispatch("cancel", { detail: { pointerType } });
374
436
  }
375
- /** Applies the in-flight offset to the element's `translate` (follow only). */
437
+ /**
438
+ * Applies the in-flight offset to the element's `translate` (follow only).
439
+ *
440
+ * @stimeoRuntimeOnly `follow` decides whether this one move writes the offset as a translate; the
441
+ * offset itself comes from the gesture.
442
+ */
376
443
  #followMove(dx, dy) {
377
444
  if (!this.followValue) return;
378
445
  this.#applyFollow(this.#followBase.x + dx, this.#followBase.y + dy);
379
446
  }
380
- /** Folds a drop's deltas into the committed base offset (follow only). */
447
+ /**
448
+ * Folds a drop's deltas into the committed base offset (follow only).
449
+ *
450
+ * @stimeoRuntimeOnly `follow` decides whether the end of this one gesture keeps the offset as a
451
+ * translate.
452
+ */
381
453
  #followCommit(dx, dy) {
382
454
  if (!this.followValue) return;
383
455
  this.#followBase = { x: this.#followBase.x + dx, y: this.#followBase.y + dy };
384
456
  this.#applyFollow(this.#followBase.x, this.#followBase.y);
385
457
  }
386
- /** Snaps back to the committed position (follow only) — the cancel contract. */
458
+ /**
459
+ * Snaps back to the committed position (follow only) — the cancel contract.
460
+ *
461
+ * @stimeoRuntimeOnly `follow` decides whether cancelling this one gesture clears the translate it
462
+ * wrote.
463
+ */
387
464
  #followReset() {
388
465
  if (!this.followValue) return;
389
466
  this.#applyFollow(this.#followBase.x, this.#followBase.y);
@@ -438,6 +515,8 @@ var PointerDragController = class _PointerDragController extends Controller {
438
515
  * idempotent) and focusability for the keyboard path (`tabindex="0"` only when
439
516
  * the author supplied none — prefer a real `<button>` handle). Both additions
440
517
  * are marker-owned so `#restoreHandle` reverts them symmetrically on teardown.
518
+ *
519
+ * @stimeoRenderRoot
441
520
  */
442
521
  #prepareHandle(handle) {
443
522
  const lent = this.#touchActionForAxis();
@@ -1 +1 @@
1
- {"version":3,"sources":["../../src/utils/arrow_step.ts","../../src/utils/detach_gate.ts","../../src/utils/event_owner.ts","../../src/controllers/pointer_drag_controller.ts"],"names":[],"mappings":"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","file":"pointer_drag_controller.js","sourcesContent":["import { isRtl } from \"./logical_scroll\";\n\n/**\n * Turns an arrow key into a **logical** step: `+1` for \"next\", `-1` for\n * \"previous\", `0` when the key names neither.\n *\n * APG defines the horizontal pair as *next / previous* and says a vertical\n * arrangement swaps in Down/Up for the same meaning — so the pair is one axis's\n * spelling of an order, and the order reverses with the writing direction. Only\n * the horizontal pair reverses. Down/Up name an axis the writing direction does\n * not mirror, and returning them unchanged is the point: many controllers fold\n * both pairs into one branch, where swapping the branches under RTL would flip\n * the vertical axis too — a bug that reads as \"the arrows work\" until someone\n * presses Down.\n *\n * **Direction is read from the element the caller passes, which should be the\n * container that lays the items out** — not the focused child. A child may carry\n * its own `dir` (an LTR input inside an RTL form is ordinary authoring), and\n * probing per handler makes two handlers disagree at the boundary between them.\n *\n * This decides direction only. Whether the axis is even active (an\n * `orientation=\"horizontal\"` widget ignoring Down/Up), how far the step lands,\n * and what wrapping does all stay with the caller.\n *\n * **It encodes the list-order convention: `ArrowDown` is *next*.** Widgets that\n * pair the arrows by *value* instead — `ArrowUp` meaning \"more\", as a rating or a\n * slider does — must not use this, or their vertical axis inverts. Reverse the\n * horizontal pair on its own there.\n *\n * @example\n * ```ts\n * const step = logicalArrowStep(event.key, this.element);\n * if (step === 0) return;\n * this.#roving.setActive(rovingMove(current, length, step, \"wrap\"), { focus: true });\n * ```\n */\nexport function logicalArrowStep(key: string, element: Element): 1 | -1 | 0 {\n if (key === \"ArrowDown\") return 1;\n if (key === \"ArrowUp\") return -1;\n if (key !== \"ArrowRight\" && key !== \"ArrowLeft\") return 0;\n const forward = isRtl(element) ? \"ArrowLeft\" : \"ArrowRight\";\n return key === forward ? 1 : -1;\n}\n\n/**\n * Rewrites `key` so an existing LTR-shaped branch keeps working under RTL:\n * `ArrowRight` and `ArrowLeft` trade places, everything else passes through.\n *\n * The alternative — negating a delta — silently breaks handlers whose two\n * horizontal branches are **not mirror images**. A grid that clamps one edge but\n * not the other, or a segmented field guarding `index > 0` on one side and\n * `index < length - 1` on the other, ends up applying the wrong guard to the\n * wrong direction. Swapping the key leaves each branch, guards and all, exactly\n * where its author put it.\n *\n * Same rule as {@link logicalArrowStep} about which element to read: pass the\n * container that lays the items out, not the focused child.\n *\n * @example\n * ```ts\n * switch (logicalArrowKey(event.key, this.element)) {\n * case \"ArrowLeft\": // \"previous\" — whatever direction that is on screen\n * ```\n */\nexport function logicalArrowKey(key: string, element: Element): string {\n if (key !== \"ArrowRight\" && key !== \"ArrowLeft\") return key;\n if (!isRtl(element)) return key;\n return key === \"ArrowRight\" ? \"ArrowLeft\" : \"ArrowRight\";\n}\n\n/** Modifiers a widget may claim on an arrow key, named for the `allow` list. */\nexport type ArrowModifier = \"alt\" | \"ctrl\" | \"meta\" | \"shift\";\n\n/**\n * True when an arrow key arrived carrying a modifier the widget must leave to\n * the browser: return without calling `preventDefault()` and without moving any\n * state.\n *\n * A bare arrow belongs to the widget; a chorded one usually does not.\n * `Alt`/`Meta` plus a horizontal arrow is history back/forward on every desktop\n * browser, and a widget that swallows it makes the shortcut work or not\n * depending on where focus happens to sit — a coin-flip the user cannot see.\n *\n * `allow` is for the combinations APG assigns to a pattern **and the widget\n * actually implements** — today only Combobox's optional `Alt+Down`/`Alt+Up`.\n * Listing one the widget does not implement defeats the point: the chord then\n * runs the plain-arrow branch, which is exactly what this guard exists to stop.\n * Non-arrow keys return `false`, so chorded letters and\n * `Control+Home`/`Control+End` are untouched.\n *\n * @example\n * ```ts\n * if (isReservedArrowChord(event)) return;\n * ```\n */\nexport function isReservedArrowChord(\n event: KeyboardEvent,\n allow: readonly ArrowModifier[] = [],\n): boolean {\n if (!event.key.startsWith(\"Arrow\")) return false;\n return (\n (event.altKey && !allow.includes(\"alt\")) ||\n (event.ctrlKey && !allow.includes(\"ctrl\")) ||\n (event.metaKey && !allow.includes(\"meta\")) ||\n (event.shiftKey && !allow.includes(\"shift\"))\n );\n}\n\n/**\n * True when a press arrived carrying any modifier, for the keys the browser and\n * the OS own outright: return without calling `preventDefault()` and without\n * moving any state.\n *\n * `Control+Home` and `Control+End` jump the document to its ends, and a widget\n * that swallows them makes the shortcut work or not depending on where focus\n * happens to sit. {@link isReservedArrowChord} answers the same question for the\n * arrows, but returns `false` for every other key so that this one can decide.\n *\n * There is no `allow` list here on purpose. APG assigns no modifier chord to\n * `Home`/`End`, so a widget that wanted one would be claiming a combination the\n * pattern never gave it.\n *\n * @example\n * ```ts\n * case \"Home\":\n * case \"End\":\n * if (hasModifierChord(event)) return;\n * ```\n */\nexport function hasModifierChord(event: KeyboardEvent): boolean {\n return event.altKey || event.ctrlKey || event.metaKey || event.shiftKey;\n}\n","/**\n * Shared \"in-page move vs real detach\" discriminator for `disconnect()`.\n *\n * A mid-session `disconnect()` whose element is still in the document is\n * ambiguous. It can be:\n *\n * - an **in-page move** — a consumer (sortable, a teleport) re-inserted the\n * element; Stimulus reconnects the SAME instance in the same mutation batch\n * and the controller's runtime state must survive;\n * - a **detach that keeps the element** — `data-controller` no longer lists the\n * identifier (a Turbo 8 morph), or the element moved outside the observed\n * root (a scoped `Application.start(root)`, a shadow root); no reconnect will\n * ever come and the controller must tear down or it leaks its sessions,\n * document listeners, and moved nodes.\n *\n * Neither available signal decides this alone. A synchronous `data-controller`\n * token check catches the morph case but misses an observed-root exit (the\n * token stays, the reconnect never comes). Deferring teardown one microtask and\n * letting `connect()` cancel it catches the root exit, but leans on Stimulus\n * reconnecting moved elements within the same mutation batch — internal\n * behavior, not a public contract. {@link DetachGate} composes both: the token\n * check is the synchronous fast path (no probe, no reliance on batching), the\n * microtask probe is the fallback for the genuinely ambiguous remainder.\n *\n * Policy stays with the consumer; this util owns the discrimination only:\n *\n * - **Probe** ({@link disconnected}) when the teardown must eventually happen —\n * live drag sessions, document listeners, teleported *content*. Call\n * {@link cancel} from `connect()` (a reconnect means in-page move) and from\n * the head of any direct teardown path (see below).\n * - **Keep** (bare {@link DetachGate.isDetached}) when undoing the ambiguous\n * case would fight the controller's own effect: a controller that moves its\n * OWN element (portal's no-`content` form) exits a scoped observed root as\n * its normal job — a probe-driven teardown would restore the element into\n * the root, reconnect, re-teleport, and disconnect again, forever. Such\n * controllers keep their state on an ambiguous disconnect and tear down only\n * on {@link DetachGate.isDetached}.\n *\n * Event convention for probe consumers: teardown into a dead (detached) tree is\n * silent — consumers restore from their own `connect()`; a detach that keeps the\n * tree alive must end an in-flight session with a `cancel` event, or composing\n * consumers strand their session bookkeeping.\n */\n\n/** The slice of a Stimulus controller the gate inspects. */\nexport interface DetachGateHost {\n readonly element: Element;\n readonly identifier: string;\n}\n\n/**\n * Per-controller-instance gate deciding whether a `disconnect()` is a real\n * detach. Hold one per controller (`#gate = new DetachGate()`) — Stimulus\n * reuses the instance across reconnects, so the pending probe state carries\n * over exactly as the protocol needs.\n *\n * @example\n * ```ts\n * #gate = new DetachGate();\n *\n * connect(): void {\n * this.#gate.cancel(); // a reconnect: the element moved in-page\n * // …\n * }\n *\n * disconnect(): void {\n * this.#gate.disconnected(this, () => this.#teardown());\n * }\n *\n * #teardown(): void {\n * this.#gate.cancel(); // disarm a still-queued probe (double-run guard)\n * // …\n * }\n * ```\n */\nexport class DetachGate {\n /** Set while a probe is queued, waiting for a reconnect to cancel it. */\n #pending = false;\n\n /**\n * True while a probe is queued — the last disconnect was ambiguous and no\n * reconnect has cancelled it yet. Read it from `connect()` to tell the\n * reconnect half of an in-page move from a first connect: a controller whose\n * initialisation restarts a measurement (a min-duration floor, an elapsed\n * counter) must skip it for the move, where nothing actually restarted.\n */\n get pending(): boolean {\n return this.#pending;\n }\n\n /**\n * True when the disconnect is definitely a real detach — the element left\n * the document, or `data-controller` no longer lists the identifier. False\n * means ambiguous (in-page move or observed-root exit), NOT \"alive\".\n */\n static isDetached(host: DetachGateHost): boolean {\n if (!host.element.isConnected) return true;\n const tokens = (host.element.getAttribute(\"data-controller\") ?? \"\").split(/\\s+/);\n return !tokens.includes(host.identifier);\n }\n\n /**\n * Call from `disconnect()`: runs `teardown` synchronously on a definite\n * detach (fast path), otherwise defers it one microtask — a reconnect\n * ({@link cancel} from `connect()`) keeps the state, no reconnect runs it.\n * One microtask is the whole probe window: Stimulus reconnects a moved\n * element within the same mutation batch, before the checkpoint drains.\n */\n disconnected(host: DetachGateHost, teardown: () => void): void {\n if (DetachGate.isDetached(host)) {\n // Also disarms a probe a previous ambiguous disconnect left queued\n // (defer, element removed, disconnect again) — exactly one teardown.\n this.#pending = false;\n teardown();\n return;\n }\n this.#pending = true;\n queueMicrotask(() => {\n if (!this.#pending) return;\n this.#pending = false;\n teardown();\n });\n }\n\n /**\n * Disarms a pending probe. Call from `connect()` (the reconnect that proves\n * an in-page move) and from the head of any teardown path not routed through\n * {@link disconnected} (disabled-toggle, Escape), so an orphaned probe can\n * never run the teardown a second time.\n */\n cancel(): void {\n this.#pending = false;\n }\n}\n","/**\n * Resolves which of a controller's elements owns a node.\n *\n * A delegated listener hears events from a whole subtree, so the handler's first\n * job is almost always the same question: which item, handle, or control does\n * this `event.target` belong to? The same question comes up for a\n * `MutationRecord.target`, for `document.activeElement`, and for a\n * `relatedTarget` on the way out of a hover region.\n *\n * The answer is `Node.contains()`, which is **inclusive** — an element contains\n * itself — so testing the candidate for identity as well would be redundant.\n *\n * **The guard is what makes this safe to call with a raw event target.**\n * `event.target` is typed `EventTarget | null`, and `contains()` takes a `Node?`:\n * browsers throw `TypeError` for anything else, and `window` — the everyday\n * `EventTarget` that is not a `Node` — is what an event dispatched at it carries.\n * Narrowing here means a caller never has to cast, and the rule cannot drift\n * between the places that ask the question.\n *\n * Scope stays with the caller. These helpers say *which candidate owns the node*,\n * not *whether the node belongs to this controller at all* — a component with\n * nested instances of itself decides that first (by comparing the closest\n * annotated ancestor) and passes the candidates it owns.\n */\n\n/**\n * Index in `candidates` of the first one that is, or contains, `node`.\n *\n * `-1` when none does, when `node` is absent, and when it is an `EventTarget`\n * that is not a `Node`. Candidates are tested in array order, so a nested pair\n * resolves to whichever the caller listed first.\n */\nexport function ownerIndex<T extends Element>(\n candidates: readonly T[],\n node: EventTarget | null | undefined,\n): number {\n if (!(node instanceof Node)) return -1;\n return candidates.findIndex((candidate) => candidate.contains(node));\n}\n\n/**\n * The first candidate that is, or contains, `node`; `null` when none does.\n *\n * A miss indexes the array at `-1`, which reads as `undefined` and lands on the\n * same `null` the absent cases produce.\n */\nexport function ownerOf<T extends Element>(\n candidates: readonly T[],\n node: EventTarget | null | undefined,\n): T | null {\n return candidates[ownerIndex(candidates, node)] ?? null;\n}\n","import { Controller } from \"@hotwired/stimulus\";\nimport { isReservedArrowChord } from \"../utils/arrow_step\";\nimport { DetachGate } from \"../utils/detach_gate\";\nimport { ownerOf } from \"../utils/event_owner\";\n\n/**\n * Elements whose own default action owns a key press. The browser never signals\n * those through `defaultPrevented`, so a yield on that flag cannot see them.\n */\nconst NATIVE_KEY_OWNERS = \"input, textarea, select, button, a[href], summary, [contenteditable]\";\n\n/** How a drag session was initiated; surfaced in every event detail. */\ntype DragPointerType = \"mouse\" | \"touch\" | \"pen\" | \"keyboard\";\n\n/** A pointer drag in flight (from `pointerdown` until up/cancel). */\ninterface PointerSession {\n pointerId: number;\n handle: HTMLElement;\n originX: number;\n originY: number;\n /** True once the movement passed `threshold` and `start` was dispatched. */\n started: boolean;\n /** Last axis-filtered deltas, reported again by `end`. */\n dx: number;\n dy: number;\n pointerType: DragPointerType;\n}\n\n/** A keyboard \"grabbed\" session (Space/Enter on the handle until drop/cancel). */\ninterface KeyboardSession {\n handle: HTMLElement;\n /** Cumulative synthetic deltas accumulated by the arrow keys. */\n dx: number;\n dy: number;\n}\n\n/**\n * Headless **pointer-drag primitive**: a normalized pointer/touch/mouse drag\n * lifecycle with a built-in keyboard alternative. It deliberately does NOT decide\n * what a drag *means* (reorder, dismiss, resize…) — it only emits a clean,\n * accessibility-friendly drag signal that higher-level behaviors compose from —\n * `stimeo--sortable` is one, and reordering, dismissal, and resizing are the usual\n * meanings a consumer layers on. No dedicated APG\n * pattern exists for drag-and-drop; the keyboard model below is the accepted\n * alternative-input technique (WCAG 2.1.1 / 2.5.7 Dragging Movements). Core\n * (zero dependencies).\n *\n * Markup contract (identifier: `stimeo--pointer-drag`):\n * <li data-controller=\"stimeo--pointer-drag\"\n * data-stimeo--pointer-drag-axis-value=\"y\">\n * <button data-stimeo--pointer-drag-target=\"handle\" aria-label=\"Reorder\">⠿</button>\n * </li>\n *\n * The `handle` target is optional — without one, the controller element itself\n * is the handle. Pointer flow: `pointerdown` on a handle arms the drag; once the\n * axis-filtered movement exceeds `threshold`, `start` fires, every subsequent\n * movement fires `move` (deltas cumulative from the origin), and release fires\n * `end` (`pointercancel` → `cancel`). Keyboard flow: Space/Enter on the handle\n * grabs (`start`, `data-grabbed`), the arrow keys emit synthetic `move` events of\n * `keyboardStep` px each, Space/Enter drops (`end`) and Escape cancels — so every\n * consumer gets a keyboard path for free.\n *\n * `start` dispatches `{ x, y, pointerType }`; `move` dispatches `{ dx, dy, x, y, pointerType }`;\n * `end` dispatches `{ dx, dy, pointerType }`; `cancel` dispatches `{ pointerType }`.\n *\n * @remarks\n * Behavior only: consumers own all visuals (ghost, placeholder, transforms) by\n * reacting to the events and the `data-dragging` / `data-grabbed` hooks. The one\n * deliberate exception is the opt-in `follow` value for the \"just move the\n * element\" case: it applies the in-flight deltas to the element's CSS\n * `translate` (a property independent of `transform`, so authored transforms\n * survive), commits the offset on drop and restores it on cancel — the exact\n * boilerplate every simple consumer would otherwise re-write. With `follow` the\n * element's inline `translate` belongs to this controller (`connect()` re-reads\n * a committed `<x>px <y>px` offset, so Turbo restores stay consistent). ARIA 1.1\n * deprecated `aria-grabbed`/`aria-dropeffect`, so the grabbed state is\n * published as `data-grabbed` and the *meaning* of a drag must be announced by\n * the consumer (pair with `stimeo--announcer`). `touch-action` on the handles is\n * derived from `axis` (marker-guarded, authored values win) so the page does not\n * pan mid-drag. Deltas are physical (client coordinates): RTL semantics belong\n * to the consumer. `disconnect()` (Turbo navigation included) tears down any\n * active session — except across an in-page move, which the session survives\n * (the full lifecycle contract lives on `disconnect()`); `connect()` clears\n * stale hooks a Turbo cache restore may have preserved (a drag cannot survive\n * a navigation).\n */\nexport class PointerDragController extends Controller<HTMLElement> {\n static override targets = [\"handle\"];\n static override values = {\n axis: { type: String, default: \"both\" },\n threshold: { type: Number, default: 3 },\n keyboardStep: { type: Number, default: 10 },\n disabled: { type: Boolean, default: false },\n follow: { type: Boolean, default: false },\n };\n static actions = [\"reset\"] as const;\n static events = [\"start\", \"move\", \"end\", \"cancel\"] as const;\n\n declare readonly handleTargets: HTMLElement[];\n declare readonly hasHandleTarget: boolean;\n declare axisValue: string;\n declare thresholdValue: number;\n declare keyboardStepValue: number;\n declare disabledValue: boolean;\n declare followValue: boolean;\n\n /** Marker attribute recording that this controller set the touch-action. */\n static readonly #TOUCH_ACTION_MARKER = \"data-pointer-drag-touch-action\";\n /** Marker attribute recording that this controller set `tabindex`. */\n static readonly #TABINDEX_MARKER = \"data-pointer-drag-tabindex\";\n\n #pointer: PointerSession | null = null;\n #keyboard: KeyboardSession | null = null;\n /** Committed follow offset from past drops; a new drag's deltas add onto it. */\n #followBase = { x: 0, y: 0 };\n /** Aborts in-progress pointer-drag listeners on drag end / teardown. */\n #dragAbort: AbortController | null = null;\n /** Decides whether a mid-session disconnect() is an in-page move or a detach. */\n readonly #gate = new DetachGate();\n\n override connect(): void {\n // A reconnect disarms the probe a mid-session disconnect() armed — the\n // element was moved in-page and the session survives (see disconnect).\n this.#gate.cancel();\n // Transient drag state cannot survive a navigation: clear hooks a Turbo\n // cache restore may have snapshotted mid-drag (idempotent reconnect). But a\n // session preserved across an in-page move keeps its hooks.\n if (!this.#pointer) this.element.removeAttribute(\"data-dragging\");\n if (!this.#keyboard) this.element.removeAttribute(\"data-grabbed\");\n // Follow mode owns the element's inline `translate`: re-read a committed\n // offset so reconnects (Turbo cache restore included) keep accumulating from\n // where the element visually sits. A session surviving an in-page move keeps\n // its base — mid-drag inline state must not be committed as a new base.\n if (this.followValue && !this.#pointer && !this.#keyboard) {\n this.#followBase = this.#parseFollowBase();\n }\n // Delegated on the container so dynamically added handles need no per-element\n // data-action.\n this.element.addEventListener(\"pointerdown\", this.#onPointerDown);\n this.element.addEventListener(\"keydown\", this.#onKeydown);\n if (!this.hasHandleTarget) this.#prepareHandle(this.element);\n }\n\n override disconnect(): void {\n this.element.removeEventListener(\"pointerdown\", this.#onPointerDown);\n this.element.removeEventListener(\"keydown\", this.#onKeydown);\n // A mid-session disconnect on a STILL-connected element is ambiguous: an\n // in-page move (a consumer like sortable re-inserts the item mid-grab —\n // Stimulus reconnects the same instance in the same mutation batch, and\n // the session must survive) vs a real detach that keeps the element\n // (`data-controller` removed, Turbo morph, element moved outside the\n // observed root). DetachGate discriminates: the token check is the\n // synchronous fast path (a morph's teardown — and its `cancel` — fires in\n // the same tick), the one-microtask probe cancelled by connect() covers\n // the rest — a detached-in-place controller never leaks its session or\n // document listeners. Probe only while a session needs protecting; an\n // idle controller tears down synchronously either way.\n if (this.#pointer || this.#keyboard) {\n this.#gate.disconnected(this, () => this.#teardown());\n return;\n }\n this.#teardown();\n }\n\n /**\n * Returns the element to its origin: drops the committed follow offset and the\n * inline `translate` that carries it.\n *\n * In follow mode the inline `translate` belongs to this controller, and the\n * committed offset lives in a field the DOM cannot reach — so a consumer that\n * wants the element back at the start, or that has written a position of its\n * own, needs this to make the two agree again. An in-flight drag is cancelled\n * first, or its deltas would land on top of the offset just cleared.\n */\n reset(): void {\n // Cancel first, then clear: the cancel contract snaps back to the committed\n // offset, so clearing before it would be undone on the way out.\n const live = this.#pointer?.started\n ? this.#pointer.pointerType\n : this.#keyboard\n ? \"keyboard\"\n : null;\n if (this.#pointer || this.#keyboard) this.#teardownSessions();\n if (live) this.#dispatchCancel(live);\n this.#followBase = { x: 0, y: 0 };\n this.#applyFollow(0, 0);\n }\n\n handleTargetConnected(handle: HTMLElement): void {\n // The element wears the handle contract only while it IS the handle; the\n // first real handle takes it back. (Marker-guarded, so this is a no-op when\n // the element never wore it.)\n if (handle !== this.element) this.#restoreHandle(this.element);\n this.#prepareHandle(handle);\n }\n\n handleTargetDisconnected(handle: HTMLElement): void {\n // The loan is due back the moment an element stops being a handle, and this\n // callback is the only place that sees every such element: once the\n // identifier token is gone, `#handles()` no longer resolves the targets.\n // Across an in-page move `handleTargetConnected` lends it again in the same\n // mutation batch.\n this.#restoreHandle(handle);\n // Target callbacks ALSO fire when the CONTROLLER goes away (Stimulus stops\n // the target observer after `disconnect()` has run) and across the in-page\n // move a live session must survive. In both the handle is still inside the\n // element: the session belongs to `disconnect()`, and handing the contract\n // to the container here would bake a nameless tab stop onto it on every\n // morph. Only a handle that actually LEFT is this callback's business.\n if (this.element.contains(handle)) return;\n\n // It can never deliver its keydown again (the delegated listener sits on the\n // container it left), so a live session would leak and the one-session guard\n // would reject every future pointerdown. The tree and the consumers are both\n // alive here, so it ends the way every other keep-the-element teardown does:\n // in `cancel`, or a composer like sortable strands its session bookkeeping.\n const interrupted =\n this.#pointer?.handle === handle && this.#pointer.started\n ? this.#pointer.pointerType\n : this.#keyboard?.handle === handle\n ? (\"keyboard\" as const)\n : null;\n if (this.#pointer?.handle === handle) this.#endPointerSession();\n if (this.#keyboard?.handle === handle) this.#clearKeyboardSession();\n // With the last handle gone the element is the handle again (`#handles()`),\n // so it needs the contract the departing handle just gave back.\n if (!this.hasHandleTarget) this.#prepareHandle(this.element);\n if (interrupted) this.#dispatchCancel(interrupted);\n }\n\n /**\n * Re-derives the handles' touch-action when the axis changes.\n *\n * Two layers, like the `tabindex` loan: the marker says the value was once\n * ours, and the current inline value says it still is. A consumer that wrote\n * its own `touch-action` after connect keeps it.\n */\n axisValueChanged(_value: string, previousValue: string | undefined): void {\n // The value to recognize as ours is the one the previous axis lent. Stimulus\n // also replays a value that did NOT change (ahead of every connect), and\n // there the axis in force is the one it was lent under.\n const lent = this.#touchActionFor(previousValue ?? this.axisValue);\n for (const handle of this.#handles()) {\n if (!handle.hasAttribute(PointerDragController.#TOUCH_ACTION_MARKER)) continue;\n if (handle.style.touchAction !== lent) continue;\n handle.style.touchAction = this.#touchActionForAxis();\n }\n }\n\n /** Cancels any in-flight session when the controller is disabled mid-drag. */\n disabledValueChanged(): void {\n if (!this.disabledValue) return;\n if (this.#pointer?.started || this.#keyboard) {\n this.#dispatchCancel(this.#keyboard ? \"keyboard\" : (this.#pointer?.pointerType ?? \"mouse\"));\n }\n this.#teardownSessions();\n }\n\n /** Arms a pointer drag on a handle; `start` waits for the threshold. */\n readonly #onPointerDown = (event: PointerEvent): void => {\n // One session at a time: ignore a second pointerdown (multi-touch, an\n // errant tap, a grabbed keyboard session) so an in-flight drag is never\n // silently overwritten and its captured pointer orphaned.\n if (this.disabledValue || this.#pointer || this.#keyboard || event.button !== 0) return;\n const handle = this.#handleFor(event.target);\n if (!handle) return;\n\n // Suppress text selection / native image drag; restore the focus the\n // suppressed default would have given, so Escape and the keyboard path\n // stay reachable right after a pointer interaction (WCAG 2.1.1).\n event.preventDefault();\n handle.focus();\n\n this.#pointer = {\n pointerId: event.pointerId,\n handle,\n originX: event.clientX,\n originY: event.clientY,\n started: false,\n dx: 0,\n dy: 0,\n pointerType: this.#pointerTypeOf(event),\n };\n\n // Pointer capture keeps fast drags delivering to the handle even when the\n // pointer strays outside it — but a consumer may re-insert the dragged\n // element mid-drag (sortable's live reorder), which silently releases the\n // capture. Tracking listeners therefore live on the DOCUMENT (captured\n // events bubble there; uncaptured ones fire there anyway), and the\n // AbortController releases them on drag end and disconnect() (Turbo included).\n handle.setPointerCapture(event.pointerId);\n this.#dragAbort?.abort();\n const abort = new AbortController();\n this.#dragAbort = abort;\n document.addEventListener(\"pointermove\", this.#onPointerMove, { signal: abort.signal });\n document.addEventListener(\"pointerup\", this.#onPointerUp, { signal: abort.signal });\n document.addEventListener(\"pointercancel\", this.#onPointerCancel, { signal: abort.signal });\n };\n\n readonly #onPointerMove = (event: PointerEvent): void => {\n const session = this.#pointer;\n if (!session || event.pointerId !== session.pointerId) return;\n\n const [dx, dy] = this.#filterAxis(\n event.clientX - session.originX,\n event.clientY - session.originY,\n );\n if (!session.started) {\n if (Math.hypot(dx, dy) < this.thresholdValue) return;\n session.started = true;\n this.element.setAttribute(\"data-dragging\", \"true\");\n this.dispatch(\"start\", {\n detail: { x: event.clientX, y: event.clientY, pointerType: session.pointerType },\n });\n }\n\n session.dx = dx;\n session.dy = dy;\n this.#followMove(dx, dy);\n this.dispatch(\"move\", {\n detail: { dx, dy, x: event.clientX, y: event.clientY, pointerType: session.pointerType },\n });\n };\n\n readonly #onPointerUp = (event: PointerEvent): void => {\n const session = this.#pointer;\n if (!session || event.pointerId !== session.pointerId) return;\n const { started, dx, dy, pointerType } = session;\n this.#endPointerSession();\n // Below the threshold the gesture was a plain click, not a drag: stay silent.\n if (!started) return;\n this.#followCommit(dx, dy);\n this.dispatch(\"end\", { detail: { dx, dy, pointerType } });\n };\n\n /** OS gesture / scroll takeover interrupted the drag: cancel, don't drop. */\n readonly #onPointerCancel = (event: PointerEvent): void => {\n const session = this.#pointer;\n if (!session || event.pointerId !== session.pointerId) return;\n const { started, pointerType } = session;\n this.#endPointerSession();\n if (started) this.#dispatchCancel(pointerType);\n };\n\n /** Keyboard alternative: Space/Enter grab & drop, arrows move, Escape cancels. */\n readonly #onKeydown = (event: KeyboardEvent): void => {\n if (this.disabledValue) return;\n const handle = this.#handleFor(event.target);\n if (!handle) return;\n\n // A descendant widget that already claimed the key (a nested roving list, a\n // segmented field inside the handle) must not ALSO drive the drag —\n // composition depends on this yield.\n if (event.defaultPrevented) return;\n // A press that steers an IME conversion belongs to the composition, and an\n // input method never says so through `defaultPrevented`.\n if (event.isComposing) return;\n // Neither does a native control or editing surface inside the handle: typing\n // a space into a field and activating a link are default actions, not claims.\n // Widgets that do claim their keys keep composing through the yield above.\n if (this.#ownsNativeKeys(event.target, handle)) return;\n // A chorded arrow belongs to the browser. \"Someone already consumed it\"\n // outranks that, so it is checked after the yields above.\n if (isReservedArrowChord(event)) return;\n\n // Escape cancels whichever session is live (pointer drag or keyboard grab).\n if (event.key === \"Escape\") {\n if (this.#pointer?.started) {\n const { pointerType } = this.#pointer;\n this.#teardownSessions();\n event.preventDefault();\n this.#dispatchCancel(pointerType);\n } else if (this.#keyboard) {\n this.#teardownSessions();\n event.preventDefault();\n this.#dispatchCancel(\"keyboard\");\n }\n return;\n }\n\n if (event.key === \" \" || event.key === \"Enter\") {\n // A live pointer drag owns the session: pressing Space mid-drag (the\n // pointerdown focused the handle) must not start a parallel grab.\n if (this.#pointer) return;\n event.preventDefault();\n if (this.#keyboard) this.#dropKeyboard();\n else this.#grabKeyboard(handle);\n return;\n }\n\n if (!this.#keyboard) return;\n // While grabbed, the handle owns the keyboard. `Home` / `End` move nothing\n // here, but a composition partner acts on them (a roving group jumps focus\n // to the ends), and focus leaving the handle strands the grab: the arrows\n // and Escape that end it are all delivered to whatever holds focus. So they\n // are consumed here and do nothing, the same reason every arrow is consumed.\n if (event.key === \"Home\" || event.key === \"End\") {\n event.preventDefault();\n return;\n }\n const step = this.#keyboardDelta(event.key);\n if (!step) return;\n // Consume every arrow while grabbed (even on a locked axis) so the page\n // never scrolls mid-grab; only allowed-axis arrows emit a move.\n event.preventDefault();\n const [dx, dy] = this.#filterAxis(step[0], step[1]);\n if (dx === 0 && dy === 0) return;\n this.#keyboard.dx += dx;\n this.#keyboard.dy += dy;\n this.#followMove(this.#keyboard.dx, this.#keyboard.dy);\n this.dispatch(\"move\", {\n detail: {\n dx: this.#keyboard.dx,\n dy: this.#keyboard.dy,\n x: this.#keyboard.dx,\n y: this.#keyboard.dy,\n pointerType: \"keyboard\",\n },\n });\n };\n\n /** Enters the grabbed mode: `data-grabbed` on element + handle, then `start`. */\n #grabKeyboard(handle: HTMLElement): void {\n this.#keyboard = { handle, dx: 0, dy: 0 };\n this.element.setAttribute(\"data-grabbed\", \"true\");\n handle.setAttribute(\"data-grabbed\", \"true\");\n this.dispatch(\"start\", { detail: { x: 0, y: 0, pointerType: \"keyboard\" } });\n }\n\n #dropKeyboard(): void {\n const session = this.#keyboard;\n if (!session) return;\n this.#clearKeyboardSession();\n this.#followCommit(session.dx, session.dy);\n this.dispatch(\"end\", { detail: { dx: session.dx, dy: session.dy, pointerType: \"keyboard\" } });\n }\n\n /** Maps an arrow key to a raw (unfiltered) `keyboardStep` delta. */\n #keyboardDelta(key: string): [number, number] | null {\n const step = this.keyboardStepValue;\n switch (key) {\n case \"ArrowRight\":\n return [step, 0];\n case \"ArrowLeft\":\n return [-step, 0];\n case \"ArrowDown\":\n return [0, step];\n case \"ArrowUp\":\n return [0, -step];\n default:\n return null;\n }\n }\n\n /** Zeroes the delta on the locked axis (`axis` = x | y | both). */\n #filterAxis(dx: number, dy: number): [number, number] {\n if (this.axisValue === \"x\") return [dx, 0];\n if (this.axisValue === \"y\") return [0, dy];\n return [dx, dy];\n }\n\n /** Releases capture + listeners and clears the pointer session and its hook. */\n #endPointerSession(): void {\n this.#releasePointerCapture();\n this.#pointer = null;\n this.#dragAbort?.abort();\n this.#dragAbort = null;\n this.element.removeAttribute(\"data-dragging\");\n }\n\n /** Releases the pointer capture the active session set (idempotent, safe). */\n #releasePointerCapture(): void {\n const session = this.#pointer;\n if (session?.handle.hasPointerCapture(session.pointerId)) {\n session.handle.releasePointerCapture(session.pointerId);\n }\n }\n\n #clearKeyboardSession(): void {\n this.#keyboard?.handle.removeAttribute(\"data-grabbed\");\n this.#keyboard = null;\n this.element.removeAttribute(\"data-grabbed\");\n }\n\n /**\n * Full teardown for a controller whose element is going away or lost its\n * controller. Into a dead (detached) tree it is silent — consumers restore\n * from their own `connect()`, not from a cancel event. But a detach that\n * KEEPS the element (Turbo morph, `data-controller` removed) leaves the\n * consumers alive and listening: an in-flight session must end in `cancel`\n * there, or a composer like sortable strands its one-at-a-time session\n * bookkeeping forever.\n */\n #teardown(): void {\n // Disarm any probe still queued: without this, an immediate teardown\n // (element removed right after a deferring disconnect) would let the\n // orphaned probe run #teardown a second time — a double cancel.\n this.#gate.cancel();\n const interrupted = this.#pointer?.started\n ? this.#pointer.pointerType\n : this.#keyboard\n ? (\"keyboard\" as const)\n : null;\n this.#teardownSessions();\n for (const handle of this.#handles()) this.#restoreHandle(handle);\n // An in-flight offset must leave the DOM even where nobody is listening: a\n // re-inserted element would have `connect()` read it back as a committed base.\n this.#followReset();\n if (interrupted && this.element.isConnected) this.#dispatchCancel(interrupted);\n }\n\n /**\n * Silently tears down whatever session is live (disconnect / disabled /\n * Escape). Composed from the two single-session teardowns so pointer and\n * keyboard cleanup cannot diverge as either path evolves.\n */\n #teardownSessions(): void {\n this.#endPointerSession();\n this.#clearKeyboardSession();\n }\n\n #dispatchCancel(pointerType: DragPointerType): void {\n // Every cancel path funnels here, so follow's snap-back can never be missed\n // (Escape, pointercancel, mid-session disable, detach-that-keeps-the-element).\n this.#followReset();\n this.dispatch(\"cancel\", { detail: { pointerType } });\n }\n\n /** Applies the in-flight offset to the element's `translate` (follow only). */\n #followMove(dx: number, dy: number): void {\n if (!this.followValue) return;\n this.#applyFollow(this.#followBase.x + dx, this.#followBase.y + dy);\n }\n\n /** Folds a drop's deltas into the committed base offset (follow only). */\n #followCommit(dx: number, dy: number): void {\n if (!this.followValue) return;\n this.#followBase = { x: this.#followBase.x + dx, y: this.#followBase.y + dy };\n this.#applyFollow(this.#followBase.x, this.#followBase.y);\n }\n\n /** Snaps back to the committed position (follow only) — the cancel contract. */\n #followReset(): void {\n if (!this.followValue) return;\n this.#applyFollow(this.#followBase.x, this.#followBase.y);\n }\n\n /**\n * Writes the offset as the standalone CSS `translate` property — independent\n * of `transform`, so an authored transform (scale, rotate…) is never\n * clobbered. At the origin the property is removed to keep the DOM clean.\n */\n #applyFollow(x: number, y: number): void {\n if (x === 0 && y === 0) this.element.style.removeProperty(\"translate\");\n else this.element.style.setProperty(\"translate\", `${x}px ${y}px`);\n }\n\n /**\n * Reads a committed follow offset back from the inline `translate`. Only the\n * controller's own `<x>px <y>px` shape is recognized; anything else (an\n * authored percentage, `none`, an empty string) starts the base at 0 — follow\n * mode owns this property, per the class contract.\n */\n #parseFollowBase(): { x: number; y: number } {\n const raw = this.element.style.getPropertyValue(\"translate\").trim();\n const match = /^(-?\\d+(?:\\.\\d+)?)px(?:\\s+(-?\\d+(?:\\.\\d+)?)px)?$/.exec(raw);\n if (!match) return { x: 0, y: 0 };\n return { x: Number(match[1]), y: Number(match[2] ?? \"0\") };\n }\n\n /** The active handles: the `handle` targets, else the element itself. */\n #handles(): HTMLElement[] {\n return this.hasHandleTarget ? this.handleTargets : [this.element];\n }\n\n /** Resolves the handle owning an event target (the handle or a descendant). */\n #handleFor(target: EventTarget | null): HTMLElement | null {\n return ownerOf(this.#handles(), target);\n }\n\n #pointerTypeOf(event: PointerEvent): DragPointerType {\n const type = event.pointerType;\n if (type === \"touch\" || type === \"pen\") return type;\n return \"mouse\";\n }\n\n /** `touch-action` that lets the page keep panning on the locked axis only. */\n #touchActionForAxis(): string {\n return this.#touchActionFor(this.axisValue);\n }\n\n /** The `touch-action` an `axis` declaration lends, for any axis value. */\n #touchActionFor(axis: string): string {\n if (axis === \"x\") return \"pan-y\";\n if (axis === \"y\") return \"pan-x\";\n return \"none\";\n }\n\n /**\n * Establishes the handle contract: a `touch-action` derived from `axis`\n * (marker-guarded so an authored inline value wins and reconnects stay\n * idempotent) and focusability for the keyboard path (`tabindex=\"0\"` only when\n * the author supplied none — prefer a real `<button>` handle). Both additions\n * are marker-owned so `#restoreHandle` reverts them symmetrically on teardown.\n */\n #prepareHandle(handle: HTMLElement): void {\n const lent = this.#touchActionForAxis();\n // Two layers, as when the loan is returned: a free property is ours to take,\n // and a marked one is still ours only while it reads back as what was lent.\n // A consumer that wrote its own value keeps it across every reconnect.\n const marked = handle.hasAttribute(PointerDragController.#TOUCH_ACTION_MARKER);\n if (handle.style.touchAction === \"\" || (marked && handle.style.touchAction === lent)) {\n handle.style.touchAction = lent;\n handle.setAttribute(PointerDragController.#TOUCH_ACTION_MARKER, \"true\");\n }\n if (handle.tabIndex < 0 && !handle.hasAttribute(\"tabindex\")) {\n handle.setAttribute(\"tabindex\", \"0\");\n handle.setAttribute(PointerDragController.#TABINDEX_MARKER, \"true\");\n }\n }\n\n /** Whether the key belongs to a native control or editing surface in the handle. */\n #ownsNativeKeys(target: EventTarget | null, handle: HTMLElement): boolean {\n const owner = (target as Element | null)?.closest(NATIVE_KEY_OWNERS) ?? null;\n return owner !== null && owner !== handle && handle.contains(owner);\n }\n\n /** Reverts the marker-owned touch-action + tabindex (authored values untouched). */\n #restoreHandle(handle: HTMLElement): void {\n if (handle.hasAttribute(PointerDragController.#TOUCH_ACTION_MARKER)) {\n // Only give back what is still ours: a consumer may have written its own\n // value since, and clearing then would lose it. The marker goes either\n // way — the loan is over regardless of who ends up owning the value.\n if (handle.style.touchAction === this.#touchActionForAxis()) {\n handle.style.touchAction = \"\";\n }\n handle.removeAttribute(PointerDragController.#TOUCH_ACTION_MARKER);\n }\n if (handle.hasAttribute(PointerDragController.#TABINDEX_MARKER)) {\n // Only remove what is verifiably still ours and safe to remove: another\n // owner (e.g. a roving list) may have rewritten the value since, and\n // stripping tabindex off the focused element would blur it to <body>\n // (losing the user's place — worse than leaking one tab stop).\n const ours = handle.getAttribute(\"tabindex\") === \"0\";\n if (ours && document.activeElement !== handle) {\n handle.removeAttribute(\"tabindex\");\n handle.removeAttribute(PointerDragController.#TABINDEX_MARKER);\n return;\n }\n // The loan ends when someone else owns the value; it stays recorded when\n // the value is still ours and only the focus stopped us returning it —\n // otherwise an in-page move (teardown + reconnect while focused) drops the\n // record and the borrowed tab stop is never given back.\n if (!ours) handle.removeAttribute(PointerDragController.#TABINDEX_MARKER);\n }\n }\n}\n"]}
1
+ {"version":3,"sources":["../../src/utils/arrow_step.ts","../../src/utils/detach_gate.ts","../../src/utils/event_owner.ts","../../src/utils/owned_pointer_session.ts","../../src/utils/transient_hooks.ts","../../src/controllers/pointer_drag_controller.ts"],"names":[],"mappings":";;;;;AA+FO,SAAS,oBAAA,CACd,KAAA,EACA,KAAA,GAAkC,EAAC,EAC1B;AACT,EAAA,IAAI,CAAC,KAAA,CAAM,GAAA,CAAI,UAAA,CAAW,OAAO,GAAG,OAAO,KAAA;AAC3C,EAAA,OACG,KAAA,CAAM,MAAA,IAAU,CAAC,KAAA,CAAM,QAAA,CAAS,KAAK,CAAA,IACrC,KAAA,CAAM,OAAA,IAAW,CAAC,KAAA,CAAM,QAAA,CAAS,MAAM,KACvC,KAAA,CAAM,OAAA,IAAW,CAAC,KAAA,CAAM,QAAA,CAAS,MAAM,CAAA,IACvC,KAAA,CAAM,QAAA,IAAY,CAAC,KAAA,CAAM,QAAA,CAAS,OAAO,CAAA;AAE9C;;;AC/BO,IAAM,UAAA,GAAN,MAAM,WAAA,CAAW;AAAA;AAAA,EAEtB,QAAA,GAAW,KAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASX,IAAI,OAAA,GAAmB;AACrB,IAAA,OAAO,IAAA,CAAK,QAAA;AAAA,EACd;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,OAAO,WAAW,IAAA,EAA+B;AAC/C,IAAA,IAAI,CAAC,IAAA,CAAK,OAAA,CAAQ,WAAA,EAAa,OAAO,IAAA;AACtC,IAAA,MAAM,MAAA,GAAA,CAAU,KAAK,OAAA,CAAQ,YAAA,CAAa,iBAAiB,CAAA,IAAK,EAAA,EAAI,MAAM,KAAK,CAAA;AAC/E,IAAA,OAAO,CAAC,MAAA,CAAO,QAAA,CAAS,IAAA,CAAK,UAAU,CAAA;AAAA,EACzC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,YAAA,CAAa,MAAsB,QAAA,EAA4B;AAC7D,IAAA,IAAI,WAAA,CAAW,UAAA,CAAW,IAAI,CAAA,EAAG;AAG/B,MAAA,IAAA,CAAK,QAAA,GAAW,KAAA;AAChB,MAAA,QAAA,EAAS;AACT,MAAA;AAAA,IACF;AACA,IAAA,IAAA,CAAK,QAAA,GAAW,IAAA;AAChB,IAAA,cAAA,CAAe,MAAM;AACnB,MAAA,IAAI,CAAC,KAAK,QAAA,EAAU;AACpB,MAAA,IAAA,CAAK,QAAA,GAAW,KAAA;AAChB,MAAA,QAAA,EAAS;AAAA,IACX,CAAC,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAA,GAAe;AACb,IAAA,IAAA,CAAK,QAAA,GAAW,KAAA;AAAA,EAClB;AACF,CAAA;;;ACrGO,SAAS,UAAA,CACd,YACA,IAAA,EACQ;AACR,EAAA,IAAI,EAAE,IAAA,YAAgB,IAAA,CAAA,EAAO,OAAO,EAAA;AACpC,EAAA,OAAO,WAAW,SAAA,CAAU,CAAC,cAAc,SAAA,CAAU,QAAA,CAAS,IAAI,CAAC,CAAA;AACrE;AAQO,SAAS,OAAA,CACd,YACA,IAAA,EACU;AACV,EAAA,OAAO,UAAA,CAAW,UAAA,CAAW,UAAA,EAAY,IAAI,CAAC,CAAA,IAAK,IAAA;AACrD;;;ACrBO,IAAM,sBAAN,MAA0B;AAAA,EACtB,UAAA;AAAA,EACA,MAAA;AAAA,EACA,SAAA;AAAA,EACA,MAAA,GAAS,IAAI,eAAA,EAAgB;AAAA,EACtC,OAAA,GAAU,IAAA;AAAA,EAEV,WAAA,CAAY,KAAA,EAAqB,KAAA,EAAoB,QAAA,EAAuC;AAC1F,IAAA,IAAA,CAAK,aAAa,KAAA,CAAM,SAAA;AACxB,IAAA,IAAA,CAAK,MAAA,GAAS,KAAA;AACd,IAAA,IAAA,CAAK,SAAA,GAAY,QAAA;AAEjB,IAAA,MAAM,EAAE,MAAA,EAAO,GAAI,IAAA,CAAK,MAAA;AACxB,IAAA,KAAA,CAAM,cAAc,gBAAA,CAAiB,aAAA,EAAe,KAAK,OAAA,EAAS,EAAE,QAAQ,CAAA;AAC5E,IAAA,KAAA,CAAM,cAAc,gBAAA,CAAiB,WAAA,EAAa,KAAK,WAAA,EAAa,EAAE,QAAQ,CAAA;AAC9E,IAAA,KAAA,CAAM,cAAc,gBAAA,CAAiB,eAAA,EAAiB,KAAK,WAAA,EAAa,EAAE,QAAQ,CAAA;AAIlF,IAAA,IAAI;AACF,MAAA,KAAA,CAAM,iBAAA,GAAoB,KAAK,UAAU,CAAA;AAAA,IAC3C,CAAA,CAAA,MAAQ;AAAA,IAGR;AAAA,EACF;AAAA;AAAA,EAGA,GAAA,GAAY;AACV,IAAA,IAAA,CAAK,QAAQ,UAAU,CAAA;AAAA,EACzB;AAAA,EAEA,QAAQ,IAAA,EAAoC;AAC1C,IAAA,IAAI,CAAC,KAAK,OAAA,EAAS;AACnB,IAAA,IAAA,CAAK,OAAA,GAAU,KAAA;AACf,IAAA,IAAA,CAAK,OAAO,KAAA,EAAM;AAClB,IAAA,IAAI;AACF,MAAA,IAAA,CAAK,MAAA,CAAO,qBAAA,GAAwB,IAAA,CAAK,UAAU,CAAA;AAAA,IACrD,CAAA,CAAA,MAAQ;AAAA,IAER;AACA,IAAA,IAAA,CAAK,SAAA,CAAU,MAAM,IAAI,CAAA;AAAA,EAC3B;AAAA,EAEA,MAAM,KAAA,EAA8B;AAClC,IAAA,OAAO,IAAA,CAAK,OAAA,IAAW,KAAA,CAAM,SAAA,KAAc,IAAA,CAAK,UAAA;AAAA,EAClD;AAAA,EAES,OAAA,GAAU,CAAC,KAAA,KAA8B;AAChD,IAAA,IAAI,KAAK,KAAA,CAAM,KAAK,GAAG,IAAA,CAAK,SAAA,CAAU,KAAK,KAAK,CAAA;AAAA,EAClD,CAAA;AAAA,EAES,WAAA,GAAc,CAAC,KAAA,KAA8B;AACpD,IAAA,IAAI,IAAA,CAAK,KAAA,CAAM,KAAK,CAAA,EAAG,IAAA,CAAK,QAAQ,KAAA,CAAM,IAAA,KAAS,WAAA,GAAc,IAAA,GAAO,QAAQ,CAAA;AAAA,EAClF,CAAA;AACF,CAAA;;;ACJO,IAAM,iBAAN,MAAqB;AAAA,EACjB,WAAA;AAAA,EAET,YAAY,OAAA,EAAgC;AAC1C,IAAA,IAAA,CAAK,cAAc,OAAA,CAAQ,UAAA;AAAA,EAC7B;AAAA;AAAA,EAGA,MAAM,OAAA,EAAwB;AAC5B,IAAA,KAAA,MAAW,SAAA,IAAa,IAAA,CAAK,WAAA,EAAa,OAAA,CAAQ,gBAAgB,SAAS,CAAA;AAAA,EAC7E;AACF,CAAA;;;ACpFA,IAAM,cAAA,GAAiB,IAAI,cAAA,CAAe,EAAE,YAAY,CAAC,eAAe,GAAG,CAAA;AAE3E,IAAM,cAAA,GAAiB,IAAI,cAAA,CAAe,EAAE,YAAY,CAAC,cAAc,GAAG,CAAA;AAM1E,IAAM,iBAAA,GAAoB,sEAAA;AA8EnB,IAAM,qBAAA,GAAN,MAAM,sBAAA,SAA8B,UAAA,CAAwB;AAAA,EACjE,OAAgB,OAAA,GAAU,CAAC,QAAQ,CAAA;AAAA,EACnC,OAAgB,MAAA,GAAS;AAAA,IACvB,IAAA,EAAM,EAAE,IAAA,EAAM,MAAA,EAAQ,SAAS,MAAA,EAAO;AAAA,IACtC,SAAA,EAAW,EAAE,IAAA,EAAM,MAAA,EAAQ,SAAS,CAAA,EAAE;AAAA,IACtC,YAAA,EAAc,EAAE,IAAA,EAAM,MAAA,EAAQ,SAAS,EAAA,EAAG;AAAA,IAC1C,QAAA,EAAU,EAAE,IAAA,EAAM,OAAA,EAAS,SAAS,KAAA,EAAM;AAAA,IAC1C,MAAA,EAAQ,EAAE,IAAA,EAAM,OAAA,EAAS,SAAS,KAAA;AAAM,GAC1C;AAAA,EACA,OAAO,OAAA,GAAU,CAAC,OAAO,CAAA;AAAA,EACzB,OAAO,MAAA,GAAS,CAAC,OAAA,EAAS,MAAA,EAAQ,OAAO,QAAQ,CAAA;AAAA;AAAA,EAWjD,OAAgB,oBAAA,GAAuB,gCAAA;AAAA;AAAA,EAEvC,OAAgB,gBAAA,GAAmB,4BAAA;AAAA,EAEnC,QAAA,GAAkC,IAAA;AAAA,EAClC,SAAA,GAAoC,IAAA;AAAA;AAAA,EAEpC,WAAA,GAAc,EAAE,CAAA,EAAG,CAAA,EAAG,GAAG,CAAA,EAAE;AAAA;AAAA,EAElB,KAAA,GAAQ,IAAI,UAAA,EAAW;AAAA,EAEvB,OAAA,GAAgB;AAGvB,IAAA,IAAA,CAAK,MAAM,MAAA,EAAO;AAIlB,IAAA,IAAI,CAAC,IAAA,CAAK,QAAA,EAAU,cAAA,CAAe,KAAA,CAAM,KAAK,OAAO,CAAA;AACrD,IAAA,IAAI,CAAC,IAAA,CAAK,SAAA,EAAW,cAAA,CAAe,KAAA,CAAM,KAAK,OAAO,CAAA;AAKtD,IAAA,IAAI,KAAK,WAAA,IAAe,CAAC,KAAK,QAAA,IAAY,CAAC,KAAK,SAAA,EAAW;AACzD,MAAA,IAAA,CAAK,WAAA,GAAc,KAAK,gBAAA,EAAiB;AAAA,IAC3C;AAGA,IAAA,IAAA,CAAK,OAAA,CAAQ,gBAAA,CAAiB,aAAA,EAAe,IAAA,CAAK,cAAc,CAAA;AAChE,IAAA,IAAA,CAAK,OAAA,CAAQ,gBAAA,CAAiB,SAAA,EAAW,IAAA,CAAK,UAAU,CAAA;AACxD,IAAA,IAAI,CAAC,IAAA,CAAK,eAAA,EAAiB,IAAA,CAAK,cAAA,CAAe,KAAK,OAAO,CAAA;AAAA,EAC7D;AAAA,EAES,UAAA,GAAmB;AAC1B,IAAA,IAAA,CAAK,OAAA,CAAQ,mBAAA,CAAoB,aAAA,EAAe,IAAA,CAAK,cAAc,CAAA;AACnE,IAAA,IAAA,CAAK,OAAA,CAAQ,mBAAA,CAAoB,SAAA,EAAW,IAAA,CAAK,UAAU,CAAA;AAY3D,IAAA,IAAI,IAAA,CAAK,QAAA,IAAY,IAAA,CAAK,SAAA,EAAW;AACnC,MAAA,IAAA,CAAK,MAAM,YAAA,CAAa,IAAA,EAAM,MAAM,IAAA,CAAK,WAAW,CAAA;AACpD,MAAA;AAAA,IACF;AACA,IAAA,IAAA,CAAK,SAAA,EAAU;AAAA,EACjB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,KAAA,GAAc;AAGZ,IAAA,MAAM,IAAA,GAAO,KAAK,QAAA,EAAU,OAAA,GACxB,KAAK,QAAA,CAAS,WAAA,GACd,IAAA,CAAK,SAAA,GACH,UAAA,GACA,IAAA;AACN,IAAA,IAAI,IAAA,CAAK,QAAA,IAAY,IAAA,CAAK,SAAA,OAAgB,iBAAA,EAAkB;AAC5D,IAAA,IAAI,IAAA,EAAM,IAAA,CAAK,eAAA,CAAgB,IAAI,CAAA;AACnC,IAAA,IAAA,CAAK,WAAA,GAAc,EAAE,CAAA,EAAG,CAAA,EAAG,GAAG,CAAA,EAAE;AAChC,IAAA,IAAA,CAAK,YAAA,CAAa,GAAG,CAAC,CAAA;AAAA,EACxB;AAAA,EAEA,sBAAsB,MAAA,EAA2B;AAI/C,IAAA,IAAI,WAAW,IAAA,CAAK,OAAA,EAAS,IAAA,CAAK,cAAA,CAAe,KAAK,OAAO,CAAA;AAC7D,IAAA,IAAA,CAAK,eAAe,MAAM,CAAA;AAAA,EAC5B;AAAA,EAEA,yBAAyB,MAAA,EAA2B;AAMlD,IAAA,IAAA,CAAK,eAAe,MAAM,CAAA;AAO1B,IAAA,IAAI,IAAA,CAAK,OAAA,CAAQ,QAAA,CAAS,MAAM,CAAA,EAAG;AAOnC,IAAA,MAAM,WAAA,GACJ,IAAA,CAAK,QAAA,EAAU,MAAA,KAAW,UAAU,IAAA,CAAK,QAAA,CAAS,OAAA,GAC9C,IAAA,CAAK,SAAS,WAAA,GACd,IAAA,CAAK,SAAA,EAAW,MAAA,KAAW,SACxB,UAAA,GACD,IAAA;AACR,IAAA,IAAI,IAAA,CAAK,QAAA,EAAU,MAAA,KAAW,MAAA,OAAa,kBAAA,EAAmB;AAC9D,IAAA,IAAI,IAAA,CAAK,SAAA,EAAW,MAAA,KAAW,MAAA,OAAa,qBAAA,EAAsB;AAGlE,IAAA,IAAI,CAAC,IAAA,CAAK,eAAA,EAAiB,IAAA,CAAK,cAAA,CAAe,KAAK,OAAO,CAAA;AAC3D,IAAA,IAAI,WAAA,EAAa,IAAA,CAAK,eAAA,CAAgB,WAAW,CAAA;AAAA,EACnD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,gBAAA,CAAiB,QAAgB,aAAA,EAAyC;AAIxE,IAAA,MAAM,IAAA,GAAO,IAAA,CAAK,eAAA,CAAgB,aAAA,IAAiB,KAAK,SAAS,CAAA;AACjE,IAAA,KAAA,MAAW,MAAA,IAAU,IAAA,CAAK,QAAA,EAAS,EAAG;AACpC,MAAA,IAAI,CAAC,MAAA,CAAO,YAAA,CAAa,sBAAA,CAAsB,oBAAoB,CAAA,EAAG;AACtE,MAAA,IAAI,MAAA,CAAO,KAAA,CAAM,WAAA,KAAgB,IAAA,EAAM;AACvC,MAAA,MAAA,CAAO,KAAA,CAAM,WAAA,GAAc,IAAA,CAAK,mBAAA,EAAoB;AAAA,IACtD;AAAA,EACF;AAAA;AAAA,EAGA,oBAAA,GAA6B;AAC3B,IAAA,IAAI,CAAC,KAAK,aAAA,EAAe;AACzB,IAAA,IAAI,IAAA,CAAK,QAAA,EAAU,OAAA,IAAW,IAAA,CAAK,SAAA,EAAW;AAC5C,MAAA,IAAA,CAAK,gBAAgB,IAAA,CAAK,SAAA,GAAY,aAAc,IAAA,CAAK,QAAA,EAAU,eAAe,OAAQ,CAAA;AAAA,IAC5F;AACA,IAAA,IAAA,CAAK,iBAAA,EAAkB;AAAA,EACzB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOS,cAAA,GAAiB,CAAC,KAAA,KAA8B;AAIvD,IAAA,IAAI,IAAA,CAAK,iBAAiB,IAAA,CAAK,QAAA,IAAY,KAAK,SAAA,IAAa,KAAA,CAAM,WAAW,CAAA,EAAG;AACjF,IAAA,MAAM,MAAA,GAAS,IAAA,CAAK,UAAA,CAAW,KAAA,CAAM,MAAM,CAAA;AAC3C,IAAA,IAAI,CAAC,MAAA,EAAQ;AAKb,IAAA,KAAA,CAAM,cAAA,EAAe;AACrB,IAAA,MAAA,CAAO,KAAA,EAAM;AAEb,IAAA,MAAM,OAAA,GAA0B;AAAA,MAC9B,OAAA,EAAS,IAAA;AAAA,MACT,MAAA;AAAA,MACA,SAAS,KAAA,CAAM,OAAA;AAAA,MACf,SAAS,KAAA,CAAM,OAAA;AAAA,MACf,OAAA,EAAS,KAAA;AAAA,MACT,EAAA,EAAI,CAAA;AAAA,MACJ,EAAA,EAAI,CAAA;AAAA,MACJ,WAAA,EAAa,IAAA,CAAK,cAAA,CAAe,KAAK;AAAA,KACxC;AAIA,IAAA,OAAA,CAAQ,OAAA,GAAU,IAAI,mBAAA,CAAoB,KAAA,EAAO,MAAA,EAAQ;AAAA,MACvD,MAAM,CAAC,IAAA,KAAS,IAAA,CAAK,UAAA,CAAW,SAAS,IAAI,CAAA;AAAA,MAC7C,KAAK,CAAC,IAAA,KAAS,IAAA,CAAK,cAAA,CAAe,SAAS,IAAI;AAAA,KACjD,CAAA;AACD,IAAA,IAAA,CAAK,QAAA,GAAW,OAAA;AAAA,EAClB,CAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,UAAA,CAAW,SAAyB,KAAA,EAA2B;AAC7D,IAAA,MAAM,CAAC,EAAA,EAAI,EAAE,CAAA,GAAI,IAAA,CAAK,WAAA;AAAA,MACpB,KAAA,CAAM,UAAU,OAAA,CAAQ,OAAA;AAAA,MACxB,KAAA,CAAM,UAAU,OAAA,CAAQ;AAAA,KAC1B;AACA,IAAA,IAAI,CAAC,QAAQ,OAAA,EAAS;AACpB,MAAA,IAAI,KAAK,KAAA,CAAM,EAAA,EAAI,EAAE,CAAA,GAAI,KAAK,cAAA,EAAgB;AAC9C,MAAA,OAAA,CAAQ,OAAA,GAAU,IAAA;AAClB,MAAA,IAAA,CAAK,OAAA,CAAQ,YAAA,CAAa,eAAA,EAAiB,MAAM,CAAA;AACjD,MAAA,IAAA,CAAK,SAAS,OAAA,EAAS;AAAA,QACrB,MAAA,EAAQ,EAAE,CAAA,EAAG,KAAA,CAAM,OAAA,EAAS,GAAG,KAAA,CAAM,OAAA,EAAS,WAAA,EAAa,OAAA,CAAQ,WAAA;AAAY,OAChF,CAAA;AAAA,IACH;AAEA,IAAA,OAAA,CAAQ,EAAA,GAAK,EAAA;AACb,IAAA,OAAA,CAAQ,EAAA,GAAK,EAAA;AACb,IAAA,IAAA,CAAK,WAAA,CAAY,IAAI,EAAE,CAAA;AACvB,IAAA,IAAA,CAAK,SAAS,MAAA,EAAQ;AAAA,MACpB,MAAA,EAAQ,EAAE,EAAA,EAAI,EAAA,EAAI,CAAA,EAAG,KAAA,CAAM,OAAA,EAAS,CAAA,EAAG,KAAA,CAAM,OAAA,EAAS,WAAA,EAAa,OAAA,CAAQ,WAAA;AAAY,KACxF,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,cAAA,CAAe,SAAyB,IAAA,EAAoC;AAC1E,IAAA,MAAM,EAAE,OAAA,EAAS,EAAA,EAAI,EAAA,EAAI,aAAY,GAAI,OAAA;AACzC,IAAA,IAAA,CAAK,QAAA,GAAW,IAAA;AAChB,IAAA,IAAA,CAAK,OAAA,CAAQ,gBAAgB,eAAe,CAAA;AAC5C,IAAA,IAAI,IAAA,KAAS,UAAA,IAAc,CAAC,OAAA,EAAS;AACrC,IAAA,IAAI,SAAS,IAAA,EAAM;AACjB,MAAA,IAAA,CAAK,aAAA,CAAc,IAAI,EAAE,CAAA;AACzB,MAAA,IAAA,CAAK,QAAA,CAAS,OAAO,EAAE,MAAA,EAAQ,EAAE,EAAA,EAAI,EAAA,EAAI,WAAA,EAAY,EAAG,CAAA;AACxD,MAAA;AAAA,IACF;AACA,IAAA,IAAA,CAAK,gBAAgB,WAAW,CAAA;AAAA,EAClC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQS,UAAA,GAAa,CAAC,KAAA,KAA+B;AACpD,IAAA,IAAI,KAAK,aAAA,EAAe;AACxB,IAAA,MAAM,MAAA,GAAS,IAAA,CAAK,UAAA,CAAW,KAAA,CAAM,MAAM,CAAA;AAC3C,IAAA,IAAI,CAAC,MAAA,EAAQ;AAKb,IAAA,IAAI,MAAM,gBAAA,EAAkB;AAG5B,IAAA,IAAI,MAAM,WAAA,EAAa;AAIvB,IAAA,IAAI,IAAA,CAAK,eAAA,CAAgB,KAAA,CAAM,MAAA,EAAQ,MAAM,CAAA,EAAG;AAGhD,IAAA,IAAI,oBAAA,CAAqB,KAAK,CAAA,EAAG;AAGjC,IAAA,IAAI,KAAA,CAAM,QAAQ,QAAA,EAAU;AAC1B,MAAA,IAAI,IAAA,CAAK,UAAU,OAAA,EAAS;AAC1B,QAAA,MAAM,EAAE,WAAA,EAAY,GAAI,IAAA,CAAK,QAAA;AAC7B,QAAA,IAAA,CAAK,iBAAA,EAAkB;AACvB,QAAA,KAAA,CAAM,cAAA,EAAe;AACrB,QAAA,IAAA,CAAK,gBAAgB,WAAW,CAAA;AAAA,MAClC,CAAA,MAAA,IAAW,KAAK,SAAA,EAAW;AACzB,QAAA,IAAA,CAAK,iBAAA,EAAkB;AACvB,QAAA,KAAA,CAAM,cAAA,EAAe;AACrB,QAAA,IAAA,CAAK,gBAAgB,UAAU,CAAA;AAAA,MACjC;AACA,MAAA;AAAA,IACF;AAEA,IAAA,IAAI,KAAA,CAAM,GAAA,KAAQ,GAAA,IAAO,KAAA,CAAM,QAAQ,OAAA,EAAS;AAG9C,MAAA,IAAI,KAAK,QAAA,EAAU;AACnB,MAAA,KAAA,CAAM,cAAA,EAAe;AACrB,MAAA,IAAI,IAAA,CAAK,SAAA,EAAW,IAAA,CAAK,aAAA,EAAc;AAAA,WAClC,IAAA,CAAK,cAAc,MAAM,CAAA;AAC9B,MAAA;AAAA,IACF;AAEA,IAAA,IAAI,CAAC,KAAK,SAAA,EAAW;AAMrB,IAAA,IAAI,KAAA,CAAM,GAAA,KAAQ,MAAA,IAAU,KAAA,CAAM,QAAQ,KAAA,EAAO;AAC/C,MAAA,KAAA,CAAM,cAAA,EAAe;AACrB,MAAA;AAAA,IACF;AACA,IAAA,MAAM,IAAA,GAAO,IAAA,CAAK,cAAA,CAAe,KAAA,CAAM,GAAG,CAAA;AAC1C,IAAA,IAAI,CAAC,IAAA,EAAM;AAGX,IAAA,KAAA,CAAM,cAAA,EAAe;AACrB,IAAA,MAAM,CAAC,EAAA,EAAI,EAAE,CAAA,GAAI,IAAA,CAAK,WAAA,CAAY,IAAA,CAAK,CAAC,CAAA,EAAG,IAAA,CAAK,CAAC,CAAC,CAAA;AAClD,IAAA,IAAI,EAAA,KAAO,CAAA,IAAK,EAAA,KAAO,CAAA,EAAG;AAC1B,IAAA,IAAA,CAAK,UAAU,EAAA,IAAM,EAAA;AACrB,IAAA,IAAA,CAAK,UAAU,EAAA,IAAM,EAAA;AACrB,IAAA,IAAA,CAAK,YAAY,IAAA,CAAK,SAAA,CAAU,EAAA,EAAI,IAAA,CAAK,UAAU,EAAE,CAAA;AACrD,IAAA,IAAA,CAAK,SAAS,MAAA,EAAQ;AAAA,MACpB,MAAA,EAAQ;AAAA,QACN,EAAA,EAAI,KAAK,SAAA,CAAU,EAAA;AAAA,QACnB,EAAA,EAAI,KAAK,SAAA,CAAU,EAAA;AAAA,QACnB,CAAA,EAAG,KAAK,SAAA,CAAU,EAAA;AAAA,QAClB,CAAA,EAAG,KAAK,SAAA,CAAU,EAAA;AAAA,QAClB,WAAA,EAAa;AAAA;AACf,KACD,CAAA;AAAA,EACH,CAAA;AAAA;AAAA,EAGA,cAAc,MAAA,EAA2B;AACvC,IAAA,IAAA,CAAK,YAAY,EAAE,MAAA,EAAQ,EAAA,EAAI,CAAA,EAAG,IAAI,CAAA,EAAE;AACxC,IAAA,IAAA,CAAK,OAAA,CAAQ,YAAA,CAAa,cAAA,EAAgB,MAAM,CAAA;AAChD,IAAA,MAAA,CAAO,YAAA,CAAa,gBAAgB,MAAM,CAAA;AAC1C,IAAA,IAAA,CAAK,QAAA,CAAS,OAAA,EAAS,EAAE,MAAA,EAAQ,EAAE,CAAA,EAAG,CAAA,EAAG,CAAA,EAAG,CAAA,EAAG,WAAA,EAAa,UAAA,EAAW,EAAG,CAAA;AAAA,EAC5E;AAAA,EAEA,aAAA,GAAsB;AACpB,IAAA,MAAM,UAAU,IAAA,CAAK,SAAA;AACrB,IAAA,IAAI,CAAC,OAAA,EAAS;AACd,IAAA,IAAA,CAAK,qBAAA,EAAsB;AAC3B,IAAA,IAAA,CAAK,aAAA,CAAc,OAAA,CAAQ,EAAA,EAAI,OAAA,CAAQ,EAAE,CAAA;AACzC,IAAA,IAAA,CAAK,QAAA,CAAS,KAAA,EAAO,EAAE,MAAA,EAAQ,EAAE,EAAA,EAAI,OAAA,CAAQ,EAAA,EAAI,EAAA,EAAI,OAAA,CAAQ,EAAA,EAAI,WAAA,EAAa,UAAA,IAAc,CAAA;AAAA,EAC9F;AAAA;AAAA,EAGA,eAAe,GAAA,EAAsC;AACnD,IAAA,MAAM,OAAO,IAAA,CAAK,iBAAA;AAClB,IAAA,QAAQ,GAAA;AAAK,MACX,KAAK,YAAA;AACH,QAAA,OAAO,CAAC,MAAM,CAAC,CAAA;AAAA,MACjB,KAAK,WAAA;AACH,QAAA,OAAO,CAAC,CAAC,IAAA,EAAM,CAAC,CAAA;AAAA,MAClB,KAAK,WAAA;AACH,QAAA,OAAO,CAAC,GAAG,IAAI,CAAA;AAAA,MACjB,KAAK,SAAA;AACH,QAAA,OAAO,CAAC,CAAA,EAAG,CAAC,IAAI,CAAA;AAAA,MAClB;AACE,QAAA,OAAO,IAAA;AAAA;AACX,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,WAAA,CAAY,IAAY,EAAA,EAA8B;AACpD,IAAA,IAAI,KAAK,SAAA,KAAc,GAAA,EAAK,OAAO,CAAC,IAAI,CAAC,CAAA;AACzC,IAAA,IAAI,KAAK,SAAA,KAAc,GAAA,EAAK,OAAO,CAAC,GAAG,EAAE,CAAA;AACzC,IAAA,OAAO,CAAC,IAAI,EAAE,CAAA;AAAA,EAChB;AAAA;AAAA,EAGA,kBAAA,GAA2B;AACzB,IAAA,IAAA,CAAK,QAAA,EAAU,SAAS,GAAA,EAAI;AAAA,EAC9B;AAAA,EAEA,qBAAA,GAA8B;AAC5B,IAAA,IAAA,CAAK,SAAA,EAAW,MAAA,CAAO,eAAA,CAAgB,cAAc,CAAA;AACrD,IAAA,IAAA,CAAK,SAAA,GAAY,IAAA;AACjB,IAAA,IAAA,CAAK,OAAA,CAAQ,gBAAgB,cAAc,CAAA;AAAA,EAC7C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWA,SAAA,GAAkB;AAIhB,IAAA,IAAA,CAAK,MAAM,MAAA,EAAO;AAClB,IAAA,MAAM,WAAA,GAAc,KAAK,QAAA,EAAU,OAAA,GAC/B,KAAK,QAAA,CAAS,WAAA,GACd,IAAA,CAAK,SAAA,GACF,UAAA,GACD,IAAA;AACN,IAAA,IAAA,CAAK,iBAAA,EAAkB;AACvB,IAAA,KAAA,MAAW,UAAU,IAAA,CAAK,QAAA,EAAS,EAAG,IAAA,CAAK,eAAe,MAAM,CAAA;AAGhE,IAAA,IAAA,CAAK,YAAA,EAAa;AAClB,IAAA,IAAI,eAAe,IAAA,CAAK,OAAA,CAAQ,WAAA,EAAa,IAAA,CAAK,gBAAgB,WAAW,CAAA;AAAA,EAC/E;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,iBAAA,GAA0B;AACxB,IAAA,IAAA,CAAK,kBAAA,EAAmB;AACxB,IAAA,IAAA,CAAK,qBAAA,EAAsB;AAAA,EAC7B;AAAA,EAEA,gBAAgB,WAAA,EAAoC;AAGlD,IAAA,IAAA,CAAK,YAAA,EAAa;AAClB,IAAA,IAAA,CAAK,SAAS,QAAA,EAAU,EAAE,QAAQ,EAAE,WAAA,IAAe,CAAA;AAAA,EACrD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,WAAA,CAAY,IAAY,EAAA,EAAkB;AACxC,IAAA,IAAI,CAAC,KAAK,WAAA,EAAa;AACvB,IAAA,IAAA,CAAK,YAAA,CAAa,KAAK,WAAA,CAAY,CAAA,GAAI,IAAI,IAAA,CAAK,WAAA,CAAY,IAAI,EAAE,CAAA;AAAA,EACpE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,aAAA,CAAc,IAAY,EAAA,EAAkB;AAC1C,IAAA,IAAI,CAAC,KAAK,WAAA,EAAa;AACvB,IAAA,IAAA,CAAK,WAAA,GAAc,EAAE,CAAA,EAAG,IAAA,CAAK,WAAA,CAAY,CAAA,GAAI,EAAA,EAAI,CAAA,EAAG,IAAA,CAAK,WAAA,CAAY,CAAA,GAAI,EAAA,EAAG;AAC5E,IAAA,IAAA,CAAK,aAAa,IAAA,CAAK,WAAA,CAAY,CAAA,EAAG,IAAA,CAAK,YAAY,CAAC,CAAA;AAAA,EAC1D;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,YAAA,GAAqB;AACnB,IAAA,IAAI,CAAC,KAAK,WAAA,EAAa;AACvB,IAAA,IAAA,CAAK,aAAa,IAAA,CAAK,WAAA,CAAY,CAAA,EAAG,IAAA,CAAK,YAAY,CAAC,CAAA;AAAA,EAC1D;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,YAAA,CAAa,GAAW,CAAA,EAAiB;AACvC,IAAA,IAAI,CAAA,KAAM,KAAK,CAAA,KAAM,CAAA,OAAQ,OAAA,CAAQ,KAAA,CAAM,eAAe,WAAW,CAAA;AAAA,SAChE,IAAA,CAAK,QAAQ,KAAA,CAAM,WAAA,CAAY,aAAa,CAAA,EAAG,CAAC,CAAA,GAAA,EAAM,CAAC,CAAA,EAAA,CAAI,CAAA;AAAA,EAClE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,gBAAA,GAA6C;AAC3C,IAAA,MAAM,MAAM,IAAA,CAAK,OAAA,CAAQ,MAAM,gBAAA,CAAiB,WAAW,EAAE,IAAA,EAAK;AAClE,IAAA,MAAM,KAAA,GAAQ,kDAAA,CAAmD,IAAA,CAAK,GAAG,CAAA;AACzE,IAAA,IAAI,CAAC,KAAA,EAAO,OAAO,EAAE,CAAA,EAAG,CAAA,EAAG,GAAG,CAAA,EAAE;AAChC,IAAA,OAAO,EAAE,CAAA,EAAG,MAAA,CAAO,KAAA,CAAM,CAAC,CAAC,CAAA,EAAG,CAAA,EAAG,MAAA,CAAO,KAAA,CAAM,CAAC,CAAA,IAAK,GAAG,CAAA,EAAE;AAAA,EAC3D;AAAA;AAAA,EAGA,QAAA,GAA0B;AACxB,IAAA,OAAO,KAAK,eAAA,GAAkB,IAAA,CAAK,aAAA,GAAgB,CAAC,KAAK,OAAO,CAAA;AAAA,EAClE;AAAA;AAAA,EAGA,WAAW,MAAA,EAAgD;AACzD,IAAA,OAAO,OAAA,CAAQ,IAAA,CAAK,QAAA,EAAS,EAAG,MAAM,CAAA;AAAA,EACxC;AAAA,EAEA,eAAe,KAAA,EAAsC;AACnD,IAAA,MAAM,OAAO,KAAA,CAAM,WAAA;AACnB,IAAA,IAAI,IAAA,KAAS,OAAA,IAAW,IAAA,KAAS,KAAA,EAAO,OAAO,IAAA;AAC/C,IAAA,OAAO,OAAA;AAAA,EACT;AAAA;AAAA,EAGA,mBAAA,GAA8B;AAC5B,IAAA,OAAO,IAAA,CAAK,eAAA,CAAgB,IAAA,CAAK,SAAS,CAAA;AAAA,EAC5C;AAAA;AAAA,EAGA,gBAAgB,IAAA,EAAsB;AACpC,IAAA,IAAI,IAAA,KAAS,KAAK,OAAO,OAAA;AACzB,IAAA,IAAI,IAAA,KAAS,KAAK,OAAO,OAAA;AACzB,IAAA,OAAO,MAAA;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWA,eAAe,MAAA,EAA2B;AACxC,IAAA,MAAM,IAAA,GAAO,KAAK,mBAAA,EAAoB;AAItC,IAAA,MAAM,MAAA,GAAS,MAAA,CAAO,YAAA,CAAa,sBAAA,CAAsB,oBAAoB,CAAA;AAC7E,IAAA,IAAI,MAAA,CAAO,MAAM,WAAA,KAAgB,EAAA,IAAO,UAAU,MAAA,CAAO,KAAA,CAAM,gBAAgB,IAAA,EAAO;AACpF,MAAA,MAAA,CAAO,MAAM,WAAA,GAAc,IAAA;AAC3B,MAAA,MAAA,CAAO,YAAA,CAAa,sBAAA,CAAsB,oBAAA,EAAsB,MAAM,CAAA;AAAA,IACxE;AACA,IAAA,IAAI,OAAO,QAAA,GAAW,CAAA,IAAK,CAAC,MAAA,CAAO,YAAA,CAAa,UAAU,CAAA,EAAG;AAC3D,MAAA,MAAA,CAAO,YAAA,CAAa,YAAY,GAAG,CAAA;AACnC,MAAA,MAAA,CAAO,YAAA,CAAa,sBAAA,CAAsB,gBAAA,EAAkB,MAAM,CAAA;AAAA,IACpE;AAAA,EACF;AAAA;AAAA,EAGA,eAAA,CAAgB,QAA4B,MAAA,EAA8B;AACxE,IAAA,MAAM,KAAA,GAAS,MAAA,EAA2B,OAAA,CAAQ,iBAAiB,CAAA,IAAK,IAAA;AACxE,IAAA,OAAO,UAAU,IAAA,IAAQ,KAAA,KAAU,MAAA,IAAU,MAAA,CAAO,SAAS,KAAK,CAAA;AAAA,EACpE;AAAA;AAAA,EAGA,eAAe,MAAA,EAA2B;AACxC,IAAA,IAAI,MAAA,CAAO,YAAA,CAAa,sBAAA,CAAsB,oBAAoB,CAAA,EAAG;AAInE,MAAA,IAAI,MAAA,CAAO,KAAA,CAAM,WAAA,KAAgB,IAAA,CAAK,qBAAoB,EAAG;AAC3D,QAAA,MAAA,CAAO,MAAM,WAAA,GAAc,EAAA;AAAA,MAC7B;AACA,MAAA,MAAA,CAAO,eAAA,CAAgB,uBAAsB,oBAAoB,CAAA;AAAA,IACnE;AACA,IAAA,IAAI,MAAA,CAAO,YAAA,CAAa,sBAAA,CAAsB,gBAAgB,CAAA,EAAG;AAK/D,MAAA,MAAM,IAAA,GAAO,MAAA,CAAO,YAAA,CAAa,UAAU,CAAA,KAAM,GAAA;AACjD,MAAA,IAAI,IAAA,IAAQ,QAAA,CAAS,aAAA,KAAkB,MAAA,EAAQ;AAC7C,QAAA,MAAA,CAAO,gBAAgB,UAAU,CAAA;AACjC,QAAA,MAAA,CAAO,eAAA,CAAgB,uBAAsB,gBAAgB,CAAA;AAC7D,QAAA;AAAA,MACF;AAKA,MAAA,IAAI,CAAC,IAAA,EAAM,MAAA,CAAO,eAAA,CAAgB,uBAAsB,gBAAgB,CAAA;AAAA,IAC1E;AAAA,EACF;AACF","file":"pointer_drag_controller.js","sourcesContent":["import { isRtl } from \"./logical_scroll\";\n\n/**\n * Turns an arrow key into a **logical** step: `+1` for \"next\", `-1` for\n * \"previous\", `0` when the key names neither.\n *\n * APG defines the horizontal pair as *next / previous* and says a vertical\n * arrangement swaps in Down/Up for the same meaning — so the pair is one axis's\n * spelling of an order, and the order reverses with the writing direction. Only\n * the horizontal pair reverses. Down/Up name an axis the writing direction does\n * not mirror, and returning them unchanged is the point: many controllers fold\n * both pairs into one branch, where swapping the branches under RTL would flip\n * the vertical axis too — a bug that reads as \"the arrows work\" until someone\n * presses Down.\n *\n * **Direction is read from the element the caller passes, which should be the\n * container that lays the items out** — not the focused child. A child may carry\n * its own `dir` (an LTR input inside an RTL form is ordinary authoring), and\n * probing per handler makes two handlers disagree at the boundary between them.\n *\n * This decides direction only. Whether the axis is even active (an\n * `orientation=\"horizontal\"` widget ignoring Down/Up), how far the step lands,\n * and what wrapping does all stay with the caller.\n *\n * **It encodes the list-order convention: `ArrowDown` is *next*.** Widgets that\n * pair the arrows by *value* instead — `ArrowUp` meaning \"more\", as a rating or a\n * slider does — must not use this, or their vertical axis inverts. Reverse the\n * horizontal pair on its own there.\n *\n * @example\n * ```ts\n * const step = logicalArrowStep(event.key, this.element);\n * if (step === 0) return;\n * this.#roving.setActive(rovingMove(current, length, step, \"wrap\"), { focus: true });\n * ```\n */\nexport function logicalArrowStep(key: string, element: Element): 1 | -1 | 0 {\n if (key === \"ArrowDown\") return 1;\n if (key === \"ArrowUp\") return -1;\n if (key !== \"ArrowRight\" && key !== \"ArrowLeft\") return 0;\n const forward = isRtl(element) ? \"ArrowLeft\" : \"ArrowRight\";\n return key === forward ? 1 : -1;\n}\n\n/**\n * Rewrites `key` so an existing LTR-shaped branch keeps working under RTL:\n * `ArrowRight` and `ArrowLeft` trade places, everything else passes through.\n *\n * The alternative — negating a delta — silently breaks handlers whose two\n * horizontal branches are **not mirror images**. A grid that clamps one edge but\n * not the other, or a segmented field guarding `index > 0` on one side and\n * `index < length - 1` on the other, ends up applying the wrong guard to the\n * wrong direction. Swapping the key leaves each branch, guards and all, exactly\n * where its author put it.\n *\n * Same rule as {@link logicalArrowStep} about which element to read: pass the\n * container that lays the items out, not the focused child.\n *\n * @example\n * ```ts\n * switch (logicalArrowKey(event.key, this.element)) {\n * case \"ArrowLeft\": // \"previous\" — whatever direction that is on screen\n * ```\n */\nexport function logicalArrowKey(key: string, element: Element): string {\n if (key !== \"ArrowRight\" && key !== \"ArrowLeft\") return key;\n if (!isRtl(element)) return key;\n return key === \"ArrowRight\" ? \"ArrowLeft\" : \"ArrowRight\";\n}\n\n/** Modifiers a widget may claim on an arrow key, named for the `allow` list. */\nexport type ArrowModifier = \"alt\" | \"ctrl\" | \"meta\" | \"shift\";\n\n/**\n * True when an arrow key arrived carrying a modifier the widget must leave to\n * the browser: return without calling `preventDefault()` and without moving any\n * state.\n *\n * A bare arrow belongs to the widget; a chorded one usually does not.\n * `Alt`/`Meta` plus a horizontal arrow is history back/forward on every desktop\n * browser, and a widget that swallows it makes the shortcut work or not\n * depending on where focus happens to sit — a coin-flip the user cannot see.\n *\n * `allow` is for the combinations APG assigns to a pattern **and the widget\n * actually implements** — today only Combobox's optional `Alt+Down`/`Alt+Up`.\n * Listing one the widget does not implement defeats the point: the chord then\n * runs the plain-arrow branch, which is exactly what this guard exists to stop.\n * Non-arrow keys return `false`, so chorded letters and\n * `Control+Home`/`Control+End` are untouched.\n *\n * @example\n * ```ts\n * if (isReservedArrowChord(event)) return;\n * ```\n */\nexport function isReservedArrowChord(\n event: KeyboardEvent,\n allow: readonly ArrowModifier[] = [],\n): boolean {\n if (!event.key.startsWith(\"Arrow\")) return false;\n return (\n (event.altKey && !allow.includes(\"alt\")) ||\n (event.ctrlKey && !allow.includes(\"ctrl\")) ||\n (event.metaKey && !allow.includes(\"meta\")) ||\n (event.shiftKey && !allow.includes(\"shift\"))\n );\n}\n\n/**\n * True when a press arrived carrying any modifier, for the keys the browser and\n * the OS own outright: return without calling `preventDefault()` and without\n * moving any state.\n *\n * `Control+Home` and `Control+End` jump the document to its ends, and a widget\n * that swallows them makes the shortcut work or not depending on where focus\n * happens to sit. {@link isReservedArrowChord} answers the same question for the\n * arrows, but returns `false` for every other key so that this one can decide.\n *\n * There is no `allow` list here on purpose. APG assigns no modifier chord to\n * `Home`/`End`, so a widget that wanted one would be claiming a combination the\n * pattern never gave it.\n *\n * @example\n * ```ts\n * case \"Home\":\n * case \"End\":\n * if (hasModifierChord(event)) return;\n * ```\n */\nexport function hasModifierChord(event: KeyboardEvent): boolean {\n return event.altKey || event.ctrlKey || event.metaKey || event.shiftKey;\n}\n","/**\n * Shared \"in-page move vs real detach\" discriminator for `disconnect()`.\n *\n * A mid-session `disconnect()` whose element is still in the document is\n * ambiguous. It can be:\n *\n * - an **in-page move** — a consumer (sortable, a teleport) re-inserted the\n * element; Stimulus reconnects the SAME instance in the same mutation batch\n * and the controller's runtime state must survive;\n * - a **detach that keeps the element** — `data-controller` no longer lists the\n * identifier (a Turbo 8 morph), or the element moved outside the observed\n * root (a scoped `Application.start(root)`, a shadow root); no reconnect will\n * ever come and the controller must tear down or it leaks its sessions,\n * document listeners, and moved nodes.\n *\n * Neither available signal decides this alone. A synchronous `data-controller`\n * token check catches the morph case but misses an observed-root exit (the\n * token stays, the reconnect never comes). Deferring teardown one microtask and\n * letting `connect()` cancel it catches the root exit, but leans on Stimulus\n * reconnecting moved elements within the same mutation batch — internal\n * behavior, not a public contract. {@link DetachGate} composes both: the token\n * check is the synchronous fast path (no probe, no reliance on batching), the\n * microtask probe is the fallback for the genuinely ambiguous remainder.\n *\n * Policy stays with the consumer; this util owns the discrimination only:\n *\n * - **Probe** ({@link disconnected}) when the teardown must eventually happen —\n * live drag sessions, document listeners, teleported *content*. Call\n * {@link cancel} from `connect()` (a reconnect means in-page move) and from\n * the head of any direct teardown path (see below).\n * - **Keep** (bare {@link DetachGate.isDetached}) when undoing the ambiguous\n * case would fight the controller's own effect: a controller that moves its\n * OWN element (portal's no-`content` form) exits a scoped observed root as\n * its normal job — a probe-driven teardown would restore the element into\n * the root, reconnect, re-teleport, and disconnect again, forever. Such\n * controllers keep their state on an ambiguous disconnect and tear down only\n * on {@link DetachGate.isDetached}.\n *\n * Event convention for probe consumers: teardown into a dead (detached) tree is\n * silent — consumers restore from their own `connect()`; a detach that keeps the\n * tree alive must end an in-flight session with a `cancel` event, or composing\n * consumers strand their session bookkeeping.\n */\n\n/** The slice of a Stimulus controller the gate inspects. */\nexport interface DetachGateHost {\n readonly element: Element;\n readonly identifier: string;\n}\n\n/**\n * Per-controller-instance gate deciding whether a `disconnect()` is a real\n * detach. Hold one per controller (`#gate = new DetachGate()`) — Stimulus\n * reuses the instance across reconnects, so the pending probe state carries\n * over exactly as the protocol needs.\n *\n * @example\n * ```ts\n * #gate = new DetachGate();\n *\n * connect(): void {\n * this.#gate.cancel(); // a reconnect: the element moved in-page\n * // …\n * }\n *\n * disconnect(): void {\n * this.#gate.disconnected(this, () => this.#teardown());\n * }\n *\n * #teardown(): void {\n * this.#gate.cancel(); // disarm a still-queued probe (double-run guard)\n * // …\n * }\n * ```\n */\nexport class DetachGate {\n /** Set while a probe is queued, waiting for a reconnect to cancel it. */\n #pending = false;\n\n /**\n * True while a probe is queued — the last disconnect was ambiguous and no\n * reconnect has cancelled it yet. Read it from `connect()` to tell the\n * reconnect half of an in-page move from a first connect: a controller whose\n * initialisation restarts a measurement (a min-duration floor, an elapsed\n * counter) must skip it for the move, where nothing actually restarted.\n */\n get pending(): boolean {\n return this.#pending;\n }\n\n /**\n * True when the disconnect is definitely a real detach — the element left\n * the document, or `data-controller` no longer lists the identifier. False\n * means ambiguous (in-page move or observed-root exit), NOT \"alive\".\n */\n static isDetached(host: DetachGateHost): boolean {\n if (!host.element.isConnected) return true;\n const tokens = (host.element.getAttribute(\"data-controller\") ?? \"\").split(/\\s+/);\n return !tokens.includes(host.identifier);\n }\n\n /**\n * Call from `disconnect()`: runs `teardown` synchronously on a definite\n * detach (fast path), otherwise defers it one microtask — a reconnect\n * ({@link cancel} from `connect()`) keeps the state, no reconnect runs it.\n * One microtask is the whole probe window: Stimulus reconnects a moved\n * element within the same mutation batch, before the checkpoint drains.\n */\n disconnected(host: DetachGateHost, teardown: () => void): void {\n if (DetachGate.isDetached(host)) {\n // Also disarms a probe a previous ambiguous disconnect left queued\n // (defer, element removed, disconnect again) — exactly one teardown.\n this.#pending = false;\n teardown();\n return;\n }\n this.#pending = true;\n queueMicrotask(() => {\n if (!this.#pending) return;\n this.#pending = false;\n teardown();\n });\n }\n\n /**\n * Disarms a pending probe. Call from `connect()` (the reconnect that proves\n * an in-page move) and from the head of any teardown path not routed through\n * {@link disconnected} (disabled-toggle, Escape), so an orphaned probe can\n * never run the teardown a second time.\n */\n cancel(): void {\n this.#pending = false;\n }\n}\n","/**\n * Resolves which of a controller's elements owns a node.\n *\n * A delegated listener hears events from a whole subtree, so the handler's first\n * job is almost always the same question: which item, handle, or control does\n * this `event.target` belong to? The same question comes up for a\n * `MutationRecord.target`, for `document.activeElement`, and for a\n * `relatedTarget` on the way out of a hover region.\n *\n * The answer is `Node.contains()`, which is **inclusive** — an element contains\n * itself — so testing the candidate for identity as well would be redundant.\n *\n * **The guard is what makes this safe to call with a raw event target.**\n * `event.target` is typed `EventTarget | null`, and `contains()` takes a `Node?`:\n * browsers throw `TypeError` for anything else, and `window` — the everyday\n * `EventTarget` that is not a `Node` — is what an event dispatched at it carries.\n * Narrowing here means a caller never has to cast, and the rule cannot drift\n * between the places that ask the question.\n *\n * Scope stays with the caller. These helpers say *which candidate owns the node*,\n * not *whether the node belongs to this controller at all* — a component with\n * nested instances of itself decides that first (by comparing the closest\n * annotated ancestor) and passes the candidates it owns.\n */\n\n/**\n * Index in `candidates` of the first one that is, or contains, `node`.\n *\n * `-1` when none does, when `node` is absent, and when it is an `EventTarget`\n * that is not a `Node`. Candidates are tested in array order, so a nested pair\n * resolves to whichever the caller listed first.\n */\nexport function ownerIndex<T extends Element>(\n candidates: readonly T[],\n node: EventTarget | null | undefined,\n): number {\n if (!(node instanceof Node)) return -1;\n return candidates.findIndex((candidate) => candidate.contains(node));\n}\n\n/**\n * The first candidate that is, or contains, `node`; `null` when none does.\n *\n * A miss indexes the array at `-1`, which reads as `undefined` and lands on the\n * same `null` the absent cases produce.\n */\nexport function ownerOf<T extends Element>(\n candidates: readonly T[],\n node: EventTarget | null | undefined,\n): T | null {\n return candidates[ownerIndex(candidates, node)] ?? null;\n}\n","/** What ended an owned pointer session. */\nexport type OwnedPointerSessionEnd = \"up\" | \"cancel\" | \"teardown\";\n\n/** Callbacks driven by one owned pointer until it ends or is cancelled. */\nexport interface OwnedPointerSessionHandlers {\n /** Receives movement from the initiating pointer only. */\n readonly move: (event: PointerEvent) => void;\n /**\n * Runs once after every listener and pointer capture have been released,\n * naming what ended the session.\n */\n readonly end?: (kind: OwnedPointerSessionEnd) => void;\n}\n\n/**\n * Owns one pointer across document-level movement and termination events.\n *\n * A controller may have at most one instance at a time. The session filters\n * every event by the initiating `pointerId` and binds all document listeners to\n * one abort signal, so exactly one callback runs when the session ends.\n *\n * **Pointer capture is delivery, not lifetime.** It is taken when the DOM\n * implementation supports it, and losing it — a consumer re-inserting the owner\n * mid-gesture, another element claiming the pointer — never ends the session:\n * the document listeners receive the pointer either way, because a captured\n * event still bubbles to the document and an uncaptured one fires there anyway.\n * An owner that actually left the tree is the owner's own business; every\n * consumer already answers that question with its own detach probe, and a\n * second answer here would cut gestures the consumer means to keep.\n */\nexport class OwnedPointerSession {\n readonly #pointerId: number;\n readonly #owner: HTMLElement;\n readonly #handlers: OwnedPointerSessionHandlers;\n readonly #abort = new AbortController();\n #active = true;\n\n constructor(start: PointerEvent, owner: HTMLElement, handlers: OwnedPointerSessionHandlers) {\n this.#pointerId = start.pointerId;\n this.#owner = owner;\n this.#handlers = handlers;\n\n const { signal } = this.#abort;\n owner.ownerDocument.addEventListener(\"pointermove\", this.#onMove, { signal });\n owner.ownerDocument.addEventListener(\"pointerup\", this.#onEndEvent, { signal });\n owner.ownerDocument.addEventListener(\"pointercancel\", this.#onEndEvent, { signal });\n\n // Pointer capture is progressive here: happy-dom and older DOM shims may not\n // implement it, while the document listeners still preserve ownership.\n try {\n owner.setPointerCapture?.(this.#pointerId);\n } catch {\n // A synthetic or already-ended pointer cannot be captured; filtering and\n // AbortController teardown remain sufficient for that environment.\n }\n }\n\n /** Releases capture and listeners, then reports the end exactly once. */\n end(): void {\n this.#finish(\"teardown\");\n }\n\n #finish(kind: OwnedPointerSessionEnd): void {\n if (!this.#active) return;\n this.#active = false;\n this.#abort.abort();\n try {\n this.#owner.releasePointerCapture?.(this.#pointerId);\n } catch {\n // Losing capture because the owner detached is already an ended session.\n }\n this.#handlers.end?.(kind);\n }\n\n #owns(event: PointerEvent): boolean {\n return this.#active && event.pointerId === this.#pointerId;\n }\n\n readonly #onMove = (event: PointerEvent): void => {\n if (this.#owns(event)) this.#handlers.move(event);\n };\n\n readonly #onEndEvent = (event: PointerEvent): void => {\n if (this.#owns(event)) this.#finish(event.type === \"pointerup\" ? \"up\" : \"cancel\");\n };\n}\n","/**\n * Drops the transient state hooks a connection inherited, so the cycle it opens\n * starts from a DOM that claims nothing.\n *\n * A transient hook is an attribute a controller writes to say \"this is happening\n * right now\" — a drag in progress, a form with unsaved edits, a refused\n * subscription. Its lifetime belongs to the interaction, not to the element, and\n * the two come apart whenever the element outlives the instance that wrote it: a\n * Turbo cache snapshot taken mid-interaction restores the hook with the markup,\n * and an element re-inserted elsewhere in the page carries it along. Nothing\n * takes such a hook off, because the instance that owned it is gone; consumer\n * CSS then keeps claiming a state no one is in.\n *\n * **`turbo:before-cache` cannot do this job**, which is why the pass belongs in\n * `connect()`: that event fires for a navigation only, so an in-page move — the\n * other half of the population — never reaches it, and a hook that arrived with\n * a moved element would survive. `connect()` covers both, because both end in a\n * connection.\n *\n * Scope is the **drop** only. What the fresh cycle should say instead is the\n * consumer's: a value re-read from the live DOM, a roster refilled by the\n * stream, a measurement retaken from the current scroll position, a slot emptied\n * of the last result. Those answers differ per consumer and none of them is a\n * hook removal, so the pass stops where every consumer agrees.\n *\n * A declaration names one group of hooks and carries no per-instance state, so\n * it belongs at module scope, shared by every instance the page connects. A\n * consumer writes as many as it has groups — hooks it drops under different\n * conditions cannot share one. The exception is a hook whose name is only known\n * at runtime, such as one built from the registered identifier: that\n * declaration is a field, because the name is.\n *\n * **A drop is not always right.** The population splits on one question: can the\n * state a hook describes outlive the instance that wrote it? Where it cannot — a\n * drag ends with the pointer, a subscription dies with its socket — dropping on\n * every connection is correct. Where it can — a submission in flight is not\n * interrupted by an in-page move — only a connection that follows a real restore\n * may drop, and the consumer answers \"did a session survive?\" with the signal it\n * already holds for its own teardown (a live-session field, a `DetachGate`\n * probe). The drop then sits behind that answer, as the second example shows.\n *\n * @example Unconditional — the state cannot outlive the instance.\n * ```ts\n * const TRANSIENT = new TransientHooks({ attributes: [\"data-sortable-dragging\"] });\n *\n * connect(): void {\n * TRANSIENT.reset(this.element);\n * }\n * ```\n *\n * @example Gated — an in-page move must not drop a live state.\n * ```ts\n * const TRANSIENT = new TransientHooks({ attributes: [\"data-optimistic\"] });\n *\n * connect(): void {\n * const restored = !this.#connected && !this.#gate.pending;\n * this.#gate.cancel();\n * this.#connected = true;\n * if (restored) TRANSIENT.reset(this.element);\n * }\n * ```\n */\n\n/** What a consumer declares once about the hooks its interaction owns. */\nexport interface TransientHooksOptions {\n /**\n * The attribute names a connection may find written by an earlier one. Hooks\n * a consumer drops under different conditions belong to different\n * declarations, so each one can be reset on its own.\n */\n readonly attributes: readonly string[];\n}\n\n/**\n * One consumer's declaration of the hooks its interaction owns, dropped from an\n * element by {@link TransientHooks.reset}.\n *\n * Every member comment inside this class body is inlined into each consumer\n * bundle (`tsup` builds with `splitting: false`), so rationale belongs in this\n * file's own block, which `dist` drops, and only the contract belongs inside.\n */\nexport class TransientHooks {\n readonly #attributes: readonly string[];\n\n constructor(options: TransientHooksOptions) {\n this.#attributes = options.attributes;\n }\n\n /** Drops the declared hooks from `element`; what it carries besides stays. */\n reset(element: Element): void {\n for (const attribute of this.#attributes) element.removeAttribute(attribute);\n }\n}\n","import { Controller } from \"@hotwired/stimulus\";\nimport { isReservedArrowChord } from \"../utils/arrow_step\";\nimport { DetachGate } from \"../utils/detach_gate\";\nimport { ownerOf } from \"../utils/event_owner\";\nimport { OwnedPointerSession, type OwnedPointerSessionEnd } from \"../utils/owned_pointer_session\";\nimport { TransientHooks } from \"../utils/transient_hooks\";\n\n/** The drag hook a connection may find written by an earlier, now-gone one. */\nconst TRANSIENT_DRAG = new TransientHooks({ attributes: [\"data-dragging\"] });\n/** The grab hook, dropped under its own condition, so its own declaration. */\nconst TRANSIENT_GRAB = new TransientHooks({ attributes: [\"data-grabbed\"] });\n\n/**\n * Elements whose own default action owns a key press. The browser never signals\n * those through `defaultPrevented`, so a yield on that flag cannot see them.\n */\nconst NATIVE_KEY_OWNERS = \"input, textarea, select, button, a[href], summary, [contenteditable]\";\n\n/** How a drag session was initiated; surfaced in every event detail. */\ntype DragPointerType = \"mouse\" | \"touch\" | \"pen\" | \"keyboard\";\n\n/** A pointer drag in flight (from `pointerdown` until up/cancel). */\ninterface PointerSession {\n /** Owns the initiating pointer; assigned as soon as the session is armed. */\n pointer: OwnedPointerSession | null;\n handle: HTMLElement;\n originX: number;\n originY: number;\n /** True once the movement passed `threshold` and `start` was dispatched. */\n started: boolean;\n /** Last axis-filtered deltas, reported again by `end`. */\n dx: number;\n dy: number;\n pointerType: DragPointerType;\n}\n\n/** A keyboard \"grabbed\" session (Space/Enter on the handle until drop/cancel). */\ninterface KeyboardSession {\n handle: HTMLElement;\n /** Cumulative synthetic deltas accumulated by the arrow keys. */\n dx: number;\n dy: number;\n}\n\n/**\n * Headless **pointer-drag primitive**: a normalized pointer/touch/mouse drag\n * lifecycle with a built-in keyboard alternative. It deliberately does NOT decide\n * what a drag *means* (reorder, dismiss, resize…) — it only emits a clean,\n * accessibility-friendly drag signal that higher-level behaviors compose from —\n * `stimeo--sortable` is one, and reordering, dismissal, and resizing are the usual\n * meanings a consumer layers on. No dedicated APG\n * pattern exists for drag-and-drop; the keyboard model below is the accepted\n * alternative-input technique (WCAG 2.1.1 / 2.5.7 Dragging Movements). Core\n * (zero dependencies).\n *\n * Markup contract (identifier: `stimeo--pointer-drag`):\n * <li data-controller=\"stimeo--pointer-drag\"\n * data-stimeo--pointer-drag-axis-value=\"y\">\n * <button data-stimeo--pointer-drag-target=\"handle\" aria-label=\"Reorder\">⠿</button>\n * </li>\n *\n * The `handle` target is optional — without one, the controller element itself\n * is the handle. Pointer flow: `pointerdown` on a handle arms the drag; once the\n * axis-filtered movement exceeds `threshold`, `start` fires, every subsequent\n * movement fires `move` (deltas cumulative from the origin), and release fires\n * `end` (`pointercancel` → `cancel`). Keyboard flow: Space/Enter on the handle\n * grabs (`start`, `data-grabbed`), the arrow keys emit synthetic `move` events of\n * `keyboardStep` px each, Space/Enter drops (`end`) and Escape cancels — so every\n * consumer gets a keyboard path for free.\n *\n * `start` dispatches `{ x, y, pointerType }`; `move` dispatches `{ dx, dy, x, y, pointerType }`;\n * `end` dispatches `{ dx, dy, pointerType }`; `cancel` dispatches `{ pointerType }`.\n *\n * @remarks\n * Behavior only: consumers own all visuals (ghost, placeholder, transforms) by\n * reacting to the events and the `data-dragging` / `data-grabbed` hooks. The one\n * deliberate exception is the opt-in `follow` value for the \"just move the\n * element\" case: it applies the in-flight deltas to the element's CSS\n * `translate` (a property independent of `transform`, so authored transforms\n * survive), commits the offset on drop and restores it on cancel — the exact\n * boilerplate every simple consumer would otherwise re-write. With `follow` the\n * element's inline `translate` belongs to this controller (`connect()` re-reads\n * a committed `<x>px <y>px` offset, so Turbo restores stay consistent). ARIA 1.1\n * deprecated `aria-grabbed`/`aria-dropeffect`, so the grabbed state is\n * published as `data-grabbed` and the *meaning* of a drag must be announced by\n * the consumer (pair with `stimeo--announcer`). `touch-action` on the handles is\n * derived from `axis` (marker-guarded, authored values win) so the page does not\n * pan mid-drag. Deltas are physical (client coordinates): RTL semantics belong\n * to the consumer. `disconnect()` (Turbo navigation included) tears down any\n * active session — except across an in-page move, which the session survives\n * (the full lifecycle contract lives on `disconnect()`); `connect()` clears\n * stale hooks a Turbo cache restore may have preserved (a drag cannot survive\n * a navigation).\n */\nexport class PointerDragController extends Controller<HTMLElement> {\n static override targets = [\"handle\"];\n static override values = {\n axis: { type: String, default: \"both\" },\n threshold: { type: Number, default: 3 },\n keyboardStep: { type: Number, default: 10 },\n disabled: { type: Boolean, default: false },\n follow: { type: Boolean, default: false },\n };\n static actions = [\"reset\"] as const;\n static events = [\"start\", \"move\", \"end\", \"cancel\"] as const;\n\n declare readonly handleTargets: HTMLElement[];\n declare readonly hasHandleTarget: boolean;\n declare axisValue: string;\n declare thresholdValue: number;\n declare keyboardStepValue: number;\n declare disabledValue: boolean;\n declare followValue: boolean;\n\n /** Marker attribute recording that this controller set the touch-action. */\n static readonly #TOUCH_ACTION_MARKER = \"data-pointer-drag-touch-action\";\n /** Marker attribute recording that this controller set `tabindex`. */\n static readonly #TABINDEX_MARKER = \"data-pointer-drag-tabindex\";\n\n #pointer: PointerSession | null = null;\n #keyboard: KeyboardSession | null = null;\n /** Committed follow offset from past drops; a new drag's deltas add onto it. */\n #followBase = { x: 0, y: 0 };\n /** Decides whether a mid-session disconnect() is an in-page move or a detach. */\n readonly #gate = new DetachGate();\n\n override connect(): void {\n // A reconnect disarms the probe a mid-session disconnect() armed — the\n // element was moved in-page and the session survives (see disconnect).\n this.#gate.cancel();\n // Transient drag state cannot survive a navigation: clear hooks a Turbo\n // cache restore may have snapshotted mid-drag (idempotent reconnect). But a\n // session preserved across an in-page move keeps its hooks.\n if (!this.#pointer) TRANSIENT_DRAG.reset(this.element);\n if (!this.#keyboard) TRANSIENT_GRAB.reset(this.element);\n // Follow mode owns the element's inline `translate`: re-read a committed\n // offset so reconnects (Turbo cache restore included) keep accumulating from\n // where the element visually sits. A session surviving an in-page move keeps\n // its base — mid-drag inline state must not be committed as a new base.\n if (this.followValue && !this.#pointer && !this.#keyboard) {\n this.#followBase = this.#parseFollowBase();\n }\n // Delegated on the container so dynamically added handles need no per-element\n // data-action.\n this.element.addEventListener(\"pointerdown\", this.#onPointerDown);\n this.element.addEventListener(\"keydown\", this.#onKeydown);\n if (!this.hasHandleTarget) this.#prepareHandle(this.element);\n }\n\n override disconnect(): void {\n this.element.removeEventListener(\"pointerdown\", this.#onPointerDown);\n this.element.removeEventListener(\"keydown\", this.#onKeydown);\n // A mid-session disconnect on a STILL-connected element is ambiguous: an\n // in-page move (a consumer like sortable re-inserts the item mid-grab —\n // Stimulus reconnects the same instance in the same mutation batch, and\n // the session must survive) vs a real detach that keeps the element\n // (`data-controller` removed, Turbo morph, element moved outside the\n // observed root). DetachGate discriminates: the token check is the\n // synchronous fast path (a morph's teardown — and its `cancel` — fires in\n // the same tick), the one-microtask probe cancelled by connect() covers\n // the rest — a detached-in-place controller never leaks its session or\n // document listeners. Probe only while a session needs protecting; an\n // idle controller tears down synchronously either way.\n if (this.#pointer || this.#keyboard) {\n this.#gate.disconnected(this, () => this.#teardown());\n return;\n }\n this.#teardown();\n }\n\n /**\n * Returns the element to its origin: drops the committed follow offset and the\n * inline `translate` that carries it.\n *\n * In follow mode the inline `translate` belongs to this controller, and the\n * committed offset lives in a field the DOM cannot reach — so a consumer that\n * wants the element back at the start, or that has written a position of its\n * own, needs this to make the two agree again. An in-flight drag is cancelled\n * first, or its deltas would land on top of the offset just cleared.\n */\n reset(): void {\n // Cancel first, then clear: the cancel contract snaps back to the committed\n // offset, so clearing before it would be undone on the way out.\n const live = this.#pointer?.started\n ? this.#pointer.pointerType\n : this.#keyboard\n ? \"keyboard\"\n : null;\n if (this.#pointer || this.#keyboard) this.#teardownSessions();\n if (live) this.#dispatchCancel(live);\n this.#followBase = { x: 0, y: 0 };\n this.#applyFollow(0, 0);\n }\n\n handleTargetConnected(handle: HTMLElement): void {\n // The element wears the handle contract only while it IS the handle; the\n // first real handle takes it back. (Marker-guarded, so this is a no-op when\n // the element never wore it.)\n if (handle !== this.element) this.#restoreHandle(this.element);\n this.#prepareHandle(handle);\n }\n\n handleTargetDisconnected(handle: HTMLElement): void {\n // The loan is due back the moment an element stops being a handle, and this\n // callback is the only place that sees every such element: once the\n // identifier token is gone, `#handles()` no longer resolves the targets.\n // Across an in-page move `handleTargetConnected` lends it again in the same\n // mutation batch.\n this.#restoreHandle(handle);\n // Target callbacks ALSO fire when the CONTROLLER goes away (Stimulus stops\n // the target observer after `disconnect()` has run) and across the in-page\n // move a live session must survive. In both the handle is still inside the\n // element: the session belongs to `disconnect()`, and handing the contract\n // to the container here would bake a nameless tab stop onto it on every\n // morph. Only a handle that actually LEFT is this callback's business.\n if (this.element.contains(handle)) return;\n\n // It can never deliver its keydown again (the delegated listener sits on the\n // container it left), so a live session would leak and the one-session guard\n // would reject every future pointerdown. The tree and the consumers are both\n // alive here, so it ends the way every other keep-the-element teardown does:\n // in `cancel`, or a composer like sortable strands its session bookkeeping.\n const interrupted =\n this.#pointer?.handle === handle && this.#pointer.started\n ? this.#pointer.pointerType\n : this.#keyboard?.handle === handle\n ? (\"keyboard\" as const)\n : null;\n if (this.#pointer?.handle === handle) this.#endPointerSession();\n if (this.#keyboard?.handle === handle) this.#clearKeyboardSession();\n // With the last handle gone the element is the handle again (`#handles()`),\n // so it needs the contract the departing handle just gave back.\n if (!this.hasHandleTarget) this.#prepareHandle(this.element);\n if (interrupted) this.#dispatchCancel(interrupted);\n }\n\n /**\n * Re-derives the handles' touch-action when the axis changes.\n *\n * Two layers, like the `tabindex` loan: the marker says the value was once\n * ours, and the current inline value says it still is. A consumer that wrote\n * its own `touch-action` after connect keeps it.\n */\n axisValueChanged(_value: string, previousValue: string | undefined): void {\n // The value to recognize as ours is the one the previous axis lent. Stimulus\n // also replays a value that did NOT change (ahead of every connect), and\n // there the axis in force is the one it was lent under.\n const lent = this.#touchActionFor(previousValue ?? this.axisValue);\n for (const handle of this.#handles()) {\n if (!handle.hasAttribute(PointerDragController.#TOUCH_ACTION_MARKER)) continue;\n if (handle.style.touchAction !== lent) continue;\n handle.style.touchAction = this.#touchActionForAxis();\n }\n }\n\n /** Cancels any in-flight session when the controller is disabled mid-drag. */\n disabledValueChanged(): void {\n if (!this.disabledValue) return;\n if (this.#pointer?.started || this.#keyboard) {\n this.#dispatchCancel(this.#keyboard ? \"keyboard\" : (this.#pointer?.pointerType ?? \"mouse\"));\n }\n this.#teardownSessions();\n }\n\n /**\n * Arms a pointer drag on a handle; `start` waits for the threshold.\n *\n * @stimeoRuntimeOnly `disabled` decides whether this one pointer press starts a gesture.\n */\n readonly #onPointerDown = (event: PointerEvent): void => {\n // One session at a time: ignore a second pointerdown (multi-touch, an\n // errant tap, a grabbed keyboard session) so an in-flight drag is never\n // silently overwritten and its captured pointer orphaned.\n if (this.disabledValue || this.#pointer || this.#keyboard || event.button !== 0) return;\n const handle = this.#handleFor(event.target);\n if (!handle) return;\n\n // Suppress text selection / native image drag; restore the focus the\n // suppressed default would have given, so Escape and the keyboard path\n // stay reachable right after a pointer interaction (WCAG 2.1.1).\n event.preventDefault();\n handle.focus();\n\n const session: PointerSession = {\n pointer: null,\n handle,\n originX: event.clientX,\n originY: event.clientY,\n started: false,\n dx: 0,\n dy: 0,\n pointerType: this.#pointerTypeOf(event),\n };\n // The session tracks the pointer on the handle's document, so a consumer\n // re-inserting the dragged element mid-drag (sortable's live reorder) keeps\n // steering the same finger, and every listener falls with one signal.\n session.pointer = new OwnedPointerSession(event, handle, {\n move: (move) => this.#trackMove(session, move),\n end: (kind) => this.#finishPointer(session, kind),\n });\n this.#pointer = session;\n };\n\n /**\n * Applies one tracked move: threshold, hooks, follow offset, events.\n *\n * @stimeoRuntimeOnly `threshold` decides when this one pointer move starts the drag.\n */\n #trackMove(session: PointerSession, event: PointerEvent): void {\n const [dx, dy] = this.#filterAxis(\n event.clientX - session.originX,\n event.clientY - session.originY,\n );\n if (!session.started) {\n if (Math.hypot(dx, dy) < this.thresholdValue) return;\n session.started = true;\n this.element.setAttribute(\"data-dragging\", \"true\");\n this.dispatch(\"start\", {\n detail: { x: event.clientX, y: event.clientY, pointerType: session.pointerType },\n });\n }\n\n session.dx = dx;\n session.dy = dy;\n this.#followMove(dx, dy);\n this.dispatch(\"move\", {\n detail: { dx, dy, x: event.clientX, y: event.clientY, pointerType: session.pointerType },\n });\n }\n\n /**\n * Closes the session and reports only the outcome the caller does not own.\n *\n * A teardown (detach, Escape, mid-drag disable, `reset`) is announced by the\n * path that asked for it, so this one stays silent; `pointerup` below the\n * threshold was a plain click, and `pointercancel` is an OS gesture takeover.\n */\n #finishPointer(session: PointerSession, kind: OwnedPointerSessionEnd): void {\n const { started, dx, dy, pointerType } = session;\n this.#pointer = null;\n this.element.removeAttribute(\"data-dragging\");\n if (kind === \"teardown\" || !started) return;\n if (kind === \"up\") {\n this.#followCommit(dx, dy);\n this.dispatch(\"end\", { detail: { dx, dy, pointerType } });\n return;\n }\n this.#dispatchCancel(pointerType);\n }\n\n /**\n * Keyboard alternative: Space/Enter grab & drop, arrows move, Escape cancels.\n *\n * @stimeoRuntimeOnly `disabled` decides whether this one key is taken and `keyboardStep` is the\n * distance of one keyboard move.\n */\n readonly #onKeydown = (event: KeyboardEvent): void => {\n if (this.disabledValue) return;\n const handle = this.#handleFor(event.target);\n if (!handle) return;\n\n // A descendant widget that already claimed the key (a nested roving list, a\n // segmented field inside the handle) must not ALSO drive the drag —\n // composition depends on this yield.\n if (event.defaultPrevented) return;\n // A press that steers an IME conversion belongs to the composition, and an\n // input method never says so through `defaultPrevented`.\n if (event.isComposing) return;\n // Neither does a native control or editing surface inside the handle: typing\n // a space into a field and activating a link are default actions, not claims.\n // Widgets that do claim their keys keep composing through the yield above.\n if (this.#ownsNativeKeys(event.target, handle)) return;\n // A chorded arrow belongs to the browser. \"Someone already consumed it\"\n // outranks that, so it is checked after the yields above.\n if (isReservedArrowChord(event)) return;\n\n // Escape cancels whichever session is live (pointer drag or keyboard grab).\n if (event.key === \"Escape\") {\n if (this.#pointer?.started) {\n const { pointerType } = this.#pointer;\n this.#teardownSessions();\n event.preventDefault();\n this.#dispatchCancel(pointerType);\n } else if (this.#keyboard) {\n this.#teardownSessions();\n event.preventDefault();\n this.#dispatchCancel(\"keyboard\");\n }\n return;\n }\n\n if (event.key === \" \" || event.key === \"Enter\") {\n // A live pointer drag owns the session: pressing Space mid-drag (the\n // pointerdown focused the handle) must not start a parallel grab.\n if (this.#pointer) return;\n event.preventDefault();\n if (this.#keyboard) this.#dropKeyboard();\n else this.#grabKeyboard(handle);\n return;\n }\n\n if (!this.#keyboard) return;\n // While grabbed, the handle owns the keyboard. `Home` / `End` move nothing\n // here, but a composition partner acts on them (a roving group jumps focus\n // to the ends), and focus leaving the handle strands the grab: the arrows\n // and Escape that end it are all delivered to whatever holds focus. So they\n // are consumed here and do nothing, the same reason every arrow is consumed.\n if (event.key === \"Home\" || event.key === \"End\") {\n event.preventDefault();\n return;\n }\n const step = this.#keyboardDelta(event.key);\n if (!step) return;\n // Consume every arrow while grabbed (even on a locked axis) so the page\n // never scrolls mid-grab; only allowed-axis arrows emit a move.\n event.preventDefault();\n const [dx, dy] = this.#filterAxis(step[0], step[1]);\n if (dx === 0 && dy === 0) return;\n this.#keyboard.dx += dx;\n this.#keyboard.dy += dy;\n this.#followMove(this.#keyboard.dx, this.#keyboard.dy);\n this.dispatch(\"move\", {\n detail: {\n dx: this.#keyboard.dx,\n dy: this.#keyboard.dy,\n x: this.#keyboard.dx,\n y: this.#keyboard.dy,\n pointerType: \"keyboard\",\n },\n });\n };\n\n /** Enters the grabbed mode: `data-grabbed` on element + handle, then `start`. */\n #grabKeyboard(handle: HTMLElement): void {\n this.#keyboard = { handle, dx: 0, dy: 0 };\n this.element.setAttribute(\"data-grabbed\", \"true\");\n handle.setAttribute(\"data-grabbed\", \"true\");\n this.dispatch(\"start\", { detail: { x: 0, y: 0, pointerType: \"keyboard\" } });\n }\n\n #dropKeyboard(): void {\n const session = this.#keyboard;\n if (!session) return;\n this.#clearKeyboardSession();\n this.#followCommit(session.dx, session.dy);\n this.dispatch(\"end\", { detail: { dx: session.dx, dy: session.dy, pointerType: \"keyboard\" } });\n }\n\n /** Maps an arrow key to a raw (unfiltered) `keyboardStep` delta. */\n #keyboardDelta(key: string): [number, number] | null {\n const step = this.keyboardStepValue;\n switch (key) {\n case \"ArrowRight\":\n return [step, 0];\n case \"ArrowLeft\":\n return [-step, 0];\n case \"ArrowDown\":\n return [0, step];\n case \"ArrowUp\":\n return [0, -step];\n default:\n return null;\n }\n }\n\n /**\n * Zeroes the delta on the locked axis (`axis` = x | y | both).\n *\n * @stimeoRuntimeOnly `axis` filters the offset of one move to the allowed direction.\n */\n #filterAxis(dx: number, dy: number): [number, number] {\n if (this.axisValue === \"x\") return [dx, 0];\n if (this.axisValue === \"y\") return [0, dy];\n return [dx, dy];\n }\n\n /** Silently closes a live pointer session; the caller announces the outcome. */\n #endPointerSession(): void {\n this.#pointer?.pointer?.end();\n }\n\n #clearKeyboardSession(): void {\n this.#keyboard?.handle.removeAttribute(\"data-grabbed\");\n this.#keyboard = null;\n this.element.removeAttribute(\"data-grabbed\");\n }\n\n /**\n * Full teardown for a controller whose element is going away or lost its\n * controller. Into a dead (detached) tree it is silent — consumers restore\n * from their own `connect()`, not from a cancel event. But a detach that\n * KEEPS the element (Turbo morph, `data-controller` removed) leaves the\n * consumers alive and listening: an in-flight session must end in `cancel`\n * there, or a composer like sortable strands its one-at-a-time session\n * bookkeeping forever.\n */\n #teardown(): void {\n // Disarm any probe still queued: without this, an immediate teardown\n // (element removed right after a deferring disconnect) would let the\n // orphaned probe run #teardown a second time — a double cancel.\n this.#gate.cancel();\n const interrupted = this.#pointer?.started\n ? this.#pointer.pointerType\n : this.#keyboard\n ? (\"keyboard\" as const)\n : null;\n this.#teardownSessions();\n for (const handle of this.#handles()) this.#restoreHandle(handle);\n // An in-flight offset must leave the DOM even where nobody is listening: a\n // re-inserted element would have `connect()` read it back as a committed base.\n this.#followReset();\n if (interrupted && this.element.isConnected) this.#dispatchCancel(interrupted);\n }\n\n /**\n * Silently tears down whatever session is live (disconnect / disabled /\n * Escape). Composed from the two single-session teardowns so pointer and\n * keyboard cleanup cannot diverge as either path evolves.\n */\n #teardownSessions(): void {\n this.#endPointerSession();\n this.#clearKeyboardSession();\n }\n\n #dispatchCancel(pointerType: DragPointerType): void {\n // Every cancel path funnels here, so follow's snap-back can never be missed\n // (Escape, pointercancel, mid-session disable, detach-that-keeps-the-element).\n this.#followReset();\n this.dispatch(\"cancel\", { detail: { pointerType } });\n }\n\n /**\n * Applies the in-flight offset to the element's `translate` (follow only).\n *\n * @stimeoRuntimeOnly `follow` decides whether this one move writes the offset as a translate; the\n * offset itself comes from the gesture.\n */\n #followMove(dx: number, dy: number): void {\n if (!this.followValue) return;\n this.#applyFollow(this.#followBase.x + dx, this.#followBase.y + dy);\n }\n\n /**\n * Folds a drop's deltas into the committed base offset (follow only).\n *\n * @stimeoRuntimeOnly `follow` decides whether the end of this one gesture keeps the offset as a\n * translate.\n */\n #followCommit(dx: number, dy: number): void {\n if (!this.followValue) return;\n this.#followBase = { x: this.#followBase.x + dx, y: this.#followBase.y + dy };\n this.#applyFollow(this.#followBase.x, this.#followBase.y);\n }\n\n /**\n * Snaps back to the committed position (follow only) — the cancel contract.\n *\n * @stimeoRuntimeOnly `follow` decides whether cancelling this one gesture clears the translate it\n * wrote.\n */\n #followReset(): void {\n if (!this.followValue) return;\n this.#applyFollow(this.#followBase.x, this.#followBase.y);\n }\n\n /**\n * Writes the offset as the standalone CSS `translate` property — independent\n * of `transform`, so an authored transform (scale, rotate…) is never\n * clobbered. At the origin the property is removed to keep the DOM clean.\n */\n #applyFollow(x: number, y: number): void {\n if (x === 0 && y === 0) this.element.style.removeProperty(\"translate\");\n else this.element.style.setProperty(\"translate\", `${x}px ${y}px`);\n }\n\n /**\n * Reads a committed follow offset back from the inline `translate`. Only the\n * controller's own `<x>px <y>px` shape is recognized; anything else (an\n * authored percentage, `none`, an empty string) starts the base at 0 — follow\n * mode owns this property, per the class contract.\n */\n #parseFollowBase(): { x: number; y: number } {\n const raw = this.element.style.getPropertyValue(\"translate\").trim();\n const match = /^(-?\\d+(?:\\.\\d+)?)px(?:\\s+(-?\\d+(?:\\.\\d+)?)px)?$/.exec(raw);\n if (!match) return { x: 0, y: 0 };\n return { x: Number(match[1]), y: Number(match[2] ?? \"0\") };\n }\n\n /** The active handles: the `handle` targets, else the element itself. */\n #handles(): HTMLElement[] {\n return this.hasHandleTarget ? this.handleTargets : [this.element];\n }\n\n /** Resolves the handle owning an event target (the handle or a descendant). */\n #handleFor(target: EventTarget | null): HTMLElement | null {\n return ownerOf(this.#handles(), target);\n }\n\n #pointerTypeOf(event: PointerEvent): DragPointerType {\n const type = event.pointerType;\n if (type === \"touch\" || type === \"pen\") return type;\n return \"mouse\";\n }\n\n /** `touch-action` that lets the page keep panning on the locked axis only. */\n #touchActionForAxis(): string {\n return this.#touchActionFor(this.axisValue);\n }\n\n /** The `touch-action` an `axis` declaration lends, for any axis value. */\n #touchActionFor(axis: string): string {\n if (axis === \"x\") return \"pan-y\";\n if (axis === \"y\") return \"pan-x\";\n return \"none\";\n }\n\n /**\n * Establishes the handle contract: a `touch-action` derived from `axis`\n * (marker-guarded so an authored inline value wins and reconnects stay\n * idempotent) and focusability for the keyboard path (`tabindex=\"0\"` only when\n * the author supplied none — prefer a real `<button>` handle). Both additions\n * are marker-owned so `#restoreHandle` reverts them symmetrically on teardown.\n *\n * @stimeoRenderRoot\n */\n #prepareHandle(handle: HTMLElement): void {\n const lent = this.#touchActionForAxis();\n // Two layers, as when the loan is returned: a free property is ours to take,\n // and a marked one is still ours only while it reads back as what was lent.\n // A consumer that wrote its own value keeps it across every reconnect.\n const marked = handle.hasAttribute(PointerDragController.#TOUCH_ACTION_MARKER);\n if (handle.style.touchAction === \"\" || (marked && handle.style.touchAction === lent)) {\n handle.style.touchAction = lent;\n handle.setAttribute(PointerDragController.#TOUCH_ACTION_MARKER, \"true\");\n }\n if (handle.tabIndex < 0 && !handle.hasAttribute(\"tabindex\")) {\n handle.setAttribute(\"tabindex\", \"0\");\n handle.setAttribute(PointerDragController.#TABINDEX_MARKER, \"true\");\n }\n }\n\n /** Whether the key belongs to a native control or editing surface in the handle. */\n #ownsNativeKeys(target: EventTarget | null, handle: HTMLElement): boolean {\n const owner = (target as Element | null)?.closest(NATIVE_KEY_OWNERS) ?? null;\n return owner !== null && owner !== handle && handle.contains(owner);\n }\n\n /** Reverts the marker-owned touch-action + tabindex (authored values untouched). */\n #restoreHandle(handle: HTMLElement): void {\n if (handle.hasAttribute(PointerDragController.#TOUCH_ACTION_MARKER)) {\n // Only give back what is still ours: a consumer may have written its own\n // value since, and clearing then would lose it. The marker goes either\n // way — the loan is over regardless of who ends up owning the value.\n if (handle.style.touchAction === this.#touchActionForAxis()) {\n handle.style.touchAction = \"\";\n }\n handle.removeAttribute(PointerDragController.#TOUCH_ACTION_MARKER);\n }\n if (handle.hasAttribute(PointerDragController.#TABINDEX_MARKER)) {\n // Only remove what is verifiably still ours and safe to remove: another\n // owner (e.g. a roving list) may have rewritten the value since, and\n // stripping tabindex off the focused element would blur it to <body>\n // (losing the user's place — worse than leaking one tab stop).\n const ours = handle.getAttribute(\"tabindex\") === \"0\";\n if (ours && document.activeElement !== handle) {\n handle.removeAttribute(\"tabindex\");\n handle.removeAttribute(PointerDragController.#TABINDEX_MARKER);\n return;\n }\n // The loan ends when someone else owns the value; it stays recorded when\n // the value is still ours and only the focus stopped us returning it —\n // otherwise an in-page move (teardown + reconnect while focused) drops the\n // record and the borrowed tab stop is never given back.\n if (!ours) handle.removeAttribute(PointerDragController.#TABINDEX_MARKER);\n }\n }\n}\n"]}
@@ -45,6 +45,11 @@ import { Controller } from '@hotwired/stimulus';
45
45
  * scroll-parent ancestor (or the window) closes the panel, the usual convention for
46
46
  * anchored popups. Closes without restoring focus (like the modeless `focusout` path)
47
47
  * so the close never fights the user's scroll. Off by default.
48
+ * - Each move of the open state is reported: `stimeo--popover:open` and
49
+ * `stimeo--popover:close` dispatch `{ reason: StateReason }`, after the state
50
+ * attributes are written. Both are informational, so neither is cancelable. A
51
+ * call that leaves the state where it already was, the normalization in
52
+ * {@link connect}, and {@link disconnect} are all silent.
48
53
  */
49
54
  declare class PopoverController extends Controller<HTMLElement> {
50
55
  #private;
@@ -56,6 +61,7 @@ declare class PopoverController extends Controller<HTMLElement> {
56
61
  };
57
62
  };
58
63
  static actions: readonly ["close", "open", "toggle"];
64
+ static events: readonly ["close", "open"];
59
65
  readonly triggerTarget: HTMLButtonElement;
60
66
  readonly panelTarget: HTMLElement;
61
67
  readonly hasTriggerTarget: boolean;
@@ -71,11 +77,11 @@ declare class PopoverController extends Controller<HTMLElement> {
71
77
  */
72
78
  disconnect(): void;
73
79
  /** Toggles the popover. Bound via `data-action` (click on the trigger). */
74
- toggle(): void;
80
+ toggle(event?: Event): void;
75
81
  /** Opens the panel, reflects state, and moves focus inside it. */
76
- open(): void;
82
+ open(event?: Event): void;
77
83
  /** Closes the panel and reflects the collapsed state. Bound via `data-action`. */
78
- close(): void;
84
+ close(event?: Event): void;
79
85
  }
80
86
 
81
87
  export { PopoverController };