@barqjs/aria 0.0.0-stage → 0.2.0-next.1

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 (103) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +304 -2
  3. package/package.json +437 -4
  4. package/src/autocomplete.tsx +581 -0
  5. package/src/breadcrumbs.tsx +297 -0
  6. package/src/button.tsx +468 -0
  7. package/src/calendar.tsx +2316 -0
  8. package/src/checkbox.tsx +732 -0
  9. package/src/collections.ts +1059 -0
  10. package/src/color.ts +2119 -0
  11. package/src/colorpicker.tsx +2023 -0
  12. package/src/colorswatchpicker.tsx +240 -0
  13. package/src/combobox.tsx +3003 -0
  14. package/src/command.tsx +1203 -0
  15. package/src/date.ts +674 -0
  16. package/src/datefield.tsx +2066 -0
  17. package/src/datepicker.tsx +907 -0
  18. package/src/dialog.tsx +1077 -0
  19. package/src/disclosure.tsx +711 -0
  20. package/src/dnd/clipboard.ts +125 -0
  21. package/src/dnd/collection.ts +1265 -0
  22. package/src/dnd/data.ts +409 -0
  23. package/src/dnd/drag-drop.ts +801 -0
  24. package/src/dnd/index.ts +133 -0
  25. package/src/dnd/manager.ts +639 -0
  26. package/src/dnd/strings.ts +1279 -0
  27. package/src/dnd/targets.ts +726 -0
  28. package/src/dnd/types.ts +212 -0
  29. package/src/dom.ts +703 -0
  30. package/src/drag-and-drop.tsx +669 -0
  31. package/src/drawer.ts +674 -0
  32. package/src/dropzone.tsx +208 -0
  33. package/src/file-trigger.tsx +103 -0
  34. package/src/focus.ts +1370 -0
  35. package/src/form.tsx +94 -0
  36. package/src/gridlist.tsx +1354 -0
  37. package/src/group.tsx +146 -0
  38. package/src/i18n.ts +823 -0
  39. package/src/index.ts +1672 -0
  40. package/src/interactions/description.ts +73 -0
  41. package/src/interactions/flags.ts +35 -0
  42. package/src/interactions/focus-events.ts +226 -0
  43. package/src/interactions/focusable.ts +86 -0
  44. package/src/interactions/hover.ts +213 -0
  45. package/src/interactions/interact-outside.ts +123 -0
  46. package/src/interactions/keyboard.ts +298 -0
  47. package/src/interactions/listeners.ts +78 -0
  48. package/src/interactions/long-press.ts +160 -0
  49. package/src/interactions/modality.ts +428 -0
  50. package/src/interactions/move.ts +257 -0
  51. package/src/interactions/open-link.ts +226 -0
  52. package/src/interactions/press.ts +915 -0
  53. package/src/interactions/prevent-focus.ts +102 -0
  54. package/src/interactions/scroll-wheel.ts +43 -0
  55. package/src/interactions/text-selection.ts +77 -0
  56. package/src/interactions.ts +81 -0
  57. package/src/label.ts +140 -0
  58. package/src/link.tsx +477 -0
  59. package/src/listbox.tsx +1247 -0
  60. package/src/live.ts +208 -0
  61. package/src/menu.tsx +2383 -0
  62. package/src/menubar.tsx +579 -0
  63. package/src/navigation-tree.tsx +357 -0
  64. package/src/navigation.ts +735 -0
  65. package/src/numberfield.tsx +942 -0
  66. package/src/otp.ts +430 -0
  67. package/src/overlay-arrow.tsx +157 -0
  68. package/src/overlays.ts +1549 -0
  69. package/src/platform.ts +75 -0
  70. package/src/presence.ts +164 -0
  71. package/src/preview-trigger.tsx +582 -0
  72. package/src/progress-bar-context.ts +15 -0
  73. package/src/questionnaire.tsx +1717 -0
  74. package/src/radio.tsx +641 -0
  75. package/src/register-dom.ts +12 -0
  76. package/src/scroller.ts +1165 -0
  77. package/src/select.tsx +1745 -0
  78. package/src/selection-indicator.tsx +74 -0
  79. package/src/selection.ts +1472 -0
  80. package/src/shared-element-transition.tsx +316 -0
  81. package/src/sheet.tsx +1461 -0
  82. package/src/slider.tsx +1137 -0
  83. package/src/splitter.ts +1152 -0
  84. package/src/static-collection.ts +211 -0
  85. package/src/switch.tsx +212 -0
  86. package/src/table.tsx +2218 -0
  87. package/src/tabs.tsx +1127 -0
  88. package/src/tag.tsx +637 -0
  89. package/src/textarea.tsx +186 -0
  90. package/src/textfield.tsx +483 -0
  91. package/src/toast-components.tsx +589 -0
  92. package/src/toast.ts +658 -0
  93. package/src/toggle-button-group.tsx +175 -0
  94. package/src/toggle-input.tsx +86 -0
  95. package/src/toggle.ts +384 -0
  96. package/src/togglegroup.ts +365 -0
  97. package/src/tokenfield.tsx +1673 -0
  98. package/src/toolbar.tsx +184 -0
  99. package/src/tooltip.tsx +674 -0
  100. package/src/tree.tsx +2075 -0
  101. package/src/utils.ts +787 -0
  102. package/src/validation.ts +504 -0
  103. package/src/virtualizer.tsx +837 -0
@@ -0,0 +1,125 @@
1
+ /** Copy, cut and paste, through the system clipboard. */
2
+
3
+ import { createEffect } from "@barqjs/core";
4
+ import { isServer } from "@barqjs/web";
5
+ import { focused } from "../interactions/focus-events.ts";
6
+ import { access, type DOMProps, type MaybeAccessor } from "../utils.ts";
7
+ import { readFromDataTransfer, writeToDataTransfer } from "./data.ts";
8
+ import type { DragItem, DropItem } from "./types.ts";
9
+
10
+ export interface ClipboardOptions {
11
+ /** What a copy or a cut writes. Without it, nothing can be copied. */
12
+ getItems?: (details: { action: "cut" | "copy" }) => DragItem[];
13
+ onCopy?: () => void;
14
+ /** Without it, nothing can be cut. */
15
+ onCut?: () => void;
16
+ /** Without it, nothing can be pasted. */
17
+ onPaste?: (items: DropItem[]) => void;
18
+ isDisabled?: MaybeAccessor<boolean | undefined>;
19
+ }
20
+
21
+ export interface ClipboardResult {
22
+ clipboardProps: DOMProps;
23
+ }
24
+
25
+ type ClipboardListener = (event: ClipboardEvent) => void;
26
+
27
+ const clipboardHandlers = new Map<
28
+ string,
29
+ { listener: (event: Event) => void; handlers: Set<ClipboardListener> }
30
+ >();
31
+
32
+ /** One document listener per event, shared by every element that wants it. */
33
+ function addClipboardListener(type: string, handler: ClipboardListener): () => void {
34
+ let entry = clipboardHandlers.get(type);
35
+ if (entry === undefined) {
36
+ const handlers = new Set<ClipboardListener>();
37
+ const listener = (event: Event): void => {
38
+ for (const each of handlers) each(event as ClipboardEvent);
39
+ };
40
+ entry = { listener, handlers };
41
+ clipboardHandlers.set(type, entry);
42
+ document.addEventListener(type, listener);
43
+ }
44
+ const registered = entry;
45
+ registered.handlers.add(handler);
46
+ return () => {
47
+ registered.handlers.delete(handler);
48
+ if (registered.handlers.size === 0) {
49
+ document.removeEventListener(type, registered.listener);
50
+ clipboardHandlers.delete(type);
51
+ }
52
+ };
53
+ }
54
+
55
+ /**
56
+ * Copy, cut and paste for a focusable element, through the system clipboard.
57
+ *
58
+ * The clipboard events fire on the document whatever is focused, so they are
59
+ * heard there and acted on only while this element has focus.
60
+ */
61
+ export function clipboard(options: ClipboardOptions): ClipboardResult {
62
+ let isFocused = false;
63
+ const { focusProps } = focused({
64
+ onFocusChange: (value) => {
65
+ isFocused = value;
66
+ },
67
+ });
68
+
69
+ // Each `before*` event enables the menu item in Safari.
70
+ const onBeforeCopy = (event: ClipboardEvent): void => {
71
+ if (isFocused && options.getItems !== undefined) event.preventDefault();
72
+ };
73
+ const onCopy = (event: ClipboardEvent): void => {
74
+ if (!isFocused || options.getItems === undefined) return;
75
+ event.preventDefault();
76
+ if (event.clipboardData === null) return;
77
+ writeToDataTransfer(event.clipboardData, options.getItems({ action: "copy" }));
78
+ options.onCopy?.();
79
+ };
80
+ const onBeforeCut = (event: ClipboardEvent): void => {
81
+ if (isFocused && options.onCut !== undefined && options.getItems !== undefined) {
82
+ event.preventDefault();
83
+ }
84
+ };
85
+ const onCut = (event: ClipboardEvent): void => {
86
+ if (!isFocused || options.onCut === undefined || options.getItems === undefined) return;
87
+ event.preventDefault();
88
+ if (event.clipboardData === null) return;
89
+ writeToDataTransfer(event.clipboardData, options.getItems({ action: "cut" }));
90
+ options.onCut();
91
+ };
92
+ // The types are not readable here, so Paste is enabled whatever is on the
93
+ // clipboard.
94
+ const onBeforePaste = (event: ClipboardEvent): void => {
95
+ if (isFocused && options.onPaste !== undefined) event.preventDefault();
96
+ };
97
+ const onPaste = (event: ClipboardEvent): void => {
98
+ if (!isFocused || options.onPaste === undefined) return;
99
+ event.preventDefault();
100
+ if (event.clipboardData === null) return;
101
+ options.onPaste(readFromDataTransfer(event.clipboardData));
102
+ };
103
+
104
+ if (!isServer) {
105
+ createEffect(
106
+ () => access(options.isDisabled) === true,
107
+ (disabled) => {
108
+ if (disabled) return undefined;
109
+ const undo = [
110
+ addClipboardListener("beforecopy", onBeforeCopy),
111
+ addClipboardListener("copy", onCopy),
112
+ addClipboardListener("beforecut", onBeforeCut),
113
+ addClipboardListener("cut", onCut),
114
+ addClipboardListener("beforepaste", onBeforePaste),
115
+ addClipboardListener("paste", onPaste),
116
+ ];
117
+ return () => {
118
+ for (const fn of undo) fn();
119
+ };
120
+ },
121
+ );
122
+ }
123
+
124
+ return { clipboardProps: focusProps };
125
+ }