@telus-uds/components-base 3.29.0 → 3.30.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 (105) hide show
  1. package/CHANGELOG.md +26 -1
  2. package/jest.config.cjs +1 -0
  3. package/lib/cjs/ActionCard/ActionCard.js +4 -4
  4. package/lib/cjs/ActivityIndicator/Dots.native.js +1 -2
  5. package/lib/cjs/ActivityIndicator/Spinner.native.js +1 -2
  6. package/lib/cjs/Box/Box.js +1 -2
  7. package/lib/cjs/Button/Button.js +1 -2
  8. package/lib/cjs/Button/ButtonBase.js +8 -8
  9. package/lib/cjs/Button/ButtonDropdown.js +1 -2
  10. package/lib/cjs/Button/ButtonGroup.js +1 -2
  11. package/lib/cjs/Button/ButtonLink.js +1 -2
  12. package/lib/cjs/Card/Card.js +1 -2
  13. package/lib/cjs/Card/PressableCardBase.js +1 -2
  14. package/lib/cjs/Card/index.js +1 -2
  15. package/lib/cjs/CardGroup/CardGroup.js +1 -2
  16. package/lib/cjs/Carousel/Carousel.js +12 -7
  17. package/lib/cjs/Carousel/CarouselThumbnail.js +123 -31
  18. package/lib/cjs/Carousel/CarouselThumbnailNavigation.js +8 -1
  19. package/lib/cjs/CheckboxCard/CheckboxCard.js +1 -2
  20. package/lib/cjs/CheckboxCardGroup/CheckboxCardGroup.js +1 -2
  21. package/lib/cjs/Footnote/FootnoteLink.js +18 -17
  22. package/lib/cjs/HorizontalScroll/index.js +1 -2
  23. package/lib/cjs/Icon/IconText.js +1 -2
  24. package/lib/cjs/Icon/index.js +1 -2
  25. package/lib/cjs/InputSupports/InputSupports.js +1 -2
  26. package/lib/cjs/InputSupports/useInputSupports.js +1 -3
  27. package/lib/cjs/Link/MobileIconTextContent.js +1 -2
  28. package/lib/cjs/Listbox/Listbox.js +1 -2
  29. package/lib/cjs/Modal/Modal.js +1 -1
  30. package/lib/cjs/Pagination/PageButton.js +1 -2
  31. package/lib/cjs/Pagination/Pagination.js +1 -2
  32. package/lib/cjs/Progress/Progress.js +30 -5
  33. package/lib/cjs/QuickLinks/QuickLinks.js +7 -0
  34. package/lib/cjs/Radio/Radio.js +1 -2
  35. package/lib/cjs/RadioCard/RadioCard.js +1 -2
  36. package/lib/cjs/RadioCard/RadioCardGroup.js +1 -2
  37. package/lib/cjs/Scroll/Scroll.js +466 -0
  38. package/lib/cjs/Scroll/ScrollContext.js +55 -0
  39. package/lib/cjs/Scroll/ScrollItem.js +103 -0
  40. package/lib/cjs/Scroll/ScrollProgress.js +99 -0
  41. package/lib/cjs/Scroll/dictionary.js +18 -0
  42. package/lib/cjs/Scroll/index.js +29 -0
  43. package/lib/cjs/Shortcuts/Shortcuts.js +1 -2
  44. package/lib/cjs/SideNav/SideNav.js +1 -2
  45. package/lib/cjs/StackView/StackWrapBox.js +9 -1
  46. package/lib/cjs/StackView/StackWrapGap.js +3 -1
  47. package/lib/cjs/StackView/getStackedContent.js +21 -12
  48. package/lib/cjs/Tabs/Tabs.js +1 -2
  49. package/lib/cjs/Tooltip/Tooltip.native.js +2 -2
  50. package/lib/cjs/index.js +16 -2
  51. package/lib/cjs/utils/animation/index.js +7 -0
  52. package/lib/cjs/utils/animation/useAnimatedValue.js +46 -0
  53. package/lib/cjs/utils/children.js +2 -1
  54. package/lib/cjs/utils/index.js +1 -2
  55. package/lib/esm/ActionCard/ActionCard.js +4 -4
  56. package/lib/esm/Button/ButtonBase.js +8 -8
  57. package/lib/esm/Carousel/Carousel.js +12 -7
  58. package/lib/esm/Carousel/CarouselThumbnail.js +124 -32
  59. package/lib/esm/Carousel/CarouselThumbnailNavigation.js +8 -1
  60. package/lib/esm/Footnote/FootnoteLink.js +18 -17
  61. package/lib/esm/InputSupports/InputSupports.js +1 -2
  62. package/lib/esm/InputSupports/useInputSupports.js +1 -3
  63. package/lib/esm/Modal/Modal.js +1 -1
  64. package/lib/esm/Progress/Progress.js +30 -5
  65. package/lib/esm/QuickLinks/QuickLinks.js +7 -0
  66. package/lib/esm/Scroll/Scroll.js +459 -0
  67. package/lib/esm/Scroll/ScrollContext.js +47 -0
  68. package/lib/esm/Scroll/ScrollItem.js +96 -0
  69. package/lib/esm/Scroll/ScrollProgress.js +92 -0
  70. package/lib/esm/Scroll/dictionary.js +12 -0
  71. package/lib/esm/Scroll/index.js +4 -0
  72. package/lib/esm/StackView/StackWrapBox.js +9 -1
  73. package/lib/esm/StackView/StackWrapGap.js +3 -1
  74. package/lib/esm/StackView/getStackedContent.js +20 -10
  75. package/lib/esm/Tooltip/Tooltip.native.js +2 -2
  76. package/lib/esm/index.js +1 -0
  77. package/lib/esm/utils/animation/index.js +1 -1
  78. package/lib/esm/utils/animation/useAnimatedValue.js +39 -0
  79. package/lib/esm/utils/children.js +2 -1
  80. package/lib/package.json +2 -2
  81. package/package.json +2 -2
  82. package/src/Carousel/Carousel.jsx +6 -1
  83. package/src/Carousel/CarouselThumbnail.jsx +153 -64
  84. package/src/Carousel/CarouselThumbnailNavigation.jsx +8 -2
  85. package/src/Footnote/FootnoteLink.jsx +17 -12
  86. package/src/InputSupports/InputSupports.jsx +1 -6
  87. package/src/InputSupports/useInputSupports.js +1 -1
  88. package/src/Modal/Modal.jsx +1 -1
  89. package/src/Progress/Progress.jsx +22 -3
  90. package/src/QuickLinks/QuickLinks.jsx +8 -0
  91. package/src/Scroll/Scroll.jsx +488 -0
  92. package/src/Scroll/ScrollContext.jsx +41 -0
  93. package/src/Scroll/ScrollItem.jsx +89 -0
  94. package/src/Scroll/ScrollProgress.jsx +75 -0
  95. package/src/Scroll/dictionary.js +12 -0
  96. package/src/Scroll/index.js +5 -0
  97. package/src/StackView/StackWrapBox.jsx +13 -1
  98. package/src/StackView/StackWrapGap.jsx +2 -1
  99. package/src/StackView/getStackedContent.jsx +22 -8
  100. package/src/index.js +1 -0
  101. package/src/utils/animation/index.js +1 -1
  102. package/src/utils/animation/useAnimatedValue.js +37 -0
  103. package/src/utils/children.jsx +4 -1
  104. package/types/Scroll.d.ts +66 -0
  105. package/types/index.d.ts +9 -0
@@ -0,0 +1,466 @@
1
+ "use strict";
2
+
3
+ Object.defineProperty(exports, "__esModule", {
4
+ value: true
5
+ });
6
+ exports.default = void 0;
7
+ var _react = _interopRequireDefault(require("react"));
8
+ var _propTypes = _interopRequireDefault(require("prop-types"));
9
+ var _Platform = _interopRequireDefault(require("react-native-web/dist/cjs/exports/Platform"));
10
+ var _Pressable = _interopRequireDefault(require("react-native-web/dist/cjs/exports/Pressable"));
11
+ var _StyleSheet = _interopRequireDefault(require("react-native-web/dist/cjs/exports/StyleSheet"));
12
+ var _View = _interopRequireDefault(require("react-native-web/dist/cjs/exports/View"));
13
+ var _ThemeProvider = require("../ThemeProvider");
14
+ var _utils = require("../utils");
15
+ var _A11yText = _interopRequireDefault(require("../A11yText"));
16
+ var _ScrollViewEnd = _interopRequireDefault(require("../HorizontalScroll/ScrollViewEnd"));
17
+ var _dictionary = _interopRequireDefault(require("./dictionary"));
18
+ var _ScrollProgress = _interopRequireDefault(require("./ScrollProgress"));
19
+ var _ScrollContext = require("./ScrollContext");
20
+ var _jsxRuntime = require("react/jsx-runtime");
21
+ function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
22
+ const [selectProps, selectedSystemPropTypes] = (0, _utils.selectSystemProps)([_utils.a11yProps, _utils.viewProps]);
23
+ const SCROLL_DESCRIPTION_PREFIX = 'scroll-description';
24
+ const KEY_ARROW_RIGHT = 'ArrowRight';
25
+ const KEY_ARROW_LEFT = 'ArrowLeft';
26
+ const KEY_SPACE = ' ';
27
+ const MAX_PERCENTAGE = 100;
28
+ const MIN_BAR_PERCENTAGE = 1;
29
+ const ROLE_REGION = 'region';
30
+ const ROLE_NONE = 'none';
31
+ const COMPONENT_NAME = 'Scroll';
32
+ const SCROLL_ITEM_SELECTOR = '[data-scroll-item]';
33
+ const TAB_INDEX = 0;
34
+ const INITIAL_DIMENSION = 0;
35
+ const HALF_DIVISOR = 2;
36
+ const selectPressableStyles = _ref => {
37
+ let {
38
+ progressHitAreaHeight,
39
+ progressSpacing
40
+ } = _ref;
41
+ return {
42
+ height: progressHitAreaHeight,
43
+ marginTop: progressSpacing
44
+ };
45
+ };
46
+ const selectThumbWrapperStyles = _ref2 => {
47
+ let {
48
+ thumbWidthPercent,
49
+ thumbPositionPercent
50
+ } = _ref2;
51
+ return {
52
+ width: `${thumbWidthPercent}%`,
53
+ marginLeft: `${thumbPositionPercent}%`
54
+ };
55
+ };
56
+ const selectContainerA11yProps = _ref3 => {
57
+ let {
58
+ accessibilityLabel,
59
+ descriptionId,
60
+ handleKeyDown
61
+ } = _ref3;
62
+ return _Platform.default.OS === 'web' ? {
63
+ role: ROLE_REGION,
64
+ 'aria-label': accessibilityLabel,
65
+ 'aria-describedby': descriptionId,
66
+ tabIndex: TAB_INDEX,
67
+ onKeyDown: handleKeyDown
68
+ } : {
69
+ accessibilityRole: ROLE_NONE,
70
+ accessibilityLabel
71
+ };
72
+ };
73
+ const selectScrollContentStyle = itemGap => ({
74
+ columnGap: itemGap
75
+ });
76
+ const calculateThumbWidth = _ref4 => {
77
+ let {
78
+ containerWidth,
79
+ contentWidth
80
+ } = _ref4;
81
+ if (contentWidth <= INITIAL_DIMENSION) return MAX_PERCENTAGE;
82
+ return Math.max(MIN_BAR_PERCENTAGE, Math.min(MAX_PERCENTAGE, containerWidth / contentWidth * MAX_PERCENTAGE));
83
+ };
84
+ const calculateThumbPosition = _ref5 => {
85
+ let {
86
+ scrollOffset,
87
+ scrollMax,
88
+ thumbWidthPercent
89
+ } = _ref5;
90
+ if (scrollMax <= INITIAL_DIMENSION) return INITIAL_DIMENSION;
91
+ return scrollOffset / scrollMax * (MAX_PERCENTAGE - thumbWidthPercent);
92
+ };
93
+ const getScrollableNode = ref => ref.current?.getScrollableNode?.() ?? null;
94
+
95
+ /**
96
+ * The `Scroll` component provides a continuous horizontal scrollable container with a progress
97
+ * bar indicator. Items are displayed in a flow layout where all items share the width of the
98
+ * widest item and the height of the tallest item.
99
+ *
100
+ * ## Props
101
+ *
102
+ * - Use `children` to pass `ScrollItem` components
103
+ * - Use `accessibilityLabel` to provide a meaningful label for the scrollable region
104
+ * - Use `copy` to select English or French for accessible labels
105
+ * - Use `dictionary` to override the default translations
106
+ *
107
+ * ## Usability and A11y guidelines
108
+ *
109
+ * - The scroll container is keyboard-focusable with `tabIndex="0"`
110
+ * - Each `ScrollItem` is individually focusable via Tab navigation
111
+ * - Use left and right arrow keys to scroll by one item width
112
+ * - Press Space bar to scroll right
113
+ * - When tabbing through items, the scroll follows focus to keep the active item visible
114
+ * - Screen readers announce the component as a region with a descriptive label
115
+ * - Touch and swipe gestures are supported on mobile and mobile web
116
+ *
117
+ */
118
+ const Scroll = /*#__PURE__*/_react.default.forwardRef((_ref6, ref) => {
119
+ let {
120
+ children,
121
+ tokens,
122
+ variant,
123
+ copy,
124
+ dictionary: customDictionary = _dictionary.default,
125
+ accessibilityLabel,
126
+ ...rest
127
+ } = _ref6;
128
+ const getCopy = (0, _utils.useCopy)({
129
+ dictionary: customDictionary,
130
+ copy
131
+ });
132
+ const resolvedAccessibilityLabel = accessibilityLabel || getCopy('accessibilityLabel');
133
+ const getTokens = (0, _ThemeProvider.useThemeTokensCallback)(COMPONENT_NAME, tokens, variant);
134
+ const defaultTokens = _react.default.useMemo(() => getTokens(), [getTokens]);
135
+ const descriptionId = (0, _utils.useUniqueId)(SCROLL_DESCRIPTION_PREFIX);
136
+ const scrollRef = _react.default.useRef(null);
137
+ const pressableRef = _react.default.useRef(null);
138
+ const scrollContainerRef = _react.default.useRef(null);
139
+ const scrollMaxRef = _react.default.useRef(INITIAL_DIMENSION);
140
+ const scrollOffsetRef = _react.default.useRef(INITIAL_DIMENSION);
141
+ const thumbWidthPercentRef = _react.default.useRef(MAX_PERCENTAGE);
142
+ const thumbRef = _react.default.useRef(null);
143
+ const isDraggingRef = _react.default.useRef(false);
144
+ const dragStartRef = _react.default.useRef({
145
+ mouseX: INITIAL_DIMENSION,
146
+ scrollOffset: INITIAL_DIMENSION
147
+ });
148
+ const [scrollOffset, setScrollOffset] = _react.default.useState(INITIAL_DIMENSION);
149
+ const [containerWidth, setContainerWidth] = _react.default.useState(INITIAL_DIMENSION);
150
+ const [contentWidth, setContentWidth] = _react.default.useState(INITIAL_DIMENSION);
151
+ const [itemWidth, setItemWidth] = _react.default.useState(INITIAL_DIMENSION);
152
+ const [itemHeight, setItemHeight] = _react.default.useState(INITIAL_DIMENSION);
153
+ const {
154
+ itemGap
155
+ } = defaultTokens;
156
+ const scrollMax = Math.max(INITIAL_DIMENSION, contentWidth - containerWidth);
157
+ _react.default.useEffect(() => {
158
+ scrollMaxRef.current = scrollMax;
159
+ }, [scrollMax]);
160
+ const thumbWidthPercent = calculateThumbWidth({
161
+ containerWidth,
162
+ contentWidth
163
+ });
164
+ thumbWidthPercentRef.current = thumbWidthPercent;
165
+ const thumbPositionPercent = calculateThumbPosition({
166
+ scrollOffset,
167
+ scrollMax,
168
+ thumbWidthPercent
169
+ });
170
+ const thumbWrapperStyle = _react.default.useMemo(() => [staticStyles.thumbWrapper, selectThumbWrapperStyles({
171
+ thumbWidthPercent,
172
+ thumbPositionPercent
173
+ }), _Platform.default.OS === 'web' ? staticStyles.thumbCursor : null], [thumbWidthPercent, thumbPositionPercent]);
174
+ const handleScroll = _react.default.useCallback(_ref7 => {
175
+ let {
176
+ nativeEvent: {
177
+ contentOffset: {
178
+ x
179
+ }
180
+ }
181
+ } = _ref7;
182
+ scrollOffsetRef.current = x;
183
+ setScrollOffset(x);
184
+ }, []);
185
+ const handleContainerLayout = _react.default.useCallback(_ref8 => {
186
+ let {
187
+ nativeEvent: {
188
+ layout: {
189
+ width
190
+ }
191
+ }
192
+ } = _ref8;
193
+ setContainerWidth(width);
194
+ }, []);
195
+ const handleContentWidth = _react.default.useCallback(width => {
196
+ setContentWidth(width);
197
+ }, []);
198
+ const handleItemLayout = _react.default.useCallback((width, height) => {
199
+ setItemWidth(prev => Math.max(prev, width));
200
+ setItemHeight(prev => Math.max(prev, height));
201
+ }, []);
202
+ _react.default.useEffect(() => {
203
+ if (_Platform.default.OS !== 'web') return undefined;
204
+ const element = scrollContainerRef.current;
205
+ if (!element) return undefined;
206
+ const handleWheel = event => {
207
+ event.preventDefault();
208
+ event.stopPropagation();
209
+ const isHorizontal = Math.abs(event.deltaX) > Math.abs(event.deltaY);
210
+ const delta = isHorizontal ? event.deltaX : event.deltaY;
211
+ const scrollableNode = getScrollableNode(scrollRef);
212
+ if (scrollableNode) {
213
+ const maxScroll = scrollMaxRef.current;
214
+ const newScrollLeft = Math.max(INITIAL_DIMENSION, Math.min(maxScroll, scrollableNode.scrollLeft + delta));
215
+ scrollableNode.scrollLeft = newScrollLeft;
216
+ scrollOffsetRef.current = newScrollLeft;
217
+ setScrollOffset(newScrollLeft);
218
+ }
219
+ };
220
+ element.addEventListener('wheel', handleWheel, {
221
+ passive: false
222
+ });
223
+ return () => element.removeEventListener('wheel', handleWheel);
224
+ }, []);
225
+ _react.default.useEffect(() => {
226
+ if (_Platform.default.OS !== 'web') return undefined;
227
+ const element = scrollContainerRef.current;
228
+ if (!element) return undefined;
229
+ const handleFocusIn = event => {
230
+ const scrollableNode = getScrollableNode(scrollRef);
231
+ if (!scrollableNode) return;
232
+ const focusedItem = event.target.closest(SCROLL_ITEM_SELECTOR);
233
+ if (!focusedItem) return;
234
+ const itemLeft = focusedItem.offsetLeft;
235
+ const itemRight = itemLeft + focusedItem.offsetWidth;
236
+ const visibleLeft = scrollableNode.scrollLeft;
237
+ const currentContainerWidth = containerWidth;
238
+ const visibleRight = visibleLeft + currentContainerWidth;
239
+ if (itemRight > visibleRight) {
240
+ scrollRef.current.scrollTo({
241
+ x: itemRight - currentContainerWidth,
242
+ animated: true
243
+ });
244
+ } else if (itemLeft < visibleLeft) {
245
+ scrollRef.current.scrollTo({
246
+ x: itemLeft,
247
+ animated: true
248
+ });
249
+ }
250
+ };
251
+ element.addEventListener('focusin', handleFocusIn);
252
+ return () => element.removeEventListener('focusin', handleFocusIn);
253
+ }, [containerWidth]);
254
+ const hasScrollbar = scrollMax > INITIAL_DIMENSION;
255
+ _react.default.useEffect(() => {
256
+ if (_Platform.default.OS !== 'web' || !hasScrollbar) return undefined;
257
+ const thumbElement = thumbRef.current;
258
+ if (!thumbElement) return undefined;
259
+ const handleMouseDown = event => {
260
+ event.preventDefault();
261
+ event.stopPropagation();
262
+ isDraggingRef.current = true;
263
+ dragStartRef.current = {
264
+ mouseX: event.clientX,
265
+ scrollOffset: getScrollableNode(scrollRef)?.scrollLeft ?? INITIAL_DIMENSION
266
+ };
267
+ thumbElement.style.cursor = 'grabbing';
268
+ document.body.style.cursor = 'grabbing';
269
+ document.body.style.userSelect = 'none';
270
+ };
271
+ const handleMouseMove = event => {
272
+ if (!isDraggingRef.current) return;
273
+ const trackElement = pressableRef.current;
274
+ if (!trackElement) return;
275
+ const trackWidth = trackElement.offsetWidth;
276
+ const thumbPixelWidth = thumbWidthPercentRef.current / MAX_PERCENTAGE * trackWidth;
277
+ const availableTrackPixels = trackWidth - thumbPixelWidth;
278
+ if (availableTrackPixels <= INITIAL_DIMENSION) return;
279
+ const mouseDelta = event.clientX - dragStartRef.current.mouseX;
280
+ const scrollDelta = mouseDelta / availableTrackPixels * scrollMaxRef.current;
281
+ const targetScroll = Math.max(INITIAL_DIMENSION, Math.min(scrollMaxRef.current, dragStartRef.current.scrollOffset + scrollDelta));
282
+ const scrollableNode = getScrollableNode(scrollRef);
283
+ if (scrollableNode) {
284
+ scrollableNode.scrollLeft = targetScroll;
285
+ scrollOffsetRef.current = targetScroll;
286
+ setScrollOffset(targetScroll);
287
+ }
288
+ };
289
+ const handleMouseUp = () => {
290
+ if (!isDraggingRef.current) return;
291
+ isDraggingRef.current = false;
292
+ thumbElement.style.cursor = '';
293
+ document.body.style.cursor = '';
294
+ document.body.style.userSelect = '';
295
+ };
296
+ thumbElement.addEventListener('mousedown', handleMouseDown);
297
+ document.addEventListener('mousemove', handleMouseMove);
298
+ document.addEventListener('mouseup', handleMouseUp);
299
+ return () => {
300
+ thumbElement.removeEventListener('mousedown', handleMouseDown);
301
+ document.removeEventListener('mousemove', handleMouseMove);
302
+ document.removeEventListener('mouseup', handleMouseUp);
303
+ };
304
+ }, [hasScrollbar]);
305
+ const handleKeyDown = _react.default.useCallback(event => {
306
+ if (event.key === KEY_ARROW_RIGHT || event.key === KEY_SPACE) {
307
+ event.preventDefault();
308
+ if (scrollRef.current) {
309
+ scrollRef.current.scrollTo({
310
+ x: scrollOffsetRef.current + itemWidth,
311
+ animated: true
312
+ });
313
+ }
314
+ } else if (event.key === KEY_ARROW_LEFT) {
315
+ event.preventDefault();
316
+ if (scrollRef.current) {
317
+ scrollRef.current.scrollTo({
318
+ x: Math.max(INITIAL_DIMENSION, scrollOffsetRef.current - itemWidth),
319
+ animated: true
320
+ });
321
+ }
322
+ }
323
+ }, [itemWidth]);
324
+ const handleProgressPress = _react.default.useCallback(event => {
325
+ if (scrollMax <= INITIAL_DIMENSION || isDraggingRef.current) return;
326
+ if (_Platform.default.OS === 'web' && pressableRef.current) {
327
+ const {
328
+ offsetX
329
+ } = event.nativeEvent;
330
+ const {
331
+ offsetWidth
332
+ } = pressableRef.current;
333
+ const thumbPixelWidth = thumbWidthPercent / MAX_PERCENTAGE * offsetWidth;
334
+ const availableTrack = offsetWidth - thumbPixelWidth;
335
+ if (availableTrack <= INITIAL_DIMENSION) return;
336
+ const clickPosition = Math.max(INITIAL_DIMENSION, Math.min(availableTrack, offsetX - thumbPixelWidth / HALF_DIVISOR));
337
+ const targetX = clickPosition / availableTrack * scrollMax;
338
+ if (scrollRef.current) {
339
+ scrollRef.current.scrollTo({
340
+ x: targetX,
341
+ animated: true
342
+ });
343
+ }
344
+ } else if (pressableRef.current) {
345
+ const {
346
+ locationX
347
+ } = event.nativeEvent;
348
+ pressableRef.current.measure((_x, _y, width) => {
349
+ const thumbPixelWidth = thumbWidthPercent / MAX_PERCENTAGE * width;
350
+ const availableTrack = width - thumbPixelWidth;
351
+ if (availableTrack <= INITIAL_DIMENSION) return;
352
+ const clickPosition = Math.max(INITIAL_DIMENSION, Math.min(availableTrack, locationX - thumbPixelWidth / HALF_DIVISOR));
353
+ const targetX = clickPosition / availableTrack * scrollMax;
354
+ if (scrollRef.current) {
355
+ scrollRef.current.scrollTo({
356
+ x: targetX,
357
+ animated: true
358
+ });
359
+ }
360
+ });
361
+ }
362
+ }, [scrollMax, thumbWidthPercent]);
363
+ const handleContainerRef = _react.default.useCallback(node => {
364
+ scrollContainerRef.current = node;
365
+ if (typeof ref === 'function') ref(node);else if (ref) Object.assign(ref, {
366
+ current: node
367
+ });
368
+ }, [ref]);
369
+ return /*#__PURE__*/(0, _jsxRuntime.jsxs)(_View.default, {
370
+ ref: handleContainerRef,
371
+ style: staticStyles.container,
372
+ ...selectContainerA11yProps({
373
+ accessibilityLabel: resolvedAccessibilityLabel,
374
+ descriptionId,
375
+ handleKeyDown
376
+ }),
377
+ ...selectProps(rest),
378
+ children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_A11yText.default, {
379
+ text: getCopy('instructionText'),
380
+ nativeID: descriptionId
381
+ }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_View.default, {
382
+ style: staticStyles.scrollContainer,
383
+ children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_ScrollViewEnd.default, {
384
+ ref: scrollRef,
385
+ horizontal: true,
386
+ onScrollEnd: handleScroll,
387
+ onScroll: handleScroll,
388
+ onContentSizeChange: handleContentWidth,
389
+ onLayout: handleContainerLayout,
390
+ showsHorizontalScrollIndicator: false,
391
+ contentContainerStyle: [staticStyles.scrollContent, selectScrollContentStyle(itemGap)],
392
+ children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_ScrollContext.ScrollProvider, {
393
+ itemWidth: itemWidth,
394
+ itemHeight: itemHeight,
395
+ onItemLayout: handleItemLayout,
396
+ children: children
397
+ })
398
+ })
399
+ }), scrollMax > INITIAL_DIMENSION && /*#__PURE__*/(0, _jsxRuntime.jsx)(_Pressable.default, {
400
+ ref: pressableRef,
401
+ style: [staticStyles.pressable, selectPressableStyles(defaultTokens)],
402
+ onPress: handleProgressPress,
403
+ children: pressableState => /*#__PURE__*/(0, _jsxRuntime.jsx)(_ScrollProgress.default, {
404
+ ref: thumbRef,
405
+ pressableState: pressableState,
406
+ getTokens: getTokens,
407
+ thumbWrapperStyle: thumbWrapperStyle,
408
+ getCopy: getCopy
409
+ })
410
+ })]
411
+ });
412
+ });
413
+ Scroll.displayName = 'Scroll';
414
+ Scroll.propTypes = {
415
+ ...selectedSystemPropTypes,
416
+ /**
417
+ * Scroll items to display. Should be `ScrollItem` components.
418
+ */
419
+ children: _propTypes.default.node.isRequired,
420
+ /**
421
+ * Theme tokens for customizing the Scroll appearance
422
+ */
423
+ tokens: (0, _utils.getTokensPropType)('Scroll'),
424
+ /**
425
+ * Variant for the Scroll component
426
+ */
427
+ variant: _utils.variantProp.propType,
428
+ /**
429
+ * Select English or French copy for accessible labels.
430
+ */
431
+ copy: _utils.copyPropTypes,
432
+ /**
433
+ * Override the default dictionary by passing the complete dictionary object for `en` and `fr`.
434
+ */
435
+ dictionary: _propTypes.default.shape({
436
+ en: _propTypes.default.object,
437
+ fr: _propTypes.default.object
438
+ }),
439
+ /**
440
+ * Accessibility label for the scrollable region
441
+ */
442
+ accessibilityLabel: _propTypes.default.string
443
+ };
444
+ var _default = exports.default = Scroll;
445
+ const staticStyles = _StyleSheet.default.create({
446
+ container: {
447
+ width: '100%'
448
+ },
449
+ scrollContainer: {
450
+ width: '100%'
451
+ },
452
+ pressable: {
453
+ justifyContent: 'center',
454
+ width: '100%'
455
+ },
456
+ scrollContent: {
457
+ alignSelf: 'flex-start',
458
+ flexGrow: 1
459
+ },
460
+ thumbWrapper: {
461
+ height: '100%'
462
+ },
463
+ thumbCursor: {
464
+ cursor: 'grab'
465
+ }
466
+ });
@@ -0,0 +1,55 @@
1
+ "use strict";
2
+
3
+ Object.defineProperty(exports, "__esModule", {
4
+ value: true
5
+ });
6
+ exports.ScrollProvider = void 0;
7
+ exports.useScroll = useScroll;
8
+ var _react = _interopRequireDefault(require("react"));
9
+ var _propTypes = _interopRequireDefault(require("prop-types"));
10
+ var _jsxRuntime = require("react/jsx-runtime");
11
+ function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
12
+ const ScrollContext = /*#__PURE__*/_react.default.createContext();
13
+ const ScrollProvider = _ref => {
14
+ let {
15
+ children,
16
+ itemWidth,
17
+ itemHeight,
18
+ onItemLayout
19
+ } = _ref;
20
+ const value = _react.default.useMemo(() => ({
21
+ itemWidth,
22
+ itemHeight,
23
+ onItemLayout
24
+ }), [itemWidth, itemHeight, onItemLayout]);
25
+ return /*#__PURE__*/(0, _jsxRuntime.jsx)(ScrollContext.Provider, {
26
+ value: value,
27
+ children: children
28
+ });
29
+ };
30
+ exports.ScrollProvider = ScrollProvider;
31
+ function useScroll() {
32
+ const context = _react.default.useContext(ScrollContext);
33
+ if (context === undefined) {
34
+ throw new Error(`'useScroll' must be used within a 'ScrollProvider'`);
35
+ }
36
+ return context;
37
+ }
38
+ ScrollProvider.propTypes = {
39
+ /**
40
+ * Content to be rendered within the scroll context provider.
41
+ */
42
+ children: _propTypes.default.node.isRequired,
43
+ /**
44
+ * Width of each scroll item in pixels.
45
+ */
46
+ itemWidth: _propTypes.default.number.isRequired,
47
+ /**
48
+ * Height of each scroll item in pixels.
49
+ */
50
+ itemHeight: _propTypes.default.number.isRequired,
51
+ /**
52
+ * Callback invoked when a scroll item layout is measured.
53
+ */
54
+ onItemLayout: _propTypes.default.func.isRequired
55
+ };
@@ -0,0 +1,103 @@
1
+ "use strict";
2
+
3
+ Object.defineProperty(exports, "__esModule", {
4
+ value: true
5
+ });
6
+ exports.default = void 0;
7
+ var _react = _interopRequireDefault(require("react"));
8
+ var _propTypes = _interopRequireDefault(require("prop-types"));
9
+ var _Platform = _interopRequireDefault(require("react-native-web/dist/cjs/exports/Platform"));
10
+ var _View = _interopRequireDefault(require("react-native-web/dist/cjs/exports/View"));
11
+ var _utils = require("../utils");
12
+ var _ScrollContext = require("./ScrollContext");
13
+ var _jsxRuntime = require("react/jsx-runtime");
14
+ function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
15
+ const [selectProps, selectedSystemPropTypes] = (0, _utils.selectSystemProps)([_utils.a11yProps, _utils.viewProps]);
16
+ const DEFAULT_TAG = 'li';
17
+ const DATA_SCROLL_ITEM = 'scrollItem';
18
+ const INITIAL_DIMENSION = 0;
19
+ const TAB_INDEX = 0;
20
+ const selectContainerStyle = _ref => {
21
+ let {
22
+ itemWidth,
23
+ itemHeight
24
+ } = _ref;
25
+ const style = {};
26
+ if (itemWidth > INITIAL_DIMENSION) {
27
+ style.width = itemWidth;
28
+ }
29
+ if (itemHeight > INITIAL_DIMENSION) {
30
+ style.height = itemHeight;
31
+ }
32
+ return style;
33
+ };
34
+
35
+ /**
36
+ * The `ScrollItem` component wraps individual items within a `Scroll` container. Each item
37
+ * is individually focusable and reports its natural dimensions so the parent can apply uniform
38
+ * sizing across all items.
39
+ *
40
+ * ## Props
41
+ *
42
+ * - Use `children` to provide the content of the scroll item
43
+ * - Use `tag` to set the HTML tag of the outer container (defaults to `'li'`)
44
+ *
45
+ */
46
+ const ScrollItem = /*#__PURE__*/_react.default.forwardRef((_ref2, ref) => {
47
+ let {
48
+ children,
49
+ tag = DEFAULT_TAG,
50
+ ...rest
51
+ } = _ref2;
52
+ const {
53
+ itemWidth,
54
+ itemHeight,
55
+ onItemLayout
56
+ } = (0, _ScrollContext.useScroll)();
57
+ const handleLayout = _react.default.useCallback(_ref3 => {
58
+ let {
59
+ nativeEvent: {
60
+ layout: {
61
+ width,
62
+ height
63
+ }
64
+ }
65
+ } = _ref3;
66
+ onItemLayout?.(width, height);
67
+ }, [onItemLayout]);
68
+ const selectedProps = selectProps({
69
+ ...rest,
70
+ ...(0, _utils.getA11yPropsFromHtmlTag)(tag, rest.accessibilityRole)
71
+ });
72
+ return /*#__PURE__*/(0, _jsxRuntime.jsx)(_View.default, {
73
+ ref: ref,
74
+ style: selectContainerStyle({
75
+ itemWidth,
76
+ itemHeight
77
+ }),
78
+ onLayout: handleLayout,
79
+ dataSet: {
80
+ [DATA_SCROLL_ITEM]: true
81
+ },
82
+ ...(_Platform.default.OS === 'web' ? {
83
+ tabIndex: TAB_INDEX
84
+ } : {
85
+ focusable: true
86
+ }),
87
+ ...selectedProps,
88
+ children: children
89
+ });
90
+ });
91
+ ScrollItem.displayName = 'ScrollItem';
92
+ ScrollItem.propTypes = {
93
+ ...selectedSystemPropTypes,
94
+ /**
95
+ * Content of the scroll item
96
+ */
97
+ children: _propTypes.default.oneOfType([_propTypes.default.arrayOf(_propTypes.default.node), _propTypes.default.node]).isRequired,
98
+ /**
99
+ * Sets the HTML tag of the outer container. Defaults to `'li'`.
100
+ */
101
+ tag: _propTypes.default.oneOf(_utils.layoutTags)
102
+ };
103
+ var _default = exports.default = /*#__PURE__*/_react.default.memo(ScrollItem);