@primer/react 0.0.0-20260715134933 → 0.0.0-20260715165143

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 (34) hide show
  1. package/CHANGELOG.md +3 -15
  2. package/dist/ActionBar/ActionBar.js +1 -1
  3. package/dist/ActionList/Group.js +1 -1
  4. package/dist/ActionList/List.js +16 -10
  5. package/dist/AnchoredOverlay/AnchoredOverlay.js +9 -3
  6. package/dist/Autocomplete/AutocompleteInput.js +10 -7
  7. package/dist/ButtonGroup/ButtonGroup.js +12 -5
  8. package/dist/Checkbox/Checkbox.js +10 -3
  9. package/dist/Dialog/Dialog.js +9 -2
  10. package/dist/FeatureFlags/DefaultFeatureFlags.js +2 -1
  11. package/dist/FilteredActionList/FilteredActionList.js +15 -4
  12. package/dist/FilteredActionList/FilteredActionListInput.d.ts +1 -1
  13. package/dist/Overlay/Overlay.js +1 -1
  14. package/dist/PageHeader/PageHeader.js +18 -9
  15. package/dist/PageLayout/PageLayout.js +247 -53
  16. package/dist/PageLayout/index.d.ts +1 -3
  17. package/dist/PageLayout/usePaneWidth.d.ts +1 -63
  18. package/dist/PageLayout/usePaneWidth.js +36 -51
  19. package/dist/SelectPanel/SelectPanel.js +1 -1
  20. package/dist/TextInput/TextInput.js +10 -3
  21. package/dist/TooltipV2/Tooltip.js +9 -2
  22. package/dist/experimental/Tabs/types.d.ts +2 -2
  23. package/dist/experimental/Tabs/useTabList.js +15 -7
  24. package/dist/experimental/index.js +3 -3
  25. package/dist/hooks/useAnchoredPosition.js +1 -14
  26. package/dist/hooks/useMergedRefs.d.ts +4 -4
  27. package/dist/hooks/useMergedRefs.js +8 -5
  28. package/dist/hooks/useProvidedRefOrCreate.d.ts +7 -10
  29. package/dist/hooks/useProvidedRefOrCreate.js +7 -10
  30. package/dist/index.d.ts +1 -3
  31. package/dist/index.js +1 -3
  32. package/package.json +1 -1
  33. package/dist/PageLayout/DragHandle.d.ts +0 -45
  34. package/dist/PageLayout/DragHandle.js +0 -224
@@ -7,12 +7,14 @@ import { useOverflow } from "../hooks/useOverflow.js";
7
7
  import { getResponsiveAttributes } from "../internal/utils/getResponsiveAttributes.js";
8
8
  import PageLayout_module_css_default from "./PageLayout.module.css.js";
9
9
  import { isCustomWidthOptions, isPaneWidth, updateAriaValues, usePaneWidth } from "./usePaneWidth.js";
10
- import { DragHandle } from "./DragHandle.js";
10
+ import { removeDraggingStyles, setDraggingStyles } from "./paneUtils.js";
11
11
  import { c } from "react-compiler-runtime";
12
12
  import { clsx } from "clsx";
13
13
  import { jsx, jsxs } from "react/jsx-runtime";
14
14
  import React, { memo, useRef } from "react";
15
15
  //#region src/PageLayout/PageLayout.tsx
16
+ const isArrowKey = (key) => key === "ArrowLeft" || key === "ArrowRight" || key === "ArrowUp" || key === "ArrowDown";
17
+ const isShrinkKey = (key) => key === "ArrowLeft" || key === "ArrowDown";
16
18
  const PageLayoutContext = /*#__PURE__*/ React.createContext({
17
19
  padding: "normal",
18
20
  rowGap: "normal",
@@ -265,9 +267,9 @@ const VerticalDivider = /*#__PURE__*/ memo((t0) => {
265
267
  });
266
268
  VerticalDivider.displayName = "VerticalDivider";
267
269
  const SidebarDivider = /*#__PURE__*/ memo(function SidebarDivider(t0) {
268
- const $ = c(23);
270
+ const $ = c(22);
269
271
  const { position, divider, resizable, minPaneWidth, maxPaneWidth, currentWidth, currentWidthRef, handleRef, sidebarRef, dragStartClientXRef, dragStartWidthRef, dragMaxWidthRef, getMaxPaneWidth, getDefaultWidth, saveWidth } = t0;
270
- const { columnGap, sidebarContentWrapperRef } = React.useContext(PageLayoutContext);
272
+ const { columnGap } = React.useContext(PageLayoutContext);
271
273
  const t1 = resizable ? "line" : divider;
272
274
  const t2 = `var(--spacing-${columnGap})`;
273
275
  let t3;
@@ -278,11 +280,9 @@ const SidebarDivider = /*#__PURE__*/ memo(function SidebarDivider(t0) {
278
280
  } else t3 = $[1];
279
281
  const t4 = t3;
280
282
  let t5;
281
- if ($[2] !== currentWidth || $[3] !== currentWidthRef || $[4] !== dragMaxWidthRef || $[5] !== dragStartClientXRef || $[6] !== dragStartWidthRef || $[7] !== getDefaultWidth || $[8] !== getMaxPaneWidth || $[9] !== handleRef || $[10] !== maxPaneWidth || $[11] !== minPaneWidth || $[12] !== position || $[13] !== resizable || $[14] !== saveWidth || $[15] !== sidebarContentWrapperRef || $[16] !== sidebarRef) {
283
+ if ($[2] !== currentWidth || $[3] !== currentWidthRef || $[4] !== dragMaxWidthRef || $[5] !== dragStartClientXRef || $[6] !== dragStartWidthRef || $[7] !== getDefaultWidth || $[8] !== getMaxPaneWidth || $[9] !== handleRef || $[10] !== maxPaneWidth || $[11] !== minPaneWidth || $[12] !== position || $[13] !== resizable || $[14] !== saveWidth || $[15] !== sidebarRef) {
282
284
  t5 = resizable ? /*#__PURE__*/ jsx(DragHandle, {
283
285
  handleRef,
284
- dragTargetRef: sidebarRef,
285
- contentWrapperRef: sidebarContentWrapperRef,
286
286
  "aria-valuemin": minPaneWidth,
287
287
  "aria-valuemax": maxPaneWidth,
288
288
  "aria-valuenow": currentWidth,
@@ -347,12 +347,11 @@ const SidebarDivider = /*#__PURE__*/ memo(function SidebarDivider(t0) {
347
347
  $[12] = position;
348
348
  $[13] = resizable;
349
349
  $[14] = saveWidth;
350
- $[15] = sidebarContentWrapperRef;
351
- $[16] = sidebarRef;
352
- $[17] = t5;
353
- } else t5 = $[17];
350
+ $[15] = sidebarRef;
351
+ $[16] = t5;
352
+ } else t5 = $[16];
354
353
  let t6;
355
- if ($[18] !== position || $[19] !== t1 || $[20] !== t4 || $[21] !== t5) {
354
+ if ($[17] !== position || $[18] !== t1 || $[19] !== t4 || $[20] !== t5) {
356
355
  t6 = /*#__PURE__*/ jsx(VerticalDivider, {
357
356
  variant: t1,
358
357
  position,
@@ -360,14 +359,212 @@ const SidebarDivider = /*#__PURE__*/ memo(function SidebarDivider(t0) {
360
359
  style: t4,
361
360
  children: t5
362
361
  });
363
- $[18] = position;
364
- $[19] = t1;
365
- $[20] = t4;
366
- $[21] = t5;
367
- $[22] = t6;
368
- } else t6 = $[22];
362
+ $[17] = position;
363
+ $[18] = t1;
364
+ $[19] = t4;
365
+ $[20] = t5;
366
+ $[21] = t6;
367
+ } else t6 = $[21];
369
368
  return t6;
370
369
  });
370
+ /**
371
+ * DragHandle - handles all pointer and keyboard interactions for resizing
372
+ * ARIA values are set in JSX for SSR accessibility,
373
+ * then updated via DOM manipulation during drag for performance
374
+ */
375
+ const DragHandle = /*#__PURE__*/ memo(function DragHandle(t0) {
376
+ const $ = c(35);
377
+ const { handleRef, onDragStart, onDrag, onDragEnd, onDoubleClick, "aria-valuemin": ariaValueMin, "aria-valuemax": ariaValueMax, "aria-valuenow": ariaValueNow } = t0;
378
+ const stableOnDragStart = React.useRef(onDragStart);
379
+ const stableOnDrag = React.useRef(onDrag);
380
+ const stableOnDragEnd = React.useRef(onDragEnd);
381
+ let t1;
382
+ if ($[0] !== onDrag || $[1] !== onDragEnd || $[2] !== onDragStart) {
383
+ t1 = () => {
384
+ stableOnDragStart.current = onDragStart;
385
+ stableOnDrag.current = onDrag;
386
+ stableOnDragEnd.current = onDragEnd;
387
+ };
388
+ $[0] = onDrag;
389
+ $[1] = onDragEnd;
390
+ $[2] = onDragStart;
391
+ $[3] = t1;
392
+ } else t1 = $[3];
393
+ React.useEffect(t1);
394
+ const { paneRef, contentWrapperRef } = React.useContext(PageLayoutContext);
395
+ const isDraggingRef = React.useRef(false);
396
+ let t2;
397
+ if ($[4] !== contentWrapperRef || $[5] !== handleRef || $[6] !== paneRef) {
398
+ t2 = () => {
399
+ if (isDraggingRef.current) return;
400
+ setDraggingStyles({
401
+ handle: handleRef.current,
402
+ pane: paneRef.current,
403
+ contentWrapper: contentWrapperRef.current
404
+ });
405
+ isDraggingRef.current = true;
406
+ };
407
+ $[4] = contentWrapperRef;
408
+ $[5] = handleRef;
409
+ $[6] = paneRef;
410
+ $[7] = t2;
411
+ } else t2 = $[7];
412
+ const startDragging = t2;
413
+ let t3;
414
+ if ($[8] !== contentWrapperRef || $[9] !== handleRef || $[10] !== paneRef) {
415
+ t3 = () => {
416
+ if (!isDraggingRef.current) return;
417
+ removeDraggingStyles({
418
+ handle: handleRef.current,
419
+ pane: paneRef.current,
420
+ contentWrapper: contentWrapperRef.current
421
+ });
422
+ isDraggingRef.current = false;
423
+ };
424
+ $[8] = contentWrapperRef;
425
+ $[9] = handleRef;
426
+ $[10] = paneRef;
427
+ $[11] = t3;
428
+ } else t3 = $[11];
429
+ const endDragging = t3;
430
+ let t4;
431
+ if ($[12] !== startDragging) {
432
+ t4 = (event) => {
433
+ if (event.button !== 0) return;
434
+ event.preventDefault();
435
+ const target = event.currentTarget;
436
+ try {
437
+ target.setPointerCapture(event.pointerId);
438
+ } catch {}
439
+ stableOnDragStart.current(event.clientX);
440
+ startDragging();
441
+ };
442
+ $[12] = startDragging;
443
+ $[13] = t4;
444
+ } else t4 = $[13];
445
+ const handlePointerDown = t4;
446
+ const rafIdRef = React.useRef(null);
447
+ const pendingClientXRef = React.useRef(null);
448
+ let t5;
449
+ if ($[14] === Symbol.for("react.memo_cache_sentinel")) {
450
+ t5 = (event_0) => {
451
+ if (!isDraggingRef.current) return;
452
+ event_0.preventDefault();
453
+ pendingClientXRef.current = event_0.clientX;
454
+ if (rafIdRef.current === null) rafIdRef.current = requestAnimationFrame(() => {
455
+ rafIdRef.current = null;
456
+ if (pendingClientXRef.current !== null) {
457
+ stableOnDrag.current(pendingClientXRef.current, false);
458
+ pendingClientXRef.current = null;
459
+ }
460
+ });
461
+ };
462
+ $[14] = t5;
463
+ } else t5 = $[14];
464
+ const handlePointerMove = t5;
465
+ let t6;
466
+ if ($[15] === Symbol.for("react.memo_cache_sentinel")) {
467
+ t6 = (event_1) => {
468
+ if (!isDraggingRef.current) return;
469
+ event_1.preventDefault();
470
+ };
471
+ $[15] = t6;
472
+ } else t6 = $[15];
473
+ const handlePointerUp = t6;
474
+ let t7;
475
+ if ($[16] !== endDragging) {
476
+ t7 = () => {
477
+ if (!isDraggingRef.current) return;
478
+ if (rafIdRef.current !== null) {
479
+ cancelAnimationFrame(rafIdRef.current);
480
+ rafIdRef.current = null;
481
+ pendingClientXRef.current = null;
482
+ }
483
+ endDragging();
484
+ stableOnDragEnd.current();
485
+ };
486
+ $[16] = endDragging;
487
+ $[17] = t7;
488
+ } else t7 = $[17];
489
+ const handleLostPointerCapture = t7;
490
+ let t8;
491
+ if ($[18] !== startDragging) {
492
+ t8 = (event_2) => {
493
+ if (!isArrowKey(event_2.key)) return;
494
+ event_2.preventDefault();
495
+ const delta = isShrinkKey(event_2.key) ? -3 : 3;
496
+ if (!isDraggingRef.current) startDragging();
497
+ stableOnDrag.current(delta, true);
498
+ };
499
+ $[18] = startDragging;
500
+ $[19] = t8;
501
+ } else t8 = $[19];
502
+ const handleKeyDown = t8;
503
+ let t9;
504
+ if ($[20] !== endDragging) {
505
+ t9 = (event_3) => {
506
+ if (!isArrowKey(event_3.key)) return;
507
+ event_3.preventDefault();
508
+ endDragging();
509
+ stableOnDragEnd.current();
510
+ };
511
+ $[20] = endDragging;
512
+ $[21] = t9;
513
+ } else t9 = $[21];
514
+ const handleKeyUp = t9;
515
+ let t10;
516
+ let t11;
517
+ if ($[22] === Symbol.for("react.memo_cache_sentinel")) {
518
+ t10 = () => () => {
519
+ if (rafIdRef.current !== null) {
520
+ cancelAnimationFrame(rafIdRef.current);
521
+ rafIdRef.current = null;
522
+ }
523
+ };
524
+ t11 = [];
525
+ $[22] = t10;
526
+ $[23] = t11;
527
+ } else {
528
+ t10 = $[22];
529
+ t11 = $[23];
530
+ }
531
+ React.useEffect(t10, t11);
532
+ const t12 = ariaValueNow !== void 0 ? `Pane width ${ariaValueNow} pixels` : void 0;
533
+ let t13;
534
+ if ($[24] !== ariaValueMax || $[25] !== ariaValueMin || $[26] !== ariaValueNow || $[27] !== handleKeyDown || $[28] !== handleKeyUp || $[29] !== handleLostPointerCapture || $[30] !== handlePointerDown || $[31] !== handleRef || $[32] !== onDoubleClick || $[33] !== t12) {
535
+ t13 = /*#__PURE__*/ jsx("div", {
536
+ ref: handleRef,
537
+ className: PageLayout_module_css_default.DraggableHandle,
538
+ "data-component": "PageLayout.DragHandle",
539
+ role: "slider",
540
+ "aria-label": "Draggable pane splitter",
541
+ "aria-valuemin": ariaValueMin,
542
+ "aria-valuemax": ariaValueMax,
543
+ "aria-valuenow": ariaValueNow,
544
+ "aria-valuetext": t12,
545
+ tabIndex: 0,
546
+ onPointerDown: handlePointerDown,
547
+ onPointerMove: handlePointerMove,
548
+ onPointerUp: handlePointerUp,
549
+ onLostPointerCapture: handleLostPointerCapture,
550
+ onKeyDown: handleKeyDown,
551
+ onKeyUp: handleKeyUp,
552
+ onDoubleClick
553
+ });
554
+ $[24] = ariaValueMax;
555
+ $[25] = ariaValueMin;
556
+ $[26] = ariaValueNow;
557
+ $[27] = handleKeyDown;
558
+ $[28] = handleKeyUp;
559
+ $[29] = handleLostPointerCapture;
560
+ $[30] = handlePointerDown;
561
+ $[31] = handleRef;
562
+ $[32] = onDoubleClick;
563
+ $[33] = t12;
564
+ $[34] = t13;
565
+ } else t13 = $[34];
566
+ return t13;
567
+ });
371
568
  const Header = (t0) => {
372
569
  const $ = c(29);
373
570
  const { "aria-label": label, "aria-labelledby": labelledBy, padding: t1, divider: t2, dividerWhenNarrow: t3, hidden: t4, children, style, className, "data-component": t5 } = t0;
@@ -548,7 +745,7 @@ const overflowProps = {
548
745
  role: "region"
549
746
  };
550
747
  const Pane = /*#__PURE__*/ React.forwardRef((t0, forwardRef) => {
551
- const $ = c(98);
748
+ const $ = c(97);
552
749
  const { "aria-label": label, "aria-labelledby": labelledBy, position: t1, positionWhenNarrow: t2, width: t3, minWidth: t4, currentWidth: controlledWidth, onResizeEnd, padding: t5, resizable: t6, widthStorageKey: t7, divider: t8, dividerWhenNarrow: t9, sticky: t10, offsetHeader: t11, hidden: t12, children, id, className, style, "data-component": t13 } = t0;
553
750
  const responsivePosition = t1 === void 0 ? "end" : t1;
554
751
  const positionWhenNarrow = t2 === void 0 ? "inherit" : t2;
@@ -801,11 +998,9 @@ const Pane = /*#__PURE__*/ React.forwardRef((t0, forwardRef) => {
801
998
  } else t48 = $[70];
802
999
  const t49 = t48;
803
1000
  let t50;
804
- if ($[71] !== contentWrapperRef || $[72] !== currentWidth || $[73] !== currentWidthRef || $[74] !== getDefaultWidth || $[75] !== getMaxPaneWidth || $[76] !== maxPaneWidth || $[77] !== minPaneWidth || $[78] !== paneRef || $[79] !== position || $[80] !== resizable || $[81] !== saveWidth) {
1001
+ if ($[71] !== currentWidth || $[72] !== currentWidthRef || $[73] !== getDefaultWidth || $[74] !== getMaxPaneWidth || $[75] !== maxPaneWidth || $[76] !== minPaneWidth || $[77] !== paneRef || $[78] !== position || $[79] !== resizable || $[80] !== saveWidth) {
805
1002
  t50 = resizable ? /*#__PURE__*/ jsx(DragHandle, {
806
1003
  handleRef,
807
- dragTargetRef: paneRef,
808
- contentWrapperRef,
809
1004
  "aria-valuemin": minPaneWidth,
810
1005
  "aria-valuemax": maxPaneWidth,
811
1006
  "aria-valuenow": currentWidth,
@@ -857,21 +1052,20 @@ const Pane = /*#__PURE__*/ React.forwardRef((t0, forwardRef) => {
857
1052
  saveWidth(resetWidth);
858
1053
  }
859
1054
  }) : null;
860
- $[71] = contentWrapperRef;
861
- $[72] = currentWidth;
862
- $[73] = currentWidthRef;
863
- $[74] = getDefaultWidth;
864
- $[75] = getMaxPaneWidth;
865
- $[76] = maxPaneWidth;
866
- $[77] = minPaneWidth;
867
- $[78] = paneRef;
868
- $[79] = position;
869
- $[80] = resizable;
870
- $[81] = saveWidth;
871
- $[82] = t50;
872
- } else t50 = $[82];
1055
+ $[71] = currentWidth;
1056
+ $[72] = currentWidthRef;
1057
+ $[73] = getDefaultWidth;
1058
+ $[74] = getMaxPaneWidth;
1059
+ $[75] = maxPaneWidth;
1060
+ $[76] = minPaneWidth;
1061
+ $[77] = paneRef;
1062
+ $[78] = position;
1063
+ $[79] = resizable;
1064
+ $[80] = saveWidth;
1065
+ $[81] = t50;
1066
+ } else t50 = $[81];
873
1067
  let t51;
874
- if ($[83] !== positionProp || $[84] !== resizable || $[85] !== t46 || $[86] !== t49 || $[87] !== t50) {
1068
+ if ($[82] !== positionProp || $[83] !== resizable || $[84] !== t46 || $[85] !== t49 || $[86] !== t50) {
875
1069
  t51 = /*#__PURE__*/ jsx(VerticalDivider, {
876
1070
  variant: t46,
877
1071
  draggable: resizable,
@@ -880,15 +1074,15 @@ const Pane = /*#__PURE__*/ React.forwardRef((t0, forwardRef) => {
880
1074
  style: t49,
881
1075
  children: t50
882
1076
  });
883
- $[83] = positionProp;
884
- $[84] = resizable;
885
- $[85] = t46;
886
- $[86] = t49;
887
- $[87] = t50;
888
- $[88] = t51;
889
- } else t51 = $[88];
1077
+ $[82] = positionProp;
1078
+ $[83] = resizable;
1079
+ $[84] = t46;
1080
+ $[85] = t49;
1081
+ $[86] = t50;
1082
+ $[87] = t51;
1083
+ } else t51 = $[87];
890
1084
  let t52;
891
- if ($[89] !== t19 || $[90] !== t24 || $[91] !== t25 || $[92] !== t26 || $[93] !== t27 || $[94] !== t32 || $[95] !== t45 || $[96] !== t51) {
1085
+ if ($[88] !== t19 || $[89] !== t24 || $[90] !== t25 || $[91] !== t26 || $[92] !== t27 || $[93] !== t32 || $[94] !== t45 || $[95] !== t51) {
892
1086
  t52 = /*#__PURE__*/ jsxs("div", {
893
1087
  className: t19,
894
1088
  style: t24,
@@ -901,16 +1095,16 @@ const Pane = /*#__PURE__*/ React.forwardRef((t0, forwardRef) => {
901
1095
  t51
902
1096
  ]
903
1097
  });
904
- $[89] = t19;
905
- $[90] = t24;
906
- $[91] = t25;
907
- $[92] = t26;
908
- $[93] = t27;
909
- $[94] = t32;
910
- $[95] = t45;
911
- $[96] = t51;
912
- $[97] = t52;
913
- } else t52 = $[97];
1098
+ $[88] = t19;
1099
+ $[89] = t24;
1100
+ $[90] = t25;
1101
+ $[91] = t26;
1102
+ $[92] = t27;
1103
+ $[93] = t32;
1104
+ $[94] = t45;
1105
+ $[95] = t51;
1106
+ $[96] = t52;
1107
+ } else t52 = $[96];
914
1108
  return t52;
915
1109
  });
916
1110
  Pane.displayName = "PageLayout.Pane";
@@ -1,4 +1,2 @@
1
- import { CustomWidthOptions, PaneWidth, PaneWidthValue, UsePaneWidthOptions, UsePaneWidthResult, defaultPaneWidth, usePaneWidth } from "./usePaneWidth.js";
2
1
  import { PageLayout, PageLayoutContentProps, PageLayoutFooterProps, PageLayoutHeaderProps, PageLayoutPaneBaseProps, PageLayoutPaneProps, PageLayoutProps, PageLayoutSidebarBaseProps, PageLayoutSidebarProps } from "./PageLayout.js";
3
- import { DragHandle, DragHandleProps } from "./DragHandle.js";
4
- export { type CustomWidthOptions, DragHandle, type DragHandleProps, PageLayout, PageLayoutContentProps, PageLayoutFooterProps, PageLayoutHeaderProps, PageLayoutPaneBaseProps, PageLayoutPaneProps, PageLayoutProps, PageLayoutSidebarBaseProps, PageLayoutSidebarProps, type PaneWidth, type PaneWidthValue, type UsePaneWidthOptions, type UsePaneWidthResult, defaultPaneWidth, usePaneWidth };
2
+ export { PageLayout, PageLayoutContentProps, PageLayoutFooterProps, PageLayoutHeaderProps, PageLayoutPaneBaseProps, PageLayoutPaneProps, PageLayoutProps, PageLayoutSidebarBaseProps, PageLayoutSidebarProps };
@@ -14,67 +14,5 @@ type PaneWidth = 'small' | 'medium' | 'large';
14
14
  * - `CustomWidthOptions`: Explicit min/default/max constraints
15
15
  */
16
16
  type PaneWidthValue = PaneWidth | CustomWidthOptions;
17
- type UsePaneWidthOptions = {
18
- width: PaneWidthValue;
19
- minWidth: number;
20
- resizable: boolean; /** localStorage key for persisting width. When undefined, localStorage is not used. */
21
- widthStorageKey?: string;
22
- paneRef: React.RefObject<HTMLDivElement | null>;
23
- handleRef: React.RefObject<HTMLDivElement | null>;
24
- /**
25
- * Optional ref to the content wrapper element. Only used by PageLayout for its
26
- * viewport/content math during resize. Standalone consumers can omit this.
27
- */
28
- contentWrapperRef?: React.RefObject<HTMLDivElement | null>;
29
- /**
30
- * When true, custom max width values are capped to the viewport-based max.
31
- * This prevents overflow in non-wrapping flex layouts (e.g., Sidebar).
32
- * @default false
33
- */
34
- constrainToViewport?: boolean; /** Callback fired when a resize operation ends (drag release or keyboard key up) */
35
- onResizeEnd?: (width: number) => void; /** Current/controlled width value in pixels (used instead of internal state; default from `width` is still used for reset) */
36
- currentWidth?: number;
37
- /**
38
- * Formats the `aria-valuetext` written during mount and viewport resize.
39
- * Should match the formatter passed to `DragHandle` so screen-reader output
40
- * stays consistent across drag, mount, and resize updates.
41
- * @default defaultFormatValueText
42
- */
43
- formatValueText?: (valueNow: number) => string;
44
- };
45
- type UsePaneWidthResult = {
46
- /** Current width for React state (used in ARIA attributes) */currentWidth: number; /** Mutable ref tracking width during drag operations */
47
- currentWidthRef: React.MutableRefObject<number>; /** Minimum allowed pane width */
48
- minPaneWidth: number; /** Maximum allowed pane width (updates on viewport resize) */
49
- maxPaneWidth: number; /** Calculate current max width constraint */
50
- getMaxPaneWidth: () => number; /** Persist width to localStorage and sync React state */
51
- saveWidth: (value: number) => void; /** Reset to default width */
52
- getDefaultWidth: () => number;
53
- };
54
- /** Default widths for preset size options */
55
- declare const defaultPaneWidth: Record<PaneWidth, number>;
56
- /**
57
- * Manages pane width state with storage persistence and viewport constraints.
58
- * Handles initialization from storage, clamping on viewport resize, and provides
59
- * functions to save and reset width.
60
- *
61
- * Storage behavior:
62
- * - When `resizable` is `true` and `onResizeEnd` is not provided: Uses localStorage
63
- * - When `onResizeEnd` is provided: Calls the callback instead of localStorage
64
- * - When `resizable` is `false` or `undefined`: Not resizable, no persistence
65
- */
66
- declare function usePaneWidth({
67
- width,
68
- minWidth,
69
- resizable,
70
- widthStorageKey,
71
- paneRef,
72
- handleRef,
73
- contentWrapperRef,
74
- constrainToViewport,
75
- onResizeEnd,
76
- currentWidth: controlledWidth,
77
- formatValueText
78
- }: UsePaneWidthOptions): UsePaneWidthResult;
79
17
  //#endregion
80
- export { CustomWidthOptions, PaneWidth, PaneWidthValue, UsePaneWidthOptions, UsePaneWidthResult, defaultPaneWidth, usePaneWidth };
18
+ export { CustomWidthOptions, PaneWidth, PaneWidthValue };
@@ -47,18 +47,13 @@ function getMaxWidthDiffFromViewport() {
47
47
  if (!canUseDOM) return DEFAULT_MAX_WIDTH_DIFF;
48
48
  return window.innerWidth >= DEFAULT_PANE_MAX_WIDTH_DIFF_BREAKPOINT ? WIDE_MAX_WIDTH_DIFF : DEFAULT_MAX_WIDTH_DIFF;
49
49
  }
50
- /**
51
- * Default formatter for the drag handle's `aria-valuetext`.
52
- * Kept in sync between the rendered attribute and drag-time DOM writes.
53
- */
54
- const defaultFormatValueText = (valueNow) => `Pane width ${valueNow} pixels`;
55
- const updateAriaValues = (handle, values, formatValueText = defaultFormatValueText) => {
50
+ const updateAriaValues = (handle, values) => {
56
51
  if (!handle) return;
57
52
  if (values.min !== void 0) handle.setAttribute("aria-valuemin", String(values.min));
58
53
  if (values.max !== void 0) handle.setAttribute("aria-valuemax", String(values.max));
59
54
  if (values.current !== void 0) {
60
55
  handle.setAttribute("aria-valuenow", String(values.current));
61
- handle.setAttribute("aria-valuetext", formatValueText(values.current));
56
+ handle.setAttribute("aria-valuetext", `Pane width ${values.current} pixels`);
62
57
  }
63
58
  };
64
59
  const localStoragePersister = {
@@ -89,8 +84,8 @@ const localStoragePersister = {
89
84
  * - When `resizable` is `false` or `undefined`: Not resizable, no persistence
90
85
  */
91
86
  function usePaneWidth(t0) {
92
- const $ = c(44);
93
- const { width, minWidth, resizable, widthStorageKey, paneRef, handleRef, contentWrapperRef, constrainToViewport: t1, onResizeEnd, currentWidth: controlledWidth, formatValueText } = t0;
87
+ const $ = c(42);
88
+ const { width, minWidth, resizable, widthStorageKey, paneRef, handleRef, contentWrapperRef, constrainToViewport: t1, onResizeEnd, currentWidth: controlledWidth } = t0;
94
89
  const constrainToViewport = t1 === void 0 ? false : t1;
95
90
  const isCustomWidth = isCustomWidthOptions(width);
96
91
  const minPaneWidth = isCustomWidth ? parseInt(width.min, 10) : minWidth;
@@ -223,20 +218,10 @@ function usePaneWidth(t0) {
223
218
  $[25] = t11;
224
219
  } else t11 = $[25];
225
220
  useIsomorphicLayoutEffect(t11);
226
- const formatValueTextRef = React.useRef(formatValueText);
227
221
  let t12;
228
- if ($[26] !== formatValueText) {
229
- t12 = () => {
230
- formatValueTextRef.current = formatValueText;
231
- };
232
- $[26] = formatValueText;
233
- $[27] = t12;
234
- } else t12 = $[27];
235
- useIsomorphicLayoutEffect(t12);
236
222
  let t13;
237
- let t14;
238
- if ($[28] !== constrainToViewport || $[29] !== contentWrapperRef || $[30] !== customMaxWidth || $[31] !== handleRef || $[32] !== minPaneWidth || $[33] !== paneRef || $[34] !== resizable) {
239
- t13 = () => {
223
+ if ($[26] !== constrainToViewport || $[27] !== contentWrapperRef || $[28] !== customMaxWidth || $[29] !== handleRef || $[30] !== minPaneWidth || $[31] !== paneRef || $[32] !== resizable) {
224
+ t12 = () => {
240
225
  var _paneRef$current3;
241
226
  if (!resizable) return;
242
227
  let lastViewportWidth = window.innerWidth;
@@ -257,7 +242,7 @@ function usePaneWidth(t0) {
257
242
  updateAriaValues(handleRef.current, {
258
243
  max: actualMax,
259
244
  current: currentWidthRef.current
260
- }, formatValueTextRef.current);
245
+ });
261
246
  if (actualMax !== maxPaneWidthRef.current || wasClamped) {
262
247
  maxPaneWidthRef.current = actualMax;
263
248
  startTransition(() => {
@@ -274,7 +259,7 @@ function usePaneWidth(t0) {
274
259
  min: minPaneWidth,
275
260
  max: initialMax,
276
261
  current: currentWidthRef.current
277
- }, formatValueTextRef.current);
262
+ });
278
263
  startTransition(() => {
279
264
  setMaxPaneWidth(initialMax);
280
265
  });
@@ -289,14 +274,14 @@ function usePaneWidth(t0) {
289
274
  if (isResizing) return;
290
275
  isResizing = true;
291
276
  (_paneRef$current4 = paneRef.current) === null || _paneRef$current4 === void 0 || _paneRef$current4.setAttribute("data-dragging", "true");
292
- contentWrapperRef === null || contentWrapperRef === void 0 || (_contentWrapperRef$cu = contentWrapperRef.current) == null || _contentWrapperRef$cu.setAttribute("data-dragging", "true");
277
+ (_contentWrapperRef$cu = contentWrapperRef.current) === null || _contentWrapperRef$cu === void 0 || _contentWrapperRef$cu.setAttribute("data-dragging", "true");
293
278
  };
294
279
  const endResizeOptimizations = () => {
295
280
  var _paneRef$current5, _contentWrapperRef$cu2;
296
281
  if (!isResizing) return;
297
282
  isResizing = false;
298
283
  (_paneRef$current5 = paneRef.current) === null || _paneRef$current5 === void 0 || _paneRef$current5.removeAttribute("data-dragging");
299
- contentWrapperRef === null || contentWrapperRef === void 0 || (_contentWrapperRef$cu2 = contentWrapperRef.current) == null || _contentWrapperRef$cu2.removeAttribute("data-dragging");
284
+ (_contentWrapperRef$cu2 = contentWrapperRef.current) === null || _contentWrapperRef$cu2 === void 0 || _contentWrapperRef$cu2.removeAttribute("data-dragging");
300
285
  };
301
286
  const handleResize = () => {
302
287
  startResizeOptimizations();
@@ -327,7 +312,7 @@ function usePaneWidth(t0) {
327
312
  window.removeEventListener("resize", handleResize);
328
313
  };
329
314
  };
330
- t14 = [
315
+ t13 = [
331
316
  resizable,
332
317
  customMaxWidth,
333
318
  constrainToViewport,
@@ -336,23 +321,23 @@ function usePaneWidth(t0) {
336
321
  handleRef,
337
322
  contentWrapperRef
338
323
  ];
339
- $[28] = constrainToViewport;
340
- $[29] = contentWrapperRef;
341
- $[30] = customMaxWidth;
342
- $[31] = handleRef;
343
- $[32] = minPaneWidth;
344
- $[33] = paneRef;
345
- $[34] = resizable;
346
- $[35] = t13;
347
- $[36] = t14;
324
+ $[26] = constrainToViewport;
325
+ $[27] = contentWrapperRef;
326
+ $[28] = customMaxWidth;
327
+ $[29] = handleRef;
328
+ $[30] = minPaneWidth;
329
+ $[31] = paneRef;
330
+ $[32] = resizable;
331
+ $[33] = t12;
332
+ $[34] = t13;
348
333
  } else {
349
- t13 = $[35];
350
- t14 = $[36];
334
+ t12 = $[33];
335
+ t13 = $[34];
351
336
  }
352
- useIsomorphicLayoutEffect(t13, t14);
353
- let t15;
354
- if ($[37] !== currentWidth || $[38] !== getDefaultWidth || $[39] !== getMaxPaneWidth || $[40] !== maxPaneWidth || $[41] !== minPaneWidth || $[42] !== saveWidth) {
355
- t15 = {
337
+ useIsomorphicLayoutEffect(t12, t13);
338
+ let t14;
339
+ if ($[35] !== currentWidth || $[36] !== getDefaultWidth || $[37] !== getMaxPaneWidth || $[38] !== maxPaneWidth || $[39] !== minPaneWidth || $[40] !== saveWidth) {
340
+ t14 = {
356
341
  currentWidth,
357
342
  currentWidthRef,
358
343
  minPaneWidth,
@@ -361,15 +346,15 @@ function usePaneWidth(t0) {
361
346
  saveWidth,
362
347
  getDefaultWidth
363
348
  };
364
- $[37] = currentWidth;
365
- $[38] = getDefaultWidth;
366
- $[39] = getMaxPaneWidth;
367
- $[40] = maxPaneWidth;
368
- $[41] = minPaneWidth;
369
- $[42] = saveWidth;
370
- $[43] = t15;
371
- } else t15 = $[43];
372
- return t15;
349
+ $[35] = currentWidth;
350
+ $[36] = getDefaultWidth;
351
+ $[37] = getMaxPaneWidth;
352
+ $[38] = maxPaneWidth;
353
+ $[39] = minPaneWidth;
354
+ $[40] = saveWidth;
355
+ $[41] = t14;
356
+ } else t14 = $[41];
357
+ return t14;
373
358
  }
374
359
  //#endregion
375
- export { DEFAULT_MAX_WIDTH_DIFF, DEFAULT_SIDEBAR_MAX_WIDTH_DIFF, defaultFormatValueText, defaultPaneWidth, getDefaultPaneWidth, getMaxWidthDiffFromViewport, isCustomWidthOptions, isPaneWidth, updateAriaValues, usePaneWidth };
360
+ export { DEFAULT_MAX_WIDTH_DIFF, DEFAULT_SIDEBAR_MAX_WIDTH_DIFF, defaultPaneWidth, getDefaultPaneWidth, getMaxWidthDiffFromViewport, isCustomWidthOptions, isPaneWidth, updateAriaValues, usePaneWidth };
@@ -2,13 +2,13 @@ import { useProvidedRefOrCreate } from "../hooks/useProvidedRefOrCreate.js";
2
2
  import { useProvidedStateOrCreate } from "../hooks/useProvidedStateOrCreate.js";
3
3
  import { isAlphabetKey } from "../hooks/useMnemonics.js";
4
4
  import { useId as useId$1 } from "../hooks/useId.js";
5
+ import { useFeatureFlag } from "../FeatureFlags/useFeatureFlag.js";
5
6
  import useSafeTimeout from "../hooks/useSafeTimeout.js";
6
7
  import { IconButton } from "../Button/IconButton.js";
7
8
  import { LinkButton } from "../Button/LinkButton.js";
8
9
  import { ButtonComponent } from "../Button/Button.js";
9
10
  import { useResponsiveValue } from "../hooks/useResponsiveValue.js";
10
11
  import Heading from "../Heading/Heading.js";
11
- import { useFeatureFlag } from "../FeatureFlags/useFeatureFlag.js";
12
12
  import { AnchoredOverlay } from "../AnchoredOverlay/AnchoredOverlay.js";
13
13
  import { Banner } from "../Banner/index.js";
14
14
  import { useFormControlContext } from "../FormControl/_FormControlContext.js";
@@ -1,5 +1,7 @@
1
+ import { useMergedRefs } from "../hooks/useMergedRefs.js";
1
2
  import { useProvidedRefOrCreate } from "../hooks/useProvidedRefOrCreate.js";
2
3
  import { AriaStatus } from "../live-region/AriaStatus.js";
4
+ import { useFeatureFlag } from "../FeatureFlags/useFeatureFlag.js";
3
5
  import Text_default from "../Text/Text.js";
4
6
  import _VisuallyHidden_module_css_default from "../_VisuallyHidden.module.css.js";
5
7
  import VisuallyHidden from "../_VisuallyHidden.js";
@@ -11,14 +13,19 @@ import UnstyledTextInput from "../internal/components/UnstyledTextInput.js";
11
13
  import { getCharacterCountState } from "../utils/character-counter.js";
12
14
  import { clsx } from "clsx";
13
15
  import { Fragment, jsx, jsxs } from "react/jsx-runtime";
14
- import React, { useCallback, useId, useState } from "react";
16
+ import React, { useCallback, useId, useRef, useState } from "react";
15
17
  import { isValidElementType } from "react-is";
16
18
  import { AlertFillIcon } from "@primer/octicons-react";
17
19
  //#region src/TextInput/TextInput.tsx
18
20
  const TextInput = /*#__PURE__*/ React.forwardRef(({ icon: IconComponent, leadingVisual: LeadingVisual, trailingVisual: TrailingVisual, trailingAction, block, className, contrast, disabled, loading, loaderPosition = "auto", loaderText = "Loading", monospace, validationStatus, size: sizeProp, onFocus, onBlur, variant: variantProp, width: widthProp, minWidth: minWidthProp, maxWidth: maxWidthProp, type = "text", required, characterLimit, onChange, value, defaultValue, "data-component": dataComponent, ...inputProps }, ref) => {
19
21
  var _counter$isOverLimit;
20
22
  const [isInputFocused, setIsInputFocused] = useState(false);
21
- const inputRef = useProvidedRefOrCreate(ref);
23
+ const mergedRefEnabled = useFeatureFlag("primer_react_merged_forwarded_refs");
24
+ const internalRef = useRef(null);
25
+ const mergedRef = useMergedRefs(internalRef, ref);
26
+ const providedOrCreatedRef = useProvidedRefOrCreate(ref);
27
+ const inputRef = mergedRefEnabled ? internalRef : providedOrCreatedRef;
28
+ const appliedRef = mergedRefEnabled ? mergedRef : providedOrCreatedRef;
22
29
  const isControlled = value !== void 0;
23
30
  const [uncontrolledLength, setUncontrolledLength] = useState(() => defaultValue !== void 0 ? String(defaultValue).length : 0);
24
31
  const currentLength = isControlled ? String(value).length : uncontrolledLength;
@@ -88,7 +95,7 @@ const TextInput = /*#__PURE__*/ React.forwardRef(({ icon: IconComponent, leading
88
95
  children: typeof LeadingVisual !== "string" && isValidElementType(LeadingVisual) ? /*#__PURE__*/ jsx(LeadingVisual, {}) : LeadingVisual
89
96
  }),
90
97
  /*#__PURE__*/ jsx(UnstyledTextInput, {
91
- ref: inputRef,
98
+ ref: appliedRef,
92
99
  disabled,
93
100
  onFocus: handleInputFocus,
94
101
  onBlur: handleInputBlur,