@tldraw/editor 4.4.0-canary.f929c9caec2f → 4.4.0-canary.fcefa58e986b

package/dist-cjs/index.d.ts

@@ -769,7 +769,13 @@ export declare class CubicSpline2d extends Geometry2d {
     getSvgPathData(): string;
 }
 
-/** @public */
+/**
+ * Converts a data URL to a file.
+ * @param url - The data URL to convert.
+ * @param filename - The name of the file.
+ * @param mimeType - The MIME type of the file.
+ * @returns A promise that resolves to a file.
+ * @public */
 export declare function dataUrlToFile(url: string, filename: string, mimeType: string): Promise<File>;
 
 /** @public */
@@ -857,6 +863,7 @@ export declare const defaultTldrawOptions: {
     readonly actionShortcutsLocation: "swap";
     readonly adjacentShapeMargin: 10;
     readonly animationMediumMs: 320;
+    readonly camera: TLCameraOptions;
     readonly cameraMovingTimeoutMs: 64;
     readonly cameraSlideFriction: 0.09;
     readonly coarseDragDistanceSquared: 36;
@@ -868,6 +875,7 @@ export declare const defaultTldrawOptions: {
     readonly createTextOnCanvasDoubleClick: true;
     readonly debouncedZoom: true;
     readonly debouncedZoomThreshold: 500;
+    readonly deepLinks: undefined;
     readonly defaultSvgPadding: 32;
     readonly doubleClickDurationMs: 450;
     readonly dragDistanceSquared: 16;
@@ -876,6 +884,7 @@ export declare const defaultTldrawOptions: {
     readonly edgeScrollEaseDuration: 200;
     readonly edgeScrollSpeed: 25;
     readonly enableToolbarKeyboardShortcuts: true;
+    readonly experimental__onDropOnCanvas: undefined;
     readonly exportProvider: ExoticComponent<FragmentProps>;
     readonly flattenImageBoundsExpand: 64;
     readonly flattenImageBoundsPadding: 16;
@@ -900,6 +909,7 @@ export declare const defaultTldrawOptions: {
     readonly handleRadius: 12;
     readonly hitTestMargin: 8;
     readonly laserDelayMs: 1200;
+    readonly laserFadeoutMs: 500;
     readonly longPressDurationMs: 500;
     readonly maxExportDelayMs: 5000;
     readonly maxFilesAtOnce: 100;
@@ -908,9 +918,11 @@ export declare const defaultTldrawOptions: {
     readonly maxShapesPerPage: 4000;
     readonly multiClickDurationMs: 200;
     readonly nonce: undefined;
+    readonly quickZoomPreservesScreenBounds: true;
     readonly snapThreshold: 8;
     readonly spacebarPanning: true;
     readonly temporaryAssetPreviewLifetimeMs: 180000;
+    readonly text: {};
     readonly textShadowLod: 0.35;
     readonly tooltipDelayMs: 700;
     readonly uiCoarseDragDistanceSquared: 625;
@@ -931,6 +943,7 @@ export declare const defaultUserPreferences: Readonly<{
     isPasteAtCursorMode: false;
     isSnapMode: false;
     isWrapMode: false;
+    isZoomDirectionInverted: false;
     locale: "ar" | "bn" | "ca" | "cs" | "da" | "de" | "el" | "en" | "es" | "fa" | "fi" | "fr" | "gl" | "gu-in" | "he" | "hi-in" | "hr" | "hu" | "id" | "it" | "ja" | "km-kh" | "kn" | "ko-kr" | "ml" | "mr" | "ms" | "ne" | "nl" | "no" | "pa" | "pl" | "pt-br" | "pt-pt" | "ro" | "ru" | "sl" | "so" | "sv" | "ta" | "te" | "th" | "tl" | "tr" | "uk" | "ur" | "vi" | "zh-cn" | "zh-tw";
     name: "";
 }>;
@@ -1009,7 +1022,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, getShapeVisibility, fontAssetUrls, }: TLEditorOptions);
+    constructor({ store, user, shapeUtils, bindingUtils, tools, getContainer, cameraOptions, initialState, autoFocus, inferDarkMode, options: _options, textOptions: _textOptions, getShapeVisibility, fontAssetUrls, }: TLEditorOptions);
     private readonly _getShapeVisibility?;
     private getIsShapeHiddenCache;
     isShapeHidden(shapeOrId: TLShape | TLShapeId): boolean;
@@ -1904,7 +1917,7 @@ export declare class Editor extends EventEmitter<TLEventMap> {
     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,
+     * Get the efficient zoom level. This returns the current zoom level if there are less than a certain number of shapes on the page,
      * otherwise it returns the debounced zoom level. This can be used to avoid expensive re-renders during camera movements.
      *
      * @public
@@ -2257,10 +2270,10 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      */
     stopFollowingUser(): this;
     /* Excluded from this release type: getUnorderedRenderingShapes */
-    private _cameraState;
     private _cameraStateTimeoutRemaining;
     private _decayCameraStateTimeout;
     private _tickCameraState;
+    private _setCameraState;
     /**
      * Whether the camera is moving or idle.
      *
@@ -2759,7 +2772,24 @@ export declare class Editor extends EventEmitter<TLEventMap> {
         hitInside?: boolean;
         margin?: number;
     }): TLShape[];
-    /* Excluded from this release type: getShapeIdsInsideBounds */
+    /**
+     * Get shape IDs within the given bounds.
+     *
+     * Note: Uses shape page bounds only. Frames with labels outside their bounds
+     * may not be included even if the label is within the search bounds.
+     *
+     * Note: Results are unordered. If you need z-order, combine with sorted shapes:
+     * ```ts
+     * const candidates = editor.getShapeIdsInsideBounds(bounds)
+     * const sorted = editor.getCurrentPageShapesSorted().filter(s => candidates.has(s.id))
+     * ```
+     *
+     * @param bounds - The bounds to search within.
+     * @returns Unordered set of shape IDs within the given bounds.
+     *
+     * @public
+     */
+    getShapeIdsInsideBounds(bounds: Box): Set<TLShapeId>;
     /**
      * Test whether a point (in the current page space) will will a shape. This method takes into account masks,
      * such as when a shape is the child of a frame and is partially clipped by the frame.
@@ -3901,7 +3931,7 @@ export declare class Editor extends EventEmitter<TLEventMap> {
     /**
      * Handles navigating to the content specified by the query param in the given URL.
      *
-     * Use {@link Editor#createDeepLink} to create a URL with a deep link query param.
+     * Use {@link Editor.createDeepLink} to create a URL with a deep link query param.
      *
      * If no URL is provided, it will look for the param in the current `window.location.href`.
      *
@@ -4285,7 +4315,10 @@ export declare function getArcMeasure(A: number, B: number, sweepFlag: number, l
 /** @public */
 export declare function getCursor(cursor: TLCursorType, rotation?: number, color?: string): string;
 
-/** @public */
+/**
+ * Gets the default CDN base URL.
+ * @returns The default CDN base URL.
+ * @public */
 export declare function getDefaultCdnBaseUrl(): string;
 
 /**
@@ -4334,7 +4367,7 @@ export declare function getPerfectDashProps(totalLength: number, strokeWidth: nu
 };
 
 /** @public */
-export declare function getPointerInfo(editor: Editor, e: PointerEvent | React.PointerEvent): {
+export declare function getPointerInfo(editor: Editor, e: PointerEvent | React_3.PointerEvent): {
     accelKey: boolean;
     altKey: boolean;
     button: number;
@@ -4395,7 +4428,7 @@ export declare function getSvgAsImage(svgString: string, options: {
 }): Promise<Blob | null>;
 
 /**
- * Turn an array of points into a path of quadradic curves.
+ * Turn an array of points into a path of quadratic curves.
  *
  * @param points - The points returned from perfect-freehand
  * @param closed - Whether the stroke is closed
@@ -4905,7 +4938,6 @@ export declare const isSafeFloat: (n: number) => boolean;
 
 /**
  * Reparents shapes that are no longer contained within their parent shapes.
- * todo: rename me to something more descriptive, like `reparentOccludedShapes` or `reparentAutoDroppedShapes`
  *
  * @param editor - The editor instance.
  * @param shapeIds - The IDs of the shapes to reparent.
@@ -5164,16 +5196,16 @@ export declare function precise(A: VecLike): string;
 /**
  * This function calls `event.preventDefault()` for you. Why is that useful?
  *
- * Beacuase if you enable `window.preventDefaultLogging = true` it'll log out a message when it
+ * Because if you enable `window.preventDefaultLogging = true` it'll log out a message when it
  * happens. Because we use console.warn rather than (log) you'll get a stack trace in the inspector
  * telling you exactly where it happened. This is important because `e.preventDefault()` is the
- * source of many bugs, but unfortuantly it can't be avoided because it also stops a lot of default
+ * source of many bugs, but unfortunately it can't be avoided because it also stops a lot of default
  * behaviour which doesn't make sense in our UI
  *
  * @param event - To prevent default on
  * @public
  */
-export declare function preventDefault(event: Event | React_3.BaseSyntheticEvent): void;
+export declare function preventDefault(event: Event | React.BaseSyntheticEvent): void;
 
 /**
  * Convert radians to degrees.
@@ -5235,7 +5267,7 @@ export declare class Rectangle2d extends Polygon2d {
 export declare function refreshPage(): void;
 
 /** @public */
-export declare function releasePointerCapture(element: Element, event: PointerEvent | React_3.PointerEvent<Element>): void;
+export declare function releasePointerCapture(element: Element, event: PointerEvent | React.PointerEvent<Element>): void;
 
 /** @public */
 export declare type RequiredKeys<T, K extends keyof T> = Required<Pick<T, K>> & Omit<T, K>;
@@ -5303,7 +5335,7 @@ export declare function rotateSelectionHandle(handle: SelectionHandle, rotation:
 
 /** @public */
 export declare const runtime: {
-    hardReset(): void;
+    hardReset(): Promise<void>;
     openWindow(url: string, target: string, allowReferrer?: boolean): void;
     refreshPage(): void;
 };
@@ -5338,27 +5370,106 @@ export declare interface ScribbleItem {
 /** @public */
 export declare class ScribbleManager {
     private editor;
-    scribbleItems: Map<string, ScribbleItem>;
-    state: "paused" | "running";
+    private sessions;
     constructor(editor: Editor);
+    /**
+     * Start a new session for grouping scribbles.
+     * Returns a session ID that can be used with other session methods.
+     *
+     * @param options - Session configuration
+     * @returns Session ID
+     * @public
+     */
+    startSession(options?: ScribbleSessionOptions): string;
+    /**
+     * Add a scribble to a session.
+     *
+     * @param sessionId - The session ID
+     * @param scribble - Partial scribble properties
+     * @param scribbleId - Optional scribble ID
+     * @public
+     */
+    addScribbleToSession(sessionId: string, scribble: Partial<TLScribble>, scribbleId?: string): ScribbleItem;
+    /**
+     * Add a point to a scribble in a session.
+     *
+     * @param sessionId - The session ID
+     * @param scribbleId - The scribble ID
+     * @param x - X coordinate
+     * @param y - Y coordinate
+     * @param z - Z coordinate (pressure)
+     * @public
+     */
+    addPointToSession(sessionId: string, scribbleId: string, x: number, y: number, z?: number): ScribbleItem;
+    /**
+     * Extend a session, resetting its idle timeout.
+     *
+     * @param sessionId - The session ID
+     * @public
+     */
+    extendSession(sessionId: string): void;
+    /**
+     * Stop a session, triggering fade-out.
+     *
+     * @param sessionId - The session ID
+     * @public
+     */
+    stopSession(sessionId: string): void;
+    /**
+     * Clear all scribbles in a session immediately.
+     *
+     * @param sessionId - The session ID
+     * @public
+     */
+    clearSession(sessionId: string): void;
+    /**
+     * Check if a session is active.
+     *
+     * @param sessionId - The session ID
+     * @public
+     */
+    isSessionActive(sessionId: string): boolean;
+    /**
+     * Add a scribble using the default self-consuming behavior.
+     * Creates an implicit session for the scribble.
+     *
+     * @param scribble - Partial scribble properties
+     * @param id - Optional scribble id
+     * @returns The created scribble item
+     * @public
+     */
     addScribble(scribble: Partial<TLScribble>, id?: string): ScribbleItem;
-    reset(): void;
     /**
-     * Start stopping the scribble. The scribble won't be removed until its last point is cleared.
+     * Add a point to a scribble. Searches all sessions.
      *
+     * @param id - The scribble id
+     * @param x - X coordinate
+     * @param y - Y coordinate
+     * @param z - Z coordinate (pressure)
      * @public
      */
-    stop(id: ScribbleItem['id']): ScribbleItem;
+    addPoint(id: string, x: number, y: number, z?: number): ScribbleItem;
     /**
-     * Set the scribble's next point.
+     * Mark a scribble as complete (done being drawn but not yet fading).
+     * Searches all sessions.
      *
-     * @param id - The id of the scribble to add a point to.
-     * @param x - The x coordinate of the point.
-     * @param y - The y coordinate of the point.
-     * @param z - The z coordinate of the point.
+     * @param id - The scribble id
      * @public
      */
-    addPoint(id: ScribbleItem['id'], x: number, y: number, z?: number): ScribbleItem;
+    complete(id: string): ScribbleItem;
+    /**
+     * Stop a scribble. Searches all sessions.
+     *
+     * @param id - The scribble id
+     * @public
+     */
+    stop(id: string): ScribbleItem;
+    /**
+     * Stop and remove all sessions.
+     *
+     * @public
+     */
+    reset(): void;
     /**
      * Update on each animation frame.
      *
@@ -5366,6 +5477,44 @@ export declare class ScribbleManager {
      * @public
      */
     tick(elapsed: number): void;
+    private resetIdleTimeout;
+    private clearIdleTimeout;
+    private tickSession;
+    private tickSessionItems;
+    private tickPersistentItem;
+    private tickSelfConsumingItem;
+    private tickGroupedFade;
+}
+
+/** @public */
+export declare interface ScribbleSessionOptions {
+    /** Session id. Auto-generated if not provided. */
+    id?: string;
+    /**
+     * Whether scribbles self-consume (shrink from start) while drawing.
+     * - true: scribbles eat their own tail as you draw (default, used for eraser/select)
+     * - false: scribbles persist until session stops (used for laser)
+     */
+    selfConsume?: boolean;
+    /**
+     * How long to wait after last activity before auto-stopping the session.
+     * Only applies when selfConsume is false.
+     */
+    idleTimeoutMs?: number;
+    /**
+     * How scribbles fade when stopping.
+     * - 'individual': each scribble fades on its own (default)
+     * - 'grouped': all scribbles fade together as one sequence
+     */
+    fadeMode?: 'grouped' | 'individual';
+    /**
+     * Easing for grouped fade.
+     */
+    fadeEasing?: 'ease-in' | 'linear';
+    /**
+     * Duration of the fade in milliseconds.
+     */
+    fadeDurationMs?: number;
 }
 
 /** @public */
@@ -5378,7 +5527,7 @@ export declare type SelectionEdge = 'bottom' | 'left' | 'right' | 'top';
 export declare type SelectionHandle = SelectionCorner | SelectionEdge;
 
 /** @public */
-export declare function setPointerCapture(element: Element, event: PointerEvent | React_3.PointerEvent<Element>): void;
+export declare function setPointerCapture(element: Element, event: PointerEvent | React.PointerEvent<Element>): void;
 
 /** @public */
 export declare function setRuntimeOverrides(input: Partial<typeof runtime>): void;
@@ -5468,6 +5617,31 @@ export declare abstract class ShapeUtil<Shape extends TLShape = TLShape> {
      * @public
      */
     abstract indicator(shape: Shape): any;
+    /**
+     * Whether to use the legacy React-based indicator rendering.
+     *
+     * Override this to return `false` if your shape implements {@link ShapeUtil.getIndicatorPath}
+     * for canvas-based indicator rendering.
+     *
+     * @returns `true` to use SVG indicators (default), `false` to use canvas indicators.
+     * @public
+     */
+    useLegacyIndicator(): boolean;
+    /**
+     * Get a Path2D for rendering the shape's indicator on the canvas.
+     *
+     * When implemented, this is used instead of {@link ShapeUtil.indicator} for more
+     * efficient canvas-based indicator rendering. Shapes that return `undefined` will
+     * fall back to SVG-based rendering via {@link ShapeUtil.indicator}.
+     *
+     * For complex indicators that need clipping (e.g., arrows with labels), return an
+     * object with `path`, `clipPath`, and `additionalPaths` properties.
+     *
+     * @param shape - The shape.
+     * @returns A Path2D to stroke, or an object with clipping info, or undefined to use SVG fallback.
+     * @public
+     */
+    getIndicatorPath(shape: Shape): TLIndicatorPath | undefined;
     /**
      * Get the font faces that should be rendered in the document in order for this shape to render
      * correctly.
@@ -6683,29 +6857,35 @@ export declare interface TldrawEditorBaseProps {
     inferDarkMode?: boolean;
     /**
      * Camera options for the editor.
+     *
+     * @deprecated Use `options.cameraOptions` instead. This will be removed in a future release.
      */
     cameraOptions?: Partial<TLCameraOptions>;
-    /**
-     * Text options for the editor.
-     */
-    textOptions?: TLTextOptions;
     /**
      * Options for the editor.
      */
     options?: Partial<TldrawOptions>;
+    /**
+     * Text options for the editor.
+     *
+     * @deprecated Use `options.text` instead. This prop will be removed in a future release.
+     */
+    textOptions?: TLTextOptions;
     /**
      * The license key.
      */
     licenseKey?: string;
     /**
      * Options for syncing the editor's camera state with the URL.
+     *
+     * @deprecated Use `options.deepLinks` instead. This prop will be removed in a future release.
      */
     deepLinks?: TLDeepLinkOptions | true;
     /**
      * Provides a way to hide shapes.
      *
      * Hidden shapes will not render in the editor, and they will not be eligible for hit test via
-     * {@link Editor#getShapeAtPoint} and {@link Editor#getShapesAtPoint}. But otherwise they will
+     * {@link @tldraw/editor#Editor.getShapeAtPoint} and {@link @tldraw/editor#Editor.getShapesAtPoint}. But otherwise they will
      * remain in the store and participate in all other operations.
      *
      * @example
@@ -6835,6 +7015,12 @@ export declare interface TldrawOptions {
     readonly flattenImageBoundsExpand: number;
     readonly flattenImageBoundsPadding: number;
     readonly laserDelayMs: number;
+    /**
+     * How long (in milliseconds) to fade all laser scribbles after the session ends.
+     * The total points across all scribbles will be removed proportionally over this duration.
+     * Defaults to 500ms (0.5 seconds).
+     */
+    readonly laserFadeoutMs: number;
     readonly maxExportDelayMs: number;
     readonly tooltipDelayMs: number;
     /**
@@ -6872,13 +7058,13 @@ export declare interface TldrawOptions {
     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,
+     * `editor.getEfficientZoomLevel()` 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.
+     * Defaults to 500 shapes.
      */
     readonly debouncedZoomThreshold: number;
     /**
@@ -6897,6 +7083,46 @@ export declare interface TldrawOptions {
      * The distance (in screen pixels) at which shapes snap to guides and other shapes.
      */
     readonly snapThreshold: number;
+    /**
+     * Options for the editor's camera. These are the initial camera options.
+     * Use {@link Editor.setCameraOptions} to update camera options at runtime.
+     */
+    readonly camera: Partial<TLCameraOptions>;
+    /**
+     * Options for the editor's text rendering. These include TipTap configuration and
+     * font handling. These are the initial text options and cannot be changed at runtime.
+     */
+    readonly text: TLTextOptions;
+    /**
+     * Options for syncing the editor's camera state with the URL. Set to `true` to enable
+     * with default options, or pass an options object to customize behavior.
+     *
+     * @example
+     * ```tsx
+     * // Enable with defaults
+     * <Tldraw options={{ deepLinks: true }} />
+     *
+     * // Enable with custom options
+     * <Tldraw options={{ deepLinks: { param: 'd', debounceMs: 500 } }} />
+     * ```
+     */
+    readonly deepLinks: TLDeepLinkOptions | true | undefined;
+    /**
+     * Whether the quick-zoom brush preserves its screen-pixel size when the user
+     * zooms the overview. When true, zooming in shrinks the target viewport (higher
+     * return zoom); zooming out expands it. When false, the brush keeps the original
+     * viewport's page dimensions regardless of overview zoom changes.
+     */
+    readonly quickZoomPreservesScreenBounds: boolean;
+    /**
+     * Called when content is dropped on the canvas. Provides the page position
+     * where the drop occurred and the underlying drag event object.
+     * Return true to prevent default drop handling (files, URLs, etc.)
+     */
+    experimental__onDropOnCanvas?(options: {
+        event: React.DragEvent<Element>;
+        point: VecLike;
+    }): boolean;
 }
 
 /** @public */
@@ -6981,10 +7207,17 @@ export declare interface TLEditorOptions {
     inferDarkMode?: boolean;
     /**
      * Options for the editor's camera.
+     *
+     * @deprecated Use `options.cameraOptions` instead. This will be removed in a future release.
      */
     cameraOptions?: Partial<TLCameraOptions>;
-    textOptions?: TLTextOptions;
     options?: Partial<TldrawOptions>;
+    /**
+     * Text options for the editor.
+     *
+     * @deprecated Use `options.text` instead. This prop will be removed in a future release.
+     */
+    textOptions?: TLTextOptions;
     licenseKey?: string;
     fontAssetUrls?: {
         [key: string]: string | undefined;
@@ -7398,6 +7631,17 @@ export declare interface TLImageExportOptions extends TLSvgExportOptions {
     format?: TLExportType;
 }
 
+/**
+ * Return type for {@link ShapeUtil.getIndicatorPath}. Can be either a simple Path2D
+ * or an object with additional rendering info like clip paths for complex indicators.
+ * @public
+ */
+export declare type TLIndicatorPath = {
+    additionalPaths?: Path2D[];
+    clipPath?: Path2D;
+    path: Path2D;
+} | Path2D;
+
 /** @public */
 export declare type TLInterruptEvent = (info: TLInterruptEventInfo) => void;
 
@@ -7841,17 +8085,35 @@ export declare interface TLShapeUtilCanBeLaidOutOpts {
 
 /**
  * Options passed to {@link ShapeUtil.canBind}. A binding that could be made. At least one of
- * `fromShapeType` or `toShapeType` will belong to this shape util.
+ * `fromShape` or `toShape` will belong to this shape util.
+ *
+ * The shapes may be full {@link @tldraw/tlschema#TLShape} objects when available, or just
+ * `{ type }` stubs when the shape hasn't been created yet (e.g. during arrow creation). Use
+ * `'id' in shape` to check whether the full shape is available.
  *
  * @public
  */
 export declare interface TLShapeUtilCanBindOpts<Shape extends TLShape = TLShape> {
-    /** The type of shape referenced by the `fromId` of the binding. */
-    fromShapeType: TLShape['type'];
-    /** The type of shape referenced by the `toId` of the binding. */
-    toShapeType: TLShape['type'];
+    /** The shape referenced by the `fromId` of the binding, or a `{ type }` stub if unavailable. */
+    fromShape: {
+        type: TLShape['type'];
+    } | TLShape;
+    /** The shape referenced by the `toId` of the binding, or a `{ type }` stub if unavailable. */
+    toShape: {
+        type: TLShape['type'];
+    } | TLShape;
     /** The type of binding. */
     bindingType: string;
+    /**
+     * The type of shape referenced by the `fromId` of the binding.
+     * @deprecated Use `fromShape.type` instead.
+     */
+    fromShapeType: TLShape['type'];
+    /**
+     * The type of shape referenced by the `toId` of the binding.
+     * @deprecated Use `toShape.type` instead.
+     */
+    toShapeType: TLShape['type'];
 }
 
 /** @public */
@@ -7905,7 +8167,7 @@ export declare interface TLStoreBaseOptions {
     defaultName?: string;
     /** How should this store upload & resolve assets? */
     assets?: TLAssetStore;
-    /** Called when the store is connected to an {@link Editor}. */
+    /** Called when the store is connected to an {@link @tldraw/editor#Editor}. */
     onMount?(editor: Editor): (() => void) | void;
 }
 
@@ -8111,6 +8373,7 @@ export declare interface TLUserPreferences {
     isPasteAtCursorMode?: boolean | null;
     enhancedA11yMode?: boolean | null;
     inputMode?: 'mouse' | 'trackpad' | null;
+    isZoomDirectionInverted?: boolean | null;
 }
 
 /** @public */
@@ -8285,6 +8548,7 @@ export declare class UserPreferencesManager {
         isDynamicResizeMode: boolean;
         isSnapMode: boolean;
         isWrapMode: boolean;
+        isZoomDirectionInverted: boolean;
         locale: string;
         name: string;
     };
@@ -8305,6 +8569,7 @@ export declare class UserPreferencesManager {
     getIsPasteAtCursorMode(): boolean;
     getEnhancedA11yMode(): boolean;
     getInputMode(): "mouse" | "trackpad" | null;
+    getIsZoomDirectionInverted(): boolean;
 }
 
 /** @public */

package/dist-cjs/index.js

@@ -152,7 +152,7 @@ __export(index_exports, {
   getUserPreferences: () => import_TLUserPreferences.getUserPreferences,
   getVerticesCountForArcLength: () => import_geometry_constants.getVerticesCountForArcLength,
   hardReset: () => import_hardReset.hardReset,
-  hardResetEditor: () => import_hardResetEditor.hardResetEditor,
+  hardResetEditor: () => import_runtime.hardResetEditor,
   inlineBase64AssetStore: () => import_createTLStore.inlineBase64AssetStore,
   intersectCircleCircle: () => import_intersect.intersectCircleCircle,
   intersectCirclePolygon: () => import_intersect.intersectCirclePolygon,
@@ -172,7 +172,7 @@ __export(index_exports, {
   loopToHtmlElement: () => import_dom.loopToHtmlElement,
   maybeSnapToGrid: () => import_Pointing.maybeSnapToGrid,
   normalizeWheel: () => import_normalizeWheel.normalizeWheel,
-  openWindow: () => import_window_open.openWindow,
+  openWindow: () => import_runtime.openWindow,
   parseDeepLinkString: () => import_deepLinks.parseDeepLinkString,
   perimeterOfEllipse: () => import_utils2.perimeterOfEllipse,
   pointInPolygon: () => import_utils2.pointInPolygon,
@@ -182,7 +182,7 @@ __export(index_exports, {
   preventDefault: () => import_dom.preventDefault,
   radiansToDegrees: () => import_utils2.radiansToDegrees,
   rangeIntersection: () => import_utils2.rangeIntersection,
-  refreshPage: () => import_refreshPage.refreshPage,
+  refreshPage: () => import_runtime.refreshPage,
   releasePointerCapture: () => import_dom.releasePointerCapture,
   resizeBox: () => import_resizeBox.resizeBox,
   resizeScaled: () => import_resizeScaled.resizeScaled,
@@ -238,11 +238,6 @@ __export(index_exports, {
 });
 module.exports = __toCommonJS(index_exports);
 var import_utils = require("@tldraw/utils");
-var import_at = require("core-js/stable/array/at.js");
-var import_flat_map = require("core-js/stable/array/flat-map.js");
-var import_flat = require("core-js/stable/array/flat.js");
-var import_at2 = require("core-js/stable/string/at.js");
-var import_replace_all = require("core-js/stable/string/replace-all.js");
 __reExport(index_exports, require("@tldraw/state"), module.exports);
 __reExport(index_exports, require("@tldraw/state-react"), module.exports);
 __reExport(index_exports, require("@tldraw/store"), module.exports);
@@ -362,10 +357,8 @@ var import_EditorAtom = require("./lib/utils/EditorAtom");
 var import_getIncrementedName = require("./lib/utils/getIncrementedName");
 var import_getPointerInfo = require("./lib/utils/getPointerInfo");
 var import_getSvgPathFromPoints = require("./lib/utils/getSvgPathFromPoints");
-var import_hardResetEditor = require("./lib/utils/hardResetEditor");
 var import_keyboard = require("./lib/utils/keyboard");
 var import_normalizeWheel = require("./lib/utils/normalizeWheel");
-var import_refreshPage = require("./lib/utils/refreshPage");
 var import_reparenting = require("./lib/utils/reparenting");
 var import_richText = require("./lib/utils/richText");
 var import_rotation = require("./lib/utils/rotation");
@@ -374,10 +367,9 @@ var import_SharedStylesMap = require("./lib/utils/SharedStylesMap");
 var import_hardReset = require("./lib/utils/sync/hardReset");
 var import_LocalIndexedDb = require("./lib/utils/sync/LocalIndexedDb");
 var import_uniq = require("./lib/utils/uniq");
-var import_window_open = require("./lib/utils/window-open");
 (0, import_utils.registerTldrawLibraryVersion)(
   "@tldraw/editor",
-  "4.4.0-canary.f929c9caec2f",
+  "4.4.0-canary.fcefa58e986b",
   "cjs"
 );
 //# sourceMappingURL=index.js.map