@astryxdesign/core 0.7.8 → 0.7.9-canary.048476f

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 (213) hide show
  1. package/dist/BottomSheet/BottomSheet.d.ts.map +1 -1
  2. package/dist/BottomSheet/BottomSheet.js +5 -0
  3. package/dist/Calendar/styles.d.ts +1 -1
  4. package/dist/ClickableCard/ClickableCard.d.ts +1 -1
  5. package/dist/ClickableCard/ClickableCard.d.ts.map +1 -1
  6. package/dist/ClickableCard/ClickableCard.js +5 -1
  7. package/dist/DateInput/PickerWheel.d.ts.map +1 -1
  8. package/dist/DateInput/PickerWheel.js +7 -1
  9. package/dist/DateRangeInput/DateRangeInput.js +1 -1
  10. package/dist/Dialog/Dialog.d.ts +2 -1
  11. package/dist/Dialog/Dialog.d.ts.map +1 -1
  12. package/dist/Dialog/Dialog.js +12 -1
  13. package/dist/Drawer/useDrawerDialogPresence.d.ts +2 -1
  14. package/dist/Drawer/useDrawerDialogPresence.d.ts.map +1 -1
  15. package/dist/Drawer/useDrawerDialogPresence.js +11 -2
  16. package/dist/DropdownMenu/DropdownMenu.d.ts +9 -1
  17. package/dist/DropdownMenu/DropdownMenu.d.ts.map +1 -1
  18. package/dist/DropdownMenu/DropdownMenu.js +9 -4
  19. package/dist/DropdownMenu/DropdownMenuCheckboxItem.d.ts.map +1 -1
  20. package/dist/DropdownMenu/DropdownMenuCheckboxItem.js +3 -2
  21. package/dist/DropdownMenu/DropdownMenuItem.d.ts.map +1 -1
  22. package/dist/DropdownMenu/DropdownMenuItem.js +3 -2
  23. package/dist/DropdownMenu/DropdownMenuRadioItem.d.ts.map +1 -1
  24. package/dist/DropdownMenu/DropdownMenuRadioItem.js +3 -2
  25. package/dist/DropdownMenu/DropdownMenuSubMenu.d.ts.map +1 -1
  26. package/dist/DropdownMenu/DropdownMenuSubMenu.js +3 -2
  27. package/dist/Field/inputDisabledFocus.d.ts +4 -4
  28. package/dist/Field/inputStyles.stylex.d.ts +1 -1
  29. package/dist/FileInput/FileInput.d.ts.map +1 -1
  30. package/dist/FileInput/FileInput.js +16 -2
  31. package/dist/Icon/Icon.d.ts +1 -1
  32. package/dist/InfoTip/InfoTip.d.ts +1 -0
  33. package/dist/InfoTip/InfoTip.d.ts.map +1 -1
  34. package/dist/InfoTip/InfoTip.js +1 -0
  35. package/dist/Item/Item.d.ts +2 -1
  36. package/dist/Item/Item.d.ts.map +1 -1
  37. package/dist/Item/Item.js +29 -6
  38. package/dist/Layer/holdEntranceInput.d.ts +24 -0
  39. package/dist/Layer/holdEntranceInput.d.ts.map +1 -0
  40. package/dist/Layer/holdEntranceInput.js +65 -0
  41. package/dist/Layer/inputHold.d.ts +49 -0
  42. package/dist/Layer/inputHold.d.ts.map +1 -0
  43. package/dist/Layer/inputHold.js +636 -0
  44. package/dist/Layer/preserveAnimations.d.ts +1 -5
  45. package/dist/Layer/preserveAnimations.d.ts.map +1 -1
  46. package/dist/Layer/preserveAnimations.js +12 -214
  47. package/dist/Lightbox/Lightbox.d.ts.map +1 -1
  48. package/dist/Lightbox/Lightbox.js +4 -0
  49. package/dist/MetadataList/MetadataList.js +1 -1
  50. package/dist/MobileNav/MobileNav.d.ts +11 -1
  51. package/dist/MobileNav/MobileNav.d.ts.map +1 -1
  52. package/dist/MobileNav/MobileNav.js +34 -1
  53. package/dist/MoreMenu/MoreMenu.d.ts +5 -3
  54. package/dist/MoreMenu/MoreMenu.d.ts.map +1 -1
  55. package/dist/RadioList/RadioListItem.d.ts.map +1 -1
  56. package/dist/RadioList/RadioListItem.js +4 -1
  57. package/dist/SelectableCard/SelectableCard.d.ts +1 -1
  58. package/dist/SelectableCard/SelectableCard.d.ts.map +1 -1
  59. package/dist/SelectableCard/SelectableCard.js +5 -1
  60. package/dist/Spinner/Spinner.d.ts.map +1 -1
  61. package/dist/Spinner/Spinner.js +12 -2
  62. package/dist/Table/plugins/sortable/useTableSortable.js +1 -1
  63. package/dist/Token/Token.d.ts.map +1 -1
  64. package/dist/Token/Token.js +9 -0
  65. package/dist/Token/TokenLink.d.ts +1 -1
  66. package/dist/Token/TokenLink.d.ts.map +1 -1
  67. package/dist/Token/TokenLink.js +4 -1
  68. package/dist/Tooltip/useTooltip.d.ts.map +1 -1
  69. package/dist/Tooltip/useTooltip.js +162 -59
  70. package/dist/TreeList/TreeListItem.d.ts +2 -1
  71. package/dist/TreeList/TreeListItem.d.ts.map +1 -1
  72. package/dist/TreeList/TreeListItem.js +27 -3
  73. package/dist/astryx.css +30 -7
  74. package/dist/gestures/GestureHost.d.ts +2 -2
  75. package/dist/gestures/GestureHost.d.ts.map +1 -1
  76. package/dist/gestures/GestureHost.js +21 -6
  77. package/dist/gestures/nativeScroll.d.ts +3 -6
  78. package/dist/gestures/nativeScroll.d.ts.map +1 -1
  79. package/dist/gestures/nativeScroll.js +7 -52
  80. package/dist/gestures/wheelSegmenter.d.ts +68 -1
  81. package/dist/gestures/wheelSegmenter.d.ts.map +1 -1
  82. package/dist/gestures/wheelSegmenter.js +199 -10
  83. package/dist/hooks/menuPressGesture.d.ts +133 -21
  84. package/dist/hooks/menuPressGesture.d.ts.map +1 -1
  85. package/dist/hooks/menuPressGesture.js +155 -30
  86. package/dist/hooks/menuPressValues.d.ts +16 -0
  87. package/dist/hooks/menuPressValues.d.ts.map +1 -0
  88. package/dist/hooks/menuPressValues.js +18 -0
  89. package/dist/hooks/useClickableContainer.d.ts +27 -5
  90. package/dist/hooks/useClickableContainer.d.ts.map +1 -1
  91. package/dist/hooks/useClickableContainer.js +41 -5
  92. package/dist/hooks/useFocusTrap.d.ts +10 -0
  93. package/dist/hooks/useFocusTrap.d.ts.map +1 -1
  94. package/dist/hooks/useFocusTrap.js +225 -132
  95. package/dist/hooks/useMenuPress.d.ts +34 -1
  96. package/dist/hooks/useMenuPress.d.ts.map +1 -1
  97. package/dist/hooks/useMenuPress.js +93 -5
  98. package/dist/hooks/usePressFeedback.d.ts +6 -6
  99. package/dist/hooks/usePressFeedback.js +6 -6
  100. package/dist/motion/carryAnimations.d.ts +58 -0
  101. package/dist/motion/carryAnimations.d.ts.map +1 -0
  102. package/dist/motion/carryAnimations.js +305 -0
  103. package/dist/motion/transientCopy.d.ts +4 -2
  104. package/dist/motion/transientCopy.d.ts.map +1 -1
  105. package/dist/motion/transientCopy.js +34 -5
  106. package/dist/motion/uikit/gestures.d.ts +41 -0
  107. package/dist/motion/uikit/gestures.d.ts.map +1 -1
  108. package/dist/motion/uikit/gestures.js +25 -0
  109. package/dist/motion/uikit/index.d.ts +1 -1
  110. package/dist/motion/uikit/index.d.ts.map +1 -1
  111. package/dist/motion/uikit/index.js +1 -1
  112. package/dist/privateAttributes/menuPressLit.stylex.d.ts +52 -0
  113. package/dist/privateAttributes/menuPressLit.stylex.d.ts.map +1 -0
  114. package/dist/privateAttributes/menuPressLit.stylex.js +99 -0
  115. package/dist/privateAttributes/press.stylex.d.ts +139 -0
  116. package/dist/privateAttributes/press.stylex.d.ts.map +1 -0
  117. package/dist/privateAttributes/press.stylex.js +98 -0
  118. package/dist/theme/tokens.stylex.d.ts +2 -2
  119. package/dist/theme/tokens.stylex.js +1 -1
  120. package/dist/utils/flatTree.d.ts +6 -3
  121. package/dist/utils/flatTree.d.ts.map +1 -1
  122. package/dist/utils/flatTree.js +13 -3
  123. package/dist/utils/hitArea.d.ts.map +1 -1
  124. package/dist/utils/hitArea.js +82 -5
  125. package/dist/utils/inputStream.d.ts +14 -1
  126. package/dist/utils/inputStream.d.ts.map +1 -1
  127. package/dist/utils/inputStream.js +40 -9
  128. package/dist/utils/interactionOverlay.stylex.d.ts +2 -1
  129. package/dist/utils/interactionOverlay.stylex.d.ts.map +1 -1
  130. package/dist/utils/interactionOverlay.stylex.js +7 -2
  131. package/dist/utils/pressFeedback.d.ts +7 -0
  132. package/dist/utils/pressFeedback.d.ts.map +1 -1
  133. package/dist/utils/pressFeedback.js +32 -7
  134. package/dist/utils/pressGesture.d.ts +6 -0
  135. package/dist/utils/pressGesture.d.ts.map +1 -1
  136. package/dist/utils/pressGesture.js +17 -0
  137. package/dist/utils/rowPressLayer.stylex.d.ts +14 -0
  138. package/dist/utils/rowPressLayer.stylex.d.ts.map +1 -0
  139. package/dist/utils/rowPressLayer.stylex.js +25 -0
  140. package/dist/utils/scrollView.d.ts +25 -0
  141. package/dist/utils/scrollView.d.ts.map +1 -0
  142. package/dist/utils/scrollView.js +108 -0
  143. package/dist/utils/selectionLock.d.ts.map +1 -1
  144. package/dist/utils/selectionLock.js +1 -10
  145. package/dist/utils/triggerFocus.d.ts +5 -0
  146. package/dist/utils/triggerFocus.d.ts.map +1 -1
  147. package/dist/utils/triggerFocus.js +9 -2
  148. package/package.json +5 -5
  149. package/src/BottomSheet/BottomSheet.tsx +5 -0
  150. package/src/ClickableCard/ClickableCard.tsx +8 -1
  151. package/src/DateInput/PickerWheel.tsx +7 -2
  152. package/src/DateRangeInput/DateRangeInput.tsx +1 -1
  153. package/src/Dialog/Dialog.doc.mjs +1 -1
  154. package/src/Dialog/Dialog.tsx +12 -1
  155. package/src/Drawer/Drawer.doc.mjs +1 -1
  156. package/src/Drawer/useDrawerDialogPresence.ts +9 -2
  157. package/src/DropdownMenu/DropdownMenu.doc.mjs +1 -2
  158. package/src/DropdownMenu/DropdownMenu.tsx +29 -5
  159. package/src/DropdownMenu/DropdownMenuCheckboxItem.tsx +5 -1
  160. package/src/DropdownMenu/DropdownMenuItem.tsx +8 -4
  161. package/src/DropdownMenu/DropdownMenuRadioItem.tsx +5 -1
  162. package/src/DropdownMenu/DropdownMenuSubMenu.tsx +5 -1
  163. package/src/FileInput/FileInput.tsx +16 -2
  164. package/src/InfoTip/InfoTip.doc.mjs +26 -2
  165. package/src/InfoTip/InfoTip.tsx +1 -0
  166. package/src/Item/Item.tsx +51 -9
  167. package/src/Layer/holdEntranceInput.ts +84 -0
  168. package/src/Layer/inputHold.ts +734 -0
  169. package/src/Layer/preserveAnimations.ts +12 -275
  170. package/src/Lightbox/Lightbox.tsx +4 -0
  171. package/src/MetadataList/MetadataList.tsx +1 -1
  172. package/src/MobileNav/MobileNav.doc.mjs +3 -3
  173. package/src/MobileNav/MobileNav.tsx +34 -1
  174. package/src/MoreMenu/MoreMenu.doc.mjs +2 -4
  175. package/src/MoreMenu/MoreMenu.tsx +5 -3
  176. package/src/RadioList/RadioListItem.tsx +4 -5
  177. package/src/SelectableCard/SelectableCard.tsx +8 -1
  178. package/src/Spinner/Spinner.tsx +13 -3
  179. package/src/Table/plugins/sortable/useTableSortable.tsx +1 -1
  180. package/src/Token/Token.tsx +18 -1
  181. package/src/Token/TokenLink.tsx +7 -1
  182. package/src/Tooltip/useTooltip.tsx +175 -79
  183. package/src/TreeList/TreeListItem.tsx +36 -2
  184. package/src/gestures/GestureHost.ts +21 -5
  185. package/src/gestures/README.md +12 -4
  186. package/src/gestures/nativeScroll.ts +12 -68
  187. package/src/gestures/wheelSegmenter.ts +243 -10
  188. package/src/hooks/menuPressGesture.ts +244 -38
  189. package/src/hooks/menuPressValues.ts +18 -0
  190. package/src/hooks/useClickableContainer.doc.mjs +8 -2
  191. package/src/hooks/useClickableContainer.ts +72 -6
  192. package/src/hooks/useFocusTrap.ts +268 -151
  193. package/src/hooks/useMenuPress.ts +118 -11
  194. package/src/hooks/usePressFeedback.doc.mjs +3 -3
  195. package/src/hooks/usePressFeedback.ts +6 -6
  196. package/src/motion/MEASUREMENTS.md +11 -0
  197. package/src/motion/carryAnimations.ts +389 -0
  198. package/src/motion/transientCopy.ts +45 -5
  199. package/src/motion/uikit/gestures.ts +22 -0
  200. package/src/motion/uikit/index.ts +1 -0
  201. package/src/privateAttributes/menuPressLit.stylex.ts +104 -0
  202. package/src/privateAttributes/press.stylex.ts +244 -0
  203. package/src/theme/tokens.stylex.ts +1 -1
  204. package/src/utils/flatTree.ts +15 -3
  205. package/src/utils/hitArea.ts +107 -5
  206. package/src/utils/inputStream.ts +47 -10
  207. package/src/utils/interactionOverlay.stylex.ts +7 -2
  208. package/src/utils/pressFeedback.ts +31 -6
  209. package/src/utils/pressGesture.ts +24 -1
  210. package/src/utils/rowPressLayer.stylex.ts +27 -0
  211. package/src/utils/scrollView.ts +135 -0
  212. package/src/utils/selectionLock.ts +5 -10
  213. package/src/utils/triggerFocus.ts +17 -4
@@ -11,245 +11,23 @@
11
11
  *
12
12
  * Taking an element out of rendering cancels every CSS animation and
13
13
  * transition of it and its subtree. When it returns, the browser creates the
14
- * animations again from the stylesheet, at their start, and the transitions
15
- * not at all; script-created animations are untouched. `preserveAnimations`
16
- * reads every animation's state first and, afterwards, gives each recreated
17
- * CSS animation that state and resumes each cancelled transition with a
18
- * script animation at the same point.
19
- *
20
- * The state is read generically, from what the platform exposes: every
21
- * accessor with a setter on the animation's and its effect's prototype
22
- * chains, every field of the effect's timing, and its keyframes. Only values
23
- * that differ from the recreated animation's are written, so a value the
24
- * stylesheet controls stays under its control. A few members are not plain
25
- * state and are handled in their own step (`ORDERED`); the rest need no
26
- * handling (`DERIVED`). What cannot be carried over is the Animation and
27
- * effect objects themselves: the old ones are idle, their `addEventListener`
28
- * listeners and `finished`/`ready` promises stay with them, and the browser
29
- * fires `animationcancel`/`transitioncancel` for them and `animationstart`
14
+ * animations again from the stylesheet, at their start. It starts no
15
+ * transition but one from `@starting-style`, and script-created animations
16
+ * are untouched. `preserveAnimations` reads every animation's state first.
17
+ * Afterwards it gives each recreated CSS animation that state, and resumes
18
+ * each cancelled transition with a script animation at the same point. Any
19
+ * other animation the return started is finished, unless it never ends
20
+ * (motion/carryAnimations.ts). The browser fires
21
+ * `animationcancel`/`transitioncancel` for the old ones and `animationstart`
30
22
  * for the new ones.
31
23
  */
32
24
 
33
- /**
34
- * Animation members written in a fixed order rather than generically: the
35
- * timeline before the range that is measured on it, the rate before the
36
- * time, and the start time (or, for a paused animation, the current time)
37
- * last, once the play state is set. `effect` is not
38
- * replaced, because a CSS animation whose effect script replaces leaves the
39
- * stylesheet's control; its state is copied onto the new effect instead.
40
- */
41
- const ORDERED = new Set([
42
- 'effect',
43
- 'timeline',
44
- 'rangeStart',
45
- 'rangeEnd',
46
- 'playbackRate',
47
- 'startTime',
48
- 'currentTime',
49
- ]);
50
-
51
- type Writable = Record<string, unknown>;
52
-
53
- /** Every accessor with a setter on `object`'s prototype chain. */
54
- function writableAccessors(object: object): string[] {
55
- const names = new Set<string>();
56
- for (
57
- let proto: object | null = Object.getPrototypeOf(object);
58
- proto != null && proto !== Object.prototype;
59
- proto = Object.getPrototypeOf(proto)
60
- ) {
61
- for (const [name, descriptor] of Object.entries(
62
- Object.getOwnPropertyDescriptors(proto),
63
- )) {
64
- if (descriptor.set != null) {
65
- names.add(name);
66
- }
67
- }
68
- }
69
- return [...names];
70
- }
71
-
72
- /**
73
- * A textual form of a value that is compared by content rather than by
74
- * identity: a CSS numeric value (as in a timeline range offset) through its
75
- * serialization, a plain object (a range) through its members. Anything else
76
- * is compared by identity (`null`).
77
- */
78
- function contentOf(value: unknown): string | null {
79
- if (
80
- typeof CSSNumericValue !== 'undefined' &&
81
- value instanceof CSSNumericValue
82
- ) {
83
- return value.toString();
84
- }
85
- if (
86
- value != null &&
87
- typeof value === 'object' &&
88
- Object.getPrototypeOf(value) === Object.prototype
89
- ) {
90
- return Object.entries(value)
91
- .map(([key, inner]) => `${key}:${contentOf(inner) ?? String(inner)}`)
92
- .join(';');
93
- }
94
- return null;
95
- }
96
-
97
- function differs(a: unknown, b: unknown): boolean {
98
- if (a === b) {
99
- return false;
100
- }
101
- const textA = contentOf(a);
102
- return textA == null || textA !== contentOf(b);
103
- }
104
-
105
- interface Saved {
106
- animation: Animation;
107
- name: string;
108
- target: Element | null;
109
- pseudoElement: string | null;
110
- values: Writable;
111
- effectValues: Writable;
112
- timing: EffectTiming | null;
113
- keyframes: ComputedKeyframe[] | null;
114
- playState: AnimationPlayState;
115
- replaceState: AnimationReplaceState;
116
- }
117
-
118
- function save(animation: Animation): Saved {
119
- const effect = animation.effect as KeyframeEffect | null;
120
- const values: Writable = {};
121
- for (const name of writableAccessors(animation)) {
122
- values[name] = (animation as unknown as Writable)[name];
123
- }
124
- const effectValues: Writable = {};
125
- if (effect != null) {
126
- for (const name of writableAccessors(effect)) {
127
- effectValues[name] = (effect as unknown as Writable)[name];
128
- }
129
- }
130
- return {
131
- animation,
132
- name:
133
- (animation as Animation & {animationName?: string}).animationName ?? '',
134
- target: effect?.target ?? null,
135
- pseudoElement: effect?.pseudoElement ?? null,
136
- values,
137
- effectValues,
138
- timing: effect?.getTiming() ?? null,
139
- keyframes: effect?.getKeyframes() ?? null,
140
- playState: animation.playState,
141
- replaceState: animation.replaceState,
142
- };
143
- }
144
-
145
- function write(object: object, name: string, value: unknown): void {
146
- (object as Writable)[name] = value;
147
- }
148
-
149
- /** Give `next` the effect state `saved` had: every writable member. */
150
- function restoreEffect(next: KeyframeEffect, saved: Saved): void {
151
- for (const name of writableAccessors(next)) {
152
- if (
153
- name in saved.effectValues &&
154
- differs(saved.effectValues[name], (next as unknown as Writable)[name])
155
- ) {
156
- write(next, name, saved.effectValues[name]);
157
- }
158
- }
159
- if (saved.timing != null) {
160
- const timing = next.getTiming() as unknown as Writable;
161
- const changed: Writable = {};
162
- for (const [field, value] of Object.entries(saved.timing)) {
163
- if (differs(value, timing[field])) {
164
- changed[field] = value;
165
- }
166
- }
167
- if (Object.keys(changed).length > 0) {
168
- next.updateTiming(changed);
169
- }
170
- }
171
- if (
172
- saved.keyframes != null &&
173
- JSON.stringify(saved.keyframes) !== JSON.stringify(next.getKeyframes())
174
- ) {
175
- next.setKeyframes(saved.keyframes);
176
- }
177
- }
178
-
179
- /** Give `next` the state `saved` had, member by member. */
180
- function restore(next: Animation, saved: Saved): void {
181
- const effect = next.effect as KeyframeEffect | null;
182
- if (effect != null) {
183
- restoreEffect(effect, saved);
184
- }
185
- const current = next as unknown as Writable;
186
- for (const name of ['timeline', 'rangeStart', 'rangeEnd']) {
187
- if (name in saved.values && differs(saved.values[name], current[name])) {
188
- write(next, name, saved.values[name]);
189
- }
190
- }
191
- for (const name of writableAccessors(next)) {
192
- if (
193
- !ORDERED.has(name) &&
194
- name in saved.values &&
195
- differs(saved.values[name], current[name])
196
- ) {
197
- write(next, name, saved.values[name]);
198
- }
199
- }
200
- if (saved.replaceState === 'persisted' && next.replaceState !== 'persisted') {
201
- next.persist();
202
- }
203
- const rate = saved.values.playbackRate;
204
- if (typeof rate === 'number' && rate !== next.playbackRate) {
205
- next.playbackRate = rate;
206
- }
207
- if (saved.playState === 'paused' && next.playState !== 'paused') {
208
- next.pause();
209
- } else if (saved.playState !== 'paused' && next.playState === 'paused') {
210
- next.play();
211
- }
212
- // A running animation is anchored to its timeline by its start time, which
213
- // carries its current time on exactly. A paused one has none and keeps its
214
- // current time. A finished one holds its end: finishing it again holds the
215
- // same time, though its start time is then counted from now, since script
216
- // cannot set a start time and a held time together.
217
- const start = saved.values.startTime as CSSNumberish | null | undefined;
218
- const time = saved.values.currentTime as CSSNumberish | null | undefined;
219
- if (saved.playState === 'finished') {
220
- next.finish();
221
- } else if (start != null) {
222
- next.startTime = start;
223
- } else if (time != null) {
224
- next.currentTime = time;
225
- }
226
- }
227
-
228
- /** Resume a cancelled CSS transition with a script animation in its state. */
229
- function resumeTransition(saved: Saved): void {
230
- if (saved.target == null || saved.keyframes == null) {
231
- return;
232
- }
233
- const replacement = saved.target.animate(saved.keyframes, {
234
- pseudoElement: saved.pseudoElement ?? undefined,
235
- });
236
- restore(replacement, saved);
237
- }
238
-
239
- function isTransition(animation: Animation): boolean {
240
- return (
241
- typeof CSSTransition !== 'undefined' && animation instanceof CSSTransition
242
- );
243
- }
25
+ import {restoreAnimations, saveAnimation} from '../motion/carryAnimations';
244
26
 
245
27
  /**
246
28
  * Run `reset`, which takes `root` out of rendering and back, and put every
247
29
  * CSS animation and transition of `root` and its subtree back in the state it
248
- * was in before. Recreated animations are matched to the ones they replace by
249
- * element, pseudo-element and name, in order, and then by name alone (an
250
- * effect script moved to another element or pseudo-element); a recreated
251
- * animation with no predecessor (an entry animation that had already played
252
- * and been dropped) is finished.
30
+ * was in before.
253
31
  */
254
32
  export function preserveAnimations(root: Element, reset: () => void): void {
255
33
  if (typeof root.getAnimations !== 'function') {
@@ -257,48 +35,7 @@ export function preserveAnimations(root: Element, reset: () => void): void {
257
35
  return;
258
36
  }
259
37
  const before = root.getAnimations({subtree: true});
260
- const saved = before.map(save);
38
+ const saved = before.map(saveAnimation);
261
39
  reset();
262
- const after = root.getAnimations({subtree: true});
263
- const current = new Set(after);
264
- const survivors = new Set(before);
265
- const cancelled: Saved[] = [];
266
- for (const state of saved) {
267
- if (current.has(state.animation)) {
268
- continue;
269
- }
270
- if (isTransition(state.animation)) {
271
- resumeTransition(state);
272
- } else {
273
- cancelled.push(state);
274
- }
275
- }
276
- const recreated = after.filter(animation => !survivors.has(animation));
277
- const unmatched: Animation[] = [];
278
- for (const animation of recreated) {
279
- const effect = animation.effect as KeyframeEffect | null;
280
- const name =
281
- (animation as Animation & {animationName?: string}).animationName ?? '';
282
- const index = cancelled.findIndex(
283
- state =>
284
- state.name === name &&
285
- state.target === (effect?.target ?? null) &&
286
- state.pseudoElement === (effect?.pseudoElement ?? null),
287
- );
288
- if (index === -1) {
289
- unmatched.push(animation);
290
- } else {
291
- restore(animation, cancelled.splice(index, 1)[0]);
292
- }
293
- }
294
- for (const animation of unmatched) {
295
- const name =
296
- (animation as Animation & {animationName?: string}).animationName ?? '';
297
- const index = cancelled.findIndex(state => state.name === name);
298
- if (index === -1) {
299
- animation.finish();
300
- } else {
301
- restore(animation, cancelled.splice(index, 1)[0]);
302
- }
303
- }
40
+ restoreAnimations(root, saved, new Set(before));
304
41
  }
@@ -46,6 +46,7 @@ import {ModalAnnounceProvider} from '../hooks/ModalAnnounceProvider';
46
46
  import {overlayPaddingReset} from '../Layout/overlayPaddingReset.stylex';
47
47
  import {LayerDepthProvider} from '../Layer/LayerDepthContext';
48
48
  import {useLayerDismissal} from '../Layer/useLayerDismissal';
49
+ import {useFocusRegionContainment} from '../hooks/useFocusTrap';
49
50
 
50
51
  import {useMergedRefs} from '../hooks/useMergedRefs';
51
52
  import {isRtlElement} from '../hooks/isRtlElement';
@@ -341,6 +342,9 @@ export function Lightbox({
341
342
  const t = useComponentTranslator();
342
343
  const dialogRef = useRef<HTMLDialogElement>(null);
343
344
  const mergedDialogRef = useMergedRefs(ref, dialogRef);
345
+ // Native showModal() lets Tab leave for the browser's own UI, so the shared
346
+ // module wraps it.
347
+ useFocusRegionContainment(dialogRef, isOpen);
344
348
  const containerRef = useRef<HTMLDivElement>(null);
345
349
  const imageWrapperRef = useRef<HTMLDivElement>(null);
346
350
  const triggerElementRef = useRef<Element | null>(null);
@@ -158,7 +158,7 @@ const styles = stylex.create({
158
158
  default: 'pointer',
159
159
  ':is(:disabled,[aria-disabled="true"])': 'default',
160
160
  },
161
- color: colorVars['--color-accent'],
161
+ color: colorVars['--color-text-accent'],
162
162
  fontSize: typeScaleVars['--text-body-size'],
163
163
  lineHeight: typeScaleVars['--text-body-leading'],
164
164
  fontWeight: fontWeightVars['--font-weight-medium'],
@@ -98,7 +98,7 @@ export const docs = {
98
98
  name: 'onOpenChange',
99
99
  type: '(isOpen: boolean) => void',
100
100
  description:
101
- 'Called when the drawer visibility changes (backdrop click, Escape key, or close button). Inside AppShell, this is managed automatically via context.',
101
+ 'Called when the drawer visibility changes (backdrop click, Escape key, or close button). Inside AppShell, this is managed automatically via context. On a phone or tablet (a coarse primary pointer), the drawer takes no tap or drag while it slides in; keys and assistive technology still act. After a close, focus returns to the element that opened it once its dialog closes.',
102
102
  },
103
103
  {
104
104
  name: 'children',
@@ -203,7 +203,7 @@ export const docsZh = {
203
203
  name: 'onOpenChange',
204
204
  type: '(isOpen: boolean) => void',
205
205
  description:
206
- '当抽屉可见性变化时调用(点击背景遮罩、按 Escape 键或点击关闭按钮)。',
206
+ '当抽屉可见性变化时调用(点击背景遮罩、按 Escape 键或点击关闭按钮)。在手机或平板上(主指针为粗指针时),抽屉滑入期间不接受点按或拖动;键盘和辅助技术仍可操作。关闭后,焦点会在对话框关闭时回到打开它的元素。',
207
207
  required: true,
208
208
  },
209
209
  {
@@ -311,7 +311,7 @@ export const docsDense = {
311
311
  propDescriptions: {
312
312
  isOpen: 'whether drawer is open',
313
313
  onOpenChange:
314
- 'called when drawer visibility changes (backdrop click, Escape, close button)',
314
+ 'called when drawer visibility changes (backdrop click, Escape, close button); under a coarse primary pointer the drawer takes no tap or drag while it slides in (keys still act)',
315
315
  children:
316
316
  'drawer content; typically SideNavSection/SideNavItem or any ReactNode',
317
317
  header:
@@ -4,7 +4,8 @@
4
4
 
5
5
  /**
6
6
  * @file MobileNav.tsx
7
- * @input Uses React, useEffect, useRef, useCallback, ReactNode, StyleX
7
+ * @input Uses React, useEffect, useRef, useCallback, ReactNode, StyleX and
8
+ * the Layer module's entrance hold
8
9
  * @output Exports MobileNav component and MobileNavProps
9
10
  * @position Core implementation; consumed by index.ts
10
11
  *
@@ -38,6 +39,7 @@
38
39
  * - /packages/core/src/MobileNav/index.ts (exports if types change)
39
40
  * - /packages/core/src/Layer/useLayerDismissal.ts (dismissal stack)
40
41
  * - /packages/core/src/hooks/useScrollLock.ts (the page's scroll lock)
42
+ * - /packages/core/src/MobileNav/MobileNavTouchPresentation.test.tsx (touch)
41
43
  * - /packages/cli/assets/templates/blocks/components/MobileNav/ (showcase blocks)
42
44
  */
43
45
 
@@ -63,6 +65,7 @@ import {Button} from '../Button';
63
65
  import {Icon} from '../Icon';
64
66
  import {Heading} from '../Heading/Heading';
65
67
  import {useAppShellMobile} from '../AppShell/AppShellMobileContext';
68
+ import {holdEntranceInput} from '../Layer/holdEntranceInput';
66
69
  import {mergeProps, composeEventHandlers} from '../utils';
67
70
  import {layerTextReset} from '../Layer/layerTextReset.stylex';
68
71
  import {layerStructureReset} from '../Layer/layerStructureReset.stylex';
@@ -282,6 +285,14 @@ const dynamicStyles = stylex.create({
282
285
  * own scheduled `dialog.close()` has a chance to run (#5701).
283
286
  */
284
287
  export const MAX_CLOSE_DELAY_MS = 250;
288
+ /**
289
+ * Longest the drawer slides in or out for, in ms. Both run for the theme's
290
+ * `--duration-medium`: 410 ms by default, and at most 545 ms on the default
291
+ * scale (`--duration-medium-max`). The slide-out keeps playing after the
292
+ * dialog closes, while the dialog's `display` transition keeps it rendered.
293
+ * The touch hold on the slide-in ends by this time.
294
+ */
295
+ export const MAX_EXIT_MS = 550;
285
296
  /** Fraction of the hold to close at, so the close never lands on its boundary. */
286
297
  const CLOSE_WITHIN_HOLD = 0.6;
287
298
 
@@ -504,7 +515,11 @@ export function MobileNav({
504
515
  );
505
516
 
506
517
  const dialogRef = useRef<HTMLDialogElement>(null);
518
+ const drawerRef = useRef<HTMLDivElement>(null);
507
519
  const closeTimeoutRef = useRef<ReturnType<typeof setTimeout>>(null);
520
+ // The input hold on the drawer's layer while it slides in under a coarse
521
+ // primary pointer. It is null under a fine one and once the slide-in ends.
522
+ const releaseHoldRef = useRef<(() => void) | null>(null);
508
523
  // Element that was focused when the drawer opened; focus goes back to it
509
524
  // once the native dialog has closed (see closeAndRestoreFocus).
510
525
  const triggerElementRef = useRef<HTMLElement | null>(null);
@@ -569,6 +584,8 @@ export function MobileNav({
569
584
  }
570
585
 
571
586
  if (isOpen) {
587
+ releaseHoldRef.current?.();
588
+ releaseHoldRef.current = null;
572
589
  if (!dialog.open) {
573
590
  // Capture the opener before showModal() pulls focus into the top
574
591
  // layer. Only on the transition into open: a reopen while the delayed
@@ -578,7 +595,16 @@ export function MobileNav({
578
595
  document.activeElement as HTMLElement | null;
579
596
  dialog.showModal();
580
597
  }
598
+ // Under a coarse primary pointer, nothing takes a touch until the
599
+ // slide-in ends, at most MAX_EXIT_MS in. A close holds nothing, because
600
+ // only an entrance is held. Under a fine one, nothing is held.
601
+ releaseHoldRef.current = holdEntranceInput(dialog, {
602
+ entrance: drawerRef.current,
603
+ capMs: MAX_EXIT_MS,
604
+ });
581
605
  } else if (dialog.open) {
606
+ releaseHoldRef.current?.();
607
+ releaseHoldRef.current = null;
582
608
  closeTimeoutRef.current = setTimeout(() => {
583
609
  closeAndRestoreFocus(dialog, triggerElementRef);
584
610
  setIsCloseHeld(false);
@@ -594,6 +620,10 @@ export function MobileNav({
594
620
  clearTimeout(closeTimeoutRef.current);
595
621
  closeTimeoutRef.current = null;
596
622
  }
623
+ // The hold this run took ends with it: a reopen, a close or an
624
+ // unmount mid-slide never leaves input blocked.
625
+ releaseHoldRef.current?.();
626
+ releaseHoldRef.current = null;
597
627
  };
598
628
  }, [isOpen]);
599
629
 
@@ -613,6 +643,8 @@ export function MobileNav({
613
643
  useEffect(() => {
614
644
  const dialog = dialogRef.current;
615
645
  return () => {
646
+ releaseHoldRef.current?.();
647
+ releaseHoldRef.current = null;
616
648
  if (dialog?.open) {
617
649
  closeAndRestoreFocus(dialog, triggerElementRef);
618
650
  }
@@ -704,6 +736,7 @@ export function MobileNav({
704
736
  <LayerContentBoundary>
705
737
  {/* Drawer panel — tabIndex so showModal() focuses the drawer, not the close button */}
706
738
  <div
739
+ ref={drawerRef}
707
740
  tabIndex={-1}
708
741
  {...stylex.props(
709
742
  styles.drawer,
@@ -104,8 +104,7 @@ export const docs = {
104
104
  {
105
105
  name: 'presentation',
106
106
  type: "'popover' | 'bottom-sheet' | 'adaptive'",
107
- description: 'Presentation policy forwarded to DropdownMenu. `adaptive` keeps the anchored popover on pointer-based layouts and uses a BottomSheet on a compact touch screen: a coarse primary pointer, and a viewport narrower than the theme `md` breakpoint (768px by default) or shorter than 500px.',
108
- default: "'popover'",
107
+ description: 'Presentation policy forwarded to DropdownMenu. `adaptive` keeps the anchored popover on pointer-based layouts and uses a BottomSheet on a compact touch screen: a coarse primary pointer, and a viewport narrower than the theme `md` breakpoint (768px by default) or shorter than 500px. Omitted, the menu is the anchored popover, and under a finger, on every device, the finger that opened it picks a row only after moving 10 px. Pass \'popover\' to keep the pointer behavior on every device, the settle rule included.',
109
108
  },
110
109
  {
111
110
  name: 'onOpenChange',
@@ -204,8 +203,7 @@ export const docsZh = {
204
203
  {
205
204
  name: 'presentation',
206
205
  type: "'popover' | 'bottom-sheet' | 'adaptive'",
207
- description: '菜单呈现策略。`adaptive` 在指针布局中使用锚定浮层,在主指针为粗略指针且视口宽度小于主题的 `md` 断点(默认 768px)或高度小于 500px 时使用 BottomSheet。',
208
- default: "'popover'",
206
+ description: '菜单呈现策略。`adaptive` 在指针布局中使用锚定浮层,在主指针为粗略指针且视口宽度小于主题的 `md` 断点(默认 768px)或高度小于 500px 时使用 BottomSheet。省略时,菜单为锚定浮层;在任何设备上用手指操作时,打开菜单的手指移动 10 px 后才会选择菜单项。传入 \'popover\' 可在所有设备上保持指针行为,包括稳定规则。',
209
207
  },
210
208
  {
211
209
  name: 'xstyle',
@@ -97,9 +97,11 @@ export interface MoreMenuProps extends Pick<
97
97
  alignment?: LayerAlignment;
98
98
 
99
99
  /**
100
- * Menu presentation policy. `adaptive` uses a BottomSheet on compact
101
- * coarse-pointer viewports and an anchored popover elsewhere.
102
- * @default 'popover'
100
+ * Menu presentation policy, forwarded to DropdownMenu. `adaptive` uses a
101
+ * BottomSheet on compact coarse-pointer viewports and an anchored popover
102
+ * elsewhere. Omitted, the menu is the anchored popover, and the finger that
103
+ * opened it follows UIMenu's handoff on every device. `'popover'` pins the
104
+ * pointer behavior on every device.
103
105
  */
104
106
  presentation?: DropdownMenuPresentation;
105
107
 
@@ -35,6 +35,7 @@ import {usePressFeedback} from '../hooks/usePressFeedback';
35
35
  import {useIndicator} from '../Indicator/useIndicator';
36
36
  import {Item, type ItemAlign} from '../Item/Item';
37
37
  import {themeProps} from '../utils/themeProps';
38
+ import {rowPressLayerStyles} from '../privateAttributes/press.stylex';
38
39
 
39
40
  // The touch press's paint, declared by the shared overlay styles on the
40
41
  // element the controller writes to (`pressedAlpha`) at the press's strength,
@@ -147,11 +148,6 @@ const rowStyles = stylex.create({
147
148
  // Suppress Item's interactive hover/press background so the resting and
148
149
  // hovered row look identical by default (a theme can restyle either).
149
150
  backgroundColor: 'transparent',
150
- // ...and the touch press's overlay image, for the same reason: under a
151
- // finger only the radio circle paints, as under a mouse. The press's
152
- // strength still lands on the row, which is where the layer over the
153
- // circle reads it.
154
- backgroundImage: 'none',
155
151
  },
156
152
  // The mouse press (a finger's lives on `data-astryx-press`): the row is
157
153
  // pressed, but not through a nested link or button, which keep their own
@@ -414,6 +410,9 @@ export function RadioListItem({
414
410
  // the painting row element (Item), the same element that carries the
415
411
  // theme target, so a theme's hover styling stays in step with the tint.
416
412
  !isDisabled && indicatorScope,
413
+ // The row keeps no press paint of its own: the circle paints, and
414
+ // reads the strength whose release the row keeps.
415
+ rowPressLayerStyles.cellWithoutLayer,
417
416
  // Restore the bare default look: zero Item's padding/radius and its
418
417
  // interactive hover/press background. Applied after Item's own base
419
418
  // styles so it wins within the base layer; a `radio-list-item` theme
@@ -44,6 +44,7 @@ import type {StyleXStyles} from '@stylexjs/stylex';
44
44
  import {colorVars, durationVars, easeVars} from '../theme/tokens.stylex';
45
45
  import type {Elevation, SizeValue, SpacingStep} from '../utils/types';
46
46
  import {isImeKeyEvent, mergeProps} from '../utils';
47
+ import {chainEventHandlers} from '../utils/chainEventHandlers';
47
48
  import {Card} from '../Card/Card';
48
49
  import type {CardVariant} from '../Card/Card';
49
50
  import {useClickableContainer} from '../hooks/useClickableContainer';
@@ -398,6 +399,7 @@ export function SelectableCard({
398
399
  onChange,
399
400
  onClick: onClickProp,
400
401
  onMouseUp: onMouseUpProp,
402
+ onPointerDown: onPointerDownProp,
401
403
  isDisabled = false,
402
404
  children,
403
405
  padding,
@@ -458,7 +460,7 @@ export function SelectableCard({
458
460
  [isDisabled, requestChange],
459
461
  );
460
462
 
461
- const {onClick, onMouseUp} = useClickableContainer({
463
+ const {onClick, onMouseUp, onPointerDown} = useClickableContainer({
462
464
  containerRef,
463
465
  interactiveRef,
464
466
  onClick: handleClick,
@@ -530,6 +532,11 @@ export function SelectableCard({
530
532
  }
531
533
  onClick={!isDisabled ? composedOnClick : undefined}
532
534
  onMouseUp={!isDisabled ? composedOnMouseUp : undefined}
535
+ onPointerDown={
536
+ !isDisabled
537
+ ? chainEventHandlers(onPointerDown, onPointerDownProp)
538
+ : onPointerDownProp
539
+ }
533
540
  {...props}
534
541
  onClickCapture={
535
542
  !isDisabled && handleLayerClickCapture
@@ -211,6 +211,16 @@ function syncRotationPhase(
211
211
  // Animation
212
212
  // =============================================================================
213
213
 
214
+ /**
215
+ * Full turns in one iteration of the rotation.
216
+ *
217
+ * Chromium wakes the main thread at each iteration boundary while the
218
+ * document listens for `animationiteration`. React listens for it on every
219
+ * root. One iteration holds 100 turns, so the wake comes once in 100 turns.
220
+ * Each turn is 360 degrees, so the ring looks the same.
221
+ */
222
+ const TURNS_PER_ITERATION = 100;
223
+
214
224
  /**
215
225
  * A `transform` animation runs on the compositor, so the ring keeps turning
216
226
  * while a script runs. A `stroke-dashoffset` animation would repaint the arc
@@ -218,7 +228,7 @@ function syncRotationPhase(
218
228
  */
219
229
  const rotation = stylex.keyframes({
220
230
  '0%': {transform: 'rotate(0deg)'},
221
- '100%': {transform: 'rotate(360deg)'},
231
+ '100%': {transform: `rotate(${360 * TURNS_PER_ITERATION}deg)`},
222
232
  });
223
233
 
224
234
  // =============================================================================
@@ -307,8 +317,8 @@ const styles = stylex.create({
307
317
  // broken. The status role and its name still say that work is busy.
308
318
  animationDuration: {
309
319
  // The loop reads the duration before a theme's tempo scales it.
310
- default: `var(--_astryx-pre-tempo-duration-slow-min, ${durationVars['--duration-slow-min']})`,
311
- '@media (prefers-reduced-motion: reduce)': '3s',
320
+ default: `calc(var(--_astryx-pre-tempo-duration-slow-min, ${durationVars['--duration-slow-min']}) * ${TURNS_PER_ITERATION})`,
321
+ '@media (prefers-reduced-motion: reduce)': `calc(3s * ${TURNS_PER_ITERATION})`,
312
322
  },
313
323
  animationIterationCount: 'infinite',
314
324
  animationName: rotation,
@@ -168,7 +168,7 @@ const sortStyles = stylex.create({
168
168
  fontSize: 10,
169
169
  // eslint-disable-next-line @astryx/no-hardcoded-styles -- no token for lineHeight:1 (tight badge)
170
170
  lineHeight: '1',
171
- color: colorVars['--color-accent'],
171
+ color: colorVars['--color-text-accent'],
172
172
  },
173
173
  });
174
174
 
@@ -39,6 +39,7 @@ import {themeProps} from '../utils/themeProps';
39
39
  import {focusOutlineProps} from '../utils/focusOutline.stylex';
40
40
  import {interactionOverlayStyles} from '../utils/interactionOverlay.stylex';
41
41
  import {usePressFeedback} from '../hooks/usePressFeedback';
42
+ import {cancelNestedTouchPress} from '../hooks/useClickableContainer';
42
43
  import type {TokenColorMap} from './index';
43
44
  import {disabledInteractionProps} from '../utils/disabledInteraction';
44
45
  import {TokenNamingContext} from './TokenNamingContext';
@@ -510,6 +511,19 @@ export function Token({
510
511
  }
511
512
  effectiveOnClick(e);
512
513
  };
514
+ // A finger press on Remove or a control in end content does not run the
515
+ // token's action, so the token shows no press for it. The inner button,
516
+ // the first button child, is the token's own action.
517
+ const handleContainerPointerDown = (
518
+ e: React.PointerEvent<HTMLSpanElement>,
519
+ ) => {
520
+ rest.onPointerDown?.(e);
521
+ cancelNestedTouchPress(
522
+ e,
523
+ e.currentTarget,
524
+ e.currentTarget.querySelector(':scope > button'),
525
+ );
526
+ };
513
527
 
514
528
  return (
515
529
  <span
@@ -535,7 +549,10 @@ export function Token({
535
549
  style,
536
550
  )}
537
551
  {...rest}
538
- {...sharedProps}>
552
+ {...sharedProps}
553
+ onPointerDown={
554
+ isDisabled ? rest.onPointerDown : handleContainerPointerDown
555
+ }>
539
556
  {icon}
540
557
  <button
541
558
  type="button"