@primer/react 0.0.0-20260717162651 → 0.0.0-20260720205022

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 (70) hide show
  1. package/CHANGELOG.md +3 -25
  2. package/dist/ActionBar/ActionBar-e63def3c.css +2 -0
  3. package/dist/ActionBar/ActionBar-e63def3c.css.map +1 -0
  4. package/dist/ActionBar/ActionBar.js +1 -1
  5. package/dist/ActionBar/ActionBar.module.css.js +1 -1
  6. package/dist/ActionList/Group.js +2 -2
  7. package/dist/ActionList/Item.js +1 -1
  8. package/dist/ActionList/List.js +21 -15
  9. package/dist/ActionMenu/ActionMenu.js +1 -1
  10. package/dist/AnchoredOverlay/AnchoredOverlay.js +7 -5
  11. package/dist/Autocomplete/AutocompleteInput.js +10 -7
  12. package/dist/Autocomplete/AutocompleteMenu.js +2 -3
  13. package/dist/Breadcrumbs/Breadcrumbs.js +1 -4
  14. package/dist/ButtonGroup/ButtonGroup.js +15 -8
  15. package/dist/Checkbox/Checkbox.js +16 -9
  16. package/dist/Dialog/Dialog.js +13 -6
  17. package/dist/FeatureFlags/DefaultFeatureFlags.js +2 -1
  18. package/dist/FeatureFlags/useFeatureFlag.js +1 -2
  19. package/dist/FilteredActionList/FilteredActionList.js +31 -20
  20. package/dist/FilteredActionList/FilteredActionListInput.d.ts +1 -1
  21. package/dist/FilteredActionList/useAnnouncements.js +14 -20
  22. package/dist/LabelGroup/LabelGroup-7d19205a.css +2 -0
  23. package/dist/LabelGroup/LabelGroup-7d19205a.css.map +1 -0
  24. package/dist/LabelGroup/LabelGroup.module.css.js +1 -1
  25. package/dist/NavList/NavList.js +1 -1
  26. package/dist/Overlay/Overlay.js +1 -1
  27. package/dist/PageHeader/PageHeader.js +31 -22
  28. package/dist/PageLayout/PageLayout.js +248 -54
  29. package/dist/PageLayout/index.d.ts +1 -3
  30. package/dist/PageLayout/usePaneWidth.d.ts +1 -63
  31. package/dist/PageLayout/usePaneWidth.js +36 -52
  32. package/dist/SelectPanel/SelectPanel.js +1 -1
  33. package/dist/TextInput/TextInput.js +13 -6
  34. package/dist/TextInputWithTokens/TextInputWithTokens.js +1 -1
  35. package/dist/Timeline/Timeline-ff81db92.css +2 -0
  36. package/dist/Timeline/Timeline-ff81db92.css.map +1 -0
  37. package/dist/Timeline/Timeline.module.css.js +1 -1
  38. package/dist/TooltipV2/Tooltip.js +19 -13
  39. package/dist/TreeView/TreeView.js +3 -6
  40. package/dist/experimental/SelectPanel2/SelectPanel.js +2 -2
  41. package/dist/experimental/Tabs/types.d.ts +2 -2
  42. package/dist/experimental/Tabs/useTabList.js +18 -10
  43. package/dist/experimental/UnderlinePanels/UnderlinePanels.js +1 -1
  44. package/dist/experimental/index.js +4 -4
  45. package/dist/hooks/useAnchoredPosition.js +1 -14
  46. package/dist/hooks/useDialog.js +1 -2
  47. package/dist/hooks/useMergedRefs.d.ts +4 -4
  48. package/dist/hooks/useMergedRefs.js +8 -5
  49. package/dist/hooks/useProvidedRefOrCreate.d.ts +7 -10
  50. package/dist/hooks/useProvidedRefOrCreate.js +7 -10
  51. package/dist/hooks/useScrollFlash.js +1 -2
  52. package/dist/index.d.ts +1 -3
  53. package/dist/index.js +5 -7
  54. package/dist/internal/components/CheckboxOrRadioGroup/CheckboxOrRadioGroup.js +1 -1
  55. package/dist/internal/components/UnderlineTabbedInterface-25587345.css +2 -0
  56. package/dist/internal/components/UnderlineTabbedInterface-25587345.css.map +1 -0
  57. package/dist/internal/components/UnderlineTabbedInterface.module.css.js +1 -1
  58. package/dist/utils/warning.js +2 -3
  59. package/generated/components.json +1 -1
  60. package/package.json +2 -2
  61. package/dist/ActionBar/ActionBar-3767d551.css +0 -2
  62. package/dist/ActionBar/ActionBar-3767d551.css.map +0 -1
  63. package/dist/LabelGroup/LabelGroup-db41f443.css +0 -2
  64. package/dist/LabelGroup/LabelGroup-db41f443.css.map +0 -1
  65. package/dist/PageLayout/DragHandle.d.ts +0 -45
  66. package/dist/PageLayout/DragHandle.js +0 -224
  67. package/dist/Timeline/Timeline-b7e6685b.css +0 -2
  68. package/dist/Timeline/Timeline-b7e6685b.css.map +0 -1
  69. package/dist/internal/components/UnderlineTabbedInterface-3b4961a4.css +0 -2
  70. package/dist/internal/components/UnderlineTabbedInterface-3b4961a4.css.map +0 -1
@@ -1,18 +1,20 @@
1
1
  import { useMergedRefs } from "../hooks/useMergedRefs.js";
2
2
  import { useId as useId$1 } from "../hooks/useId.js";
3
3
  import { warning } from "../utils/warning.js";
4
- import { useSlots } from "../hooks/useSlots.js";
5
4
  import { isResponsiveValue } from "../hooks/useResponsiveValue.js";
5
+ import { useSlots } from "../hooks/useSlots.js";
6
6
  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 valueNow => `Pane width ${valueNow} pixels`
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,19 +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) => {
50
+ const updateAriaValues = (handle, values) => {
56
51
  if (!handle) return;
57
- const format = formatValueText !== null && formatValueText !== void 0 ? formatValueText : defaultFormatValueText;
58
52
  if (values.min !== void 0) handle.setAttribute("aria-valuemin", String(values.min));
59
53
  if (values.max !== void 0) handle.setAttribute("aria-valuemax", String(values.max));
60
54
  if (values.current !== void 0) {
61
55
  handle.setAttribute("aria-valuenow", String(values.current));
62
- handle.setAttribute("aria-valuetext", format(values.current));
56
+ handle.setAttribute("aria-valuetext", `Pane width ${values.current} pixels`);
63
57
  }
64
58
  };
65
59
  const localStoragePersister = {
@@ -90,8 +84,8 @@ const localStoragePersister = {
90
84
  * - When `resizable` is `false` or `undefined`: Not resizable, no persistence
91
85
  */
92
86
  function usePaneWidth(t0) {
93
- const $ = c(44);
94
- 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;
95
89
  const constrainToViewport = t1 === void 0 ? false : t1;
96
90
  const isCustomWidth = isCustomWidthOptions(width);
97
91
  const minPaneWidth = isCustomWidth ? parseInt(width.min, 10) : minWidth;
@@ -224,20 +218,10 @@ function usePaneWidth(t0) {
224
218
  $[25] = t11;
225
219
  } else t11 = $[25];
226
220
  useIsomorphicLayoutEffect(t11);
227
- const formatValueTextRef = React.useRef(formatValueText);
228
221
  let t12;
229
- if ($[26] !== formatValueText) {
230
- t12 = () => {
231
- formatValueTextRef.current = formatValueText;
232
- };
233
- $[26] = formatValueText;
234
- $[27] = t12;
235
- } else t12 = $[27];
236
- useIsomorphicLayoutEffect(t12);
237
222
  let t13;
238
- let t14;
239
- if ($[28] !== constrainToViewport || $[29] !== contentWrapperRef || $[30] !== customMaxWidth || $[31] !== handleRef || $[32] !== minPaneWidth || $[33] !== paneRef || $[34] !== resizable) {
240
- t13 = () => {
223
+ if ($[26] !== constrainToViewport || $[27] !== contentWrapperRef || $[28] !== customMaxWidth || $[29] !== handleRef || $[30] !== minPaneWidth || $[31] !== paneRef || $[32] !== resizable) {
224
+ t12 = () => {
241
225
  var _paneRef$current3;
242
226
  if (!resizable) return;
243
227
  let lastViewportWidth = window.innerWidth;
@@ -258,7 +242,7 @@ function usePaneWidth(t0) {
258
242
  updateAriaValues(handleRef.current, {
259
243
  max: actualMax,
260
244
  current: currentWidthRef.current
261
- }, formatValueTextRef.current);
245
+ });
262
246
  if (actualMax !== maxPaneWidthRef.current || wasClamped) {
263
247
  maxPaneWidthRef.current = actualMax;
264
248
  startTransition(() => {
@@ -275,7 +259,7 @@ function usePaneWidth(t0) {
275
259
  min: minPaneWidth,
276
260
  max: initialMax,
277
261
  current: currentWidthRef.current
278
- }, formatValueTextRef.current);
262
+ });
279
263
  startTransition(() => {
280
264
  setMaxPaneWidth(initialMax);
281
265
  });
@@ -290,14 +274,14 @@ function usePaneWidth(t0) {
290
274
  if (isResizing) return;
291
275
  isResizing = true;
292
276
  (_paneRef$current4 = paneRef.current) === null || _paneRef$current4 === void 0 || _paneRef$current4.setAttribute("data-dragging", "true");
293
- 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");
294
278
  };
295
279
  const endResizeOptimizations = () => {
296
280
  var _paneRef$current5, _contentWrapperRef$cu2;
297
281
  if (!isResizing) return;
298
282
  isResizing = false;
299
283
  (_paneRef$current5 = paneRef.current) === null || _paneRef$current5 === void 0 || _paneRef$current5.removeAttribute("data-dragging");
300
- 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");
301
285
  };
302
286
  const handleResize = () => {
303
287
  startResizeOptimizations();
@@ -328,7 +312,7 @@ function usePaneWidth(t0) {
328
312
  window.removeEventListener("resize", handleResize);
329
313
  };
330
314
  };
331
- t14 = [
315
+ t13 = [
332
316
  resizable,
333
317
  customMaxWidth,
334
318
  constrainToViewport,
@@ -337,23 +321,23 @@ function usePaneWidth(t0) {
337
321
  handleRef,
338
322
  contentWrapperRef
339
323
  ];
340
- $[28] = constrainToViewport;
341
- $[29] = contentWrapperRef;
342
- $[30] = customMaxWidth;
343
- $[31] = handleRef;
344
- $[32] = minPaneWidth;
345
- $[33] = paneRef;
346
- $[34] = resizable;
347
- $[35] = t13;
348
- $[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;
349
333
  } else {
350
- t13 = $[35];
351
- t14 = $[36];
334
+ t12 = $[33];
335
+ t13 = $[34];
352
336
  }
353
- useIsomorphicLayoutEffect(t13, t14);
354
- let t15;
355
- if ($[37] !== currentWidth || $[38] !== getDefaultWidth || $[39] !== getMaxPaneWidth || $[40] !== maxPaneWidth || $[41] !== minPaneWidth || $[42] !== saveWidth) {
356
- t15 = {
337
+ useIsomorphicLayoutEffect(t12, t13);
338
+ let t14;
339
+ if ($[35] !== currentWidth || $[36] !== getDefaultWidth || $[37] !== getMaxPaneWidth || $[38] !== maxPaneWidth || $[39] !== minPaneWidth || $[40] !== saveWidth) {
340
+ t14 = {
357
341
  currentWidth,
358
342
  currentWidthRef,
359
343
  minPaneWidth,
@@ -362,15 +346,15 @@ function usePaneWidth(t0) {
362
346
  saveWidth,
363
347
  getDefaultWidth
364
348
  };
365
- $[37] = currentWidth;
366
- $[38] = getDefaultWidth;
367
- $[39] = getMaxPaneWidth;
368
- $[40] = maxPaneWidth;
369
- $[41] = minPaneWidth;
370
- $[42] = saveWidth;
371
- $[43] = t15;
372
- } else t15 = $[43];
373
- 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;
374
358
  }
375
359
  //#endregion
376
- 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";