@proyecto-viviana/solidaria 0.0.1 → 0.0.2

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 (56) hide show
  1. package/dist/index.js +1 -1
  2. package/dist/index.js.map +1 -1
  3. package/package.json +4 -3
  4. package/src/button/createButton.ts +135 -0
  5. package/src/button/createToggleButton.ts +101 -0
  6. package/src/button/index.ts +4 -0
  7. package/src/button/types.ts +67 -0
  8. package/src/checkbox/createCheckbox.ts +135 -0
  9. package/src/checkbox/createCheckboxGroup.ts +137 -0
  10. package/src/checkbox/createCheckboxGroupItem.ts +117 -0
  11. package/src/checkbox/createCheckboxGroupState.ts +193 -0
  12. package/src/checkbox/index.ts +13 -0
  13. package/src/index.ts +128 -0
  14. package/src/interactions/FocusableProvider.tsx +44 -0
  15. package/src/interactions/PressEvent.ts +112 -0
  16. package/src/interactions/createFocus.ts +157 -0
  17. package/src/interactions/createFocusRing.ts +142 -0
  18. package/src/interactions/createFocusWithin.ts +141 -0
  19. package/src/interactions/createFocusable.ts +168 -0
  20. package/src/interactions/createHover.ts +214 -0
  21. package/src/interactions/createKeyboard.ts +82 -0
  22. package/src/interactions/createPress.ts +758 -0
  23. package/src/interactions/index.ts +45 -0
  24. package/src/label/createField.ts +145 -0
  25. package/src/label/createLabel.ts +116 -0
  26. package/src/label/createLabels.ts +50 -0
  27. package/src/label/index.ts +19 -0
  28. package/src/link/createLink.ts +176 -0
  29. package/src/link/index.ts +1 -0
  30. package/src/progress/createProgressBar.ts +128 -0
  31. package/src/progress/index.ts +5 -0
  32. package/src/radio/createRadio.ts +286 -0
  33. package/src/radio/createRadioGroup.ts +189 -0
  34. package/src/radio/createRadioGroupState.ts +201 -0
  35. package/src/radio/index.ts +23 -0
  36. package/src/separator/createSeparator.ts +82 -0
  37. package/src/separator/index.ts +6 -0
  38. package/src/ssr/index.ts +36 -0
  39. package/src/switch/createSwitch.ts +70 -0
  40. package/src/switch/index.ts +1 -0
  41. package/src/textfield/createTextField.ts +198 -0
  42. package/src/textfield/index.ts +5 -0
  43. package/src/toggle/createToggle.ts +222 -0
  44. package/src/toggle/createToggleState.ts +94 -0
  45. package/src/toggle/index.ts +7 -0
  46. package/src/utils/dom.ts +244 -0
  47. package/src/utils/events.ts +119 -0
  48. package/src/utils/filterDOMProps.ts +116 -0
  49. package/src/utils/focus.ts +151 -0
  50. package/src/utils/geometry.ts +115 -0
  51. package/src/utils/globalListeners.ts +142 -0
  52. package/src/utils/index.ts +66 -0
  53. package/src/utils/mergeProps.ts +49 -0
  54. package/src/utils/platform.ts +52 -0
  55. package/src/utils/reactivity.ts +36 -0
  56. package/src/utils/textSelection.ts +114 -0
@@ -0,0 +1,758 @@
1
+ /**
2
+ * createPress - Handles press interactions across mouse, touch, keyboard, and virtual clicks.
3
+ *
4
+ * This is a 1-1 port of React-Aria's usePress hook adapted for SolidJS.
5
+ * All behaviors, edge cases, and platform-specific handling are preserved.
6
+ */
7
+
8
+ import { createSignal, JSX, Accessor, onCleanup } from 'solid-js';
9
+ import { PressEvent, PointerType, createPressEvent } from './PressEvent';
10
+ import {
11
+ nodeContains,
12
+ getEventTarget,
13
+ isValidKeyboardEvent,
14
+ isHTMLAnchorLink,
15
+ shouldPreventDefaultKeyboard,
16
+ isVirtualClick,
17
+ isVirtualPointerEvent,
18
+ isPointOverTarget,
19
+ getTouchFromEvent,
20
+ getTouchById,
21
+ disableTextSelection,
22
+ restoreTextSelection,
23
+ preventFocus,
24
+ openLink,
25
+ isMac,
26
+ createGlobalListeners,
27
+ } from '../utils';
28
+
29
+ // Re-export PressEvent types
30
+ export { PressEvent, type PointerType } from './PressEvent';
31
+ export type { IPressEvent, PressEventType } from './PressEvent';
32
+
33
+ export interface CreatePressProps {
34
+ /** Whether the target is currently disabled. */
35
+ isDisabled?: Accessor<boolean> | boolean;
36
+ /** Handler called when the press is released over the target. */
37
+ onPress?: (e: PressEvent) => void;
38
+ /** Handler called when a press interaction starts. */
39
+ onPressStart?: (e: PressEvent) => void;
40
+ /**
41
+ * Handler called when a press interaction ends, either
42
+ * over the target or when the pointer leaves the target.
43
+ */
44
+ onPressEnd?: (e: PressEvent) => void;
45
+ /** Handler called when a press is released over the target, regardless of whether it started on the target. */
46
+ onPressUp?: (e: PressEvent) => void;
47
+ /** Handler called when the press state changes. */
48
+ onPressChange?: (isPressed: boolean) => void;
49
+ /** Whether the press should be visual only, not triggering onPress. */
50
+ isPressed?: Accessor<boolean> | boolean;
51
+ /** Whether to prevent focus when pressing. */
52
+ preventFocusOnPress?: boolean;
53
+ /** Whether long press should cancel when pointer moves out of target. */
54
+ shouldCancelOnPointerExit?: boolean;
55
+ /** Whether text selection should be allowed during press. */
56
+ allowTextSelectionOnPress?: boolean;
57
+ }
58
+
59
+ export interface PressResult {
60
+ /** Whether the target is currently pressed. */
61
+ isPressed: Accessor<boolean>;
62
+ /** Props to spread on the target element. */
63
+ pressProps: JSX.HTMLAttributes<HTMLElement>;
64
+ }
65
+
66
+ function isDisabledValue(isDisabled: Accessor<boolean> | boolean | undefined): boolean {
67
+ if (typeof isDisabled === 'function') {
68
+ return isDisabled();
69
+ }
70
+ return isDisabled ?? false;
71
+ }
72
+
73
+ function isPressedValue(isPressed: Accessor<boolean> | boolean | undefined): boolean {
74
+ if (typeof isPressed === 'function') {
75
+ return isPressed();
76
+ }
77
+ return isPressed ?? false;
78
+ }
79
+
80
+ // Symbol to track if a link click was handled by us
81
+ const LINK_CLICKED = Symbol('linkClicked');
82
+
83
+ // CSS for preventing double-tap zoom delay
84
+ let pressableCSSInjected = false;
85
+ function injectPressableCSS(): void {
86
+ if (pressableCSSInjected || typeof document === 'undefined') return;
87
+
88
+ const style = document.createElement('style');
89
+ style.id = 'solidaria-pressable-style';
90
+ style.textContent = `
91
+ [data-solidaria-pressable] {
92
+ touch-action: pan-x pan-y pinch-zoom;
93
+ }
94
+ `;
95
+ document.head.appendChild(style);
96
+ pressableCSSInjected = true;
97
+ }
98
+
99
+ /**
100
+ * Handles press interactions across mouse, touch, keyboard, and screen readers.
101
+ * Provides consistent press behavior regardless of input method.
102
+ *
103
+ * Based on react-aria's usePress but adapted for SolidJS.
104
+ */
105
+ export function createPress(props: CreatePressProps = {}): PressResult {
106
+ // Internal pressed state (for visual feedback)
107
+ const [internalIsPressed, setInternalIsPressed] = createSignal(false);
108
+
109
+ // Use controlled isPressed if provided, otherwise internal state
110
+ const isPressed = (): boolean => {
111
+ const controlledPressed = isPressedValue(props.isPressed);
112
+ if (controlledPressed) {
113
+ return controlledPressed;
114
+ }
115
+ return internalIsPressed();
116
+ };
117
+
118
+ // State tracking (using plain variables - SolidJS doesn't need refs for mutable state)
119
+ let pressState = {
120
+ isPressed: false,
121
+ ignoreEmulatedMouseEvents: false,
122
+ ignoreClickAfterPress: false,
123
+ didFirePressStart: false,
124
+ isTriggeringEvent: false,
125
+ activePointerId: null as number | null,
126
+ target: null as Element | null,
127
+ isOverTarget: false,
128
+ pointerType: null as PointerType | null,
129
+ userSelect: undefined as string | undefined,
130
+ metaKeyEvents: null as Map<string, KeyboardEvent> | null,
131
+ clickCleanup: null as (() => void) | null,
132
+ };
133
+
134
+ // Global listeners manager
135
+ const { addGlobalListener, removeAllGlobalListeners } = createGlobalListeners();
136
+
137
+ // Inject CSS on first use
138
+ injectPressableCSS();
139
+
140
+ // --- Event Triggers ---
141
+
142
+ const triggerPressStart = (originalEvent: Event, pointerType: PointerType): boolean => {
143
+ if (isDisabledValue(props.isDisabled) || pressState.didFirePressStart) {
144
+ return false;
145
+ }
146
+
147
+ let shouldStopPropagation = true;
148
+ pressState.isTriggeringEvent = true;
149
+
150
+ if (props.onPressStart) {
151
+ const event = createPressEvent('pressstart', pointerType, originalEvent, pressState.target!);
152
+ props.onPressStart(event);
153
+ shouldStopPropagation = event.shouldStopPropagation;
154
+ }
155
+
156
+ if (props.onPressChange) {
157
+ props.onPressChange(true);
158
+ }
159
+
160
+ pressState.isTriggeringEvent = false;
161
+ pressState.didFirePressStart = true;
162
+ setInternalIsPressed(true);
163
+
164
+ return shouldStopPropagation;
165
+ };
166
+
167
+ const triggerPressEnd = (originalEvent: Event, pointerType: PointerType, wasPressed = true): void => {
168
+ if (!pressState.didFirePressStart) {
169
+ return;
170
+ }
171
+
172
+ pressState.ignoreClickAfterPress = true;
173
+ pressState.didFirePressStart = false;
174
+ pressState.isTriggeringEvent = true;
175
+
176
+ if (props.onPressEnd) {
177
+ const event = createPressEvent('pressend', pointerType, originalEvent, pressState.target!);
178
+ props.onPressEnd(event);
179
+ }
180
+
181
+ if (props.onPressChange) {
182
+ props.onPressChange(false);
183
+ }
184
+
185
+ setInternalIsPressed(false);
186
+
187
+ if (wasPressed && !isDisabledValue(props.isDisabled)) {
188
+ if (props.onPress) {
189
+ const event = createPressEvent('press', pointerType, originalEvent, pressState.target!);
190
+ props.onPress(event);
191
+ }
192
+ }
193
+
194
+ pressState.isTriggeringEvent = false;
195
+ };
196
+
197
+ const triggerPressUp = (originalEvent: Event, pointerType: PointerType): void => {
198
+ if (isDisabledValue(props.isDisabled)) {
199
+ return;
200
+ }
201
+
202
+ if (props.onPressUp) {
203
+ pressState.isTriggeringEvent = true;
204
+ const event = createPressEvent('pressup', pointerType, originalEvent, pressState.target!);
205
+ props.onPressUp(event);
206
+ pressState.isTriggeringEvent = false;
207
+ }
208
+ };
209
+
210
+ const cancel = (originalEvent: Event): void => {
211
+ if (!pressState.isPressed) {
212
+ return;
213
+ }
214
+
215
+ if (pressState.isOverTarget && pressState.target) {
216
+ triggerPressEnd(originalEvent, pressState.pointerType ?? 'mouse', false);
217
+ }
218
+
219
+ pressState.isPressed = false;
220
+ pressState.isOverTarget = false;
221
+ pressState.activePointerId = null;
222
+ pressState.pointerType = null;
223
+
224
+ removeAllGlobalListeners();
225
+
226
+ // Clean up click timeout/listener if set
227
+ if (pressState.clickCleanup) {
228
+ pressState.clickCleanup();
229
+ pressState.clickCleanup = null;
230
+ }
231
+
232
+ if (!props.allowTextSelectionOnPress) {
233
+ restoreTextSelection(pressState.target as HTMLElement);
234
+ }
235
+ };
236
+
237
+ // --- Pointer Event Handlers (used when PointerEvent is available) ---
238
+
239
+ const onPointerDown: JSX.EventHandler<HTMLElement, PointerEvent> = (e) => {
240
+ // Only handle left clicks, and ignore events that bubbled through portals
241
+ if (e.button !== 0 || !nodeContains(e.currentTarget, getEventTarget(e))) {
242
+ return;
243
+ }
244
+
245
+ // iOS VoiceOver bug: fires pointer events with incorrect coordinates
246
+ // Let the click handler deal with it instead
247
+ if (isVirtualPointerEvent(e)) {
248
+ pressState.pointerType = 'virtual';
249
+ return;
250
+ }
251
+
252
+ pressState.pointerType = e.pointerType as PointerType;
253
+
254
+ if (!pressState.isPressed) {
255
+ pressState.isPressed = true;
256
+ pressState.isOverTarget = true;
257
+ pressState.activePointerId = e.pointerId;
258
+ pressState.target = e.currentTarget;
259
+
260
+ if (!props.allowTextSelectionOnPress) {
261
+ disableTextSelection(pressState.target as HTMLElement);
262
+ }
263
+
264
+ const shouldStopPropagation = triggerPressStart(e, pressState.pointerType);
265
+ if (shouldStopPropagation) {
266
+ e.stopPropagation();
267
+ }
268
+
269
+ // Set up global listeners for pointer events
270
+ addGlobalListener('pointerup', onPointerUp);
271
+ addGlobalListener('pointercancel', onPointerCancel);
272
+ }
273
+ };
274
+
275
+ // Mouse down handler when using pointer events - only prevents focus, doesn't trigger press
276
+ const onMouseDownPointer: JSX.EventHandler<HTMLElement, MouseEvent> = (e) => {
277
+ if (!nodeContains(e.currentTarget, getEventTarget(e))) {
278
+ return;
279
+ }
280
+
281
+ if (e.button === 0) {
282
+ // Prevent focus if requested
283
+ if (props.preventFocusOnPress) {
284
+ preventFocus(e.currentTarget);
285
+ }
286
+ e.stopPropagation();
287
+ }
288
+ };
289
+
290
+ const onPointerUp = (e: PointerEvent): void => {
291
+ // Only handle events for our active pointer
292
+ if (e.pointerId !== pressState.activePointerId || !pressState.isPressed || e.button !== 0 || !pressState.target) {
293
+ return;
294
+ }
295
+
296
+ const isOverTarget = nodeContains(pressState.target, getEventTarget(e) as Element);
297
+ if (isOverTarget && pressState.pointerType != null && pressState.pointerType !== 'virtual') {
298
+ // Pointer released over target - wait for onClick to complete the press sequence.
299
+ // This matches React-Aria's behavior for compatibility with DOM mutations and third-party libraries.
300
+ // https://github.com/adobe/react-spectrum/issues/1513
301
+ // https://issues.chromium.org/issues/40732224
302
+ //
303
+ // However, if stopPropagation is called on the click event (e.g., by a child input element),
304
+ // the onClick handler on this element won't fire. We work around this by triggering a click
305
+ // ourselves after a timeout. This timeout is canceled during the click event in case the
306
+ // real one fires first. The timeout must be at least 32ms, because Safari on iOS delays the
307
+ // click event on non-form elements without certain ARIA roles (for hover emulation).
308
+ // https://github.com/WebKit/WebKit/blob/dccfae42bb29bd4bdef052e469f604a9387241c0/Source/WebKit/WebProcess/WebPage/ios/WebPageIOS.mm#L875-L892
309
+ let clickFired = false;
310
+ const timeout = setTimeout(() => {
311
+ // Guard for SSR/test environments where the element may no longer exist
312
+ if (typeof HTMLElement === 'undefined') {
313
+ return;
314
+ }
315
+ if (pressState.isPressed && pressState.target instanceof HTMLElement) {
316
+ if (clickFired) {
317
+ // Click already happened, just cancel the press state
318
+ cancel(e);
319
+ } else {
320
+ // Click didn't happen (probably due to stopPropagation), trigger it manually
321
+ pressState.target.focus();
322
+ pressState.target.click();
323
+ }
324
+ }
325
+ }, 80);
326
+
327
+ // Use a capturing listener to track if a click occurred.
328
+ // If stopPropagation is called it may never reach our handler.
329
+ const doc = pressState.target.ownerDocument ?? document;
330
+ const clickListener = () => {
331
+ clickFired = true;
332
+ };
333
+ doc.addEventListener('click', clickListener, true);
334
+
335
+ // Store cleanup function
336
+ pressState.clickCleanup = () => {
337
+ clearTimeout(timeout);
338
+ doc.removeEventListener('click', clickListener, true);
339
+ };
340
+
341
+ pressState.isOverTarget = false;
342
+ } else {
343
+ // Pointer released outside target, or virtual - cancel the press
344
+ cancel(e);
345
+ }
346
+ };
347
+
348
+ const onPointerCancel = (e: PointerEvent): void => {
349
+ if (e.pointerId === pressState.activePointerId) {
350
+ cancel(e);
351
+ }
352
+ };
353
+
354
+ const onPointerEnter: JSX.EventHandler<HTMLElement, PointerEvent> = (e) => {
355
+ if (e.pointerId === pressState.activePointerId && pressState.target && !pressState.isOverTarget && pressState.pointerType != null) {
356
+ pressState.isOverTarget = true;
357
+ triggerPressStart(e, pressState.pointerType);
358
+ }
359
+ };
360
+
361
+ const onPointerLeave: JSX.EventHandler<HTMLElement, PointerEvent> = (e) => {
362
+ if (e.pointerId === pressState.activePointerId && pressState.target && pressState.isOverTarget && pressState.pointerType != null) {
363
+ pressState.isOverTarget = false;
364
+ triggerPressEnd(e, pressState.pointerType, false);
365
+
366
+ if (props.shouldCancelOnPointerExit) {
367
+ cancel(e);
368
+ }
369
+ }
370
+ };
371
+
372
+ // --- Touch Event Handlers (fallback for testing/older browsers) ---
373
+
374
+ const onTouchStart: JSX.EventHandler<HTMLElement, TouchEvent> = (e) => {
375
+ if (isDisabledValue(props.isDisabled)) {
376
+ return;
377
+ }
378
+
379
+ // If already pressed via pointer events, ignore touch events
380
+ if (pressState.isPressed) {
381
+ return;
382
+ }
383
+
384
+ const touch = getTouchFromEvent(e);
385
+ if (!touch) {
386
+ return;
387
+ }
388
+
389
+ pressState.activePointerId = touch.identifier;
390
+ pressState.ignoreEmulatedMouseEvents = true;
391
+ pressState.isOverTarget = true;
392
+ pressState.isPressed = true;
393
+ pressState.target = e.currentTarget;
394
+ pressState.pointerType = 'touch';
395
+
396
+ if (!props.allowTextSelectionOnPress) {
397
+ disableTextSelection(pressState.target as HTMLElement);
398
+ }
399
+
400
+ const shouldStopPropagation = triggerPressStart(e, 'touch');
401
+ if (shouldStopPropagation) {
402
+ e.stopPropagation();
403
+ }
404
+
405
+ addGlobalListener('scroll', onScroll, { capture: true, isWindow: true });
406
+ };
407
+
408
+ const onTouchMove: JSX.EventHandler<HTMLElement, TouchEvent> = (e) => {
409
+ if (!pressState.isPressed) {
410
+ return;
411
+ }
412
+
413
+ const touch = getTouchById(e, pressState.activePointerId);
414
+ if (!touch) {
415
+ return;
416
+ }
417
+
418
+ const target = pressState.target!;
419
+ const isOverTarget = isPointOverTarget(touch, target);
420
+
421
+ if (isOverTarget !== pressState.isOverTarget) {
422
+ pressState.isOverTarget = isOverTarget;
423
+ if (isOverTarget) {
424
+ triggerPressStart(e, 'touch');
425
+ } else {
426
+ triggerPressEnd(e, 'touch', false);
427
+
428
+ if (props.shouldCancelOnPointerExit) {
429
+ cancel(e);
430
+ }
431
+ }
432
+ }
433
+ };
434
+
435
+ const onTouchEnd: JSX.EventHandler<HTMLElement, TouchEvent> = (e) => {
436
+ if (!pressState.isPressed) {
437
+ return;
438
+ }
439
+
440
+ const touch = getTouchById(e, pressState.activePointerId);
441
+ if (!touch) {
442
+ return;
443
+ }
444
+
445
+ const target = pressState.target!;
446
+ const isOverTarget = isPointOverTarget(touch, target);
447
+
448
+ if (isOverTarget) {
449
+ triggerPressUp(e, 'touch');
450
+ }
451
+
452
+ triggerPressEnd(e, 'touch', isOverTarget && pressState.isOverTarget);
453
+
454
+ pressState.isPressed = false;
455
+ pressState.isOverTarget = false;
456
+ pressState.activePointerId = null;
457
+ pressState.pointerType = null;
458
+
459
+ removeAllGlobalListeners();
460
+
461
+ if (!props.allowTextSelectionOnPress) {
462
+ restoreTextSelection(target as HTMLElement);
463
+ }
464
+ };
465
+
466
+ const onTouchCancel: JSX.EventHandler<HTMLElement, TouchEvent> = (e) => {
467
+ cancel(e);
468
+ };
469
+
470
+ const onScroll = (e: Event): void => {
471
+ if (pressState.isPressed && nodeContains(e.target as Element, pressState.target)) {
472
+ cancel(e);
473
+ }
474
+ };
475
+
476
+ // --- Mouse Event Handlers (fallback when PointerEvent is not available) ---
477
+
478
+ const onMouseDownFallback: JSX.EventHandler<HTMLElement, MouseEvent> = (e) => {
479
+ // Only handle left button
480
+ if (e.button !== 0) {
481
+ return;
482
+ }
483
+
484
+ // Ignore emulated mouse events from touch
485
+ if (pressState.ignoreEmulatedMouseEvents) {
486
+ e.stopPropagation();
487
+ return;
488
+ }
489
+
490
+ pressState.isPressed = true;
491
+ pressState.isOverTarget = true;
492
+ pressState.target = e.currentTarget;
493
+ pressState.pointerType = isVirtualClick(e) ? 'virtual' : 'mouse';
494
+
495
+ const shouldStopPropagation = triggerPressStart(e, pressState.pointerType);
496
+ if (shouldStopPropagation) {
497
+ e.stopPropagation();
498
+ }
499
+
500
+ addGlobalListener('mouseup', onMouseUpFallback);
501
+ };
502
+
503
+ const onMouseUpFallback = (e: MouseEvent): void => {
504
+ if (e.button !== 0) {
505
+ return;
506
+ }
507
+
508
+ if (!pressState.ignoreEmulatedMouseEvents && e.button === 0 && !pressState.isPressed) {
509
+ triggerPressUp(e, pressState.pointerType || 'mouse');
510
+ }
511
+ };
512
+
513
+ const onMouseEnterFallback: JSX.EventHandler<HTMLElement, MouseEvent> = (e) => {
514
+ if (!pressState.isPressed || pressState.ignoreEmulatedMouseEvents) {
515
+ return;
516
+ }
517
+
518
+ if (pressState.isPressed && !pressState.ignoreEmulatedMouseEvents && pressState.pointerType != null) {
519
+ pressState.isOverTarget = true;
520
+ triggerPressStart(e, pressState.pointerType);
521
+ }
522
+ };
523
+
524
+ const onMouseLeaveFallback: JSX.EventHandler<HTMLElement, MouseEvent> = (e) => {
525
+ if (!pressState.isPressed || pressState.ignoreEmulatedMouseEvents) {
526
+ return;
527
+ }
528
+
529
+ if (pressState.isPressed && !pressState.ignoreEmulatedMouseEvents && pressState.pointerType != null) {
530
+ pressState.isOverTarget = false;
531
+ triggerPressEnd(e, pressState.pointerType, false);
532
+
533
+ if (props.shouldCancelOnPointerExit) {
534
+ cancel(e);
535
+ }
536
+ }
537
+ };
538
+
539
+ // --- Keyboard Event Handlers ---
540
+
541
+ const onKeyDown: JSX.EventHandler<HTMLElement, KeyboardEvent> = (e) => {
542
+ if (isDisabledValue(props.isDisabled)) {
543
+ return;
544
+ }
545
+
546
+ if (!isValidKeyboardEvent(e, e.currentTarget)) {
547
+ // Allow event to propagate for invalid keys
548
+ if (e.key === 'Enter') {
549
+ e.stopPropagation();
550
+ }
551
+ return;
552
+ }
553
+
554
+ // Prevent key repeat
555
+ if (e.repeat) {
556
+ e.preventDefault();
557
+ return;
558
+ }
559
+
560
+ pressState.target = e.currentTarget;
561
+ pressState.isPressed = true;
562
+ pressState.isOverTarget = true;
563
+ pressState.pointerType = 'keyboard';
564
+
565
+ const shouldStopPropagation = triggerPressStart(e, 'keyboard');
566
+ if (shouldStopPropagation) {
567
+ e.stopPropagation();
568
+ }
569
+
570
+ // Prevent default for non-native interactive elements
571
+ if (shouldPreventDefaultKeyboard(e.currentTarget, e.key)) {
572
+ e.preventDefault();
573
+ }
574
+
575
+ // macOS bug: keyup doesn't fire while Meta key is held
576
+ // Track keydown events while Meta is held so we can manually dispatch keyup
577
+ if (isMac() && e.metaKey && !e.ctrlKey && !e.altKey) {
578
+ pressState.metaKeyEvents = pressState.metaKeyEvents || new Map();
579
+ pressState.metaKeyEvents.set(e.key, e);
580
+ }
581
+
582
+ // For Enter key on native buttons, the click fires on keydown
583
+ // Set flag to ignore it
584
+ if (e.key === 'Enter') {
585
+ pressState.ignoreClickAfterPress = true;
586
+ }
587
+
588
+ // Set up global keyup listener
589
+ addGlobalListener('keyup', onKeyUp, { capture: true });
590
+ };
591
+
592
+ const onKeyUp = (e: KeyboardEvent): void => {
593
+ if (!pressState.isPressed || pressState.pointerType !== 'keyboard') {
594
+ return;
595
+ }
596
+
597
+ if (!isValidKeyboardEvent(e, pressState.target!)) {
598
+ return;
599
+ }
600
+
601
+ // Handle macOS Meta key bug
602
+ if (isMac() && e.key === 'Meta' && pressState.metaKeyEvents?.size) {
603
+ // When Meta releases, dispatch keyup for any keys that were pressed during
604
+ for (const [key, event] of pressState.metaKeyEvents) {
605
+ pressState.target?.dispatchEvent(
606
+ new KeyboardEvent('keyup', {
607
+ key,
608
+ code: event.code,
609
+ bubbles: true,
610
+ cancelable: true,
611
+ })
612
+ );
613
+ }
614
+ pressState.metaKeyEvents.clear();
615
+ return;
616
+ }
617
+
618
+ const target = pressState.target!;
619
+ triggerPressUp(e, 'keyboard');
620
+ triggerPressEnd(e, 'keyboard', pressState.isOverTarget);
621
+
622
+ pressState.isPressed = false;
623
+ pressState.pointerType = null;
624
+
625
+ removeAllGlobalListeners();
626
+
627
+ // Prevent default to avoid triggering native action
628
+ e.preventDefault();
629
+
630
+ // Handle link activation with non-Enter keys (Space)
631
+ // Native links only respond to Enter, but we want Space to work too
632
+ if (e.key === ' ' && isHTMLAnchorLink(target) && !(target as any)[LINK_CLICKED]) {
633
+ (target as any)[LINK_CLICKED] = true;
634
+ openLink(target as HTMLAnchorElement, e);
635
+ // Clean up the marker
636
+ setTimeout(() => {
637
+ delete (target as any)[LINK_CLICKED];
638
+ }, 0);
639
+ }
640
+
641
+ // For Space key, the click fires after keyup
642
+ // Set flag to ignore it
643
+ if (e.key === ' ') {
644
+ pressState.ignoreClickAfterPress = true;
645
+ }
646
+ };
647
+
648
+ // --- Click Event Handler ---
649
+
650
+ const onClick: JSX.EventHandler<HTMLElement, MouseEvent> = (e) => {
651
+ // Don't handle click if it's not on the target
652
+ if (!nodeContains(e.currentTarget, e.target as Element)) {
653
+ return;
654
+ }
655
+
656
+ // Only process left clicks that aren't from our own event triggers
657
+ if (e.button === 0 && !pressState.isTriggeringEvent) {
658
+ if (isDisabledValue(props.isDisabled)) {
659
+ e.preventDefault();
660
+ return;
661
+ }
662
+
663
+ // If triggered from a screen reader or by using element.click(),
664
+ // trigger as if it were a keyboard/virtual click.
665
+ if (
666
+ !pressState.ignoreEmulatedMouseEvents &&
667
+ !pressState.isPressed &&
668
+ (pressState.pointerType === 'virtual' || isVirtualClick(e))
669
+ ) {
670
+ pressState.target = e.currentTarget;
671
+ triggerPressStart(e, 'virtual');
672
+ triggerPressUp(e, 'virtual');
673
+ triggerPressEnd(e, 'virtual', true);
674
+ } else if (pressState.isPressed && pressState.pointerType !== 'keyboard') {
675
+ // Complete the press sequence for pointer/touch/mouse events
676
+ const pointerType =
677
+ pressState.pointerType ||
678
+ ((e as unknown as PointerEvent).pointerType as PointerType) ||
679
+ 'virtual';
680
+ triggerPressUp(e, pointerType);
681
+ triggerPressEnd(e, pointerType, true);
682
+ pressState.isOverTarget = false;
683
+ cancel(e);
684
+ }
685
+
686
+ pressState.ignoreEmulatedMouseEvents = false;
687
+ }
688
+ };
689
+
690
+ // --- Drag Event Handler ---
691
+
692
+ const onDragStart: JSX.EventHandler<HTMLElement, DragEvent> = (e) => {
693
+ // Safari doesn't fire pointercancel on drag, so we need to cancel manually
694
+ if (pressState.isPressed) {
695
+ cancel(e);
696
+ }
697
+ };
698
+
699
+ // --- Build Props ---
700
+ // Conditionally use pointer events or mouse events based on browser support
701
+ // This matches React-Aria's approach exactly
702
+
703
+ const pressProps: JSX.HTMLAttributes<HTMLElement> & { 'data-solidaria-pressable': string } =
704
+ typeof PointerEvent !== 'undefined'
705
+ ? {
706
+ // Keyboard events
707
+ onKeyDown,
708
+ onKeyUp,
709
+ onClick,
710
+ onDragStart,
711
+ // Pointer events (preferred when available)
712
+ onPointerDown,
713
+ onPointerEnter,
714
+ onPointerLeave,
715
+ // Mouse down only for focus prevention when using pointer events
716
+ onMouseDown: onMouseDownPointer,
717
+ // Touch events (always included for ignoreEmulatedMouseEvents handling)
718
+ onTouchStart,
719
+ onTouchMove,
720
+ onTouchEnd,
721
+ onTouchCancel,
722
+ // Attribute for CSS touch-action
723
+ 'data-solidaria-pressable': '',
724
+ }
725
+ : {
726
+ // Keyboard events
727
+ onKeyDown,
728
+ onKeyUp,
729
+ onClick,
730
+ onDragStart,
731
+ // Mouse events (fallback when PointerEvent not available)
732
+ onMouseDown: onMouseDownFallback,
733
+ onMouseEnter: onMouseEnterFallback,
734
+ onMouseLeave: onMouseLeaveFallback,
735
+ // Touch events (always included)
736
+ onTouchStart,
737
+ onTouchMove,
738
+ onTouchEnd,
739
+ onTouchCancel,
740
+ // Attribute for CSS touch-action
741
+ 'data-solidaria-pressable': '',
742
+ };
743
+
744
+ // Clean up on unmount
745
+ onCleanup(() => {
746
+ removeAllGlobalListeners();
747
+ // Clean up click timeout/listener if pending
748
+ if (pressState.clickCleanup) {
749
+ pressState.clickCleanup();
750
+ pressState.clickCleanup = null;
751
+ }
752
+ });
753
+
754
+ return {
755
+ isPressed,
756
+ pressProps,
757
+ };
758
+ }