@tldraw/editor 4.3.0-next.f4772c19540d → 4.3.0

package/dist-cjs/index.d.ts

@@ -1,4 +1,5 @@
 import { Atom } from '@tldraw/state';
+import { AtomSet } from '@tldraw/store';
 import { BoxModel } from '@tldraw/tlschema';
 import { ComponentType } from 'react';
 import { Computed } from '@tldraw/state';
@@ -7,11 +8,13 @@ import { Editor as Editor_2 } from '@tiptap/core';
 import { EditorProviderProps as EditorProviderProps_2 } from '@tiptap/react';
 import EventEmitter from 'eventemitter3';
 import { ExoticComponent } from 'react';
+import { ExtractShapeByProps } from '@tldraw/tlschema';
 import { ForwardRefExoticComponent } from 'react';
+import { FragmentProps } from 'react';
 import { HistoryEntry } from '@tldraw/store';
 import { IndexKey } from '@tldraw/utils';
 import { JsonObject } from '@tldraw/utils';
-import { JSX as JSX_2 } from 'react/jsx-runtime';
+import { JSX } from 'react/jsx-runtime';
 import { LegacyMigrations } from '@tldraw/store';
 import { MigrationSequence } from '@tldraw/store';
 import { NamedExoticComponent } from 'react';
@@ -48,6 +51,7 @@ import { TLBindingId } from '@tldraw/tlschema';
 import { TLBindingUpdate } from '@tldraw/tlschema';
 import { TLBookmarkAsset } from '@tldraw/tlschema';
 import { TLCamera } from '@tldraw/tlschema';
+import { TLCreateShapePartial } from '@tldraw/tlschema';
 import { TLCursor } from '@tldraw/tlschema';
 import { TLCursorType } from '@tldraw/tlschema';
 import { TLDefaultDashStyle } from '@tldraw/tlschema';
@@ -147,7 +151,7 @@ export declare abstract class BaseBoxShapeTool extends StateNode {
     static id: string;
     static initial: string;
     static children(): TLStateNodeConstructor[];
-    abstract shapeType: string;
+    abstract shapeType: TLBaseBoxShape['type'];
     onCreate?(_shape: null | TLShape): null | void;
 }
 
@@ -165,7 +169,7 @@ export declare abstract class BaseBoxShapeUtil<Shape extends TLBaseBoxShape> ext
  *
  * @public
  */
-export declare interface BindingOnChangeOptions<Binding extends TLUnknownBinding> {
+export declare interface BindingOnChangeOptions<Binding extends TLBinding = TLBinding> {
     /** The binding record before the change is made. */
     bindingBefore: Binding;
     /** The binding record after the change is made. */
@@ -178,7 +182,7 @@ export declare interface BindingOnChangeOptions<Binding extends TLUnknownBinding
  *
  * @public
  */
-export declare interface BindingOnCreateOptions<Binding extends TLUnknownBinding> {
+export declare interface BindingOnCreateOptions<Binding extends TLBinding = TLBinding> {
     /** The binding being created. */
     binding: Binding;
 }
@@ -189,7 +193,7 @@ export declare interface BindingOnCreateOptions<Binding extends TLUnknownBinding
  *
  * @public
  */
-export declare interface BindingOnDeleteOptions<Binding extends TLUnknownBinding> {
+export declare interface BindingOnDeleteOptions<Binding extends TLBinding = TLBinding> {
     /** The binding being deleted. */
     binding: Binding;
 }
@@ -200,7 +204,7 @@ export declare interface BindingOnDeleteOptions<Binding extends TLUnknownBinding
  *
  * @public
  */
-export declare interface BindingOnShapeChangeOptions<Binding extends TLUnknownBinding> {
+export declare interface BindingOnShapeChangeOptions<Binding extends TLBinding = TLBinding> {
     /** The binding record linking these two shapes. */
     binding: Binding;
     /** The shape record before the change is made. */
@@ -224,7 +228,7 @@ export declare interface BindingOnShapeChangeOptions<Binding extends TLUnknownBi
  *
  * @public
  */
-export declare interface BindingOnShapeDeleteOptions<Binding extends TLUnknownBinding> {
+export declare interface BindingOnShapeDeleteOptions<Binding extends TLBinding = TLBinding> {
     /** The binding record that refers to the shape in question. */
     binding: Binding;
     /** The shape that is about to be deleted. */
@@ -256,7 +260,7 @@ export declare interface BindingOnShapeDeleteOptions<Binding extends TLUnknownBi
  *
  * @public
  */
-export declare interface BindingOnShapeIsolateOptions<Binding extends TLUnknownBinding> {
+export declare interface BindingOnShapeIsolateOptions<Binding extends TLBinding = TLBinding> {
     /** The binding record that refers to the shape in question. */
     binding: Binding;
     /**
@@ -267,7 +271,7 @@ export declare interface BindingOnShapeIsolateOptions<Binding extends TLUnknownB
 }
 
 /** @public */
-export declare abstract class BindingUtil<Binding extends TLUnknownBinding = TLUnknownBinding> {
+export declare abstract class BindingUtil<Binding extends TLBinding = TLBinding> {
     editor: Editor;
     constructor(editor: Editor);
     static props?: RecordProps<TLUnknownBinding>;
@@ -486,6 +490,7 @@ export declare class Box {
     get cornersAndCenter(): Vec[];
     get sides(): Array<[Vec, Vec]>;
     get size(): Vec;
+    isValid(): boolean;
     toFixed(): this;
     setTo(B: Box): this;
     set(x?: number, y?: number, w?: number, h?: number): this;
@@ -653,7 +658,7 @@ export declare function clockwiseAngleDist(a0: number, a1: number): number;
  * @public
  * @react
  */
-export declare function ContainerProvider({ container, children }: ContainerProviderProps): JSX_2.Element;
+export declare function ContainerProvider({ container, children }: ContainerProviderProps): JSX.Element;
 
 /** @public */
 export declare interface ContainerProviderProps {
@@ -794,16 +799,16 @@ export declare interface DebugFlagDefaults<T> {
 /* Excluded from this release type: DEFAULT_CAMERA_OPTIONS */
 
 /** @public @react */
-export declare function DefaultBackground(): JSX_2.Element;
+export declare function DefaultBackground(): JSX.Element;
 
 /** @public @react */
-export declare const DefaultBrush: ({ brush, color, opacity, className }: TLBrushProps) => JSX_2.Element;
+export declare const DefaultBrush: ({ brush, color, opacity, className }: TLBrushProps) => JSX.Element;
 
 /** @public @react */
-export declare function DefaultCanvas({ className }: TLCanvasComponentProps): JSX_2.Element;
+export declare function DefaultCanvas({ className }: TLCanvasComponentProps): JSX.Element;
 
 /** @public @react */
-export declare function DefaultCollaboratorHint({ className, zoom, point, color, viewport, opacity, }: TLCollaboratorHintProps): JSX_2.Element;
+export declare function DefaultCollaboratorHint({ className, zoom, point, color, viewport, opacity, }: TLCollaboratorHintProps): JSX.Element;
 
 /** @public @react */
 export declare const DefaultCursor: NamedExoticComponent<TLCursorProps>;
@@ -812,22 +817,22 @@ export declare const DefaultCursor: NamedExoticComponent<TLCursorProps>;
 export declare const DefaultErrorFallback: TLErrorFallbackComponent;
 
 /** @public @react */
-export declare function DefaultGrid({ x, y, z, size }: TLGridProps): JSX_2.Element;
+export declare function DefaultGrid({ x, y, z, size }: TLGridProps): JSX.Element;
 
 /** @public @react */
-export declare function DefaultHandle({ handle, isCoarse, className, zoom }: TLHandleProps): JSX_2.Element;
+export declare function DefaultHandle({ handle, isCoarse, className, zoom }: TLHandleProps): JSX.Element;
 
 /** @public @react */
-export declare const DefaultHandles: ({ children }: TLHandlesProps) => JSX_2.Element;
+export declare const DefaultHandles: ({ children }: TLHandlesProps) => JSX.Element;
 
 /** @public @react */
-export declare function DefaultScribble({ scribble, zoom, color, opacity, className }: TLScribbleProps): JSX_2.Element | null;
+export declare function DefaultScribble({ scribble, zoom, color, opacity, className }: TLScribbleProps): JSX.Element | null;
 
 /** @public @react */
-export declare function DefaultSelectionBackground({ bounds, rotation }: TLSelectionBackgroundProps): JSX_2.Element;
+export declare function DefaultSelectionBackground({ bounds, rotation }: TLSelectionBackgroundProps): JSX.Element;
 
 /** @public @react */
-export declare function DefaultSelectionForeground({ bounds, rotation }: TLSelectionForegroundProps): JSX_2.Element;
+export declare function DefaultSelectionForeground({ bounds, rotation }: TLSelectionForegroundProps): JSX.Element;
 
 /** @public @react */
 export declare const DefaultShapeIndicator: NamedExoticComponent<TLShapeIndicatorProps>;
@@ -839,10 +844,10 @@ export declare const DefaultShapeIndicators: NamedExoticComponent<TLShapeIndicat
 export declare const DefaultShapeWrapper: ForwardRefExoticComponent<TLShapeWrapperProps & RefAttributes<HTMLDivElement>>;
 
 /** @public @react */
-export declare function DefaultSnapIndicator({ className, line, zoom }: TLSnapIndicatorProps): JSX_2.Element;
+export declare function DefaultSnapIndicator({ className, line, zoom }: TLSnapIndicatorProps): JSX.Element;
 
 /** @public @react */
-export declare function DefaultSpinner(props: React.SVGProps<SVGSVGElement>): JSX_2.Element;
+export declare function DefaultSpinner(props: React.SVGProps<SVGSVGElement>): JSX.Element;
 
 /** @public @react */
 export declare const DefaultSvgDefs: () => null;
@@ -861,6 +866,8 @@ export declare const defaultTldrawOptions: {
     readonly collaboratorIdleTimeoutMs: 3000;
     readonly collaboratorInactiveTimeoutMs: 60000;
     readonly createTextOnCanvasDoubleClick: true;
+    readonly debouncedZoom: true;
+    readonly debouncedZoomThreshold: 500;
     readonly defaultSvgPadding: 32;
     readonly doubleClickDurationMs: 450;
     readonly dragDistanceSquared: 16;
@@ -869,9 +876,7 @@ export declare const defaultTldrawOptions: {
     readonly edgeScrollEaseDuration: 200;
     readonly edgeScrollSpeed: 25;
     readonly enableToolbarKeyboardShortcuts: true;
-    readonly exportProvider: ExoticComponent<    {
-    children?: ReactNode | undefined;
-    }>;
+    readonly exportProvider: ExoticComponent<FragmentProps>;
     readonly flattenImageBoundsExpand: 64;
     readonly flattenImageBoundsPadding: 16;
     readonly followChaseViewportSnap: 2;
@@ -903,11 +908,14 @@ export declare const defaultTldrawOptions: {
     readonly maxShapesPerPage: 4000;
     readonly multiClickDurationMs: 200;
     readonly nonce: undefined;
+    readonly snapThreshold: 8;
+    readonly spacebarPanning: true;
     readonly temporaryAssetPreviewLifetimeMs: 180000;
     readonly textShadowLod: 0.35;
     readonly tooltipDelayMs: 700;
     readonly uiCoarseDragDistanceSquared: 625;
     readonly uiDragDistanceSquared: 16;
+    readonly zoomToFitPadding: 128;
 };
 
 /** @public */
@@ -981,6 +989,7 @@ export declare class EdgeScrollManager {
     constructor(editor: Editor);
     private _isEdgeScrolling;
     private _edgeScrollDuration;
+    getIsEdgeScrolling(): boolean;
     /**
      * Update the camera position when the mouse is close to the edge of the screen.
      * Run this on every tick when in a state where edge scrolling is enabled.
@@ -1039,7 +1048,7 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      */
     removeTool(Tool: TLStateNodeConstructor, parent?: StateNode): void;
     /**
-     * A set of functions to call when the app is disposed.
+     * A set of functions to call when the editor is disposed.
      *
      * @public
      */
@@ -1052,7 +1061,13 @@ export declare class Editor extends EventEmitter<TLEventMap> {
     isDisposed: boolean;
     /* Excluded from this release type: _tickManager */
     /**
-     * A manager for the app's snapping feature.
+     * A manager for the editor's input state.
+     *
+     * @public
+     */
+    readonly inputs: InputsManager;
+    /**
+     * A manager for the editor's snapping feature.
      *
      * @public
      */
@@ -1129,7 +1144,7 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      * @public
      */
     shapeUtils: {
-        readonly [K in string]?: ShapeUtil<TLUnknownShape>;
+        readonly [K in string]?: ShapeUtil<TLShape>;
     };
     styleProps: {
         [key: string]: Map<StyleProp<any>, string>;
@@ -1149,16 +1164,18 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      *
      * @public
      */
-    getShapeUtil<S extends TLUnknownShape>(shape: S | TLShapePartial<S>): ShapeUtil<S>;
-    getShapeUtil<S extends TLUnknownShape>(type: S['type']): ShapeUtil<S>;
+    getShapeUtil<K extends TLShape['type']>(type: K): ShapeUtil<Extract<TLShape, {
+        type: K;
+    }>>;
+    getShapeUtil<S extends TLShape>(shape: S | S['type'] | TLShapePartial<S>): ShapeUtil<S>;
     getShapeUtil<T extends ShapeUtil>(type: T extends ShapeUtil<infer R> ? R['type'] : string): T;
     /**
      * Returns true if the editor has a shape util for the given shape / shape type.
      *
      * @param shape - A shape, shape partial, or shape type.
      */
-    hasShapeUtil<S extends TLUnknownShape>(shape: S | TLShapePartial<S>): boolean;
-    hasShapeUtil<S extends TLUnknownShape>(type: S['type']): boolean;
+    hasShapeUtil(shape: TLShape | TLShapePartial<TLShape>): boolean;
+    hasShapeUtil(type: TLShape['type']): boolean;
     hasShapeUtil<T extends ShapeUtil>(type: T extends ShapeUtil<infer R> ? R['type'] : string): boolean;
     /**
      * A map of shape utility classes (TLShapeUtils) by shape type.
@@ -1166,7 +1183,7 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      * @public
      */
     bindingUtils: {
-        readonly [K in string]?: BindingUtil<TLUnknownBinding>;
+        readonly [K in string]?: BindingUtil<TLBinding>;
     };
     /**
      * Get a binding util from a binding itself.
@@ -1183,13 +1200,15 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      *
      * @public
      */
-    getBindingUtil<S extends TLUnknownBinding>(binding: {
+    getBindingUtil<K extends TLBinding['type']>(type: K): BindingUtil<Extract<TLBinding, {
+        type: K;
+    }>>;
+    getBindingUtil<S extends TLBinding>(binding: {
         type: S['type'];
     } | S): BindingUtil<S>;
-    getBindingUtil<S extends TLUnknownBinding>(type: S['type']): BindingUtil<S>;
     getBindingUtil<T extends BindingUtil>(type: T extends BindingUtil<infer R> ? R['type'] : string): T;
     /**
-     * A manager for the app's history.
+     * A manager for the editor's history.
      *
      * @readonly
      */
@@ -1206,10 +1225,11 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      */
     undo(): this;
     /**
-     * Whether the app can undo.
+     * Whether the editor can undo.
      *
      * @public
      */
+    canUndo(): boolean;
     getCanUndo(): boolean;
     /**
      * Redo to the next mark.
@@ -1222,13 +1242,14 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      * @public
      */
     redo(): this;
-    clearHistory(): this;
     /**
-     * Whether the app can redo.
+     * Whether the editor can redo.
      *
      * @public
      */
+    canRedo(): boolean;
     getCanRedo(): boolean;
+    clearHistory(): this;
     /**
      * Create a new "mark", or stopping point, in the undo redo history. Creating a mark will clear
      * any redos. You typically want to do this just before a user interaction begins or is handled.
@@ -1587,7 +1608,7 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      */
     selectNone(): this;
     /**
-     * The id of the app's only selected shape.
+     * The id of the editor's only selected shape.
      *
      * @returns Null if there is no shape or more than one selected shape, otherwise the selected shape's id.
      *
@@ -1596,7 +1617,7 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      */
     getOnlySelectedShapeId(): null | TLShapeId;
     /**
-     * The app's only selected shape.
+     * The editor's only selected shape.
      *
      * @returns Null if there is no shape or more than one selected shape, otherwise the selected shape.
      *
@@ -1688,6 +1709,16 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      * @public
      */
     getEditingShape(): TLShape | undefined;
+    /**
+     * Whether the shape can be edited.
+     *
+     * @param shape - The shape (or shape id) to check if it can be edited.
+     * @param info - The info about the edit start.
+     *
+     * @public
+     * @returns true if the shape can be edited, false otherwise.
+     */
+    canEditShape<T extends TLShape | TLShapeId>(shape: null | T, info?: TLEditStartInfo): shape is T;
     /**
      * Set the current editing shape.
      *
@@ -1807,6 +1838,15 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      * @public
      */
     getCroppingShapeId(): null | TLShapeId;
+    /**
+     * Whether the shape can be cropped.
+     *
+     * @param shape - The shape (or shape id) to check if it can be cropped.
+     *
+     * @public
+     * @returns true if the shape can be cropped, false otherwise.
+     */
+    canCropShape<T extends TLShape | TLShapeId>(shape: null | T): shape is T;
     /**
      * Set the current cropping shape.
      *
@@ -1849,6 +1889,32 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      * @public
      */
     getZoomLevel(): number;
+    private _debouncedZoomLevel;
+    /**
+     * Get the debounced zoom level. When the camera is moving, this returns the zoom level
+     * from when the camera started moving rather than the current zoom level. This can be
+     * used to avoid expensive re-renders during camera movements.
+     *
+     * This behavior is controlled by the `useDebouncedZoom` option. When `useDebouncedZoom`
+     * is `false`, this method always returns the current zoom level.
+     *
+     * @public
+     */
+    getDebouncedZoomLevel(): number;
+    private _getAboveDebouncedZoomThreshold;
+    /**
+     * Get the efficient zoom level. This returns the current zoom level if there are less than 300 shapes on the page,
+     * otherwise it returns the debounced zoom level. This can be used to avoid expensive re-renders during camera movements.
+     *
+     * @public
+     * @example
+     * ```ts
+     * editor.getEfficientZoomLevel()
+     * ```
+     *
+     * @public
+     */
+    getEfficientZoomLevel(): number;
     /**
      * Get the camera's initial or reset zoom level.
      *
@@ -1963,7 +2029,7 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      * ```ts
      * editor.zoomIn()
      * editor.zoomIn(editor.getViewportScreenCenter(), { animation: { duration: 200 } })
-     * editor.zoomIn(editor.inputs.currentScreenPoint, { animation: { duration: 200 } })
+     * editor.zoomIn(editor.inputs.getCurrentScreenPoint(), { animation: { duration: 200 } })
      * ```
      *
      * @param point - The screen point to zoom in on. Defaults to the screen center
@@ -1979,7 +2045,7 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      * ```ts
      * editor.zoomOut()
      * editor.zoomOut(editor.getViewportScreenCenter(), { animation: { duration: 120 } })
-     * editor.zoomOut(editor.inputs.currentScreenPoint, { animation: { duration: 120 } })
+     * editor.zoomOut(editor.inputs.getCurrentScreenPoint(), { animation: { duration: 120 } })
      * ```
      *
      * @param point - The point to zoom out on. Defaults to the viewport screen center.
@@ -2192,8 +2258,8 @@ export declare class Editor extends EventEmitter<TLEventMap> {
     /* Excluded from this release type: getUnorderedRenderingShapes */
     private _cameraState;
     private _cameraStateTimeoutRemaining;
-    _decayCameraStateTimeout(elapsed: number): void;
-    _tickCameraState(): void;
+    private _decayCameraStateTimeout;
+    private _tickCameraState;
     /**
      * Whether the camera is moving or idle.
      *
@@ -2765,7 +2831,7 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      *
      * @example
      * ```ts
-     * const isArrowShape = isShapeOfType<TLArrowShape>(someShape, 'arrow')
+     * const isArrowShape = isShapeOfType(someShape, 'arrow')
      * ```
      *
      * @param util - the TLShapeUtil constructor to test against
@@ -2773,8 +2839,13 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      *
      * @public
      */
-    isShapeOfType<T extends TLUnknownShape>(shape: TLUnknownShape, type: T['type']): shape is T;
-    isShapeOfType<T extends TLUnknownShape>(shapeId: TLUnknownShape['id'], type: T['type']): shapeId is T['id'];
+    isShapeOfType<K extends TLShape['type']>(shape: TLShape, type: K): shape is Extract<TLShape, {
+        type: K;
+    }>;
+    isShapeOfType<T extends TLShape>(shape: TLShape, type: T['type']): shape is Extract<TLShape, {
+        type: T['type'];
+    }>;
+    isShapeOfType<T extends TLShape = TLShape>(shapeId: TLShapeId, type: T['type']): boolean;
     /**
      * Get a shape by its id.
      *
@@ -2925,17 +2996,26 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      * Get all bindings of a certain type _from_ a particular shape. These are the bindings whose
      * `fromId` matched the shape's ID.
      */
-    getBindingsFromShape<Binding extends TLUnknownBinding = TLBinding>(shape: TLShape | TLShapeId, type: Binding['type']): Binding[];
+    getBindingsFromShape<K extends TLBinding['type']>(shape: TLShape | TLShapeId, type: K): Extract<TLBinding, {
+        type: K;
+    }>[];
+    getBindingsFromShape<Binding extends TLBinding = TLBinding>(shape: TLShape | TLShapeId, type: Binding['type']): Binding[];
     /**
      * Get all bindings of a certain type _to_ a particular shape. These are the bindings whose
      * `toId` matches the shape's ID.
      */
-    getBindingsToShape<Binding extends TLUnknownBinding = TLBinding>(shape: TLShape | TLShapeId, type: Binding['type']): Binding[];
+    getBindingsToShape<K extends TLBinding['type']>(shape: TLShape | TLShapeId, type: K): Extract<TLBinding, {
+        type: K;
+    }>[];
+    getBindingsToShape<Binding extends TLBinding = TLBinding>(shape: TLShape | TLShapeId, type: Binding['type']): Binding[];
     /**
      * Get all bindings involving a particular shape. This includes bindings where the shape is the
      * `fromId` or `toId`. If a type is provided, only bindings of that type are returned.
      */
-    getBindingsInvolvingShape<Binding extends TLUnknownBinding = TLBinding>(shape: TLShape | TLShapeId, type?: Binding['type']): Binding[];
+    getBindingsInvolvingShape<K extends TLBinding['type']>(shape: TLShape | TLShapeId, type: K): Extract<TLBinding, {
+        type: K;
+    }>[];
+    getBindingsInvolvingShape<Binding extends TLBinding = TLBinding>(shape: TLShape | TLShapeId, type?: Binding['type']): Binding[];
     /**
      * Create bindings from a list of partial bindings. You can omit the ID and most props of a
      * binding, but the `type`, `toId`, and `fromId` must all be provided.
@@ -3250,7 +3330,7 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      *
      * @public
      */
-    canCreateShape<T extends TLUnknownShape>(shape: OptionalKeys<TLShapePartial<T>, 'id'> | T['id']): boolean;
+    canCreateShape(shape: OptionalKeys<TLShapePartial<TLShape>, 'id'> | TLShape['id']): boolean;
     /**
      * Get whether the provided shapes can be created.
      *
@@ -3258,7 +3338,7 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      *
      * @public
      */
-    canCreateShapes<T extends TLUnknownShape>(shapes: (OptionalKeys<TLShapePartial<T>, 'id'> | T['id'])[]): boolean;
+    canCreateShapes(shapes: (OptionalKeys<TLShapePartial<TLShape>, 'id'> | TLShape['id'])[]): boolean;
     /**
      * Create a single shape.
      *
@@ -3272,7 +3352,7 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      *
      * @public
      */
-    createShape<T extends TLUnknownShape>(shape: OptionalKeys<TLShapePartial<T>, 'id'>): this;
+    createShape<TShape extends TLShape>(shape: TLCreateShapePartial<TShape>): this;
     /**
      * Create shapes.
      *
@@ -3286,7 +3366,7 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      *
      * @public
      */
-    createShapes<T extends TLUnknownShape>(shapes: OptionalKeys<TLShapePartial<T>, 'id'>[]): this;
+    createShapes<TShape extends TLShape = TLShape>(shapes: TLCreateShapePartial<TShape>[]): this;
     private animatingShapes;
     /**
      * Animate a shape.
@@ -3372,7 +3452,7 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      *
      * @public
      */
-    updateShape<T extends TLUnknownShape>(partial: null | TLShapePartial<T> | undefined): this;
+    updateShape<T extends TLShape = TLShape>(partial: null | TLShapePartial<T> | undefined): this;
     /**
      * Update shapes using partials of each shape.
      *
@@ -3385,7 +3465,7 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      *
      * @public
      */
-    updateShapes<T extends TLUnknownShape>(partials: (null | TLShapePartial<T> | undefined)[]): this;
+    updateShapes<T extends TLShape>(partials: (null | TLShapePartial<T> | undefined)[]): this;
     /* Excluded from this release type: _updateShapes */
     /* Excluded from this release type: _getUnlockedShapeIds */
     /**
@@ -3700,59 +3780,6 @@ export declare class Editor extends EventEmitter<TLEventMap> {
         url: string;
         width: number;
     }>;
-    /**
-     * The app's current input state.
-     *
-     * @public
-     */
-    inputs: {
-        /** A set containing the currently pressed buttons. */
-        buttons: Set<number>;
-        /** A set containing the currently pressed keys. */
-        keys: Set<string>;
-        /** The most recent pointer down's position in screen space. */
-        originScreenPoint: Vec;
-        /** The most recent pointer down's position in the current page space. */
-        originPagePoint: Vec;
-        /** The most recent pointer position in screen space. */
-        currentScreenPoint: Vec;
-        /** The most recent pointer position in the current page space. */
-        currentPagePoint: Vec;
-        /** The previous pointer position in screen space. */
-        previousScreenPoint: Vec;
-        /** The previous pointer position in the current page space. */
-        previousPagePoint: Vec;
-        /** Velocity of mouse pointer, in pixels per millisecond */
-        pointerVelocity: Vec;
-        /** Whether the alt or option key is currently pressed. */
-        altKey: boolean;
-        /** Whether the control or command key is currently pressed. */
-        ctrlKey: boolean;
-        /** Whether the input is from a pe. */
-        isPen: boolean;
-        /** Whether the meta key is currently pressed. */
-        metaKey: boolean;
-        /** Whether the shift key is currently pressed. */
-        shiftKey: boolean;
-        /** Whether the user is dragging. */
-        isDragging: boolean;
-        /** Whether the user is editing. */
-        isEditing: boolean;
-        /** Whether the user is panning. */
-        isPanning: boolean;
-        /** Whether the user is pinching. */
-        isPinching: boolean;
-        /** Whether the user is pointing. */
-        isPointing: boolean;
-        /** Whether the user is spacebar panning. */
-        isSpacebarPanning: boolean;
-    };
-    /**
-     * Update the input points from a pointer, pinch, or wheel event.
-     *
-     * @param info - The event info.
-     */
-    private _updateInputsFromEvent;
     /**
      * Dispatch a cancel event.
      *
@@ -3998,7 +4025,6 @@ export declare class Editor extends EventEmitter<TLEventMap> {
     /* Excluded from this release type: _metaKeyTimeout */
     /* Excluded from this release type: _setMetaKeyTimeout */
     /* Excluded from this release type: _restoreToolId */
-    /* Excluded from this release type: _pinchStart */
     /* Excluded from this release type: _didPinch */
     /* Excluded from this release type: _selectedShapeIdsAtPointerDown */
     /* Excluded from this release type: _longPressTimeout */
@@ -4073,7 +4099,7 @@ export declare class EditorAtom<T> {
 export declare const EditorContext: React_3.Context<Editor | null>;
 
 /** @public @react */
-export declare function EditorProvider({ editor, children }: EditorProviderProps): JSX_2.Element;
+export declare function EditorProvider({ editor, children }: EditorProviderProps): JSX.Element;
 
 /** @public */
 export declare interface EditorProviderProps {
@@ -4104,7 +4130,7 @@ export declare class Ellipse2d extends Geometry2d {
 }
 
 /** @public */
-export declare class ErrorBoundary extends React_2.Component<React_2.PropsWithRef<React_2.PropsWithChildren<TLErrorBoundaryProps>>, {
+export declare class ErrorBoundary extends React_2.Component<React_2.PropsWithChildren<TLErrorBoundaryProps>, {
     error: Error | null;
 }> {
     static getDerivedStateFromError(error: Error): {
@@ -4114,11 +4140,11 @@ export declare class ErrorBoundary extends React_2.Component<React_2.PropsWithRe
         error: null;
     };
     componentDidCatch(error: unknown): void;
-    render(): boolean | JSX_2.Element | Iterable<React_2.ReactNode> | null | number | string | undefined;
+    render(): bigint | boolean | JSX.Element | Iterable<React_2.ReactNode> | null | number | Promise<bigint | boolean | Iterable<React_2.ReactNode> | null | number | React_2.ReactElement<unknown, React_2.JSXElementConstructor<any> | string> | React_2.ReactPortal | string | undefined> | string | undefined;
 }
 
 /** @public @react */
-export declare function ErrorScreen({ children }: LoadingScreenProps): JSX_2.Element;
+export declare function ErrorScreen({ children }: LoadingScreenProps): JSX.Element;
 
 /** @public */
 export declare const EVENT_NAME_MAP: Record<Exclude<TLEventName, TLPinchEventName>, keyof TLEventHandlers>;
@@ -4418,8 +4444,8 @@ export declare class GroupShapeUtil extends ShapeUtil<TLGroupShape> {
     canResizeChildren(): boolean;
     getDefaultProps(): TLGroupShape['props'];
     getGeometry(shape: TLGroupShape): Geometry2d;
-    component(shape: TLGroupShape): JSX_2.Element | null;
-    indicator(shape: TLGroupShape): JSX_2.Element;
+    component(shape: TLGroupShape): JSX.Element | null;
+    indicator(shape: TLGroupShape): JSX.Element;
     onChildrenChange(group: TLGroupShape): void;
 }
 
@@ -4523,7 +4549,7 @@ export declare class HistoryManager<R extends UnknownRecord> {
 }
 
 /** @public @react */
-export declare function HTMLContainer({ children, className, ...rest }: HTMLContainerProps): JSX_2.Element;
+export declare function HTMLContainer({ children, className, ...rest }: HTMLContainerProps): JSX.Element;
 
 /** @public */
 export declare type HTMLContainerProps = React_2.HTMLAttributes<HTMLDivElement>;
@@ -4531,6 +4557,248 @@ export declare type HTMLContainerProps = React_2.HTMLAttributes<HTMLDivElement>;
 /** @public */
 export declare const inlineBase64AssetStore: TLAssetStore;
 
+/** @public */
+export declare class InputsManager {
+    private readonly editor;
+    constructor(editor: Editor);
+    private _originPagePoint;
+    /**
+     * The most recent pointer down's position in the current page space.
+     */
+    getOriginPagePoint(): Vec;
+    /**
+     * @deprecated Use `getOriginPagePoint()` instead.
+     */
+    get originPagePoint(): Vec;
+    private _originScreenPoint;
+    /**
+     * The most recent pointer down's position in screen space.
+     */
+    getOriginScreenPoint(): Vec;
+    /**
+     * @deprecated Use `getOriginScreenPoint()` instead.
+     */
+    get originScreenPoint(): Vec;
+    private _previousPagePoint;
+    /**
+     * The previous pointer position in the current page space.
+     */
+    getPreviousPagePoint(): Vec;
+    /**
+     * @deprecated Use `getPreviousPagePoint()` instead.
+     */
+    get previousPagePoint(): Vec;
+    private _previousScreenPoint;
+    /**
+     * The previous pointer position in screen space.
+     */
+    getPreviousScreenPoint(): Vec;
+    /**
+     * @deprecated Use `getPreviousScreenPoint()` instead.
+     */
+    get previousScreenPoint(): Vec;
+    private _currentPagePoint;
+    /**
+     * The most recent pointer position in the current page space.
+     */
+    getCurrentPagePoint(): Vec;
+    /**
+     * @deprecated Use `getCurrentPagePoint()` instead.
+     */
+    get currentPagePoint(): Vec;
+    private _currentScreenPoint;
+    /**
+     * The most recent pointer position in screen space.
+     */
+    getCurrentScreenPoint(): Vec;
+    /**
+     * @deprecated Use `getCurrentScreenPoint()` instead.
+     */
+    get currentScreenPoint(): Vec;
+    private _pointerVelocity;
+    /**
+     * Velocity of mouse pointer, in pixels per millisecond.
+     */
+    getPointerVelocity(): Vec;
+    /**
+     * @deprecated Use `getPointerVelocity()` instead.
+     */
+    get pointerVelocity(): Vec;
+    /* Excluded from this release type: setPointerVelocity */
+    /**
+     * A set containing the currently pressed keys.
+     */
+    readonly keys: AtomSet<string>;
+    /**
+     * A set containing the currently pressed buttons.
+     */
+    readonly buttons: AtomSet<number>;
+    private _isPen;
+    /**
+     * Whether the input is from a pen.
+     */
+    getIsPen(): boolean;
+    /**
+     * @deprecated Use `getIsPen()` instead.
+     */
+    get isPen(): boolean;
+    set isPen(isPen: boolean);
+    /**
+     * @param isPen - Whether the input is from a pen.
+     */
+    setIsPen(isPen: boolean): void;
+    private _shiftKey;
+    /**
+     * Whether the shift key is currently pressed.
+     */
+    getShiftKey(): boolean;
+    /**
+     * @deprecated Use `getShiftKey()` instead.
+     */
+    get shiftKey(): boolean;
+    set shiftKey(shiftKey: boolean);
+    /* Excluded from this release type: setShiftKey */
+    private _metaKey;
+    /**
+     * Whether the meta key is currently pressed.
+     */
+    getMetaKey(): boolean;
+    /**
+     * @deprecated Use `getMetaKey()` instead.
+     */
+    get metaKey(): boolean;
+    set metaKey(metaKey: boolean);
+    /* Excluded from this release type: setMetaKey */
+    private _ctrlKey;
+    /**
+     * Whether the ctrl or command key is currently pressed.
+     */
+    getCtrlKey(): boolean;
+    /**
+     * @deprecated Use `getCtrlKey()` instead.
+     */
+    get ctrlKey(): boolean;
+    set ctrlKey(ctrlKey: boolean);
+    /* Excluded from this release type: setCtrlKey */
+    private _altKey;
+    /**
+     * Whether the alt or option key is currently pressed.
+     */
+    getAltKey(): boolean;
+    /**
+     * @deprecated Use `getAltKey()` instead.
+     */
+    get altKey(): boolean;
+    set altKey(altKey: boolean);
+    /* Excluded from this release type: setAltKey */
+    /**
+     * Is the accelerator key (cmd on mac, ctrl elsewhere) currently pressed.
+     */
+    getAccelKey(): boolean;
+    /**
+     * @deprecated Use `getAccelKey()` instead.
+     */
+    get accelKey(): boolean;
+    private _isDragging;
+    /**
+     * Whether the user is dragging.
+     */
+    getIsDragging(): boolean;
+    /**
+     * Soon to be deprecated, use `getIsDragging()` instead.
+     */
+    get isDragging(): boolean;
+    set isDragging(isDragging: boolean);
+    /**
+     * @param isDragging - Whether the user is dragging.
+     */
+    setIsDragging(isDragging: boolean): void;
+    private _isPointing;
+    /**
+     * Whether the user is pointing.
+     */
+    getIsPointing(): boolean;
+    /**
+     * @deprecated Use `getIsPointing()` instead.
+     */
+    get isPointing(): boolean;
+    set isPointing(isPointing: boolean);
+    /* Excluded from this release type: setIsPointing */
+    private _isPinching;
+    /**
+     * Whether the user is pinching.
+     */
+    getIsPinching(): boolean;
+    /**
+     * @deprecated Use `getIsPinching()` instead.
+     */
+    get isPinching(): boolean;
+    set isPinching(isPinching: boolean);
+    /* Excluded from this release type: setIsPinching */
+    private _isEditing;
+    /**
+     * Whether the user is editing.
+     */
+    getIsEditing(): boolean;
+    /**
+     * @deprecated Use `getIsEditing()` instead.
+     */
+    get isEditing(): boolean;
+    set isEditing(isEditing: boolean);
+    /**
+     * @param isEditing - Whether the user is editing.
+     */
+    setIsEditing(isEditing: boolean): void;
+    private _isPanning;
+    /**
+     * Whether the user is panning.
+     */
+    getIsPanning(): boolean;
+    /**
+     * @deprecated Use `getIsPanning()` instead.
+     */
+    get isPanning(): boolean;
+    set isPanning(isPanning: boolean);
+    /* Excluded from this release type: setIsPanning */
+    private _isSpacebarPanning;
+    /**
+     * Whether the user is spacebar panning.
+     */
+    getIsSpacebarPanning(): boolean;
+    /**
+     * @deprecated Use `getIsSpacebarPanning()` instead.
+     */
+    get isSpacebarPanning(): boolean;
+    set isSpacebarPanning(isSpacebarPanning: boolean);
+    /* Excluded from this release type: setIsSpacebarPanning */
+    private _getHasCollaborators;
+    /* Excluded from this release type: _velocityPrevPoint */
+    /* Excluded from this release type: updatePointerVelocity */
+    /* Excluded from this release type: updateFromEvent */
+    toJson(): {
+        altKey: boolean;
+        buttons: number[];
+        ctrlKey: boolean;
+        currentPagePoint: VecModel;
+        currentScreenPoint: VecModel;
+        isDragging: boolean;
+        isEditing: boolean;
+        isPanning: boolean;
+        isPen: boolean;
+        isPinching: boolean;
+        isPointing: boolean;
+        isSpacebarPanning: boolean;
+        keys: string[];
+        metaKey: boolean;
+        originPagePoint: VecModel;
+        originScreenPoint: VecModel;
+        pointerVelocity: VecModel;
+        previousPagePoint: VecModel;
+        previousScreenPoint: VecModel;
+        shiftKey: boolean;
+    };
+}
+
 /**
  * Find the intersections between a circle and a circle.
  *
@@ -4660,7 +4928,7 @@ export declare function kickoutOccludedShapes(editor: Editor, shapeIds: TLShapeI
 export declare function linesIntersect(A: VecLike, B: VecLike, C: VecLike, D: VecLike): boolean;
 
 /** @public @react */
-export declare function LoadingScreen({ children }: LoadingScreenProps): JSX_2.Element;
+export declare function LoadingScreen({ children }: LoadingScreenProps): JSX.Element;
 
 /** @public */
 export declare interface LoadingScreenProps {
@@ -4778,7 +5046,7 @@ export declare function maybeSnapToGrid(point: Vec, editor: Editor): Vec;
  *
  * @public @react
  */
-export declare function MenuClickCapture(): false | JSX_2.Element;
+export declare function MenuClickCapture(): false | JSX.Element;
 
 /* Excluded from this release type: normalizeWheel */
 
@@ -5116,7 +5384,7 @@ export declare function setRuntimeOverrides(input: Partial<typeof runtime>): voi
 export declare function setUserPreferences(user: TLUserPreferences): void;
 
 /** @public */
-export declare abstract class ShapeUtil<Shape extends TLUnknownShape = TLUnknownShape> {
+export declare abstract class ShapeUtil<Shape extends TLShape = TLShape> {
     editor: Editor;
     /** Configure this shape utils {@link ShapeUtil.options | `options`}. */
     static configure<T extends TLShapeUtilConstructor<any, any>>(this: T, options: T extends new (...args: any[]) => {
@@ -5211,20 +5479,20 @@ export declare abstract class ShapeUtil<Shape extends TLUnknownShape = TLUnknown
      * @param shape - The shape.
      * @public
      */
-    canSnap(_shape: Shape): boolean;
+    canSnap(shape: Shape): boolean;
     /**
      * Whether the shape can be tabbed to.
      *
      * @param shape - The shape.
      * @public
      */
-    canTabTo(_shape: Shape): boolean;
+    canTabTo(shape: Shape): boolean;
     /**
      * Whether the shape can be scrolled while editing.
      *
      * @public
      */
-    canScroll(_shape: Shape): boolean;
+    canScroll(shape: Shape): boolean;
     /**
      * Whether the shape can be bound to. See {@link TLShapeUtilCanBindOpts} for details.
      *
@@ -5236,31 +5504,37 @@ export declare abstract class ShapeUtil<Shape extends TLUnknownShape = TLUnknown
      *
      * @public
      */
-    canEdit(_shape: Shape): boolean;
+    canEdit(shape: Shape, info: TLEditStartInfo): boolean;
     /**
      * Whether the shape can be resized.
      *
      * @public
      */
-    canResize(_shape: Shape): boolean;
+    canResize(shape: Shape): boolean;
     /**
      * When the shape is resized, whether the shape's children should also be resized.
      *
      * @public
      */
-    canResizeChildren(_shape: Shape): boolean;
+    canResizeChildren(shape: Shape): boolean;
     /**
      * Whether the shape can be edited in read-only mode.
      *
      * @public
      */
-    canEditInReadonly(_shape: Shape): boolean;
+    canEditInReadonly(shape: Shape): boolean;
+    /**
+     * Whether the shape can be edited while locked or while an ancestor is locked.
+     *
+     * @public
+     */
+    canEditWhileLocked(shape: Shape): boolean;
     /**
      * Whether the shape can be cropped.
      *
      * @public
      */
-    canCrop(_shape: Shape): boolean;
+    canCrop(shape: Shape): boolean;
     /**
      * Whether the shape can participate in layout functions such as alignment or distribution.
      *
@@ -5270,7 +5544,7 @@ export declare abstract class ShapeUtil<Shape extends TLUnknownShape = TLUnknown
      *
      * @public
      */
-    canBeLaidOut(_shape: Shape, _info: TLShapeUtilCanBeLaidOutOpts): boolean;
+    canBeLaidOut(shape: Shape, info: TLShapeUtilCanBeLaidOutOpts): boolean;
     /**
      * Whether this shape can be culled. By default, shapes are culled for
      * performance reasons when they are outside of the viewport. Culled shapes are still rendered
@@ -5278,11 +5552,31 @@ export declare abstract class ShapeUtil<Shape extends TLUnknownShape = TLUnknown
      *
      * @param shape - The shape.
      */
-    canCull(_shape: Shape): boolean;
+    canCull(shape: Shape): boolean;
     /* Excluded from this release type: providesBackgroundForChildren */
     /**
      * Get the clip path to apply to this shape's children.
      *
+     * The returned points should define the **inner** clip boundary - the area where
+     * children will be visible. If your shape has a stroke, you should inset the clip
+     * path by half the stroke width so children are clipped to the inner edge of the
+     * stroke rather than its center line.
+     *
+     * @example
+     * ```ts
+     * override getClipPath(shape: MyShape): Vec[] | undefined {
+     *   const strokeWidth = 2
+     *   const inset = strokeWidth / 2
+     *   // Return points inset by half the stroke width
+     *   return [
+     *     new Vec(inset, inset),
+     *     new Vec(shape.props.w - inset, inset),
+     *     new Vec(shape.props.w - inset, shape.props.h - inset),
+     *     new Vec(inset, shape.props.h - inset),
+     *   ]
+     * }
+     * ```
+     *
      * @param shape - The shape to get the clip path for
      * @returns Array of points defining the clipping polygon in local coordinates, or undefined if no clipping
      * @public
@@ -5307,37 +5601,37 @@ export declare abstract class ShapeUtil<Shape extends TLUnknownShape = TLUnknown
      * @returns boolean indicating if this shape should hide in the minimap
      * @public
      */
-    hideInMinimap?(_shape: Shape): boolean;
+    hideInMinimap?(shape: Shape): boolean;
     /**
      * Whether the shape should hide its resize handles when selected.
      *
      * @public
      */
-    hideResizeHandles(_shape: Shape): boolean;
+    hideResizeHandles(shape: Shape): boolean;
     /**
      * Whether the shape should hide its rotation handles when selected.
      *
      * @public
      */
-    hideRotateHandle(_shape: Shape): boolean;
+    hideRotateHandle(shape: Shape): boolean;
     /**
      * Whether the shape should hide its selection bounds background when selected.
      *
      * @public
      */
-    hideSelectionBoundsBg(_shape: Shape): boolean;
+    hideSelectionBoundsBg(shape: Shape): boolean;
     /**
      * Whether the shape should hide its selection bounds foreground when selected.
      *
      * @public
      */
-    hideSelectionBoundsFg(_shape: Shape): boolean;
+    hideSelectionBoundsFg(shape: Shape): boolean;
     /**
      * Whether the shape's aspect ratio is locked.
      *
      * @public
      */
-    isAspectRatioLocked(_shape: Shape): boolean;
+    isAspectRatioLocked(shape: Shape): boolean;
     /**
      * By default, the bounds of an image export are the bounds of all the shapes it contains, plus
      * some padding. If an export includes a shape where `isExportBoundsContainer` is true, then the
@@ -5345,10 +5639,10 @@ export declare abstract class ShapeUtil<Shape extends TLUnknownShape = TLUnknown
      * useful in cases like annotating on top of an image, where you usually want to avoid extra
      * padding around the image if you don't need it.
      *
-     * @param _shape - The shape to check
+     * @param shape - The shape to check
      * @returns True if this shape should be treated as an export bounds container
      */
-    isExportBoundsContainer(_shape: Shape): boolean;
+    isExportBoundsContainer(shape: Shape): boolean;
     /* Excluded from this release type: backgroundComponent */
     /**
      * Get the interpolated props for an animating shape. This is an optional method.
@@ -5385,7 +5679,7 @@ export declare abstract class ShapeUtil<Shape extends TLUnknownShape = TLUnknown
      * @param type - The shape type.
      * @public
      */
-    canReceiveNewChildrenOfType(_shape: Shape, _type: TLShape['type']): boolean;
+    canReceiveNewChildrenOfType(shape: Shape, _type: TLShape['type']): boolean;
     /**
      * Get the shape as an SVG object.
      *
@@ -5418,14 +5712,14 @@ export declare abstract class ShapeUtil<Shape extends TLUnknownShape = TLUnknown
      * Get the geometry to use when snapping to this this shape in translate/resize operations. See
      * {@link BoundsSnapGeometry} for details.
      */
-    getBoundsSnapGeometry(_shape: Shape): BoundsSnapGeometry;
+    getBoundsSnapGeometry(shape: Shape): BoundsSnapGeometry;
     /**
      * Get the geometry to use when snapping handles to this shape. See {@link HandleSnapGeometry}
      * for details.
      */
-    getHandleSnapGeometry(_shape: Shape): HandleSnapGeometry;
-    getText(_shape: Shape): string | undefined;
-    getAriaDescriptor(_shape: Shape): string | undefined;
+    getHandleSnapGeometry(shape: Shape): HandleSnapGeometry;
+    getText(shape: Shape): string | undefined;
+    getAriaDescriptor(shape: Shape): string | undefined;
     /**
      * A callback called just before a shape is created. This method provides a last chance to modify
      * the created shape.
@@ -5920,7 +6214,7 @@ export declare const stopEventPropagation: (e: any) => any;
 export declare function suffixSafeId(id: SafeId, suffix: string): SafeId;
 
 /** @public @react */
-export declare function SVGContainer({ children, className, ...rest }: SVGContainerProps): JSX_2.Element;
+export declare function SVGContainer({ children, className, ...rest }: SVGContainerProps): JSX.Element;
 
 /** @public */
 export declare type SVGContainerProps = React_2.ComponentProps<'svg'>;
@@ -6018,6 +6312,8 @@ export declare class TextManager {
     }[];
 }
 
+/* Excluded from this release type: TickManager */
+
 /**
  * This is the TipTap editor! Docs are {@link https://tiptap.dev/docs}.
  *
@@ -6041,7 +6337,7 @@ export declare type TLAnyBindingUtilConstructor = TLBindingUtilConstructor<any>;
 export declare type TLAnyShapeUtilConstructor = TLShapeUtilConstructor<any>;
 
 /** @public */
-export declare type TLBaseBoxShape = TLBaseShape<string, {
+export declare type TLBaseBoxShape = ExtractShapeByProps<{
     h: number;
     w: number;
 }>;
@@ -6063,7 +6359,7 @@ export declare interface TLBaseExternalContent {
 }
 
 /** @public */
-export declare interface TLBindingUtilConstructor<T extends TLUnknownBinding, U extends BindingUtil<T> = BindingUtil<T>> {
+export declare interface TLBindingUtilConstructor<T extends TLBinding, U extends BindingUtil<T> = BindingUtil<T>> {
     new (editor: Editor): U;
     type: T['type'];
     /** Validations for this binding's props. */
@@ -6569,6 +6865,33 @@ export declare interface TldrawOptions {
      * Branding name of the app, currently only used for adding aria-label for the application.
      */
     readonly branding?: string;
+    /**
+     * Whether to use debounced zoom level for certain rendering optimizations. When true,
+     * `editor.getDebouncedZoomLevel()` returns a cached zoom value while the camera is moving,
+     * reducing re-renders. When false, it always returns the current zoom level.
+     */
+    readonly debouncedZoom: boolean;
+    /**
+     * The number of shapes that must be on the page for the debounced zoom level to be used.
+     * Defaults to 300 shapes.
+     */
+    readonly debouncedZoomThreshold: number;
+    /**
+     * Whether to allow spacebar panning. When true, the spacebar will pan the camera when held down.
+     * When false, the spacebar will not pan the camera.
+     */
+    readonly spacebarPanning: boolean;
+    /**
+     * The default padding (in pixels) used when zooming to fit content in the viewport.
+     * This affects methods like `zoomToFit()`, `zoomToSelection()`, and `zoomToBounds()`.
+     * The actual padding used is the minimum of this value and 28% of the viewport width.
+     * Defaults to 128 pixels.
+     */
+    readonly zoomToFitPadding: number;
+    /**
+     * The distance (in screen pixels) at which shapes snap to guides and other shapes.
+     */
+    readonly snapThreshold: number;
 }
 
 /** @public */
@@ -6614,7 +6937,7 @@ export declare interface TLEditorComponents {
 /** @public */
 export declare interface TLEditorOptions {
     /**
-     * The Store instance to use for keeping the app's data. This may be prepopulated, e.g. by loading
+     * The Store instance to use for keeping the editor's data. This may be prepopulated, e.g. by loading
      * from a server or database.
      */
     store: TLStore;
@@ -6693,6 +7016,11 @@ export declare interface TLEditorSnapshot {
     session: TLSessionStateSnapshot;
 }
 
+/** @public */
+export declare interface TLEditStartInfo {
+    type: 'click-header' | 'click' | 'double-click-corner' | 'double-click-edge' | 'double-click' | 'press_enter' | 'unknown';
+}
+
 /** @public */
 export declare interface TLEmbedExternalContent<EmbedDefinition> extends TLBaseExternalContent {
     type: 'embed';
@@ -6705,6 +7033,8 @@ export declare type TLEnterEventHandler = (info: any, from: string) => void;
 
 /**
  * An object that contains information about the current device and environment.
+ * This object is not reactive and will not update automatically when the environment changes,
+ * so only include values that are fixed, such as the user's browser and operating system.
  *
  * @public
  */
@@ -6719,6 +7049,17 @@ export declare const tlenv: {
     isWebview: boolean;
 };
 
+/**
+ * An atom that contains information about the current device and environment.
+ * This object is reactive and will update automatically when the environment changes.
+ * Use it for values that may change over time, such as the pointer type.
+ *
+ * @public
+ */
+export declare const tlenvReactive: Atom<    {
+isCoarsePointer: boolean;
+}, unknown>;
+
 /** @public */
 export declare interface TLErrorBoundaryProps {
     children: React_2.ReactNode;
@@ -6782,6 +7123,7 @@ export declare interface TLEventMap {
     event: [TLEventInfo];
     tick: [number];
     frame: [number];
+    resize: [BoxModel];
     'select-all-text': [{
         shapeId: TLShapeId;
     }];
@@ -6796,6 +7138,7 @@ export declare interface TLEventMap {
     'edited-shapes': [TLRecord[]];
     'deleted-shapes': [TLShapeId[]];
     edit: [];
+    dispose: [];
 }
 
 /** @public */
@@ -7497,11 +7840,11 @@ export declare interface TLShapeUtilCanBeLaidOutOpts {
  *
  * @public
  */
-export declare interface TLShapeUtilCanBindOpts<Shape extends TLUnknownShape = TLUnknownShape> {
+export declare interface TLShapeUtilCanBindOpts<Shape extends TLShape = TLShape> {
     /** The type of shape referenced by the `fromId` of the binding. */
-    fromShapeType: string;
+    fromShapeType: TLShape['type'];
     /** The type of shape referenced by the `toId` of the binding. */
-    toShapeType: string;
+    toShapeType: TLShape['type'];
     /** The type of binding. */
     bindingType: string;
 }
@@ -7513,7 +7856,7 @@ export declare interface TLShapeUtilCanvasSvgDef {
 }
 
 /** @public */
-export declare interface TLShapeUtilConstructor<T extends TLUnknownShape, U extends ShapeUtil<T> = ShapeUtil<T>> {
+export declare interface TLShapeUtilConstructor<T extends TLShape, U extends ShapeUtil<T> = ShapeUtil<T>> {
     new (editor: Editor): U;
     type: T['type'];
     props?: RecordProps<T>;
@@ -7893,10 +8236,10 @@ export declare function useMaybeEditor(): Editor | null;
 /* Excluded from this release type: useOnMount */
 
 /** @public */
-export declare function usePassThroughMouseOverEvents(ref: RefObject<HTMLElement>): void;
+export declare function usePassThroughMouseOverEvents(ref: RefObject<HTMLElement | null>): void;
 
 /** @public */
-export declare function usePassThroughWheelEvents(ref: RefObject<HTMLElement>): void;
+export declare function usePassThroughWheelEvents(ref: RefObject<HTMLElement | null>): void;
 
 /**
  * @returns The list of peer UserIDs
@@ -8004,7 +8347,7 @@ export declare function useTLSchemaFromUtils(opts: TLStoreSchemaOptions): StoreS
 export declare function useTLStore(opts: TLStoreOptions): TLStore;
 
 /** @public */
-export declare function useTransform(ref: React.RefObject<HTMLElement | SVGElement>, x?: number, y?: number, scale?: number, rotate?: number, additionalOffset?: VecLike): void;
+export declare function useTransform(ref: React.RefObject<HTMLElement | null | SVGElement>, x?: number, y?: number, scale?: number, rotate?: number, additionalOffset?: VecLike): void;
 
 /**
  * React's useId hook returns a unique id for the component. However, it uses a colon in the id,