@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,212 @@
1
+ /** The shapes every part of drag and drop speaks in. */
2
+
3
+ import type { Key } from "../collections.ts";
4
+ import type { MaybeAccessor } from "../utils.ts";
5
+
6
+ export type DropOperation = "copy" | "link" | "move" | "cancel";
7
+
8
+ /** One dragged thing, in every representation it offers: `{ "text/plain": "…" }`. */
9
+ export interface DragItem {
10
+ [type: string]: string;
11
+ }
12
+
13
+ export interface DragDropEvent {
14
+ /** Relative to the target for a drop event, to the viewport for a drag event. */
15
+ x: number;
16
+ y: number;
17
+ }
18
+
19
+ export interface DragStartEvent extends DragDropEvent {
20
+ type: "dragstart";
21
+ }
22
+
23
+ export interface DragMoveEvent extends DragDropEvent {
24
+ type: "dragmove";
25
+ }
26
+
27
+ export interface DragEndEvent extends DragDropEvent {
28
+ type: "dragend";
29
+ dropOperation: DropOperation;
30
+ }
31
+
32
+ export interface DropEnterEvent extends DragDropEvent {
33
+ type: "dropenter";
34
+ }
35
+
36
+ export interface DropMoveEvent extends DragDropEvent {
37
+ type: "dropmove";
38
+ }
39
+
40
+ export interface DropActivateEvent extends DragDropEvent {
41
+ type: "dropactivate";
42
+ }
43
+
44
+ export interface DropExitEvent extends DragDropEvent {
45
+ type: "dropexit";
46
+ }
47
+
48
+ export interface TextDropItem {
49
+ kind: "text";
50
+ types: Set<string>;
51
+ getText(type: string): Promise<string>;
52
+ }
53
+
54
+ export interface FileDropItem {
55
+ kind: "file";
56
+ type: string;
57
+ name: string;
58
+ getFile(): Promise<File>;
59
+ getText(): Promise<string>;
60
+ }
61
+
62
+ export interface DirectoryDropItem {
63
+ kind: "directory";
64
+ name: string;
65
+ getEntries(): AsyncIterable<FileDropItem | DirectoryDropItem>;
66
+ }
67
+
68
+ export type DropItem = TextDropItem | FileDropItem | DirectoryDropItem;
69
+
70
+ export interface DropEvent extends DragDropEvent {
71
+ type: "drop";
72
+ dropOperation: DropOperation;
73
+ items: DropItem[];
74
+ }
75
+
76
+ export type DropPosition = "on" | "before" | "after";
77
+
78
+ export interface RootDropTarget {
79
+ type: "root";
80
+ }
81
+
82
+ export interface ItemDropTarget {
83
+ type: "item";
84
+ key: Key;
85
+ dropPosition: DropPosition;
86
+ }
87
+
88
+ export type DropTarget = RootDropTarget | ItemDropTarget;
89
+
90
+ export interface DroppableCollectionEnterEvent extends DropEnterEvent {
91
+ target: DropTarget;
92
+ }
93
+
94
+ export interface DroppableCollectionMoveEvent extends DropMoveEvent {
95
+ target: DropTarget;
96
+ }
97
+
98
+ export interface DroppableCollectionActivateEvent extends DropActivateEvent {
99
+ target: DropTarget;
100
+ }
101
+
102
+ export interface DroppableCollectionExitEvent extends DropExitEvent {
103
+ target: DropTarget;
104
+ }
105
+
106
+ export interface DroppableCollectionDropEvent extends DropEvent {
107
+ target: DropTarget;
108
+ }
109
+
110
+ export interface DroppableCollectionInsertDropEvent {
111
+ items: DropItem[];
112
+ dropOperation: DropOperation;
113
+ target: ItemDropTarget;
114
+ }
115
+
116
+ export interface DroppableCollectionRootDropEvent {
117
+ items: DropItem[];
118
+ dropOperation: DropOperation;
119
+ }
120
+
121
+ export interface DroppableCollectionOnItemDropEvent {
122
+ items: DropItem[];
123
+ dropOperation: DropOperation;
124
+ isInternal: boolean;
125
+ target: ItemDropTarget;
126
+ }
127
+
128
+ export interface DroppableCollectionReorderEvent {
129
+ keys: Set<Key>;
130
+ dropOperation: DropOperation;
131
+ target: ItemDropTarget;
132
+ }
133
+
134
+ export type DragType = string | symbol;
135
+
136
+ export interface DragTypes {
137
+ /** Whether any of the dragged items offers `type`. `"image/*"` matches a family. */
138
+ has(type: DragType | DragType[]): boolean;
139
+ }
140
+
141
+ export interface DropTargetDelegate {
142
+ getDropTargetFromPoint(
143
+ x: number,
144
+ y: number,
145
+ isValidDropTarget: (target: DropTarget) => boolean,
146
+ ): DropTarget | null;
147
+ }
148
+
149
+ export interface DraggableCollectionStartEvent extends DragStartEvent {
150
+ keys: Set<Key>;
151
+ }
152
+
153
+ export interface DraggableCollectionMoveEvent extends DragMoveEvent {
154
+ keys: Set<Key>;
155
+ }
156
+
157
+ export interface DraggableCollectionEndEvent extends DragEndEvent {
158
+ keys: Set<Key>;
159
+ isInternal: boolean;
160
+ }
161
+
162
+ /**
163
+ * Renders the preview for a drag, then hands its element back so the browser
164
+ * can photograph it. `x` and `y` override where it sits under the pointer.
165
+ */
166
+ export type DragPreviewRenderer = (
167
+ items: DragItem[],
168
+ callback: (node: HTMLElement | null, x?: number, y?: number) => void,
169
+ ) => void;
170
+
171
+ export interface DroppableCollectionUtilityOptions {
172
+ /** @default "all" */
173
+ acceptedDragTypes?: "all" | DragType[];
174
+ /** Items from elsewhere, dropped between two items. */
175
+ onInsert?: (event: DroppableCollectionInsertDropEvent) => void | Promise<void>;
176
+ /** Items from elsewhere, dropped on the collection itself. */
177
+ onRootDrop?: (event: DroppableCollectionRootDropEvent) => void | Promise<void>;
178
+ /** Items dropped ON an item, from anywhere. */
179
+ onItemDrop?: (event: DroppableCollectionOnItemDropEvent) => void | Promise<void>;
180
+ /** Items of this collection, dropped between two of its items at the same level. */
181
+ onReorder?: (event: DroppableCollectionReorderEvent) => void | Promise<void>;
182
+ /** Items of this collection, dropped anywhere in it. */
183
+ onMove?: (event: DroppableCollectionReorderEvent) => void | Promise<void>;
184
+ /** Whether an item accepts a drop on itself, on top of `acceptedDragTypes`. */
185
+ shouldAcceptItemDrop?: (target: ItemDropTarget, types: DragTypes) => boolean;
186
+ }
187
+
188
+ export interface DroppableCollectionBaseProps {
189
+ onDropEnter?: (event: DroppableCollectionEnterEvent) => void;
190
+ onDropActivate?: (event: DroppableCollectionActivateEvent) => void;
191
+ onDropExit?: (event: DroppableCollectionExitEvent) => void;
192
+ /** Every drop, before the utility handlers interpret it. Replaces them when given. */
193
+ onDrop?: (event: DroppableCollectionDropEvent) => void | Promise<void>;
194
+ getDropOperation?: (
195
+ target: DropTarget,
196
+ types: DragTypes,
197
+ allowedOperations: DropOperation[],
198
+ ) => DropOperation;
199
+ }
200
+
201
+ export interface DroppableCollectionProps
202
+ extends DroppableCollectionUtilityOptions, DroppableCollectionBaseProps {}
203
+
204
+ export interface DraggableCollectionProps<T = unknown> {
205
+ onDragStart?: (event: DraggableCollectionStartEvent) => void;
206
+ onDragMove?: (event: DraggableCollectionMoveEvent) => void;
207
+ onDragEnd?: (event: DraggableCollectionEndEvent) => void;
208
+ /** What a drag of `keys` carries. `items` are the values those keys were built from. */
209
+ getItems: (keys: Set<Key>, items: T[]) => DragItem[];
210
+ preview?: MaybeAccessor<DragPreviewRenderer | null | undefined>;
211
+ getAllowedDropOperations?: () => DropOperation[];
212
+ }