@excalidraw/common 0.18.0-4a5c9e9 → 0.18.0-4ce38fb

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

@@ -0,0 +1,26 @@
+/**
+ * Positions an element beside a cursor within a container, flipping the
+ * element to the other side of the cursor when it would overflow the
+ * container, resolved independently on each axis.
+ *
+ * Takes the cursor in client (viewport) coordinates and returns
+ * container-local coordinates.
+ */
+export declare const positionElementBesideCursor: ({ cursor, element, container, gap, }: {
+    /** client (viewport) coordinates */
+    cursor: {
+        x: number;
+        y: number;
+    };
+    element: {
+        width: number;
+        height: number;
+    };
+    /** the container's bounding client rect */
+    container: Pick<DOMRect, "left" | "top" | "width" | "height">;
+    /** distance between the cursor and the positioned element */
+    gap: number;
+}) => {
+    left: number;
+    top: number;
+};

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

@@ -0,0 +1,39 @@
+import type { ElementsMap, ExcalidrawElement, NonDeletedElementsMap, NonDeletedSceneElementsMap } from "@excalidraw/element/types";
+import type { AppClassProperties, UIAppState } from "../types";
+export declare const canChangeStrokeColor: (appState: UIAppState, targetElements: ExcalidrawElement[]) => boolean;
+export declare const canChangeBackgroundColor: (appState: UIAppState, targetElements: ExcalidrawElement[], elementsMap: ElementsMap) => boolean;
+/**
+ * Single source of truth for "which shape-action controls are relevant right
+ * now". Each flag answers whether a given control should be shown, given the
+ * active tool and the current selection. All three styles-panel layouts
+ * (full / compact / mobile) and the compact popovers consume these flags so
+ * that visibility logic lives in one place and layout stays pure.
+ */
+export declare const getShapeActionPredicates: (appState: UIAppState, targetElements: ExcalidrawElement[], elementsMap: NonDeletedElementsMap | NonDeletedSceneElementsMap, app: AppClassProperties) => {
+    /** some element(s) selected */
+    hasSelection: boolean;
+    /** actions on selected elements (delete/duplicate/...) */
+    showExtraActions: boolean;
+    strokeColor: boolean;
+    backgroundColor: boolean;
+    fill: boolean;
+    strokeWidth: boolean;
+    freedrawMode: boolean;
+    strokeStyle: boolean;
+    sloppiness: boolean;
+    roundness: boolean;
+    arrowType: boolean;
+    arrowheads: boolean;
+    text: boolean;
+    textAlign: boolean;
+    verticalAlign: boolean;
+    opacity: boolean;
+    layers: boolean;
+    align: boolean;
+    distribute: boolean;
+    link: boolean;
+    linkSingleOnly: boolean;
+    cropEditor: boolean;
+    lineEditor: boolean;
+};
+export type ShapeActionPredicates = ReturnType<typeof getShapeActionPredicates>;

package/dist/types/excalidraw/data/blob.d.ts

@@ -20,7 +20,13 @@ fileHandle?: FileSystemFileHandle | null) => Promise<{
     data: {
         elements: import("@excalidraw/element/types").OrderedExcalidrawElement[];
         appState: {
+            zoom: import("../types").Zoom;
             viewModeEnabled: boolean;
+            activeTool: {
+                lastActiveTool: import("../types").ActiveTool | null;
+                locked: boolean;
+                fromSelection: boolean;
+            } & import("../types").ActiveTool;
             zenModeEnabled: boolean;
             gridModeEnabled: boolean;
             objectsSnapModeEnabled: boolean;
@@ -28,11 +34,6 @@ fileHandle?: FileSystemFileHandle | null) => Promise<{
             name: string | null;
             currentItemArrowType: "sharp" | "round" | "elbow";
             gridSize: number;
-            activeTool: {
-                lastActiveTool: import("../types").ActiveTool | null;
-                locked: boolean;
-                fromSelection: boolean;
-            } & import("../types").ActiveTool;
             contextMenu: {
                 items: import("../components/ContextMenu").ContextMenuItems;
                 top: number;
@@ -50,13 +51,26 @@ fileHandle?: FileSystemFileHandle | null) => Promise<{
             multiElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawLinearElement> | null;
             selectionElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
             isBindingEnabled: boolean;
+            boxSelectionMode: import("../types").BoxSelectionMode;
             bindingPreference: "enabled" | "disabled";
             isMidpointSnappingEnabled: boolean;
-            startBoundElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawBindableElement> | null;
+            showHints: boolean;
+            inputDevice: import("../types").InputDevice;
             suggestedBinding: {
                 element: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawBindableElement>;
                 midPoint?: import("@excalidraw/math").GlobalPoint;
             } | null;
+            textToolHover: {
+                type: "text";
+                elementId: ExcalidrawElement["id"];
+            } | {
+                type: "container";
+                elementId: ExcalidrawElement["id"];
+            } | {
+                type: "arrow";
+                elementId: import("@excalidraw/element/types").ExcalidrawArrowElement["id"];
+                anchor: "start" | "end" | "label";
+            } | null;
             frameToHighlight: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawFrameLikeElement> | null;
             frameRendering: {
                 enabled: boolean;
@@ -64,8 +78,8 @@ fileHandle?: FileSystemFileHandle | null) => Promise<{
                 outline: boolean;
                 clip: boolean;
             };
-            editingFrame: string | null;
-            elementsToHighlight: import("@excalidraw/element/types").NonDeleted<ExcalidrawElement>[] | null;
+            editingFrame: import("@excalidraw/element/types").ExcalidrawFrameLikeElement["id"] | null;
+            elementsToHighlight: readonly import("@excalidraw/element/types").NonDeletedExcalidrawElement[] | null;
             editingTextElement: import("@excalidraw/element/types").ExcalidrawTextElement | null;
             preferredSelectionTool: {
                 type: "selection" | "lasso";
@@ -78,11 +92,14 @@ fileHandle?: FileSystemFileHandle | null) => Promise<{
             exportWithDarkMode: boolean;
             exportScale: number;
             currentItemStrokeColor: string;
+            currentItemStickynoteStrokeColor: string;
+            currentItemStickynoteBackgroundColor: string;
             currentItemBackgroundColor: string;
             currentItemFillStyle: ExcalidrawElement["fillStyle"];
-            currentItemStrokeWidth: number;
+            currentItemStrokeWidthKey: import("@excalidraw/common").StrokeWidthKey;
             currentItemStrokeStyle: ExcalidrawElement["strokeStyle"];
             currentItemRoughness: number;
+            currentItemStrokeVariability: import("@excalidraw/element/types").StrokeVariability;
             currentItemOpacity: number;
             currentItemFontFamily: import("@excalidraw/element/types").FontFamilyValues;
             currentItemFontSize: number;
@@ -94,11 +111,11 @@ fileHandle?: FileSystemFileHandle | null) => Promise<{
             viewBackgroundColor: string;
             scrollX: number;
             scrollY: number;
+            scrollConstraints: import("../types").ScrollConstraints | null;
             cursorButton: "up" | "down";
             scrolledOutside: boolean;
             isResizing: boolean;
             isRotating: boolean;
-            zoom: import("../types").Zoom;
             openMenu: "canvas" | null;
             openPopup: "canvasBackground" | "elementBackground" | "elementStroke" | "fontFamily" | "compactTextProperties" | "compactStrokeStyles" | "compactOtherProperties" | "compactArrowProperties" | null;
             openSidebar: {
@@ -158,8 +175,6 @@ fileHandle?: FileSystemFileHandle | null) => Promise<{
                 x: number;
                 y: number;
             } | null;
-            userToFollow: import("../types").UserToFollow | null;
-            followedBy: Set<import("../types").SocketId>;
             isCropping: boolean;
             croppingElementId: ExcalidrawElement["id"] | null;
             searchMatches: Readonly<{
@@ -171,6 +186,14 @@ fileHandle?: FileSystemFileHandle | null) => Promise<{
                 [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;
+            };
+            fontTopPicks: readonly import("@excalidraw/element/types").FontFamilyValues[] | null;
         };
         files: import("../types").BinaryFiles;
     };
@@ -185,7 +208,13 @@ localAppState: AppState | null, localElements: readonly ExcalidrawElement[] | nu
 fileHandle?: FileSystemFileHandle | null) => Promise<{
     elements: import("@excalidraw/element/types").OrderedExcalidrawElement[];
     appState: {
+        zoom: import("../types").Zoom;
         viewModeEnabled: boolean;
+        activeTool: {
+            lastActiveTool: import("../types").ActiveTool | null;
+            locked: boolean;
+            fromSelection: boolean;
+        } & import("../types").ActiveTool;
         zenModeEnabled: boolean;
         gridModeEnabled: boolean;
         objectsSnapModeEnabled: boolean;
@@ -193,11 +222,6 @@ fileHandle?: FileSystemFileHandle | null) => Promise<{
         name: string | null;
         currentItemArrowType: "sharp" | "round" | "elbow";
         gridSize: number;
-        activeTool: {
-            lastActiveTool: import("../types").ActiveTool | null;
-            locked: boolean;
-            fromSelection: boolean;
-        } & import("../types").ActiveTool;
         contextMenu: {
             items: import("../components/ContextMenu").ContextMenuItems;
             top: number;
@@ -215,13 +239,26 @@ fileHandle?: FileSystemFileHandle | null) => Promise<{
         multiElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawLinearElement> | null;
         selectionElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
         isBindingEnabled: boolean;
+        boxSelectionMode: import("../types").BoxSelectionMode;
         bindingPreference: "enabled" | "disabled";
         isMidpointSnappingEnabled: boolean;
-        startBoundElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawBindableElement> | null;
+        showHints: boolean;
+        inputDevice: import("../types").InputDevice;
         suggestedBinding: {
             element: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawBindableElement>;
             midPoint?: import("@excalidraw/math").GlobalPoint;
         } | null;
+        textToolHover: {
+            type: "text";
+            elementId: ExcalidrawElement["id"];
+        } | {
+            type: "container";
+            elementId: ExcalidrawElement["id"];
+        } | {
+            type: "arrow";
+            elementId: import("@excalidraw/element/types").ExcalidrawArrowElement["id"];
+            anchor: "start" | "end" | "label";
+        } | null;
         frameToHighlight: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawFrameLikeElement> | null;
         frameRendering: {
             enabled: boolean;
@@ -229,8 +266,8 @@ fileHandle?: FileSystemFileHandle | null) => Promise<{
             outline: boolean;
             clip: boolean;
         };
-        editingFrame: string | null;
-        elementsToHighlight: import("@excalidraw/element/types").NonDeleted<ExcalidrawElement>[] | null;
+        editingFrame: import("@excalidraw/element/types").ExcalidrawFrameLikeElement["id"] | null;
+        elementsToHighlight: readonly import("@excalidraw/element/types").NonDeletedExcalidrawElement[] | null;
         editingTextElement: import("@excalidraw/element/types").ExcalidrawTextElement | null;
         preferredSelectionTool: {
             type: "selection" | "lasso";
@@ -243,11 +280,14 @@ fileHandle?: FileSystemFileHandle | null) => Promise<{
         exportWithDarkMode: boolean;
         exportScale: number;
         currentItemStrokeColor: string;
+        currentItemStickynoteStrokeColor: string;
+        currentItemStickynoteBackgroundColor: string;
         currentItemBackgroundColor: string;
         currentItemFillStyle: ExcalidrawElement["fillStyle"];
-        currentItemStrokeWidth: number;
+        currentItemStrokeWidthKey: import("@excalidraw/common").StrokeWidthKey;
         currentItemStrokeStyle: ExcalidrawElement["strokeStyle"];
         currentItemRoughness: number;
+        currentItemStrokeVariability: import("@excalidraw/element/types").StrokeVariability;
         currentItemOpacity: number;
         currentItemFontFamily: import("@excalidraw/element/types").FontFamilyValues;
         currentItemFontSize: number;
@@ -259,11 +299,11 @@ fileHandle?: FileSystemFileHandle | null) => Promise<{
         viewBackgroundColor: string;
         scrollX: number;
         scrollY: number;
+        scrollConstraints: import("../types").ScrollConstraints | null;
         cursorButton: "up" | "down";
         scrolledOutside: boolean;
         isResizing: boolean;
         isRotating: boolean;
-        zoom: import("../types").Zoom;
         openMenu: "canvas" | null;
         openPopup: "canvasBackground" | "elementBackground" | "elementStroke" | "fontFamily" | "compactTextProperties" | "compactStrokeStyles" | "compactOtherProperties" | "compactArrowProperties" | null;
         openSidebar: {
@@ -323,8 +363,6 @@ fileHandle?: FileSystemFileHandle | null) => Promise<{
             x: number;
             y: number;
         } | null;
-        userToFollow: import("../types").UserToFollow | null;
-        followedBy: Set<import("../types").SocketId>;
         isCropping: boolean;
         croppingElementId: ExcalidrawElement["id"] | null;
         searchMatches: Readonly<{
@@ -336,6 +374,14 @@ fileHandle?: FileSystemFileHandle | null) => Promise<{
             [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;
+        };
+        fontTopPicks: readonly import("@excalidraw/element/types").FontFamilyValues[] | null;
     };
     files: import("../types").BinaryFiles;
 }>;

package/dist/types/excalidraw/data/index.d.ts

@@ -1,4 +1,4 @@
-import type { ExcalidrawElement, ExcalidrawFrameLikeElement, NonDeletedExcalidrawElement } from "@excalidraw/element/types";
+import type { ExcalidrawElement, ExcalidrawFrameLikeElement, NonDeleted, NonDeletedExcalidrawElement } from "@excalidraw/element/types";
 import type { ExportType } from "../scene/types";
 import type { AppState, BinaryFiles } from "../types";
 export { loadFromBlob } from "./blob";
@@ -6,8 +6,8 @@ export { loadFromJSON, saveAsJSON } from "./json";
 export type ExportedElements = readonly NonDeletedExcalidrawElement[] & {
     _brand: "exportedElements";
 };
-export declare const prepareElementsForExport: (elements: readonly ExcalidrawElement[], { selectedElementIds }: Pick<AppState, "selectedElementIds">, exportSelectionOnly: boolean) => {
-    exportingFrame: ExcalidrawFrameLikeElement | null;
+export declare const prepareElementsForExport: (allElements: readonly ExcalidrawElement[], { selectedElementIds }: Pick<AppState, "selectedElementIds">, exportSelectionOnly: boolean) => {
+    exportingFrame: NonDeleted<ExcalidrawFrameLikeElement> | null;
     exportedElements: ExportedElements;
 };
 export declare const exportCanvas: (type: Omit<ExportType, "backend">, elements: ExportedElements, appState: AppState, files: BinaryFiles, { exportBackground, exportPadding, viewBackgroundColor, name, fileHandle, exportingFrame, }: {
@@ -17,5 +17,5 @@ export declare const exportCanvas: (type: Omit<ExportType, "backend">, elements:
     /** filename, if applicable */
     name?: string;
     fileHandle?: FileSystemFileHandle | null;
-    exportingFrame: ExcalidrawFrameLikeElement | null;
+    exportingFrame: NonDeleted<ExcalidrawFrameLikeElement> | null;
 }) => Promise<FileSystemFileHandle | null | undefined>;

package/dist/types/excalidraw/data/json.d.ts

@@ -1,9 +1,9 @@
-import type { ExcalidrawElement, NonDeleted } from "@excalidraw/element/types";
+import type { ExcalidrawElement } from "@excalidraw/element/types";
 import type { MaybePromise } from "@excalidraw/common/utility-types";
 import type { AppState, BinaryFiles, LibraryItems } from "../types";
 import type { ImportedDataState, ImportedLibraryData } from "./types";
 export type JSONExportData = {
-    elements: readonly NonDeleted<ExcalidrawElement>[];
+    elements: readonly ExcalidrawElement[];
     appState: AppState;
     files: BinaryFiles;
 };
@@ -18,7 +18,13 @@ export declare const saveAsJSON: ({ data, filename, fileHandle, }: {
 export declare const loadFromJSON: (localAppState: AppState, localElements: readonly ExcalidrawElement[] | null) => Promise<{
     elements: import("@excalidraw/element/types").OrderedExcalidrawElement[];
     appState: {
+        zoom: import("../types").Zoom;
         viewModeEnabled: boolean;
+        activeTool: {
+            lastActiveTool: import("../types").ActiveTool | null;
+            locked: boolean;
+            fromSelection: boolean;
+        } & import("../types").ActiveTool;
         zenModeEnabled: boolean;
         gridModeEnabled: boolean;
         objectsSnapModeEnabled: boolean;
@@ -26,11 +32,6 @@ export declare const loadFromJSON: (localAppState: AppState, localElements: read
         name: string | null;
         currentItemArrowType: "sharp" | "round" | "elbow";
         gridSize: number;
-        activeTool: {
-            lastActiveTool: import("../types").ActiveTool | null;
-            locked: boolean;
-            fromSelection: boolean;
-        } & import("../types").ActiveTool;
         contextMenu: {
             items: import("../components/ContextMenu").ContextMenuItems;
             top: number;
@@ -43,27 +44,40 @@ export declare const loadFromJSON: (localAppState: AppState, localElements: read
             element: import("@excalidraw/element/types").NonDeletedExcalidrawElement;
             state: "hover" | "active";
         } | null;
-        newElement: NonDeleted<import("@excalidraw/element/types").ExcalidrawNonSelectionElement> | null;
+        newElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawNonSelectionElement> | null;
         resizingElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
-        multiElement: NonDeleted<import("@excalidraw/element/types").ExcalidrawLinearElement> | null;
+        multiElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawLinearElement> | null;
         selectionElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
         isBindingEnabled: boolean;
+        boxSelectionMode: import("../types").BoxSelectionMode;
         bindingPreference: "enabled" | "disabled";
         isMidpointSnappingEnabled: boolean;
-        startBoundElement: NonDeleted<import("@excalidraw/element/types").ExcalidrawBindableElement> | null;
+        showHints: boolean;
+        inputDevice: import("../types").InputDevice;
         suggestedBinding: {
-            element: NonDeleted<import("@excalidraw/element/types").ExcalidrawBindableElement>;
+            element: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawBindableElement>;
             midPoint?: import("@excalidraw/math").GlobalPoint;
         } | null;
-        frameToHighlight: NonDeleted<import("@excalidraw/element/types").ExcalidrawFrameLikeElement> | null;
+        textToolHover: {
+            type: "text";
+            elementId: ExcalidrawElement["id"];
+        } | {
+            type: "container";
+            elementId: ExcalidrawElement["id"];
+        } | {
+            type: "arrow";
+            elementId: import("@excalidraw/element/types").ExcalidrawArrowElement["id"];
+            anchor: "start" | "end" | "label";
+        } | null;
+        frameToHighlight: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawFrameLikeElement> | null;
         frameRendering: {
             enabled: boolean;
             name: boolean;
             outline: boolean;
             clip: boolean;
         };
-        editingFrame: string | null;
-        elementsToHighlight: NonDeleted<ExcalidrawElement>[] | null;
+        editingFrame: import("@excalidraw/element/types").ExcalidrawFrameLikeElement["id"] | null;
+        elementsToHighlight: readonly import("@excalidraw/element/types").NonDeletedExcalidrawElement[] | null;
         editingTextElement: import("@excalidraw/element/types").ExcalidrawTextElement | null;
         preferredSelectionTool: {
             type: "selection" | "lasso";
@@ -76,11 +90,14 @@ export declare const loadFromJSON: (localAppState: AppState, localElements: read
         exportWithDarkMode: boolean;
         exportScale: number;
         currentItemStrokeColor: string;
+        currentItemStickynoteStrokeColor: string;
+        currentItemStickynoteBackgroundColor: string;
         currentItemBackgroundColor: string;
         currentItemFillStyle: ExcalidrawElement["fillStyle"];
-        currentItemStrokeWidth: number;
+        currentItemStrokeWidthKey: import("@excalidraw/common").StrokeWidthKey;
         currentItemStrokeStyle: ExcalidrawElement["strokeStyle"];
         currentItemRoughness: number;
+        currentItemStrokeVariability: import("@excalidraw/element/types").StrokeVariability;
         currentItemOpacity: number;
         currentItemFontFamily: import("@excalidraw/element/types").FontFamilyValues;
         currentItemFontSize: number;
@@ -92,11 +109,11 @@ export declare const loadFromJSON: (localAppState: AppState, localElements: read
         viewBackgroundColor: string;
         scrollX: number;
         scrollY: number;
+        scrollConstraints: import("../types").ScrollConstraints | null;
         cursorButton: "up" | "down";
         scrolledOutside: boolean;
         isResizing: boolean;
         isRotating: boolean;
-        zoom: import("../types").Zoom;
         openMenu: "canvas" | null;
         openPopup: "canvasBackground" | "elementBackground" | "elementStroke" | "fontFamily" | "compactTextProperties" | "compactStrokeStyles" | "compactOtherProperties" | "compactArrowProperties" | null;
         openSidebar: {
@@ -156,8 +173,6 @@ export declare const loadFromJSON: (localAppState: AppState, localElements: read
             x: number;
             y: number;
         } | null;
-        userToFollow: import("../types").UserToFollow | null;
-        followedBy: Set<import("../types").SocketId>;
         isCropping: boolean;
         croppingElementId: ExcalidrawElement["id"] | null;
         searchMatches: Readonly<{
@@ -169,6 +184,14 @@ export declare const loadFromJSON: (localAppState: AppState, localElements: read
             [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;
+        };
+        fontTopPicks: readonly import("@excalidraw/element/types").FontFamilyValues[] | null;
     };
     files: BinaryFiles;
 }>;

package/dist/types/excalidraw/data/library.d.ts

@@ -37,7 +37,7 @@ export interface LibraryMigrationAdapter {
     /** clears entire storage afterwards */
     clear(): MaybePromise<void>;
 }
-export declare const libraryItemsAtom: import("jotai/vanilla/atom").PrimitiveAtom<{
+export declare const libraryItemsAtom: import("jotai").PrimitiveAtom<{
     status: "loading" | "loaded";
     /** indicates whether library is initialized with library items (has gone
      * through at least one update). Used in UI. Specific to this atom only. */

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

@@ -0,0 +1,16 @@
+import type { GlobalPoint } from "@excalidraw/math";
+import type App from "./components/App";
+import type { Trail } from "./animatedTrail";
+export declare class DrawShapeTrail implements Trail {
+    private app;
+    private trail;
+    constructor(app: App);
+    private getTrailOptions;
+    startPath(x: number, y: number): void;
+    addPointToPath(x: number, y: number): void;
+    endPath(): void;
+    clearTrails(): void;
+    getCurrentPoints(): GlobalPoint[];
+    start(container: SVGSVGElement): void;
+    stop(): void;
+}

package/dist/types/excalidraw/eraser/index.d.ts

@@ -1,10 +1,9 @@
-import { AnimatedTrail } from "../animated-trail";
-import type { AnimationFrameHandler } from "../animation-frame-handler";
+import { AnimatedTrail } from "../animatedTrail";
 import type App from "../components/App";
 export declare class EraserTrail extends AnimatedTrail {
     private elementsToErase;
     private groupsToErase;
-    constructor(animationFrameHandler: AnimationFrameHandler, app: App);
+    constructor(app: App);
     startPath(x: number, y: number): void;
     addPointToPath(x: number, y: number, restore?: boolean): string[];
     private updateElementsToBeErased;

package/dist/types/excalidraw/fonts/Fonts.d.ts

@@ -15,7 +15,8 @@ export declare class Fonts {
         fontFaces: ExcalidrawFontFace[];
     }>;
     private readonly scene;
-    constructor(scene: Scene);
+    private readonly ownerDocument;
+    constructor(scene: Scene, ownerDocument?: Document);
     /**
      * Get all the font families for the given scene.
      */
@@ -36,7 +37,7 @@ export declare class Fonts {
     /**
      * Load font faces for passed elements - use when the scene is unavailable (i.e. export).
      */
-    static loadElementsFonts: (elements: readonly ExcalidrawElement[]) => Promise<FontFace[]>;
+    static loadElementsFonts: (elements: readonly ExcalidrawElement[], ownerDocument?: Document) => Promise<FontFace[]>;
     /**
      * Generate CSS @font-face declarations for the given elements.
      */

package/dist/types/excalidraw/hooks/useAppStateValue.d.ts

@@ -0,0 +1,29 @@
+import type { AppState } from "../types";
+/**
+ * Subscribes to specific appState changes. The component re-renders
+ * only when the specified prop(s) change — not on every appState update.
+ *
+ * Works both inside and outside the <Excalidraw> tree, as long as
+ * ExcalidrawAPIContext.Provider is an ancestor (automatically provided
+ * inside <Excalidraw>, or manually by the host app).
+ *
+ * Returns the narrowed value depending on prop form:
+ *  - `keyof AppState` → `AppState[K]`
+ *  - `(keyof AppState)[]` → whole `AppState`
+ *  - selector function → selector's return type `T`
+ *
+ * If excalidrawAPI is not ready yet (host apps), hook is rerendered with latest
+ * value once available.
+ */
+export declare function useAppStateValue<K extends keyof AppState>(prop: K, _internal?: boolean): AppState[K];
+export declare function useAppStateValue(props: (keyof AppState)[], _internal?: boolean): AppState;
+export declare function useAppStateValue<T>(selector: (appState: AppState) => T, _internal?: boolean): T;
+/**
+ * Subscribes to specific appState changes without causing component rerenders.
+ *
+ * The callback is called on every matching change, but also on initial render
+ * so you can initialize your state.
+ */
+export declare function useOnAppStateChange<K extends keyof AppState>(prop: K, callback: (value: AppState[K], appState: AppState) => void): undefined;
+export declare function useOnAppStateChange(props: (keyof AppState)[], callback: (props: AppState, appState: AppState) => void): undefined;
+export declare function useOnAppStateChange<T>(selector: (appState: AppState) => T, callback: (value: T, appState: AppState) => void): undefined;

package/dist/types/excalidraw/hooks/useLibraryItemSvg.d.ts

@@ -1,6 +1,6 @@
 import type { LibraryItem } from "../types";
 export type SvgCache = Map<LibraryItem["id"], SVGSVGElement>;
-export declare const libraryItemSvgsCache: import("jotai/vanilla/atom").PrimitiveAtom<SvgCache> & {
+export declare const libraryItemSvgsCache: import("jotai").PrimitiveAtom<SvgCache> & {
     init: SvgCache;
 };
 export declare const useLibraryItemSvg: (id: LibraryItem["id"] | null, elements: LibraryItem["elements"] | undefined, svgCache: SvgCache, ref: React.RefObject<HTMLDivElement | null>) => SVGSVGElement | undefined;

package/dist/types/excalidraw/hooks/useTextEditorFocus.d.ts

@@ -2,13 +2,13 @@ export type CaretPosition = {
     start: number;
     end: number;
 };
-export declare const saveCaretPosition: () => CaretPosition | null;
-export declare const restoreCaretPosition: (position: CaretPosition | null) => void;
-export declare const withCaretPositionPreservation: (callback: () => void, isCompactMode: boolean, isEditingText: boolean, onPreventClose?: () => void) => void;
-export declare const useTextEditorFocus: () => {
+export declare const saveCaretPosition: (ownerDocument?: Document) => CaretPosition | null;
+export declare const restoreCaretPosition: (position: CaretPosition | null, ownerDocument?: Document) => void;
+export declare const withCaretPositionPreservation: (callback: () => void, isCompactMode: boolean, isEditingText: boolean, onPreventClose?: () => void, ownerDocument?: Document) => void;
+export declare const useTextEditorFocus: (ownerDocument?: Document) => {
     saveCaretPosition: () => void;
     restoreCaretPosition: () => void;
     clearSavedPosition: () => void;
     hasSavedPosition: boolean;
 };
-export declare const temporarilyDisableTextEditorBlur: (duration?: number) => void;
+export declare const temporarilyDisableTextEditorBlur: (ownerDocument?: Document, duration?: number) => void;

package/dist/types/excalidraw/{laser-trails.d.ts → laserTrails.d.ts}

@@ -1,20 +1,18 @@
-import { AnimatedTrail } from "./animated-trail";
-import type { Trail } from "./animated-trail";
-import type { AnimationFrameHandler } from "./animation-frame-handler";
+import { AnimatedTrail } from "./animatedTrail";
+import type { Trail } from "./animatedTrail";
 import type App from "./components/App";
 export declare class LaserTrails implements Trail {
-    private animationFrameHandler;
     private app;
     localTrail: AnimatedTrail;
     private collabTrails;
     private container?;
-    constructor(animationFrameHandler: AnimationFrameHandler, app: App);
+    constructor(app: App);
     private getTrailOptions;
     startPath(x: number, y: number): void;
     addPointToPath(x: number, y: number): void;
     endPath(): void;
     start(container: SVGSVGElement): void;
     stop(): void;
-    onFrame(): void;
-    private updateCollabTrails;
+    private stopCollabTrails;
+    updateCollabTrails(collaborators: App["state"]["collaborators"]): void;
 }

package/dist/types/excalidraw/lasso/index.d.ts

@@ -1,5 +1,4 @@
-import { type AnimationFrameHandler } from "../animation-frame-handler";
-import { AnimatedTrail } from "../animated-trail";
+import { AnimatedTrail } from "../animatedTrail";
 import type App from "../components/App";
 export declare class LassoTrail extends AnimatedTrail {
     private intersectedElements;
@@ -7,7 +6,7 @@ export declare class LassoTrail extends AnimatedTrail {
     private elementsSegments;
     private canvasTranslate;
     private keepPreviousSelection;
-    constructor(animationFrameHandler: AnimationFrameHandler, app: App);
+    constructor(app: App);
     startPath(x: number, y: number, keepPreviousSelection?: boolean): void;
     selectElementsFromIds: (ids: string[]) => void;
     addPointToPath: (x: number, y: number, keepPreviousSelection?: boolean) => void;

package/dist/types/excalidraw/lasso/utils.d.ts

@@ -1,5 +1,6 @@
 import type { ElementsSegmentsMap, GlobalPoint } from "@excalidraw/math/types";
 import type { ElementsMap, ExcalidrawElement } from "@excalidraw/element/types";
+import type { BoxSelectionMode } from "../types";
 export declare const getLassoSelectedElementIds: (input: {
     lassoPath: GlobalPoint[];
     elements: readonly ExcalidrawElement[];
@@ -8,6 +9,7 @@ export declare const getLassoSelectedElementIds: (input: {
     intersectedElements: Set<ExcalidrawElement["id"]>;
     enclosedElements: Set<ExcalidrawElement["id"]>;
     simplifyDistance?: number;
+    mode?: BoxSelectionMode;
 }) => {
     selectedElementIds: string[];
 };