Release Notes

frame label fix (#2016)

• Add a brief release note for your PR here.

fix cloud rendering (#2008)

• Improves cloud shape rendering

[improvement] prevent editing in readonly (#1990)

• Prevent editing text shapes in readonly mode.

[fix] Hovered indicators shown when coarse pointer (#1985)

• Hide hovered indicators on mobile / coarse pointer devices.

fix(docs): update shapes docs add the array of defined shapes (#1949)

This pr add the custom defined shapes that's being passed to Tldraw

Fix style panel opening when disabled (#1983)

• When select tool is active, the style menu shouldn't be openable unless a shape is also selected.

Before/After

[fix] pinch events (#1979)

• Improve pinch gesture events.

Fix text-wrapping on Safari (#1980)

• Fix text wrapping differently on Safari and Chrome/Firefox

Before/After

Remove focus management (#1953)

• [editor] Make autofocus default, remove automatic blur / focus events.

[fix] Drawing tool touch for first pen mark (#1977)

• [fix] Accidental palm inputs when using iPad pencil

Remove targeted editing from text (#1962)

• Fixed some cases where text would get selected in the wrong place.
• Changed the behaviour of text selection. Removed 'deep editing'.

fix line bugs (#1936)

• This PR patches a couple of bugs which led to straight draw lines and beziered dash lines not rendering on the canvas

Before & After:

Allow right clicking selection backgrounds (#1968)

• Improved right click behaviour.

Mark an undo before toggling lock (#1969)

• Mark an undo before toggling locked.

Stop editing frame headers when clicking inside a frame. (#1955)

• Stop editing frame headers when clicking inside of a frame.

Lokalise: Translations update (#1964)

• Updated community translations for German and Galician

[improvement] improve arrows (for real) (#1957)

• Improve arrows.

[feature] Include sources in TLExternalContent (#1925)

• [editor / tldraw] add sources to TLExternalContent

[improvement] quick actions (#1922)

• Improve the menu / kbds behavior when select tool is not active

Fix shape drag perf (#1932)

• Fixes a perf regression for dragging shapes around

Firefox: Fix dropdowns not opening with touch (#1923)

• Firefox: Fixed dropdown menus not opening with touch.

Use smarter rounding for shape container div width/height (#1930)

• Improves the precision of the shape dimensions rounding logic

Fix lines being draggable via their background (#1920)

• None - unreleased bug

Fix first handle of line snapping to itself (#1912)

• Fixed a bug where the first handle of a line shape could snap to itself.

[fix] Moving group items inside of a frame (dropping) (#1886)

• Fix bug: ungroup when moving a shape in a group in a frame.

[fix] id properties of undefined (#1730) (#1919)

• Fixed a bug similar #1730

:recycle: fix: editing is not terminated after the conversion is confirmed. (#1885)

• fix: editing is not terminated after the conversion is confirmed.

Update community translations (#1889)

• Updated translations for Russian, Ukrainian, and Simplified Chinese

Fix line wobble (#1915)

• Fixes an issue where lines would wobble as you dragged the handles around

Fix selecting one shape from selection group (#1905)

• Fix bug when selecting a single shape from a selection group

Before

https://github.com/tldraw/tldraw/assets/98838967/1412f9c6-d466-42b3-af94-d08cbc1656be

After

Fix highlighter dots not being clickable (#1903)

• None - unreleased bug

Fix video shape controls (#1909)

• Fixes pointer events for editing video shapes.

Fix line handles (#1904)

• Fixes an issue where line handles were slightly offset from the indicator line.

Fix pinch start with toolbar open (#1895)

• Fixes a bug that could trigger undo by accident when closing the style toolbar via a pinch gesture on mobile.

[wip] Viewport focus of editing shapes (#1873)

Removed a feature to reset the viewport back to a shape that is being edited.

(Before) Don't be held back by the past

(After) You are free to find new avenues of exploration

Migrate snapshot (#1843)

• [editor] add Store.migrateSnapshot

[fix] zero width / height bounds (#1840)

• Fix bug with straight lines / arrows

clamp x-box and check-box lines to stay within box at small scales (#1860)

• Fixes a regression introduced by the geometry refactor related to x-box and checkbox resizing.

Fix paste transform (#1859)

• Fixes a bug affecting the position of pasted content inside frames.

Fix indicator transform miscalculation (#1852)

• Fixes indicator transform miscalculation on android and windows

update currentPageShapesSorted reference in docs (#1851)

• Add a brief release note for your PR here.

[fix] awful rendering issue (#1842)

• [fix] iframe rendering issue

fix typo (#1831)

• Just fixed a typo in the docs

[feature] Asset props (#1824)

• [@tldraw/tldraw] add asset props

[fix] snapping bug (#1819)

• [fix] crash that could occur when snapping

[fix] editing video shapes (#1821)

• Fix bug with editing video shapes.

[feature] unlock all action (#1820)

• Adds the unlock all feature.

[fix] bug with eventemitter3 default export (#1818)

• [@tldraw/editor] updates eventemitter3 import to fix issue with Astro builds.

Add next cache to clean command (#1811)

• Internal tooling change

Fix text editing in page menu popover (#1790)

• (fix) page menu editing

[fix] embeds switching / tldraw embed (#1792)

• [fix] tldraw embeds

Custom rendering margin / don't cull selected shapes (#1788)

• [editor] add Editor.renderingBoundsMargin

Camera APIs (#1786)

• (editor) improve camera commands

environment manager (#1784)

• [editor] Move environment flags to environment manager

Editor commands API / effects (#1778)

• tbd

[feature] Add val town embed (#1777)

• (feature) val town

export UiEventsProvider (#1774)

• [@tldraw/tldraw] export ui events, so that UI hooks can work without context

remove useForceSolid effect for geo / line shapes (#1769)

• Remove the force solid switching for geo / line shapes

[fix] shape indicator showing when locked shapes are hovered (#1771)

• locked shapes do not show an indicator when hovered

remove selectionPageCenter (#1766)

• [dev] Removes Editor.selectionPageCenter

rename selection page bounds (#1763)

• [editor] rename selectedPageBounds to selectionPageBounds

ShapeUtil.getGeometry, selection rewrite (#1751)

• [editor] Remove ShapeUtil.getBounds, ShapeUtil.getOutline, ShapeUtil.hitTestPoint, ShapeUtil.hitTestLineSegment
• [editor] Add ShapeUtil.getGeometry
• [editor] Add Editor.getShapeGeometry

Fix asset urls (#1758)

• Fixed asset urls

[fix] arrow snapping bug (#1756)

• [fix] arrow snapping

[fix] dark mode (#1754)

• [fix] dark mode colors not updating

Remove helpers / extraneous API methods. (#1745)

• [tldraw] rename useReadonly to useReadOnly
• [editor] remove Editor.isDarkMode
• [editor] remove Editor.isChangingStyle
• [editor] remove Editor.isCoarsePointer
• [editor] remove Editor.isDarkMode
• [editor] remove Editor.isFocused
• [editor] remove Editor.isGridMode
• [editor] remove Editor.isPenMode
• [editor] remove Editor.isReadOnly
• [editor] remove Editor.isSnapMode
• [editor] remove Editor.isToolLocked
• [editor] remove Editor.locale
• [editor] rename Editor.pageState to Editor.currentPageState
• [editor] add Editor.pageStates
• [editor] add Editor.setErasingIds
• [editor] add Editor.setEditingId
• [editor] add several new component overrides

add shapes docs content (#1705)

• Documentation: Added more info about shapes.

fix: escape eraser tool on escape (#1732)

• escape eraser tool on escape

fix: arrow label dark mode color (#1733)

• fixed arrow label dark mode color

tldraw zero - package shuffle (#1710)

• [@tldraw/editor] lots, wip
• [@tldraw/ui] gone, merged to tldraw/tldraw
• [@tldraw/polyfills] gone, merged to tldraw/editor
• [@tldraw/primitives] gone, merged to tldraw/editor / tldraw/tldraw
• [@tldraw/indices] gone, merged to tldraw/editor
• [@tldraw/file-format] gone, merged to tldraw/tldraw

[fix] add cloud tooltip (#1728)

• Add a brief release note for your PR here.

(2/2) Add content to Tools docs page. (#1721)

• Tools docs.

tweaks for cloud shape (#1723)

• Add a brief release note for your PR here.

Add cloud shape (#1708)

• Adds a cloud shape.

[refactor] reduce dependencies on shape utils in editor (#1693)

• removes shape utils from the arguments of isShapeOfType, replacing with a generic
• removes shape utils from the arguments of getShapeUtil, replacing with a generic
• moves custom arrow info cache out of the util and into the editor class
• changes the a tool's shapeType to be a string instead of a shape util

Make some missing tsdocs appear on the docs site (#1706)

• Docs: Fixed some missing docs for the TldrawEditor component.

[hot take] remove tool from shape definition (#1691)

• [dev] Removed the tool property from defineShape

[refactor] reordering shapes (#1718)

• [api] removes Editor.getParentsMappedToChildren
• [api] removes Editor.reorderShapes
• [api] moves reordering shapes code into its own file, outside of the editor

remove state checks for brush and zoom brush (#1717)

• [editor] remove editor.isIn state checks for displaying brush and zoom brush.

Add API links to all docs pages (#1661)

• Documentation: Added links to API reference in guides.

Go back to default cursor when done resizing. (#1700)

• Switch back to the default cursor after you are done inserting a new text shape.

Firefox: Fix coarse pointer issue (#1701)

• Fixed firefox not being able to use cursor chat when using a touch screen on desktop.

Fix tsdocs for TldrawUi component (#1707)

• Docs: Show some docs missing from TldrawUi component.

---

💥 Breaking Change

• @tldraw/editor, @tldraw/tldraw
  • [improvement] prevent editing in readonly #1990 (@steveruizok)
  • Remove focus management #1953 (@steveruizok @ds300)
  • Make user preferences optional #1963 (@ds300)
  • [fix] style changes #1814 (@steveruizok)
  • Cleanup page state commands #1800 (@steveruizok)
  • Rendering / cropping side-effects #1799 (@steveruizok)
  • history options / markId / createPage #1796 (@steveruizok)
  • Update setter names, setXXShapeId rather than setXXId #1789 (@steveruizok)
  • Rename shapes apis #1787 (@steveruizok)
  • Camera APIs #1786 (@steveruizok)
  • environment manager #1784 (@steveruizok)
  • remove selectionPageCenter #1766 (@steveruizok)
  • rename selection page bounds #1763 (@steveruizok)
• @tldraw/tldraw
  • Remove targeted editing from text #1962 (@TodePond @steveruizok)
  • [improvement] quick actions #1922 (@steveruizok)
• @tldraw/editor, @tldraw/store
  • SideEffectManager #1785 (@steveruizok)
• @tldraw/editor, @tldraw/state, @tldraw/store, @tldraw/tldraw, @tldraw/tlschema
  • Revert "Editor commands API / effects" #1783 (@steveruizok)
  • Editor commands API / effects #1778 (@steveruizok)
• @tldraw/editor, @tldraw/tldraw, @tldraw/tlschema
  • ShapeUtil.getGeometry, selection rewrite #1751 (@steveruizok)
  • More cleanup, focus bug fixes #1749 (@steveruizok)
  • Remove helpers / extraneous API methods. #1745 (@steveruizok)
• @tldraw/editor, @tldraw/tldraw, @tldraw/utils
  • move some utils into tldraw/utils #1750 (@steveruizok)
• @tldraw/editor, @tldraw/state, @tldraw/store, @tldraw/tldraw, @tldraw/tlschema, @tldraw/utils, @tldraw/validate
  • tldraw zero - package shuffle #1710 (@steveruizok @SomeHats)
• @tldraw/editor
  • [refactor] reduce dependencies on shape utils in editor #1693 (@steveruizok)
  • [hot take] remove tool from shape definition #1691 (@TodePond)
  • [refactor] reordering shapes #1718 (@steveruizok)

🚀 Enhancement

• @tldraw/editor, @tldraw/tldraw
  • Debugging cleanup / misc cleanup #2025 (@steveruizok)
  • [feature] Include sources in TLExternalContent #1925 (@steveruizok)
  • Add snapshot prop, examples #1856 (@steveruizok)
  • [fix] arrow snapping bug #1756 (@steveruizok)
• @tldraw/editor, @tldraw/tldraw, @tldraw/tlschema
  • Fix arrow handle snapping, snapping to text labels, selection of text labels #1910 (@steveruizok)
• @tldraw/editor, @tldraw/store, @tldraw/tldraw, @tldraw/tlschema
  • Migrate snapshot #1843 (@steveruizok)
• @tldraw/tldraw
  • export asset stuff #1829 (@steveruizok)
  • [feature] Asset props #1824 (@steveruizok)
  • [feature] unlock all action #1820 (@steveruizok)
  • export UiEventsProvider #1774 (@steveruizok)
• @tldraw/editor
  • Add className as prop to Canvas #1827 (@steveruizok)
  • refactor parentsToChildrenWithIndexes #1764 (@steveruizok)
  • remove state checks for brush and zoom brush #1717 (@steveruizok)
• @tldraw/editor, @tldraw/state, @tldraw/tldraw
  • [improvement] More selection logic #1806 (@steveruizok)
• @tldraw/assets, @tldraw/tlschema
  • [feature] Add val town embed #1777 (@steveruizok)
• @tldraw/tldraw, @tldraw/validate
  • Add shapes to exports #1776 (@steveruizok)
• @tldraw/assets, @tldraw/editor, @tldraw/tlschema
  • Add cloud shape #1708 (@ds300)

🐛 Bug Fix

• [fix] Multiple example #2026 (@steveruizok)
• Fix vs code extension. Prepare for new release. #2011 (@MitjaBezensek @steveruizok)
• Lokalise: Translations update #1964 (@TodePond)
• Update community translations #1889 (@TodePond)
• Bump vs code version. #1735 (@MitjaBezensek)
• [fix] add cloud tooltip #1728 (@ds300)
• Bump vs code version. #1719 (@MitjaBezensek)
• @tldraw/tldraw
  • Update readme #2027 (@steveruizok)
  • [fix] Minimap interactions #2012 (@steveruizok)
  • [fix] Image size #2002 (@steveruizok)
  • [fix] tool lock button in toolbar #2009 (@steveruizok)
  • fix cloud rendering #2008 (@ds300)
  • Fix hooks error. #2000 (@MitjaBezensek)
  • Fix style panel opening when disabled #1983 (@Taha-Hassan-Git @steveruizok)
  • [fix] Drawing tool touch for first pen mark #1977 (@steveruizok)
  • [fix] Screen bounds offset after editing text #1976 (@steveruizok)
  • fix line bugs #1936 (@Taha-Hassan-Git @steveruizok)
  • Mark an undo before toggling lock #1969 (@steveruizok)
  • Stop editing frame headers when clicking inside a frame. #1955 (@MitjaBezensek @TodePond)
  • Firefox: Fix dropdowns not opening with touch #1923 (@TodePond)
  • Fix lines being draggable via their background #1920 (@TodePond)
  • Fix first handle of line snapping to itself #1912 (@TodePond)
  • [fix] id properties of undefined (#1730) #1919 (@momenthana)
  • :recycle: fix: editing is not terminated after the conversion is confirmed. #1885 (@mr04vv @steveruizok)
  • Fix selecting one shape from selection group #1905 (@Taha-Hassan-Git)
  • [fix] help menu css #1888 (@steveruizok)
  • Fix highlighter dots not being clickable #1903 (@TodePond)
  • Fix video shape controls #1909 (@ds300)
  • Fix line handles #1904 (@ds300)
  • Fix pinch start with toolbar open #1895 (@ds300)
  • clamp x-box and check-box lines to stay within box at small scales #1860 (@ds300)
  • [fix] exit penmode #1847 (@steveruizok)
  • [fix] assets and content handlers #1846 (@steveruizok)
  • [fix] line tool bug with tool locked #1841 (@steveruizok)
  • [fix] arrows bind to locked shapes #1833 (@steveruizok @MitjaBezensek)
  • [fix] Collaborator scribble on tldraw #1804 (@steveruizok)
  • [fix] Don't make arrows shapes to arrows #1793 (@steveruizok)
  • Fix text editing in page menu popover #1790 (@steveruizok)
  • Fix outlines on text shapes #1781 (@steveruizok)
  • remove useForceSolid effect for geo / line shapes #1769 (@steveruizok)
  • [fix] arrow rendering safari #1767 (@steveruizok)
  • [fix] revert legacy changes to buildFromV1Document.ts #1761 (@steveruizok)
  • Fix asset urls #1758 (@lakesare)
  • [fix]: Fix typo in shapeType declaration #1747 (@ricardo-crespo @steveruizok)
  • fix: escape eraser tool on escape #1732 (@gabrielchl @steveruizok)
  • fix: arrow label dark mode color #1733 (@gabrielchl @steveruizok)
• @tldraw/editor
  • fix screen bounds not updating #2022 (@SomeHats)
  • [improvement] Refactor curved arrows #2019 (@steveruizok)
  • [fix] focus events #2013 (@steveruizok)
  • Re-focus on focus. #2010 (@steveruizok)
  • [fix] X box shape arrow intersections #2006 (@steveruizok)
  • Fix group opacity #1997 (@ds300)
  • [fix] Escape key exiting full screen while editing shapes #1986 (@steveruizok)
  • [fix] Hovered indicators shown when coarse pointer #1985 (@steveruizok)
  • Sliiiightly darken muted-2 color. #1981 (@steveruizok)
  • [fix] pinch events #1979 (@steveruizok)
  • Make state node methods arrow functions #1973 (@steveruizok)
  • Arrows followup #1972 (@steveruizok)
  • [improvement] improve arrows (for real) #1957 (@steveruizok)
  • fix clipping on nested non-intersecting frames #1934 (@SomeHats)
  • Use smarter rounding for shape container div width/height #1930 (@ds300)
  • Fix line wobble #1915 (@ds300)
  • [fix] right click #1891 (@steveruizok)
  • [wip] Viewport focus of editing shapes #1873 (@Taha-Hassan-Git)
  • Fix indicator transform miscalculation #1852 (@ds300)
  • [fix] pointer events in shapes #1855 (@steveruizok)
  • [fix] overlays stacking #1849 (@steveruizok)
  • [fix] awful rendering issue #1842 (@steveruizok)
  • [fix] svg overlays when browser zoom is not 100% #1836 (@steveruizok)
  • Allow setting user as a prop #1832 (@SomeHats)
  • [fix] snapping bug #1819 (@steveruizok)
  • [fix] Replace findLast for browser compat #1822 (@steveruizok)
  • [fix] bug with eventemitter3 default export #1818 (@steveruizok)
  • [fix] handles updates #1779 (@steveruizok)
  • [fix] transform errors #1772 (@steveruizok)
  • [fix] shape indicator showing when locked shapes are hovered #1771 (@steveruizok)
  • tweaks for cloud shape #1723 (@ds300)
  • Go back to default cursor when done resizing. #1700 (@MitjaBezensek)
  • Firefox: Fix coarse pointer issue #1701 (@TodePond)
• @tldraw/editor, @tldraw/tldraw
  • frame label fix #2016 (@ds300)
  • [fix] Focus events (actually) #2015 (@steveruizok)
  • Contain all the things #1999 (@steveruizok)
  • fix text in geo shapes not causing its container to grow #2003 (@SomeHats)
  • Fix an issue with arrow creation. #2004 (@MitjaBezensek @steveruizok)
  • Fix text-wrapping on Safari #1980 (@Taha-Hassan-Git)
  • [fix] text shape outline #1974 (@steveruizok)
  • Allow right clicking selection backgrounds #1968 (@TodePond @steveruizok)
  • [fix] geo shape text label placement #1927 (@steveruizok @ds300)
  • expanded highlighter geometry #1929 (@SomeHats)
  • [fix] Moving group items inside of a frame (dropping) #1886 (@mr04vv @steveruizok)
  • [fix] iframe losing focus on pointer down #1848 (@steveruizok)
  • [fix] zero width / height bounds #1840 (@steveruizok)
  • avoid pixel rounding / transformation miscalc for overlay items #1858 (@BrianHung @ds300)
  • Fix paste transform #1859 (@ds300)
  • [fix] text editing outline when scaled #1826 (@steveruizok)
  • [fix] Line shape rendering #1825 (@steveruizok)
  • [fix] remove CSS radius calculations #1823 (@steveruizok)
  • [fix] editing video shapes #1821 (@steveruizok)
  • [fix] Sticky text content / hovered shapes #1808 (@steveruizok)
  • [fix] page to screen #1797 (@steveruizok)
  • Custom rendering margin / don't cull selected shapes #1788 (@steveruizok)
  • [fix] minimap, common page bounds #1770 (@steveruizok)
  • [fix] restore bg option, fix calculations #1765 (@steveruizok)
• @tldraw/editor, @tldraw/store
  • Fix shape drag perf #1932 (@ds300)
• @tldraw/tldraw, @tldraw/tlschema
  • [fix] embeds switching / tldraw embed #1792 (@steveruizok)
• @tldraw/editor, @tldraw/tldraw, @tldraw/tlschema
  • [fix] dark mode #1754 (@steveruizok)

🏠 Internal

• Remove docs source. #2030 (@steveruizok)
• [infra] missing await #1951 (@ds300)
• [infra] maybe fix canary publish #1950 (@ds300)
• fix typo #1831 (@judicaelandria)
• Add next cache to clean command #1811 (@ds300)
• remove yjs example #1795 (@steveruizok)
• support custom shapes in yjs example #1737 (@steveruizok)
• [internal] Add basic list to examples #1688 (@steveruizok)
• cleanup #1711 (@SomeHats)
• @tldraw/tldraw
  • [fix] CSS reload in dev #1791 (@steveruizok)

📝 Documentation

• fix(docs): update shapes docs add the array of defined shapes #1949 (@judicaelandria @steveruizok)
• update currentPageShapesSorted reference in docs #1851 (@Taha-Hassan-Git)
• Fix broken link in docs #1830 (@jmduke @steveruizok)
• add shapes docs content #1705 (@TodePond @steveruizok)
• (2/2) Add content to Tools docs page. #1721 (@TodePond)
• Add API links to all docs pages #1661 (@TodePond)
• Fix tsdocs for TldrawUi component #1707 (@TodePond)
• @tldraw/editor
  • Make some missing tsdocs appear on the docs site #1706 (@TodePond)

🧪 Tests

• Fix e2e test #1748 (@steveruizok)
• @tldraw/tldraw
  • [fix] Right click groups #1975 (@TodePond @steveruizok)

🔩 Dependency Updates

• @tldraw/editor
  • (chore) bump #1744 (@steveruizok)

Authors: 14

• alex (@SomeHats)
• Brian Hung (@BrianHung)
• David Sheldrick (@ds300)
• Evgenia Karunus (@lakesare)
• Gabriel Lee (@gabrielchl)
• Hana (@momenthana)
• Judicael (@judicaelandria)
• Justin Duke (@jmduke)
• Lu Wilson (@TodePond)
• Mitja Bezenšek (@MitjaBezensek)
• Ricardo Crespo (@ricardo-crespo)
• Steve Ruiz (@steveruizok)
• Taha (@Taha-Hassan-Git)
• Takuto Mori Gump (@mr04vv)