TldrawOptions

Where the quick actions render.

Gap left when placing an adjacent shape, duplicating, stacking or packing.

Duration of a medium-length camera animation: zoom to fit, zoom to selection.

The application's name, used in accessibility labels ("Canvas for <branding>").

Accepted and used for labelling only. mocanvas paints no watermark and performs no licence check, so there is no vendor branding for this to turn on or off — the label is the whole of it.

The camera's starting policy. Change it later with Editor.setCameraOptions.

How long after the last camera write the camera counts as settled.

How quickly a flung camera loses speed. 0…1; higher stops sooner.

The same threshold for a coarse pointer, where a still finger still wobbles.

Handle radius for a coarse pointer.

Hit-test tolerance for a coarse pointer.

Assumed pointer width used to widen the edge-scroll zone for touch.

How often collaborator liveness is re-checked.

After this long, a collaborator reads as idle.

After this long without a presence refresh, a collaborator stops being drawn.

Whether double-clicking empty canvas creates a text shape.

Serve a cached zoom level while the camera is moving, on a busy page.

Shape count above which debouncedZoom takes effect.

Mirror the camera into the URL. true for the defaults, or an options object.

Padding around exported SVG content, in page units.

Longest gap between two clicks that still counts as a double click.

How far a pointer must move before it is a drag, squared.

Squared throughout so drag detection never takes a square root: it runs on every pointer move, and the comparison is exactly as correct either way.

How long the pointer must sit at an edge before scrolling starts.

Width of the band at the viewport edge that triggers scrolling.

How long scrolling takes to reach full speed.

Screen pixels per frame at full speed, before the user's speed preference.

Whether the number keys select toolbar items.

Called when something is dropped on the canvas, before the editor's own handling. Return true to claim the drop.

Named experimental__ because its signature is expected to change; it is here because there is no other way to intercept a drop before assets are created for it.

A React provider wrapped around exported content.

Export renders shapes outside the editor's own tree, so a custom shape that reads a context — a theme, an i18n provider — renders wrong (or throws) unless that context is re-established here.

How far image bounds are expanded when flattening a selection to one image.

Padding added when flattening a selection to one image.

How close the viewport must get to a followed collaborator's before it snaps.

The grid's bands, coarsest first. See TLGridStep.

Radius of a selection handle's hit area, in screen pixels.

Extra tolerance around a shape when hit testing, in screen pixels.

How long the laser trail stays fully visible.

How long the laser trail takes to fade.

How long a press must last to become a long press.

How long an export waits for fonts and images before giving up.

Most files accepted from a single drop or paste.

How many fonts to wait for before the canvas is shown at all.

Most pages a document may hold. Set to 1 to make the document single-page.

Most shapes one page may hold. Creating past it is refused and reported.

Window in which a further click extends a multi-click.

CSP nonce stamped on any style tag the editor injects.

Called before a selection is written to the clipboard by copy or cut.

Return modified content to transform it, false to cancel the write, or nothing to pass it through untouched.

Called after a paste has been parsed but before any shape is created. Only fires for a paste — a file drop does not go through the clipboard.

Called first for a keyboard or menu paste, before the editor tries to parse the clipboard at all. Return false to take the paste over completely.

Whether the quick-zoom brush keeps the viewport's scale.

Whether dragging with the right button pans.

Whether a locked shape can be clicked or brushed into a selection.

Distance, in screen pixels, at which snapping takes hold.

Whether holding space turns the pointer into a pan.

How long a temporary asset preview stays paintable before it expires.

Rich-text configuration. Also accepted as the top-level textOptions.

Zoom below which text shadows stop being drawn.

How long a tooltip waits before appearing.

UI drag threshold for a coarse pointer.

Drag threshold for UI elements rather than canvas content.

Padding left around the content by zoomToFit and friends.