Changelog

June 18, 2026 · View on GitHub

4.0.2 (Jun 18, 2026)

Fix (types): make <ResizableBox>'s default-backed props optional in the TypeScript definitions. Props now extends Partial<DefaultProps>, so consumers no longer have to pass props that already have defaults. Types only; runtime behavior is unchanged. (#264)

4.0.1 (May 26, 2026)

Locked aspect ratio drags now track the cursor via orthogonal projection onto the w = ratio·h line instead of snapping to whichever axis had the larger delta. Closes #222.
Convert the example app to TypeScript and fix the broken examples build (webpack entry pointed at examples/example.js after the 4.0.0 TS conversion). Affects the GitHub Pages demo / yarn dev only; the published package was unaffected. (#261)

This release converts the library from Flow to TypeScript and ships bundled type declarations. The runtime API and on-screen behavior are unchanged. The major version bump is to flag two things consumers may need to act on.

Breaking — types delivery

The library is now authored in TypeScript. Bundled type declarations ship in build/*.d.ts and are resolved via the "types" field in package.json. No @types/react-resizable install is needed; if you have one installed, remove it — TypeScript prefers the bundled types and the DefinitelyTyped package is no longer required.
The *.js.flow shims previously emitted by build.sh have been removed. Flow is no longer supported.

Flow users who still need types can copy the last Flow-annotated source from the 3.2.0 tag: react-grid-layout/react-resizable@db2e37e/lib (lib/Resizable.js, lib/ResizableBox.js, lib/propTypes.js, lib/utils.js). These files were the input to the published .js.flow artifacts in react-resizable@3.2.0 on npm; you can vendor them as a local Flow shim. They will not be updated, and any fix landing on master after 4.0.0 will not be backported into a Flow form.

Internal

✏ Chore: Migrate lib/ and __tests__/ from Flow to TypeScript (*.ts/*.tsx). Public runtime API unchanged.
✏ Chore: Replace @babel/preset-flow with @babel/preset-typescript; drop flow-bin, flow-typed/, .flowconfig.
✏ Chore: Add tsconfig.json (typecheck), tsconfig.build.json (declaration emit), tsconfig.test.json.
✏ Chore: build.sh now runs babel for the JS transform and tsc --emitDeclarationOnly for the .d.ts files.
✏ Chore: ESLint now uses @typescript-eslint/parser.
✏ Chore: CI now runs yarn lint, yarn typecheck, yarn test, and a build-artifact smoke test on every push and PR.
✏ Chore: Add an integration smoke test that imports the built CJS entry point and asserts the public surface (Resizable, ResizableBox).

3.2.0 (May 11, 2026)

🐛 Bugfix: Prevent resize drift caused by stale props between renders. The component now accumulates deltas from lastSize rather than this.props.width/height, and dimensionsChanged is compared against that same base so zero-delta callbacks are still suppressed correctly. #255
✏ Chore: Pin ESLint to ^9.x. ESLint 10 removes scopeManager.addGlobals, which @babel/eslint-parser 7.x still calls; the parser fix is only available in unreleased v8 RCs that require an unreleased Babel core v8.

3.1.3 (Jan 1, 2026)

✏ Chore: Add files whitelist to package.json to reduce package size and exclude unnecessary files.

3.1.2 (Jan 1, 2026)

🐛 Bugfix: Fix SSR crash where Element is not defined in Node.js environments. #251

3.1.1 (Dec 30, 2025)

🐛 Bugfix: Fix crash when Resizable child has a single child element (was not iterable). #219
🐛 Bugfix: Fix offsetParent propType from PropTypes.node to PropTypes.instanceOf(Element). #220
✏ Chore: Update GitHub Actions workflows to latest versions.
✏ Chore: Add version display to demo page.

3.1.0 (Dec 30, 2025)

🐛 Bugfix: Fix onResizeStop reporting stale size data due to React's batched state updates. The callback now uses the stored size from the last onResize call. #250
➕ Feature: React 18 support.
✏ Chore: Migrate test suite from Enzyme to React Testing Library. #249
✏ Chore: Update react-draggable to ^4.5.0.
✏ Chore: Update react-test-renderer to ^18.

3.0.5 (Mar 21, 2023)

🐛 Bugfix: Make width and height conditionally required if an axis is set. See #196
✏ Chore: Minor dependency upgrades.
✏ Chore: Fix documentation of onResize callback arity.

3.0.4 (Jun 15, 2021)

🐛 Bugfix: Fix incorrect fix for handleAxis on DOM elements. #175
✏ Chore:Upgrade dependencies.

3.0.3 (Jun 14, 2021)

🐛 Bugfix: Remove unknown prop handleAxis making it to DOM elements, causing a warning in dev.
✏ Chore: Rewrote lockAspectRatio logic to be more accurate and shorter.

3.0.2 (Jun 8, 2021)

✏ Chore: Add documentation for resize handles and fix a mistake where the handleAxis prop was not being passed to custom components.
- See Resize Handles

3.0.1 (May 10, 2021)

✏ Chore: Reduce package size through .npmignore.

3.0.0 (May 10, 2021)

Breaking

🐛 Bugfix: Fixed handling of the nodeRef that needs to be passed to <DraggableCore> to avoid use of ReactDOM. This means that vanilla usage of react-resizable no longer requires ReactDOM. No code changes are needed in the usual case, except:
- React >= 16.3 is required due to use of React.createRef(), and
- The handle prop now sends a ReactRef<HTMLElement> as its second argument and expects it to be used on your returned component.
  - If you do not attach the ref, you will receive the following error: "<DraggableCore> not mounted on DragStart!" This is due to the ref being present but not attached to any node.

1.11.1 (Mar 5, 2021)

✏ Chore: Added React 17 to peerDependencies.

1.11.0 (Sep 3, 2020)

⚠ Important Notice!
- React-Resizable 2.0.0 was published due to a breaking change in props handling. This change ended up actually completely breaking certain workflows, for the dubious benefit of making the code slightly simpler to add to. The breaking change has been reverted, 2.0.0 is now deprecated, and we will continue on the 1.x branch. Future breaking changes to react-resizable will upgrade the major version to 3.
➕ Feature: <ResizableBox> now takes a style prop which will be applied on the wrapping <div>. width and height in this prop are ignored.
🐛 Bugfix: remove unknown Prop handle from div children in Resizable React.cloneElement. #124
🐛 Bugfix: Fix top and left resizing jerkiness. Thanks @conor-kelleher. #136
✏ Chore: Improved test suite. Please contribute tests for your use cases if you have the time, I would really appreciate it! Thanks very much, @Danielecina
✏ Chore: Minor internal refactors and additional tests.
✏ Chore: Additional examples.

1.10.1 (Nov 25, 2019)

Note: 1.10.0 was a mis-publish.

➕ Feature: Add transformScale prop #115
🐛 Bugfix: Resolve getDerivedStateFromProps dev warning #117

1.9.0 (Oct 24, 2019)

🐛 Bugfix: Fix resize with north/south handles when lockAspectRatio=true #106
✏ Chore: Remove deprecated React 16.9 lifecycle methods (componentWillReceiveProps) (https://github.com/STRML/react-resizable/pull/112/commits/541dee69b8e45d91a533855609472b481634edee)
✏ Chore: Upgrade to babel 7
✏ Chore: Remove unused state inside <Draggable>. This has not been needed for quite some time, fixes some bugs and improves performance.

1.8.0 (May 15, 2019)

➕ Feature: Added support for custom resize handles #79
➕ Feature: Added support for resize handles on all corners #191

1.7.5 (Sep 26, 2017)

✏ Chore: Support for React 16 (no changes required, updated peerDependencies)
✏ Chore: Minor dep updates.

1.7.4 (Sep 5, 2017)

✏ Chore: Minor Flow & dependency updates.

1.7.3 (Aug 31, 2017)

🐛 Bugfix: React deprecation warnings from import *
- https://github.com/facebook/react/issues/10583

1.7.2 (Aug 21, 2017)

✏ Chore: Pkg: Add react-draggable@3.0.0 to version range.
- This package is compatible with both @2 and @3 versions.

1.7.1 (May 23, 2017)

🐛 Bugfix: Some flow types were improperly specified.

1.7.0 (May 1, 2017)

⚠ Deprecation: React.PropTypes now deprecated in React 15.5, moved to prop-types package
✏ Chore: Update devDeps, upgrade to webpack 2
✏ Chore: Remove babel stage-1 and transform-flow-comments, bring in only selected plugins, makes for leaner dev/build.