@excalidraw/math 0.18.0-0457ac9 → 0.18.0-063e025

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

@@ -1,10 +1,17 @@
 import React from "react";
 import "./Island.scss";
+import type { ViewportUIDock, ViewportUIName } from "../types";
 type IslandProps = {
     children: React.ReactNode;
     padding?: number;
     className?: string | boolean;
     style?: object;
+    /** marks the island as a canvas-occluding UI surface measured by
+     * `getViewportOffsets` (see {@link ViewportUIDock}) */
+    "data-viewport-ui"?: ViewportUIDock;
+    /** identifies the surface so `getViewportOffsets` can reserve space for
+     * it while hidden (see {@link ViewportUIName}) */
+    "data-viewport-ui-name"?: ViewportUIName;
 };
 export declare const Island: React.ForwardRefExoticComponent<IslandProps & React.RefAttributes<HTMLDivElement>>;
 export {};

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

@@ -1,6 +1,6 @@
 import React from "react";
 import "./LibraryMenu.scss";
-export declare const isLibraryMenuOpenAtom: import("jotai/vanilla/atom").PrimitiveAtom<boolean> & {
+export declare const isLibraryMenuOpenAtom: import("jotai").PrimitiveAtom<boolean> & {
     init: boolean;
 };
 /**

package/dist/types/excalidraw/components/OverwriteConfirm/OverwriteConfirmState.d.ts

@@ -11,7 +11,7 @@ export type OverwriteConfirmState = {
 } | {
     active: false;
 };
-export declare const overwriteConfirmStateAtom: import("jotai/vanilla/atom").PrimitiveAtom<OverwriteConfirmState> & {
+export declare const overwriteConfirmStateAtom: import("jotai").PrimitiveAtom<OverwriteConfirmState> & {
     init: OverwriteConfirmState;
 };
 export declare function openConfirmModal({ title, description, actionLabel, color, }: {

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

@@ -1,5 +1,5 @@
 import "./SVGLayer.scss";
-import type { Trail } from "../animated-trail";
+import type { Trail } from "../animatedTrail";
 type SVGLayerProps = {
     trails: Trail[];
 };

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

@@ -1,5 +1,5 @@
 import "./SearchMenu.scss";
-export declare const searchItemInFocusAtom: import("jotai/vanilla/atom").PrimitiveAtom<number | null> & {
+export declare const searchItemInFocusAtom: import("jotai").PrimitiveAtom<number | null> & {
     init: number | null;
 };
 export declare const SearchMenu: () => import("react/jsx-runtime").JSX.Element;

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

@@ -8,7 +8,7 @@ import "./Sidebar.scss";
  *
  * Since we can only render one Sidebar at a time, we can use a simple flag.
  */
-export declare const isSidebarDockedAtom: import("jotai/vanilla/atom").PrimitiveAtom<boolean> & {
+export declare const isSidebarDockedAtom: import("jotai").PrimitiveAtom<boolean> & {
     init: boolean;
 };
 export declare const SidebarInner: React.ForwardRefExoticComponent<Omit<{

package/dist/types/excalidraw/components/Stats/Angle.d.ts

@@ -1,8 +1,8 @@
-import type { ExcalidrawElement } from "@excalidraw/element/types";
+import type { NonDeletedExcalidrawElement } from "@excalidraw/element/types";
 import type { Scene } from "@excalidraw/element";
 import type { AppState } from "../../types";
 interface AngleProps {
-    element: ExcalidrawElement;
+    element: NonDeletedExcalidrawElement;
     scene: Scene;
     appState: AppState;
     property: "angle";

package/dist/types/excalidraw/components/Stats/Dimension.d.ts

@@ -1,9 +1,9 @@
-import type { ExcalidrawElement } from "@excalidraw/element/types";
+import type { NonDeletedExcalidrawElement } from "@excalidraw/element/types";
 import type { Scene } from "@excalidraw/element";
 import type { AppState } from "../../types";
 interface DimensionDragInputProps {
     property: "width" | "height";
-    element: ExcalidrawElement;
+    element: NonDeletedExcalidrawElement;
     scene: Scene;
     appState: AppState;
 }

package/dist/types/excalidraw/components/Stats/DragInput.d.ts

@@ -1,10 +1,10 @@
-import type { ElementsMap, ExcalidrawElement } from "@excalidraw/element/types";
+import type { ElementsMap, ExcalidrawElement, NonDeletedExcalidrawElement } from "@excalidraw/element/types";
 import type { Scene } from "@excalidraw/element";
 import { useApp, useExcalidrawSetAppState } from "../App";
 import "./DragInput.scss";
 import type { StatsInputProperty } from "./utils";
 import type { AppState } from "../../types";
-export type DragInputCallbackType<P extends StatsInputProperty, E = ExcalidrawElement> = (props: {
+export type DragInputCallbackType<P extends StatsInputProperty, E = NonDeletedExcalidrawElement> = (props: {
     accumulatedChange: number;
     instantChange: number;
     originalElements: readonly E[];

package/dist/types/excalidraw/components/Stats/MultiAngle.d.ts

@@ -1,8 +1,8 @@
-import type { ExcalidrawElement } from "@excalidraw/element/types";
+import type { NonDeletedExcalidrawElement } from "@excalidraw/element/types";
 import type { Scene } from "@excalidraw/element";
 import type { AppState } from "../../types";
 interface MultiAngleProps {
-    elements: readonly ExcalidrawElement[];
+    elements: readonly NonDeletedExcalidrawElement[];
     scene: Scene;
     appState: AppState;
     property: "angle";

package/dist/types/excalidraw/components/Stats/MultiDimension.d.ts

@@ -1,10 +1,10 @@
-import type { ExcalidrawElement, NonDeletedSceneElementsMap } from "@excalidraw/element/types";
+import type { NonDeletedExcalidrawElement, NonDeletedSceneElementsMap } from "@excalidraw/element/types";
 import type { Scene } from "@excalidraw/element";
 import type { AtomicUnit } from "./utils";
 import type { AppState } from "../../types";
 interface MultiDimensionProps {
     property: "width" | "height";
-    elements: readonly ExcalidrawElement[];
+    elements: readonly NonDeletedExcalidrawElement[];
     elementsMap: NonDeletedSceneElementsMap;
     atomicUnits: AtomicUnit[];
     scene: Scene;

package/dist/types/excalidraw/components/Stats/MultiPosition.d.ts

@@ -1,10 +1,10 @@
-import type { ElementsMap, ExcalidrawElement } from "@excalidraw/element/types";
+import type { ElementsMap, NonDeletedExcalidrawElement } from "@excalidraw/element/types";
 import type { Scene } from "@excalidraw/element";
 import type { AtomicUnit } from "./utils";
 import type { AppState } from "../../types";
 interface MultiPositionProps {
     property: "x" | "y";
-    elements: readonly ExcalidrawElement[];
+    elements: readonly NonDeletedExcalidrawElement[];
     elementsMap: ElementsMap;
     atomicUnits: AtomicUnit[];
     scene: Scene;

package/dist/types/excalidraw/components/Stats/Position.d.ts

@@ -1,12 +1,12 @@
-import type { ElementsMap, ExcalidrawElement } from "@excalidraw/element/types";
+import type { ElementsMap, NonDeletedExcalidrawElement } from "@excalidraw/element/types";
 import type { Scene } from "@excalidraw/element";
 import type { AppState } from "../../types";
 interface PositionProps {
     property: "x" | "y";
-    element: ExcalidrawElement;
+    element: NonDeletedExcalidrawElement;
     elementsMap: ElementsMap;
     scene: Scene;
     appState: AppState;
 }
-declare const Position: ({ property, element, elementsMap, scene, appState, }: PositionProps) => import("react/jsx-runtime").JSX.Element;
+declare const Position: ({ property, element, scene, appState }: PositionProps) => import("react/jsx-runtime").JSX.Element;
 export default Position;

package/dist/types/excalidraw/components/Stats/utils.d.ts

@@ -15,5 +15,5 @@ export declare const newOrigin: (x1: number, y1: number, w1: number, h1: number,
     x: number;
     y: number;
 };
-export declare const moveElement: (newTopLeftX: number, newTopLeftY: number, originalElement: ExcalidrawElement, scene: Scene, appState: AppState, originalElementsMap: ElementsMap, shouldInformMutation?: boolean) => void;
+export declare const moveElement: (newTopLeftX: number, newTopLeftY: number, originalElement: NonDeletedExcalidrawElement, scene: Scene, appState: AppState, originalElementsMap: ElementsMap, shouldInformMutation?: boolean) => void;
 export declare const getAtomicUnits: (targetElements: readonly ExcalidrawElement[], appState: AppState) => AtomicUnit[];

package/dist/types/excalidraw/components/TTDDialog/TTDContext.d.ts

@@ -1,13 +1,13 @@
 import type { RateLimits, TChat } from "./types";
-export declare const rateLimitsAtom: import("jotai/vanilla/atom").PrimitiveAtom<RateLimits | null> & {
+export declare const rateLimitsAtom: import("jotai").PrimitiveAtom<RateLimits | null> & {
     init: RateLimits | null;
 };
-export declare const showPreviewAtom: import("jotai/vanilla/atom").PrimitiveAtom<boolean> & {
+export declare const showPreviewAtom: import("jotai").PrimitiveAtom<boolean> & {
     init: boolean;
 };
-export declare const errorAtom: import("jotai/vanilla/atom").PrimitiveAtom<Error | null> & {
+export declare const errorAtom: import("jotai").PrimitiveAtom<Error | null> & {
     init: Error | null;
 };
-export declare const chatHistoryAtom: import("jotai/vanilla/atom").PrimitiveAtom<TChat.ChatHistory> & {
+export declare const chatHistoryAtom: import("jotai").PrimitiveAtom<TChat.ChatHistory> & {
     init: TChat.ChatHistory;
 };

package/dist/types/excalidraw/components/TTDDialog/useTTDChatStorage.d.ts

@@ -9,13 +9,13 @@ interface UseTTDChatStorageReturn {
     restoreChat: (chat: SavedChat) => SavedChat;
     createNewChatId: () => Promise<string>;
 }
-export declare const savedChatsAtom: import("jotai/vanilla/atom").PrimitiveAtom<SavedChats> & {
+export declare const savedChatsAtom: import("jotai").PrimitiveAtom<SavedChats> & {
     init: SavedChats;
 };
-export declare const isLoadingChatsAtom: import("jotai/vanilla/atom").PrimitiveAtom<boolean> & {
+export declare const isLoadingChatsAtom: import("jotai").PrimitiveAtom<boolean> & {
     init: boolean;
 };
-export declare const chatsLoadedAtom: import("jotai/vanilla/atom").PrimitiveAtom<boolean> & {
+export declare const chatsLoadedAtom: import("jotai").PrimitiveAtom<boolean> & {
     init: boolean;
 };
 export declare const useTTDChatStorage: ({ persistenceAdapter, }: UseTTDChatStorageProps) => UseTTDChatStorageReturn;

package/dist/types/excalidraw/components/hyperlink/helpers.d.ts

@@ -1,10 +1,10 @@
 import type { GlobalPoint, Radians } from "@excalidraw/math";
 import type { Bounds } from "@excalidraw/common";
 import type { ElementsMap, NonDeletedExcalidrawElement } from "@excalidraw/element/types";
-import type { AppState, UIAppState } from "../../types";
+import type { AppState } from "../../types";
 export declare const DEFAULT_LINK_SIZE = 12;
 export declare const EXTERNAL_LINK_IMG: HTMLImageElement;
 export declare const ELEMENT_LINK_IMG: HTMLImageElement;
-export declare const getLinkHandleFromCoords: ([x1, y1, x2, y2]: Bounds, angle: Radians, appState: Pick<UIAppState, "zoom">) => Bounds;
+export declare const getLinkHandleFromCoords: ([x1, y1, x2, y2]: Bounds, angle: Radians, appState: Pick<AppState, "zoom">) => Bounds;
 export declare const isPointHittingLinkIcon: (element: NonDeletedExcalidrawElement, elementsMap: ElementsMap, appState: AppState, [x, y]: GlobalPoint) => boolean;
 export declare const isPointHittingLink: (element: NonDeletedExcalidrawElement, elementsMap: ElementsMap, appState: AppState, [x, y]: GlobalPoint, isMobile: boolean) => boolean;

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

@@ -114,6 +114,8 @@ export declare const StrokeStyleDottedIcon: import("react/jsx-runtime").JSX.Elem
 export declare const SloppinessArchitectIcon: import("react/jsx-runtime").JSX.Element;
 export declare const SloppinessArtistIcon: import("react/jsx-runtime").JSX.Element;
 export declare const SloppinessCartoonistIcon: import("react/jsx-runtime").JSX.Element;
+export declare const strokeVariabilityConstantIcon: import("react/jsx-runtime").JSX.Element;
+export declare const strokeVariabilityVariableIcon: import("react/jsx-runtime").JSX.Element;
 export declare const EdgeSharpIcon: import("react/jsx-runtime").JSX.Element;
 export declare const EdgeRoundIcon: import("react/jsx-runtime").JSX.Element;
 export declare const ArrowheadNoneIcon: React.MemoExoticComponent<({ flip }: {

package/dist/types/excalidraw/components/main-menu/DefaultItems.d.ts

@@ -35,11 +35,14 @@ export declare const ClearCanvas: {
 export declare const ToggleTheme: {
     (props: {
         allowSystemTheme: true;
+        /**
+         * Controls the theme of this UI component only.
+         * You should subscribe to `props.onThemeChange` and control the theme
+         * upstream.
+         */
         theme: Theme | "system";
-        onSelect: (theme: Theme | "system") => void;
     } | {
-        allowSystemTheme?: false;
-        onSelect?: (theme: Theme) => void;
+        allowSystemTheme: false;
     }): import("react/jsx-runtime").JSX.Element | null;
     displayName: string;
 };

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

@@ -78,7 +78,7 @@ fileHandle?: FileSystemFileHandle | null) => Promise<{
                 midPoint?: import("@excalidraw/math").GlobalPoint;
             } | null;
             isRotating: boolean;
-            elementsToHighlight: import("@excalidraw/element/types").NonDeleted<ExcalidrawElement>[] | null;
+            elementsToHighlight: readonly import("@excalidraw/element/types").NonDeletedExcalidrawElement[] | null;
             collaborators: Map<import("../types").SocketId, import("../types").Collaborator>;
             snapLines: readonly import("../snapping").SnapLine[];
             zenModeEnabled: boolean;
@@ -122,9 +122,10 @@ fileHandle?: FileSystemFileHandle | null) => Promise<{
             currentItemStrokeColor: 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;
@@ -133,6 +134,7 @@ fileHandle?: FileSystemFileHandle | null) => Promise<{
             currentItemEndArrowhead: import("@excalidraw/element/types").Arrowhead | null;
             currentHoveredFontFamily: import("@excalidraw/element/types").FontFamilyValues | null;
             currentItemRoundness: import("@excalidraw/element/types").StrokeRoundness;
+            scrollConstraints: import("../types").ScrollConstraints | null;
             cursorButton: "up" | "down";
             scrolledOutside: boolean;
             isResizing: boolean;
@@ -243,7 +245,7 @@ fileHandle?: FileSystemFileHandle | null) => Promise<{
             midPoint?: import("@excalidraw/math").GlobalPoint;
         } | null;
         isRotating: boolean;
-        elementsToHighlight: import("@excalidraw/element/types").NonDeleted<ExcalidrawElement>[] | null;
+        elementsToHighlight: readonly import("@excalidraw/element/types").NonDeletedExcalidrawElement[] | null;
         collaborators: Map<import("../types").SocketId, import("../types").Collaborator>;
         snapLines: readonly import("../snapping").SnapLine[];
         zenModeEnabled: boolean;
@@ -287,9 +289,10 @@ fileHandle?: FileSystemFileHandle | null) => Promise<{
         currentItemStrokeColor: 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;
@@ -298,6 +301,7 @@ fileHandle?: FileSystemFileHandle | null) => Promise<{
         currentItemEndArrowhead: import("@excalidraw/element/types").Arrowhead | null;
         currentHoveredFontFamily: import("@excalidraw/element/types").FontFamilyValues | null;
         currentItemRoundness: import("@excalidraw/element/types").StrokeRoundness;
+        scrollConstraints: import("../types").ScrollConstraints | null;
         cursorButton: "up" | "down";
         scrolledOutside: boolean;
         isResizing: boolean;

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;
 };
@@ -52,7 +52,7 @@ export declare const loadFromJSON: (localAppState: AppState, localElements: read
         selectedElementIds: Readonly<{
             [id: string]: true;
         }>;
-        frameToHighlight: NonDeleted<import("@excalidraw/element/types").ExcalidrawFrameLikeElement> | null;
+        frameToHighlight: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawFrameLikeElement> | null;
         activeTool: {
             lastActiveTool: import("../types").ActiveTool | null;
             locked: boolean;
@@ -67,16 +67,16 @@ export declare const loadFromJSON: (localAppState: AppState, localElements: read
             [groupId: string]: boolean;
         };
         selectedLinearElement: import("@excalidraw/element").LinearElementEditor | null;
-        multiElement: NonDeleted<import("@excalidraw/element/types").ExcalidrawLinearElement> | null;
-        newElement: NonDeleted<import("@excalidraw/element/types").ExcalidrawNonSelectionElement> | null;
+        multiElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawLinearElement> | null;
+        newElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawNonSelectionElement> | null;
         isBindingEnabled: boolean;
         isMidpointSnappingEnabled: boolean;
         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;
         isRotating: boolean;
-        elementsToHighlight: NonDeleted<ExcalidrawElement>[] | null;
+        elementsToHighlight: readonly import("@excalidraw/element/types").NonDeletedExcalidrawElement[] | null;
         collaborators: Map<import("../types").SocketId, import("../types").Collaborator>;
         snapLines: readonly import("../snapping").SnapLine[];
         zenModeEnabled: boolean;
@@ -120,9 +120,10 @@ export declare const loadFromJSON: (localAppState: AppState, localElements: read
         currentItemStrokeColor: 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;
@@ -131,6 +132,7 @@ export declare const loadFromJSON: (localAppState: AppState, localElements: read
         currentItemEndArrowhead: import("@excalidraw/element/types").Arrowhead | null;
         currentHoveredFontFamily: import("@excalidraw/element/types").FontFamilyValues | null;
         currentItemRoundness: import("@excalidraw/element/types").StrokeRoundness;
+        scrollConstraints: import("../types").ScrollConstraints | null;
         cursorButton: "up" | "down";
         scrolledOutside: boolean;
         isResizing: boolean;

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/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/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/{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/renderer/animation.d.ts

@@ -3,10 +3,14 @@ export type Animation<R extends object> = (params: {
     state?: R;
 }) => R | null | undefined;
 export declare class AnimationController {
-    private static isRunning;
+    private static scheduledFrame;
     private static animations;
     static start<R extends object>(key: string, animation: Animation<R>): void;
+    private static scheduleNextFrame;
+    private static cancelScheduledFrame;
+    private static cancelScheduledFrameIfIdle;
     private static tick;
     static running(key: string): boolean;
     static cancel(key: string): void;
+    static reset(): void;
 }

package/dist/types/excalidraw/renderer/interactiveScene.d.ts

@@ -1,9 +1,7 @@
 import { getScrollBars } from "../scene/scrollbars";
-import type { InteractiveSceneRenderConfig, RenderableElementsMap } from "../scene/types";
+import type { InteractiveSceneRenderConfig } from "../scene/types";
 declare const _renderInteractiveScene: ({ app, canvas, elementsMap, visibleElements, selectedElements, allElementsMap, scale, appState, renderConfig, editorInterface, animationState, deltaTime, }: InteractiveSceneRenderConfig) => {
     scrollBars?: ReturnType<typeof getScrollBars>;
-    atLeastOneVisibleElement: boolean;
-    elementsMap: RenderableElementsMap;
     animationState?: typeof animationState;
 };
 /**

package/dist/types/excalidraw/scene/Renderer.d.ts

@@ -64,7 +64,7 @@ export declare class Renderer {
             startArrowhead: import("@excalidraw/element/types").Arrowhead | null;
             endArrowhead: import("@excalidraw/element/types").Arrowhead | null;
         }> & {
-            isDeleted: boolean;
+            isDeleted: false;
         }) | (Readonly<{
             id: string;
             x: number;
@@ -98,7 +98,7 @@ export declare class Renderer {
         }> & {
             type: "rectangle";
         } & {
-            isDeleted: boolean;
+            isDeleted: false;
         }) | (Readonly<{
             id: string;
             x: number;
@@ -132,7 +132,7 @@ export declare class Renderer {
         }> & {
             type: "diamond";
         } & {
-            isDeleted: boolean;
+            isDeleted: false;
         }) | (Readonly<{
             id: string;
             x: number;
@@ -166,7 +166,7 @@ export declare class Renderer {
         }> & {
             type: "ellipse";
         } & {
-            isDeleted: boolean;
+            isDeleted: false;
         }) | (Readonly<{
             id: string;
             x: number;
@@ -200,7 +200,7 @@ export declare class Renderer {
         }> & Readonly<{
             type: "embeddable";
         }> & {
-            isDeleted: boolean;
+            isDeleted: false;
         }) | (Readonly<{
             id: string;
             x: number;
@@ -237,7 +237,7 @@ export declare class Renderer {
                 generationData?: import("@excalidraw/element/types").MagicGenerationData;
             };
         }> & {
-            isDeleted: boolean;
+            isDeleted: false;
         }) | (Readonly<{
             id: string;
             x: number;
@@ -275,7 +275,7 @@ export declare class Renderer {
             scale: [number, number];
             crop: import("@excalidraw/element/types").ImageCrop | null;
         }> & {
-            isDeleted: boolean;
+            isDeleted: false;
         }) | (Readonly<{
             id: string;
             x: number;
@@ -310,7 +310,7 @@ export declare class Renderer {
             type: "frame";
             name: string | null;
         } & {
-            isDeleted: boolean;
+            isDeleted: false;
         }) | (Readonly<{
             id: string;
             x: number;
@@ -345,7 +345,7 @@ export declare class Renderer {
             type: "magicframe";
             name: string | null;
         } & {
-            isDeleted: boolean;
+            isDeleted: false;
         }) | (Readonly<{
             id: string;
             x: number;
@@ -390,7 +390,7 @@ export declare class Renderer {
                 _brand: "unitlessLineHeight";
             };
         }> & {
-            isDeleted: boolean;
+            isDeleted: false;
         }) | (Readonly<{
             id: string;
             x: number;
@@ -426,8 +426,9 @@ export declare class Renderer {
             points: readonly import("@excalidraw/math").LocalPoint[];
             pressures: readonly number[];
             simulatePressure: boolean;
+            strokeOptions: import("@excalidraw/element/types").StrokeOptions;
         }> & {
-            isDeleted: boolean;
+            isDeleted: false;
         }) | null;
         canvasNonce: string;
     };