tldraw 5.4.2 → 5.5.0-canary.0241f11f2e99

package/DOCS.md

@@ -1,6 +1,6 @@
 # tldraw Documentation
 
-Version: `5.4.2`
+Version: `5.5.0-canary.0241f11f2e99`
 
 This file is generated during package publishing from the tldraw docs content for this exact package version.
 
@@ -1199,7 +1199,7 @@ See [Collaboration](https://tldraw.dev/sdk-features/collaboration) for productio
 
 When you load a snapshot from an older schema version, the store migrates it automatically. For custom shapes, you can define migrations to handle changes to their props over time.
 
-See [Persistence](https://tldraw.dev/sdk-features/persistence#migrations) for details on shape props migrations and general migrations.
+See [Persistence](https://tldraw.dev/sdk-features/persistence#Migrations) for details on shape props migrations and general migrations.
 
 #### Examples
 
@@ -1419,7 +1419,7 @@ function MyApp() {
 }
 ```
 
-Comment records are opt-in, so register `commentSchemaRecords` on your server's schema too, and list the comment record types in the room's `objectTypes` (see [Comments and the object-store lane](https://tldraw.dev/docs/sync#comments-and-the-object-store-lane)). Commenting is a licensed feature. See the [commenting overview](https://tldraw.dev/docs/commenting) for an introduction, or the [commenting reference](https://tldraw.dev/sdk-features/commenting) for anchors, options, and server setup.
+Comment records are opt-in, so register `commentSchemaRecords` on your server's schema too, and list the comment record types in the room's `objectTypes` (see [Comments and the object-store lane](https://tldraw.dev/docs/sync#Comments-and-the-object-store-lane)). Commenting is a licensed feature. See the [commenting overview](https://tldraw.dev/docs/commenting) for an introduction, or the [commenting reference](https://tldraw.dev/sdk-features/commenting) for anchors, options, and server setup.
 
 #### Using other backends
 
@@ -1772,7 +1772,7 @@ import { CommentTool } from '@tldraw/commenting'
 const tools = [CommentTool.configure({ enableRegions: true })]
 ```
 
-The option worth knowing about first is `history`. Comment writes default to `'ignore'`, which keeps them off the undo stack, and that default matters in a shared document: an undoable resolve would revert a thread a collaborator has since reopened. Deletes are never undoable, whatever `history` says. See [Comments and undo](https://tldraw.dev/sdk-features/commenting#comments-and-undo).
+The option worth knowing about first is `history`. Comment writes default to `'ignore'`, which keeps them off the undo stack, and that default matters in a shared document: an undoable resolve would revert a thread a collaborator has since reopened. Deletes are never undoable, whatever `history` says. See [Comments and undo](https://tldraw.dev/sdk-features/commenting#Comments-and-undo).
 
 #### Permissions
 
@@ -1784,7 +1784,7 @@ They're UI-level controls and nothing more. Comment records carry a client-suppl
 
 Comments sync like the rest of your document, with one registration on each side. Pass `records: commentSchemaRecords` to your sync hook, and the same map to `createTLSchema` on the server.
 
-On the server you can go a step further and serve comments through the room's object-store lane. Lane records are gated by their own per-session permission rather than by `isReadonly`, which is how a viewer who can't edit the document can still comment. See [Syncing comments](https://tldraw.dev/sdk-features/commenting#syncing-comments).
+On the server you can go a step further and serve comments through the room's object-store lane. Lane records are gated by their own per-session permission rather than by `isReadonly`, which is how a viewer who can't edit the document can still comment. See [Syncing comments](https://tldraw.dev/sdk-features/commenting#Syncing-comments).
 
 #### Related
 
@@ -2094,7 +2094,7 @@ function MyApp() {
 Use `createTLSchema` to create a store schema, and pass that into `TLSocketRoom`. You can
 use shape/binding utils here, but the schema only reads three properties:
 [`props`](https://tldraw.dev/reference/editor/ShapeUtil#props), `meta`, and
-[`migrations`](https://tldraw.dev/sdk-features/persistence#migrations). You need to provide the default shape
+[`migrations`](https://tldraw.dev/sdk-features/persistence#Migrations). You need to provide the default shape
 schemas if you're using them.
 
 ```tsx
@@ -2918,7 +2918,7 @@ For example, see `src/components/WhiteboardModal.tsx:92` for UI component overri
 
 #### Further reading
 
-- **[Custom shape utilities](https://tldraw.dev/docs/shapes#custom-shapes)**: Learn how to create custom shapes with their own interactions.
+- **[Custom shape utilities](https://tldraw.dev/docs/shapes#Custom-shapes)**: Learn how to create custom shapes with their own interactions.
 
 - **[Editor API](https://tldraw.dev/docs/editor)**: Learn about the tldraw Editor.
 
@@ -3454,14 +3454,14 @@ The system prompt is rebuilt for each step in the agentic loop depending on whic
 You can set an agent's model by calling `setModelName` on the `modelName` manager.
 
 ```tsx
-agent.modelName.setModelName('gemini-3-flash-preview')
+agent.modelName.setModelName('gemini-3.8-flash')
 ```
 
 To override an agent's model, specify a different model name with a request.
 
 ```tsx
 agent.prompt({
-	modelName: 'gemini-3-flash-preview',
+	modelName: 'gemini-3.8-flash',
 	message: 'Draw a diagram of a volcano.',
 })
 ```
@@ -3470,7 +3470,7 @@ You can conditionally override the model name by overriding the `getModelName()`
 
 ```tsx
 override getModelName(part: MyCustomPromptPart) {
-	return part.fastMode ? 'gemini-3-flash-preview' : 'claude-sonnet-4-5'
+	return part.fastMode ? 'gemini-3.8-flash' : 'claude-sonnet-5'
 }
 ```
 
@@ -3479,10 +3479,14 @@ override getModelName(part: MyCustomPromptPart) {
 To add support for a different model, add the model's definition to `AGENT_MODEL_DEFINITIONS` in the `shared/models.ts` file.
 
 ```tsx
-'claude-sonnet-4-5': {
-	name: 'claude-sonnet-4-5',
-	id: 'claude-sonnet-4-5',
+'claude-sonnet-5': {
+	name: 'claude-sonnet-5',
+	id: 'claude-sonnet-5',
 	provider: 'anthropic',
+	supportsPrefill: false,
+	supportsTemperature: false,
+	thinking: 'adaptive',
+	effort: 'low',
 }
 ```
 
@@ -3490,7 +3494,7 @@ If you need to add any extra setup or configuration for your provider, you can a
 
 ##### Support custom shapes
 
-If your app includes [custom shapes](https://tldraw.dev/docs/shapes#custom-shapes), the agent will be able to see, move, delete, resize, rotate and arrange them with no extra setup. However, you might want to also let the agent create and edit them, and read their custom properties.
+If your app includes [custom shapes](https://tldraw.dev/docs/shapes#Custom-shapes), the agent will be able to see, move, delete, resize, rotate and arrange them with no extra setup. However, you might want to also let the agent create and edit them, and read their custom properties.
 
 To support custom shapes, you have two main options:
 
@@ -3667,7 +3671,7 @@ export function convertFocusedShapeToTldrawShape(
 
 - **[Multiplayer starter kit](https://tldraw.dev/starter-kits/multiplayer)**: Use the tldraw multiplayer sync starter kit to build multi-user agent environments.
 
-- **[Shape utilities](https://tldraw.dev/docs/shapes#custom-shapes)**: Learn how to create custom shapes and extend tldraw's shape system with advanced geometry, rendering, and interaction patterns.
+- **[Shape utilities](https://tldraw.dev/docs/shapes#Custom-shapes)**: Learn how to create custom shapes and extend tldraw's shape system with advanced geometry, rendering, and interaction patterns.
 
 - **[Editor state management](https://tldraw.dev/docs/editor)**: Learn how to work with tldraw's reactive state system, editor lifecycle, and event handling for complex canvas applications.
 
@@ -3871,7 +3875,7 @@ See `client/connection/ConnectionBindingUtil.tsx` as an example. This file demon
 #### Further reading
 
 - [Workflow starter kit](https://tldraw.dev/starter-kits/workflow): Learn how to build visual programming interfaces with node-based workflows on infinite canvas.
-- [Shape utilities](https://tldraw.dev/docs/shapes#custom-shapes): Learn how to create custom shapes and extend tldraw's shape system with advanced geometry, rendering, and interaction patterns.
+- [Shape utilities](https://tldraw.dev/docs/shapes#Custom-shapes): Learn how to create custom shapes and extend tldraw's shape system with advanced geometry, rendering, and interaction patterns.
 - [Binding system](https://tldraw.dev/sdk-features/bindings): Learn more about tldraw's binding system for creating relationships between shapes, automatic updates, and connection management.
 - [Editor state management](https://tldraw.dev/docs/editor): Learn how to work with tldraw's reactive state system, editor lifecycle, and event handling for complex canvas applications.
 
@@ -4199,7 +4203,7 @@ See [`src/fluid/FluidManager.ts`](https://github.com/tldraw/tldraw/tree/main/tem
 
 #### Further reading
 
-For multi-user shader environments, see the [Multiplayer starter kit](https://tldraw.dev/starter-kits/multiplayer). To create custom shapes with advanced geometry and rendering, see [Shape utilities](https://tldraw.dev/docs/shapes#custom-shapes). For working with tldraw's reactive state system and event handling, see [Editor state management](https://tldraw.dev/docs/editor).
+For multi-user shader environments, see the [Multiplayer starter kit](https://tldraw.dev/starter-kits/multiplayer). To create custom shapes with advanced geometry and rendering, see [Shape utilities](https://tldraw.dev/docs/shapes#Custom-shapes). For working with tldraw's reactive state system and event handling, see [Editor state management](https://tldraw.dev/docs/editor).
 
 ---
 
@@ -5433,7 +5437,7 @@ Custom metadata is validated and persisted alongside the standard user fields. A
 | `createCachedUserResolve`          | Create a cached resolve function for `TLUserStore`                      |
 | `createUserRecordType`             | Build a user record type with custom meta validators                    |
 
-For setting up user identity in multiplayer, see the [Collaboration](https://tldraw.dev/sdk-features/collaboration#user-identity) page.
+For setting up user identity in multiplayer, see the [Collaboration](https://tldraw.dev/sdk-features/collaboration#User-identity) page.
 
 #### Related examples
 
@@ -7576,7 +7580,7 @@ class MyShapeUtil extends ShapeUtil<MyShape> {
 }
 ```
 
-Shapes whose util overrides `canCull` are subscribed to individually inside the culling derivation, so a `canCull` that reads many props re-runs the derivation more often. Shapes using the default fast path don't pay this cost. Disable culling only for shapes that need it: visual effects that extend past the bounds, shapes that measure their DOM, or animations that should keep running off-screen. See [Performance](https://tldraw.dev/sdk-features/performance#disable-culling-only-when-necessary) for guidance.
+Shapes whose util overrides `canCull` are subscribed to individually inside the culling derivation, so a `canCull` that reads many props re-runs the derivation more often. Shapes using the default fast path don't pay this cost. Disable culling only for shapes that need it: visual effects that extend past the bounds, shapes that measure their DOM, or animations that should keep running off-screen. See [Performance](https://tldraw.dev/sdk-features/performance#Disable-culling-only-when-necessary) for guidance.
 
 #### Related examples
 
@@ -7749,7 +7753,7 @@ export default function App() {
 }
 ```
 
-Remote users' chat messages render as part of the collaborator cursor, in the DOM cursor layer. To customize how they appear, replace the `CollaboratorCursor` component. See [Cursors](https://tldraw.dev/sdk-features/cursors#rendering-collaborator-cursors) for details.
+Remote users' chat messages render as part of the collaborator cursor, in the DOM cursor layer. To customize how they appear, replace the `CollaboratorCursor` component. See [Cursors](https://tldraw.dev/sdk-features/cursors#Rendering-collaborator-cursors) for details.
 
 #### Availability
 
@@ -8542,7 +8546,7 @@ const ConfiguredFrameUtil = FrameShapeUtil.configure({
 })
 ```
 
-To build your own container shape that behaves like a frame, extend `BaseFrameLikeShapeUtil` rather than re-implementing every behavior on `FrameShapeUtil`. The base class provides defaults for clipping children, full-brush selection, blocking erasure from inside, and drag-and-drop reparenting — see [Shapes](https://tldraw.dev/sdk-features/shapes#frames) for details and the [portal shapes example](https://tldraw.dev/examples/shapes/tools/portal-shapes) for a working implementation.
+To build your own container shape that behaves like a frame, extend `BaseFrameLikeShapeUtil` rather than re-implementing every behavior on `FrameShapeUtil`. The base class provides defaults for clipping children, full-brush selection, blocking erasure from inside, and drag-and-drop reparenting — see [Shapes](https://tldraw.dev/sdk-features/shapes#Frames) for details and the [portal shapes example](https://tldraw.dev/examples/shapes/tools/portal-shapes) for a working implementation.
 
 ##### Group
 
@@ -9155,8 +9159,8 @@ The geometry uses the processed stroke points (after applying streamline and smo
 
 #### Related shapes
 
-- [Highlight](https://tldraw.dev/sdk-features/default-shapes#highlight) uses the same point capture system but renders semi-transparently for marking up content
-- [Line](https://tldraw.dev/sdk-features/default-shapes#line) creates editable multi-point lines with draggable handles
+- [Highlight](https://tldraw.dev/sdk-features/default-shapes#Highlight) uses the same point capture system but renders semi-transparently for marking up content
+- [Line](https://tldraw.dev/sdk-features/default-shapes#Line) creates editable multi-point lines with draggable handles
 
 #### Related articles
 
@@ -9624,7 +9628,7 @@ editor.updateInstanceState({ isReadonly: true })
 editor.updateInstanceState({ isToolLocked: true })
 ```
 
-See [Tools](https://tldraw.dev/sdk-features/tools#tool-lock) for more on tool lock.
+See [Tools](https://tldraw.dev/sdk-features/tools#Tool-lock) for more on tool lock.
 
 Each page also has instance state (`TLInstancePageState`) tracking selection, hovered shape, and editing shape for that page:
 
@@ -9765,7 +9769,7 @@ The shape stores the original URL and renders the embed version.
 
 #### Fallback to bookmarks
 
-When you paste a URL that no embed definition recognizes, the default URL handler creates a [bookmark shape](https://tldraw.dev/sdk-features/default-shapes#bookmark) instead of an embed. An existing embed shape whose URL doesn't match any definition still renders the URL in an iframe, using the stricter sandbox for unknown sources.
+When you paste a URL that no embed definition recognizes, the default URL handler creates a [bookmark shape](https://tldraw.dev/sdk-features/default-shapes#Bookmark) instead of an embed. An existing embed shape whose URL doesn't match any definition still renders the URL in an iframe, using the stricter sandbox for unknown sources.
 
 Use `getEmbedInfo` to check whether a URL is embeddable before creating a shape:
 
@@ -9899,7 +9903,7 @@ Embed shapes render as blank rectangles in SVG exports. The iframe content can't
 #### Related articles
 
 - [Default shapes](https://tldraw.dev/sdk-features/default-shapes) — Overview of all built-in shape types
-- [Bookmark shape](https://tldraw.dev/sdk-features/default-shapes#bookmark) — URL link cards (fallback for non-embeddable URLs)
+- [Bookmark shape](https://tldraw.dev/sdk-features/default-shapes#Bookmark) — URL link cards (fallback for non-embeddable URLs)
 - [External content handling](https://tldraw.dev/sdk-features/external-content) — Handling pasted and dropped content
 - [Custom embeds example](https://tldraw.dev/examples/configuration/custom-embed) — Add a custom embed definition for a new service
 
@@ -10856,7 +10860,7 @@ Empty names render as `Frame` so unnamed frames still get a label. The shape's `
 
 Frames clip their children to the frame's rectangle during rendering. A shape that extends past the frame edge is rendered up to the boundary and then cut off. Clipping doesn't change the child's geometry or its own bounds, but hit testing respects the mask: you can't click the clipped-off part of a shape, and `Editor#getShapeMaskedPageBounds` returns only the visible portion. Arrows are exempt from clipping so connectors can leave a frame.
 
-The `BaseFrameLikeShapeUtil` base class implements clipping via `getClipPath` and the arrow exemption via `shouldClipChild`. If you need clipping for a custom container shape, see the [Frames](https://tldraw.dev/sdk-features/shapes#frames) section in the Shapes guide.
+The `BaseFrameLikeShapeUtil` base class implements clipping via `getClipPath` and the arrow exemption via `shouldClipChild`. If you need clipping for a custom container shape, see the [Frames](https://tldraw.dev/sdk-features/shapes#Frames) section in the Shapes guide.
 
 #### Shape properties
 
@@ -10948,8 +10952,8 @@ Reach for a frame when you want a labeled, bounded region: a slide, a screen, an
 
 #### Related articles
 
-- [Shapes](https://tldraw.dev/sdk-features/shapes#frames) — How to build your own container shape with `BaseFrameLikeShapeUtil`
-- [Default shapes](https://tldraw.dev/sdk-features/default-shapes#frame) — Overview of all built-in shapes
+- [Shapes](https://tldraw.dev/sdk-features/shapes#Frames) — How to build your own container shape with `BaseFrameLikeShapeUtil`
+- [Default shapes](https://tldraw.dev/sdk-features/default-shapes#Frame) — Overview of all built-in shapes
 - [Shape clipping](https://tldraw.dev/sdk-features/shape-clipping) — How custom shapes can clip their children
 - [Image export](https://tldraw.dev/sdk-features/image-export) — Exporting frames and selections as images
 - [Parenting](https://tldraw.dev/sdk-features/parenting) — How shapes are nested inside containers
@@ -13214,7 +13218,7 @@ When tool lock is enabled, the current tool stays active after creating a shape
 editor.updateInstanceState({ isToolLocked: true })
 ```
 
-Custom tools should check this property to decide whether to return to select after completing their action. See [Tools](https://tldraw.dev/sdk-features/tools#tool-lock) for implementation details.
+Custom tools should check this property to decide whether to return to select after completing their action. See [Tools](https://tldraw.dev/sdk-features/tools#Tool-lock) for implementation details.
 
 ##### Cursor customization
 
@@ -13273,7 +13277,7 @@ When you switch pages, the instance's `currentPageId` changes, but each page ret
 - [Cursors](https://tldraw.dev/sdk-features/cursors) — Cursor types and rotation handling
 - [Readonly mode](https://tldraw.dev/sdk-features/readonly) — Disable editing with `isReadonly`
 - [Focus](https://tldraw.dev/sdk-features/focus) — Editor focus state with `isFocused`
-- [Tools](https://tldraw.dev/sdk-features/tools#tool-lock) — Tool lock behavior with `isToolLocked`
+- [Tools](https://tldraw.dev/sdk-features/tools#Tool-lock) — Tool lock behavior with `isToolLocked`
 - [User preferences](https://tldraw.dev/sdk-features/user-preferences) — Global preferences that persist across editor instances
 
 #### Related examples
@@ -13714,7 +13718,7 @@ Even with `ignoreShapeLock: true`, some behaviors remain unchanged: locked shape
 
 Some shapes have interactive content that should remain usable even when locked. Embed shapes (YouTube videos, Figma files, interactive maps) are a good example: you might want the embed locked in place but still playable or navigable.
 
-[ShapeUtils](https://tldraw.dev/sdk-features/shapes#shapeutil) can override `ShapeUtil#canEditWhileLocked` (default `false`) to allow editing interactions on locked shapes. The built-in embed shape returns `true` unless its embed definition says otherwise:
+[ShapeUtils](https://tldraw.dev/sdk-features/shapes#ShapeUtil) can override `ShapeUtil#canEditWhileLocked` (default `false`) to allow editing interactions on locked shapes. The built-in embed shape returns `true` unless its embed definition says otherwise:
 
 ```typescript
 class MyInteractiveShapeUtil extends ShapeUtil<MyShape> {
@@ -13848,7 +13852,7 @@ See the [note resizing example](https://tldraw.dev/examples/configuration/resize
 
 #### Dynamic resize mode
 
-When `editor.user.getIsDynamicResizeMode()` is true, new notes are created at a scale inversely proportional to the current zoom level, so they stay visually consistent regardless of zoom. `Editor#getResizeScaleFactor` returns that scale. See [Text shape](https://tldraw.dev/sdk-features/text-shape#dynamic-resize-mode) for details.
+When `editor.user.getIsDynamicResizeMode()` is true, new notes are created at a scale inversely proportional to the current zoom level, so they stay visually consistent regardless of zoom. `Editor#getResizeScaleFactor` returns that scale. See [Text shape](https://tldraw.dev/sdk-features/text-shape#Dynamic-resize-mode) for details.
 
 #### Related articles
 
@@ -13927,7 +13931,7 @@ Control when pointer movement becomes a drag operation:
 | `uiDragDistanceSquared`       | 16      | Distance² for UI element drag (4px)      |
 | `uiCoarseDragDistanceSquared` | 625     | Distance² for touch UI drag (25px)       |
 
-Values are squared to avoid computing square roots during drag detection. The larger touch thresholds prevent accidental drags on mobile devices.
+Values are squared to avoid computing square roots during drag detection. The larger touch thresholds prevent accidental drags on mobile devices. The UI thresholds govern dragging a tool out of the toolbar. A drag starts once the pointer has left the toolbar, so they matter only for presses that begin near its edge.
 
 ##### Handle and hit testing
 
@@ -14181,7 +14185,7 @@ function App() {
 }
 ```
 
-See [Embed shape](https://tldraw.dev/sdk-features/embed-shape#custom-embed-definitions) for the full embed definition API.
+See [Embed shape](https://tldraw.dev/sdk-features/embed-shape#Custom-embed-definitions) for the full embed definition API.
 
 ##### Editor setup
 
@@ -18086,7 +18090,7 @@ Snapshots include schema version information. When you load a snapshot from an o
 const migrated = editor.store.migrateSnapshot(oldSnapshot)
 ```
 
-The migration system handles schema changes between tldraw versions. You can also define migrations for custom shape props and custom record types. See [persistence](https://tldraw.dev/sdk-features/persistence#migrations) for details.
+The migration system handles schema changes between tldraw versions. You can also define migrations for custom shape props and custom record types. See [persistence](https://tldraw.dev/sdk-features/persistence#Migrations) for details.
 
 #### Queries
 
@@ -20446,7 +20450,7 @@ export default function App() {
 
 Preferences cover visual settings (color scheme, animation speed), interaction settings (snap mode, edge scroll speed), and identity (user name, color, locale). By default the editor stores them in localStorage and syncs them across tabs with a BroadcastChannel.
 
-To supply preferences from your own auth or state instead, pass a `user` created with `useTldrawCurrentUser` (or `createTLCurrentUser`) to the `Tldraw` component. Preferences you provide this way are yours to persist and sync. See [Collaboration](https://tldraw.dev/sdk-features/collaboration#integrating-with-usetldrawcurrentuser) for a full example.
+To supply preferences from your own auth or state instead, pass a `user` created with `useTldrawCurrentUser` (or `createTLCurrentUser`) to the `Tldraw` component. Preferences you provide this way are yours to persist and sync. See [Collaboration](https://tldraw.dev/sdk-features/collaboration#Integrating-with-useTldrawCurrentUser) for a full example.
 
 #### Reading preferences
 
@@ -20527,7 +20531,7 @@ const isDark = editor.user.getIsDarkMode()
 // true if colorScheme is 'dark', or 'system' with OS in dark mode
 ```
 
-The editor-level `colorScheme` prop sets the default color scheme. When a user preference is set, it takes priority over the prop. See [Themes](https://tldraw.dev/sdk-features/themes#color-mode) for more.
+The editor-level `colorScheme` prop sets the default color scheme. When a user preference is set, it takes priority over the prop. See [Themes](https://tldraw.dev/sdk-features/themes#Color-mode) for more.
 
 #### Persistence and synchronization
 
@@ -20900,3 +20904,62 @@ While the tldraw SDK is [source available](https://github.com/tldraw/tldraw), it
 If you wish to include tldraw in an open source project, you may do so but the SDK itself must remain under its original license. This means that you and your downstream users will require their own trial, commercial, or hobby license in order to use the SDK in production. In this case, please also see our [trademark guidelines](https://tldraw.dev/legal/trademark-guidelines) that limit the use of the tldraw name and branding.
 
 The tldraw SDK is a product of a company. See [tldraw.dev](https://tldraw.dev/company) for more information about the company and the team.
+
+### Dependencies
+
+{/* This page is generated by `yarn license-report --prod`. Do not edit it by hand. */}
+
+The tldraw SDK itself is published under the [tldraw license](https://tldraw.dev/legal/tldraw-license). It also depends on the third-party packages listed below, each under its own license.
+
+This covers the runtime dependencies that the `@tldraw/*` packages declare directly. It does not include their own transitive dependencies, our development and build tooling, or anything in the tldraw.com application. If you need a full transitive list for the exact versions you have installed, generate one from your own lockfile.
+
+#### Dependencies
+
+| Dependency                                                          | Version | License | Used by                                      |
+| ------------------------------------------------------------------- | ------- | ------- | -------------------------------------------- |
+| [@tiptap/core](https://github.com/ueberdosis/tiptap)                | 3.13.0  | MIT     | `commenting`, `editor`, `mentions`, `tldraw` |
+| [@tiptap/extension-code](https://github.com/ueberdosis/tiptap)      | 3.13.0  | MIT     | `tldraw`                                     |
+| [@tiptap/extension-highlight](https://github.com/ueberdosis/tiptap) | 3.13.0  | MIT     | `tldraw`                                     |
+| [@tiptap/extension-list](https://github.com/ueberdosis/tiptap)      | 3.13.0  | MIT     | `tldraw`                                     |
+| [@tiptap/extension-mention](https://github.com/ueberdosis/tiptap)   | 3.13.0  | MIT     | `mentions`                                   |
+| [@tiptap/pm](https://github.com/ueberdosis/tiptap)                  | 3.13.0  | MIT     | `commenting`, `editor`, `mentions`, `tldraw` |
+| [@tiptap/react](https://github.com/ueberdosis/tiptap)               | 3.13.0  | MIT     | `commenting`, `editor`, `mentions`, `tldraw` |
+| [@tiptap/starter-kit](https://github.com/ueberdosis/tiptap)         | 3.13.0  | MIT     | `tldraw`                                     |
+| [@tiptap/suggestion](https://github.com/ueberdosis/tiptap)          | 3.13.0  | MIT     | `mentions`                                   |
+| [classnames](https://github.com/JedWatson/classnames)               | 2.5.1   | MIT     | `editor`, `tldraw`                           |
+| [eventemitter3](https://github.com/primus/eventemitter3)            | 4.0.7   | MIT     | `editor`                                     |
+| [idb](https://github.com/jakearchibald/idb)                         | 7.1.1   | ISC     | `editor`, `tldraw`                           |
+| [is-plain-object](https://github.com/jonschlinkert/is-plain-object) | 5.0.0   | MIT     | `editor`                                     |
+| [lodash.isequal](https://github.com/lodash/lodash)                  | 4.5.0   | MIT     | `utils`                                      |
+| [lodash.isequalwith](https://github.com/lodash/lodash)              | 4.4.0   | MIT     | `utils`                                      |
+| [lodash.throttle](https://github.com/lodash/lodash)                 | 4.1.1   | MIT     | `utils`                                      |
+| [lodash.uniq](https://github.com/lodash/lodash)                     | 4.5.0   | MIT     | `utils`                                      |
+| [lz-string](https://github.com/pieroxy/lz-string)                   | 1.5.0   | MIT     | `tldraw`                                     |
+| [mermaid](https://github.com/mermaid-js/mermaid)                    | 11.16.1 | MIT     | `mermaid`                                    |
+| [nanoevents](https://github.com/ai/nanoevents)                      | 7.0.1   | MIT     | `sync`, `sync-core`                          |
+| [radix-ui](https://github.com/radix-ui/primitives)                  | 1.4.2   | MIT     | `tldraw`                                     |
+| [rbush](https://github.com/mourner/rbush)                           | 3.0.1   | MIT     | `editor`                                     |
+| [ws](https://github.com/websockets/ws)                              | 8.21.0  | MIT     | `sync`, `sync-core`                          |
+
+#### Inline code
+
+Some third-party code is included directly in our source rather than as a dependency. Each of these files carries its license in a comment at the top.
+
+| File                                                       | License                                                                                                              | Copyright                                                                            |
+| ---------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------ |
+| `packages/create-tldraw/src/group-select.ts`               | [MIT](https://github.com/bombshell-dev/clack/blob/1adb270af5509ead3d22c4fa602b465f39c7a8c2/packages/prompts/LICENSE) | Nate Moore                                                                           |
+| `packages/create-tldraw/src/wrap-ansi.ts`                  | [MIT](https://github.com/chalk/wrap-ansi/blob/163b878a6eb5d8c32b7bbea65036eeadc0e4def9/license)                      | Sindre Sorhus &lt;sindresorhus@gmail.com&gt; (https://sindresorhus.com)              |
+| `packages/editor/src/lib/hooks/useScreenBounds.ts`         | [MIT](https://github.com/excalidraw/excalidraw/blob/master/LICENSE)                                                  |                                                                                      |
+| `packages/editor/src/lib/hooks/useViewportHeight.ts`       | [BSD](https://github.com/outline/rich-markdown-editor/blob/main/LICENSE)                                             | 2020 General Outline, Inc (https://www.getoutline.com/) and individual contributors. |
+| `packages/editor/src/lib/utils/browserCanvasMaxSize.ts`    | [MIT](https://github.com/jhildenbiddle/canvas-size/blob/master/LICENSE)                                              | John Hildenbiddle                                                                    |
+| `packages/store/src/lib/ImmutableMap.ts`                   | [MIT](https://github.com/immutable-js/immutable-js/blob/main/LICENSE)                                                | 2014-present, Lee Byron and other contributors.                                      |
+| `packages/tldraw/src/lib/shapes/shared/PathBuilder.tsx`    | [Apache](https://github.com/adobe-webplatform/Snap.svg/blob/master/LICENSE)                                          |                                                                                      |
+| `packages/tldraw/src/lib/ui/hooks/useKeyboardShortcuts.ts` | [MIT](https://github.com/jaywcjlove/hotkeys-js/blob/master/LICENSE)                                                  | 2015-present, Kenny Wong                                                             |
+| `packages/tldraw/src/lib/ui/kbd-utils.ts`                  | [MIT](https://github.com/jaywcjlove/hotkeys-js/blob/master/LICENSE)                                                  | 2015-present, Kenny Wong                                                             |
+| `packages/tldraw/src/lib/utils/svg/sanitizeSvg.ts`         | MIT                                                                                                                  | 2015 Mario Heiderich                                                                 |
+| `packages/utils/src/lib/bind.ts`                           | [MIT](https://github.com/NoHomey/bind-decorator/blob/master/License)                                                 | 2016 Ivo Stratev                                                                     |
+| `packages/utils/src/lib/id.ts`                             | [MIT](https://github.com/ai/nanoid/blob/main/LICENSE)                                                                | 2017 Andrey Sitnik &lt;andrey@sitnik.ru&gt;                                          |
+| `packages/utils/src/lib/media/apng.ts`                     | [MIT](https://github.com/vHeemstra/is-apng/blob/main/license)                                                        | Philip van Heemstra                                                                  |
+| `packages/utils/src/lib/media/gif.ts`                      | MIT                                                                                                                  | 2016 Józef Sokołowski &lt;j.k.sokolowski@gmail.com&gt;                               |
+| `packages/utils/src/lib/media/png.ts`                      | [MIT](https://github.com/alexgorbatchev/crc/blob/master/LICENSE)                                                     | 2014 Alex Gorbatchev                                                                 |
+| `packages/utils/src/lib/media/webp.ts`                     | [MIT](https://github.com/sindresorhus/is-webp/blob/main/license)                                                     | Sindre Sorhus &lt;sindresorhus@gmail.com&gt; (https://sindresorhus.com)              |

package/RELEASE_NOTES.md

@@ -1,23 +1,9 @@
 # Releases
 
-Version: `5.4.2`
+Version: `5.5.0-canary.0241f11f2e99`
 
 This file is generated during package publishing from the tldraw release notes content for this exact package version.
 
-## v5.4.2
-
-So far this release is a set of fixes: camera coasting and edge scrolling now move at the same rate on high-refresh displays, rotated images stay put when a crop changes their size, and embed hostname matching no longer trusts lookalike hosts.
-
-### Bug fixes
-
-- Fix camera coasting after a fling, and edge scrolling, running roughly twice as fast on a 120 Hz display as on a 60 Hz one. Both now scale by the elapsed tick time, so motion per second is the same at any refresh rate. ([#10501](https://github.com/tldraw/tldraw/pull/10501))
-- Fix rotated images jumping on the canvas when their aspect ratio or crop zoom changed, or when the image was replaced. ([#10233](https://github.com/tldraw/tldraw/pull/10233))
-- Fix embed hostname matching trusting lookalike hosts such as `tldraw.com.evil.io`, which were rendered with the matched definition's relaxed iframe permissions. A host must now be the pattern itself or a subdomain of it. ([#10196](https://github.com/tldraw/tldraw/pull/10196))
-- Fix geometry hit tests, nearest-point, and length calculations losing precision after a shape's SVG path data was generated. `getSvgPathData` rounded the geometry's stored points to two decimals in place, and geometries are cached per shape, so every later calculation used the rounded points. ([#10600](https://github.com/tldraw/tldraw/pull/10600))
-- Fix keyboard shape navigation, and `Editor.selectAdjacentShape('prev')`, selecting the second-to-last shape instead of the last one when nothing is selected. ([#10601](https://github.com/tldraw/tldraw/pull/10601))
-- Fix `Editor.getCurrentTheme()` returning `undefined` after `setCurrentTheme()` was called with an unregistered theme id. The call is now rejected and the current theme is kept. ([#10602](https://github.com/tldraw/tldraw/pull/10602))
-- Fix `Group2d.transform` dropping its ignored children, resetting the `isInternal`, `excludeFromShapeBounds`, and `isEmptyLabel` flags, and discarding its `opts` argument. It now matches the base `Geometry2d.transform` signature. ([#10603](https://github.com/tldraw/tldraw/pull/10603))
-
 ## v5.4.0
 
 [View on GitHub](https://github.com/tldraw/tldraw/releases/tag/v5.4.0)
@@ -191,6 +177,16 @@ This release adds a `center` operation to `Editor.alignShapes`, a `tleditors` re
 - Fix the `store.query.ids()` query creator being called with a computed's `(previousValue, epoch)` arguments. ([#10218](https://github.com/tldraw/tldraw/pull/10218))
 - Fix `CollectionDiff`s from `store.query.ids()` and `index()` containing an empty `added` or `removed` set after an add/remove round trip. ([#10221](https://github.com/tldraw/tldraw/pull/10221))
 
+---
+
+### Patch releases
+
+#### v5.4.1
+
+- Fix the context menu not reopening after a left-click dismissal when radix-ui 1.5 or later is installed. ([#10567](https://github.com/tldraw/tldraw/pull/10567))
+
+[View release on GitHub](https://github.com/tldraw/tldraw/releases/tag/v5.4.1)
+
 ## v5.3.0
 
 [View on GitHub](https://github.com/tldraw/tldraw/releases/tag/v5.3.0)
@@ -1401,7 +1397,7 @@ declare module 'tldraw' {
 type MyBinding = TLBinding`<'my-binding'>`
 ```
 
-See the [Custom Shapes Guide](https://tldraw.dev/docs/shapes#custom-shapes) and the [Pin Bindings example](https://github.com/tldraw/tldraw/tree/main/apps/examples/src/examples/shapes/tools/pin-bindings) for details.
+See the [Custom Shapes Guide](https://tldraw.dev/docs/shapes#Custom-shapes) and the [Pin Bindings example](https://github.com/tldraw/tldraw/tree/main/apps/examples/src/examples/shapes/tools/pin-bindings) for details.
 
 **After registering, remove the `TLBaseShape` import** — it's no longer used and will trip lint rules that flag unused imports.
 

package/dist-cjs/index.js

@@ -653,7 +653,7 @@ var import_buildFromV1Document = require("./lib/utils/tldr/buildFromV1Document")
 var import_file = require("./lib/utils/tldr/file");
 (0, import_editor.registerTldrawLibraryVersion)(
   "tldraw",
-  "5.4.2",
+  "5.5.0-canary.0241f11f2e99",
   "cjs"
 );
 //# sourceMappingURL=index.js.map

package/dist-cjs/lib/shapes/draw/toolStates/Drawing.js

@@ -103,8 +103,13 @@ class Drawing extends import_editor.StateNode {
           break;
         }
         case "starting_straight": {
-          this.pagePointWhereNextSegmentChanged = null;
-          this.segmentMode = "free";
+          const shape = this.initialShape && this.editor.getShape(this.initialShape.id);
+          if (shape && (0, import_editor.last)(shape.props.segments)?.type === "straight") {
+            this.segmentMode = "starting_free";
+          } else {
+            this.pagePointWhereNextSegmentChanged = null;
+            this.segmentMode = "free";
+          }
           break;
         }
       }