Update dependency react-resizable-panels to v4

[renovate]

This PR contains the following updates:

Package	Change	Age	Confidence
react-resizable-panels (source)	^3.0.0 → ^4.0.0

---

Release Notes

bvaughn/react-resizable-panels (react-resizable-panels)

v4.12.3

Compare Source

• 730: Guard CSSStyleSheet construction to avoid throwing in unsupported environments (@​leo-yang-qiong)
• 736: Bugfix: Derived Panel constraints equality check
• 732: Bugfix: Prevent orphaned groups in "pointerup" edge case (@​waterWang)

v4.12.2

Compare Source

• 726: Updated inline documentation to clarify size units.

v4.12.1

Compare Source

• 723: Bug fix for context menu event (right click) occurring while pointer-resize is active

v4.12.0

Compare Source

• 716): Meta info available to onLayoutChanged callback signalling whether resize event was triggered by direct user input (keyboard or mouse)
• useDefaultLayout hook supports onlySaveAfterUserInteractions option to only save layouts when directly triggered by user interactions.

v4.11.2

Compare Source

• 719): Bug fix: Calculate rem-based sizes relative to owner document (not body)

v4.11.1

Compare Source

• 715): Edge case SSR bug fix for panels with defaultSize={0}

v4.11.0

Compare Source

• 712: Separator supports :focus-visible pseudo-class
• 703: Fix: edge case scenarios when collapsing the last panel
• 711: Improve legacy browser support wrt global stylesheets

v4.10.0

Compare Source

• 705: Add data-separator="focus" state for Separator elements for more consistent custom CSS styles.

v4.9.0

Compare Source

• 702: Add disableDoubleClick prop to Separator to enable turning off the double-click size reset behavior.

v4.8.0

Compare Source

• 699: useDefaultLayout hook automatically migrates legacy layouts to version 4 format; see issue 605 for details on how this works.

v4.7.6

Compare Source

• 698: Replace Panel aria-disabled attribute with data-disabled

v4.7.5

Compare Source

• 696: Improved server rendering support for defaultSize prop

v4.7.4

Compare Source

• 689: Fix edge case bug with pointer event capture

v4.7.3

Compare Source

• 690: Imperative Panel API supports non-percentage sizes

v4.7.2

Compare Source

• 683: Don't scroll separator when setting focus

v4.7.1

Compare Source

• 678: Change default overflow styles to support shadows

v4.7.0

Compare Source

• 677: Add groupResizeBehavior prop to Panel, enabling panels to retain their current size (pixels) size when the parent Group is resized.

v4.6.5

Compare Source

• 670: Check for undefined adoptedStyleSheets (to better support environments like jsdom)
• 671: Bug-fix: Update in-memory layout cache when group is resized by double-clicking on a separator

v4.6.4

Compare Source

• 664, 665: Resize actions sometimes "jump" on touch devices

v4.6.3

Compare Source

• Fixed a problem with project logo not displaying correctly in the README for the Firefox browser.

v4.6.2

Compare Source

• 660: Group guards against layouts with mis-ordered Panel id keys

v4.6.1

Compare Source

• 658: Imperative Panel and Group APIs ignored disabled status when resizing panels; this is an explicit override of the disabled state and is required to support conditionally disabled groups.
• 658: Separator component does not set a cursor: not-allowed style if the parent Group has cursors disabled.

v4.6.0

Compare Source

• 657: Allow Panel and Separator components to be disabled

v4.5.9

Compare Source

• 649: Optimization: Replace useForceUpdate with useSyncExternalStore to avoid side effect of swallowing "click" events in certain cases
• 654: Bugfix Imperative Group method setLayout persists layout to in-memory cache
• 652: Re-enable collapsible panel bugfix after fixing another reported issue

v4.5.8

Compare Source

• 651: Disabled the change to collapsible panel behavior that was originally made in 635 due to another reported regression

v4.5.7

Compare Source

• 646: Re-enable the collapsible Panel from 4.5.3 that was disabled in 4.5.6
• 648: Bugfix: Reset Separator hover-state on Document "pointerout"

v4.5.6

Compare Source

• 644: Disabled the change to collapsible panel behavior that was originally made in 635

v4.5.5

Compare Source

• 641: Removed aria-orientation role from root Group element as this was invalid according to the ARIA spec; (for more information see the discussion on issue #​640)
• 642: Bugfix: Fix collapsible Panel regression introduced in 4.5.3

v4.5.4

Compare Source

• 638: Panel avoids unnecessary re-renders in response to mouse-hover state.

v4.5.3

Compare Source

• 635: Expand pre-collapsed panels if drug past the halfway point for more consistent collapse/expand behavior.
• 631: Bugfix: Panels set max-width and max-height to 100% to fix potential CSS overflow bug.

v4.5.2

Compare Source

• 626: Decrease default hit target size for Separator and Panel edges; make configurable via a new Group prop.

v4.5.1

Compare Source

• 624: Bugfix: Fallback to alternate CSS cursor styles for Safari

Safari	Chrome, Firefox
grab	move
col-resize	ew-resize
row-resize	ns-resize

v4.5.0

Compare Source

• 616: Replace Separator and Panel edge hit-area padding with a minimum size threshold based on Apple's user interface guidelines. Separators that are large enough will no longer be padded; separators that are too small (or panels without separators) will more or less function like before. This should not have much of a user-facing impact other than an increase in the click target area. (Previously I was not padding enough, as per Apple's guidelines.)
• 615, 620: Double-clicking on a Separator resets its associated Panel to its default-size (see video below); double-click will have no impact on panels without default sizes
• 622: Bugfix: Panels within vertical groups are now properly sized in Safari
• 618: Bugfix: Don't override adoptedStyleSheets

Demo of double-clicking on a separator:

dbl-click.mov

v4.4.2

Compare Source

• 610: Fix calculated cursor style when "pointermove" event is has low-precision/rounded clientX and clientY values

v4.4.1

Compare Source

• 600: Bugfix: Collapsible Panel should treat defaultSize={0} as collapsed on mount

v4.4.0

Compare Source

• 599: Add new onLayoutChanged prop to Group.

For layout changes caused by pointer events, this method is not called until the pointer has been released. This callback should be used if you're doing something like saving a layout as it is called less frequently than the previous approach.

The useDefaultLayout hook has also been updated to use this callback (though it will continue to support the old callback as well, with a @deprecation tag).

v4.3.3

Compare Source

• 595: Don't call event.preventDefault() on "pointerup" unless a handle was actively dragged

[!NOTE]
This change also fixes a text selection bug that impacted Windows users (#​574)

v4.3.2

Compare Source

• Moved flex-grow Panel style to an inline value instead of a CSS variable defined on the parent Group to improve rendering performance. (This significantly reduces the negative impact from forced-reflow)

v4.3.1

Compare Source

• 588: Replace "unset" styles with safer override values
• 589: Use capture phase for "pointerdown" and "pointerup" events; this is necessary for compatibility with certain UI libraries like Blueprint JS
• 590: Read Panel pixel size using offsetWidth/offsetHeight rather than inlineSize to avoid an edgecase bug with ResizeObserver

v4.3.0

Compare Source

• 583: Group component now sets default width, height, and overflow styles; (both can be overridden using the style property)
• 582: Drag interactions only call event.preventDefault for the primary button
• Refine TS types for useGroupRef and usePanelRef to include | null to increase compatibility with older React versions
• Update TSDoc comments for Panel and Separator components

v4.2.2

Compare Source

• useDefaultLayout hook initializes storage param to localStorage if undefined.
• Fix ambiguous type for Panel prop onResize that impacted certain TypeScript versions.

v4.2.1

Compare Source

• 2a6b03f: Add displayName property to Group, Panel, and Separator components for better debugging experience.
• 577: Group handles newly registered Panels + Separators during mount so that user code can safely call imperative APIs earlier

v4.2.0

Compare Source

• 573: Add prevPanelSize param to onResize callback to help simplify collapse/expand detection.

v4.1.1

Compare Source

• 571: Update TS types to better reflect that Separator attributes role and tabIndex cannot be overridden using props.

v4.1.0

Compare Source

• 567: useDefaultLayout hook supports saving and restoring multiple Panel layouts
• 568: Fix race in useGroupRef and usePanelRef hooks

v4.0.16

Compare Source

• 563: Panel expand() API should restore pre-collapse size
• 564: Add guard for unexpected defaultView value seemingly returned by some dev environments

v4.0.15

Compare Source

• 556: Ignore defaultLayout when keys don't match Panel ids

v4.0.14

Compare Source

• 555: Allow resizable panels to be rendered into a different Window (e.g. popup or frame) by accessing globals through element.ownerDocument.defaultView

v4.0.13

Compare Source

• useDefaultLayout: Deprecated groupId param in favor of id to avoid confusion; (there is no actual requirement for the Group to have a matching id)

v4.0.12

Compare Source

• 552: useDefaultLayout now debounces calls to storage.setItem by 150ms

// To opt out of this change
useDefaultLayout({
  debounceSaveMs: 0,
  groupId: "test-group-id",
  storage: localStorage,
})

[!NOTE]
Some may consider this a breaking change, considering the default value is 150ms rather than 0ms. I think in practice this should only impact unit tests which can be easily fixed by overriding the default (as shown above) or by using fake timers.

Changes like this are often judgement calls, but I think on balance it's better to correct my initial oversight of not debouncing this by default.

v4.0.11

Compare Source

• 8604491: Fix edge case bug with panel constraints not being properly invalidated after resize

v4.0.10

Compare Source

• #​551: Expand fixed-size element support

v4.0.9

Compare Source

• #​542: Clicks on higher z-index elements (e.g. modals) should not trigger separators behind them
• #​547: Don't re-mount Group when defaultLayout or disableCursor props change
• #​548: Bugfix: Gracefully handle Panel id changes
• #​549: Improve DevX when Group within hidden DOM subtree; defer layout-change events

v4.0.8

Compare Source

• #​541: Don't set invalid layouts when Group is hidden or has a width/height of 0
• 40d4356: Gracefully handle invalid defaultLayout value

v4.0.7

Compare Source

• f07bf00: Reset pointer-event styles after "pointerup" event

v4.0.6

Compare Source

• 0796644: Account for Flex gap when calculating pointer-move delta %

v4.0.5

Compare Source

• #​535: Updated docs to make size and layout formats clearer

v4.0.4

Compare Source

• #​534: Set focus on Separator on "pointerdown"
• e08fe42: Improve iOS/Safari resize UX

v4.0.3

Compare Source

• Fixed TS type for defaultLayout value returned from useDefaultLayout

v4.0.2

Compare Source

• Export GroupImperativeHandle and PanelImperativeHandle types.

v4.0.1

Compare Source

• 563: Panel expand() API should restore pre-collapse size
• 564: Add guard for unexpected defaultView value seemingly returned by some dev environments

v4.0.0

Compare Source

Version 4 of react-resizable-panels offers more flexible size constraints– supporting units as pixels, percentages, REMs/EMs, and more. Support for server-rendering (including Server Components) has also been expanded.

Migrating from version 3 to 4

Refer to the docs for a complete list of props and API methods. Below are some examples of migrating from version 3 to 4, but first a couple of potential questions:

Q: Why'd you rename <component> or <prop>?

A: The most likely reason is that I think the new name more closely aligns with web standards like WAI-ARIA and CSS. For example, the PanelResizeHandle component was renamed to Separator to better align with the ARIA "separator" role and the direction prop was renamed to orientation to better align with the ARIA orientation attribute .

Q: Why'd you remove support for <feature>?

A: Probably because it wasn't used widely enough to justify the complexity required to maintain it. If it turns out that I'm mistaken, features can always be (re)added but it's more difficult to remove them.

Q: Were the onCollapse and onExpand event handlers removed?

A: Yes. Use the onResize event handler instead:

onResize={(nextSize, id, prevSize) => {
  if (prevSize !== undefined) {
    const wasCollapsed = prevSize.asPercentage !== 0;
    const isCollapsed = nextSize.asPercentage === 0;
    if (isCollapsed !== wasCollapsed) {
      // Panel was collapsed or expanded
    }
  }
}}

Basic usage example

// Version 3

import { PanelGroup, Panel, PanelResizeHandle } from "react-resizable-panels";

<PanelGroup direction="horizontal">
  <Panel defaultSize={30} minSize={20}>left</Panel>
  <PanelResizeHandle />
  <Panel defaultSize={30} minSize={20}>right</Panel>
</PanelGroup>

// Version 4

import { Group, Panel, Separator } from "react-resizable-panels";

<Group orientation="horizontal">
  <Panel defaultSize="30%" minSize="20%">left</Panel>
  <Separator />
  <Panel defaultSize="30%" minSize="20%">right</Panel>
</Group>

Persistent layouts using localStorage

// Version 3

import { PanelGroup, Panel, PanelResizeHandle } from "react-resizable-panels";

<PanelGroup autoSaveId="unique-group-id" direction="horizontal">
  <Panel>left</Panel>
  <PanelResizeHandle />
  <Panel>right</Panel>
</PanelGroup>

// Version 4

import { Group, Panel, Separator, useDefaultLayout } from "react-resizable-panels";

const { defaultLayout, onLayoutChange } = useDefaultLayout({
  groupId: "unique-group-id",
  storage: localStorage
});

<Group defaultLayout={defaultLayout} onLayoutChange={onLayoutChange}>
  <Panel>left</Panel>
  <Separator />
  <Panel>right</Panel>
</Group>

[!NOTE]
Refer to the docs for examples of persistent layouts with server rendering and server components.

Conditional panels

// Version 3

import { PanelGroup, Panel, PanelResizeHandle } from "react-resizable-panels";

<PanelGroup autoSaveId="unique-group-id" direction="horizontal">
   {showLeftPanel && (
     <>
       <Panel id="left" order={1}>left</Panel>
       <PanelResizeHandle />
     </>
   )}
   <Panel id="center" order={2}>center</Panel>
   {showRightPanel && (
     <>
       <PanelResizeHandle />
       <Panel id="right" order={3}>right</Panel>
     </>
   )}
</PanelGroup>

// Version 4

import { Group, Panel, Separator } from "react-resizable-panels";

<Group>
  {showLeftPanel && (
    <>
      <Panel id="left">left</Panel>
      <Separator />
    </>
  )}
  <Panel id="center">center</Panel>
  {showRightPanel && (
    <>
      <Separator />
      <Panel id="right">right</Panel>
    </>
  )}
</Group>

Imperative APIs

// Version 3

import { PanelGroup, Panel, PanelResizeHandle } from "react-resizable-panels";
import type { ImperativePanelGroupHandle, ImperativePanelHandle }from "react-resizable-panels";

 const panelRef = useRef<ImperativePanelHandle>(null);
 const panelGroupRef = useRef<ImperativePanelGroupHandle>(null);

<PanelGroup direction="horizontal" ref={panelGroupRef}>
  <Panel ref={panelRef}>left</Panel>
  <PanelResizeHandle />
  <Panel>right</Panel>
</PanelGroup>

// Version 4

import { Group, Panel, Separator, useGroupRef, usePanelRef } from "react-resizable-panels";

const groupRef = useGroupRef();
const panelRef = usePanelRef();

<Group groupRef={groupRef} orientation="horizontal">
  <Panel panelRef={panelRef}>left</Panel>
  <Separator />
  <Panel>right</Panel>
</Group>

Disabling custom cursors

// Version 3

import { disableGlobalCursorStyles } from "react-resizable-panels";

disableGlobalCursorStyles();

// Version 4

import { Group, Panel, Separator } from "react-resizable-panels";

<Group disableCursor />

---

Configuration

📅 Schedule: (UTC)

• Branch creation
  • At any time (no schedule defined)
• Automerge
  • At any time (no schedule defined)

🚦 Automerge: Enabled.

♻ Rebasing: Whenever PR is behind base branch, or you tick the rebase/retry checkbox.

🔕 Ignore: Close this PR and you won't be reminded about this update again.

---

• If you want to rebase/retry this PR, check this box

---

This PR was generated by Mend Renovate. View the repository job log.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
full-stack-skeleton	Error		Aug 18, 2026 4:55pm

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 36.32%. Comparing base (fc5c96b) to head (2e641fe).

Additional details and impacted files

@@           Coverage Diff           @@
##             main     #361   +/-   ##
=======================================
  Coverage   36.32%   36.32%           
=======================================
  Files          25       25           
  Lines         647      647           
=======================================
  Hits          235      235           
  Misses        370      370           
  Partials       42       42           

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 09022ce. Configure here.}

[cursor]

Major version bump without migrating breaking API changes

High Severity

Bumping react-resizable-panels from v3 to v4 without updating consuming code will break the app. In v4, PanelGroup was renamed to Group and PanelResizeHandle to Separator, so resizable.tsx references non-existent exports. Additionally, sidebar.tsx uses removed/renamed props: direction (now orientation), onLayout (now onLayoutChange), onCollapse/onExpand (removed), and numeric size values (now require strings like "30%"). CSS selectors using data-[panel-group-direction=...] also changed to aria-[orientation=...].

 

^{Reviewed by Cursor Bugbot for commit 09022ce. Configure here.}