• All packages now have verified ESM support
• Packages expose CJS/ESM surface are via pkg.exports

This release uses output from swc using the 'es2017' target instead of using output from 'tsc' using the 'ESNext' target.

This release fixes issues with the ESM-only structure of v15.0.0. All packages are now in their prior CommonJS/ESM format.

Major Changes

• The react-dnd packages are now published as ESM-only with type: module. See this FAQ by sindresorhus: https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c

• The Decorators API has been removed and fully replaced by the Hooks API. The Decorators API was difficult to develop & type correctly, and this improves its maintainability.

• The builds no longer use babel & preset-env. The library is transpiled using SWC into the "es2017" target, which assumes async/await is available. This should reduce bundle sizes by removing polyfills and support-code which may be unnecessary in your target.

Bugfixes

• Improve data-transfer acquisition from File inputs (#3262)
• Don't set the 'draggable' attribute unless canDrag is true (#3187)
• Improve typings of DropTargetMonitor, DragLayerMonitor (#3300, #3341)

Patch

Update internal hook useDragType() to align with updated typings. Check 14.0.0 release for API changes

This release addresses a handful of nagging liveness and ergonomic issues with the hooks API.

The liveness issues affect all hooks, and were discovered on deeper inspection of certain stress tests in the documentation. The internal useCollector() hook is used to collect props from the DnD system when things change. Prior to this update, we subscribed to updates from the DnD monitor to trigger prop collection. However, state on the react side was only accounted for on the first render. This release improves that liveness by collecting props whenever react state changes.

The ergonomics of the useDrag have been refactored. In short:

• spec.type is required
• spec.item can be a function or static object.
• The function version of spec.item replaces spec.begin

Since the release of the hooks API, we packed type under spec.item. However, this led to nonintuitive situations where an item field was required to be specified even though items are created in the begin method.

Additionally, in the original React-DnD design, beginDrag() was optional and the type of the draggables had to be defined. If no explicit DragObject was created, an implicit object was created by the system..

The change we've made here decouples type from item, and collapses begin into item.

// Pre-v14
useDrag({
   // item defined here to get a type
   item: { type: BOX } },
   // ...but the actual item is created here
   begin: () => ({ id })
})

// v14
useDrag({
   type: BOX,
   item: () => ({id})
})

e.g. useDrag({ item: { type: BOX }}) => useDrag({ type: 'BOX' })

We've also added the ability to cancel drag operations in the hooks API by returning null from begin.

// new API
useDrag({
  type: BOX,
  item: () => shouldNotDrag ? null : {id},
})

Patch

Update .npmignore files so that tsbuildinfo files are not included in publication. This reduces package sizes.

Minor

• Add getDecoratedComponent() method to wrapInTestContext imperative API. (#2488)

Patch

• Improve typings of wrapInTestContext(#2486)
• Eliminate module cycles in react-dnd (#2491)

Breaking Changes

Update Backends to use named exports for BackendFactory functions instead of default exports.

e.g. import HTML5Backend from 'react-dnd-html5-backend 👇 import { HTML5Backend } from 'react-dnd-html5-backend

In general, throughout the app we've minimized the usage of default exports as well. They interfere with type correctness and screw with UMD builds (e.g. having to scrape a .default property off of a UMD global).

Minor Changes

• Expose internal hook useDragDropManager at top level
• Add profiling function to backend interface
• Make handler functions public on backends

Patch Changes

• Correct memory leak in drag previews (#2423)
• Improve and correct typings

Patch

dnd-core: Use updated version @react-dnd/asap with browser variant support, this allows us to drop syntheticDefaultImports in dnd-core.

Patch

Fix UMD builds - our fork of ASAP was being brought in with node-specific code, breaking UMD builds. Using the canonical version of ASAP until we update our fork (#1684 )

Major

The package.type=module setting has been removed. This proved to be a major pain point for users, and was technically problematic at this time. We will eventually ship with package.type=module when NodeJS 12 drops out of maintenance and all of our dependencies ship ESM. (#1683)

Patch

The touch-backend has been updated to work-around iOS 13.x eventing issues (#1631) (thanks @zhusee2!)

Patch

• Remove syntheticDefaultImport usage of react in react-dnd (#1629) thanks @sandersn . Fully removing syntheticDefaultImport from react-dnd is a WIP. We will need pure ESM versions of asap and hoist-non-react-statics. Ideally invariant and shallowequal would have ESM builds available as well, but there are forked ESM variants of these packages.

Minor Changes

• Declare packages side-effect free for tree-shaking (#1577), thanks @maclockard
• HTML5Backend: Make file metadata available on dragstart event (#1610), thanks @LeopoldLerch
• TestBackend: Add DragDropManager accessor to TestBackend (#1564), thanks @ezr-ondrej

Patch Changes

• Improve UMD builds to conform to browserslist support target, add some basic UMD verification tests

Minor

• UMD builds are now shipped with the react-dnd, react-dnd-html5-backend, and react-dnd-touch-backend packages in addition to react-dnd-umd-builds

Patch

• Added refcounting to the DndProvider component. If the DndProvider is unmounted, the manager instance will be cleared out of the global context.

Patch

• (Typings) - Add getTargetIds to DragSourceMonitor interface declaration (#1478)
• Replace for..of statements with other looping semantics for older browser support (#1428
• Add an isomorphic useLayoutEffect implementation for SSR (#1497)
• Correct DragPreview connection logic for chainable connector functions (#1500)

Patch

• Fixed some issues in react-dnd where named exports of interfaces were causing JS breakage (#1462)
• Added a cra-test package to verify that react-dnd can be used in the context of create-react-app by default (#1462)

Libraries Affected

All libraries

Minor

• Add CJS builds to the core packages in order to facilitate better testing. (#1455, #1460)

Patch

• Correct some issues with interface imports/exports using Babel's TS transpilation (#1459)

Libraries

All Libraries Affected

Minor

The react-dnd toolchain has been changed up from using TypeScript to using Babel. This allows us to use a ‘browserlist’ query instead of a coarse tsc target when defining what JS features to ship with. The public API has not changed at all, but there could be underlying changes if your code is implementation dependent.

Major

• Remove DragDropContext decorator. (#1439)
• Update BackendFactory function in dnd-core to accept a configuration object. (#1439)
• Construct the Backend outside of the DragDropManagerImpl class (#1439)

Minor

• Add react-dnd-touch-backend library
• Update DndProvider to accept an 'options' prop with backend configuration
• Correct state staleness issues when using hooks-based API (#1429, #1437)

Patch

• Prevent starting a react-dnd drag operation if a dragstart event has it's default-prevented (#1426)

Bugfixes

• The DndProvider component had been throwing errors if it was rendered multiple times because of the implicit singleton invariant of the HTML5Backend. To correct this, if a backend factory is passed to the DndProvider using <DndProvider backend={HTML5Backend}/>, it will only create a singleton instance of the DndContext per global context. This means that to create a second backend for an iframe, one needs to use: <DndProvider backend={HTML5Backend} context={iframeWindow} />.

Patch

The CommonJS libraries had runtime issues due to some @ts-ignore statements on non-typed module imports. Those have been removed from the core libraries.

Major

• ES Modules. The target output of TypeScript has been changed to esnext with esnext modules. This speeds up and simplifies our build process, and targets the future with modern web standards. The UMD builds have been moved to a new 'react-dnd-umd-builds' package. CommonJS builds have been removed.
• Polyfills: Legacy polyfills have been removed. At this point, that's just String.endsWith
• DragDropContextProvider:
  • ~DragDragDropContextProvider~ => DndProvider
  • ~DragDropContext, DragDropContextConsumer, and DragDropContextProvider~ => DndContext.

The package.json files for the react-dnd libraries contained a "module" field which was used to identify where the ES Module roots began. These fields were added with the intent of supporting CommonJS module loading (the de-facto NodeJS module system) simultaneously with the ES Module loading system (the emerging standard for JavaScript modules).

Unfortunately this change resulted in a lot of build headaches for users then their module bundlers started defaulting to using the ES Module roots.

This release reverts that change and leaves the v7 branch of React-Dnd as primarily using CommonJS. ES Module builds are still available under the esm/ folders, but it is up to users to use them at their own discretion.

In v8, ES Modules are used as the default module system. CommonJS-based packages are still available however in react-dnd-cjs, and react-dnd-html5-backend-cjs

• Release the Hooks API (#1381) (a5b0242), closes #1381
• v7.6.0 (c08efd5)
• chore: replace tslint with eslint (#1380) (fc44aee), closes #1380
• fix: add memoization to hooks example to improve performance (497afda)
• fix: documentation fixes (6630373)
• fix: improve performance in the sortable stress test example (a1584d9)

Minor

• Allow DragDropContextProvider to accept a manager prop (#1362)

Patch

• Improve performance of backend subscriptions (#1355, related)
• Handle cases where a DragDropRegistry may return an undefined dropResult. (#1281)
• Correct function-state issues with hooks-based APIs.

• Replace lodash with custom functions
• Correct issue where getDecoratedComponentInstance() would throw invariant errors when used internally
• Add String.endsWith polyfill for semver compat
• Improve decorator API typings (#1306)

Minor

• Add a third argument to the collector functions in DragSource and DropTarget that includes the props of the current component. (e.g. collect(connect, monitor, props)
• Connect functions can now accept Ref objects. (e.g. connectDragSource(ref))
• Add a new DragPreviewImage renderless component that wires up Drag Preview images.
• Improve decorated types to include as much of the original types as we can. Our typing strategy for this followed the same pattern that react-redux uses.
• Add react-dnd-test-utils package, which exposes the wrapInTestContext utility function

Patch

• Throw invariant errors when components are rendered outside of a DragDropContext.
• Hooks API updates

• [patch] - #1249 - Check for uninitialized source/target identifiers

• [patch] - #1250 - Use ES5 target for CommonJs builds.

• [minor] - #1251, #1244, #1173 - Experimental Hooks API

This release includes an experimental hook-based React-Dnd API. Documentation for this feature still needs to be created, but the three public facing hooks are: useDragSource, useDropTarget, and useDragLayer.

The hooks API will is currently experimental, and breaking changes of hooks may occur in non-major versions.

• useDragSource:

const ref = useRef(); // pass in a ref instead of connectDragSource()
const { isDragging } = useDragSource(ref, ItemTypes.KNIGHT, {
    beginDrag(monitor){ /* */ },
    // collect function defined in specification
    collect: monitor => ({
        isDragging: monitor.isDragging(),
    }),
})
return <div ref={ref}>...</div>

• useDropTarget:

const ref = useRef(); // pass in a ref instead of connectDropTarget()
const { isOver, canDrop } = useDropTarget(ref, ItemTypes.KNIGHT, {
    canDrop: () => canMoveKnight(props.x, props.y),
    drop: () => moveKnight(props.x, props.y),
    // collect function defined in specification
    collect: monitor => ({
        isOver: monitor.isOver(),
        canDrop: monitor.canDrop(),
    }),
})

return <div ref={ref}>...</div>

• useDragLayer

const props = useDragLayer(monitor => ({
    item: monitor.getItem(),
    itemType: monitor.getItemType(),
    initialOffset: monitor.getInitialSourceClientOffset(),
    currentOffset: monitor.getSourceClientOffset(),
    isDragging: monitor.isDragging(),
}))

• Add EsModule builds in addition to CommonJS builds (#1205)
• Remove the dropEffect=none setting on native DnD events (#1240)
• Expose dataTransfer.items for files (#1241)
• Correct child mounting order (#1220)
• Refresh Dependencies (#1243)
• Eliminate errors when using Ref objects (#1242)

License Update The library was originally licensed as MIT, but during the transition to a Monorepo, the license was set to BSD 3-Clause. This release corrects that error and restores the MIT license across all packages.

• Add 'debugMode' option to DndContext (#1190) (572955b), closes #1190
• fix typo in Tutorial (#1169) (46fd5ae), closes #1169
• Fixed the typo in functional component example link (#1180) (e4722ff), closes #1180
• Update naive.md (#1168) (3a5e0d4), closes #1168
• Update README.md (c0e6cf5)
• v7.0.0 (f294f68)
• fix: clientOffset and initialClientOffset are null in canDrag #1175 (#1176) (8718ae5), closes #1175 #1176
• fix: make DecoratedComponent as static property (#1177) (#1185) (95d90b3), closes #1177 #1185
• fix: remove initClientOffset action - merge it into initCoords (#1191) (6b58b8b), closes #1191
• docs: fix examples page URL (#1181) (#1183) (6430c45), closes #1181 #1183 #1181
• docs: fix link in root page (#1189) (ffda6c7), closes #1189
• build: upgrade npm-run-all for security (#1186) (c025cd7), closes #1186
• ci: upgrade har-vlidator to fix CI corrupt (#1184) (478f5b5), closes #1184
• chore: add stalebot config (6f451ee)

• [Major] - Improve typings for DragSource, DropTarget and DragLayer decorator functions. This required dropping support of TypeScript decorators in our examples, and may cause breaking changes for TypeScript users. The core issue is that Typescript decorator results need to be assignable to the incoming type. We want to be able to explicitly remove DnD-collected props from the resultant component type. Our old way of dealing with this was to make DnD-collected props optional in our props interfaces, which resulted in unnecessary null-checks in render, and a leaky client interface. (#1134)
• [Patch] - In the beginDrag action, since publishSource defaults to true when no argument is passed, use a default initializer when an object is entered that does not specify it (#1161)
• [Patch] - Replace use of autobind-decorator library with class bind semantics, which eliminates that dependency.
• [Patch] - Fire off an initCoords event before dragStart to improve client offset-calculation logic.(#1082)
• [Patch] - Update the EnterLeaveCounter in HTML5Backend to use the configured window object. This corrects behavior in iframe environments (#1137)
• [Patch] - Correct an error where an incorrect dropEffect was being used when in a scrolling container (#1131)
• [Patch] - Library upgrades, documentation updates

Remove the esModuleInterop setting from our tsconfig.json, this corrects typings for users who were not using esModuleInterop mode, and improves the bundled library sizes.

• UMD builds were missing from react-dnd and react-dnd-html5-backend in 4.0.2.
• Remove tsconfig.json from packages to prevent errors in typescript clients (#1066)
• Remove sourcemap files from typescript compilation to prevent issues with clients using sourcemap-loader (#1060)

Breaking Changes:

• Using new React Context API. React Peer dependency has been pinned at >= 16.3., which is when that API was released.
• Dictionary objects have been replaced with ES6 Maps, shims may be required for older and non-compliant browsers.

Other Changes:

• Remove dependency on @types/redux, since redux provides its own typings
• React 17 prep - remove usage of lifecycle methods that are being deprecated
• Replace all require()s with imports, which was causing grief for some users. This resulted in some culling of dependencies.
• Remove isClassComponent check from decorateHandler. This check was not working correctly in certain situations, and resulted in silent failures. By just setting the ref directly, React will emit warnings about not being able to ref SFCs, which is more useful.

This patch release changes the typescript transpilation from es2015 to es5. This should resolve some issues users had reported due to es2015 syntax.

3.0.0 was intended as a prerelease version (apologies for not including a -beta tag). This is the "final" 3.0 release.

The typings here have been updated to align more closely with the DefinitelyTyped react-dnd typings. They are much more accurate than in the prerelease.

Edit: please don't use this version, we discovered a critical issue with the documentation site.

In this release we've migrated the codebase to Typescript. The published libraries now have their own embedded typings definitions. It will remain an ongoing effort to improve the typings in our code.

Breaking Changes:

• Removed the dependency on window from react-dnd. This should allow us to experiment with using react-dnd react-native. To support this, the DragDropContextProvider has been totally changed up. It now accepts a context object parameter that is backend-implementation dependent. Currently the HTML5Backend will need context to be { window }
• The DragDropContext component will no longer try to unpack ES6 modules. The difference between CommonJS and ES6 module formats is well known by now.
• The dnd-core`s redux actions are now FSA-compliant.
• dnd-core Redux has been upgraded to 4.x

• New Feature: Passing Derivative Props to DragLayer to minimize render cycles (#979).
• HTML5 Backend Firefox Fixes
  • #970 - Removes some hacks that are no longer necessary.
  • #928 - Fixes a Firefox error where react-dnd was not functioning due to event firing sequences.
• Community documentation updates
• Use Yarn workspaces
• Move documentation into a sub-package

• Fixes an issue in the DragDropContextProvider where the backend was created on every render (#859) - thanks @WearyMonkey
• Avoids using refs with StatelessFunctionalComponents (#898) - thanks @knowbody

• Correct SPDX license fields in the packages. The LICENSE files have always been BSD-3-Clause, but the license field was set to "MIT".
• The peerDependency on "react" is set to "*" in the react-dnd package, but 16.x is installed for development.
• This doesn't affect the packages, but the documentation was using some deprecated react/lib modules, and the react-hot-loader needed to be updated.

• Add React@16 to peer-dependencies to react-dnd
• Remove react-dnd peer-dependency from HTML5Backend
• Improve iframe detection

• Correct SSR bug due to addEventListener and removeEventListener methods not being available in server-mode (#813)
• Documentation Corrections and Updates
• Replace Yarn package manager with NPM 5.
• Upgrade React to 15.6.1
• Use babel-preset-env instead of babel-preset-latest

• (#639) - Correct Example Rendering with Firefox (#684) (11e3df6), closes #639 #684
• (#645) - Use 'typeof window' to check for window existence in HTML5 B… (#646) (b3807e0), closes #645 #646 #645 #645 #645
• 2.2.0 (#642) (643992a), closes #642
• Add an invariant(..) validation before accessing the decorated instance (89763d1)
• Add bundling, babel scripts to package.json (de5285f)
• Add clean script, update 'npm test' (9eea7db)
• Add dependency badges (400c47c)
• Add gzip size badge (#692) (0933e3f), closes #692
• Add HTML5 backend gzip size (#697) (551b80e), closes #697
• Add License Field to Sub-Packages (#670) (6d7dc97), closes #670 #667
• Add myself to contributor list (0a5e37e)
• Add Reactiflux Discord Link (#663) (4f12fb0), closes #663
• Adding a React Component for establishing Context via React Trees [v2] (#632) (1153d82), closes #632
• adding Redux instead of or in addition to Flux in documentation per issue: #222 (6b5f1a6), closes #222
• Adding statics hoisting to HOCs (7aa0cac)
• Adds require for Box component to Testing.md (#606) (61baa4b), closes #606
• Build system, documentation updates (4b04f90)
• Build updates (b9c5236)
• clarifying DropTarget and DragSource composition (24926f4)
• Copy readme from react-dnd package (#644) (d8b1fa8), closes #644
• Correct linting issues from upstream merge (b5c8f03)
• created stub function to better reproduce reality (b5aded4)
• Fix an example of the tutorial (b6f3f81)
• Fix intermittent problems with dropping a native file in FF (#713) (bfa8165), closes #713 #539
• Fix ReactTestUtils dependency (d3e4e4c)
• Fix syntax error (bce3808)
• fix typo (#656) (5442d31), closes #656
• Fix typo on DragLayerMonitor doc (#707) (1cbc990), closes #707
• fixed es5 example (36926b5)
• fixed invisible square (183ee4d)
• fixed invisible square at es7 example (bc6f61f)
• fixed mistake about collect function parameters (19348c3)
• Fixes #566 - documentation mistake regarding first vs second argument. (4fff699), closes #566
• Initializing class state in the Backend Constructor (#695) (39576c8), closes #695
• Make alt drag work for drop sources that can take either copy or move drag operations (#675) (1573fe9), closes #675
• Migrated deprecated React.PropTypes in example + same for React.createClass in docs (#729) (abbe4c7), closes #729
• Missed a spot of Flux (0f2504e)
• Missing comma in Overview example (3e6c0ae)
• Project Updates & Cleanup (#650) (23aac6c), closes #650
• Remove .vscode settings (7cd860b)
• Remove duplicated 'canDrag' of ALLOWED_SPEC_METHODS (d502238)
• Remove Gitter Links (02ade2e)
• Remove unused import from docs (55723db)
• Remove vestigial rule removals (aee325a)
• Remove vscode conf (2961b41)
• Replace 'Thinking in React' URL with link to English doc (e12cc93)
• Replace npmcdn.com with unpkg.com (f3c2be4)
• Replace ref String Attribute with ref Callback Attribute (e33d431)
• Revert "Upgrade React to stable (15.0.1)" (8a96d85)
• Set up Lerna Monorepo (WIP) (#643) (ca10e68), closes #643
• Turn on 'comma-dangle' in the examples/ folder (cf3ff00)
• Turn on 'comma-dangle' in the src/ folder (c2de0ed)
• Turn on 'consistent-return' (f8fc637)
• Turn on 'jsx-a11y/label-has-for' rule (d3ebb39)
• Turn on 'no-plusplus' (b128097)
• Turn on 'object-curly-spacing' rule (6c63d93)
• Turn on 'object-shorthand' rule (1c89429)
• Turn on 'prefer-template' rule (50182a5)
• Turn on 'quote-props' rule (8a26e17)
• Turn on 'react-jsx-first-prop-new-line', 'react-jsx-indent-props', and 'react-jsx-closing-bracket-lo (0dd5977)
• Turn on arrow-parens rule in examples (eec158c)
• Turn on import-ordering rule (4a4ee46)
• Turn on indent rule (c11d1eb)
• Turn on no-mixed-operators rule (f7832d1)
• Update #687 - Native File Example (#696) (9e062eb), closes #687 #696
• Update badges (e1871af)
• Update dependencies (4e0123f)
• Update dnd-core dep version (#641) (d59ba75), closes #641
• Update doc site stuff (2e0aa35)
• Update DropTarget.md (71c13cf)
• Update FAQ.md (bdcd120)
• Update Github URLs (5d6d740)
• Update Lerna (#678) (27e1822), closes #678
• Update LICENSE (d527941)
• Update linting rules, add editorconfig, correct static site issues (91c6684)
• Update the CodeBlock component so that newer JS syntax is shown first (#654) (ad4102d), closes #654
• Update the documentation devServer's webpack configuration so that dnd-core may be npm/yarn-linked (4fdd8e6)
• Update Tutorial.md (9c640de)
• Update walkthrough code to use yarn instead of npm (#671) (ad1e992), closes #671
• Update yarn.lock files (#653) (f7fb8b3), closes #653
• Updated reactiflux discord channel to #need-help (#703) (a7ffa6e), closes #703
• upgrade React to stable (15.0.1) (19f32f2)
• Use Babel 6, Update ESLint and Airbnb config (3b3a521)
• Use Lerna Fixed Mode for Versioning (#651) (7c34642), closes #651
• v2.2.3 (#652) (87b5ad5), closes #652
• v2.2.4 Version Cut (#674) (d1d901e), closes #674
• v2.3.0 (#710) (8a42cb5), closes #710
• v2.4.0 (8721c09)
• when rendering on the server window is undefined so no need to return it (#672) (dc28a61), closes #672
• fix: delete duplicate content (#711) (64ccf46), closes #711

• Includes a fix for server-side rendering with the DragDropContextProvider #672, (thanks @liors)
• Various documentation updates
• Add license field to child projects

Starting with this release, the packages will all be released simultaneously using the same version numbers.

• Updates to Lodash 4 (#363, fecd21fcaab2f1482d4079aed335f4482cbf9d56)
• Handlers are now unregistered on the next tick. This should solve issues like #296, #360, and #361.
• Drag layers now update in response to state changes (#348, #293)
• We no longer offer UMD build under the latest branch. If you use Bower, point your config to npmcdn. For example: https://npmcdn.com/react-dnd@latest/dist/ReactDnD.min.js

• Fixes #261 hopefully for good—the change in 2.0.1 wasn't covering all cases