tldraw 3.16.0-canary.ca347c5375a5 → 3.16.0-canary.cb18f446a36f

package/dist-esm/index.d.mts

@@ -11,13 +11,16 @@ import { Circle2d } from '@tldraw/editor';
 import { ComponentType } from 'react';
 import { CSSProperties } from 'react';
 import { Editor } from '@tldraw/editor';
+import { ElbowArrowSnap } from '@tldraw/editor';
 import { Extension } from '@tiptap/core';
 import { Extensions } from '@tiptap/core';
+import { ForwardRefExoticComponent } from 'react';
 import { Geometry2d } from '@tldraw/editor';
 import { Geometry2dFilters } from '@tldraw/editor';
 import { Geometry2dOptions } from '@tldraw/editor';
 import { Group2d } from '@tldraw/editor';
 import { HandleSnapGeometry } from '@tldraw/editor';
+import { HTMLAttributes } from 'react';
 import { IndexKey } from '@tldraw/editor';
 import { JsonObject } from '@tldraw/editor';
 import { JSX as JSX_2 } from 'react/jsx-runtime';
@@ -37,6 +40,7 @@ import { ReadonlySharedStyleMap } from '@tldraw/editor';
 import { RecordProps } from '@tldraw/editor';
 import { Rectangle2d } from '@tldraw/editor';
 import { RecursivePartial } from '@tldraw/editor';
+import { RefAttributes } from 'react';
 import { RefObject } from 'react';
 import { Result } from '@tldraw/editor';
 import { RichTextFontVisitorState } from '@tldraw/editor';
@@ -55,6 +59,7 @@ import { TLArrowBinding } from '@tldraw/editor';
 import { TLArrowBindingProps } from '@tldraw/editor';
 import { TLArrowShape } from '@tldraw/editor';
 import { TLArrowShapeArrowheadStyle } from '@tldraw/editor';
+import { TLArrowShapeKind } from '@tldraw/editor';
 import { TLArrowShapeProps } from '@tldraw/editor';
 import { TLAsset } from '@tldraw/editor';
 import { TLAssetId } from '@tldraw/editor';
@@ -65,7 +70,6 @@ import { TLClickEventInfo } from '@tldraw/editor';
 import { TLContent } from '@tldraw/editor';
 import { TLCropInfo } from '@tldraw/editor';
 import { TLDefaultColorStyle } from '@tldraw/editor';
-import { TLDefaultColorTheme } from '@tldraw/editor';
 import { TLDefaultColorThemeColor } from '@tldraw/editor';
 import { TLDefaultDashStyle } from '@tldraw/editor';
 import { TLDefaultFillStyle } from '@tldraw/editor';
@@ -148,6 +152,9 @@ export declare interface A11yProviderProps {
     children: React.ReactNode;
 }
 
+/** @public @react */
+export declare function AccessibilityMenu(): JSX_2.Element;
+
 /** @public */
 export declare interface ActionsProviderProps {
     overrides?(editor: Editor, actions: TLUiActionsContextType, helpers: TLUiOverrideHelpers): TLUiActionsContextType;
@@ -187,9 +194,6 @@ export declare class ArrowBindingUtil extends BindingUtil<TLArrowBinding> {
 /** @public @react */
 export declare function ArrowDownToolbarItem(): JSX_2.Element;
 
-/** @public @react */
-export declare function ArrowheadStylePickerSet({ styles }: StylePickerSetProps): JSX_2.Element | null;
-
 /** @public @react */
 export declare function ArrowLeftToolbarItem(): JSX_2.Element;
 
@@ -272,7 +276,7 @@ export declare interface ArrowShapeOptions {
      */
     readonly hoverPreciseTimeout: number;
     /**
-     * When pointing at a shape using the arrow tool or draggin an arrow terminal handle, how long
+     * When pointing at a shape using the arrow tool or dragging an arrow terminal handle, how long
      * should we wait before we assume the user is targeting precisely instead of imprecisely.
      */
     readonly pointingPreciseTimeout: number;
@@ -280,11 +284,11 @@ export declare interface ArrowShapeOptions {
      * When creating an arrow, should it stop exactly at the pointer, or should
      * it stop at the edge of the target shape.
      */
-    readonly shouldBeExact: (editor: Editor) => boolean;
+    shouldBeExact(editor: Editor, isPrecise: boolean): boolean;
     /**
      * When creating an arrow, should it bind to the target shape.
      */
-    readonly shouldIgnoreTargets: (editor: Editor) => boolean;
+    shouldIgnoreTargets(editor: Editor): boolean;
 }
 
 /** @public */
@@ -359,6 +363,42 @@ export declare class ArrowShapeUtil extends ShapeUtil<TLArrowShape> {
     getInterpolatedProps(startShape: TLArrowShape, endShape: TLArrowShape, progress: number): TLArrowShapeProps;
 }
 
+/**
+ * State representing what we're pointing to when drawing or updating an arrow. You can get this
+ * state using {@link getArrowTargetState}, and update it as part of an arrow interaction with
+ * {@link updateArrowTargetState} or {@link clearArrowTargetState}.
+ *
+ * @public
+ */
+export declare interface ArrowTargetState {
+    target: TLShape;
+    arrowKind: TLArrowShapeKind;
+    handlesInPageSpace: {
+        bottom: {
+            isEnabled: boolean;
+            point: VecLike;
+        };
+        left: {
+            isEnabled: boolean;
+            point: VecLike;
+        };
+        right: {
+            isEnabled: boolean;
+            point: VecLike;
+        };
+        top: {
+            isEnabled: boolean;
+            point: VecLike;
+        };
+    };
+    isExact: boolean;
+    isPrecise: boolean;
+    centerInPageSpace: VecLike;
+    anchorInPageSpace: VecLike;
+    snap: ElbowArrowSnap;
+    normalizedAnchor: VecLike;
+}
+
 /** @public @react */
 export declare function ArrowToolbarItem(): JSX_2.Element;
 
@@ -485,6 +525,14 @@ export declare function centerSelectionAroundPoint(editor: Editor, position: Vec
 /** @public @react */
 export declare function CheckBoxToolbarItem(): JSX_2.Element;
 
+/**
+ * Clear the current arrow target state for an editor. See {@link ArrowTargetState} for more
+ * information.
+ *
+ * @public
+ */
+export declare function clearArrowTargetState(editor: Editor): void;
+
 /** @public @react */
 export declare function ClipboardMenuGroup(): JSX_2.Element;
 
@@ -494,9 +542,6 @@ export declare function CloudToolbarItem(): JSX_2.Element;
 /** @public @react */
 export declare function ColorSchemeMenu(): JSX_2.Element;
 
-/** @public @react */
-export declare function CommonStylePickerSet({ styles, theme }: ThemeStylePickerSetProps): JSX_2.Element;
-
 /**
  * Contains the size within the given box size
  *
@@ -528,14 +573,6 @@ export declare function ConvertToEmbedMenuItem(): JSX_2.Element | null;
  */
 export declare function copyAs(editor: Editor, ids: TLShapeId[], opts: CopyAsOptions): Promise<void>;
 
-/**
- * @deprecated The format parameter is now part of the opts object.
- * @public
- */
-export declare function copyAs(editor: Editor, ids: TLShapeId[], format: TLCopyType, opts?: TLImageExportOptions & {
-    format?: undefined;
-}): Promise<void>;
-
 /** @public @react */
 export declare function CopyAsMenuGroup(): JSX_2.Element;
 
@@ -847,6 +884,9 @@ export declare let defaultEditorAssetUrls: TLEditorAssetUrls;
 /** @public */
 export declare type DefaultEmbedDefinitionType = (typeof DEFAULT_EMBED_DEFINITIONS)[number]['type'];
 
+/** @public @react */
+export declare function DefaultFollowingIndicator(): JSX_2.Element | null;
+
 /** @public */
 export declare const DefaultFontFaces: TLDefaultFonts;
 
@@ -990,7 +1030,7 @@ export declare function DefaultSharePanel(): JSX_2.Element;
 export declare const DefaultStylePanel: NamedExoticComponent<TLUiStylePanelProps>;
 
 /** @public @react */
-export declare function DefaultStylePanelContent({ styles }: TLUiStylePanelContentProps): JSX_2.Element | null;
+export declare function DefaultStylePanelContent(): JSX_2.Element;
 
 /** @public @react */
 export declare const DefaultToasts: NamedExoticComponent<object>;
@@ -1011,6 +1051,11 @@ export declare function DefaultToolbarContent(): JSX_2.Element;
 /** @public */
 export declare interface DefaultToolbarProps {
     children?: ReactNode;
+    orientation?: 'horizontal' | 'vertical';
+    minItems?: number;
+    minSizePx?: number;
+    maxItems?: number;
+    maxSizePx?: number;
 }
 
 /** @public */
@@ -1478,12 +1523,6 @@ export declare interface ExampleDialogProps {
  */
 export declare function exportAs(editor: Editor, ids: TLShapeId[], opts: ExportAsOptions): Promise<void>;
 
-/**
- * @deprecated The format & name parameters are now part of the opts object.
- * @public
- */
-export declare function exportAs(editor: Editor, ids: TLShapeId[], format?: TLExportType, name?: string, opts?: TLImageExportOptions): Promise<void>;
-
 /** @public */
 export declare interface ExportAsOptions extends TLImageExportOptions {
     /** {@inheritdoc @tldraw/editor#TLImageExportOptions.format} */
@@ -1495,23 +1534,6 @@ export declare interface ExportAsOptions extends TLImageExportOptions {
 /** @public @react */
 export declare function ExportFileContentSubMenu(): JSX_2.Element;
 
-/**
- * Export the given shapes as a blob.
- * @param editor - The editor instance.
- * @param ids - The ids of the shapes to export.
- * @param format - The format to export as.
- * @param opts - Rendering options.
- * @returns A promise that resolves to a blob.
- * @deprecated Use {@link @tldraw/editor#Editor.toImage} instead.
- * @public
- */
-export declare function exportToBlob({ editor, ids, format, opts, }: {
-    editor: Editor;
-    format: TLExportType;
-    ids: TLShapeId[];
-    opts?: TLImageExportOptions;
-}): Promise<Blob>;
-
 /** @public @react */
 export declare function ExtrasGroup(): JSX_2.Element;
 
@@ -1568,6 +1590,7 @@ export declare class FrameShapeUtil extends BaseBoxShapeUtil<TLFrameShape> {
     canEdit(): boolean;
     canResize(): boolean;
     canResizeChildren(): boolean;
+    isExportBoundsContainer(): boolean;
     getDefaultProps(): TLFrameShape['props'];
     getAriaDescriptor(shape: TLFrameShape): string;
     getGeometry(shape: TLFrameShape): Geometry2d;
@@ -1576,6 +1599,7 @@ export declare class FrameShapeUtil extends BaseBoxShapeUtil<TLFrameShape> {
     toSvg(shape: TLFrameShape, ctx: SvgExportContext): JSX_2.Element;
     indicator(shape: TLFrameShape): JSX_2.Element;
     providesBackgroundForChildren(): boolean;
+    getClipPath(shape: TLFrameShape): Vec[];
     canReceiveNewChildrenOfType(shape: TLShape): boolean;
     onResize(shape: any, info: TLResizeInfo<any>): any;
     getInterpolatedProps(startShape: TLFrameShape, endShape: TLFrameShape, t: number): TLFrameShapeProps;
@@ -1724,15 +1748,20 @@ export declare class GeoShapeUtil extends BaseBoxShapeUtil<TLGeoShape> {
     getInterpolatedProps(startShape: TLGeoShape, endShape: TLGeoShape, t: number): TLGeoShapeProps;
 }
 
-/** @public @react */
-export declare function GeoStylePickerSet({ styles }: StylePickerSetProps): JSX_2.Element | null;
-
 /** @public */
 export declare function getArrowBindings(editor: Editor, shape: TLArrowShape): TLArrowBindings;
 
 /** @public */
 export declare function getArrowInfo(editor: Editor, shape: TLArrowShape | TLShapeId): TLArrowInfo | undefined;
 
+/**
+ * Get the current arrow target state for an editor. See {@link ArrowTargetState} for more
+ * information.
+ *
+ * @public
+ */
+export declare function getArrowTargetState(editor: Editor): ArrowTargetState | null;
+
 /** @public */
 export declare function getArrowTerminalsInArrowSpace(editor: Editor, shape: TLArrowShape, bindings: TLArrowBindings): {
     end: Vec;
@@ -1769,6 +1798,29 @@ export declare function getHitShapeOnCanvasPointerDown(editor: Editor, hitLabels
 /** @public */
 export declare function getMediaAssetInfoPartial(file: File, assetId: TLAssetId, isImageType: boolean, isVideoType: boolean, maxImageDimension?: number): Promise<TLImageAsset | TLVideoAsset>;
 
+/**
+ * ## getStrokePoints
+ *
+ * Get an array of points as objects with an adjusted point, pressure, vector, distance, and
+ * runningLength.
+ *
+ * @param points - An array of points (as `[x, y, pressure]` or `{x, y, pressure}`). Pressure is
+ *   optional in both cases.
+ * @param options - An object with options.
+ * @public
+ */
+export declare function getStrokePoints(rawInputPoints: VecLike[], options?: StrokeOptions): StrokePoint[];
+
+/**
+ * Turn an array of stroke points into a path of quadradic curves.
+ *
+ * @param points - The stroke points returned from perfect-freehand
+ * @param closed - Whether the shape is closed
+ *
+ * @public
+ */
+export declare function getSvgPathFromStrokePoints(points: StrokePoint[], closed?: boolean): string;
+
 /**
  * Original (uncropped) width and height of shape.
  *
@@ -1864,6 +1916,7 @@ export declare class ImageShapeUtil extends BaseBoxShapeUtil<TLImageShape> {
     static migrations: TLPropsMigrations;
     isAspectRatioLocked(): boolean;
     canCrop(): boolean;
+    isExportBoundsContainer(): boolean;
     getDefaultProps(): TLImageShape['props'];
     getGeometry(shape: TLImageShape): Geometry2d;
     getAriaDescriptor(shape: TLImageShape): string;
@@ -2114,21 +2167,57 @@ export declare class NoteShapeUtil extends ShapeUtil<TLNoteShape> {
 /** @public @react */
 export declare function NoteToolbarItem(): JSX_2.Element;
 
+/**
+ * Checks if a file is allowed to be uploaded. If it is not, it will show a toast explaining why to the user.
+ *
+ * @param file - The file to check
+ * @param options - The options for the external content handler
+ * @returns True if the file is allowed, false otherwise
+ * @public
+ */
+export declare function notifyIfFileNotAllowed(file: File, options: TLDefaultExternalContentHandlerOpts): boolean;
+
 /** @public @react */
 export declare function OfflineIndicator(): JSX_2.Element;
 
-/** @public @react */
-export declare function OpacitySlider(): JSX_2.Element | null;
+/**
+ * A helper method to use in {@link TLUiToolItem#onDragStart} to create a shape by dragging it from
+ * the toolbar.
+ * @public
+ */
+export declare function onDragFromToolbarToCreateShape(editor: Editor, info: TLPointerEventInfo, opts: OnDragFromToolbarToCreateShapesOpts): void;
+
+/**
+ * Options for {@link onDragFromToolbarToCreateShape}.
+ * @public
+ */
+export declare interface OnDragFromToolbarToCreateShapesOpts {
+    /**
+     * Create the shape being dragged. You don't need to worry about positioning it, as it'll be
+     * immediately updated with the correct position.
+     */
+    createShape(id: TLShapeId): void;
+    /**
+     * Called once the drag interaction has finished.
+     */
+    onDragEnd?(id: TLShapeId): void;
+}
 
 /** @public @react */
 export declare function OvalToolbarItem(): JSX_2.Element;
 
 /** @public @react */
-export declare function OverflowingToolbar({ children }: OverflowingToolbarProps): JSX_2.Element;
+export declare function OverflowingToolbar({ children, orientation, sizingParentClassName, minItems, minSizePx, maxItems, maxSizePx, }: OverflowingToolbarProps): JSX_2.Element;
 
 /** @public */
 export declare interface OverflowingToolbarProps {
     children: React.ReactNode;
+    orientation: 'horizontal' | 'vertical';
+    sizingParentClassName: string;
+    minItems: number;
+    minSizePx: number;
+    maxItems: number;
+    maxSizePx: number;
 }
 
 /** @public @react */
@@ -2505,9 +2594,6 @@ export declare interface SolidPathBuilderOpts extends BasePathBuilderOpts {
 
 /* Excluded from this release type: Spinner */
 
-/** @public @react */
-export declare function SplineStylePickerSet({ styles }: StylePickerSetProps): JSX_2.Element | null;
-
 /** @public @react */
 export declare function StackMenuItems(): JSX_2.Element;
 
@@ -2517,11 +2603,172 @@ export declare function StarToolbarItem(): JSX_2.Element;
 /** @public */
 export declare const STROKE_SIZES: Record<TLDefaultSizeStyle, number>;
 
+/**
+ * The options object for `getStroke` or `getStrokePoints`.
+ *
+ * @public
+ */
+export declare interface StrokeOptions {
+    /** The base size (diameter) of the stroke. */
+    size?: number;
+    /** The effect of pressure on the stroke's size. */
+    thinning?: number;
+    /** How much to soften the stroke's edges. */
+    smoothing?: number;
+    streamline?: number;
+    /** An easing function to apply to each point's pressure. */
+    easing?(pressure: number): number;
+    /** Whether to simulate pressure based on velocity. */
+    simulatePressure?: boolean;
+    /** Cap, taper and easing for the start of the line. */
+    start?: {
+        cap?: boolean;
+        easing?(distance: number): number;
+        taper?: boolean | number;
+    };
+    /** Cap, taper and easing for the end of the line. */
+    end?: {
+        cap?: boolean;
+        easing?(distance: number): number;
+        taper?: boolean | number;
+    };
+    /** Whether to handle the points as a completed stroke. */
+    last?: boolean;
+}
+
+/**
+ * The points returned by `getStrokePoints`, and the input for `getStrokeOutlinePoints`
+ *
+ * @public
+ */
+export declare interface StrokePoint {
+    point: Vec;
+    input: Vec;
+    vector: Vec;
+    pressure: number;
+    distance: number;
+    runningLength: number;
+    radius: number;
+}
+
+/** @public @react */
+export declare function StylePanelArrowheadPicker(): JSX_2.Element | null;
+
+/** @public @react */
+export declare function StylePanelArrowKindPicker(): JSX_2.Element | null;
+
+/** @public */
+export declare const StylePanelButtonPicker: <T extends string>(props: StylePanelButtonPickerProps<T>) => ReactElement;
+
+/** @public */
+export declare interface StylePanelButtonPickerProps<T extends string> {
+    title: string;
+    uiType: string;
+    style: StyleProp<T>;
+    value: SharedStyle<T>;
+    items: StyleValuesForUi<T>;
+    onValueChange?(style: StyleProp<T>, value: T): void;
+    onHistoryMark?(id: string): void;
+}
+
+/** @public @react */
+export declare function StylePanelColorPicker(): JSX_2.Element | null;
+
+/** @public */
+export declare interface StylePanelContext {
+    styles: ReadonlySharedStyleMap;
+    showUiLabels: boolean;
+    onHistoryMark(id: string): void;
+    onValueChange<T>(style: StyleProp<T>, value: T): void;
+}
+
+/** @public @react */
+export declare function StylePanelContextProvider({ children, styles }: StylePanelContextProviderProps): JSX_2.Element;
+
 /** @public */
-export declare interface StylePickerSetProps {
+export declare interface StylePanelContextProviderProps {
+    children: React.ReactNode;
     styles: ReadonlySharedStyleMap;
 }
 
+/** @public @react */
+export declare function StylePanelDashPicker(): JSX_2.Element | null;
+
+/** @public @react */
+export declare const StylePanelDoubleDropdownPicker: <T extends string>(props: StylePanelDoubleDropdownPickerProps<T>) => React_2.JSX.Element;
+
+/** @public */
+export declare interface StylePanelDoubleDropdownPickerProps<T extends string> {
+    uiTypeA: string;
+    uiTypeB: string;
+    label: Exclude<string, TLUiTranslationKey> | TLUiTranslationKey;
+    labelA: Exclude<string, TLUiTranslationKey> | TLUiTranslationKey;
+    labelB: Exclude<string, TLUiTranslationKey> | TLUiTranslationKey;
+    itemsA: StyleValuesForUi<T>;
+    itemsB: StyleValuesForUi<T>;
+    styleA: StyleProp<T>;
+    styleB: StyleProp<T>;
+    valueA: SharedStyle<T>;
+    valueB: SharedStyle<T>;
+    onValueChange?(style: StyleProp<T>, value: T): void;
+}
+
+/** @public @react */
+export declare const StylePanelDropdownPicker: <T extends string>(props: StylePanelDropdownPickerProps<T>) => React_2.JSX.Element;
+
+/** @public */
+export declare interface StylePanelDropdownPickerProps<T extends string> {
+    id: string;
+    label?: Exclude<string, TLUiTranslationKey> | TLUiTranslationKey;
+    uiType: string;
+    stylePanelType: string;
+    style: StyleProp<T>;
+    value: SharedStyle<T>;
+    items: StyleValuesForUi<T>;
+    type: 'icon' | 'menu' | 'tool';
+    onValueChange?(style: StyleProp<T>, value: T): void;
+}
+
+/** @public @react */
+export declare function StylePanelFillPicker(): JSX_2.Element | null;
+
+/** @public @react */
+export declare function StylePanelFontPicker(): JSX_2.Element | null;
+
+/** @public @react */
+export declare function StylePanelGeoShapePicker(): JSX_2.Element | null;
+
+/** @public @react */
+export declare function StylePanelLabelAlignPicker(): JSX_2.Element | null;
+
+/** @public @react */
+export declare function StylePanelOpacityPicker(): JSX_2.Element | null;
+
+/** @public @react */
+export declare function StylePanelSection({ children }: StylePanelSectionProps): JSX_2.Element;
+
+/** @public */
+export declare interface StylePanelSectionProps {
+    children: React_3.ReactNode;
+}
+
+/** @public @react */
+export declare function StylePanelSizePicker(): JSX_2.Element | null;
+
+/** @public @react */
+export declare function StylePanelSplinePicker(): JSX_2.Element | null;
+
+/** @public @react */
+export declare function StylePanelSubheading({ children }: StylePanelSubheadingProps): JSX_2.Element;
+
+/** @public */
+export declare interface StylePanelSubheadingProps {
+    children: React.ReactNode;
+}
+
+/** @public @react */
+export declare function StylePanelTextAlignPicker(): JSX_2.Element | null;
+
 /** @public */
 export declare type StyleValuesForUi<T> = readonly {
     readonly icon: string | TLUiIconJsx;
@@ -2561,12 +2808,6 @@ export declare interface TextAreaProps {
  */
 export declare const TextDirection: Extension<any, any>;
 
-/**
- * @deprecated Use `PlainTextLabel` instead.
- * @public
- */
-export declare const TextLabel: React_3.NamedExoticComponent<PlainTextLabelProps>;
-
 /** @public */
 export declare interface TextShapeOptions {
     /** How much addition padding should be added to the horizontal geometry of the shape when binding to an arrow? */
@@ -2644,18 +2885,9 @@ export declare class TextShapeUtil extends ShapeUtil<TLTextShape> {
     } | undefined;
 }
 
-/** @public @react */
-export declare function TextStylePickerSet({ theme, styles }: ThemeStylePickerSetProps): JSX_2.Element | null;
-
 /** @public @react */
 export declare function TextToolbarItem(): JSX_2.Element;
 
-/** @public */
-export declare interface ThemeStylePickerSetProps {
-    styles: ReadonlySharedStyleMap;
-    theme: TLDefaultColorTheme;
-}
-
 /**
  * Default extensions for the TipTap editor.
  *
@@ -2912,8 +3144,12 @@ export declare function TldrawUiButtonIcon({ icon, small, invertIcon }: TLUiButt
 /** @public @react */
 export declare function TldrawUiButtonLabel({ children }: TLUiButtonLabelProps): JSX_2.Element;
 
-/** @public */
-export declare const TldrawUiButtonPicker: <T extends string>(props: TLUiButtonPickerProps<T>) => ReactElement;
+/**
+ * A column, usually of UI controls like buttons, select dropdown, checkboxes, etc.
+ *
+ * @public @react
+ */
+export declare const TldrawUiColumn: ForwardRefExoticComponent<TLUiLayoutProps & RefAttributes<HTMLDivElement>>;
 
 /** @public @react */
 export declare function TldrawUiComponentsProvider({ overrides, children, }: TLUiComponentsProviderProps): JSX_2.Element;
@@ -2977,9 +3213,19 @@ export declare function TldrawUiDropdownMenuTrigger({ children, ...rest }: TLUiD
 /** @public @react */
 export declare function TldrawUiEventsProvider({ onEvent, children }: EventsProviderProps): JSX_2.Element;
 
+/**
+ * A tight grid 4 elements wide, usually of UI controls like buttons, select dropdown, checkboxes,
+ * etc.
+ *
+ * @public @react */
+export declare const TldrawUiGrid: ForwardRefExoticComponent<TLUiLayoutProps & RefAttributes<HTMLDivElement>>;
+
 /** @public @react */
 export declare const TldrawUiIcon: NamedExoticComponent<TLUiIconProps>;
 
+/** @public @react */
+export declare function TldrawUiInFrontOfTheCanvas(): JSX_2.Element;
+
 /** @public @react */
 export declare const TldrawUiInput: React_2.ForwardRefExoticComponent<TLUiInputProps & React_2.RefAttributes<HTMLInputElement>>;
 
@@ -2993,7 +3239,7 @@ export declare function TldrawUiMenuActionCheckboxItem({ actionId, ...rest }: TL
 export declare function TldrawUiMenuActionItem({ actionId, ...rest }: TLUiMenuActionItemProps): JSX_2.Element | null;
 
 /** @public @react */
-export declare function TldrawUiMenuCheckboxItem<TranslationKey extends string = string, IconType extends string = string>({ id, kbd, label, readonlyOk, onSelect, toggle, disabled, checked, }: TLUiMenuCheckboxItemProps<TranslationKey, IconType>): JSX_2.Element | null;
+export declare function TldrawUiMenuCheckboxItem<TranslationKey extends string = string, IconType extends string = string>({ id, kbd, label, lang, readonlyOk, onSelect, toggle, disabled, checked, }: TLUiMenuCheckboxItemProps<TranslationKey, IconType>): JSX_2.Element | null;
 
 /** @public @react */
 export declare function TldrawUiMenuContextProvider({ type, sourceId, children, }: TLUiMenuContextProviderProps): JSX_2.Element;
@@ -3002,7 +3248,7 @@ export declare function TldrawUiMenuContextProvider({ type, sourceId, children,
 export declare function TldrawUiMenuGroup({ id, label, className, children }: TLUiMenuGroupProps): boolean | JSX_2.Element | Iterable<ReactNode> | null | number | string | undefined;
 
 /** @public @react */
-export declare function TldrawUiMenuItem<TranslationKey extends string = string, IconType extends string = string>({ disabled, spinner, readonlyOk, id, kbd, label, icon, iconLeft, onSelect, noClose, isSelected, }: TLUiMenuItemProps<TranslationKey, IconType>): JSX_2.Element | null;
+export declare function TldrawUiMenuItem<TranslationKey extends string = string, IconType extends string = string>({ disabled, spinner, readonlyOk, id, kbd, label, icon, iconLeft, onSelect, noClose, isSelected, onDragStart, }: TLUiMenuItemProps<TranslationKey, IconType>): JSX_2.Element | null;
 
 /** @public @react */
 export declare function TldrawUiMenuSubmenu<Translation extends string = string>({ id, disabled, label, size, children, }: TLUiMenuSubmenuProps<Translation>): boolean | JSX_2.Element | Iterable<ReactNode> | null | number | string | undefined;
@@ -3010,8 +3256,24 @@ export declare function TldrawUiMenuSubmenu<Translation extends string = string>
 /** @public @react */
 export declare function TldrawUiMenuToolItem({ toolId, ...rest }: TLUiMenuToolItemProps): JSX_2.Element | null;
 
+/** @public */
+export declare interface TldrawUiOrientationContext {
+    orientation: 'horizontal' | 'vertical';
+    tooltipSide: 'bottom' | 'left' | 'right' | 'top';
+}
+
 /** @public @react */
-export declare function TldrawUiPopover({ id, children, onOpenChange, open }: TLUiPopoverProps): JSX_2.Element;
+export declare function TldrawUiOrientationProvider({ children, orientation, tooltipSide, }: TldrawUiOrientationProviderProps): JSX_2.Element;
+
+/** @public */
+export declare interface TldrawUiOrientationProviderProps {
+    children: ReactNode;
+    orientation: 'horizontal' | 'vertical';
+    tooltipSide?: 'bottom' | 'left' | 'right' | 'top';
+}
+
+/** @public @react */
+export declare function TldrawUiPopover({ id, children, onOpenChange, open, className }: TLUiPopoverProps): JSX_2.Element;
 
 /** @public @react */
 export declare function TldrawUiPopoverContent({ side, children, align, sideOffset, alignOffset, disableEscapeKeyDown, autoFocusFirstButton, }: TLUiPopoverContentProps): JSX_2.Element;
@@ -3041,6 +3303,13 @@ export declare interface TldrawUiProps extends TLUiContextProviderProps {
     assetUrls?: TLUiAssetUrlOverrides;
 }
 
+/**
+ * A row, usually of UI controls like buttons, select dropdown, checkboxes, etc.
+ *
+ * @public @react
+ */
+export declare const TldrawUiRow: ForwardRefExoticComponent<TLUiLayoutProps & RefAttributes<HTMLDivElement>>;
+
 /** @public @react */
 export declare const TldrawUiSlider: React_3.ForwardRefExoticComponent<TLUiSliderProps & React_3.RefAttributes<HTMLDivElement>>;
 
@@ -3054,10 +3323,32 @@ export declare const TldrawUiToolbar: React_3.ForwardRefExoticComponent<TLUiTool
 export declare const TldrawUiToolbarButton: React_3.ForwardRefExoticComponent<TLUiToolbarButtonProps & React_3.RefAttributes<HTMLButtonElement>>;
 
 /** @public @react */
-export declare const TldrawUiToolbarToggleGroup: ({ children, className, type, ...props }: TLUiToolbarToggleGroupProps) => JSX_2.Element;
+export declare const TldrawUiToolbarToggleGroup: ({ children, className, type, asChild, ...props }: TLUiToolbarToggleGroupProps) => JSX_2.Element;
+
+/** @public @react */
+export declare const TldrawUiToolbarToggleItem: ({ children, className, type, value, tooltip, ...props }: TLUiToolbarToggleItemProps) => JSX_2.Element;
 
 /** @public @react */
-export declare const TldrawUiToolbarToggleItem: ({ children, className, type, value, ...props }: TLUiToolbarToggleItemProps) => JSX_2.Element;
+export declare const TldrawUiTooltip: React_3.ForwardRefExoticComponent<TldrawUiTooltipProps & React_3.RefAttributes<HTMLButtonElement>>;
+
+/** @public */
+export declare interface TldrawUiTooltipProps {
+    children: React_3.ReactNode;
+    content?: React_3.ReactNode | string;
+    side?: 'bottom' | 'left' | 'right' | 'top';
+    sideOffset?: number;
+    disabled?: boolean;
+    showOnMobile?: boolean;
+    delayDuration?: number;
+}
+
+/** @public @react */
+export declare function TldrawUiTooltipProvider({ children }: TldrawUiTooltipProviderProps): JSX_2.Element;
+
+/** @public */
+export declare interface TldrawUiTooltipProviderProps {
+    children: React_3.ReactNode;
+}
 
 /* Excluded from this release type: TldrawUiTranslationProvider */
 
@@ -3219,18 +3510,6 @@ export declare interface TLUiButtonLabelProps {
     children?: ReactNode;
 }
 
-/** @public */
-export declare interface TLUiButtonPickerProps<T extends string> {
-    title: string;
-    uiType: string;
-    style: StyleProp<T>;
-    value: SharedStyle<T>;
-    items: StyleValuesForUi<T>;
-    theme: TLDefaultColorTheme;
-    onValueChange(style: StyleProp<T>, value: T): void;
-    onHistoryMark?(id: string): void;
-}
-
 /** @public */
 export declare interface TLUiButtonProps extends React_2.HTMLAttributes<HTMLButtonElement> {
     disabled?: boolean;
@@ -3265,6 +3544,7 @@ export declare interface TLUiComponents {
     Dialogs?: ComponentType | null;
     Toasts?: ComponentType | null;
     A11y?: ComponentType | null;
+    FollowingIndicator?: ComponentType | null;
 }
 
 /** @public */
@@ -3572,6 +3852,7 @@ export declare interface TLUiEventMap {
     'toggle-lock': null;
     'toggle-reduce-motion': null;
     'toggle-keyboard-shortcuts': null;
+    'toggle-ui-labels': null;
     'toggle-edge-scrolling': null;
     'color-scheme': {
         value: string;
@@ -3589,11 +3870,14 @@ export declare interface TLUiEventMap {
     'flatten-to-image': null;
     'a11y-repeat-shape-announce': null;
     'open-url': {
-        url: string;
+        destinationUrl: string;
     };
     'open-context-menu': null;
     'adjust-shape-styles': null;
     'copy-link': null;
+    'drag-tool': {
+        id: string;
+    };
     'image-replace': null;
     'video-replace': null;
     'open-kbd-shortcuts': null;
@@ -3667,6 +3951,7 @@ export declare interface TLUiInputProps {
     shouldManuallyMaintainScrollPositionWhenFocused?: boolean;
     value?: string;
     'data-testid'?: string;
+    'aria-label'?: string;
 }
 
 /** @public */
@@ -3680,6 +3965,13 @@ export declare type TLUiKeyboardShortcutsDialogProps = TLUiDialogProps & {
     children?: ReactNode;
 };
 
+/** @public */
+export declare interface TLUiLayoutProps extends HTMLAttributes<HTMLDivElement> {
+    children: ReactNode;
+    tooltipSide?: 'bottom' | 'left' | 'right' | 'top';
+    asChild?: boolean;
+}
+
 /** @public */
 export declare interface TLUiMainMenuProps {
     children?: ReactNode;
@@ -3704,6 +3996,7 @@ export declare interface TLUiMenuCheckboxItemProps<TranslationKey extends string
     label?: {
         [key: string]: TranslationKey;
     } | TranslationKey;
+    lang?: string;
     readonlyOk?: boolean;
     onSelect(source: TLUiEventSource): Promise<void> | void;
     toggle?: boolean;
@@ -3719,7 +4012,7 @@ export declare interface TLUiMenuContextProviderProps {
 }
 
 /** @public */
-export declare type TLUiMenuContextType = 'context-menu' | 'helper-buttons' | 'icons' | 'keyboard-shortcuts' | 'menu' | 'panel' | 'small-icons' | 'toolbar-overflow' | 'toolbar';
+export declare type TLUiMenuContextType = 'context-menu' | 'helper-buttons' | 'icons' | 'keyboard-shortcuts' | 'menu' | 'small-icons' | 'toolbar-overflow' | 'toolbar';
 
 /** @public */
 export declare interface TLUiMenuGroupProps<TranslationKey extends string = string> {
@@ -3779,6 +4072,10 @@ export declare interface TLUiMenuItemProps<TranslationKey extends string = strin
      * Whether the item is selected.
      */
     isSelected?: boolean;
+    /**
+     * The function to call when the item is dragged. If this is provided, the item will be draggable.
+     */
+    onDragStart?(source: TLUiEventSource, info: TLPointerEventInfo): void;
 }
 
 /** @public */
@@ -3824,6 +4121,7 @@ export declare interface TLUiPopoverProps {
     open?: boolean;
     children: React_3.ReactNode;
     onOpenChange?(isOpen: boolean): void;
+    className?: string;
 }
 
 /** @public */
@@ -3849,19 +4147,15 @@ export declare interface TLUiSliderProps {
     label: string;
     title: string;
     onValueChange(value: number): void;
-    onHistoryMark(id: string): void;
+    onHistoryMark?(id: string): void;
     'data-testid'?: string;
     ariaValueModifier?: number;
 }
 
-/** @public */
-export declare interface TLUiStylePanelContentProps {
-    styles: ReturnType<typeof useRelevantStyles>;
-}
-
 /** @public */
 export declare interface TLUiStylePanelProps {
     isMobile?: boolean;
+    styles?: null | ReadonlySharedStyleMap;
     children?: ReactNode;
 }
 
@@ -3909,6 +4203,7 @@ export declare interface TLUiToolbarButtonProps extends React_3.HTMLAttributes<H
     disabled?: boolean;
     isActive?: boolean;
     type: 'icon' | 'menu' | 'tool';
+    tooltip?: string;
 }
 
 /** @public */
@@ -3917,6 +4212,8 @@ export declare interface TLUiToolbarProps extends React_3.HTMLAttributes<HTMLDiv
     className?: string;
     dir?: 'ltr' | 'rtl';
     label: string;
+    orientation?: 'grid' | 'horizontal' | 'vertical';
+    tooltipSide?: 'bottom' | 'left' | 'right' | 'top';
 }
 
 /** @public */
@@ -3927,6 +4224,7 @@ export declare interface TLUiToolbarToggleGroupProps extends React_3.HTMLAttribu
     value: any;
     defaultValue?: any;
     type: 'multiple' | 'single';
+    asChild?: boolean;
 }
 
 /** @public */
@@ -3935,6 +4233,7 @@ export declare interface TLUiToolbarToggleItemProps extends React_3.HTMLAttribut
     className?: string;
     type: 'icon' | 'tool';
     value: string;
+    tooltip?: React_3.ReactNode;
 }
 
 /** @public */
@@ -3944,6 +4243,7 @@ export declare interface TLUiToolItem<TranslationKey extends string = string, Ic
     shortcutsLabel?: TranslationKey;
     icon: IconType | TLUiIconJsx;
     onSelect(source: TLUiEventSource): void;
+    onDragStart?(source: TLUiEventSource, info: TLPointerEventInfo): void;
     /**
      * The keyboard shortcut for this tool. This is a string that can be a single key,
      * or a combination of keys.
@@ -3979,7 +4279,7 @@ export declare interface TLUiTranslation {
 export declare type TLUiTranslationContextType = TLUiTranslation;
 
 /** @public */
-export declare type TLUiTranslationKey = 'a11y.adjust-shape-styles' | 'a11y.enlarge-shape' | 'a11y.enter-leave-container' | 'a11y.move-shape-faster' | 'a11y.move-shape' | 'a11y.multiple-shapes' | 'a11y.open-context-menu' | 'a11y.open-keyboard-shortcuts' | 'a11y.pan-camera' | 'a11y.repeat-shape' | 'a11y.rotate-shape-ccw-fine' | 'a11y.rotate-shape-ccw' | 'a11y.rotate-shape-cw-fine' | 'a11y.rotate-shape-cw' | 'a11y.select-shape-direction' | 'a11y.select-shape' | 'a11y.shape-image' | 'a11y.shape-index' | 'a11y.shape-video' | 'a11y.shrink-shape' | 'a11y.skip-to-main-content' | 'a11y.status' | 'action.align-bottom' | 'action.align-center-horizontal.short' | 'action.align-center-horizontal' | 'action.align-center-vertical.short' | 'action.align-center-vertical' | 'action.align-left' | 'action.align-right' | 'action.align-top' | 'action.back-to-content' | 'action.bring-forward' | 'action.bring-to-front' | 'action.convert-to-bookmark' | 'action.convert-to-embed' | 'action.copy-as-png.short' | 'action.copy-as-png' | 'action.copy-as-svg.short' | 'action.copy-as-svg' | 'action.copy' | 'action.cut' | 'action.delete' | 'action.distribute-horizontal.short' | 'action.distribute-horizontal' | 'action.distribute-vertical.short' | 'action.distribute-vertical' | 'action.download-original' | 'action.duplicate' | 'action.edit-link' | 'action.exit-pen-mode' | 'action.export-all-as-png.short' | 'action.export-all-as-png' | 'action.export-all-as-svg.short' | 'action.export-all-as-svg' | 'action.export-as-png.short' | 'action.export-as-png' | 'action.export-as-svg.short' | 'action.export-as-svg' | 'action.fit-frame-to-content' | 'action.flatten-to-image' | 'action.flip-horizontal.short' | 'action.flip-horizontal' | 'action.flip-vertical.short' | 'action.flip-vertical' | 'action.fork-project-on-tldraw' | 'action.fork-project' | 'action.group' | 'action.insert-embed' | 'action.insert-media' | 'action.leave-shared-project' | 'action.new-project' | 'action.new-shared-project' | 'action.open-cursor-chat' | 'action.open-embed-link' | 'action.open-file' | 'action.open-kbd-shortcuts' | 'action.pack' | 'action.paste-error-description' | 'action.paste-error-title' | 'action.paste' | 'action.print' | 'action.redo' | 'action.remove-frame' | 'action.rename' | 'action.rotate-ccw' | 'action.rotate-cw' | 'action.save-copy' | 'action.select-all' | 'action.select-none' | 'action.send-backward' | 'action.send-to-back' | 'action.share-project' | 'action.stack-horizontal.short' | 'action.stack-horizontal' | 'action.stack-vertical.short' | 'action.stack-vertical' | 'action.stop-following' | 'action.stretch-horizontal.short' | 'action.stretch-horizontal' | 'action.stretch-vertical.short' | 'action.stretch-vertical' | 'action.toggle-auto-size' | 'action.toggle-dark-mode.menu' | 'action.toggle-dark-mode' | 'action.toggle-debug-mode.menu' | 'action.toggle-debug-mode' | 'action.toggle-dynamic-size-mode.menu' | 'action.toggle-dynamic-size-mode' | 'action.toggle-edge-scrolling.menu' | 'action.toggle-edge-scrolling' | 'action.toggle-focus-mode.menu' | 'action.toggle-focus-mode' | 'action.toggle-grid.menu' | 'action.toggle-grid' | 'action.toggle-keyboard-shortcuts.menu' | 'action.toggle-keyboard-shortcuts' | 'action.toggle-lock' | 'action.toggle-paste-at-cursor.menu' | 'action.toggle-paste-at-cursor' | 'action.toggle-reduce-motion.menu' | 'action.toggle-reduce-motion' | 'action.toggle-snap-mode.menu' | 'action.toggle-snap-mode' | 'action.toggle-tool-lock.menu' | 'action.toggle-tool-lock' | 'action.toggle-transparent.context-menu' | 'action.toggle-transparent.menu' | 'action.toggle-transparent' | 'action.toggle-wrap-mode.menu' | 'action.toggle-wrap-mode' | 'action.undo' | 'action.ungroup' | 'action.unlock-all' | 'action.zoom-in' | 'action.zoom-out' | 'action.zoom-to-100' | 'action.zoom-to-fit' | 'action.zoom-to-selection' | 'actions-menu.title' | 'align-style.end' | 'align-style.justify' | 'align-style.middle' | 'align-style.start' | 'app.loading' | 'arrow-kind-style.arc' | 'arrow-kind-style.elbow' | 'arrowheadEnd-style.arrow' | 'arrowheadEnd-style.bar' | 'arrowheadEnd-style.diamond' | 'arrowheadEnd-style.dot' | 'arrowheadEnd-style.inverted' | 'arrowheadEnd-style.none' | 'arrowheadEnd-style.pipe' | 'arrowheadEnd-style.square' | 'arrowheadEnd-style.triangle' | 'arrowheadStart-style.arrow' | 'arrowheadStart-style.bar' | 'arrowheadStart-style.diamond' | 'arrowheadStart-style.dot' | 'arrowheadStart-style.inverted' | 'arrowheadStart-style.none' | 'arrowheadStart-style.pipe' | 'arrowheadStart-style.square' | 'arrowheadStart-style.triangle' | 'assets.files.amount-too-many' | 'assets.files.size-too-big' | 'assets.files.type-not-allowed' | 'assets.files.upload-failed' | 'assets.url.failed' | 'color-style.black' | 'color-style.blue' | 'color-style.green' | 'color-style.grey' | 'color-style.light-blue' | 'color-style.light-green' | 'color-style.light-red' | 'color-style.light-violet' | 'color-style.orange' | 'color-style.red' | 'color-style.violet' | 'color-style.white' | 'color-style.yellow' | 'context-menu.arrange' | 'context-menu.copy-as' | 'context-menu.edit' | 'context-menu.export-all-as' | 'context-menu.export-as' | 'context-menu.move-to-page' | 'context-menu.reorder' | 'context-menu.title' | 'context.pages.new-page' | 'cursor-chat.type-to-chat' | 'dash-style.dashed' | 'dash-style.dotted' | 'dash-style.draw' | 'dash-style.solid' | 'document-name-menu.copy-link' | 'document.default-name' | 'edit-link-dialog.cancel' | 'edit-link-dialog.clear' | 'edit-link-dialog.detail' | 'edit-link-dialog.external-link' | 'edit-link-dialog.invalid-url' | 'edit-link-dialog.save' | 'edit-link-dialog.title' | 'edit-link-dialog.url' | 'embed-dialog.back' | 'embed-dialog.cancel' | 'embed-dialog.create' | 'embed-dialog.instruction' | 'embed-dialog.invalid-url' | 'embed-dialog.title' | 'embed-dialog.url' | 'file-system.confirm-clear.cancel' | 'file-system.confirm-clear.continue' | 'file-system.confirm-clear.description' | 'file-system.confirm-clear.dont-show-again' | 'file-system.confirm-clear.title' | 'file-system.confirm-open.cancel' | 'file-system.confirm-open.description' | 'file-system.confirm-open.dont-show-again' | 'file-system.confirm-open.open' | 'file-system.confirm-open.title' | 'file-system.file-open-error.file-format-version-too-new' | 'file-system.file-open-error.generic-corrupted-file' | 'file-system.file-open-error.not-a-tldraw-file' | 'file-system.file-open-error.title' | 'file-system.shared-document-file-open-error.description' | 'file-system.shared-document-file-open-error.title' | 'fill-style.fill' | 'fill-style.none' | 'fill-style.pattern' | 'fill-style.semi' | 'fill-style.solid' | 'focus-mode.toggle-focus-mode' | 'font-style.draw' | 'font-style.mono' | 'font-style.sans' | 'font-style.serif' | 'geo-style.arrow-down' | 'geo-style.arrow-left' | 'geo-style.arrow-right' | 'geo-style.arrow-up' | 'geo-style.check-box' | 'geo-style.cloud' | 'geo-style.diamond' | 'geo-style.ellipse' | 'geo-style.heart' | 'geo-style.hexagon' | 'geo-style.octagon' | 'geo-style.oval' | 'geo-style.pentagon' | 'geo-style.rectangle' | 'geo-style.rhombus' | 'geo-style.star' | 'geo-style.trapezoid' | 'geo-style.triangle' | 'geo-style.x-box' | 'handle.crop.bottom-left' | 'handle.crop.bottom-right' | 'handle.crop.bottom' | 'handle.crop.left' | 'handle.crop.right' | 'handle.crop.top-left' | 'handle.crop.top-right' | 'handle.crop.top' | 'handle.resize-bottom-left' | 'handle.resize-bottom-right' | 'handle.resize-bottom' | 'handle.resize-left' | 'handle.resize-right' | 'handle.resize-top-left' | 'handle.resize-top-right' | 'handle.resize-top' | 'handle.rotate.bottom_left_rotate' | 'handle.rotate.bottom_right_rotate' | 'handle.rotate.mobile_rotate' | 'handle.rotate.top_left_rotate' | 'handle.rotate.top_right_rotate' | 'help-menu.about' | 'help-menu.discord' | 'help-menu.github' | 'help-menu.import-tldr-file' | 'help-menu.keyboard-shortcuts' | 'help-menu.privacy' | 'help-menu.terms' | 'help-menu.title' | 'help-menu.twitter' | 'menu.copy-as' | 'menu.edit' | 'menu.export-as' | 'menu.file' | 'menu.language' | 'menu.preferences' | 'menu.theme' | 'menu.title' | 'menu.view' | 'navigation-zone.minimap' | 'navigation-zone.title' | 'navigation-zone.toggle-minimap' | 'navigation-zone.zoom' | 'opacity-style.0.1' | 'opacity-style.0.25' | 'opacity-style.0.5' | 'opacity-style.0.75' | 'opacity-style.1' | 'page-menu.create-new-page' | 'page-menu.edit-done' | 'page-menu.edit-start' | 'page-menu.go-to-page' | 'page-menu.max-page-count-reached' | 'page-menu.new-page-initial-name' | 'page-menu.submenu.delete' | 'page-menu.submenu.duplicate-page' | 'page-menu.submenu.move-down' | 'page-menu.submenu.move-up' | 'page-menu.submenu.rename' | 'page-menu.submenu.title' | 'page-menu.title' | 'people-menu.anonymous-user' | 'people-menu.avatar-color' | 'people-menu.change-color' | 'people-menu.change-name' | 'people-menu.follow' | 'people-menu.following' | 'people-menu.invite' | 'people-menu.leading' | 'people-menu.title' | 'people-menu.user' | 'share-menu.copied' | 'share-menu.copy-link-note' | 'share-menu.copy-link' | 'share-menu.copy-readonly-link-note' | 'share-menu.copy-readonly-link' | 'share-menu.create-snapshot-link' | 'share-menu.creating-project' | 'share-menu.fork-note' | 'share-menu.offline-note' | 'share-menu.project-too-large' | 'share-menu.save-note' | 'share-menu.share-project' | 'share-menu.snapshot-link-note' | 'share-menu.title' | 'share-menu.upload-failed' | 'sharing.confirm-leave.cancel' | 'sharing.confirm-leave.description' | 'sharing.confirm-leave.dont-show-again' | 'sharing.confirm-leave.leave' | 'sharing.confirm-leave.title' | 'shortcuts-dialog.a11y' | 'shortcuts-dialog.collaboration' | 'shortcuts-dialog.edit' | 'shortcuts-dialog.file' | 'shortcuts-dialog.preferences' | 'shortcuts-dialog.text-formatting' | 'shortcuts-dialog.title' | 'shortcuts-dialog.tools' | 'shortcuts-dialog.transform' | 'shortcuts-dialog.view' | 'size-style.l' | 'size-style.m' | 'size-style.s' | 'size-style.xl' | 'spline-style.cubic' | 'spline-style.line' | 'status.offline' | 'style-panel.align' | 'style-panel.arrow-kind' | 'style-panel.arrowhead-end' | 'style-panel.arrowhead-start' | 'style-panel.arrowheads' | 'style-panel.color' | 'style-panel.dash' | 'style-panel.fill' | 'style-panel.font' | 'style-panel.geo' | 'style-panel.label-align' | 'style-panel.mixed' | 'style-panel.opacity' | 'style-panel.position' | 'style-panel.size' | 'style-panel.spline' | 'style-panel.title' | 'style-panel.vertical-align' | 'theme.dark' | 'theme.light' | 'theme.system' | 'toast.close' | 'toast.error.copy-fail.desc' | 'toast.error.copy-fail.title' | 'toast.error.export-fail.desc' | 'toast.error.export-fail.title' | 'toast.error' | 'toast.info' | 'toast.success' | 'toast.warning' | 'tool-panel.more' | 'tool-panel.title' | 'tool.arrow-down' | 'tool.arrow-left' | 'tool.arrow-right' | 'tool.arrow-up' | 'tool.arrow' | 'tool.aspect-ratio.circle' | 'tool.aspect-ratio.landscape' | 'tool.aspect-ratio.original' | 'tool.aspect-ratio.portrait' | 'tool.aspect-ratio.square' | 'tool.aspect-ratio.wide' | 'tool.aspect-ratio' | 'tool.bookmark' | 'tool.check-box' | 'tool.cloud' | 'tool.diamond' | 'tool.draw' | 'tool.ellipse' | 'tool.embed' | 'tool.eraser' | 'tool.flip-horz' | 'tool.flip-vert' | 'tool.frame' | 'tool.hand' | 'tool.heart' | 'tool.hexagon' | 'tool.highlight' | 'tool.image-crop' | 'tool.image-toolbar-title' | 'tool.image-zoom' | 'tool.laser' | 'tool.line' | 'tool.media-alt-text-confirm' | 'tool.media-alt-text-desc' | 'tool.media-alt-text' | 'tool.media' | 'tool.note' | 'tool.octagon' | 'tool.oval' | 'tool.pentagon' | 'tool.pointer-down' | 'tool.rectangle' | 'tool.replace-media' | 'tool.rhombus' | 'tool.rich-text-bold' | 'tool.rich-text-bulletList' | 'tool.rich-text-code' | 'tool.rich-text-header' | 'tool.rich-text-highlight' | 'tool.rich-text-italic' | 'tool.rich-text-link-remove' | 'tool.rich-text-link-visit' | 'tool.rich-text-link' | 'tool.rich-text-orderedList' | 'tool.rich-text-strikethrough' | 'tool.rich-text-toolbar-title' | 'tool.rotate-cw' | 'tool.select' | 'tool.star' | 'tool.text' | 'tool.trapezoid' | 'tool.triangle' | 'tool.x-box' | 'ui.checked' | 'ui.close' | 'ui.unchecked' | 'verticalAlign-style.end' | 'verticalAlign-style.middle' | 'verticalAlign-style.start' | 'vscode.file-open.backup-failed' | 'vscode.file-open.backup-saved' | 'vscode.file-open.backup' | 'vscode.file-open.desc' | 'vscode.file-open.dont-show-again' | 'vscode.file-open.open';
+export declare type TLUiTranslationKey = 'a11y.adjust-shape-styles' | 'a11y.enlarge-shape' | 'a11y.enter-leave-container' | 'a11y.move-shape-faster' | 'a11y.move-shape' | 'a11y.multiple-shapes' | 'a11y.open-context-menu' | 'a11y.open-keyboard-shortcuts' | 'a11y.pan-camera' | 'a11y.repeat-shape' | 'a11y.rotate-shape-ccw-fine' | 'a11y.rotate-shape-ccw' | 'a11y.rotate-shape-cw-fine' | 'a11y.rotate-shape-cw' | 'a11y.select-shape-direction' | 'a11y.select-shape' | 'a11y.shape-image' | 'a11y.shape-index' | 'a11y.shape-video' | 'a11y.shrink-shape' | 'a11y.skip-to-main-content' | 'a11y.status' | 'action.align-bottom' | 'action.align-center-horizontal.short' | 'action.align-center-horizontal' | 'action.align-center-vertical.short' | 'action.align-center-vertical' | 'action.align-left' | 'action.align-right' | 'action.align-top' | 'action.back-to-content' | 'action.bring-forward' | 'action.bring-to-front' | 'action.convert-to-bookmark' | 'action.convert-to-embed' | 'action.copy-as-png.short' | 'action.copy-as-png' | 'action.copy-as-svg.short' | 'action.copy-as-svg' | 'action.copy' | 'action.cut' | 'action.delete' | 'action.distribute-horizontal.short' | 'action.distribute-horizontal' | 'action.distribute-vertical.short' | 'action.distribute-vertical' | 'action.download-original' | 'action.duplicate' | 'action.edit-link' | 'action.exit-pen-mode' | 'action.export-all-as-png.short' | 'action.export-all-as-png' | 'action.export-all-as-svg.short' | 'action.export-all-as-svg' | 'action.export-as-png.short' | 'action.export-as-png' | 'action.export-as-svg.short' | 'action.export-as-svg' | 'action.fit-frame-to-content' | 'action.flatten-to-image' | 'action.flip-horizontal.short' | 'action.flip-horizontal' | 'action.flip-vertical.short' | 'action.flip-vertical' | 'action.fork-project-on-tldraw' | 'action.fork-project' | 'action.group' | 'action.insert-embed' | 'action.insert-media' | 'action.leave-shared-project' | 'action.new-project' | 'action.new-shared-project' | 'action.open-cursor-chat' | 'action.open-embed-link' | 'action.open-file' | 'action.open-kbd-shortcuts' | 'action.pack' | 'action.paste-error-description' | 'action.paste-error-title' | 'action.paste' | 'action.print' | 'action.redo' | 'action.remove-frame' | 'action.rename' | 'action.rotate-ccw' | 'action.rotate-cw' | 'action.save-copy' | 'action.select-all' | 'action.select-none' | 'action.send-backward' | 'action.send-to-back' | 'action.share-project' | 'action.stack-horizontal.short' | 'action.stack-horizontal' | 'action.stack-vertical.short' | 'action.stack-vertical' | 'action.stop-following' | 'action.stretch-horizontal.short' | 'action.stretch-horizontal' | 'action.stretch-vertical.short' | 'action.stretch-vertical' | 'action.toggle-auto-size' | 'action.toggle-dark-mode.menu' | 'action.toggle-dark-mode' | 'action.toggle-debug-mode.menu' | 'action.toggle-debug-mode' | 'action.toggle-dynamic-size-mode.menu' | 'action.toggle-dynamic-size-mode' | 'action.toggle-edge-scrolling.menu' | 'action.toggle-edge-scrolling' | 'action.toggle-focus-mode.menu' | 'action.toggle-focus-mode' | 'action.toggle-grid.menu' | 'action.toggle-grid' | 'action.toggle-keyboard-shortcuts.menu' | 'action.toggle-keyboard-shortcuts' | 'action.toggle-lock' | 'action.toggle-paste-at-cursor.menu' | 'action.toggle-paste-at-cursor' | 'action.toggle-reduce-motion.menu' | 'action.toggle-reduce-motion' | 'action.toggle-snap-mode.menu' | 'action.toggle-snap-mode' | 'action.toggle-tool-lock.menu' | 'action.toggle-tool-lock' | 'action.toggle-transparent.context-menu' | 'action.toggle-transparent.menu' | 'action.toggle-transparent' | 'action.toggle-ui-labels.menu' | 'action.toggle-ui-labels' | 'action.toggle-wrap-mode.menu' | 'action.toggle-wrap-mode' | 'action.undo' | 'action.ungroup' | 'action.unlock-all' | 'action.zoom-in' | 'action.zoom-out' | 'action.zoom-to-100' | 'action.zoom-to-fit' | 'action.zoom-to-selection' | 'actions-menu.title' | 'align-style.end' | 'align-style.justify' | 'align-style.middle' | 'align-style.start' | 'app.loading' | 'arrow-kind-style.arc' | 'arrow-kind-style.elbow' | 'arrowheadEnd-style.arrow' | 'arrowheadEnd-style.bar' | 'arrowheadEnd-style.diamond' | 'arrowheadEnd-style.dot' | 'arrowheadEnd-style.inverted' | 'arrowheadEnd-style.none' | 'arrowheadEnd-style.pipe' | 'arrowheadEnd-style.square' | 'arrowheadEnd-style.triangle' | 'arrowheadStart-style.arrow' | 'arrowheadStart-style.bar' | 'arrowheadStart-style.diamond' | 'arrowheadStart-style.dot' | 'arrowheadStart-style.inverted' | 'arrowheadStart-style.none' | 'arrowheadStart-style.pipe' | 'arrowheadStart-style.square' | 'arrowheadStart-style.triangle' | 'assets.files.amount-too-many' | 'assets.files.maximum-size' | 'assets.files.size-too-big' | 'assets.files.type-not-allowed' | 'assets.files.upload-failed' | 'assets.url.failed' | 'color-style.black' | 'color-style.blue' | 'color-style.green' | 'color-style.grey' | 'color-style.light-blue' | 'color-style.light-green' | 'color-style.light-red' | 'color-style.light-violet' | 'color-style.orange' | 'color-style.red' | 'color-style.violet' | 'color-style.white' | 'color-style.yellow' | 'context-menu.arrange' | 'context-menu.copy-as' | 'context-menu.edit' | 'context-menu.export-all-as' | 'context-menu.export-as' | 'context-menu.move-to-page' | 'context-menu.reorder' | 'context-menu.title' | 'context.pages.new-page' | 'cursor-chat.type-to-chat' | 'dash-style.dashed' | 'dash-style.dotted' | 'dash-style.draw' | 'dash-style.solid' | 'document-name-menu.copy-link' | 'document.default-name' | 'edit-link-dialog.cancel' | 'edit-link-dialog.clear' | 'edit-link-dialog.detail' | 'edit-link-dialog.external-link' | 'edit-link-dialog.invalid-url' | 'edit-link-dialog.save' | 'edit-link-dialog.title' | 'edit-link-dialog.url' | 'embed-dialog.back' | 'embed-dialog.cancel' | 'embed-dialog.create' | 'embed-dialog.instruction' | 'embed-dialog.invalid-url' | 'embed-dialog.title' | 'embed-dialog.url' | 'file-system.confirm-clear.cancel' | 'file-system.confirm-clear.continue' | 'file-system.confirm-clear.description' | 'file-system.confirm-clear.dont-show-again' | 'file-system.confirm-clear.title' | 'file-system.confirm-open.cancel' | 'file-system.confirm-open.description' | 'file-system.confirm-open.dont-show-again' | 'file-system.confirm-open.open' | 'file-system.confirm-open.title' | 'file-system.file-open-error.file-format-version-too-new' | 'file-system.file-open-error.generic-corrupted-file' | 'file-system.file-open-error.not-a-tldraw-file' | 'file-system.file-open-error.title' | 'file-system.shared-document-file-open-error.description' | 'file-system.shared-document-file-open-error.title' | 'fill-style.fill' | 'fill-style.none' | 'fill-style.pattern' | 'fill-style.semi' | 'fill-style.solid' | 'focus-mode.toggle-focus-mode' | 'font-style.draw' | 'font-style.mono' | 'font-style.sans' | 'font-style.serif' | 'geo-style.arrow-down' | 'geo-style.arrow-left' | 'geo-style.arrow-right' | 'geo-style.arrow-up' | 'geo-style.check-box' | 'geo-style.cloud' | 'geo-style.diamond' | 'geo-style.ellipse' | 'geo-style.heart' | 'geo-style.hexagon' | 'geo-style.octagon' | 'geo-style.oval' | 'geo-style.pentagon' | 'geo-style.rectangle' | 'geo-style.rhombus-2' | 'geo-style.rhombus' | 'geo-style.star' | 'geo-style.trapezoid' | 'geo-style.triangle' | 'geo-style.x-box' | 'handle.crop.bottom-left' | 'handle.crop.bottom-right' | 'handle.crop.bottom' | 'handle.crop.left' | 'handle.crop.right' | 'handle.crop.top-left' | 'handle.crop.top-right' | 'handle.crop.top' | 'handle.resize-bottom-left' | 'handle.resize-bottom-right' | 'handle.resize-bottom' | 'handle.resize-left' | 'handle.resize-right' | 'handle.resize-top-left' | 'handle.resize-top-right' | 'handle.resize-top' | 'handle.rotate.bottom_left_rotate' | 'handle.rotate.bottom_right_rotate' | 'handle.rotate.mobile_rotate' | 'handle.rotate.top_left_rotate' | 'handle.rotate.top_right_rotate' | 'help-menu.about' | 'help-menu.discord' | 'help-menu.github' | 'help-menu.import-tldr-file' | 'help-menu.keyboard-shortcuts' | 'help-menu.privacy' | 'help-menu.terms' | 'help-menu.title' | 'help-menu.twitter' | 'menu.accessibility' | 'menu.copy-as' | 'menu.edit' | 'menu.export-as' | 'menu.file' | 'menu.language' | 'menu.preferences' | 'menu.theme' | 'menu.title' | 'menu.view' | 'navigation-zone.minimap' | 'navigation-zone.title' | 'navigation-zone.toggle-minimap' | 'navigation-zone.zoom' | 'opacity-style.0.1' | 'opacity-style.0.25' | 'opacity-style.0.5' | 'opacity-style.0.75' | 'opacity-style.1' | 'page-menu.create-new-page' | 'page-menu.edit-done' | 'page-menu.edit-start' | 'page-menu.go-to-page' | 'page-menu.max-page-count-reached' | 'page-menu.new-page-initial-name' | 'page-menu.submenu.delete' | 'page-menu.submenu.duplicate-page' | 'page-menu.submenu.move-down' | 'page-menu.submenu.move-up' | 'page-menu.submenu.rename' | 'page-menu.submenu.title' | 'page-menu.title' | 'people-menu.anonymous-user' | 'people-menu.avatar-color' | 'people-menu.change-color' | 'people-menu.change-name' | 'people-menu.follow' | 'people-menu.following' | 'people-menu.invite' | 'people-menu.leading' | 'people-menu.title' | 'people-menu.user' | 'share-menu.copied' | 'share-menu.copy-link-note' | 'share-menu.copy-link' | 'share-menu.copy-readonly-link-note' | 'share-menu.copy-readonly-link' | 'share-menu.create-snapshot-link' | 'share-menu.creating-project' | 'share-menu.fork-note' | 'share-menu.offline-note' | 'share-menu.project-too-large' | 'share-menu.save-note' | 'share-menu.share-project' | 'share-menu.snapshot-link-note' | 'share-menu.title' | 'share-menu.upload-failed' | 'sharing.confirm-leave.cancel' | 'sharing.confirm-leave.description' | 'sharing.confirm-leave.dont-show-again' | 'sharing.confirm-leave.leave' | 'sharing.confirm-leave.title' | 'shortcuts-dialog.a11y' | 'shortcuts-dialog.collaboration' | 'shortcuts-dialog.edit' | 'shortcuts-dialog.file' | 'shortcuts-dialog.preferences' | 'shortcuts-dialog.text-formatting' | 'shortcuts-dialog.title' | 'shortcuts-dialog.tools' | 'shortcuts-dialog.transform' | 'shortcuts-dialog.view' | 'size-style.l' | 'size-style.m' | 'size-style.s' | 'size-style.xl' | 'spline-style.cubic' | 'spline-style.line' | 'status.offline' | 'style-panel.align' | 'style-panel.arrow-kind' | 'style-panel.arrowhead-end' | 'style-panel.arrowhead-start' | 'style-panel.arrowheads' | 'style-panel.color' | 'style-panel.dash' | 'style-panel.fill' | 'style-panel.font' | 'style-panel.geo' | 'style-panel.label-align' | 'style-panel.mixed' | 'style-panel.opacity' | 'style-panel.position' | 'style-panel.selected' | 'style-panel.size' | 'style-panel.spline' | 'style-panel.title' | 'style-panel.vertical-align' | 'theme.dark' | 'theme.light' | 'theme.system' | 'toast.close' | 'toast.error.copy-fail.desc' | 'toast.error.copy-fail.title' | 'toast.error.export-fail.desc' | 'toast.error.export-fail.title' | 'toast.error' | 'toast.info' | 'toast.success' | 'toast.warning' | 'tool-panel.more' | 'tool-panel.title' | 'tool.arrow-down' | 'tool.arrow-left' | 'tool.arrow-right' | 'tool.arrow-up' | 'tool.arrow' | 'tool.aspect-ratio.circle' | 'tool.aspect-ratio.landscape' | 'tool.aspect-ratio.original' | 'tool.aspect-ratio.portrait' | 'tool.aspect-ratio.square' | 'tool.aspect-ratio.wide' | 'tool.aspect-ratio' | 'tool.bookmark' | 'tool.check-box' | 'tool.cloud' | 'tool.diamond' | 'tool.draw' | 'tool.ellipse' | 'tool.embed' | 'tool.eraser' | 'tool.flip-horz' | 'tool.flip-vert' | 'tool.frame' | 'tool.hand' | 'tool.heart' | 'tool.hexagon' | 'tool.highlight' | 'tool.image-crop-confirm' | 'tool.image-crop' | 'tool.image-toolbar-title' | 'tool.image-zoom' | 'tool.laser' | 'tool.line' | 'tool.media-alt-text-confirm' | 'tool.media-alt-text-desc' | 'tool.media-alt-text' | 'tool.media' | 'tool.note' | 'tool.octagon' | 'tool.oval' | 'tool.pentagon' | 'tool.pointer-down' | 'tool.rectangle' | 'tool.replace-media' | 'tool.rhombus' | 'tool.rich-text-bold' | 'tool.rich-text-bulletList' | 'tool.rich-text-code' | 'tool.rich-text-header' | 'tool.rich-text-highlight' | 'tool.rich-text-italic' | 'tool.rich-text-link-remove' | 'tool.rich-text-link-visit' | 'tool.rich-text-link' | 'tool.rich-text-orderedList' | 'tool.rich-text-strikethrough' | 'tool.rich-text-toolbar-title' | 'tool.rotate-cw' | 'tool.select' | 'tool.star' | 'tool.text' | 'tool.trapezoid' | 'tool.triangle' | 'tool.x-box' | 'ui.checked' | 'ui.close' | 'ui.unchecked' | 'verticalAlign-style.end' | 'verticalAlign-style.middle' | 'verticalAlign-style.start' | 'vscode.file-open.backup-failed' | 'vscode.file-open.backup-saved' | 'vscode.file-open.backup' | 'vscode.file-open.desc' | 'vscode.file-open.dont-show-again' | 'vscode.file-open.open';
 
 /** @public */
 export declare interface TLUiTranslationProviderProps {
@@ -4120,6 +4420,9 @@ export declare function ToggleToolLockItem(): JSX_2.Element;
 /** @public @react */
 export declare function ToggleTransparentBgMenuItem(): JSX_2.Element;
 
+/** @public @react */
+export declare function ToggleUiLabelsItem(): JSX_2.Element;
+
 /** @public @react */
 export declare function ToggleWrapModeItem(): JSX_2.Element;
 
@@ -4152,18 +4455,34 @@ export declare function UnlockAllMenuItem(): JSX_2.Element;
 /** @public */
 export declare function unwrapLabel(label?: TLUiActionItem['label'], menuType?: string): string | undefined;
 
-/** @public */
-export declare function useA11y(): TLUiA11yContextType;
-
-/** @public */
-export declare function useActions(): TLUiActionsContextType;
+/**
+ * Update the current arrow target state for an editor. See {@link ArrowTargetState} for more
+ * information.
+ *
+ * @public
+ */
+export declare function updateArrowTargetState({ editor, pointInPageSpace, arrow, isPrecise, currentBinding, oppositeBinding, }: UpdateArrowTargetStateOpts): ArrowTargetState | null;
 
 /**
- * @deprecated Use {@link useImageOrVideoAsset} instead.
+ * Options passed to {@link updateArrowTargetState}.
  *
  * @public
  */
-export declare const useAsset: typeof useImageOrVideoAsset;
+export declare interface UpdateArrowTargetStateOpts {
+    editor: Editor;
+    pointInPageSpace: VecLike;
+    arrow: TLArrowShape | undefined;
+    isPrecise: boolean;
+    currentBinding: TLArrowBinding | undefined;
+    /** The binding from the opposite end of the arrow, if one exists. */
+    oppositeBinding: TLArrowBinding | undefined;
+}
+
+/** @public */
+export declare function useA11y(): TLUiA11yContextType;
+
+/** @public */
+export declare function useActions(): TLUiActionsContextType;
 
 /* Excluded from this release type: useAssetUrls */
 
@@ -4219,7 +4538,11 @@ export declare function useDefaultHelpers(): {
     copy: (source: TLUiEventSource) => Promise<void>;
     copyAs: (ids: TLShapeId[], format?: TLCopyType) => void;
     cut: (source: TLUiEventSource) => Promise<void>;
-    exportAs: (ids: TLShapeId[], format: TLExportType | undefined, name: string | undefined) => void;
+    exportAs: (ids: TLShapeId[], opts?: {
+        format?: TLExportType;
+        name?: string;
+        scale?: number;
+    }) => void;
     getEmbedDefinition: (url: string) => TLEmbedResult;
     insertMedia: () => Promise<void>;
     isMobile: boolean;
@@ -4241,7 +4564,9 @@ export declare function useEditablePlainText(shapeId: TLShapeId, type: string, t
     handleChange: ({ plaintext }: {
         plaintext: string;
     }) => void;
-    handleDoubleClick: (e: any) => any;
+    handleDoubleClick: (e: {
+        nativeEvent: Event;
+    } | Event) => void;
     handleFocus: () => void;
     handleInputPointerDown: (e: React_3.PointerEvent) => void;
     handleKeyDown: (e: KeyboardEvent) => void;
@@ -4258,7 +4583,9 @@ export declare function useEditableRichText(shapeId: TLShapeId, type: string, ri
     handleChange: ({ richText }: {
         richText: TLRichText;
     }) => void;
-    handleDoubleClick: (e: any) => any;
+    handleDoubleClick: (e: {
+        nativeEvent: Event;
+    } | Event) => void;
     handleFocus: () => void;
     handleInputPointerDown: (e: React.PointerEvent) => void;
     handleKeyDown: (e: KeyboardEvent) => void;
@@ -4269,14 +4596,12 @@ export declare function useEditableRichText(shapeId: TLShapeId, type: string, ri
     rInput: RefObject<HTMLDivElement>;
 };
 
-/**
- * @deprecated Use `useEditablePlainText` instead.
- * @public
- */
-export declare const useEditableText: typeof useEditablePlainText;
-
 /** @public */
-export declare function useExportAs(): (ids: TLShapeId[], format: TLExportType | undefined, name: string | undefined) => void;
+export declare function useExportAs(): (ids: TLShapeId[], opts?: {
+    format?: TLExportType;
+    name?: string;
+    scale?: number;
+}) => void;
 
 /**
  * This is a handy helper hook that resolves an asset to an optimized URL for a given shape, or its
@@ -4350,9 +4675,15 @@ export declare const useSelectedShapesAnnouncer: () => void;
 /** @public */
 export declare function useShowCollaborationUi(): boolean;
 
+/** @public */
+export declare function useStylePanelContext(): StylePanelContext;
+
 /** @public */
 export declare function useTldrawUiComponents(): TLUiComponents;
 
+/** @public */
+export declare function useTldrawUiOrientation(): TldrawUiOrientationContext;
+
 /** @public */
 export declare function useToasts(): TLUiToastsContextType;