Releases

How tldraw is versioned

Unlike many JavaScript packages distributed on NPM, the tldraw SDK does not follow semantic versioning in its release versions. Here's what we do instead:

Major version bumps are very rare and we reserve them for special changes that signify a paradigm shift of some kind.
Minor version bumps are released on a regular cadence - approximately monthly. They may contain breaking changes. We aim to make breaking changes as minimally disruptive as possible, but tldraw is actively evolving as we add new features. We recommend updating tldraw at a similar pace to our release cadence, and be sure to check the release notes.
Patch version bumps are for bugfixes and hotfixes that can't wait for the next cadence release.

Current release: v3.6.0

Welcome to the 3.6.0 release of tldraw. This month's SDK release expands DX around helpers (e.g. toasts), and addresses various issues.

What's new

Expand helpers available in actions / toasts overrides. (#5041)

Makes new helper available via actions and tools overrides, things like clipboard interactions, toasts, exports, printing, and a couple more.

Improvements

Create a utility type for making undefined properties optional #5055
Make sure notes snap to grid after position is updated #5010
Add incremental derivation example #5038

API changes

Expand helpers available in actions / toasts overrides. #5041 (@steveruizok)
setEmbedDefinitions used to be an instance method on the EmbedShapeUtil class, but has been converted into a static method on that class. #5027
Remove ExtractOptionalKeys and ExtractRequiredKeys types. https://github.com/tldraw/tldraw/pull/5055

Bug fix

Fix up resolving assets when copy/pasting multiple items; also, fix up copy/pasting videos #5061
Fix properly clipping scaled text in frames when exporting #5022
Fix multiple concurrent exports from interfering with each-others fonts #5022
Fix issue with long press where the point would be incorrect #5032
Fix file name when exporting a single unnamed frame #4918
Fix first render of custom embeds #5027

Authors: 7

alex (@SomeHats)
David Sheldrick (@ds300)
Mime Čuvalo (@mimecuvalo)
Mitja Bezenšek (@MitjaBezensek)
Steve Ruiz (@steveruizok)
Trygve Aaberge (@trygve-aaberge-adsk)