furniture/node_modules/react-konva/RELEASE_NOTES.md

19.3.2: Clean release artifacts

Builds now clear previous output before compilation. This prevents stale, unused files from entering the package after a compiler configuration change.

19.3.1: Batched Transformer updates

With Konva 10.9+, react-konva batches automatic Transformer updates across each canvas commit. Updating many selected nodes triggers one Transformer refresh after the mutations. Layout effects see the final anchor positions.

This works automatically. Upgrade Konva to enable it:

npm install react-konva@19.3.1 konva@^10.9.0

Older supported Konva versions keep their existing behavior and do not require the new batching API. React and React DOM still require matching 19.3+ versions within React 19.

Updates the context bridge and renderer types, with the same React 19.3.0 minimum.

Attribute-change listeners run during mutation. They can read the changed attributes and Transformer bounds synchronously. To read final anchor positions, use a layout effect or call transformer.update() explicitly in the listener.

Validation

The suite covers 203 correctness tests per build and 41 performance checks, including resizing 600 selected shapes. Regression tests cover individual selections, selected Groups, layout reads, and a missing batching API. Package checks cover server rendering, both module formats, consumer types, package exports, and React DevTools.

19.3.0: React 19.3 support

Upgrade requirements

Upgrade React and React DOM to matching 19.3 versions before you install this release. The minimum React and React DOM version is now 19.3.0.

npm install react@19.3.0 react-dom@19.3.0 react-konva@19.3.0

For React 19.2 projects, pin react-konva to ~19.2.7. The range ^19.2.7 also allows 19.3.0, which requires the React upgrade. For React 18 projects, use the React Konva 18 release line.

Fixes and improvements

• Fixes the useActionState crash inside Stage with React 19.3. This resolves #859 through #860.
• Updates the bundled react-reconciler to 0.34.0 and scheduler to 0.28.0 for React 19.3.
• Canvas roots inherit React StrictMode checks from the DOM tree.
• Activity and Suspense preserve canvas state and node identity through hiding and reveal. Effects and refs disconnect and reconnect as each boundary requires.
• Stage removal discards pending child updates and runs effect cleanup, including for hidden Stages.
• Canvas components read the surrounding DOM form status through useFormStatus, including the submitted data and action.
• useId values remain stable on updates and distinct across DOM and Stage roots.
• Both package formats register with React DevTools. Development builds support hook state changes.

Renderer boundaries

Error boundaries inside Stage handle canvas errors and display Konva fallbacks. DOM error boundaries around Stage do not catch errors from canvas children. Uncaught canvas errors appear in the console with the original error and component stack, including errors during cleanup.

Canvas Suspense boundaries display Konva fallbacks. Canvas suspension does not activate a surrounding DOM Suspense boundary. A promise read before Stage renders can activate that DOM fallback.

A DOM ViewTransition can animate the Stage container. A ViewTransition inside Stage with Konva nodes or a ref throws a clear error. Fragment children remain supported, but Fragment refs stay null and provide no DOM methods.

The React compatibility matrix lists the supported hooks, features, fallbacks, and remaining limits. Native input synchronization and the fallback for older Konva versions continue from 19.2.7.

Validation

CI passes with Chromium, Firefox, and WebKit in development and production. The minimum React and React DOM 19.3.0 job also passes. The suite covers 196 correctness tests per build and 38 performance checks. Package checks cover both module formats, server rendering, package exports, consumer types, and the DevTools protocol.