@tldraw/editor 5.3.0-next.fc37bd96825b → 5.4.0-canary.074b19f2c11f

package/dist-cjs/index.d.ts

@@ -18,6 +18,7 @@ import { IndexKey } from '@tldraw/utils';
 import { JsonObject } from '@tldraw/utils';
 import { JSX } from 'react/jsx-runtime';
 import { LegacyMigrations } from '@tldraw/store';
+import { MemoExoticComponent } from 'react';
 import { MigrationSequence } from '@tldraw/store';
 import { Node as Node_2 } from '@tiptap/pm/model';
 import { PerformanceTracker } from '@tldraw/utils';
@@ -25,6 +26,7 @@ import * as React_2 from 'react';
 import { default as React_3 } from 'react';
 import { ReactElement } from 'react';
 import { ReactNode } from 'react';
+import { ReactPortal } from 'react';
 import { RecordProps } from '@tldraw/tlschema';
 import { RecordsDiff } from '@tldraw/store';
 import { RefAttributes } from 'react';
@@ -66,6 +68,7 @@ import { TLImageAsset } from '@tldraw/tlschema';
 import { TLInstance } from '@tldraw/tlschema';
 import { TLInstancePageState } from '@tldraw/tlschema';
 import { TLInstancePresence } from '@tldraw/tlschema';
+import { TLOpacityType } from '@tldraw/tlschema';
 import { TLPage } from '@tldraw/tlschema';
 import { TLPageId } from '@tldraw/tlschema';
 import { TLParentId } from '@tldraw/tlschema';
@@ -554,13 +557,13 @@ export declare class BoundsSnaps {
     private getSnappablePoints;
     private getSnappableGapNodes;
     private getVisibleGaps;
-    snapTranslateShapes({ lockedAxis, initialSelectionPageBounds, initialSelectionSnapPoints, dragDelta }: {
+    snapTranslateShapes({ lockedAxis, initialSelectionPageBounds, initialSelectionSnapPoints, dragDelta, }: {
         dragDelta: Vec;
         initialSelectionPageBounds: Box;
         initialSelectionSnapPoints: BoundsSnapPoint[];
         lockedAxis: 'x' | 'y' | null;
     }): SnapData;
-    snapResizeShapes({ initialSelectionPageBounds, dragDelta, handle: originalHandle, isAspectRatioLocked, isResizingFromCenter }: {
+    snapResizeShapes({ initialSelectionPageBounds, dragDelta, handle: originalHandle, isAspectRatioLocked, isResizingFromCenter, }: {
         dragDelta: Vec;
         handle: SelectionCorner | SelectionEdge;
         initialSelectionPageBounds: Box;
@@ -842,7 +845,7 @@ export declare const coreShapes: readonly [typeof GroupShapeUtil];
 export declare function counterClockwiseAngleDist(a0: number, a1: number): number;
 
 /** @public */
-export declare function createDebugValue<T>(name: string, { defaults, shouldStoreForSession }: {
+export declare function createDebugValue<T>(name: string, { defaults, shouldStoreForSession, }: {
     defaults: DebugFlagDefaults<T>;
     shouldStoreForSession?: boolean;
 }): DebugFlag<T>;
@@ -873,8 +876,8 @@ export declare function createSessionStateSnapshotSignal(store: TLStore): Signal
 
 /** @public */
 export declare function createTLCurrentUser(opts?: {
-    setUserPreferences?: ((userPreferences: TLUserPreferences) => void) | undefined;
-    userPreferences?: Signal<TLUserPreferences, unknown> | undefined;
+    setUserPreferences?: (userPreferences: TLUserPreferences) => void;
+    userPreferences?: Signal<TLUserPreferences>;
 }): TLCurrentUser;
 
 /**
@@ -982,6 +985,15 @@ export declare function DefaultBackground(): JSX.Element;
 /** @public @react */
 export declare function DefaultCanvas({ className }: TLCanvasComponentProps): JSX.Element;
 
+/**
+ * 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
+ */
+export declare const DefaultCursor: MemoExoticComponent<({ className, zoom, point, color, name, chatMessage, }: TLCursorProps) => JSX.Element | null>;
+
 /** @public @react */
 export declare const DefaultErrorFallback: TLErrorFallbackComponent;
 
@@ -999,7 +1011,7 @@ export declare function DefaultSvgDefs(): null;
 
 /** @public */
 export declare const defaultTldrawOptions: {
-    readonly actionShortcutsLocation: "swap";
+    readonly actionShortcutsLocation: 'swap';
     readonly adjacentShapeMargin: 10;
     readonly animationMediumMs: 320;
     readonly camera: TLCameraOptions;
@@ -1171,7 +1183,7 @@ export declare class EdgeScrollManager {
 /** @public */
 export declare class Editor extends EventEmitter<TLEventMap> {
     readonly id: string;
-    constructor({ store, user, shapeUtils, bindingUtils, assetUtils: assetUtilConstructors, overlayUtils: overlayUtilConstructors, tools, getContainer, cameraOptions, initialState, autoFocus, options: _options, textOptions: _textOptions, getShapeVisibility, colorScheme, fontAssetUrls, themes, initialTheme }: TLEditorOptions);
+    constructor({ store, user, shapeUtils, bindingUtils, assetUtils: assetUtilConstructors, overlayUtils: overlayUtilConstructors, tools, getContainer, cameraOptions, initialState, autoFocus, options: _options, textOptions: _textOptions, getShapeVisibility, colorScheme, fontAssetUrls, themes, initialTheme, }: TLEditorOptions);
     private readonly _getShapeVisibility?;
     private getIsShapeHiddenCache;
     isShapeHidden(shapeOrId: TLShape | TLShapeId): boolean;
@@ -1263,8 +1275,8 @@ export declare class Editor extends EventEmitter<TLEventMap> {
     readonly timers: {
         dispose: () => void;
         requestAnimationFrame: (callback: FrameRequestCallback) => number;
-        setInterval: (handler: TimerHandler, timeout?: number | undefined, ...args: any[]) => number;
-        setTimeout: (handler: TimerHandler, timeout?: number | undefined, ...args: any[]) => number;
+        setInterval: (handler: TimerHandler, timeout?: number, ...args: any[]) => number;
+        setTimeout: (handler: TimerHandler, timeout?: number, ...args: any[]) => number;
     };
     /**
      * A manager for remote peer collaborators connected to this editor.
@@ -1797,14 +1809,14 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      * @public
      */
     getPageStates(): TLInstancePageState[];
-    private _getPageStatesQuery;
+    /* Excluded from this release type: _getPageStatesQuery */
     /**
      * The current page state.
      *
      * @public
      */
     getCurrentPageState(): TLInstancePageState;
-    private _getCurrentPageStateId;
+    /* Excluded from this release type: _getCurrentPageStateId */
     /**
      * Update this instance's page state.
      *
@@ -2197,7 +2209,7 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      *
      *  @public */
     getTextOptions(): TLTextOptions;
-    private _unsafe_getCameraId;
+    /* Excluded from this release type: _unsafe_getCameraId */
     /**
      * The current camera.
      *
@@ -2453,10 +2465,10 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      */
     slideCamera(opts?: {
         direction: VecLike;
-        force?: boolean | undefined;
-        friction?: number | undefined;
+        force?: boolean;
+        friction?: number;
         speed: number;
-        speedThreshold?: number | undefined;
+        speedThreshold?: number;
     }): this;
     /**
      * Animate the camera to a user's cursor position. This also briefly show the user's cursor if it's not currently visible.
@@ -2815,7 +2827,7 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      * @public
      */
     renamePage(page: TLPage | TLPageId, name: string): this;
-    private _getAllAssetsQuery;
+    /* Excluded from this release type: _getAllAssetsQuery */
     /**
      * Get all assets in the editor.
      *
@@ -2904,7 +2916,7 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      * @public
      */
     getShapeGeometry<T extends Geometry2d>(shape: TLShape | TLShapeId, opts?: TLGeometryOpts): T;
-    private _getShapeHandlesCache;
+    /* Excluded from this release type: _getShapeHandlesCache */
     /**
      * Get the handles (if any) for a shape.
      *
@@ -2934,7 +2946,7 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      * @public
      */
     getShapeLocalTransform(shape: TLShape | TLShapeId): Mat;
-    private _getShapePageTransformCache;
+    /* Excluded from this release type: _getShapePageTransformCache */
     /**
      * Get the local transform of a shape's parent as a matrix model.
      *
@@ -2962,7 +2974,7 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      * @public
      */
     getShapePageTransform(shape: TLShape | TLShapeId): Mat;
-    private _getShapePageBoundsCache;
+    /* Excluded from this release type: _getShapePageBoundsCache */
     /**
      * Get the bounds of a shape in the current page space.
      *
@@ -2977,7 +2989,7 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      * @public
      */
     getShapePageBounds(shape: TLShape | TLShapeId): Box | undefined;
-    private _getShapeClipPathCache;
+    /* Excluded from this release type: _getShapeClipPathCache */
     /**
      * Get the clip path for a shape.
      *
@@ -2994,7 +3006,7 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      * @public
      */
     getShapeClipPath(shape: TLShape | TLShapeId): string | undefined;
-    private _getShapeMaskCache;
+    /* Excluded from this release type: _getShapeMaskCache */
     /**
      * Get the mask (in the current page space) for a shape.
      *
@@ -3026,7 +3038,7 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      * @public
      */
     getShapeMaskedPageBounds(shape: TLShape | TLShapeId): Box | undefined;
-    private _getShapeMaskedPageBoundsCache;
+    /* Excluded from this release type: _getShapeMaskedPageBoundsCache */
     /**
      * Get the ancestors of a shape.
      *
@@ -3147,8 +3159,8 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      * @public
      */
     getShapesAtPoint(point: VecLike, opts?: {
-        hitInside?: boolean | undefined;
-        margin?: number | undefined;
+        hitInside?: boolean;
+        margin?: number;
     }): TLShape[];
     /**
      * Get shape IDs within the given bounds.
@@ -3184,8 +3196,8 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      * @public
      */
     isPointInShape(shape: TLShape | TLShapeId, point: VecLike, opts?: {
-        hitInside?: boolean | undefined;
-        margin?: number | undefined;
+        hitInside?: boolean;
+        margin?: number;
     }): boolean;
     /**
      * Convert a point in the current page space to a point in the local space of a shape. For example, if a
@@ -3473,7 +3485,7 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      * Delete a binding by its ID. If the binding doesn't exist, it's ignored.
      */
     deleteBinding(binding: TLBinding | TLBindingId, opts?: Parameters<this['deleteBindings']>[1]): this;
-    canBindShapes({ fromShape, toShape, binding }: {
+    canBindShapes({ fromShape, toShape, binding, }: {
         binding: {
             type: TLBinding['type'];
         } | TLBinding | TLBinding['type'];
@@ -3689,7 +3701,7 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      *
      * @public
      */
-    alignShapes(shapes: TLShape[] | TLShapeId[], operation: 'bottom' | 'center-horizontal' | 'center-vertical' | 'left' | 'right' | 'top'): this;
+    alignShapes(shapes: TLShape[] | TLShapeId[], operation: 'bottom' | 'center-horizontal' | 'center-vertical' | 'center' | 'left' | 'right' | 'top'): this;
     /**
      * Distribute shape positions.
      *
@@ -3940,7 +3952,7 @@ export declare class Editor extends EventEmitter<TLEventMap> {
     deleteShape(id: TLShapeId): this;
     deleteShape(shape: TLShape): this;
     /* Excluded from this release type: _extractSharedStyles */
-    private _getSelectionSharedStyles;
+    /* Excluded from this release type: _getSelectionSharedStyles */
     /**
      * Get the style for the next shape.
      *
@@ -4129,7 +4141,7 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      * @param opts - Options for handling external content, including force flag to bypass readonly checks.
      */
     putExternalContent<E>(info: TLExternalContent<E>, opts?: {
-        force?: boolean | undefined;
+        force?: boolean;
     }): Promise<void>;
     /**
      * Handle replacing external content.
@@ -4138,7 +4150,7 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      * @param opts - Options for handling external content, including force flag to bypass readonly checks.
      */
     replaceExternalContent<E>(info: TLExternalContent<E>, opts?: {
-        force?: boolean | undefined;
+        force?: boolean;
     }): Promise<void>;
     /**
      * Get content that can be exported for the given shape ids.
@@ -4462,13 +4474,14 @@ export declare class Editor extends EventEmitter<TLEventMap> {
     cancelDoubleClick(): void;
     /* Excluded from this release type: _prevCursor */
     /* Excluded from this release type: _shiftKeyTimeout */
-    /* Excluded from this release type: _setShiftKeyTimeout */
+    /* Excluded from this release type: _releaseShiftKey */
     /* Excluded from this release type: _altKeyTimeout */
-    /* Excluded from this release type: _setAltKeyTimeout */
+    /* Excluded from this release type: _releaseAltKey */
     /* Excluded from this release type: _ctrlKeyTimeout */
-    /* Excluded from this release type: _setCtrlKeyTimeout */
+    /* Excluded from this release type: _releaseCtrlKey */
     /* Excluded from this release type: _metaKeyTimeout */
-    /* Excluded from this release type: _setMetaKeyTimeout */
+    /* Excluded from this release type: _releaseMetaKey */
+    /* Excluded from this release type: _releaseDebouncedModifiers */
     /* Excluded from this release type: _restoreToolId */
     /* Excluded from this release type: _didPinch */
     /* Excluded from this release type: _selectedShapeIdsAtPointerDown */
@@ -4586,6 +4599,52 @@ export declare abstract class EditorManager {
     /* Excluded from this release type: dispose */
 }
 
+/**
+ * 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 (`--tl-layer-canvas-in-front`); above that belongs to
+ * whatever renders the UI. In `tldraw` that's `--tl-layer-panels` (300) and `--tl-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
+ */
+export declare function EditorPortal({ children }: EditorPortalProps): ReactPortal | null;
+
+/** @public */
+export declare interface EditorPortalProps {
+    children: ReactNode;
+}
+
 /** @public @react */
 export declare function EditorProvider({ editor, children }: EditorProviderProps): JSX.Element;
 
@@ -4982,7 +5041,7 @@ export declare class Group2d extends Geometry2d {
 
 /** @public */
 export declare class GroupShapeUtil extends ShapeUtil<TLGroupShape> {
-    static type: "group";
+    static type: 'group';
     static props: RecordProps<TLGroupShape>;
     static migrations: TLPropsMigrations;
     hideSelectionBoundsFg(shape: TLGroupShape): boolean;
@@ -5046,7 +5105,7 @@ export declare class HandleSnaps {
     private iterateSnapOutlines;
     private getHandleSnapPosition;
     private getHandleSnapData;
-    snapHandle({ currentShapeId, handle }: {
+    snapHandle({ currentShapeId, handle, }: {
         currentShapeId: TLShapeId;
         handle: TLHandle;
     }): null | SnapData;
@@ -5449,6 +5508,24 @@ export declare function intersectPolygonPolygon(polygonA: VecLike[], polygonB: V
 
 /* Excluded from this release type: isAccelKey */
 
+/**
+ * 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.
+ *
+ * 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).
+ *
+ * @public
+ */
+export declare function isCursorInViewport(cursor: VecLike, viewport: {
+    maxX: number;
+    maxY: number;
+    minX: number;
+    minY: number;
+}, zoom: number): boolean;
+
 /**
  * Check if a float is safe to use. ie: Not too big or small.
  * @public
@@ -5470,6 +5547,8 @@ export declare function kickoutOccludedShapes(editor: Editor, shapeIds: TLShapeI
 
 /* Excluded from this release type: LICENSE_TIMEOUT */
 
+/* Excluded from this release type: LicenseFeatureName */
+
 /* Excluded from this release type: LicenseFromKeyResult */
 
 /* Excluded from this release type: LicenseInfo */
@@ -6155,11 +6234,11 @@ export declare interface RichTextFontVisitorState {
 
 /** @public */
 export declare const ROTATE_CORNER_TO_SELECTION_CORNER: {
-    readonly bottom_left_rotate: "bottom_left";
-    readonly bottom_right_rotate: "bottom_right";
-    readonly mobile_rotate: "top_left";
-    readonly top_left_rotate: "top_left";
-    readonly top_right_rotate: "top_right";
+    readonly bottom_left_rotate: 'bottom_left';
+    readonly bottom_right_rotate: 'bottom_right';
+    readonly mobile_rotate: 'top_left';
+    readonly top_left_rotate: 'top_left';
+    readonly top_right_rotate: 'top_right';
 };
 
 /** @public */
@@ -6793,6 +6872,29 @@ export declare abstract class ShapeUtil<Shape extends TLShape = TLShape> {
      * @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.
@@ -7135,7 +7237,7 @@ export declare type SharedStyle<T> = {
 export declare function shortAngleDist(a0: number, a1: number): number;
 
 /** @public */
-export declare const SIDES: readonly ["top", "right", "bottom", "left"];
+export declare const SIDES: readonly ['top', 'right', 'bottom', 'left'];
 
 /** @public */
 export declare const SIN: (x: number) => number;
@@ -7525,6 +7627,11 @@ export declare interface TLBaseEventInfo {
 
 /** @public */
 export declare interface TLBaseExternalContent {
+    /**
+     * 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?: TLExternalContentSource[];
     point?: VecLike;
 }
@@ -7771,6 +7878,17 @@ export declare interface TLCurrentUser {
     readonly setUserPreferences: (userPreferences: TLUserPreferences) => void;
 }
 
+/** @public */
+export declare interface TLCursorProps {
+    userId: string;
+    className?: string;
+    point: null | VecModel;
+    zoom: number;
+    color?: string;
+    name: null | string;
+    chatMessage: string;
+}
+
 /** @public */
 export declare type TLDeepLink = {
     bounds: BoxModel;
@@ -7840,7 +7958,7 @@ export declare interface TLDragShapesOverInfo {
 }
 
 /** @public @react */
-export declare const TldrawEditor: React_3.NamedExoticComponent<TldrawEditorProps>;
+export declare const TldrawEditor: React_3.MemoExoticComponent<({ store, components, className, user: _user, options: _options, textOptions: _textOptions, deepLinks: _deepLinks, ...rest }: TldrawEditorProps) => JSX.Element>;
 
 /**
  * Base props for the {@link tldraw#Tldraw} and {@link TldrawEditor} components.
@@ -8273,6 +8391,7 @@ export declare interface TLDropShapesOverInfo {
 export declare interface TLEditorComponents {
     Background?: ComponentType | null;
     Canvas?: ComponentType<TLCanvasComponentProps> | null;
+    CollaboratorCursor?: ComponentType<TLCursorProps> | null;
     Grid?: ComponentType<TLGridProps> | null;
     InFrontOfTheCanvas?: ComponentType | null;
     LoadingScreen?: ComponentType | null;
@@ -8890,7 +9009,7 @@ export declare const tlmenus: {
      *
      * @public
      */
-    clearOpenMenus(contextId?: string | undefined): void;
+    clearOpenMenus(contextId?: string): void;
     /**
      * Delete an open menu.
      *
@@ -8913,7 +9032,7 @@ export declare const tlmenus: {
      *
      * @public
      */
-    getOpenMenus(contextId?: string | undefined): string[];
+    getOpenMenus(contextId?: string): string[];
     /**
      * Get whether a menu is open for a given context.
      *
@@ -8927,7 +9046,7 @@ export declare const tlmenus: {
      *
      * @public
      */
-    isMenuOpen(id: string, contextId?: string | undefined): boolean;
+    isMenuOpen(id: string, contextId?: string): boolean;
     /**
      * Get whether any menus are open for a given context.
      *
@@ -8965,7 +9084,7 @@ export declare const tlmenus: {
      *
      * @public
      */
-    hideOpenMenus(contextId?: string | undefined): void;
+    hideOpenMenus(contextId?: string): void;
     /**
      * Show all hidden menus.
      *
@@ -8979,7 +9098,7 @@ export declare const tlmenus: {
      *
      * @public
      */
-    showOpenMenus(contextId?: string | undefined): void;
+    showOpenMenus(contextId?: string): void;
     forContext(contextId: string): {
         addOpenMenu: (id: string) => void;
         clearOpenMenus: () => void;
@@ -9728,6 +9847,16 @@ export declare function useEditor(): Editor;
 /** @public */
 export declare function useEditorComponents(): Required<TLEditorComponents>;
 
+/**
+ * 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
+ */
+export declare function useEditorPortalHost(): HTMLElement | null;
+
 /* Excluded from this release type: useEvent */
 
 /** @public */
@@ -9739,6 +9868,10 @@ export declare function useIsCropping(shapeId: TLShapeId): boolean;
 /** @public */
 export declare function useIsEditing(shapeId: TLShapeId): boolean;
 
+/* Excluded from this release type: useLicenseContext */
+
+/* Excluded from this release type: useLicenseFeatureFlag */
+
 /* Excluded from this release type: useLocalStore */
 
 /** @public */
@@ -9746,9 +9879,6 @@ export declare function useMaybeEditor(): Editor | null;
 
 /* Excluded from this release type: useOnMount */
 
-/** @public */
-export declare function usePassThroughMouseOverEvents(ref: RefObject<HTMLElement | null>): void;
-
 /** @public */
 export declare function usePassThroughWheelEvents(ref: RefObject<HTMLElement | null>): void;
 
@@ -9875,6 +10005,13 @@ export declare function useTLSchemaFromUtils(opts: TLStoreSchemaOptions): StoreS
 /** @public */
 export declare function useTLStore(opts: TLStoreOptions): TLStore;
 
+/**
+ * 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
+ */
+export declare function useTransform(ref: React.RefObject<HTMLElement | null | SVGElement>, x?: number, y?: number, scale?: number, rotate?: number, additionalOffset?: VecLike): void;
+
 /**
  * React's useId hook returns a unique id for the component. However, it uses a colon in the id,
  * which is not valid for CSS selectors. This hook replaces the colon with an underscore.
@@ -9883,7 +10020,15 @@ export declare function useTLStore(opts: TLStoreOptions): TLStore;
  */
 export declare function useUniqueSafeId(suffix?: string): SafeId;
 
-/** @public */
+/**
+ * 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
+ */
 export declare function useViewportHeight(): number;
 
 /* Excluded from this release type: ValidLicenseKeyResult */