@myoc/math 0.19.521 → 0.19.522

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

@@ -4,7 +4,8 @@ import type { AppClassProperties } from "../types";
 type ToolOption = {
     type: string;
     icon: React.ReactNode;
-    title?: string;
+    title: string;
+    fillable?: boolean;
 };
 type ToolPopoverProps = {
     app: AppClassProperties;
@@ -13,13 +14,9 @@ type ToolPopoverProps = {
         type: string;
     };
     defaultOption: string;
-    className?: string;
-    namePrefix: string;
-    title: string;
     "data-testid": string;
     onToolChange: (type: string) => void;
     displayedOption: ToolOption;
-    fillable?: boolean;
 };
-export declare const ToolPopover: ({ app, options, activeTool, defaultOption, className, namePrefix, title, "data-testid": dataTestId, onToolChange, displayedOption, fillable, }: ToolPopoverProps) => import("react/jsx-runtime").JSX.Element;
+export declare const ToolPopover: ({ app, options, activeTool, defaultOption, "data-testid": dataTestId, onToolChange, displayedOption, }: ToolPopoverProps) => import("react/jsx-runtime").JSX.Element;
 export {};

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

@@ -0,0 +1,11 @@
+import type { AppClassProperties, AppProps, AppState, UIAppState } from "../types";
+/** the main (desktop/tablet) toolbar island */
+export declare const Toolbar: ({ app, appState, setAppState, UIOptions, onPenModeToggle, onLockToggle, heading, }: {
+    app: AppClassProperties;
+    appState: UIAppState;
+    setAppState: React.Component<any, AppState>["setState"];
+    UIOptions: AppProps["UIOptions"];
+    onPenModeToggle: AppClassProperties["togglePenMode"];
+    onLockToggle: () => void;
+    heading: React.ReactNode;
+}) => import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,146 @@
+import type { AppClassProperties, AppState, ToolType, UIAppState } from "../types";
+export type ToolConfig = {
+    icon: React.ReactNode;
+    /** letter shortcut(s) — the first one is shown in tooltips */
+    letterKey?: string | readonly string[];
+    /** whether `letterKey` requires Shift to be held (e.g. Shift+X) */
+    shiftKey?: boolean;
+    numericKey?: string;
+    /** whether the tool's shapes can be filled — fills the icon when active */
+    fillable?: boolean;
+    /**
+     * re-activating the tool switches back to the previously active tool
+     * (via the keyboard shortcut or ESC — see `setActiveTool`'s `toggle`
+     * option)
+     */
+    toggle?: boolean;
+};
+/**
+ * Tool data — the single source of truth for tool buttons, keyboard
+ * shortcuts (`findShapeByKey`), and the command palette. Toolbar placement
+ * is not defined here: toolbars compose the `*ToolButton` components below
+ * manually, so entries without a toolbar slot (e.g. laser) are data-only.
+ */
+export declare const TOOLS: {
+    hand: ToolConfig;
+    selection: ToolConfig;
+    rectangle: ToolConfig;
+    diamond: ToolConfig;
+    ellipse: ToolConfig;
+    arrow: ToolConfig;
+    line: ToolConfig;
+    freedraw: ToolConfig;
+    text: ToolConfig;
+    image: ToolConfig;
+    eraser: ToolConfig;
+    frame: ToolConfig;
+    autoshape: ToolConfig;
+    embeddable: ToolConfig;
+    laser: ToolConfig;
+    bucketfill: ToolConfig;
+    lasso: ToolConfig;
+};
+export type ToolbarToolType = keyof typeof TOOLS;
+/**
+ * tools that, when activated while already active, switch back to the
+ * previously active tool (see `setActiveTool`'s `toggle` option)
+ */
+export declare const TOGGLE_TOOLS: readonly (ToolType | "custom")[];
+export declare const getToolLetter: (type: ToolbarToolType) => string | undefined;
+/** human-readable shortcut hint, e.g. "R or 2", used in tooltips & aria */
+export declare const getToolShortcut: (type: ToolbarToolType) => string;
+export declare const findShapeByKey: (key: string, app: AppClassProperties, shiftKey?: boolean) => "line" | "arrow" | "text" | "selection" | "rectangle" | "diamond" | "ellipse" | "embeddable" | "image" | "frame" | "freedraw" | "lasso" | "eraser" | "hand" | "laser" | "autoshape" | "bucketfill" | null;
+/**
+ * Whether a toolbar entry activating the given tool renders disabled — true
+ * when the active tool is host-controlled (`props.activeTool`) and the entry
+ * doesn't activate the forced tool (`setActiveTool` refuses it).
+ */
+export declare const isToolButtonDisabled: (app: AppClassProperties, type: string) => boolean;
+export type ToolButtonComponentProps = {
+    app: AppClassProperties;
+    activeTool: UIAppState["activeTool"];
+    /** hide the keybinding badge rendered in the button's corner */
+    hideKeyBinding?: boolean;
+    /**
+     * hide all shortcut affordances (tooltip hint, aria-keyshortcuts, and the
+     * keybinding badge) — used on mobile where there's no keyboard
+     */
+    hideShortcut?: boolean;
+};
+export declare const HandToolButton: {
+    ({ app, activeTool, hideKeyBinding, hideShortcut, }: ToolButtonComponentProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+export declare const RectangleToolButton: {
+    ({ app, activeTool, hideKeyBinding, hideShortcut, }: ToolButtonComponentProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+export declare const DiamondToolButton: {
+    ({ app, activeTool, hideKeyBinding, hideShortcut, }: ToolButtonComponentProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+export declare const EllipseToolButton: {
+    ({ app, activeTool, hideKeyBinding, hideShortcut, }: ToolButtonComponentProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+export declare const ArrowToolButton: {
+    ({ app, activeTool, hideKeyBinding, hideShortcut, }: ToolButtonComponentProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+export declare const LineToolButton: {
+    ({ app, activeTool, hideKeyBinding, hideShortcut, }: ToolButtonComponentProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+export declare const FreedrawToolButton: {
+    ({ app, activeTool, hideKeyBinding, hideShortcut, }: ToolButtonComponentProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+export declare const TextToolButton: {
+    ({ app, activeTool, hideKeyBinding, hideShortcut, }: ToolButtonComponentProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+export declare const ImageToolButton: {
+    ({ app, activeTool, hideKeyBinding, hideShortcut, }: ToolButtonComponentProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+export declare const EraserToolButton: {
+    ({ app, activeTool, hideKeyBinding, hideShortcut, }: ToolButtonComponentProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+export declare const FrameToolButton: {
+    ({ app, activeTool, hideKeyBinding, hideShortcut, }: ToolButtonComponentProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+/**
+ * The selection tool button — pointer-clicking it while the selection tool
+ * is active switches to lasso.
+ */
+export declare const SelectionToolButton: {
+    ({ app, activeTool, hideKeyBinding, hideShortcut, }: ToolButtonComponentProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+/**
+ * Rendered in place of the selection button when lasso is the preferred
+ * selection tool; the selection shortcut activates it then.
+ */
+export declare const LassoToolButton: {
+    ({ app, activeTool, hideKeyBinding, hideShortcut, }: ToolButtonComponentProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+/**
+ * The selection ⇄ lasso popover used in compact (tablet) and mobile
+ * toolbars; picking an option also makes it the preferred selection tool.
+ */
+export declare const SelectionToolPopover: ({ app, activeTool, setAppState, }: {
+    app: AppClassProperties;
+    activeTool: UIAppState["activeTool"];
+    setAppState: React.Component<any, AppState>["setState"];
+}) => import("react/jsx-runtime").JSX.Element;
+/**
+ * The freedraw ⇄ draw-shape popover used in compact (tablet) and mobile
+ * toolbars. The trigger remembers and displays the most recently used option.
+ */
+export declare const FreedrawToolPopover: ({ app, activeTool, }: {
+    app: AppClassProperties;
+    activeTool: UIAppState["activeTool"];
+}) => import("react/jsx-runtime").JSX.Element;

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

@@ -7,12 +7,13 @@ export type GoToCollaboratorComponentProps = {
     withName: boolean;
     isBeingFollowed: boolean;
 };
-type UserListUserObject = Pick<Collaborator, "avatarUrl" | "id" | "socketId" | "username" | "isInCall" | "isSpeaking" | "isMuted">;
+type UserListUserObject = Pick<Collaborator, "avatarUrl" | "id" | "socketId" | "username" | "isInCall" | "isSpeaking" | "isMuted" | "isCurrentUser">;
 type UserListProps = {
     className?: string;
     mobile?: boolean;
     collaborators: Map<SocketId, UserListUserObject>;
     userToFollow: SocketId | null;
+    currentUserControls?: React.ReactNode | ((isMobile: boolean) => React.ReactNode);
 };
-export declare const UserList: React.MemoExoticComponent<({ className, mobile, collaborators, userToFollow }: UserListProps) => import("react/jsx-runtime").JSX.Element>;
+export declare const UserList: React.MemoExoticComponent<({ className, mobile, collaborators, userToFollow, currentUserControls, }: UserListProps) => import("react/jsx-runtime").JSX.Element>;
 export {};

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

@@ -0,0 +1,11 @@
+import "./ViewportStatusFrame.scss";
+import type { CSSProperties } from "react";
+import type { ViewportStatusFrame as ViewportStatusFrameType } from "../../types";
+export declare const ViewportStatusBorder: ({ border, style, }: {
+    border: string;
+    style?: CSSProperties;
+}) => import("react/jsx-runtime").JSX.Element;
+export declare const ViewportStatusBadge: ({ label, border, }: {
+    label: NonNullable<ViewportStatusFrameType["label"]>;
+    border?: ViewportStatusFrameType["border"];
+}) => import("react/jsx-runtime").JSX.Element;

package/dist/types/excalidraw/components/canvases/InteractiveCanvas.d.ts

@@ -18,6 +18,8 @@ type InteractiveCanvasProps = {
     renderScrollbars: boolean;
     editorInterface: EditorInterface;
     app: AppClassProperties;
+    interactionEnabled: boolean;
+    navigationEnabled: boolean;
     renderInteractiveSceneCallback: (data: RenderInteractiveSceneCallback) => void;
     handleCanvasRef: (canvas: HTMLCanvasElement | null) => void;
     onContextMenu: Exclude<DOMAttributes<HTMLCanvasElement | HTMLDivElement>["onContextMenu"], undefined>;

package/dist/types/excalidraw/components/footer/Footer.d.ts

@@ -1,11 +1,13 @@
 import type { ActionManager } from "../../actions/manager";
 import type { UIAppState } from "../../types";
 declare const Footer: {
-    ({ appState, actionManager, showExitZenModeBtn, renderWelcomeScreen, }: {
+    ({ appState, actionManager, showExitZenModeBtn, renderWelcomeScreen, defaultUIEnabled, zoomUIEnabled, }: {
         appState: UIAppState;
         actionManager: ActionManager;
         showExitZenModeBtn: boolean;
         renderWelcomeScreen: boolean;
+        defaultUIEnabled: boolean;
+        zoomUIEnabled: boolean;
     }): import("react/jsx-runtime").JSX.Element;
     displayName: string;
 };

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

@@ -56,6 +56,7 @@ export declare const saveAs: import("react/jsx-runtime").JSX.Element;
 export declare const LoadIcon: import("react/jsx-runtime").JSX.Element;
 export declare const clipboard: import("react/jsx-runtime").JSX.Element;
 export declare const palette: import("react/jsx-runtime").JSX.Element;
+export declare const bucketFillIconSvgPaths: readonly ["M5 16l1.465 1.638a2 2 0 1 1 -3.015 .099l1.55 -1.737z", "M13.737 9.737c2.299 -2.3 3.23 -5.095 2.081 -6.245c-1.15 -1.15 -3.945 -.217 -6.244 2.082c-2.3 2.299 -3.231 5.095 -2.082 6.244c1.15 1.15 3.946 .218 6.245 -2.081z", "M7.492 11.818c.362 .362 .768 .676 1.208 .934l6.895 4.047c1.078 .557 2.255 -.075 3.692 -1.512c1.437 -1.437 2.07 -2.614 1.512 -3.692c-.372 -.718 -1.72 -3.017 -4.047 -6.895a6.015 6.015 0 0 0 -.934 -1.208"];
 export declare const bucketFillIcon: import("react/jsx-runtime").JSX.Element;
 export declare const slashIcon: import("react/jsx-runtime").JSX.Element;
 export declare const ExportImageIcon: import("react/jsx-runtime").JSX.Element;
@@ -195,12 +196,13 @@ export declare const playerPlayIcon: import("react/jsx-runtime").JSX.Element;
 export declare const playerStopFilledIcon: import("react/jsx-runtime").JSX.Element;
 export declare const tablerCheckIcon: import("react/jsx-runtime").JSX.Element;
 export declare const alertTriangleIcon: import("react/jsx-runtime").JSX.Element;
+export declare const eyeDropperIconSvgPaths: readonly ["M4 16l11.7 -11.7a1 1 0 0 1 1.4 0l2.6 2.6a1 1 0 0 1 0 1.4l-11.7 11.7h-4v-4z", "M11 7l6 6"];
 export declare const eyeDropperIcon: import("react/jsx-runtime").JSX.Element;
-export declare const extraToolsIcon: import("react/jsx-runtime").JSX.Element;
 export declare const frameToolIcon: import("react/jsx-runtime").JSX.Element;
 export declare const RetryIcon: import("react/jsx-runtime").JSX.Element;
 export declare const stackPushIcon: import("react/jsx-runtime").JSX.Element;
 export declare const ArrowRightIcon: import("react/jsx-runtime").JSX.Element;
+export declare const drawShapeToolIcon: import("react/jsx-runtime").JSX.Element;
 export declare const laserPointerToolIcon: import("react/jsx-runtime").JSX.Element;
 export declare const MagicIcon: import("react/jsx-runtime").JSX.Element;
 export declare const MagicIconThin: import("react/jsx-runtime").JSX.Element;
@@ -251,6 +253,7 @@ export declare const sidebarRightIcon: import("react/jsx-runtime").JSX.Element;
 export declare const messageCircleIcon: import("react/jsx-runtime").JSX.Element;
 export declare const presentationIcon: import("react/jsx-runtime").JSX.Element;
 export declare const emptyIcon: import("react/jsx-runtime").JSX.Element;
+export declare const chevronDownIcon: import("react/jsx-runtime").JSX.Element;
 export declare const chevronRight: import("react/jsx-runtime").JSX.Element;
 export declare const settingsIcon: import("react/jsx-runtime").JSX.Element;
 export {};

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 { 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[]) => 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/context/tunnels.d.ts

@@ -12,7 +12,6 @@ type TunnelsContextValue = {
     DefaultSidebarTriggerTunnel: Tunnel;
     DefaultSidebarTabTriggersTunnel: Tunnel;
     OverwriteConfirmDialogTunnel: Tunnel;
-    TTDDialogTriggerTunnel: Tunnel;
     tunnelsJotai: ReturnType<typeof createIsolation>;
 };
 export declare const TunnelsContext: React.Context<TunnelsContextValue>;

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

@@ -65,12 +65,17 @@ fileHandle?: FileSystemFileHandle | null) => Promise<{
         newElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawNonSelectionElement> | null;
         isBindingEnabled: boolean;
         isMidpointSnappingEnabled: boolean;
+        gridModeEnabled: boolean;
         suggestedBinding: {
             element: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawBindableElement>;
             midPoint?: import("@excalidraw/math").GlobalPoint;
         } | null;
+        hoveredArrowTextAnchor: {
+            elementId: import("@excalidraw/element/types").ExcalidrawArrowElement["id"];
+            anchor: "start" | "end" | "label";
+        } | 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;
@@ -88,10 +93,9 @@ fileHandle?: FileSystemFileHandle | null) => Promise<{
         shouldCacheIgnoreZoom: boolean;
         exportScale: number;
         currentItemArrowType: "sharp" | "round" | "elbow";
-        bindMode: import("@excalidraw/element/types").BindMode;
         gridSize: number;
+        bindMode: import("@excalidraw/element/types").BindMode;
         viewModeOnly: boolean;
-        gridModeEnabled: boolean;
         objectsSnapModeEnabled: boolean;
         wheelZoomsOnDefault?: boolean | undefined;
         selectedElementsAreBeingDragged: boolean;
@@ -119,7 +123,7 @@ fileHandle?: FileSystemFileHandle | null) => Promise<{
         resizingElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
         boxSelectionMode: import("../types").BoxSelectionMode;
         bindingPreference: "enabled" | "disabled";
-        editingFrame: string | null;
+        editingFrame: import("@excalidraw/element/types").ExcalidrawFrameLikeElement["id"] | null;
         preferredSelectionTool: {
             type: "selection" | "lasso";
             initialized: boolean;
@@ -143,6 +147,7 @@ fileHandle?: FileSystemFileHandle | null) => Promise<{
         currentItemStartArrowhead: import("@excalidraw/element/types").Arrowhead | null;
         currentItemEndArrowhead: import("@excalidraw/element/types").Arrowhead | null;
         currentItemRoundness: import("@excalidraw/element/types").StrokeRoundness;
+        scrollConstraints: import("../types").ScrollConstraints | null;
         cursorButton: "up" | "down";
         scrolledOutside: boolean;
         isResizing: boolean;
@@ -172,11 +177,14 @@ fileHandle?: FileSystemFileHandle | null) => Promise<{
             x: number;
             y: number;
         } | null;
-        userToFollow: import("../types").UserToFollow | null;
-        followedBy: Set<import("../types").SocketId>;
         lockedMultiSelections: {
             [groupId: string]: true;
         };
+        colorTopPicks: {
+            elementStroke: readonly string[] | null;
+            elementBackground: readonly string[] | null;
+            bucketFill: readonly string[] | 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 } from "../types";
 import type { ImportedDataState } from "./types";
 export type JSONExportData = {
-    elements: readonly NonDeleted<ExcalidrawElement>[];
+    elements: readonly ExcalidrawElement[];
     appState: AppState;
     files: BinaryFiles;
 };
@@ -47,7 +47,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;
@@ -62,16 +62,21 @@ 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;
+        gridModeEnabled: 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;
+        hoveredArrowTextAnchor: {
+            elementId: import("@excalidraw/element/types").ExcalidrawArrowElement["id"];
+            anchor: "start" | "end" | "label";
+        } | 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;
@@ -89,10 +94,9 @@ export declare const loadFromJSON: (localAppState: AppState, localElements: read
         shouldCacheIgnoreZoom: boolean;
         exportScale: number;
         currentItemArrowType: "sharp" | "round" | "elbow";
-        bindMode: import("@excalidraw/element/types").BindMode;
         gridSize: number;
+        bindMode: import("@excalidraw/element/types").BindMode;
         viewModeOnly: boolean;
-        gridModeEnabled: boolean;
         objectsSnapModeEnabled: boolean;
         wheelZoomsOnDefault?: boolean | undefined;
         selectedElementsAreBeingDragged: boolean;
@@ -120,7 +124,7 @@ export declare const loadFromJSON: (localAppState: AppState, localElements: read
         resizingElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
         boxSelectionMode: import("../types").BoxSelectionMode;
         bindingPreference: "enabled" | "disabled";
-        editingFrame: string | null;
+        editingFrame: import("@excalidraw/element/types").ExcalidrawFrameLikeElement["id"] | null;
         preferredSelectionTool: {
             type: "selection" | "lasso";
             initialized: boolean;
@@ -144,6 +148,7 @@ export declare const loadFromJSON: (localAppState: AppState, localElements: read
         currentItemStartArrowhead: import("@excalidraw/element/types").Arrowhead | null;
         currentItemEndArrowhead: import("@excalidraw/element/types").Arrowhead | null;
         currentItemRoundness: import("@excalidraw/element/types").StrokeRoundness;
+        scrollConstraints: import("../types").ScrollConstraints | null;
         cursorButton: "up" | "down";
         scrolledOutside: boolean;
         isResizing: boolean;
@@ -173,11 +178,14 @@ export declare const loadFromJSON: (localAppState: AppState, localElements: read
             x: number;
             y: number;
         } | null;
-        userToFollow: import("../types").UserToFollow | null;
-        followedBy: Set<import("../types").SocketId>;
         lockedMultiSelections: {
             [groupId: string]: true;
         };
+        colorTopPicks: {
+            elementStroke: readonly string[] | null;
+            elementBackground: readonly string[] | null;
+            bucketFill: readonly string[] | null;
+        };
     };
     files: BinaryFiles;
 }>;

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/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/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[];
 };

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

@@ -1,9 +1,16 @@
+import type { ElementsMap, NonDeletedExcalidrawElement } from "@excalidraw/element/types";
 import { getScrollBars } from "../scene/scrollbars";
-import type { InteractiveSceneRenderConfig, RenderableElementsMap } from "../scene/types";
+import type { InteractiveCanvasAppState } from "../types";
+import type { InteractiveSceneRenderConfig } from "../scene/types";
+type ImageStatusOverlayPlacement = "center" | "top-right";
+export declare const getImageStatusOverlayPosition: (element: NonDeletedExcalidrawElement, elementsMap: ElementsMap, appState: InteractiveCanvasAppState, placement: ImageStatusOverlayPlacement) => {
+    centerX: number;
+    centerY: number;
+    radius: number;
+    lineWidth: number;
+} | null;
 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;
 };
 /**