@dwelle/excalidraw 0.5.0-e6263588 → 0.5.0-e9944c4

package/dist/types/excalidraw/actions/actionToggleSearchMenu.d.ts

@@ -36,6 +36,7 @@ export declare const actionToggleSearchMenu: {
             boxSelectionMode: import("../types").BoxSelectionMode;
             bindingPreference: "enabled" | "disabled";
             isMidpointSnappingEnabled: boolean;
+            inputDevice: import("../types").InputDevice;
             suggestedBinding: {
                 element: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawBindableElement>;
                 midPoint?: import("@excalidraw/math").GlobalPoint;
@@ -70,6 +71,8 @@ export declare const actionToggleSearchMenu: {
             exportWithDarkMode: boolean;
             exportScale: number;
             currentItemStrokeColor: string;
+            currentItemStickynoteStrokeColor: string;
+            currentItemStickynoteBackgroundColor: string;
             currentItemBackgroundColor: string;
             currentItemFillStyle: import("@excalidraw/element/types").ExcalidrawElement["fillStyle"];
             currentItemStrokeWidthKey: import("@excalidraw/common").StrokeWidthKey;
@@ -143,8 +146,6 @@ export declare const actionToggleSearchMenu: {
                 y: number;
             } | null;
             objectsSnapModeEnabled: boolean;
-            userToFollow: import("../types").UserToFollow | null;
-            followedBy: Set<import("../types").SocketId>;
             isCropping: boolean;
             croppingElementId: import("@excalidraw/element/types").ExcalidrawElement["id"] | null;
             searchMatches: Readonly<{
@@ -156,6 +157,13 @@ export declare const actionToggleSearchMenu: {
                 [groupId: string]: true;
             };
             bindMode: import("@excalidraw/element/types").BindMode;
+            colorTopPicks: {
+                elementStroke: readonly string[] | null;
+                elementBackground: readonly string[] | null;
+                bucketFill: readonly string[] | null;
+                stickyNoteStroke: readonly string[] | null;
+                stickyNoteBackground: readonly string[] | null;
+            };
         };
         captureUpdate: "EVENTUALLY";
     };

package/dist/types/excalidraw/actions/actionToggleStats.d.ts

@@ -33,6 +33,7 @@ export declare const actionToggleStats: {
             boxSelectionMode: import("../types").BoxSelectionMode;
             bindingPreference: "enabled" | "disabled";
             isMidpointSnappingEnabled: boolean;
+            inputDevice: import("../types").InputDevice;
             suggestedBinding: {
                 element: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawBindableElement>;
                 midPoint?: import("@excalidraw/math").GlobalPoint;
@@ -67,6 +68,8 @@ export declare const actionToggleStats: {
             exportWithDarkMode: boolean;
             exportScale: number;
             currentItemStrokeColor: string;
+            currentItemStickynoteStrokeColor: string;
+            currentItemStickynoteBackgroundColor: string;
             currentItemBackgroundColor: string;
             currentItemFillStyle: import("@excalidraw/element/types").ExcalidrawElement["fillStyle"];
             currentItemStrokeWidthKey: import("@excalidraw/common").StrokeWidthKey;
@@ -157,8 +160,6 @@ export declare const actionToggleStats: {
                 y: number;
             } | null;
             objectsSnapModeEnabled: boolean;
-            userToFollow: import("../types").UserToFollow | null;
-            followedBy: Set<import("../types").SocketId>;
             isCropping: boolean;
             croppingElementId: import("@excalidraw/element/types").ExcalidrawElement["id"] | null;
             searchMatches: Readonly<{
@@ -170,6 +171,13 @@ export declare const actionToggleStats: {
                 [groupId: string]: true;
             };
             bindMode: import("@excalidraw/element/types").BindMode;
+            colorTopPicks: {
+                elementStroke: readonly string[] | null;
+                elementBackground: readonly string[] | null;
+                bucketFill: readonly string[] | null;
+                stickyNoteStroke: readonly string[] | null;
+                stickyNoteBackground: readonly string[] | null;
+            };
         };
         captureUpdate: "EVENTUALLY";
     };

package/dist/types/excalidraw/actions/actionToggleViewMode.d.ts

@@ -30,6 +30,7 @@ export declare const actionToggleViewMode: {
             boxSelectionMode: import("../types").BoxSelectionMode;
             bindingPreference: "enabled" | "disabled";
             isMidpointSnappingEnabled: boolean;
+            inputDevice: import("../types").InputDevice;
             suggestedBinding: {
                 element: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawBindableElement>;
                 midPoint?: import("@excalidraw/math").GlobalPoint;
@@ -64,6 +65,8 @@ export declare const actionToggleViewMode: {
             exportWithDarkMode: boolean;
             exportScale: number;
             currentItemStrokeColor: string;
+            currentItemStickynoteStrokeColor: string;
+            currentItemStickynoteBackgroundColor: string;
             currentItemBackgroundColor: string;
             currentItemFillStyle: import("@excalidraw/element/types").ExcalidrawElement["fillStyle"];
             currentItemStrokeWidthKey: import("@excalidraw/common").StrokeWidthKey;
@@ -157,8 +160,6 @@ export declare const actionToggleViewMode: {
                 y: number;
             } | null;
             objectsSnapModeEnabled: boolean;
-            userToFollow: import("../types").UserToFollow | null;
-            followedBy: Set<import("../types").SocketId>;
             isCropping: boolean;
             croppingElementId: import("@excalidraw/element/types").ExcalidrawElement["id"] | null;
             searchMatches: Readonly<{
@@ -170,6 +171,13 @@ export declare const actionToggleViewMode: {
                 [groupId: string]: true;
             };
             bindMode: import("@excalidraw/element/types").BindMode;
+            colorTopPicks: {
+                elementStroke: readonly string[] | null;
+                elementBackground: readonly string[] | null;
+                bucketFill: readonly string[] | null;
+                stickyNoteStroke: readonly string[] | null;
+                stickyNoteBackground: readonly string[] | null;
+            };
         };
         captureUpdate: "EVENTUALLY";
     };

package/dist/types/excalidraw/actions/actionToggleZenMode.d.ts

@@ -30,6 +30,7 @@ export declare const actionToggleZenMode: {
             boxSelectionMode: import("../types").BoxSelectionMode;
             bindingPreference: "enabled" | "disabled";
             isMidpointSnappingEnabled: boolean;
+            inputDevice: import("../types").InputDevice;
             suggestedBinding: {
                 element: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawBindableElement>;
                 midPoint?: import("@excalidraw/math").GlobalPoint;
@@ -64,6 +65,8 @@ export declare const actionToggleZenMode: {
             exportWithDarkMode: boolean;
             exportScale: number;
             currentItemStrokeColor: string;
+            currentItemStickynoteStrokeColor: string;
+            currentItemStickynoteBackgroundColor: string;
             currentItemBackgroundColor: string;
             currentItemFillStyle: import("@excalidraw/element/types").ExcalidrawElement["fillStyle"];
             currentItemStrokeWidthKey: import("@excalidraw/common").StrokeWidthKey;
@@ -157,8 +160,6 @@ export declare const actionToggleZenMode: {
                 y: number;
             } | null;
             objectsSnapModeEnabled: boolean;
-            userToFollow: import("../types").UserToFollow | null;
-            followedBy: Set<import("../types").SocketId>;
             isCropping: boolean;
             croppingElementId: import("@excalidraw/element/types").ExcalidrawElement["id"] | null;
             searchMatches: Readonly<{
@@ -170,6 +171,13 @@ export declare const actionToggleZenMode: {
                 [groupId: string]: true;
             };
             bindMode: import("@excalidraw/element/types").BindMode;
+            colorTopPicks: {
+                elementStroke: readonly string[] | null;
+                elementBackground: readonly string[] | null;
+                bucketFill: readonly string[] | null;
+                stickyNoteStroke: readonly string[] | null;
+                stickyNoteBackground: readonly string[] | null;
+            };
         };
         captureUpdate: "EVENTUALLY";
     };

package/dist/types/excalidraw/actions/colorTargets.d.ts

@@ -0,0 +1,39 @@
+import type { ColorPaletteCustom, ColorTuple } from "@excalidraw/common";
+import type { ExcalidrawElement } from "@excalidraw/element/types";
+import type { AppState } from "../types";
+export type ColorProperty = "strokeColor" | "backgroundColor";
+/**
+ * Sticky notes are their own color domain: own defaults, own top picks, no
+ * transparent. A pick targets the regular domain, the sticky domain, or both
+ * ("mixed" selections write both defaults and use the regular picker).
+ */
+export type ColorTargetKind = "regular" | "sticky" | "mixed";
+export type ColorDefaultKey = "currentItemStrokeColor" | "currentItemBackgroundColor" | "currentItemStickynoteStrokeColor" | "currentItemStickynoteBackgroundColor";
+export type ColorTargetAppState = Pick<AppState, "selectedElementIds" | "editingTextElement" | "activeTool" | ColorDefaultKey>;
+export type ColorTarget = {
+    kind: ColorTargetKind;
+    property: ColorProperty;
+    /** the current-item defaults a pick is written to (normalized per domain) */
+    appStateKeys: readonly ColorDefaultKey[];
+    /** the default shown when no element is targeted */
+    currentValue: string;
+    palette: ColorPaletteCustom;
+    topPicks: ColorTuple;
+    customizableTopPicks: keyof AppState["colorTopPicks"];
+    excludedColors: readonly string[] | undefined;
+};
+/**
+ * Who a stroke/background pick targets. Resolve it from the state an action
+ * runs against, at execution time — never capture it in a render closure:
+ * the memoized picker keeps a stale `onChange`, and the always-visible top
+ * picks fire it without a re-render.
+ *
+ * Targets are the selected color-capable elements (for stroke incl. bound
+ * labels, since a note's visible text is its label) plus the text being
+ * edited (`handleTextWysiwyg` deselects while editing) — or, for a
+ * background pick on a note's label, the note (see `getColorTargetElement`).
+ * With no target, the active tool decides the domain.
+ */
+export declare const resolveColorTarget: (appState: ColorTargetAppState, elements: readonly ExcalidrawElement[], property: ColorProperty) => ColorTarget;
+/** the current-item default updates for a picked color */
+export declare const getColorTargetAppStateUpdates: (target: ColorTarget, color: string) => Partial<AppState>;

package/dist/types/excalidraw/appState.d.ts

@@ -1,4 +1,4 @@
-import type { AppState } from "./types";
+import type { AppState, InputDevice } from "./types";
 export declare const getDefaultAppState: () => Omit<AppState, "offsetTop" | "offsetLeft" | "width" | "height">;
 export declare const clearAppStateForLocalStorage: (appState: Partial<AppState>) => {
     theme?: import("@excalidraw/element/types").Theme | undefined;
@@ -34,6 +34,7 @@ export declare const clearAppStateForLocalStorage: (appState: Partial<AppState>)
     showWelcomeScreen?: boolean | undefined;
     boxSelectionMode?: import("./types").BoxSelectionMode | undefined;
     bindingPreference?: "enabled" | "disabled" | undefined;
+    inputDevice?: InputDevice | undefined;
     preferredSelectionTool?: {
         type: "selection" | "lasso";
         initialized: boolean;
@@ -44,6 +45,8 @@ export declare const clearAppStateForLocalStorage: (appState: Partial<AppState>)
     exportEmbedScene?: boolean | undefined;
     exportWithDarkMode?: boolean | undefined;
     currentItemStrokeColor?: string | undefined;
+    currentItemStickynoteStrokeColor?: string | undefined;
+    currentItemStickynoteBackgroundColor?: string | undefined;
     currentItemBackgroundColor?: string | undefined;
     currentItemFillStyle?: import("@excalidraw/element/types").FillStyle | undefined;
     currentItemStrokeWidthKey?: import("@excalidraw/common").StrokeWidthKey | undefined;
@@ -78,6 +81,13 @@ export declare const clearAppStateForLocalStorage: (appState: Partial<AppState>)
     lockedMultiSelections?: {
         [groupId: string]: true;
     } | undefined;
+    colorTopPicks?: {
+        elementStroke: readonly string[] | null;
+        elementBackground: readonly string[] | null;
+        bucketFill: readonly string[] | null;
+        stickyNoteStroke: readonly string[] | null;
+        stickyNoteBackground: readonly string[] | null;
+    } | undefined;
 };
 export declare const cleanAppStateForExport: (appState: Partial<AppState>) => {
     viewBackgroundColor?: string | undefined;
@@ -103,3 +113,13 @@ export declare const isEraserActive: ({ activeTool, }: {
 export declare const isHandToolActive: ({ activeTool, }: {
     activeTool: AppState["activeTool"];
 }) => boolean;
+/**
+ * The device the wheel mappings follow for the given preference.
+ *
+ * `auto` is meant to detect the device from the wheel events themselves
+ * (line vs. pixel delta modes, whole vs. fractional deltas, one vs. two axes
+ * moving, event cadence and momentum tails). That is not implemented yet, so
+ * it resolves to `trackpad` — the mapping the editor has always had, and the
+ * default to keep until detection exists.
+ */
+export declare const resolveInputDevice: (inputDevice: InputDevice) => Exclude<InputDevice, "auto">;

package/dist/types/excalidraw/components/App.arrowText.d.ts

@@ -1,15 +1,23 @@
+import { LinearElementEditor } from "@excalidraw/element";
 import type { ArrowEndpoint } from "@excalidraw/element";
-import type { ExcalidrawElement, ExcalidrawTextElement, FixedPoint, NonDeleted } from "@excalidraw/element/types";
+import type { ExcalidrawElement, ExcalidrawTextElement, FixedPoint, NonDeleted, NonDeletedExcalidrawElement } from "@excalidraw/element/types";
 import type App from "./App";
-import type { AppState } from "../types";
+import type { AppState, PointerDownState } from "../types";
 /**
- * The text tool's interaction with arrows: the hover affordance showing where
- * a click would attach text to an arrow — a free endpoint (binds the arrow to
- * a new text element positioned against that endpoint) or the arrow's midpoint
- * (adds a label bound to the arrow) — and the endpoint-bound flavor of
- * drag-sizing a new text.
+ * Text ↔ arrow interactions.
  *
- * The scene-level logic lives in `@excalidraw/element`'s `arrowEndpointText.ts`.
+ * With the text tool: the hover affordance showing where a click would attach
+ * text to an arrow — a free endpoint (binds the arrow to a new text element
+ * positioned against that endpoint) or the arrow's midpoint (adds a label
+ * bound to the arrow) — and the endpoint-bound flavor of drag-sizing a new
+ * text.
+ *
+ * With the selection tool: dragging an arrow's existing label along the arrow
+ * — the grab affordance, the drag itself, and where a double-click starts
+ * editing a label the drag has moved.
+ *
+ * The scene-level logic lives in `@excalidraw/element`'s
+ * `arrowEndpointText.ts` and `linearElementEditor.ts`.
  */
 export declare class AppArrowText {
     private app;
@@ -69,4 +77,28 @@ export declare class AppArrowText {
         x: number;
         y: number;
     }): boolean;
+    /**
+     * Whether the arrow's label is what a grab at this position would pick up:
+     * the pointer is over the label, and no element stacked above the arrow
+     * owns the hit instead.
+     */
+    isBoundTextGrabbable(element: NonDeletedExcalidrawElement, x: number, y: number): boolean;
+    /**
+     * The pointer-move half of dragging a label along its arrow. Owns the move
+     * whenever the gesture started on the label (`pointerDownState.hit.arrowLabel`),
+     * dragging only once past the threshold. Returns whether it owned it.
+     */
+    maybeDragLabel(linearElementEditor: LinearElementEditor, pointerDownState: PointerDownState, pointerCoords: {
+        x: number;
+        y: number;
+    }): boolean;
+    /**
+     * Where a double-click on a labeled arrow should start text editing: the
+     * center of the label itself, which a label drag may have moved away from
+     * the arrow's midpoint. Null when the element is not a labeled arrow.
+     */
+    getLabelCenter(element: ExcalidrawElement): {
+        x: number;
+        y: number;
+    } | null;
 }

package/dist/types/excalidraw/components/App.bucketFill.d.ts

@@ -1,3 +1,4 @@
+import type { Theme } from "@excalidraw/element/types";
 import type App from "./App";
 type ScenePoint = {
     x: number;
@@ -7,6 +8,7 @@ type ScenePoint = {
 export declare class AppBucketFill {
     private app;
     constructor(app: App);
+    private temporaryEyeDropper;
     /**
      * The click armed on pointer down, committed on pointer up. Deferring the
      * scene mutation to pointer up is what lets a pinch/pan second finger, a
@@ -24,11 +26,23 @@ export declare class AppBucketFill {
     handlePointerUp: () => void;
     /** Abort the armed fill (second finger, context menu, pointercancel). */
     cancel: () => void;
+    cycleBackgroundColor: () => void;
+    openTemporaryEyeDropper: () => void;
+    closeTemporaryEyeDropper: () => void;
     /**
      * Apply the current bucket fill settings to an existing fill-compatible
      * element (no-op when nothing would change). One undoable step.
      */
     private restyle;
     private fill;
+    /**
+     * The color the bucket fill tool actually fills with: the shared
+     * `currentItemBackgroundColor`, falling back to green when that is
+     * transparent (the tool's picker doesn't offer transparent, but the shared
+     * state can hold it from the generic shape picker).
+     */
+    getBucketFillBackgroundColor: (backgroundColor: string, 
+    /** supply only for display purposes such as when applying to the cursor */
+    theme?: Theme) => string;
 }
 export {};

package/dist/types/excalidraw/components/App.cursor.d.ts

@@ -1,5 +1,5 @@
-import type App from "./App";
 import type { AppState } from "../types";
+import type App from "./App";
 /**
  * Captures all cursor management for the interactive canvas.
  *
@@ -10,10 +10,9 @@ import type { AppState } from "../types";
  */
 export declare class AppCursor {
     private app;
+    private toolCursorMemo;
     private eraserCanvasCache;
     private eraserPreviewDataURL;
-    private drawShapeCanvasCache;
-    private drawShapePreviewDataURL;
     constructor(app: App);
     private get canvas();
     set: (cursor: string) => void;
@@ -25,6 +24,14 @@ export declare class AppCursor {
     reset: () => void;
     /** applies the given tool's cursor (defaults to the active tool) */
     applyForTool: (activeTool?: AppState["activeTool"]) => void;
+    /**
+     * Re-runs the hover cursor logic at the last known pointer position by
+     * re-dispatching a synthetic pointermove — for state changes that alter
+     * what hovering means without the pointer moving (e.g. the tool reverting
+     * to selection after an element is created). Mouse only: touch and pen
+     * have no resting hover to restore.
+     */
+    refreshHover: () => void;
     /** clears the inline cursor so the environment default (CSS) applies */
     private clear;
     private applyEraser;

package/dist/types/excalidraw/components/App.d.ts

@@ -4,6 +4,7 @@ import { LinearElementEditor } from "@excalidraw/element";
 import { Scene, Store, type ElementUpdate, StoreDelta, type ApplyToOptions } from "@excalidraw/element";
 import type { LocalPoint, Radians } from "@excalidraw/math";
 import type { ExcalidrawElement, ExcalidrawTextElement, NonDeleted, NonDeletedExcalidrawElement, ExcalidrawTextContainer, ExcalidrawFrameLikeElement, ExcalidrawIframeElement, ExcalidrawEmbeddableElement, Ordered, SceneElementsMap } from "@excalidraw/element/types";
+import type { ArrowEndpoint, TransformHandleDirection } from "@excalidraw/element";
 import type { Mutable } from "@excalidraw/common/utility-types";
 import { ActionManager } from "../actions/manager";
 import { History } from "../history";
@@ -17,10 +18,12 @@ import { LassoTrail } from "../lasso";
 import { EraserTrail } from "../eraser";
 import { AppArrowText } from "./App.arrowText";
 import { AppBucketFill } from "./App.bucketFill";
+import { AppToolDrag } from "./App.toolDrag";
 import { AppCursor } from "./App.cursor";
 import { AppDrawShape } from "./App.drawshape";
 import { AppFlowchart } from "./App.flowchart";
 import { AppViewport } from "./App.viewport";
+import { AppWheel } from "./App.wheel";
 import { CursorHints } from "./CursorHint";
 import { type OnStateChange } from "./AppStateObserver";
 import type { ExportedElements } from "../data";
@@ -82,6 +85,8 @@ declare class App extends React.Component<AppProps, AppState> {
     editorInterface: EditorInterface;
     private stylesPanelMode;
     private excalidrawContainerRef;
+    get ownerDocument(): Document;
+    get ownerWindow(): Window & typeof globalThis;
     scene: Scene;
     fonts: Fonts;
     renderer: Renderer;
@@ -93,7 +98,7 @@ declare class App extends React.Component<AppProps, AppState> {
     library: AppClassProperties["library"];
     libraryItemsFromStorage: LibraryItems | undefined;
     id: string;
-    private store;
+    store: Store;
     private history;
     excalidrawContainerValue: {
         container: HTMLDivElement | null;
@@ -119,14 +124,23 @@ declare class App extends React.Component<AppProps, AppState> {
     private appStateObserver;
     onStateChange: OnStateChange;
     bucketFill: AppBucketFill;
+    toolDrag: AppToolDrag;
     flowchart: AppFlowchart;
     cursor: AppCursor;
     arrowText: AppArrowText;
     viewport: AppViewport;
+    wheel: AppWheel;
     bindModeHandler: ReturnType<typeof setTimeout> | null;
     private textWysiwygSubmitHandler;
     hitLinkElement?: NonDeletedExcalidrawElement;
     lastPointerDownEvent: React.PointerEvent<HTMLElement> | null;
+    /**
+     * the handle of the resize in progress while `state.isResizing` — for UI
+     * that words itself by handle (a sticky note's corners resize
+     * proportionally, its edges freely); not app state, so it costs no
+     * re-render of its own
+     */
+    activeResizeHandle: TransformHandleDirection | null;
     lastPointerUpEvent: React.PointerEvent<HTMLElement> | PointerEvent | null;
     lastPointerUpIsDoubleClick: boolean;
     lastPointerMoveEvent: PointerEvent | null;
@@ -185,6 +199,7 @@ declare class App extends React.Component<AppProps, AppState> {
             wasAddedToSelection: boolean;
             hasBeenDuplicated: boolean;
             hasHitCommonBoundingBoxOfSelectedElements: boolean;
+            arrowLabel: boolean;
         };
         withCmdOrCtrl: boolean;
         drag: {
@@ -247,6 +262,7 @@ declare class App extends React.Component<AppProps, AppState> {
             wasAddedToSelection: boolean;
             hasBeenDuplicated: boolean;
             hasHitCommonBoundingBoxOfSelectedElements: boolean;
+            arrowLabel: boolean;
         };
         withCmdOrCtrl: boolean;
         drag: {
@@ -338,10 +354,11 @@ declare class App extends React.Component<AppProps, AppState> {
     isToolLocked(): boolean;
     /**
      * Whether the active tool captures the primary pointer instead of the
-     * view-mode drag-to-pan — the laser always does; while non-interactive,
-     * any tool allowed via `interaction.enabled.tools` does. (Editing tools
-     * capture the pointer trivially since view mode implies they're not
-     * active; this predicate only matters where view-mode gates apply.)
+     * view-mode drag-to-pan — the laser and host-implemented custom tools do;
+     * while non-interactive, any tool allowed via
+     * `interaction.enabled.tools` does. (Editing tools capture the pointer
+     * trivially since view mode implies they're not active; this predicate only
+     * matters where view-mode gates apply.)
      */
     isActiveToolPointerCapturing(): boolean;
     /** Whether Excalidraw's full default UI is rendered. */
@@ -363,6 +380,11 @@ declare class App extends React.Component<AppProps, AppState> {
     getEffectiveGridSize: () => NullableGridSize;
     private getTextCreationGridPoint;
     private getHTMLIFrameElement;
+    /**
+     * AI-generated iframe elements aren't interactive while their generation
+     * is still in progress (the partial content is render-only).
+     */
+    private isIframeLikeInteractive;
     private handleIframeLikeElementHover;
     /** @returns true if iframe-like element click handled */
     private handleIframeLikeCenterClick;
@@ -403,7 +425,6 @@ declare class App extends React.Component<AppProps, AppState> {
     private onBlur;
     private onUnload;
     private disableEvent;
-    private preventBrowserZoomWheel;
     private handleNavigationModeKeyDown;
     /**
      * PageUp/PageDown scroll the canvas by a page — vertically, or
@@ -477,7 +498,13 @@ declare class App extends React.Component<AppProps, AppState> {
     updateFrameRendering: (opts: Partial<AppState["frameRendering"]> | ((prevState: AppState["frameRendering"]) => Partial<AppState["frameRendering"]>)) => void;
     togglePenMode: (force: boolean | null) => void;
     revealIfHidden: (elements: NonDeletedExcalidrawElement[]) => void;
-    private maybeUnfollowRemoteUser;
+    /** emits a follow/unfollow intent to the host (which owns the
+     *  `userToFollow` state) via both the `onUserFollow` prop and the
+     *  imperative API emitter */
+    emitUserFollowIntent: (payload: OnUserFollowedPayload) => void;
+    /** emits an UNFOLLOW intent if currently following someone — use on
+     *  user-initiated viewport changes which should break follow mode */
+    requestUnfollow: () => void;
     setToast: (toast: AppState["toast"]) => void;
     restoreFileFromShare: () => Promise<void>;
     /**
@@ -565,9 +592,12 @@ declare class App extends React.Component<AppProps, AppState> {
     }) & {
         preferSelected?: boolean;
     }): NonDeleted<ExcalidrawElement> | null;
-    private getElementsAtPosition;
+    getElementsAtPosition(x: number, y: number, opts?: {
+        includeBoundTextElement?: boolean;
+        includeLockedElements?: boolean;
+    }): NonDeleted<ExcalidrawElement>[];
     getElementHitThreshold(element: ExcalidrawElement): number;
-    private hitElement;
+    hitElement(x: number, y: number, element: NonDeletedExcalidrawElement, considerBoundingBox?: boolean): boolean;
     getTextBindableContainerAtPosition(x: number, y: number): (Readonly<{
         id: string;
         x: number;
@@ -595,6 +625,7 @@ declare class App extends React.Component<AppProps, AppState> {
         frameId: string | null;
         boundElements: readonly import("@excalidraw/element/types").BoundElement[] | null;
         updated: number;
+        created: number | null;
         link: string | null;
         locked: boolean;
         customData?: Record<string, any>;
@@ -629,6 +660,43 @@ declare class App extends React.Component<AppProps, AppState> {
         frameId: string | null;
         boundElements: readonly import("@excalidraw/element/types").BoundElement[] | null;
         updated: number;
+        created: number | null;
+        link: string | null;
+        locked: boolean;
+        customData?: Record<string, any>;
+    }> & Readonly<{
+        type: "stickynote";
+        baseHeight: number;
+    }> & {
+        isDeleted: false;
+    }) | (Readonly<{
+        id: string;
+        x: number;
+        y: number;
+        strokeColor: string;
+        backgroundColor: string;
+        fillStyle: import("@excalidraw/element/types").FillStyle;
+        strokeWidth: number;
+        strokeStyle: import("@excalidraw/element/types").StrokeStyle;
+        roundness: null | {
+            type: import("@excalidraw/element/types").RoundnessType;
+            value?: number;
+        };
+        roughness: number;
+        opacity: number;
+        width: number;
+        height: number;
+        angle: Radians;
+        seed: number;
+        version: number;
+        versionNonce: number;
+        index: import("@excalidraw/element/types").FractionalIndex | null;
+        isDeleted: boolean;
+        groupIds: readonly import("@excalidraw/element/types").GroupId[];
+        frameId: string | null;
+        boundElements: readonly import("@excalidraw/element/types").BoundElement[] | null;
+        updated: number;
+        created: number | null;
         link: string | null;
         locked: boolean;
         customData?: Record<string, any>;
@@ -663,6 +731,7 @@ declare class App extends React.Component<AppProps, AppState> {
         frameId: string | null;
         boundElements: readonly import("@excalidraw/element/types").BoundElement[] | null;
         updated: number;
+        created: number | null;
         link: string | null;
         locked: boolean;
         customData?: Record<string, any>;
@@ -697,6 +766,7 @@ declare class App extends React.Component<AppProps, AppState> {
         frameId: string | null;
         boundElements: readonly import("@excalidraw/element/types").BoundElement[] | null;
         updated: number;
+        created: number | null;
         link: string | null;
         locked: boolean;
         customData?: Record<string, any>;
@@ -725,7 +795,25 @@ declare class App extends React.Component<AppProps, AppState> {
      * so the whole create-and-type lands in a single entry.
      */
     private isEditingTextContent;
-    private startTextEditing;
+    startTextEditing: ({ sceneX, sceneY, insertAtParentCenter, container, autoEdit, initialCaretSceneCoords, arrowEndpoint, }: {
+        /** X position to insert text at */
+        sceneX: number;
+        /** Y position to insert text at */
+        sceneY: number;
+        /** whether to attempt to insert at element center if applicable */
+        insertAtParentCenter?: boolean;
+        container?: ExcalidrawTextContainer | null;
+        autoEdit?: boolean;
+        initialCaretSceneCoords?: {
+            x: number;
+            y: number;
+        };
+        /**
+         * creates the text as a label for this arrow endpoint: the binding then
+         * dictates the text's position and alignment, overriding (sceneX, sceneY)
+         */
+        arrowEndpoint?: ArrowEndpoint | null;
+    }) => void;
     private startImageCropping;
     private finishImageCropping;
     private shouldHandleBrowserCanvasDoubleClick;
@@ -778,6 +866,10 @@ declare class App extends React.Component<AppProps, AppState> {
     private handleCanvasPointerMove;
     private handleEraser;
     private handleTouchMove;
+    /**
+     * Applies the hover affordances of a selected linear element: the cursor,
+     * plus the hovered-handle state that renders them highlighted.
+     */
     handleHoverSelectedLinearElement(linearElementEditor: LinearElementEditor, scenePointerX: number, scenePointerY: number): void;
     private handleCanvasPointerDown;
     private handleCanvasPointerUp;
@@ -820,8 +912,10 @@ declare class App extends React.Component<AppProps, AppState> {
     }) => NonDeleted<ExcalidrawEmbeddableElement> | undefined;
     private newImagePlaceholder;
     private handleLinearElementOnPointerDown;
-    private getCurrentItemRoundness;
-    private getCurrentItemStrokeWidth;
+    getCurrentItemRoundness(elementType: "selection" | "rectangle" | "stickynote" | "diamond" | "ellipse" | "iframe" | "embeddable"): {
+        type: 2 | 3;
+    } | null;
+    getCurrentItemStrokeWidth(elementType: ExcalidrawElement["type"]): number;
     private createGenericElementOnPointerDown;
     private createFrameElementOnPointerDown;
     private maybeCacheReferenceSnapPoints;
@@ -860,7 +954,6 @@ declare class App extends React.Component<AppProps, AppState> {
     private maybeHandleCrop;
     private maybeHandleResize;
     private getContextMenuItems;
-    private handleWheel;
     getTextWysiwygSnappedToCenterPosition(x: number, y: number, appState: AppState, container?: ExcalidrawTextContainer | null): {
         viewportX: number;
         viewportY: number;
@@ -868,7 +961,11 @@ declare class App extends React.Component<AppProps, AppState> {
         elementCenterY: number;
     } | undefined;
     private savePointer;
-    private resetShouldCacheIgnoreZoomDebounced;
+    resetShouldCacheIgnoreZoomDebounced: {
+        (): void;
+        flush(): void;
+        cancel(): void;
+    };
     private updateDOMRect;
     refresh: () => void;
     private getCanvasOffsets;