@ibodr/editor 0.2.5 → 0.2.7

package/dist/index.d.ts

@@ -3,10 +3,10 @@ import { Signal, Computed, Atom } from '@ibodr/state';
 export * from '@ibodr/state';
 export * from '@ibodr/state-react';
 import * as _ibodr_store from '@ibodr/store';
-import { LegacyMigrations, MigrationSequence, UnknownRecord, SerializedSchema, RecordsDiff, Store, AtomSet, HistoryEntry, StoreSideEffects, SerializedStore, StoreSchema } from '@ibodr/store';
+import { LegacyMigrations, MigrationSequence, UnknownRecord, SerializedSchema, RecordsDiff, Store, HistoryEntry, AtomSet, StoreSideEffects, SerializedStore, StoreSchema } from '@ibodr/store';
 export * from '@ibodr/store';
 import * as _ibodr_schema from '@ibodr/schema';
-import { DrAsset, RecordProps, DrPropsMigrations, DrUnknownAsset, DrAssetId, DrBinding, DrUnknownBinding, DrShape, VecModel, BoxModel, DrHandle, DrShapeId, DrCursorType, DrUnknownShape, DrShapePartial, DrFontFace, DrShapeCrop, DrParentId, DrGroupShape, DrPageId, DrBoardBackgroundType, DrStore, DrStoreSnapshot, DrUser, DrRichText, StyleProp, DrInstancePresence, DrScribble, DrDefaultHorizontalAlignStyle, DrRecord, DrThemes, DrThemeId, DrTheme, DrInstancePageState, DrInstance, DrDocument, DrCursor, DrCamera, DrPage, DrImageAsset, DrVideoAsset, DrAssetPartial, DrBindingId, DrBindingCreate, DrBindingUpdate, DrCreateShapePartial, StylePropValue, DrAssetStore, DrUserStore, DrStoreProps, CustomRecordInfo, DrThemeColors, DrDefaultColorStyle, DrDefaultColor, ExtractShapeByProps, DrDefaultDashStyle, DrBaseShape, DrStoreSchema } from '@ibodr/schema';
+import { VecModel, DrAsset, RecordProps, DrPropsMigrations, DrUnknownAsset, DrAssetId, DrBinding, DrUnknownBinding, DrShape, BoxModel, DrHandle, DrShapeId, DrCursorType, DrUnknownShape, DrShapePartial, DrFontFace, DrShapeCrop, DrParentId, DrGroupShape, DrPageId, DrBoardBackgroundType, DrStore, DrStoreSnapshot, DrUser, DrRichText, StyleProp, DrInstancePresence, DrRecord, DrScribble, DrDefaultHorizontalAlignStyle, DrUserId, DrThemes, DrThemeId, DrTheme, DrInstancePageState, DrInstance, DrDocument, DrCursor, DrCamera, DrPage, DrImageAsset, DrVideoAsset, DrAssetPartial, DrBindingId, DrBindingCreate, DrBindingUpdate, DrCreateShapePartial, StylePropValue, DrAssetStore, DrUserStore, DrStoreProps, CustomRecordInfo, DrThemeColors, DrDefaultColorStyle, DrDefaultColor, ExtractShapeByProps, DrDefaultDashStyle, DrBaseShape, DrStoreSchema } from '@ibodr/schema';
 export * from '@ibodr/schema';
 import { IndexKey, Awaitable, PerformanceTracker, JsonObject, Timers } from '@ibodr/utils';
 export * from '@ibodr/utils';
@@ -20,6 +20,36 @@ import { Editor as Editor$1 } from '@tiptap/core';
 import { Node as Node$1 } from '@tiptap/pm/model';
 import { EditorProviderProps as EditorProviderProps$1 } from '@tiptap/react';
 
+/** @public */
+interface DrCollaboratorCursorLayout {
+    /** Offset of the name/chat badge from the cursor anchor (px, before zoom scale). */
+    badgeOffset: {
+        x: number;
+        y: number;
+    };
+    /** Offset of the pointer icon from the cursor anchor (px, before zoom scale). */
+    iconOffset: {
+        x: number;
+        y: number;
+    };
+}
+
+/** @public */
+interface DrCollaboratorCursorProps {
+    /** Screen position relative to the editor container. */
+    point: {
+        x: number;
+        y: number;
+    };
+    color: string;
+    name?: string | null;
+    chatMessage?: string;
+    /** Scale relative to camera zoom (1 = base size at 100% zoom). */
+    scale: number;
+    /** Layout offsets for the pointer icon and name badge. */
+    layout?: DrCollaboratorCursorLayout;
+}
+
 /** @public */
 interface DrBackgroundProps {
     x: number;
@@ -36,6 +66,25 @@ interface DrCanvasComponentProps {
 /** @public @react */
 declare function DefaultCanvas({ className }: DrCanvasComponentProps): react_jsx_runtime.JSX.Element;
 
+/** @public */
+interface DrCursorProps {
+    userId: string;
+    className?: string;
+    point: VecModel | null;
+    zoom: number;
+    color?: string;
+    name: string | null;
+    chatMessage: string;
+}
+/**
+ * The default collaborator cursor: the arrow glyph plus a name tag or chat bubble. The arrow is a
+ * `<use>` of a shared `<defs>` symbol that `LiveCollaborators` renders, so a `DefaultCursor`
+ * used outside that layer draws no arrow.
+ *
+ * @public @react
+ */
+declare const DefaultCursor: React$1.NamedExoticComponent<DrCursorProps>;
+
 /**
  * A user of tldraw
  *
@@ -1149,7 +1198,7 @@ type DrPointerEventTarget = {
 /** @public */
 type DrPointerEventName = 'pointer_down' | 'pointer_move' | 'long_press' | 'pointer_up' | 'right_click' | 'middle_click';
 /** @public */
-type DrCLickEventName = 'double_click' | 'triple_click' | 'quadruple_click';
+type DrCLickEventName = 'double_click';
 /** @public */
 type DrPinchEventName = 'pinch_start' | 'pinch' | 'pinch_end';
 /** @public */
@@ -1173,6 +1222,13 @@ type DrPointerEventInfo = DrBaseEventInfo & {
     pointerId: number;
     button: number;
     isPen: boolean;
+    /**
+     * Whether this pen event appears to be direct manipulation on the display (e.g. Apple Pencil on
+     * an iPad or a Surface Pen on a touchscreen) rather than indirect input from a desktop graphics
+     * tablet (e.g. a Wacom Intuos). Only direct-display pens should auto-enable pen mode. Drawing and
+     * pressure behavior is driven by `isPen` and applies to all pens regardless of this flag.
+     */
+    isPenDirect?: boolean;
 } & DrPointerEventTarget;
 /** @public */
 type DrClickEventInfo = DrBaseEventInfo & {
@@ -1181,7 +1237,7 @@ type DrClickEventInfo = DrBaseEventInfo & {
     point: VecLike;
     pointerId: number;
     button: number;
-    phase: 'down' | 'up' | 'settle';
+    phase: 'down' | 'up' | 'settle-down' | 'settle-up';
 } & DrPointerEventTarget;
 /** @public */
 type DrKeyboardEventInfo = DrBaseEventInfo & {
@@ -1258,8 +1314,6 @@ interface DrEventHandlers {
     onLongPress: DrPointerEvent;
     onRightClick: DrPointerEvent;
     onDoubleClick: DrClickEvent;
-    onTripleClick: DrClickEvent;
-    onQuadrupleClick: DrClickEvent;
     onMiddleClick: DrPointerEvent;
     onPointerUp: DrPointerEvent;
     onKeyDown: DrKeyboardEvent;
@@ -1859,6 +1913,29 @@ declare abstract class ShapeUtil<Shape extends DrShape = DrShape> {
      * @public
      */
     onBeforeCreate?(next: Shape): Shape | void;
+    /**
+     * A callback called when a shape is reproduced from an existing shape, either by duplicating
+     * ({@link Editor.duplicateShapes}) or by pasting/putting content onto the page
+     * ({@link Editor.putContentOntoCurrentPage}). This provides a last chance to modify the copy
+     * before it's created — for example, to re-stamp attribution so the copy is credited to the
+     * current user rather than the original author. It is not called when content is put with
+     * `preserveIds` (e.g. {@link Editor.moveShapesToPage}), since the shape keeps its identity
+     * and no copy is made.
+     *
+     * @example
+     *
+     * ```ts
+     * onBeforeDuplicate = (source, duplicate) => {
+     * 	return { ...duplicate, props: { ...duplicate.props, editedBy: this.editor.getAttributionUserId() } }
+     * }
+     * ```
+     *
+     * @param source - The shape being copied from.
+     * @param duplicate - The new copy (with its own id), before it's created.
+     * @returns The next shape or void.
+     * @public
+     */
+    onBeforeDuplicate?(source: Shape, duplicate: Shape): Shape | void;
     /**
      * A callback called just before a shape is updated. This method provides a last chance to modify
      * the updated shape.
@@ -2136,6 +2213,45 @@ declare abstract class ShapeUtil<Shape extends DrShape = DrShape> {
      * @public
      */
     onEditEnd?(shape: Shape): void;
+    /**
+     * Provide an app-owned element to be rendered inside the shape, alongside the output of
+     * {@link ShapeUtil.component}. While the shape remains mounted, tldraw guarantees the
+     * element keeps the same DOM position: it is never unmounted, recreated, or relocated by
+     * reordering, reparenting, culling, or re-renders. When adopting the element, tldraw uses
+     * `Node.moveBefore` where available so stateful content like cross-origin iframes keeps
+     * its state across the move, falling back to `appendChild` elsewhere.
+     *
+     * Pair this with {@link ShapeUtil.onReleaseAppOwnedElement} to reclaim the element before
+     * the shape or editor unmounts.
+     *
+     * This is called once per shape mount, not on every prop change, so the adopted element is
+     * not refreshed when the shape's props change. If the element's content depends on props,
+     * return a stable element and mutate it in place (for example from {@link ShapeUtil.component}
+     * or an effect) rather than returning a different element.
+     *
+     * @param shape - The shape.
+     * @returns The element to adopt, or null to render nothing.
+     * @public
+     */
+    getAppOwnedElement?(shape: Shape): HTMLElement | null;
+    /**
+     * A callback called before the shape's app-owned element slot is destroyed: when the shape
+     * unmounts (for example when it is deleted or the current page changes) or when the whole
+     * editor unmounts, including error teardown. The slot is still connected to the document
+     * when this is called, so the app can move the element to another connected parent with
+     * `Node.moveBefore` to preserve its state. An element left in the slot is destroyed along
+     * with it.
+     *
+     * This is not only a "shape deleted" signal: it also fires on page changes, editor unmount,
+     * and (in dev under React StrictMode) on the throwaway mount/unmount cycle while the shape
+     * still exists. Make it safe to call when the shape is still present, and check the store
+     * (`this.editor.getShape(shape.id)`) if you need to distinguish deletion from a remount.
+     *
+     * @param shape - The shape.
+     * @param element - The element returned by {@link ShapeUtil.getAppOwnedElement}.
+     * @public
+     */
+    onReleaseAppOwnedElement?(shape: Shape, element: HTMLElement): void;
 }
 /**
  * Info about a crop.
@@ -2154,6 +2270,7 @@ interface DrCropInfo<T extends DrShape> {
     };
     initialShape: T;
     aspectRatioLocked?: boolean;
+    isResizingFromCenter?: boolean;
 }
 /** @public */
 interface DrDragShapesInInfo {
@@ -2380,6 +2497,11 @@ interface DrDrawLegacyExternalContentSource {
 type DrExternalContentSource = DrDrawExternalContentSource | DrDrawLegacyExternalContentSource | DrExcalidrawExternalContentSource | DrMiroExternalContentSource | DrTextExternalContentSource | DrErrorExternalContentSource;
 /** @public */
 interface DrBaseExternalContent {
+    /**
+     * The other content sources found on the clipboard alongside this content. For example, when
+     * pasting an image copied together with HTML and plain text, the `files` content will have
+     * text sources for the HTML and plain text parts.
+     */
     sources?: DrExternalContentSource[];
     point?: VecLike;
 }
@@ -2407,6 +2529,11 @@ interface DrFileReplaceExternalContent extends DrBaseExternalContent {
 interface DrUrlExternalContent extends DrBaseExternalContent {
     type: 'url';
     url: string;
+    /**
+     * A shape to set the url on, instead of creating a bookmark or an embed. The shape must have a
+     * `url` prop; the clipboard sets this when a link is pasted with one such shape selected.
+     */
+    shapeId?: DrShapeId;
 }
 /** @public */
 interface DrSvgTextExternalContent extends DrBaseExternalContent {
@@ -2839,6 +2966,7 @@ interface DrawOptions {
     readonly collaboratorCheckIntervalMs: number;
     readonly cameraMovingTimeoutMs: number;
     readonly hitTestMargin: number;
+    readonly coarseHitTestMargin: number;
     readonly edgeScrollDelay: number;
     readonly edgeScrollEaseDuration: number;
     readonly edgeScrollSpeed: number;
@@ -3076,7 +3204,8 @@ declare const defaultDrawOptions: {
     readonly collaboratorIdleTimeoutMs: 3000;
     readonly collaboratorCheckIntervalMs: 1200;
     readonly cameraMovingTimeoutMs: 64;
-    readonly hitTestMargin: 8;
+    readonly hitTestMargin: 3;
+    readonly coarseHitTestMargin: 4;
     readonly edgeScrollDelay: 200;
     readonly edgeScrollEaseDuration: 200;
     readonly edgeScrollSpeed: 25;
@@ -3159,7 +3288,7 @@ declare class SharedStyleMap extends ReadonlySharedStyleMap {
 }
 
 /** @public */
-type DrClickState = 'idle' | 'pendingDouble' | 'pendingTriple' | 'pendingQuadruple' | 'pendingOverflow' | 'overflow';
+type DrClickState = 'idle' | 'pendingDouble' | 'pendingOverflow' | 'overflow';
 /** @public */
 declare class ClickManager {
     editor: Editor;
@@ -3168,6 +3297,7 @@ declare class ClickManager {
     private _clickTimeout?;
     private _clickScreenPoint?;
     private _previousScreenPoint?;
+    private _isPressingWhilePending;
     _getClickTimeout(state: DrClickState, id?: string): void;
     /**
      * The current click state.
@@ -3329,6 +3459,10 @@ declare class HistoryManager<R extends UnknownRecord> {
     getNumUndos(): number;
     getNumRedos(): number;
     /** @internal */
+    private _isReplaying;
+    /** @internal */
+    isReplaying(): boolean;
+    /** @internal */
     _isInBatch: boolean;
     batch(fn: () => void, opts?: DrHistoryBatchOptions): this;
     _undo({ pushToRedoStack, toMark }: {
@@ -3358,9 +3492,123 @@ declare class HistoryManager<R extends UnknownRecord> {
 }
 
 /** @public */
-declare class InputsManager {
-    private readonly editor;
+interface DrEventMap {
+    mount: [];
+    unmount: [];
+    'max-shapes': [{
+        name: string;
+        pageId: DrPageId;
+        count: number;
+    }];
+    change: [HistoryEntry<DrRecord>];
+    update: [];
+    crash: [{
+        error: unknown;
+    }];
+    'stop-camera-animation': [];
+    'stop-following': [];
+    'before-event': [DrEventInfo];
+    event: [DrEventInfo];
+    tick: [number];
+    frame: [number];
+    resize: [BoxModel];
+    'select-all-text': [{
+        shapeId: DrShapeId;
+    }];
+    'place-caret': [{
+        shapeId: DrShapeId;
+        point: {
+            x: number;
+            y: number;
+        };
+    }];
+    'created-shapes': [DrRecord[]];
+    'edited-shapes': [DrRecord[]];
+    'deleted-shapes': [DrShapeId[]];
+    /**
+     * Fired after a successful Miro clipboard paste (`miro-data-v1`).
+     * Payload is produced by `@ibodr/draw` putMiroContent.
+     */
+    'paste-miro': [
+        {
+            shapeCount: number;
+            shapeIds: DrShapeId[];
+            widgetTypes: string[];
+            miroBoardId: string | null;
+            miroHost: string | null;
+        }
+    ];
+    edit: [];
+    dispose: [];
+}
+/** @public */
+type DrEventMapHandler<T extends keyof DrEventMap> = (...args: DrEventMap[T]) => void;
+
+/**
+ * Base class for editor-attached managers that need to clean up after themselves.
+ *
+ * Extending `EditorManager` gives a manager one consistent teardown contract: register
+ * anything that needs undoing, and it runs automatically on `dispose()`. This keeps
+ * subscription lifecycle symmetric — whatever sets a thing up is what tears it down — so
+ * it can't be forgotten (the failure mode behind the strict-mode camera bug, #8892).
+ *
+ * Register cleanup by what you're creating:
+ *
+ * - Editor bus event (`tick`, `frame`, `change`, …): {@link EditorManager.addEditorEvent}
+ * - Store side effect (`editor.sideEffects.register…`): `this.register(disposer)`
+ * - Reaction (`react(...)` from `@ibodr/state`): `this.register(react(...))`
+ * - DOM listener: `this.register(() => el.removeEventListener(...))`
+ * - Other resource (cache, index, child manager): `this.register(() => x.dispose())`
+ * - Resource held only part of the time (a listener attached while subscribers exist):
+ *   `this.register(...)` on attach and `this.unregister(...)` on detach, see `PerformanceManager`
+ *
+ * For timeouts, intervals, and animation frames prefer `editor.timers` (context-grouped
+ * and auto-disposed) over raw `setTimeout`. For cleanup on the editor itself rather than a
+ * manager, use `editor.disposables`.
+ *
+ * If a manager needs ordered teardown (e.g. pause a loop before cancelling it), override
+ * `dispose()` and call `super.dispose()` last — see `TickManager`.
+ *
+ * @public
+ */
+declare abstract class EditorManager {
+    protected readonly editor: Editor;
+    protected readonly disposables: Set<() => void>;
+    constructor(editor: Editor);
+    /**
+     * Register a teardown function to run on `dispose()`. The universal way for a manager to
+     * make a resource "see itself out". Returns the same function for convenience.
+     */
+    protected register(dispose: () => void): () => void;
+    /**
+     * Run a registered teardown now instead of at `dispose()`. A teardown that is no longer
+     * registered (already run by `dispose()`, or never registered) is skipped, so nothing is
+     * torn down twice.
+     */
+    protected unregister(dispose: () => void): void;
+    /**
+     * Subscribe to an editor bus event and register the matching unsubscribe, so the listener
+     * is removed automatically on `dispose()`. Returns that unsubscribe, for passing to
+     * {@link EditorManager.unregister} to detach it before `dispose()`.
+     */
+    protected addEditorEvent<E extends keyof DrEventMap>(event: E, fn: (...args: DrEventMap[E]) => void): () => void;
+    /** @internal */
+    dispose(): void;
+}
+
+/** @public */
+declare class InputsManager extends EditorManager {
     constructor(editor: Editor);
+    private _detachActivityListenersFn;
+    /**
+     * User input anywhere in the editor's tab counts as activity for collaborator presence —
+     * presence means "this person is here", whether or not the input lands on the editor itself
+     * (e.g. typing in a sidebar next to the canvas). Listen in the capture phase so input that
+     * other handlers swallow still counts.
+     */
+    private _attachActivityListeners;
+    private _detachActivityListeners;
+    private _onFrame;
     private _originPagePoint;
     /**
      * The most recent pointer down's position in the current page space.
@@ -3425,8 +3673,7 @@ declare class InputsManager {
      */
     get pointerVelocity(): Vec;
     /**
-     * Normally you shouldn't need to set the pointer velocity directly, this is set by the tick manager.
-     * However, this is currently used in tests to fake pointer velocity.
+     * Normally you shouldn't need to set the pointer velocity directly. Used in tests to fake pointer velocity.
      * @param pointerVelocity - The pointer velocity.
      * @internal
      */
@@ -3617,6 +3864,26 @@ declare class InputsManager {
      */
     setIsSpacebarPanning(isSpacebarPanning: boolean): void;
     private _getHasCollaborators;
+    private readonly _throttledActivityStamp;
+    /**
+     * Mark the current user as active for collaborator presence. User input anywhere in the
+     * editor's tab counts as activity automatically; call this to make input that doesn't produce
+     * DOM events count too, so peers don't classify this user as idle or inactive while they're
+     * still interacting. Calls are throttled on the leading edge, so it's safe to call from
+     * high-frequency input events.
+     *
+     * @example
+     * ```ts
+     * // Gamepads are polled rather than event-driven, so stamp activity from the poll
+     * editor.timers.setInterval(() => {
+     * 	const isPressed = navigator
+     * 		.getGamepads()
+     * 		.some((pad) => pad?.buttons.some((button) => button.pressed))
+     * 	if (isPressed) editor.inputs.markActivity()
+     * }, 50)
+     * ```
+     */
+    markActivity(): void;
     /**
      * The previous point used for velocity calculation (updated each tick, not each pointer event).
      * @internal
@@ -3861,18 +4128,12 @@ interface DrPerfEventMap {
  *
  * @public
  */
-declare class PerformanceManager {
+declare class PerformanceManager extends EditorManager {
     /** @internal */
     readonly emitter: EventEmitter<DrPerfEventMap, any>;
-    private editor;
     private activeInteraction;
     private activeCamera;
-    private frameCleanup;
-    private shapeCreatedCleanup;
-    private shapeEditedCleanup;
-    private shapeDeletedCleanup;
-    private loafObserver;
-    constructor(editor: Editor);
+    private readonly lazyCleanups;
     /**
      * Subscribe to a performance event. Returns an unsubscribe function.
      *
@@ -3911,11 +4172,11 @@ declare class PerformanceManager {
     private _onShapesEdited;
     private _onShapesDeleted;
     private _startLoafObserver;
-    private _stopLoafObserver;
     private _needsFrameListener;
     private _needsLoafObserver;
     private _maybeAttachLazyListeners;
     private _maybeDetachLazyListeners;
+    private _detachLazy;
 }
 
 /** @public */
@@ -4076,6 +4337,18 @@ declare class ScribbleManager {
     private tickGroupedFade;
 }
 
+/**
+ * The whole-pixel line-height for a given font size and tldraw's unitless line-height
+ * multiplier. tldraw's theme stores line-height as a multiplier (e.g. 1.35); resolving it
+ * to a whole pixel keeps line spacing identical across rendering engines, which otherwise
+ * disagree on fractional line boxes (WebKit snaps them to whole pixels, Blink keeps the
+ * fraction) and let multi-line text drift apart. Apply it everywhere line-height is used —
+ * measurement, on-canvas render, and export — so geometry and rendering agree.
+ * See https://github.com/tldraw/tldraw/issues/8970.
+ *
+ * @public
+ */
+declare function resolveLineHeightPx(fontSize: number, lineHeight: number): number;
 /** @public */
 interface BatchMeasurementRequest {
     html: string;
@@ -4121,8 +4394,7 @@ interface DrMeasureTextSpanOpts {
     measureScrollWidth?: boolean;
 }
 /** @public */
-declare class TextManager {
-    editor: Editor;
+declare class TextManager extends EditorManager {
     private elm;
     private poolElms;
     constructor(editor: Editor);
@@ -4130,7 +4402,6 @@ declare class TextManager {
     private resetElementStyles;
     private setElementStyles;
     private getMeasureStyles;
-    dispose(): void;
     private ensurePoolSize;
     private getPoolItem;
     measureHtmlBatch(requests: BatchMeasurementRequest[]): DrMeasuredTextSize[];
@@ -4168,6 +4439,7 @@ declare class UserPreferencesManager {
     private readonly user;
     private readonly colorScheme;
     systemColorScheme: _ibodr_state.Atom<"light" | "dark", unknown>;
+    private readonly systemPrefersReducedMotion;
     disposables: Set<() => void>;
     dispose(): void;
     constructor(user: DrCurrentUser, colorScheme: 'light' | 'dark' | 'system' | 'inherit');
@@ -4195,7 +4467,25 @@ declare class UserPreferencesManager {
     getEdgeScrollSpeed(): number;
     getAnimationSpeed(): number;
     getAreKeyboardShortcutsEnabled(): boolean;
+    /**
+     * The current user's raw, app-provided id — the value set in the user's
+     * {@link @ibodr/editor#DrUserPreferences}. Use this when you need the id your application
+     * assigned to the user. To compare against or look up store records, use
+     * {@link UserPreferencesManager.getRecordId} instead.
+     */
+    getExternalId(): string;
+    /**
+     * @deprecated Use {@link UserPreferencesManager.getExternalId} for the raw app-provided id, or
+     * {@link UserPreferencesManager.getRecordId} for the prefixed `DrUserId` record id.
+     */
     getId(): string;
+    /**
+     * The current user's id as a tldraw {@link @ibodr/schema#DrUserId} record id (prefixed
+     * with `user:`). Use this when comparing against or looking up store records, such as a
+     * presence record's `userId` or `followingUserId`. For the raw, app-provided id, use
+     * {@link UserPreferencesManager.getExternalId}.
+     */
+    getRecordId(): DrUserId;
     getName(): string;
     getLocale(): string;
     getColor(): string;
@@ -4398,8 +4688,6 @@ declare abstract class StateNode implements Partial<DrEventHandlers> {
     onLongPress?(info: DrPointerEventInfo): void;
     onPointerUp?(info: DrPointerEventInfo): void;
     onDoubleClick?(info: DrClickEventInfo): void;
-    onTripleClick?(info: DrClickEventInfo): void;
-    onQuadrupleClick?(info: DrClickEventInfo): void;
     onRightClick?(info: DrPointerEventInfo): void;
     onMiddleClick?(info: DrPointerEventInfo): void;
     onKeyDown?(info: DrKeyboardEventInfo): void;
@@ -4413,58 +4701,6 @@ declare abstract class StateNode implements Partial<DrEventHandlers> {
     onExit?(info: any, to: string): void;
 }
 
-/** @public */
-interface DrEventMap {
-    mount: [];
-    'max-shapes': [{
-        name: string;
-        pageId: DrPageId;
-        count: number;
-    }];
-    change: [HistoryEntry<DrRecord>];
-    update: [];
-    crash: [{
-        error: unknown;
-    }];
-    'stop-camera-animation': [];
-    'stop-following': [];
-    'before-event': [DrEventInfo];
-    event: [DrEventInfo];
-    tick: [number];
-    frame: [number];
-    resize: [BoxModel];
-    'select-all-text': [{
-        shapeId: DrShapeId;
-    }];
-    'place-caret': [{
-        shapeId: DrShapeId;
-        point: {
-            x: number;
-            y: number;
-        };
-    }];
-    'created-shapes': [DrRecord[]];
-    'edited-shapes': [DrRecord[]];
-    'deleted-shapes': [DrShapeId[]];
-    /**
-     * Fired after a successful Miro clipboard paste (`miro-data-v1`).
-     * Payload is produced by `@ibodr/draw` putMiroContent.
-     */
-    'paste-miro': [
-        {
-            shapeCount: number;
-            shapeIds: DrShapeId[];
-            widgetTypes: string[];
-            miroBoardId: string | null;
-            miroHost: string | null;
-        }
-    ];
-    edit: [];
-    dispose: [];
-}
-/** @public */
-type DrEventMapHandler<T extends keyof DrEventMap> = (...args: DrEventMap[T]) => void;
-
 /** @public */
 type DrResizeShapeOptions = Partial<{
     initialBounds: Box;
@@ -4645,6 +4881,19 @@ declare class Editor extends EventEmitter<DrEventMap> {
      * @public
      */
     isDisposed: boolean;
+    private readonly _isMounted;
+    /**
+     * Whether the editor is currently mounted. This is `true` while the editor's component is
+     * mounted in the DOM (after the `mount` event) and `false` before mount and after `unmount`.
+     *
+     * Unlike disposal, mounting is not terminal: the editor's component can unmount and remount
+     * (for example when the canvas is replaced by an error fallback and restored) without the
+     * editor itself being disposed. To react to the transitions, listen to the editor's `mount`
+     * and `unmount` events.
+     *
+     * @public
+     */
+    getIsMounted(): boolean;
     /**
      * A manager for the editor's tick events.
      *
@@ -4684,6 +4933,9 @@ declare class Editor extends EventEmitter<DrEventMap> {
         setTimeout: (handler: TimerHandler, timeout?: number, ...args: any[]) => number;
         setInterval: (handler: TimerHandler, timeout?: number, ...args: any[]) => number;
         requestAnimationFrame: (callback: FrameRequestCallback) => number;
+        clearTimeout: (id: number | undefined) => void;
+        clearInterval: (id: number | undefined) => void;
+        cancelAnimationFrame: (id: number | undefined) => void;
         dispose: () => void;
     };
     /**
@@ -5036,6 +5288,12 @@ declare class Editor extends EventEmitter<DrEventMap> {
      * @internal this is only used to implement some backwards-compatibility logic. Should be fine to delete after 6 months or whatever.
      */
     getMarkIdMatching(idSubstring: string): string | null;
+    /**
+     * Whether the editor is currently replaying history (i.e. an undo or redo is being applied).
+     *
+     * @internal
+     */
+    isReplayingHistory(): boolean;
     /**
      * Coalesces all changes since the given mark into a single change, removing any intermediate marks.
      *
@@ -5959,6 +6217,7 @@ declare class Editor extends EventEmitter<DrEventMap> {
      *
      * @public */
     getBaseZoom(): number;
+    private _getFitZoom;
     private _cameraOptions;
     /**
      * Get the current camera options.
@@ -6170,7 +6429,7 @@ declare class Editor extends EventEmitter<DrEventMap> {
      * @param opts - The camera move options.
      * @public
      */
-    zoomToUser(userId: string, opts?: DrCameraMoveOptions): this;
+    zoomToUser(userId: DrUserId, opts?: DrCameraMoveOptions): this;
     /** @internal */
     private _willSetInitialBounds;
     /**
@@ -6318,7 +6577,7 @@ declare class Editor extends EventEmitter<DrEventMap> {
     getAttributionUser(userId: string | null): DrUser | null;
     /**
      * Collect user IDs referenced by a set of shapes via shape-specific props
-     * (e.g. `textFirstEditedBy` on notes).
+     * (e.g. `textLastEditedBy` on notes).
      *
      * @internal
      */
@@ -6336,7 +6595,7 @@ declare class Editor extends EventEmitter<DrEventMap> {
      *
      * @public
      */
-    startFollowingUser(userId: string): this;
+    startFollowingUser(userId: DrUserId): this;
     /**
      * Stop viewport-following a user.
      *
@@ -6833,6 +7092,17 @@ declare class Editor extends EventEmitter<DrEventMap> {
      * @public
      */
     getCurrentPageBounds(): Box | undefined;
+    /**
+     * Get the hit-test margin in page space—the distance in page units within which a pointer is
+     * considered to be touching a shape. This resolves to {@link DrawOptions.hitTestMargin} (or
+     * {@link DrawOptions.coarseHitTestMargin} when using a coarse pointer) divided by the current
+     * zoom level, so it stays a constant distance in screen space.
+     *
+     * @returns The hit-test margin in page space.
+     *
+     * @public
+     */
+    getHitTestMargin(): number;
     /**
      * Get the top-most selected shape at the given point, ignoring groups.
      *
@@ -7201,6 +7471,15 @@ declare class Editor extends EventEmitter<DrEventMap> {
     deleteBindings(bindings: (DrBinding | DrBindingId)[], { isolateShapes }?: {
         isolateShapes?: boolean | undefined;
     }): this;
+    /**
+     * Unguarded so that withIsolatedShapes can transiently isolate shapes for copy and export in
+     * readonly mode; the public deleteBindings is what readonly blocks.
+     *
+     * @internal
+     */
+    _deleteBindings(bindings: (DrBinding | DrBindingId)[], { isolateShapes }?: {
+        isolateShapes?: boolean | undefined;
+    }): this;
     /**
      * Delete a binding by its ID. If the binding doesn't exist, it's ignored.
      */
@@ -7233,6 +7512,7 @@ declare class Editor extends EventEmitter<DrEventMap> {
         center?: VecLike;
     }): this;
     private getChangesToTranslateShape;
+    private getChangesToTranslateShapeByPageDelta;
     /**
      * Move shapes by a delta.
      *
@@ -7430,7 +7710,7 @@ declare class Editor extends EventEmitter<DrEventMap> {
      *
      * @public
      */
-    alignShapes(shapes: DrShapeId[] | DrShape[], operation: 'left' | 'center-horizontal' | 'right' | 'top' | 'center-vertical' | 'bottom'): this;
+    alignShapes(shapes: DrShapeId[] | DrShape[], operation: 'left' | 'center-horizontal' | 'right' | 'top' | 'center-vertical' | 'bottom' | 'center'): this;
     /**
      * Distribute shape positions.
      *
@@ -7487,6 +7767,18 @@ declare class Editor extends EventEmitter<DrEventMap> {
      * @public
      */
     resizeShape(shape: DrShapeId | DrShape, scale: VecLike, opts?: DrResizeShapeOptions): this;
+    /**
+     * Get the update for a resized shape without committing it to the store. Interactions that
+     * resize many shapes at once use this to collect all of the updates and commit them in a
+     * single batch. Returns null when there is nothing to update.
+     *
+     * Shapes that are rotated out of alignment with the scale axis cannot be resized with a
+     * single update; those shapes are resized immediately (as `resizeShape` would do) and null
+     * is returned.
+     *
+     * @internal
+     */
+    getResizeShapePartial(shape: DrShapeId | DrShape, scale: VecLike, opts?: DrResizeShapeOptions): DrShapePartial | null;
     /** @internal */
     private _scalePagePoint;
     /** @internal */
@@ -7684,11 +7976,12 @@ declare class Editor extends EventEmitter<DrEventMap> {
     deleteShape(id: DrShapeId): this;
     deleteShape(shape: DrShape): this;
     /**
-     * Get all the current styles among the users selected shapes
+     * Groups have no styles of their own: a style read or write on a selection applies to the
+     * non-group shapes beneath each group, however deeply nested. Returns those shapes.
      *
      * @internal
      */
-    private _extractSharedStyles;
+    private _getStyleableShapes;
     /**
      * A derived map containing all current styles among the user's selected shapes.
      *
@@ -8242,26 +8535,65 @@ declare class Editor extends EventEmitter<DrEventMap> {
     private _prevCursor;
     /** @internal */
     private _shiftKeyTimeout;
-    /** @internal */
-    _setShiftKeyTimeout(): void;
+    /**
+     * Release the shift modifier: clear its debounce timer id, drop the atom, and
+     * dispatch a synthetic `key_up` so `inputs.keys` and tool `onKeyUp` handlers update.
+     * Runs both as the 150ms debounce timer callback and when a pointer down flushes it.
+     * @internal
+     */
+    _releaseShiftKey(): void;
     /** @internal */
     private _altKeyTimeout;
-    /** @internal */
-    _setAltKeyTimeout(): void;
+    /**
+     * Release the alt modifier. See {@link Editor._releaseShiftKey}.
+     * @internal
+     */
+    _releaseAltKey(): void;
     /** @internal */
     private _ctrlKeyTimeout;
-    /** @internal */
-    _setCtrlKeyTimeout(): void;
+    /**
+     * Release the ctrl modifier. See {@link Editor._releaseShiftKey}.
+     * @internal
+     */
+    _releaseCtrlKey(): void;
     /** @internal */
     private _metaKeyTimeout;
-    /** @internal */
-    _setMetaKeyTimeout(): void;
+    /**
+     * Release the meta modifier. See {@link Editor._releaseShiftKey}.
+     * @internal
+     */
+    _releaseMetaKey(): void;
+    /**
+     * Flush any modifier still sitting in its 150ms release-debounce window, so a new
+     * interaction (a pointer down) starts with correct modifier state instead of a
+     * just-released key still being counted as held. A pending timer is exactly
+     * "released but still counted as held"; a genuinely-held modifier has no timer
+     * (-1) and is left alone.
+     *
+     * Each modifier is released through the same path its timer would have taken
+     * (`_releaseShiftKey` and friends), which dispatches the synthetic `key_up` so
+     * stale codes (e.g. `ShiftLeft`) leave `inputs.keys` and tool `onKeyUp` handlers run.
+     * We clear every pending modifier atom and timer *first*, then dispatch: a synthetic
+     * `key_up` reports all currently-held modifiers, so releasing them one at a time
+     * would make each event re-confirm the not-yet-released ones and cancel their flush.
+     * @internal
+     */
+    private _releaseDebouncedModifiers;
     /** @internal */
     private _restoreToolId;
     /** @internal */
     private _didPinch;
     /** @internal */
     private _selectedShapeIdsAtPointerDown;
+    /**
+     * Whether `_selectedShapeIdsAtPointerDown` holds a pre-gesture selection
+     * captured by a `pointer_down` (the touch path) that a following pinch
+     * should restore. False when no pointer_down preceded the pinch (the
+     * Safari trackpad path uses gesture events), in which case `pinch_start`
+     * captures the live selection instead.
+     * @internal
+     */
+    private _didCaptureSelectionAtPointerDown;
     /** @internal */
     private _longPressTimeout;
     /** @internal */
@@ -8317,12 +8649,19 @@ declare class Editor extends EventEmitter<DrEventMap> {
 }
 
 /** @public */
-type DrErrorFallbackComponent = ComponentType<{
+interface DrErrorFallbackProps {
+    /** The error that was caught. */
     error: unknown;
+    /**
+     * Only set when the caller renders the fallback with an editor; the editor's own error
+     * boundaries pass just `error`.
+     */
     editor?: Editor;
-}>;
+}
+/** @public */
+type DrErrorFallbackComponent = ComponentType<DrErrorFallbackProps>;
 /** @public @react */
-declare const DefaultErrorFallback: DrErrorFallbackComponent;
+declare function DefaultErrorFallback({ error, editor }: DrErrorFallbackProps): react_jsx_runtime.JSX.Element;
 
 /** @public */
 interface DrGridProps {
@@ -8334,14 +8673,6 @@ interface DrGridProps {
 /** @public @react */
 declare function DefaultGrid({ x, y, z, size }: DrGridProps): react_jsx_runtime.JSX.Element;
 
-/** @public */
-interface DrSelectionBackgroundProps {
-    bounds: Box;
-    rotation: number;
-}
-/** @public @react */
-declare function DefaultSelectionBackground({ bounds, rotation }: DrSelectionBackgroundProps): react_jsx_runtime.JSX.Element;
-
 /** @public */
 type DrShapeErrorFallbackComponent = ComponentType<{
     error: any;
@@ -8359,11 +8690,67 @@ interface DrShapeWrapperProps extends React.HTMLAttributes<HTMLDivElement> {
 /** @public @react */
 declare const DefaultShapeWrapper: React$1.ForwardRefExoticComponent<DrShapeWrapperProps & React$1.RefAttributes<HTMLDivElement>>;
 
+/** @public */
+type DrSpinnerProps = React.SVGProps<SVGSVGElement>;
 /** @public @react */
-declare function DefaultSpinner(props: React.SVGProps<SVGSVGElement>): react_jsx_runtime.JSX.Element;
+declare function DefaultSpinner(props: DrSpinnerProps): react_jsx_runtime.JSX.Element;
 
 /** @public @react */
-declare const DefaultSvgDefs: () => null;
+declare function DefaultSvgDefs(): null;
+
+/**
+ * The DOM node that {@link EditorPortal} renders into: an empty `display: contents` element the
+ * editor renders last among its container's children, after the canvas and after the UI.
+ *
+ * Null until the container has mounted, so prefer {@link EditorPortal}, which handles that for you.
+ *
+ * @public
+ */
+declare function useEditorPortalHost(): HTMLElement | null;
+/** @public */
+interface EditorPortalProps {
+    children: ReactNode;
+}
+/**
+ * Renders its children into the end of the editor's container, escaping the canvas layer.
+ *
+ * Use this for anything anchored to canvas coordinates that also has to draw over the UI — a
+ * popover on a shape, a comment thread, an annotation panel. The `OnTheCanvas` and
+ * `InFrontOfTheCanvas` slots are fixed layers, each its own stacking context, so content mounted
+ * there can't paint above whatever outranks its layer whatever z-index it asks for. Mount in
+ * whichever slot suits your data flow, wrap the part that needs its own layer in this, and give
+ * that part a z-index.
+ *
+ * This package's own layers stop at 250 (`--dr-layer-canvas-in-front`); above that belongs to
+ * whatever renders the UI. In `tldraw` that's `--dr-layer-panels` (300) and `--dr-layer-menus`
+ * (400), defined by `tldraw`'s stylesheet rather than this one.
+ *
+ * Positioning still resolves against the editor's container, so a `position: absolute` child uses
+ * ordinary container coordinates.
+ *
+ * Prefer this over `createPortal(children, useContainer())`, which picks its DOM position from the
+ * commit that mounts it — landing the node ahead of the UI and of the "skip to main content" link
+ * that only works while nothing precedes it. This host is a real element placed last, so ordering
+ * is fixed rather than dependent on mount timing.
+ *
+ * @example
+ * ```tsx
+ * // 400 clears tldraw's menus layer; the bare editor's own layers stop at 250.
+ * function ShapeAnnotation({ point }: { point: VecLike }) {
+ * 	return (
+ * 		<EditorPortal>
+ * 			<div style={{ position: 'absolute', left: point.x, top: point.y, zIndex: 400 }}>
+ * 				Above the UI
+ * 			</div>
+ * 		</EditorPortal>
+ * 	)
+ * }
+ * ```
+ *
+ * @public
+ * @react
+ */
+declare function EditorPortal({ children }: EditorPortalProps): React$1.ReactPortal | null;
 
 /** @public */
 interface DrErrorBoundaryProps {
@@ -8480,20 +8867,50 @@ declare const DEFAULT_ANIMATION_OPTIONS: {
 /** @public */
 declare const SIDES: readonly ["top", "right", "bottom", "left"];
 
+/**
+ * Optional adapter that pipes PerformanceManager events into browser
+ * `performance.mark()` / `performance.measure()` for DevTools integration.
+ *
+ * Tree-shakeable — only included if imported.
+ *
+ * @example
+ * ```ts
+ * const adapter = new PerformanceApiAdapter(editor.performance)
+ * // ... later
+ * adapter.dispose()
+ * ```
+ *
+ * @public
+ */
+declare class PerformanceApiAdapter {
+    private cleanups;
+    constructor(perfManager: PerformanceManager);
+    /** Remove all listeners and stop piping events. @public */
+    dispose(): void;
+}
+
 /**
  * Manages spatial indexing for efficient shape location queries.
  *
  * Uses an R-tree (via RBush) to enable O(log n) spatial queries instead of O(n) iteration.
- * Handles shapes with computed bounds (arrows, groups, custom shapes) by checking all shapes'
- * bounds on each update using the reactive bounds cache.
+ * Derived-bounds changes (arrows following bound shapes, groups resizing with children) are
+ * tracked structurally: each record diff is expanded into a dirty set covering the changed
+ * shapes' descendants, ancestors, and binding partners, and only those shapes' bounds are
+ * rechecked — O(affected) per update instead of O(page).
  *
  * Key features:
- * - Incremental updates using filterHistory pattern
- * - Leverages existing bounds cache reactivity for dependency tracking
- * - Works with any custom shape type with computed bounds
+ * - Incremental updates using filterHistory pattern (shape and binding history)
+ * - Dirty-set expansion via parent/child and binding relationships
  * - Per-page index (rebuilds on page change)
  * - Optimized for viewport culling queries
  *
+ * Known limitation: a custom shape whose geometry reads other shapes outside the
+ * parent/child and binding relationships is not rechecked when those shapes change.
+ * Core shapes only depend on other shapes via bindings (arrows) and parent/child
+ * relationships (groups), which are both covered. This narrows the previous
+ * approach, which rechecked every indexed shape on every update and so happened to
+ * cover such shapes; the structural expansion trades that for O(affected) updates.
+ *
  * @internal
  */
 declare class SpatialIndexManager {
@@ -8501,11 +8918,13 @@ declare class SpatialIndexManager {
     private rbush;
     private spatialIndexComputed;
     private lastPageId;
+    private _boundsEpoch;
     constructor(editor: Editor);
+    private rebuildAndBumpEpoch;
     private createSpatialIndexComputed;
     private buildFromScratch;
     private processIncrementalUpdate;
-    private areBoundsEqual;
+    private areBoundsEqualToSpatialElement;
     /**
      * Get shape IDs within the given bounds.
      * Optimized for viewport culling queries.
@@ -8626,7 +9045,10 @@ declare class ThemeManager {
     /** Get the id of the current theme. */
     getCurrentThemeId(): DrThemeId;
     getCurrentTheme(): DrTheme;
-    /** Set the current theme by id. The theme must have been previously registered. */
+    /**
+     * Set the current theme by id. The theme must have been previously registered; an
+     * unregistered id is ignored and the current theme is kept.
+     */
     setCurrentTheme(id: DrThemeId): void;
     /** Replace all theme definitions, or update them via a callback that receives a deep copy. */
     updateThemes(themes: DrThemes | ((themes: DrThemes) => DrThemes)): void;
@@ -8637,8 +9059,7 @@ declare class ThemeManager {
 }
 
 /** @internal */
-declare class TickManager {
-    editor: Editor;
+declare class TickManager extends EditorManager {
     constructor(editor: Editor);
     cancelRaf?: null | (() => void);
     isPaused: boolean;
@@ -8648,27 +9069,33 @@ declare class TickManager {
     dispose(): void;
 }
 
+/** @public */
+interface OverlayOptionsWithDisplayValues<Overlay extends DrOverlay, DisplayValues extends object> {
+    getDefaultDisplayValues(editor: Editor, overlay: Overlay, theme: DrTheme, colorMode: 'light' | 'dark'): DisplayValues;
+    getCustomDisplayValues(editor: Editor, overlay: Overlay, theme: DrTheme, colorMode: 'light' | 'dark'): Partial<DisplayValues>;
+}
 /**
- * Optional adapter that pipes PerformanceManager events into browser
- * `performance.mark()` / `performance.measure()` for DevTools integration.
+ * Get the resolved display values for an overlay, merging the base values with any overrides.
  *
- * Tree-shakeable — only included if imported.
+ * @public
+ */
+declare function getOverlayDisplayValues<Overlay extends DrOverlay, DisplayValues extends object>(util: {
+    editor: Editor;
+    options: OverlayOptionsWithDisplayValues<Overlay, DisplayValues>;
+}, overlay: Overlay, colorMode?: 'light' | 'dark'): DisplayValues;
+
+/**
+ * Combine every batchable shape indicator into a single page-space `Path2D` and
+ * emit one stroke call. Shapes whose indicator needs an evenodd clip (e.g.
+ * arrows with labels or complex arrowheads) can't be batched — they still
+ * stroke individually inside a save/restore with `ctx.clip` applied.
  *
- * @example
- * ```ts
- * const adapter = new PerformanceApiAdapter(editor.performance)
- * // ... later
- * adapter.dispose()
- * ```
+ * Shared by any overlay util that paints shape indicators (e.g. collaborator
+ * selections).
  *
  * @public
  */
-declare class PerformanceApiAdapter {
-    private cleanups;
-    constructor(perfManager: PerformanceManager);
-    /** Remove all listeners and stop piping events. @public */
-    dispose(): void;
-}
+declare function strokeShapeIndicators(editor: Editor, ctx: CanvasRenderingContext2D, shapeIds: DrShapeId[]): void;
 
 /** @public */
 type DrBaseBoxShape = ExtractShapeByProps<{
@@ -8684,7 +9111,7 @@ declare abstract class BaseBoxShapeUtil<Shape extends DrBaseBoxShape> extends Sh
 }
 
 /**
- * A base class for frame-like shapes — containers that clip their children,
+ * A base class for frame-like shapes — containers that clip their children except arrows,
  * require full-brush selection, block erasure from inside, and support
  * drag-and-drop reparenting.
  *
@@ -8696,6 +9123,7 @@ declare abstract class BaseBoxShapeUtil<Shape extends DrBaseBoxShape> extends Sh
  * - `canReceiveNewChildrenOfType()` returns `true` unless the container is locked
  * - `canRemoveChildrenOfType()` returns `true` unless the container is locked
  * - `getClipPath()` returns the shape geometry's vertices
+ * - `shouldClipChild()` clips all children except arrows
  * - `onDragShapesIn()` reparents shapes into the frame (with index restoration)
  * - `onDragShapesOut()` reparents shapes back to the page
  *
@@ -8731,70 +9159,11 @@ declare abstract class BaseFrameLikeShapeUtil<Shape extends DrBaseBoxShape> exte
     canReceiveNewChildrenOfType(shape: Shape, _type: DrShape['type']): boolean;
     canRemoveChildrenOfType(shape: Shape, _type: DrShape['type']): boolean;
     getClipPath(shape: Shape): Vec[] | undefined;
+    shouldClipChild(child: DrShape): boolean;
     onDragShapesIn(shape: Shape, draggingShapes: DrShape[], { initialParentIds, initialIndices }: DrDragShapesInInfo): void;
     onDragShapesOut(shape: Shape, draggingShapes: DrShape[], info: DrDragShapesOutInfo): void;
 }
 
-/** @public */
-interface OverlayOptionsWithDisplayValues<Overlay extends DrOverlay, DisplayValues extends object> {
-    getDefaultDisplayValues(editor: Editor, overlay: Overlay, theme: DrTheme, colorMode: 'light' | 'dark'): DisplayValues;
-    getCustomDisplayValues(editor: Editor, overlay: Overlay, theme: DrTheme, colorMode: 'light' | 'dark'): Partial<DisplayValues>;
-}
-/**
- * Get the resolved display values for an overlay, merging the base values with any overrides.
- *
- * @public
- */
-declare function getOverlayDisplayValues<Overlay extends DrOverlay, DisplayValues extends object>(util: {
-    editor: Editor;
-    options: OverlayOptionsWithDisplayValues<Overlay, DisplayValues>;
-}, overlay: Overlay, colorMode?: 'light' | 'dark'): DisplayValues;
-
-/** @public */
-interface DrShapeIndicatorOverlay extends DrOverlay {
-    props: {
-        idsToDisplay: DrShapeId[];
-        hintingShapeIds: DrShapeId[];
-    };
-}
-/**
- * Combine every batchable shape indicator into a single page-space `Path2D` and
- * emit one stroke call. Shapes whose indicator needs an evenodd clip (e.g.
- * arrows with labels or complex arrowheads) can't be batched — they still
- * stroke individually inside a save/restore with `ctx.clip` applied.
- *
- * Shared by {@link ShapeIndicatorOverlayUtil} and any overlay util that paints
- * shape indicators (e.g. collaborator selections).
- *
- * @public
- */
-declare function strokeShapeIndicators(editor: Editor, ctx: CanvasRenderingContext2D, shapeIds: DrShapeId[]): void;
-/**
- * Overlay util for shape indicators — the selection / hover / hint outlines drawn
- * under the selection foreground. Paints local indicators in the theme's
- * selection color.
- *
- * Remote collaborator selection indicators are drawn by a separate overlay util
- * (e.g. `CollaboratorShapeIndicatorOverlayUtil` from `tldraw`) that runs at a
- * lower z-index so peer selections appear under the local indicators.
- *
- * Non-interactive: contributes no hit-test geometry.
- *
- * @public
- */
-declare class ShapeIndicatorOverlayUtil extends OverlayUtil<DrShapeIndicatorOverlay> {
-    static type: string;
-    options: {
-        zIndex: number;
-        lineWidth: number;
-        hintedLineWidth: number;
-    };
-    private _instanceFlags$;
-    isActive(): boolean;
-    getOverlays(): DrShapeIndicatorOverlay[];
-    render(ctx: CanvasRenderingContext2D, overlays: DrShapeIndicatorOverlay[]): void;
-}
-
 /** @public */
 type PerfectDashTerminal = 'skip' | 'outset' | 'none';
 /** @public */
@@ -8876,6 +9245,38 @@ declare function getSvgAsImage(svgString: string, options: {
     pixelRatio?: number;
 }): Promise<Blob | null>;
 
+/**
+ * A global registry of currently mounted editor instances. Use it to discover live editors from
+ * outside the React tree, for example from sidebar chrome, keyboard shortcuts, or multi-editor
+ * layouts.
+ *
+ * @example
+ * ```ts
+ * tleditors.getMounted() // readonly Editor[]
+ *
+ * const editors = useValue('mounted editors', () => tleditors.getMounted(), [])
+ * ```
+ *
+ * @public
+ */
+declare const tleditors: {
+    /**
+     * A reactive list of currently mounted editor instances.
+     *
+     * An editor is added when it emits the `mount` event and removed when it emits `unmount`
+     * (including when the editor is disposed while still mounted).
+     *
+     * @public
+     */
+    mounted: Signal<readonly Editor[]>;
+    /**
+     * Get the currently mounted editor instances.
+     *
+     * @public
+     */
+    getMounted(): readonly Editor[];
+};
+
 /**
  * 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,
@@ -8892,6 +9293,7 @@ declare const tlenv: {
     isWebview: boolean;
     isDarwin: boolean;
     hasCanvasSupport: boolean;
+    isTouchDevice: boolean;
 };
 /**
  * An atom that contains information about the current device and environment.
@@ -9056,6 +9458,9 @@ declare const tlmenus: {
  */
 declare const tltime: Timers;
 
+/** @public */
+declare function useColorMode(): 'light' | 'dark';
+
 /** @public */
 interface ContainerProviderProps {
     container: HTMLElement;
@@ -9072,10 +9477,12 @@ declare function useContainer(): HTMLElement;
 declare function useContainerIfExists(): HTMLElement | null;
 
 /** @public */
-declare function useColorMode(): 'light' | 'dark';
+declare function getCursor(cursor: DrCursorType, rotation?: number, color?: string): string;
 
 /** @public */
-declare function getCursor(cursor: DrCursorType, rotation?: number, color?: string): string;
+declare function useDrStore(opts: DrStoreOptions): _ibodr_schema.DrStore;
+/** @public */
+declare function useDrSchemaFromUtils(opts: DrStoreSchemaOptions): _ibodr_store.StoreSchema<_ibodr_schema.DrRecord, _ibodr_schema.DrStoreProps>;
 
 /** @public */
 declare const EditorContext: React__default.Context<Editor | null>;
@@ -9091,36 +9498,6 @@ interface EditorProviderProps {
 /** @public @react */
 declare function EditorProvider({ editor, children }: EditorProviderProps): react_jsx_runtime.JSX.Element;
 
-/** @public */
-interface DrCollaboratorCursorLayout {
-    /** Offset of the name/chat badge from the cursor anchor (px, before zoom scale). */
-    badgeOffset: {
-        x: number;
-        y: number;
-    };
-    /** Offset of the pointer icon from the cursor anchor (px, before zoom scale). */
-    iconOffset: {
-        x: number;
-        y: number;
-    };
-}
-
-/** @public */
-interface DrCollaboratorCursorProps {
-    /** Screen position relative to the editor container. */
-    point: {
-        x: number;
-        y: number;
-    };
-    color: string;
-    name?: string | null;
-    chatMessage?: string;
-    /** Scale relative to camera zoom (1 = base size at 100% zoom). */
-    scale: number;
-    /** Layout offsets for the pointer icon and name badge. */
-    layout?: DrCollaboratorCursorLayout;
-}
-
 /** @public */
 interface DrEditorComponents {
     Background?: ComponentType<DrBackgroundProps> | null;
@@ -9133,9 +9510,8 @@ interface DrEditorComponents {
     InFrontOfTheCanvas?: ComponentType | null;
     LoadingScreen?: ComponentType | null;
     OnTheCanvas?: ComponentType | null;
-    SelectionBackground?: ComponentType<DrSelectionBackgroundProps> | null;
     ShapeWrapper?: ComponentType<DrShapeWrapperProps & RefAttributes<HTMLDivElement>> | null;
-    Spinner?: ComponentType<React.SVGProps<SVGSVGElement>> | null;
+    Spinner?: ComponentType<DrSpinnerProps> | null;
     SvgDefs?: ComponentType | null;
     ErrorFallback?: DrErrorFallbackComponent;
     ShapeErrorFallback?: DrShapeErrorFallbackComponent;
@@ -9219,9 +9595,6 @@ declare function useLocalStore(options: {
     snapshot?: DrEditorSnapshot | DrStoreSnapshot;
 } & DrStoreOptions): DrStoreWithStatus;
 
-/** @public */
-declare function usePassThroughMouseOverEvents(ref: RefObject<HTMLElement | null>): void;
-
 /** @public */
 declare function usePassThroughWheelEvents(ref: RefObject<HTMLElement | null>): void;
 
@@ -9234,13 +9607,13 @@ declare function usePassThroughWheelEvents(ref: RefObject<HTMLElement | null>):
  * @returns The list of peer UserIDs
  * @public
  */
-declare function usePeerIds(): string[];
+declare function usePeerIds(): _ibodr_schema.DrUserId[];
 
 /**
  * @returns The latest presence of the user matching userId
  * @public
  */
-declare function usePresence(userId: string): DrInstancePresence | null;
+declare function usePresence(userId: DrUserId): DrInstancePresence | null;
 
 /**
  * A `useState` that uses a `ref` to keep the state in sync with the last value assigned to it.
@@ -9317,59 +9690,284 @@ declare function useSharedSafeId(id: string): SafeId;
 /** @public */
 declare function sanitizeId(id: string): string;
 
-/** @public */
-declare function useDrStore(opts: DrStoreOptions): _ibodr_schema.DrStore;
-/** @public */
-declare function useDrSchemaFromUtils(opts: DrStoreSchemaOptions): _ibodr_store.StoreSchema<_ibodr_schema.DrRecord, _ibodr_schema.DrStoreProps>;
-
-/** @public */
+/**
+ * Position an element by writing its `transform` directly, outside React's render output — the
+ * cheap path for elements that move at pointer/presence frequency.
+ * @public
+ */
 declare function useTransform(ref: React.RefObject<HTMLElement | SVGElement | null>, x?: number, y?: number, scale?: number, rotate?: number, additionalOffset?: VecLike): void;
 
-/*!
- * BSD License: https://github.com/outline/rich-markdown-editor/blob/main/LICENSE
- * Copyright (c) 2020 General Outline, Inc (https://www.getoutline.com/) and individual contributors.
+/**
+ * Whether a collaborator's cursor (page coords) is inside the viewport, with a small margin for the
+ * cursor glyph so it isn't culled the instant its hotspot crosses the edge.
  *
- * Returns the height of the viewport.
- * This is mainly to account for virtual keyboards on mobile devices.
+ * Single source of truth for the cursor/hint split: the DOM cursor layer renders a collaborator
+ * when this is true, and `CollaboratorHintOverlayUtil` draws the viewport-edge hint when it's
+ * false. Sharing the predicate keeps those two exhaustive and mutually exclusive — a margin change
+ * can't open a dead zone (neither renders) or a double-render (both).
  *
- * N.B. On iOS, you have to take into account the offsetTop as well so that you get an accurate position
- * while using the virtual keyboard.
+ * @public
  */
-/** @public */
-declare function useViewportHeight(): number;
+declare function isCursorInViewport(cursor: VecLike, viewport: {
+    minX: number;
+    minY: number;
+    maxX: number;
+    maxY: number;
+}, zoom: number): boolean;
 
-/** @public */
-declare const EASINGS: {
-    readonly linear: (t: number) => number;
-    readonly easeInQuad: (t: number) => number;
-    readonly easeOutQuad: (t: number) => number;
-    readonly easeInOutQuad: (t: number) => number;
-    readonly easeInCubic: (t: number) => number;
-    readonly easeOutCubic: (t: number) => number;
-    readonly easeInOutCubic: (t: number) => number;
-    readonly easeInQuart: (t: number) => number;
-    readonly easeOutQuart: (t: number) => number;
-    readonly easeInOutQuart: (t: number) => number;
-    readonly easeInQuint: (t: number) => number;
-    readonly easeOutQuint: (t: number) => number;
-    readonly easeInOutQuint: (t: number) => number;
-    readonly easeInSine: (t: number) => number;
-    readonly easeOutSine: (t: number) => number;
-    readonly easeInOutSine: (t: number) => number;
-    readonly easeInExpo: (t: number) => number;
-    readonly easeOutExpo: (t: number) => number;
-    readonly easeInOutExpo: (t: number) => number;
-};
-
-/** @public */
-declare class Arc2d extends Geometry2d {
-    private _center;
-    private _radius;
-    private _start;
-    private _end;
-    private _largeArcFlag;
-    private _sweepFlag;
-    private _measure;
+/**
+ * Props for the {@link tldraw#Draw} and {@link DrawEditor} components, when passing in a
+ * `DrStore` directly. If you would like tldraw to create a store for you, use
+ * {@link DrawEditorWithoutStoreProps}.
+ *
+ * @public
+ */
+interface DrawEditorWithStoreProps {
+    /**
+     * The store to use in the editor.
+     */
+    store: DrStore | DrStoreWithStatus;
+}
+/**
+ * Props for the {@link tldraw#Draw} and {@link DrawEditor} components, when not passing in a
+ * `DrStore` directly. If you would like to pass in a store directly, use
+ * {@link DrawEditorWithStoreProps}.
+ *
+ * @public
+ */
+interface DrawEditorWithoutStoreProps extends DrStoreBaseOptions {
+    store?: undefined;
+    /**
+     * Additional migrations to use in the store
+     */
+    migrations?: readonly MigrationSequence[];
+    /**
+     * A starting snapshot of data to pre-populate the store. Do not supply both this and
+     * `initialData`.
+     */
+    snapshot?: DrEditorSnapshot | DrStoreSnapshot;
+    /**
+     * If you would like to persist the store to the browser's local IndexedDB storage and sync it
+     * across tabs, provide a key here. Each key represents a single tldraw document.
+     */
+    persistenceKey?: string;
+    sessionId?: string;
+}
+/** @public */
+type DrawEditorStoreProps = DrawEditorWithStoreProps | DrawEditorWithoutStoreProps;
+/** @public */
+type DrawEditorProps = DrawEditorBaseProps & DrawEditorStoreProps;
+/**
+ * Base props for the {@link tldraw#Draw} and {@link DrawEditor} components.
+ *
+ * @public
+ */
+interface DrawEditorBaseProps {
+    /**
+     * The component's children.
+     */
+    children?: ReactNode;
+    /**
+     * An array of shape utils to use in the editor.
+     */
+    shapeUtils?: readonly DrAnyShapeUtilConstructor[];
+    /**
+     * An array of binding utils to use in the editor.
+     */
+    bindingUtils?: readonly DrAnyBindingUtilConstructor[];
+    /**
+     * An array of asset utils to use in the editor.
+     */
+    assetUtils?: readonly DrAnyAssetUtilConstructor[];
+    /**
+     * An array of overlay utils to use in the editor for canvas overlay UI elements.
+     */
+    overlayUtils?: readonly DrAnyOverlayUtilConstructor[];
+    /**
+     * An array of tools to add to the editor's state chart.
+     */
+    tools?: readonly DrStateNodeConstructor[];
+    /**
+     * Whether to automatically focus the editor when it mounts.
+     */
+    autoFocus?: boolean;
+    /**
+     * Overrides for the editor's components, such as handles, collaborator cursors, etc.
+     */
+    components?: DrEditorComponents;
+    /**
+     * Called when the editor has mounted.
+     */
+    onMount?: DrOnMountHandler;
+    /**
+     * The editor's initial state (usually the id of the first active tool).
+     */
+    initialState?: string;
+    /**
+     * A classname to pass to the editor's container.
+     */
+    className?: string;
+    /**
+     * The user interacting with the editor.
+     */
+    user?: DrCurrentUser;
+    /**
+     * The editor's color scheme. Defaults to `'light'`.
+     *
+     * - `'light'` - Always use light mode.
+     * - `'dark'` - Always use dark mode.
+     * - `'system'` - Follow the OS color scheme preference.
+     * - `'inherit'` - Follow the nearest ancestor's `data-color-mode` attribute
+     *   (for embedding inside a host app that manages its own theme).
+     */
+    colorScheme?: 'light' | 'dark' | 'system' | 'inherit';
+    /**
+     * Named themes for the editor.
+     */
+    themes?: Partial<DrThemes>;
+    /**
+     * The id of the initially active theme. Defaults to `'default'`.
+     */
+    initialTheme?: DrThemeId;
+    /**
+     * Camera options for the editor.
+     *
+     * @deprecated Use `options.cameraOptions` instead. This will be removed in a future release.
+     */
+    cameraOptions?: Partial<DrCameraOptions>;
+    /**
+     * Options for the editor.
+     */
+    options?: Partial<DrawOptions>;
+    /**
+     * Text options for the editor.
+     *
+     * @deprecated Use `options.text` instead. This prop will be removed in a future release.
+     */
+    textOptions?: DrTextOptions;
+    /**
+     * 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?: true | DrDeepLinkOptions;
+    /**
+     * 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 @ibodr/editor#Editor.getShapeAtPoint} and {@link @ibodr/editor#Editor.getShapesAtPoint}. But otherwise they will
+     * remain in the store and participate in all other operations.
+     *
+     * @example
+     * ```ts
+     * getShapeVisibility={(shape, editor) => shape.meta.hidden ? 'hidden' : 'inherit'}
+     * ```
+     *
+     * - `'inherit' | undefined` - (default) The shape will be visible unless its parent is hidden.
+     * - `'hidden'` - The shape will be hidden.
+     * - `'visible'` - The shape will be visible.
+     *
+     * @param shape - The shape to check.
+     * @param editor - The editor instance.
+     */
+    getShapeVisibility?(shape: DrShape, editor: Editor): 'visible' | 'hidden' | 'inherit' | null | undefined;
+    /**
+     * The URLs for the fonts to use in the editor.
+     */
+    assetUrls?: {
+        fonts?: {
+            [key: string]: string | undefined;
+        };
+    };
+}
+/**
+ * Called when the editor has mounted.
+ * @example
+ * ```ts
+ * <Draw onMount={(editor) => editor.selectAll()} />
+ * ```
+ * @param editor - The editor instance.
+ *
+ * @public
+ */
+type DrOnMountHandler = (editor: Editor) => (() => void | undefined) | undefined | void;
+declare global {
+    interface Window {
+        drawReady: boolean;
+    }
+}
+/**
+ * The editor component without any of the default shapes, tools, or UI. It renders the canvas, or
+ * your own children in its place, with the shape utils, binding utils, tools, and components you
+ * pass in; the `Draw` component in the `tldraw` package wraps it with those defaults.
+ *
+ * @public @react
+ */
+declare const DrawEditor: React__default.NamedExoticComponent<DrawEditorProps>;
+/** @public */
+interface LoadingScreenProps {
+    children: ReactNode;
+}
+/** @public @react */
+declare function LoadingScreen({ children }: LoadingScreenProps): react_jsx_runtime.JSX.Element;
+/** @public @react */
+declare function ErrorScreen({ children }: LoadingScreenProps): react_jsx_runtime.JSX.Element;
+/** @internal */
+declare function useOnMount(onMount?: DrOnMountHandler): void;
+
+/*!
+ * BSD License: https://github.com/outline/rich-markdown-editor/blob/main/LICENSE
+ * Copyright (c) 2020 General Outline, Inc (https://www.getoutline.com/) and individual contributors.
+ *
+ * Returns the height of the viewport.
+ * This is mainly to account for virtual keyboards on mobile devices.
+ *
+ * N.B. On iOS, you have to take into account the offsetTop as well so that you get an accurate position
+ * while using the virtual keyboard.
+ */
+/**
+ * The height of the visible viewport, including the visual viewport's own offset.
+ *
+ * @deprecated Read `window.visualViewport` directly: this flattens the visible rectangle to a
+ * single scalar, and keeping UI clear of the software keyboard usually needs the other edges too.
+ * Unused since v3.14; will be removed in a future release.
+ *
+ * @public
+ */
+declare function useViewportHeight(): number;
+
+/** @public */
+declare const EASINGS: {
+    readonly linear: (t: number) => number;
+    readonly easeInQuad: (t: number) => number;
+    readonly easeOutQuad: (t: number) => number;
+    readonly easeInOutQuad: (t: number) => number;
+    readonly easeInCubic: (t: number) => number;
+    readonly easeOutCubic: (t: number) => number;
+    readonly easeInOutCubic: (t: number) => number;
+    readonly easeInQuart: (t: number) => number;
+    readonly easeOutQuart: (t: number) => number;
+    readonly easeInOutQuart: (t: number) => number;
+    readonly easeInQuint: (t: number) => number;
+    readonly easeOutQuint: (t: number) => number;
+    readonly easeInOutQuint: (t: number) => number;
+    readonly easeInSine: (t: number) => number;
+    readonly easeOutSine: (t: number) => number;
+    readonly easeInOutSine: (t: number) => number;
+    readonly easeInExpo: (t: number) => number;
+    readonly easeOutExpo: (t: number) => number;
+    readonly easeInOutExpo: (t: number) => number;
+};
+
+/** @public */
+declare class Arc2d extends Geometry2d {
+    private _center;
+    private _radius;
+    private _start;
+    private _end;
+    private _largeArcFlag;
+    private _sweepFlag;
+    private _measure;
     private _angleStart;
     private _angleEnd;
     constructor(config: Omit<Geometry2dOptions, 'isFilled' | 'isClosed'> & {
@@ -9531,7 +10129,7 @@ declare class Group2d extends Geometry2d {
     intersectPolyline(polyline: VecLike[], filters?: Geometry2dFilters): VecLike[];
     interpolateAlongEdge(t: number, filters?: Geometry2dFilters): Vec;
     uninterpolateAlongEdge(point: VecLike, filters?: Geometry2dFilters): number;
-    transform(transform: Mat): Geometry2d;
+    transform(transform: MatModel, opts?: TransformedGeometry2dOptions): Geometry2d;
     getArea(): number;
     toSimpleSvgPath(): string;
     getLength(filters?: Geometry2dFilters): number;
@@ -9869,7 +10467,7 @@ declare function toFixed(v: number): number;
  * Check if a float is safe to use. ie: Not too big or small.
  * @public
  */
-declare const isSafeFloat: (n: number) => boolean;
+declare function isSafeFloat(n: number): boolean;
 /**
  * Get the angle of a point on an arc.
  * @param fromAngle - The angle from center to arc's start point (A) on the circle
@@ -9920,204 +10518,6 @@ declare function centerOfCircleFromThreePoints(a: VecLike, b: VecLike, c: VecLik
 /** @public */
 declare function getPointsOnArc(startPoint: VecLike, endPoint: VecLike, center: VecLike | null, radius: number, numPoints: number): Vec[];
 
-/**
- * Props for the {@link tldraw#Draw} and {@link DrawEditor} components, when passing in a
- * `DrStore` directly. If you would like tldraw to create a store for you, use
- * {@link DrawEditorWithoutStoreProps}.
- *
- * @public
- */
-interface DrawEditorWithStoreProps {
-    /**
-     * The store to use in the editor.
-     */
-    store: DrStore | DrStoreWithStatus;
-}
-/**
- * Props for the {@link tldraw#Draw} and {@link DrawEditor} components, when not passing in a
- * `DrStore` directly. If you would like to pass in a store directly, use
- * {@link DrawEditorWithStoreProps}.
- *
- * @public
- */
-interface DrawEditorWithoutStoreProps extends DrStoreBaseOptions {
-    store?: undefined;
-    /**
-     * Additional migrations to use in the store
-     */
-    migrations?: readonly MigrationSequence[];
-    /**
-     * A starting snapshot of data to pre-populate the store. Do not supply both this and
-     * `initialData`.
-     */
-    snapshot?: DrEditorSnapshot | DrStoreSnapshot;
-    /**
-     * If you would like to persist the store to the browser's local IndexedDB storage and sync it
-     * across tabs, provide a key here. Each key represents a single tldraw document.
-     */
-    persistenceKey?: string;
-    sessionId?: string;
-}
-/** @public */
-type DrawEditorStoreProps = DrawEditorWithStoreProps | DrawEditorWithoutStoreProps;
-/**
- * Props for the {@link tldraw#Draw} and {@link DrawEditor} components.
- *
- * @public
- **/
-type DrawEditorProps = DrawEditorBaseProps & DrawEditorStoreProps;
-/**
- * Base props for the {@link tldraw#Draw} and {@link DrawEditor} components.
- *
- * @public
- */
-interface DrawEditorBaseProps {
-    /**
-     * The component's children.
-     */
-    children?: ReactNode;
-    /**
-     * An array of shape utils to use in the editor.
-     */
-    shapeUtils?: readonly DrAnyShapeUtilConstructor[];
-    /**
-     * An array of binding utils to use in the editor.
-     */
-    bindingUtils?: readonly DrAnyBindingUtilConstructor[];
-    /**
-     * An array of asset utils to use in the editor.
-     */
-    assetUtils?: readonly DrAnyAssetUtilConstructor[];
-    /**
-     * An array of overlay utils to use in the editor for canvas overlay UI elements.
-     */
-    overlayUtils?: readonly DrAnyOverlayUtilConstructor[];
-    /**
-     * An array of tools to add to the editor's state chart.
-     */
-    tools?: readonly DrStateNodeConstructor[];
-    /**
-     * Whether to automatically focus the editor when it mounts.
-     */
-    autoFocus?: boolean;
-    /**
-     * Overrides for the editor's components, such as handles, collaborator cursors, etc.
-     */
-    components?: DrEditorComponents;
-    /**
-     * Called when the editor has mounted.
-     */
-    onMount?: DrOnMountHandler;
-    /**
-     * The editor's initial state (usually the id of the first active tool).
-     */
-    initialState?: string;
-    /**
-     * A classname to pass to the editor's container.
-     */
-    className?: string;
-    /**
-     * The user interacting with the editor.
-     */
-    user?: DrCurrentUser;
-    /**
-     * The editor's color scheme. Defaults to `'light'`.
-     *
-     * - `'light'` - Always use light mode.
-     * - `'dark'` - Always use dark mode.
-     * - `'system'` - Follow the OS color scheme preference.
-     * - `'inherit'` - Follow the nearest ancestor's `data-color-mode` attribute
-     *   (for embedding inside a host app that manages its own theme).
-     */
-    colorScheme?: 'light' | 'dark' | 'system' | 'inherit';
-    /**
-     * Named themes for the editor.
-     */
-    themes?: Partial<DrThemes>;
-    /**
-     * The id of the initially active theme. Defaults to `'default'`.
-     */
-    initialTheme?: DrThemeId;
-    /**
-     * Camera options for the editor.
-     *
-     * @deprecated Use `options.cameraOptions` instead. This will be removed in a future release.
-     */
-    cameraOptions?: Partial<DrCameraOptions>;
-    /**
-     * Options for the editor.
-     */
-    options?: Partial<DrawOptions>;
-    /**
-     * Text options for the editor.
-     *
-     * @deprecated Use `options.text` instead. This prop will be removed in a future release.
-     */
-    textOptions?: DrTextOptions;
-    /**
-     * 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?: true | DrDeepLinkOptions;
-    /**
-     * 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 @ibodr/editor#Editor.getShapeAtPoint} and {@link @ibodr/editor#Editor.getShapesAtPoint}. But otherwise they will
-     * remain in the store and participate in all other operations.
-     *
-     * @example
-     * ```ts
-     * getShapeVisibility={(shape, editor) => shape.meta.hidden ? 'hidden' : 'inherit'}
-     * ```
-     *
-     * - `'inherit' | undefined` - (default) The shape will be visible unless its parent is hidden.
-     * - `'hidden'` - The shape will be hidden.
-     * - `'visible'` - The shape will be visible.
-     *
-     * @param shape - The shape to check.
-     * @param editor - The editor instance.
-     */
-    getShapeVisibility?(shape: DrShape, editor: Editor): 'visible' | 'hidden' | 'inherit' | null | undefined;
-    /**
-     * The URLs for the fonts to use in the editor.
-     */
-    assetUrls?: {
-        fonts?: {
-            [key: string]: string | undefined;
-        };
-    };
-}
-/**
- * Called when the editor has mounted.
- * @example
- * ```ts
- * <Draw onMount={(editor) => editor.selectAll()} />
- * ```
- * @param editor - The editor instance.
- *
- * @public
- */
-type DrOnMountHandler = (editor: Editor) => (() => void | undefined) | undefined | void;
-declare global {
-    interface Window {
-        drawReady: boolean;
-    }
-}
-/** @public @react */
-declare const DrawEditor: React__default.NamedExoticComponent<DrawEditorProps>;
-/** @public */
-interface LoadingScreenProps {
-    children: ReactNode;
-}
-/** @public @react */
-declare function LoadingScreen({ children }: LoadingScreenProps): react_jsx_runtime.JSX.Element;
-/** @public @react */
-declare function ErrorScreen({ children }: LoadingScreenProps): react_jsx_runtime.JSX.Element;
-/** @internal */
-declare function useOnMount(onMount?: DrOnMountHandler): void;
-
 /**
  * Converts a data URL to a file.
  * @param url - The data URL to convert.
@@ -10152,8 +10552,6 @@ declare const debugFlags: {
     readonly showFps: DebugFlag<boolean>;
     readonly measurePerformance: DebugFlag<boolean>;
     readonly throwToBlob: DebugFlag<boolean>;
-    readonly reconnectOnPing: DebugFlag<boolean>;
-    readonly debugCursors: DebugFlag<boolean>;
     readonly forceSrgb: DebugFlag<boolean>;
     readonly debugGeometry: DebugFlag<boolean>;
     readonly hideShapes: DebugFlag<boolean>;
@@ -10211,7 +10609,25 @@ declare function releasePointerCapture(element: Element, event: React.PointerEve
  *
  * @public
  */
-declare const stopEventPropagation: (e: any) => any;
+declare function stopEventPropagation(e: any): any;
+/**
+ * Move an element into a new parent, preserving its state where the platform allows it.
+ *
+ * Uses `Node.moveBefore` (Chromium 133+, Firefox 144+) when both the element and parent are
+ * connected to the same document — this moves the element without resetting its state, so
+ * iframes don't reload and media keeps playing. Otherwise (older browsers, disconnected nodes,
+ * or a cross-document move) it falls back to `appendChild`, which moves the element but resets
+ * its state like an iframe reload.
+ *
+ * This is the primitive tldraw uses to adopt `ShapeUtil.getAppOwnedElement` elements, exposed so
+ * apps can perform symmetric state-preserving moves from `ShapeUtil.onReleaseAppOwnedElement` —
+ * for example moving an element to an off-canvas parking lot between editor sessions.
+ *
+ * @param parent - The element to move `element` into, as its last child.
+ * @param element - The element to move.
+ * @public
+ */
+declare function moveElementInto(parent: HTMLElement, element: HTMLElement): void;
 /** @internal */
 declare function elementShouldCaptureKeys(el: Element | null, includeButtonsAndMenus?: boolean): boolean;
 /**
@@ -10446,7 +10862,14 @@ declare class LocalIndexedDb {
         sessionId?: string | null;
         sessionStateSnapshot?: DrSessionStateSnapshot | null;
     }): Promise<void>;
-    pruneSessions(): Promise<void>;
+    /**
+     * Drop all but the most recently updated session state rows. The row for `keepSessionId` is never
+     * deleted: it may be an old row that this tab restored its state from and has not rewritten yet,
+     * and deleting it would make a later reload fall back to another tab's session state.
+     */
+    pruneSessions({ keepSessionId }?: {
+        keepSessionId?: string;
+    }): Promise<void>;
     getAsset(assetId: string): Promise<File | undefined>;
     storeAsset(assetId: string, blob: File): Promise<void>;
     removeAssets(assetId: string[]): Promise<void>;
@@ -10458,4 +10881,4 @@ declare function uniq<T>(array: {
     readonly [n: number]: T;
 } | null | undefined): T[];
 
-export { Arc2d, AssetUtil, BaseBoxShapeTool, BaseBoxShapeUtil, BaseFrameLikeShapeUtil, type BatchMeasurementRequest, type BindingOnChangeOptions, type BindingOnCreateOptions, type BindingOnDeleteOptions, type BindingOnShapeChangeOptions, type BindingOnShapeDeleteOptions, type BindingOnShapeIsolateOptions, BindingUtil, type BoundsSnapGeometry, type BoundsSnapPoint, BoundsSnaps, Box, type BoxLike, type CanvasMaxSize, Circle2d, ClickManager, CollaboratorsManager, ContainerProvider, type ContainerProviderProps, CubicBezier2d, CubicSpline2d, DEFAULT_ANIMATION_OPTIONS, DEFAULT_CAMERA_OPTIONS, DEFAULT_THEME, type DebugFlag, type DebugFlagDef, type DebugFlagDefaults, DefaultBackground, DefaultCanvas, DefaultErrorFallback, DefaultGrid, DefaultSelectionBackground, DefaultShapeWrapper, DefaultSpinner, DefaultSvgDefs, type DrAdjacentDirection, type DrAnyAssetUtilConstructor, type DrAnyBindingUtilConstructor, type DrAnyOverlayUtilConstructor, type DrAnyShapeUtilConstructor, type DrAssetUtilConstructor, type DrBackgroundProps, type DrBaseBoxShape, type DrBaseEventInfo, type DrBaseExternalContent, type DrBindingUtilConstructor, type DrCLickEventName, type DrCameraConstraints, type DrCameraEndPerfEvent, type DrCameraMoveOptions, type DrCameraOptions, type DrCameraStartPerfEvent, type DrCancelEvent, type DrCancelEventInfo, type DrCanvasComponentProps, type DrClickEvent, type DrClickEventInfo, type DrClickState, type DrClipboardPasteRawInfo, type DrClipboardWriteInfo, type DrCollaboratorCursorLayout, type DrCollaboratorCursorProps, type DrCompleteEvent, type DrCompleteEventInfo, type DrContent, type DrCropInfo, type DrCurrentUser, type DrDeepLink, type DrDeepLinkOptions, type DrDragShapesInInfo, type DrDragShapesOutInfo, type DrDragShapesOverInfo, type DrDrawExternalContent, type DrDrawExternalContentSource, type DrDropShapesOverInfo, type DrEditStartInfo, type DrEditorComponents, type DrEditorOptions, type DrEditorRunOptions, type DrEditorSnapshot, type DrEmbedExternalContent, type DrEnterEventHandler, type DrErrorBoundaryProps, type DrErrorExternalContentSource, type DrErrorFallbackComponent, type DrEventHandlers, type DrEventInfo, type DrEventMap, type DrEventMapHandler, type DrEventName, type DrExcalidrawExternalContent, type DrExcalidrawExternalContentSource, type DrExitEventHandler, type DrExportType, type DrExternalAsset, type DrExternalContent, type DrExternalContentSource, type DrFileExternalAsset, type DrFileReplaceExternalContent, type DrFilesExternalContent, type DrFramePerfEvent, type DrGeometryOpts, type DrGetShapeAtPointOptions, type DrGridProps, type DrHandleDragInfo, type DrHistoryBatchOptions, type DrHistoryDiff, type DrHistoryEntry, type DrHistoryMark, type DrImageExportOptions, type DrIndicatorPath, type DrInteractionEndPerfEvent, type DrInteractionStartPerfEvent, type DrInterruptEvent, type DrInterruptEventInfo, type DrKeyboardEvent, type DrKeyboardEventInfo, type DrKeyboardEventName, type DrLoadSessionStateSnapshotOptions, type DrLoadSnapshotOptions, type DrMeasureTextOpts, type DrMeasureTextSpanOpts, type DrMeasuredTextSize, type DrMiroExternalContent, type DrMiroExternalContentSource, type DrOnMountHandler, type DrOverlay, type DrOverlayEntry, type DrOverlayUtilConstructor, type DrPerfEventMap, type DrPerfFrameTimeStats, type DrPerfLongAnimationFrame, type DrPerfLongAnimationFrameScript, type DrPinchEvent, type DrPinchEventInfo, type DrPinchEventName, type DrPointerEvent, type DrPointerEventInfo, type DrPointerEventName, type DrPointerEventTarget, type DrRenderingShape, type DrResizeHandle, type DrResizeInfo, type DrResizeMode, type DrResizeShapeOptions, type DrRotationSnapshot, type DrSelectionBackgroundProps, type DrSelectionHandle, type DrSessionStateSnapshot, type DrShapeErrorFallbackComponent, type DrShapeIndicatorOverlay, type DrShapeOperationPerfEvent, type DrShapeUtilCanBeLaidOutOpts, type DrShapeUtilCanBindOpts, type DrShapeUtilCanvasSvgDef, type DrShapeUtilConstructor, type DrShapeWrapperProps, type DrStateNodeConstructor, type DrStoreBaseOptions, type DrStoreEventInfo, type DrStoreOptions, type DrStoreSchemaOptions, type DrStoreWithStatus, type DrSvgExportOptions, type DrSvgTextExternalContent, type DrTextExternalContent, type DrTextExternalContentSource, type DrTextOptions, type DrTickEvent, type DrTickEventInfo, type DrUndoRedoPerfEvent, type DrUpdatePointerOptions, type DrUrlExternalAsset, type DrUrlExternalContent, type DrUserPreferences, type DrWheelEvent, type DrWheelEventInfo, DrawEditor, type DrawEditorBaseProps, type DrawEditorProps, type DrawEditorStoreProps, type DrawEditorWithStoreProps, type DrawEditorWithoutStoreProps, type DrawOptions, EASINGS, EVENT_NAME_MAP, Edge2d, EdgeScrollManager, Editor, EditorAtom, EditorContext, EditorProvider, type EditorProviderProps, Ellipse2d, ErrorBoundary, ErrorScreen, FontManager, type GapsSnapIndicator, Geometry2d, Geometry2dFilters, type Geometry2dOptions, Group2d, GroupShapeUtil, HALF_PI, HTMLContainer, type HTMLContainerProps, type HandleSnapGeometry, HandleSnaps, HistoryManager, InputsManager, LoadingScreen, type LoadingScreenProps, LocalIndexedDb, Mat, type MatLike, type MatModel, MenuClickCapture, OptionalErrorBoundary, type OptionalKeys, OverlayManager, type OverlayOptionsWithDisplayValues, OverlayUtil, PI, PI2, type PerfectDashTerminal, PerformanceApiAdapter, PerformanceManager, Point2d, type PointsSnapIndicator, Polygon2d, Polyline2d, ROTATE_CORNER_TO_SELECTION_CORNER, ReadonlySharedStyleMap, Rectangle2d, type RequiredKeys, type ResizeBoxOptions, type RichTextFontVisitor, type RichTextFontVisitorState, type RotateCorner, SIDES, SIN, SVGContainer, type SVGContainerProps, type SafeId, type ScribbleItem, ScribbleManager, type ScribbleSessionOptions, type SelectionCorner, type SelectionEdge, type SelectionHandle, ShapeIndicatorOverlayUtil, ShapeUtil, type SharedStyle, SharedStyleMap, type SnapData, type SnapIndicator, SnapManager, SpatialIndexManager, Stadium2d, StateNode, type StoreName, type SvgExportContext, type SvgExportDef, TAB_ID, Table, TextManager, ThemeManager, TickManager, type TiptapEditor, type TiptapNode, TransformedGeometry2d, type TransformedGeometry2dOptions, USER_COLORS, type UiEvent, type UiEventType, UserPreferencesManager, Vec, type VecLike, activeElementShouldCaptureKeys, angleDistance, applyRotationToSnapshotShapes, approximately, areAnglesCompatible, average, canonicalizeRotation, centerOfCircleFromThreePoints, clamp, clampRadians, clampToBrowserMaxCanvasSize, clockwiseAngleDist, coreShapes, counterClockwiseAngleDist, createDebugValue, createDeepLinkString, createDrCurrentUser, createDrSchemaFromUtils, createDrStore, createSessionStateSnapshotSignal, dataUrlToFile, debugFlags, defaultDrawOptions, defaultUserPreferences, defaultUserStore, degreesToRadians, elementShouldCaptureKeys, extractSessionStateFromLegacySnapshot, featureFlags, getArcMeasure, getColorValue, getCursor, getDefaultCdnBaseUrl, getDroppedShapesToNewParents, getFontsFromRichText, getFreshUserPreferences, getGlobalDocument, getGlobalWindow, getIncrementedName, getOverlayDisplayValues, getOwnerDocument, getOwnerWindow, getPerfectDashProps, getPointInArcT, getPointOnCircle, getPointerInfo, getPointsOnArc, getPolygonVertices, getRotationSnapshot, getSnapshot, getSvgAsImage, getSvgPathFromPoints, getUserPreferences, getVerticesCountForArcLength, hardReset, hardResetEditor, inlineBase64AssetStore, intersectCircleCircle, intersectCirclePolygon, intersectCirclePolyline, intersectLineSegmentCircle, intersectLineSegmentLineSegment, intersectLineSegmentPolygon, intersectLineSegmentPolyline, intersectPolygonBounds, intersectPolygonPolygon, isAccelKey, isSafeFloat, kickoutOccludedShapes, linesIntersect, loadSessionStateSnapshotIntoStore, loadSnapshot, loopToHtmlElement, maybeSnapToGrid, normalizeWheel, openWindow, parseDeepLinkString, perimeterOfEllipse, pointInPolygon, polygonIntersectsPolyline, polygonsIntersect, precise, preventDefault, radiansToDegrees, rangeIntersection, refreshPage, releasePointerCapture, resizeBox, resizeScaled, resolveThemes, rotateSelectionHandle, runtime, sanitizeId, setPointerCapture, setRuntimeOverrides, setUserPreferences, shortAngleDist, snapAngle, stopEventPropagation, strokeShapeIndicators, suffixSafeId, tlenv, tlenvReactive, tlmenus, tltime, toDomPrecision, toFixed, toPrecision, uniq, useColorMode, useContainer, useContainerIfExists, useDelaySvgExport, useDrSchemaFromUtils, useDrStore, useDrawCurrentUser, useEditor, useEditorComponents, useEvent, useGlobalMenuIsOpen, useIsCropping, useIsEditing, useLocalStore, useMaybeEditor, useOnMount, usePassThroughMouseOverEvents, usePassThroughWheelEvents, usePeerIds, usePresence, useReactiveEvent, useRefState, useShallowArrayIdentity, useShallowObjectIdentity, useSharedSafeId, useSvgExportContext, useTransform, useUniqueSafeId, useViewportHeight, userTypeValidator };
+export { Arc2d, AssetUtil, BaseBoxShapeTool, BaseBoxShapeUtil, BaseFrameLikeShapeUtil, type BatchMeasurementRequest, type BindingOnChangeOptions, type BindingOnCreateOptions, type BindingOnDeleteOptions, type BindingOnShapeChangeOptions, type BindingOnShapeDeleteOptions, type BindingOnShapeIsolateOptions, BindingUtil, type BoundsSnapGeometry, type BoundsSnapPoint, BoundsSnaps, Box, type BoxLike, type CanvasMaxSize, Circle2d, ClickManager, CollaboratorsManager, ContainerProvider, type ContainerProviderProps, CubicBezier2d, CubicSpline2d, DEFAULT_ANIMATION_OPTIONS, DEFAULT_CAMERA_OPTIONS, DEFAULT_THEME, type DebugFlag, type DebugFlagDef, type DebugFlagDefaults, DefaultBackground, DefaultCanvas, DefaultCursor, DefaultErrorFallback, DefaultGrid, DefaultShapeWrapper, DefaultSpinner, DefaultSvgDefs, type DrAdjacentDirection, type DrAnyAssetUtilConstructor, type DrAnyBindingUtilConstructor, type DrAnyOverlayUtilConstructor, type DrAnyShapeUtilConstructor, type DrAssetUtilConstructor, type DrBackgroundProps, type DrBaseBoxShape, type DrBaseEventInfo, type DrBaseExternalContent, type DrBindingUtilConstructor, type DrCLickEventName, type DrCameraConstraints, type DrCameraEndPerfEvent, type DrCameraMoveOptions, type DrCameraOptions, type DrCameraStartPerfEvent, type DrCancelEvent, type DrCancelEventInfo, type DrCanvasComponentProps, type DrClickEvent, type DrClickEventInfo, type DrClickState, type DrClipboardPasteRawInfo, type DrClipboardWriteInfo, type DrCollaboratorCursorLayout, type DrCollaboratorCursorProps, type DrCompleteEvent, type DrCompleteEventInfo, type DrContent, type DrCropInfo, type DrCurrentUser, type DrCursorProps, type DrDeepLink, type DrDeepLinkOptions, type DrDragShapesInInfo, type DrDragShapesOutInfo, type DrDragShapesOverInfo, type DrDrawExternalContent, type DrDrawExternalContentSource, type DrDropShapesOverInfo, type DrEditStartInfo, type DrEditorComponents, type DrEditorOptions, type DrEditorRunOptions, type DrEditorSnapshot, type DrEmbedExternalContent, type DrEnterEventHandler, type DrErrorBoundaryProps, type DrErrorExternalContentSource, type DrErrorFallbackComponent, type DrErrorFallbackProps, type DrEventHandlers, type DrEventInfo, type DrEventMap, type DrEventMapHandler, type DrEventName, type DrExcalidrawExternalContent, type DrExcalidrawExternalContentSource, type DrExitEventHandler, type DrExportType, type DrExternalAsset, type DrExternalContent, type DrExternalContentSource, type DrFileExternalAsset, type DrFileReplaceExternalContent, type DrFilesExternalContent, type DrFramePerfEvent, type DrGeometryOpts, type DrGetShapeAtPointOptions, type DrGridProps, type DrHandleDragInfo, type DrHistoryBatchOptions, type DrHistoryDiff, type DrHistoryEntry, type DrHistoryMark, type DrImageExportOptions, type DrIndicatorPath, type DrInteractionEndPerfEvent, type DrInteractionStartPerfEvent, type DrInterruptEvent, type DrInterruptEventInfo, type DrKeyboardEvent, type DrKeyboardEventInfo, type DrKeyboardEventName, type DrLoadSessionStateSnapshotOptions, type DrLoadSnapshotOptions, type DrMeasureTextOpts, type DrMeasureTextSpanOpts, type DrMeasuredTextSize, type DrMiroExternalContent, type DrMiroExternalContentSource, type DrOnMountHandler, type DrOverlay, type DrOverlayEntry, type DrOverlayUtilConstructor, type DrPerfEventMap, type DrPerfFrameTimeStats, type DrPerfLongAnimationFrame, type DrPerfLongAnimationFrameScript, type DrPinchEvent, type DrPinchEventInfo, type DrPinchEventName, type DrPointerEvent, type DrPointerEventInfo, type DrPointerEventName, type DrPointerEventTarget, type DrRenderingShape, type DrResizeHandle, type DrResizeInfo, type DrResizeMode, type DrResizeShapeOptions, type DrRotationSnapshot, type DrSelectionHandle, type DrSessionStateSnapshot, type DrShapeErrorFallbackComponent, type DrShapeOperationPerfEvent, type DrShapeUtilCanBeLaidOutOpts, type DrShapeUtilCanBindOpts, type DrShapeUtilCanvasSvgDef, type DrShapeUtilConstructor, type DrShapeWrapperProps, type DrSpinnerProps, type DrStateNodeConstructor, type DrStoreBaseOptions, type DrStoreEventInfo, type DrStoreOptions, type DrStoreSchemaOptions, type DrStoreWithStatus, type DrSvgExportOptions, type DrSvgTextExternalContent, type DrTextExternalContent, type DrTextExternalContentSource, type DrTextOptions, type DrTickEvent, type DrTickEventInfo, type DrUndoRedoPerfEvent, type DrUpdatePointerOptions, type DrUrlExternalAsset, type DrUrlExternalContent, type DrUserPreferences, type DrWheelEvent, type DrWheelEventInfo, DrawEditor, type DrawEditorBaseProps, type DrawEditorProps, type DrawEditorStoreProps, type DrawEditorWithStoreProps, type DrawEditorWithoutStoreProps, type DrawOptions, EASINGS, EVENT_NAME_MAP, Edge2d, EdgeScrollManager, Editor, EditorAtom, EditorContext, EditorManager, EditorPortal, type EditorPortalProps, EditorProvider, type EditorProviderProps, Ellipse2d, ErrorBoundary, ErrorScreen, FontManager, type GapsSnapIndicator, Geometry2d, Geometry2dFilters, type Geometry2dOptions, Group2d, GroupShapeUtil, HALF_PI, HTMLContainer, type HTMLContainerProps, type HandleSnapGeometry, HandleSnaps, HistoryManager, InputsManager, LoadingScreen, type LoadingScreenProps, LocalIndexedDb, Mat, type MatLike, type MatModel, MenuClickCapture, OptionalErrorBoundary, type OptionalKeys, OverlayManager, type OverlayOptionsWithDisplayValues, OverlayUtil, PI, PI2, type PerfectDashTerminal, PerformanceApiAdapter, PerformanceManager, Point2d, type PointsSnapIndicator, Polygon2d, Polyline2d, ROTATE_CORNER_TO_SELECTION_CORNER, ReadonlySharedStyleMap, Rectangle2d, type RequiredKeys, type ResizeBoxOptions, type RichTextFontVisitor, type RichTextFontVisitorState, type RotateCorner, SIDES, SIN, SVGContainer, type SVGContainerProps, type SafeId, type ScribbleItem, ScribbleManager, type ScribbleSessionOptions, type SelectionCorner, type SelectionEdge, type SelectionHandle, ShapeUtil, type SharedStyle, SharedStyleMap, type SnapData, type SnapIndicator, SnapManager, SpatialIndexManager, Stadium2d, StateNode, type StoreName, type SvgExportContext, type SvgExportDef, TAB_ID, Table, TextManager, ThemeManager, TickManager, type TiptapEditor, type TiptapNode, TransformedGeometry2d, type TransformedGeometry2dOptions, USER_COLORS, type UiEvent, type UiEventType, UserPreferencesManager, Vec, type VecLike, activeElementShouldCaptureKeys, angleDistance, applyRotationToSnapshotShapes, approximately, areAnglesCompatible, average, canonicalizeRotation, centerOfCircleFromThreePoints, clamp, clampRadians, clampToBrowserMaxCanvasSize, clockwiseAngleDist, coreShapes, counterClockwiseAngleDist, createDebugValue, createDeepLinkString, createDrCurrentUser, createDrSchemaFromUtils, createDrStore, createSessionStateSnapshotSignal, dataUrlToFile, debugFlags, defaultDrawOptions, defaultUserPreferences, defaultUserStore, degreesToRadians, elementShouldCaptureKeys, extractSessionStateFromLegacySnapshot, featureFlags, getArcMeasure, getColorValue, getCursor, getDefaultCdnBaseUrl, getDroppedShapesToNewParents, getFontsFromRichText, getFreshUserPreferences, getGlobalDocument, getGlobalWindow, getIncrementedName, getOverlayDisplayValues, getOwnerDocument, getOwnerWindow, getPerfectDashProps, getPointInArcT, getPointOnCircle, getPointerInfo, getPointsOnArc, getPolygonVertices, getRotationSnapshot, getSnapshot, getSvgAsImage, getSvgPathFromPoints, getUserPreferences, getVerticesCountForArcLength, hardReset, hardResetEditor, inlineBase64AssetStore, intersectCircleCircle, intersectCirclePolygon, intersectCirclePolyline, intersectLineSegmentCircle, intersectLineSegmentLineSegment, intersectLineSegmentPolygon, intersectLineSegmentPolyline, intersectPolygonBounds, intersectPolygonPolygon, isAccelKey, isCursorInViewport, isSafeFloat, kickoutOccludedShapes, linesIntersect, loadSessionStateSnapshotIntoStore, loadSnapshot, loopToHtmlElement, maybeSnapToGrid, moveElementInto, normalizeWheel, openWindow, parseDeepLinkString, perimeterOfEllipse, pointInPolygon, polygonIntersectsPolyline, polygonsIntersect, precise, preventDefault, radiansToDegrees, rangeIntersection, refreshPage, releasePointerCapture, resizeBox, resizeScaled, resolveLineHeightPx, resolveThemes, rotateSelectionHandle, runtime, sanitizeId, setPointerCapture, setRuntimeOverrides, setUserPreferences, shortAngleDist, snapAngle, stopEventPropagation, strokeShapeIndicators, suffixSafeId, tleditors, tlenv, tlenvReactive, tlmenus, tltime, toDomPrecision, toFixed, toPrecision, uniq, useColorMode, useContainer, useContainerIfExists, useDelaySvgExport, useDrSchemaFromUtils, useDrStore, useDrawCurrentUser, useEditor, useEditorComponents, useEditorPortalHost, useEvent, useGlobalMenuIsOpen, useIsCropping, useIsEditing, useLocalStore, useMaybeEditor, useOnMount, usePassThroughWheelEvents, usePeerIds, usePresence, useReactiveEvent, useRefState, useShallowArrayIdentity, useShallowObjectIdentity, useSharedSafeId, useSvgExportContext, useTransform, useUniqueSafeId, useViewportHeight, userTypeValidator };