@tldraw/editor 3.16.0-canary.ffdf566dd0a8 → 3.16.0-internal.71f83a8a571b

package/dist-esm/index.d.mts

@@ -147,7 +147,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;
 }
 
@@ -510,6 +510,7 @@ export declare class Box {
     static ExpandBy(A: Box, n: number): Box;
     static Collides(A: Box, B: Box): boolean;
     static Contains(A: Box, B: Box): boolean;
+    static ContainsApproximately(A: Box, B: Box, precision?: number): boolean;
     static Includes(A: Box, B: Box): boolean;
     static ContainsPoint(A: Box, B: VecLike, margin?: number): boolean;
     static Common(boxes: Box[]): Box;
@@ -760,11 +761,6 @@ export declare class CubicSpline2d extends Geometry2d {
 /** @public */
 export declare function dataUrlToFile(url: string, filename: string, mimeType: string): Promise<File>;
 
-/**
- * @deprecated Licensing is now enabled in the tldraw SDK.
- * @public */
-export declare function debugEnableLicensing(): void;
-
 /* Excluded from this release type: DebugFlag */
 
 /* Excluded from this release type: DebugFlagDef */
@@ -890,6 +886,8 @@ export declare const defaultTldrawOptions: {
     readonly temporaryAssetPreviewLifetimeMs: 180000;
     readonly textShadowLod: 0.35;
     readonly tooltipDelayMs: 700;
+    readonly uiCoarseDragDistanceSquared: 625;
+    readonly uiDragDistanceSquared: 16;
 };
 
 /** @public */
@@ -981,7 +979,7 @@ export declare class EdgeScrollManager {
 /** @public */
 export declare class Editor extends EventEmitter<TLEventMap> {
     readonly id: string;
-    constructor({ store, user, shapeUtils, bindingUtils, tools, getContainer, cameraOptions, textOptions, initialState, autoFocus, inferDarkMode, options, isShapeHidden, getShapeVisibility, fontAssetUrls, }: TLEditorOptions);
+    constructor({ store, user, shapeUtils, bindingUtils, tools, getContainer, cameraOptions, textOptions, initialState, autoFocus, inferDarkMode, options, getShapeVisibility, fontAssetUrls, }: TLEditorOptions);
     private readonly _getShapeVisibility?;
     private getIsShapeHiddenCache;
     isShapeHidden(shapeOrId: TLShape | TLShapeId): boolean;
@@ -1048,22 +1046,6 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      * @public
      */
     readonly fonts: FontManager;
-    /**
-     * A manager for the editor's environment.
-     *
-     * @deprecated This is deprecated and will be removed in a future version. Use the `tlenv` global export instead.
-     * @public
-     */
-    readonly environment: {
-        hasCanvasSupport: boolean;
-        isAndroid: boolean;
-        isChromeForIos: boolean;
-        isDarwin: boolean;
-        isFirefox: boolean;
-        isIos: boolean;
-        isSafari: boolean;
-        isWebview: boolean;
-    };
     /**
      * A manager for the editor's scribbles.
      *
@@ -1106,7 +1088,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>;
@@ -1126,16 +1108,16 @@ 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<S extends TLShape>(shape: S | TLShapePartial<S>): ShapeUtil<S>;
+    getShapeUtil<S extends TLShape>(type: S['type']): 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.
@@ -1206,22 +1188,6 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      * @public
      */
     getCanRedo(): boolean;
-    /**
-     * Create a new "mark", or stopping point, in the undo redo history. Creating a mark will clear
-     * any redos.
-     *
-     * @example
-     * ```ts
-     * editor.mark()
-     * editor.mark('flip shapes')
-     * ```
-     *
-     * @param markId - The mark's id, usually the reason for adding the mark.
-     *
-     * @public
-     * @deprecated use {@link Editor.markHistoryStoppingPoint} instead
-     */
-    mark(markId?: string): 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.
@@ -1311,10 +1277,6 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      * @public
      */
     run(fn: () => void, opts?: TLEditorRunOptions): this;
-    /**
-     * @deprecated Use `Editor.run` instead.
-     */
-    batch(fn: () => void, opts?: TLEditorRunOptions): this;
     /* Excluded from this release type: annotateError */
     /* Excluded from this release type: createErrorAnnotations */
     /* Excluded from this release type: _crashingError */
@@ -1436,36 +1398,6 @@ export declare class Editor extends EventEmitter<TLEventMap> {
         hasOpenMenus: () => boolean;
         isMenuOpen: (id: string) => boolean;
     };
-    /**
-     * @deprecated Use `editor.menus.getOpenMenus` instead.
-     *
-     * @public
-     */
-    getOpenMenus(): string[];
-    /**
-     * @deprecated Use `editor.menus.addOpenMenu` instead.
-     *
-     * @public
-     */
-    addOpenMenu(id: string): this;
-    /**
-     * @deprecated Use `editor.menus.deleteOpenMenu` instead.
-     *
-     * @public
-     */
-    deleteOpenMenu(id: string): this;
-    /**
-     * @deprecated Use `editor.menus.clearOpenMenus` instead.
-     *
-     * @public
-     */
-    clearOpenMenus(): this;
-    /**
-     * @deprecated Use `editor.menus.hasAnyOpenMenus` instead.
-     *
-     * @public
-     */
-    getIsMenuOpen(): boolean;
     /**
      * Set the cursor.
      *
@@ -2795,8 +2727,8 @@ 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<T extends TLShape>(shape: TLShape, type: T['type']): shape is T;
+    isShapeOfType<T extends TLShape = TLShape>(shapeId: TLShapeId, type: T['type']): boolean;
     /**
      * Get a shape by its id.
      *
@@ -2914,8 +2846,6 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      * @public
      */
     getShapeAndDescendantIds(ids: TLShapeId[]): Set<TLShapeId>;
-    /** @deprecated Use {@link Editor.getDraggingOverShape} instead */
-    getDroppingOverShape(point: Vec, droppingShapes: TLShape[]): TLShape | undefined;
     /**
      * Get the shape that some shapes should be dropped on at a given point.
      *
@@ -3274,7 +3204,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.
      *
@@ -3282,7 +3212,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.
      *
@@ -3296,7 +3226,7 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      *
      * @public
      */
-    createShape<T extends TLUnknownShape>(shape: OptionalKeys<TLShapePartial<T>, 'id'>): this;
+    createShape<TShape extends TLShape>(shape: OptionalKeys<TLShapePartial<TShape>, 'id'>): this;
     /**
      * Create shapes.
      *
@@ -3310,7 +3240,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: OptionalKeys<TLShapePartial<TShape>, 'id'>[]): this;
     private animatingShapes;
     /**
      * Animate a shape.
@@ -3396,7 +3326,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.
      *
@@ -3409,7 +3339,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 */
     /**
@@ -3627,14 +3557,20 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      * Handle external content, such as files, urls, embeds, or plain text which has been put into the app, for example by pasting external text or dropping external images onto canvas.
      *
      * @param info - Info about the external content.
+     * @param opts - Options for handling external content, including force flag to bypass readonly checks.
      */
-    putExternalContent<E>(info: TLExternalContent<E>): Promise<void>;
+    putExternalContent<E>(info: TLExternalContent<E>, opts?: {
+        force?: boolean;
+    }): Promise<void>;
     /**
      * Handle replacing external content.
      *
      * @param info - Info about the external content.
+     * @param opts - Options for handling external content, including force flag to bypass readonly checks.
      */
-    replaceExternalContent<E>(info: TLExternalContent<E>): Promise<void>;
+    replaceExternalContent<E>(info: TLExternalContent<E>, opts?: {
+        force?: boolean;
+    }): Promise<void>;
     /**
      * Get content that can be exported for the given shape ids.
      *
@@ -3690,8 +3626,6 @@ export declare class Editor extends EventEmitter<TLEventMap> {
         svg: string;
         width: number;
     } | undefined>;
-    /** @deprecated Use {@link Editor.getSvgString} or {@link Editor.getSvgElement} instead. */
-    getSvg(shapes: TLShape[] | TLShapeId[], opts?: TLSvgExportOptions): Promise<SVGSVGElement | undefined>;
     /**
      * Get an exported image of the given shapes.
      *
@@ -3706,6 +3640,20 @@ export declare class Editor extends EventEmitter<TLEventMap> {
         height: number;
         width: number;
     }>;
+    /**
+     * Get an exported image of the given shapes as a data URL.
+     *
+     * @param shapes - The shapes (or shape ids) to export.
+     * @param opts - Options for the export.
+     *
+     * @returns A data URL of the image.
+     * @public
+     */
+    toImageDataUrl(shapes: TLShape[] | TLShapeId[], opts?: TLImageExportOptions): Promise<{
+        height: number;
+        url: string;
+        width: number;
+    }>;
     /**
      * The app's current input state.
      *
@@ -4147,6 +4095,7 @@ export declare abstract class Geometry2d {
     isLabel: boolean;
     isEmptyLabel: boolean;
     isInternal: boolean;
+    excludeFromShapeBounds: boolean;
     debugColor?: string;
     ignore?: boolean;
     constructor(opts: Geometry2dOptions);
@@ -4170,12 +4119,14 @@ export declare abstract class Geometry2d {
      * along the edge it is as a fraction of the total length.
      */
     uninterpolateAlongEdge(point: VecLike, _filters?: Geometry2dFilters): number;
-    /** @deprecated Iterate the vertices instead. */
-    nearestPointOnLineSegment(A: VecLike, B: VecLike): Vec;
     isPointInBounds(point: VecLike, margin?: number): boolean;
+    overlapsPolygon(_polygon: VecLike[]): boolean;
     transform(transform: MatModel, opts?: TransformedGeometry2dOptions): Geometry2d;
     private _vertices;
     get vertices(): Vec[];
+    getBoundsVertices(): Vec[];
+    private _boundsVertices;
+    get boundsVertices(): Vec[];
     getBounds(): Box;
     private _bounds;
     get bounds(): Box;
@@ -4372,6 +4323,7 @@ export declare class Group2d extends Geometry2d {
     hitTestLineSegment(A: VecLike, B: VecLike, zoom: number, filters?: Geometry2dFilters): boolean;
     intersectLineSegment(A: VecLike, B: VecLike, filters?: Geometry2dFilters): VecLike[];
     intersectCircle(center: VecLike, radius: number, filters?: Geometry2dFilters): VecLike[];
+    getBoundsVertices(): Vec[];
     intersectPolygon(polygon: VecLike[], filters?: Geometry2dFilters): VecLike[];
     intersectPolyline(polyline: VecLike[], filters?: Geometry2dFilters): VecLike[];
     interpolateAlongEdge(t: number, filters?: Geometry2dFilters): Vec;
@@ -4381,6 +4333,7 @@ export declare class Group2d extends Geometry2d {
     toSimpleSvgPath(): string;
     getLength(filters?: Geometry2dFilters): number;
     getSvgPathData(): string;
+    overlapsPolygon(polygon: VecLike[]): boolean;
 }
 
 /** @public */
@@ -4621,12 +4574,16 @@ export declare function kickoutOccludedShapes(editor: Editor, shapeIds: TLShapeI
     filter?(parent: TLShape): boolean;
 }): void;
 
+/* Excluded from this release type: LICENSE_TIMEOUT */
+
 /* Excluded from this release type: LicenseFromKeyResult */
 
 /* Excluded from this release type: LicenseInfo */
 
 /* Excluded from this release type: LicenseManager */
 
+/* Excluded from this release type: LicenseState */
+
 /** @public */
 export declare function linesIntersect(A: VecLike, B: VecLike, C: VecLike, D: VecLike): boolean;
 
@@ -4659,6 +4616,23 @@ export declare function loadSnapshot(store: TLStore, _snapshot: Partial<TLEditor
 /** @public */
 export declare function loopToHtmlElement(elm: Element): HTMLElement;
 
+/**
+ * In tldraw, events are sometimes handled by multiple components. For example, the shapes might
+ * have events, but the canvas handles events too. The way that the canvas handles events can
+ * interfere with the with the shapes event handlers - for example, it calls `.preventDefault()` on
+ * `pointerDown`, which also prevents `click` events from firing on the shapes.
+ *
+ * You can use `.stopPropagation()` to prevent the event from propagating to the rest of the DOM,
+ * but that can impact non-tldraw event handlers set up elsewhere. By using `markEventAsHandled`,
+ * you'll stop other parts of tldraw from handling the event without impacting other, non-tldraw
+ * event handlers. See also {@link wasEventAlreadyHandled}.
+ *
+ * @public
+ */
+export declare function markEventAsHandled(e: {
+    nativeEvent: Event;
+} | Event): void;
+
 /** @public */
 export declare class Mat {
     constructor(a: number, b: number, c: number, d: number, e: number, f: number);
@@ -5077,7 +5051,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[]) => {
@@ -5232,7 +5206,34 @@ export declare abstract class ShapeUtil<Shape extends TLUnknownShape = TLUnknown
      * @public
      */
     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
+     * to the DOM, but have their `display` property set to `none`.
+     *
+     * @param shape - The shape.
+     */
+    canCull(_shape: Shape): boolean;
     /* Excluded from this release type: providesBackgroundForChildren */
+    /**
+     * Get the clip path to apply to this shape's children.
+     *
+     * @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
+     */
+    getClipPath?(shape: Shape): undefined | Vec[];
+    /**
+     * Whether a specific child shape should be clipped by this shape.
+     * Only called if getClipPath returns a valid polygon.
+     *
+     * If not defined, the default behavior is to clip all children.
+     *
+     * @param child - The child shape to check
+     * @returns boolean indicating if this child should be clipped
+     * @public
+     */
+    shouldClipChild?(child: TLShape): boolean;
     /**
      * Whether the shape should hide its resize handles when selected.
      *
@@ -5263,6 +5264,17 @@ export declare abstract class ShapeUtil<Shape extends TLUnknownShape = TLUnknown
      * @public
      */
     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
+     * padding is skipped _if the bounds of that shape contains all the other shapes_. This is
+     * 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
+     * @returns True if this shape should be treated as an export bounds container
+     */
+    isExportBoundsContainer(_shape: Shape): boolean;
     /* Excluded from this release type: backgroundComponent */
     /**
      * Get the interpolated props for an animating shape. This is an optional method.
@@ -5818,7 +5830,14 @@ export declare abstract class StateNode implements Partial<TLEventHandlers> {
     onExit?(info: any, to: string): void;
 }
 
-/** @public */
+/**
+ * Calls `event.stopPropagation()`.
+ *
+ * @deprecated Use {@link markEventAsHandled} instead, or manually call `event.stopPropagation()` if
+ * that's what you really want.
+ *
+ * @public
+ */
 export declare const stopEventPropagation: (e: any) => any;
 
 /* Excluded from this release type: StoreName */
@@ -5950,9 +5969,11 @@ export declare type TLAnyBindingUtilConstructor = TLBindingUtilConstructor<any>;
 export declare type TLAnyShapeUtilConstructor = TLShapeUtilConstructor<any>;
 
 /** @public */
-export declare type TLBaseBoxShape = TLBaseShape<string, {
-    h: number;
-    w: number;
+export declare type TLBaseBoxShape = Extract<TLShape, {
+    props: {
+        h: number;
+        w: number;
+    };
 }>;
 
 /** @public */
@@ -6309,12 +6330,6 @@ export declare interface TldrawEditorBaseProps {
      * Options for syncing the editor's camera state with the URL.
      */
     deepLinks?: TLDeepLinkOptions | true;
-    /**
-     * Predicate for whether or not a shape should be hidden.
-     *
-     * @deprecated Use {@link TldrawEditorBaseProps#getShapeVisibility} instead.
-     */
-    isShapeHidden?(shape: TLShape, editor: Editor): boolean;
     /**
      * Provides a way to hide shapes.
      *
@@ -6422,6 +6437,8 @@ export declare interface TldrawOptions {
     readonly multiClickDurationMs: number;
     readonly coarseDragDistanceSquared: number;
     readonly dragDistanceSquared: number;
+    readonly uiDragDistanceSquared: number;
+    readonly uiCoarseDragDistanceSquared: number;
     readonly defaultSvgPadding: number;
     readonly cameraSlideFriction: number;
     readonly gridSteps: readonly {
@@ -6574,15 +6591,6 @@ export declare interface TLEditorOptions {
     fontAssetUrls?: {
         [key: string]: string | undefined;
     };
-    /**
-     * A predicate that should return true if the given shape should be hidden.
-     *
-     * @deprecated Use {@link Editor#getShapeVisibility} instead.
-     *
-     * @param shape - The shape to check.
-     * @param editor - The editor instance.
-     */
-    isShapeHidden?(shape: TLShape, editor: Editor): boolean;
     /**
      * Provides a way to hide shapes.
      *
@@ -7419,11 +7427,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;
 }
@@ -7435,7 +7443,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>;
@@ -7573,12 +7581,6 @@ export declare interface TLSvgExportOptions {
     preserveAspectRatio?: React.SVGAttributes<SVGSVGElement>['preserveAspectRatio'];
 }
 
-/**
- * @public
- * @deprecated use {@link TLImageExportOptions} instead
- */
-export declare type TLSvgOptions = TLImageExportOptions;
-
 /** @public */
 export declare interface TLSvgTextExternalContent extends TLBaseExternalContent {
     type: 'svg-text';
@@ -7732,6 +7734,7 @@ export declare class TransformedGeometry2d extends Geometry2d {
     private readonly decomposed;
     constructor(geometry: Geometry2d, matrix: MatModel, opts?: TransformedGeometry2dOptions);
     getVertices(filters: Geometry2dFilters): Vec[];
+    getBoundsVertices(): Vec[];
     nearestPoint(point: VecLike, filters?: Geometry2dFilters): Vec;
     hitTestPoint(point: VecLike, margin?: number, hitInside?: boolean, filters?: Geometry2dFilters): boolean;
     distanceToPoint(point: VecLike, hitInside?: boolean, filters?: Geometry2dFilters): number;
@@ -7752,6 +7755,7 @@ export declare interface TransformedGeometry2dOptions {
     isInternal?: boolean;
     debugColor?: string;
     ignore?: boolean;
+    excludeFromShapeBounds?: boolean;
 }
 
 /** @public */
@@ -7986,8 +7990,6 @@ export declare class Vec {
     lrp(B: VecLike, t: number): Vec;
     equals(B: VecLike): boolean;
     equalsXY(x: number, y: number): boolean;
-    /** @deprecated use `uni` instead */
-    norm(): this;
     toFixed(): this;
     toString(): string;
     toJson(): VecModel;
@@ -8109,6 +8111,15 @@ export declare class Vec {
 /** @public */
 export declare type VecLike = Vec | VecModel;
 
+/**
+ * Checks if an event has already been handled. See {@link markEventAsHandled}.
+ *
+ * @public
+ */
+export declare function wasEventAlreadyHandled(e: {
+    nativeEvent: Event;
+} | Event): boolean;
+
 
 export * from "@tldraw/state";
 export * from "@tldraw/state-react";

package/dist-esm/index.mjs

@@ -175,6 +175,7 @@ import { useViewportHeight } from "./lib/hooks/useViewportHeight.mjs";
 import {
   LicenseManager
 } from "./lib/license/LicenseManager.mjs";
+import { LICENSE_TIMEOUT } from "./lib/license/LicenseProvider.mjs";
 import { defaultTldrawOptions } from "./lib/options.mjs";
 import {
   Box,
@@ -268,10 +269,12 @@ import {
 import {
   activeElementShouldCaptureKeys,
   loopToHtmlElement,
+  markEventAsHandled,
   preventDefault,
   releasePointerCapture,
   setPointerCapture,
-  stopEventPropagation
+  stopEventPropagation,
+  wasEventAlreadyHandled
 } from "./lib/utils/dom.mjs";
 import { EditorAtom } from "./lib/utils/EditorAtom.mjs";
 import { getIncrementedName } from "./lib/utils/getIncrementedName.mjs";
@@ -298,12 +301,9 @@ import { hardReset } from "./lib/utils/sync/hardReset.mjs";
 import { LocalIndexedDb, Table } from "./lib/utils/sync/LocalIndexedDb.mjs";
 import { uniq } from "./lib/utils/uniq.mjs";
 import { openWindow } from "./lib/utils/window-open.mjs";
-function debugEnableLicensing() {
-  return;
-}
 registerTldrawLibraryVersion(
   "@tldraw/editor",
-  "3.16.0-canary.ffdf566dd0a8",
+  "3.16.0-internal.71f83a8a571b",
   "esm"
 );
 export {
@@ -358,6 +358,7 @@ export {
   HTMLContainer,
   HandleSnaps,
   HistoryManager,
+  LICENSE_TIMEOUT,
   LicenseManager,
   LoadingScreen,
   LocalIndexedDb,
@@ -409,7 +410,6 @@ export {
   createTLStore,
   createTLUser,
   dataUrlToFile,
-  debugEnableLicensing,
   debugFlags,
   defaultTldrawOptions,
   defaultUserPreferences,
@@ -454,6 +454,7 @@ export {
   loadSessionStateSnapshotIntoStore,
   loadSnapshot,
   loopToHtmlElement,
+  markEventAsHandled,
   maybeSnapToGrid,
   normalizeWheel,
   openWindow,
@@ -517,6 +518,7 @@ export {
   useTransform,
   useUniqueSafeId,
   useViewportHeight,
-  userTypeValidator
+  userTypeValidator,
+  wasEventAlreadyHandled
 };
 //# sourceMappingURL=index.mjs.map