@excalidraw/math 0.18.0-4e471c107 → 0.18.0-4f68076

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

@@ -0,0 +1,63 @@
+import type { ExcalidrawNonSelectionElement, NonDeleted } from "@excalidraw/element/types";
+import type App from "./App";
+import type { ToolType } from "../types";
+type ScenePoint = {
+    x: number;
+    y: number;
+};
+/** what a drag places: any element the new-element canvas can preview */
+type DraggedElement = NonDeleted<ExcalidrawNonSelectionElement>;
+/**
+ * A tool the user can drag out of the toolbar to drop a default-sized element
+ * where the pointer is released.
+ */
+type DraggableTool = {
+    /** the element the drop creates, centered on the pointer */
+    createElement: (app: App, center: ScenePoint) => DraggedElement;
+    /** what the tool does once its element is on the canvas (e.g. start editing) */
+    onDrop?: (app: App, element: DraggedElement) => void;
+};
+/**
+ * The tools that can be dragged out of the toolbar. Add an entry to make a
+ * tool's button draggable — the gesture, preview and drop are shared.
+ */
+export declare const DRAGGABLE_TOOLS: Partial<Record<ToolType, DraggableTool>>;
+/** CSS opacity of the preview canvas while dragging */
+export declare const TOOL_DRAG_PREVIEW_OPACITY = 0.5;
+/**
+ * Dragging a tool out of the toolbar. The preview element exists only here
+ * until the drop — it is not in the scene, the store or the history, so
+ * collaborators never see it and an aborted drag leaves nothing behind. It
+ * is painted by the `NewElementCanvas`, drawn exactly as it will land, with
+ * the canvas itself made translucent.
+ *
+ * The button arms on pointerdown; the drag starts once the pointer has
+ * moved `DRAGGING_THRESHOLD`, so a plain click still selects the tool. The
+ * gesture lives on the owner window (the pointer leaves the button at once),
+ * like the other pointer gestures in `App`.
+ */
+export declare class AppToolDrag {
+    private app;
+    constructor(app: App);
+    /** the element under the pointer while dragging, `null` otherwise */
+    preview: DraggedElement | null;
+    private armed;
+    private tool;
+    private type;
+    static isDraggable: (type: ToolType) => boolean;
+    isDragging: () => boolean;
+    /**
+     * Arm a drag from a tool button's pointerdown. Returns whether the tool is
+     * draggable (the caller lets a non-draggable press fall through).
+     */
+    handleButtonPointerDown: (type: ToolType, event: PointerEvent) => boolean;
+    private onPointerMove;
+    private onPointerUp;
+    private onKeyDown;
+    /** drop the gesture without a trace */
+    cancel: () => void;
+    private isOverCanvas;
+    private addListeners;
+    private removeListeners;
+}
+export {};

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

@@ -0,0 +1,113 @@
+import { type StylesPanelMode } from "@excalidraw/common";
+import type { NonDeletedSceneElementsMap } from "@excalidraw/element/types";
+import { type SetViewportOptions } from "../viewport";
+import type { AppProps, AppState, Offsets, ScrollConstraints, ViewportOffsets, ViewportOffsetsOptions, ViewportUIName } from "../types";
+import type App from "./App";
+export declare const SCROLL_TO_CONTENT_ANIMATION_KEY = "animateScrollToContent";
+export declare const SCROLL_CONSTRAINTS_SNAP_BACK_ANIMATION_KEY = "animateScrollConstraintsSnapBack";
+/** single source of truth for the `--right-sidebar-width` CSS variable */
+export declare const RIGHT_SIDEBAR_WIDTH = 302;
+type Viewport = Pick<AppState, "scrollX" | "scrollY" | "zoom">;
+type AppViewportDependencies = {
+    getContainer: () => HTMLDivElement | null;
+    getStylesPanelMode: () => StylesPanelMode;
+    isGestureActive: () => boolean;
+};
+/**
+ * Rubberband snap-back: animates the viewport from its current (possibly
+ * overscrolled) position back inside the lock box via the shared
+ * AnimationController. No-op when already within the hard bounds (or when
+ * there is no lock).
+ */
+export declare const snapBackToConstraints: (state: Pick<AppState, "scrollX" | "scrollY" | "zoom" | "width" | "height" | "scrollConstraints">, onFrame: (updater: (state: Pick<AppState, "scrollX" | "scrollY" | "zoom" | "width" | "height" | "scrollConstraints">) => Viewport | null) => void, duration?: number) => void;
+/**
+ * Owns viewport state transitions and App-bound viewport concerns. Pure
+ * viewport geometry remains in `viewport.ts` so actions and public helpers can
+ * calculate state without an App instance.
+ */
+export declare class AppViewport {
+    private app;
+    private dependencies;
+    lastPosition: {
+        x: number;
+        y: number;
+    };
+    private activeTransition;
+    private uiLastMeasured;
+    constructor(app: App, dependencies: AppViewportDependencies);
+    get isAnimating(): boolean;
+    /** Whether a programmatic transition into a locked viewport currently owns
+     * user pan/zoom input. */
+    get isLockedTransitionPending(): boolean;
+    invalidateUIOffset: (name: ViewportUIName) => void;
+    /**
+     * The side a rendered side UI (`data-viewport-ui="side"`) docks to, and
+     * how far it reaches into the canvas from it, in screen px.
+     */
+    private measureSide;
+    /**
+     * The side a named surface docks to while it's hidden, and how far it
+     * reaches into the canvas from it: as last measured, else approximately.
+     */
+    private getReservedSide;
+    private querySideUI;
+    /**
+     * Where a rendered side UI is, relative to the editor's container, in
+     * screen px; null when it isn't rendered.
+     */
+    getSideUIRect: (name: ViewportUIName) => {
+        left: number;
+        right: number;
+        top: number;
+        bottom: number;
+    } | null;
+    /**
+     * How far the named side UIs reach into the canvas, in screen px, from
+     * the left and the right: the part of the canvas they cover. Zero at a
+     * side none of them is rendered at — e.g. with the sidebar closed, or on
+     * phones, where it's an overlay that doesn't count as viewport UI — unless
+     * a hidden one is reserved (see `ViewportOffsetsOptions.reserve`).
+     */
+    getSideInsets: (names: readonly ViewportUIName[], opts?: Pick<ViewportOffsetsOptions, "reserve">) => {
+        left: number;
+        right: number;
+    };
+    /** How far the sidebar reaches into the canvas (see `getSideInsets`). */
+    getSidebarInsets: () => {
+        left: number;
+        right: number;
+    };
+    /**
+     * Resolves user-supplied viewport offsets into concrete per-side pixel
+     * values. Static sides take precedence over UI-derived sides.
+     */
+    resolveOffsets: (offsets: ViewportOffsets | undefined) => Offsets | undefined;
+    /**
+     * Measures the currently rendered editor UI and returns the usable viewport
+     * offsets, including optional padding and reserved hidden surfaces.
+     */
+    getOffsets: (opts?: ViewportOffsetsOptions) => Offsets;
+    /** Resolves the host-supplied initial viewport against restored scene data. */
+    resolveInitialViewport: (opts: Omit<SetViewportOptions, "animation">, elementsMap: NonDeletedSceneElementsMap, appState: AppState) => (Viewport & {
+        scrollConstraints: ScrollConstraints | null;
+    }) | null;
+    /**
+     * Navigates to a target and optionally installs scroll/zoom constraints.
+     * Navigating stops following a collaborator, as a user's pan does.
+     */
+    setViewport: (opts: SetViewportOptions | null) => void;
+    /** Use when changing scrollX/scrollY/zoom based on user interaction. */
+    translate: <K extends keyof AppState>(state: AppState | Pick<AppState, K> | null | ((prevState: Readonly<AppState>, props: Readonly<AppProps>) => AppState | Pick<AppState, K> | null), opts?: {
+        zoomPreConstrained?: boolean;
+        preserveScrollConstraintsSnapBack?: boolean;
+    }) => boolean;
+    /** Clamps the viewport into the active scroll constraints. */
+    constrain: (overscroll?: number) => void;
+    /** Releases a held rubberband overscroll. */
+    releaseOverscroll: () => void;
+    private snapBack;
+    private snapBackDebounced;
+    private cancelTransition;
+    destroy: () => void;
+}
+export {};

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

@@ -0,0 +1,26 @@
+import type App from "./App";
+/**
+ * Wheel input over the editor: pans the canvas, or zooms it around the
+ * pointer (`viewport.lastPosition`) — on ctrl/cmd+wheel (which is also how
+ * a trackpad pinch is delivered), while the wheel button itself is held
+ * down, or on a plain wheel when the input device is a mouse
+ * (`appState.inputDevice`). Shift+wheel pans horizontally;
+ * ctrl/cmd+shift+wheel pans vertically.
+ */
+export declare class AppWheel {
+    private app;
+    constructor(app: App);
+    /** the editor surfaces whose wheel input the editor consumes; everywhere
+     * else (menus, sidebars, …) the DOM keeps scrolling. The frame-name labels
+     * are DOM, but sit inside the container this listener is attached to */
+    private isOverEditorSurface;
+    handle: (event: WheelEvent) => void;
+    /**
+     * Prevents the browser's own zoom over the non-interactive editor while
+     * letting regular scroll through (trackpad pinch is delivered as
+     * ctrl+wheel).
+     */
+    preventBrowserZoom: (event: WheelEvent) => void;
+    /** zooms around the pointer by a wheel delta (positive = zoom out) */
+    private zoomBy;
+}

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

@@ -0,0 +1,37 @@
+import type { AppState, UnsubscribeCallback } from "../types";
+type StateChangeSelector = keyof AppState | (keyof AppState)[] | ((appState: AppState) => unknown);
+export type OnStateChange = {
+    <K extends keyof AppState>(prop: K, callback: (value: AppState[K], appState: AppState) => void, opts?: {
+        once: boolean;
+    }): UnsubscribeCallback;
+    <K extends keyof AppState>(prop: K): Promise<AppState[K]>;
+    (prop: (keyof AppState)[], callback: (appState: AppState, appState2: AppState) => void, opts?: {
+        once: boolean;
+    }): UnsubscribeCallback;
+    (prop: (keyof AppState)[]): Promise<AppState>;
+    <T>(prop: (appState: AppState) => T, callback: (value: T, appState: AppState) => void, opts?: {
+        once: boolean;
+    }): UnsubscribeCallback;
+    <T>(prop: (appState: AppState) => T): Promise<T>;
+    (opts: {
+        predicate: (appState: AppState) => boolean;
+        callback: (appState: AppState) => void;
+        once?: boolean;
+    }): UnsubscribeCallback;
+    (opts: {
+        predicate: (appState: AppState) => boolean;
+    }): Promise<AppState>;
+    (selector: StateChangeSelector, callback: (value: any, appState: AppState) => void): any;
+};
+export declare class AppStateObserver {
+    private readonly getState;
+    private listeners;
+    constructor(getState: () => AppState);
+    private isStateChangePredicateOptions;
+    private subscribe;
+    private normalize;
+    onStateChange: OnStateChange;
+    flush(prevState: AppState): void;
+    clear(): void;
+}
+export {};

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

@@ -1,7 +1,5 @@
-/// <reference types="react" />
-import OpenColor from "open-color";
 import "./Card.scss";
 export declare const Card: React.FC<{
-    color: keyof OpenColor | "primary";
+    color: "primary" | "lime" | "pink";
     children?: React.ReactNode;
 }>;

package/dist/types/excalidraw/components/ColorPicker/ColorInput.d.ts

@@ -1,10 +1,8 @@
 import type { ColorPickerType } from "./colorPickerUtils";
-interface ColorInputProps {
+export declare const ColorInput: ({ color, onChange, label, colorPickerType, placeholder, }: {
     color: string;
     onChange: (color: string) => void;
     label: string;
     colorPickerType: ColorPickerType;
     placeholder?: string;
-}
-export declare const ColorInput: ({ color, onChange, label, colorPickerType, placeholder, }: ColorInputProps) => import("react/jsx-runtime").JSX.Element;
-export {};
+}) => import("react/jsx-runtime").JSX.Element;

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

@@ -2,8 +2,7 @@ import type { ColorTuple, ColorPaletteCustom } from "@excalidraw/common";
 import type { ExcalidrawElement } from "@excalidraw/element/types";
 import "./ColorPicker.scss";
 import type { ColorPickerType } from "./colorPickerUtils";
-import type { AppState } from "../../types";
-export declare const getColor: (color: string) => string | null;
+import type { AppState, UIAppState } from "../../types";
 interface ColorPickerProps {
     type: ColorPickerType;
     /**
@@ -14,10 +13,16 @@ interface ColorPickerProps {
     onChange: (color: string) => void;
     label: string;
     elements: readonly ExcalidrawElement[];
-    appState: AppState;
+    appState: UIAppState;
     palette?: ColorPaletteCustom | null;
     topPicks?: ColorTuple;
     updateData: (formData?: any) => void;
+    /** palette colors to hide from the popup, keeping hotkey positions */
+    excludedColors?: readonly string[];
+    /** allow users to customize the top picks strip by drag & dropping colors
+     * from the picker popup onto it. The value names the
+     * `appState.colorTopPicks` slot the customization is stored in */
+    customizableTopPicks?: keyof AppState["colorTopPicks"];
 }
-export declare const ColorPicker: ({ type, color, onChange, label, elements, palette, topPicks, updateData, appState, }: ColorPickerProps) => import("react/jsx-runtime").JSX.Element;
+export declare const ColorPicker: import("react").MemoExoticComponent<({ type, color, onChange, label, elements, palette, topPicks, updateData, appState, excludedColors, customizableTopPicks, }: ColorPickerProps) => import("react/jsx-runtime").JSX.Element>;
 export {};

package/dist/types/excalidraw/components/ColorPicker/CustomColorList.d.ts

@@ -1,8 +1,10 @@
+import type { Theme } from "@excalidraw/element/types";
 interface CustomColorListProps {
+    theme: Theme;
     colors: string[];
     color: string | null;
     onChange: (color: string) => void;
     label: string;
 }
-export declare const CustomColorList: ({ colors, color, onChange, label, }: CustomColorListProps) => import("react/jsx-runtime").JSX.Element;
+export declare const CustomColorList: ({ theme, colors, color, onChange, label, }: CustomColorListProps) => import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/types/excalidraw/components/ColorPicker/Picker.d.ts

@@ -1,8 +1,9 @@
 import React from "react";
-import type { ExcalidrawElement } from "@excalidraw/element/types";
+import type { ExcalidrawElement, Theme } from "@excalidraw/element/types";
 import type { ColorPaletteCustom } from "@excalidraw/common";
 import type { ColorPickerType } from "./colorPickerUtils";
 interface PickerProps {
+    theme: Theme;
     color: string | null;
     onChange: (color: string) => void;
     type: ColorPickerType;
@@ -10,8 +11,13 @@ interface PickerProps {
     palette: ColorPaletteCustom;
     updateData: (formData?: any) => void;
     children?: React.ReactNode;
+    showTitle?: boolean;
     onEyeDropperToggle: (force?: boolean) => void;
     onEscape: (event: React.KeyboardEvent | KeyboardEvent) => void;
+    showHotKey?: boolean;
+    excludedColors?: readonly string[];
+    /** present only while the top picks are customized */
+    onResetTopPicks?: () => void;
 }
 export declare const Picker: React.ForwardRefExoticComponent<PickerProps & React.RefAttributes<unknown>>;
 export {};

package/dist/types/excalidraw/components/ColorPicker/PickerColorList.d.ts

@@ -1,9 +1,17 @@
-import type { ColorPaletteCustom } from "@excalidraw/common";
+import { type ColorPaletteCustom } from "@excalidraw/common";
+import type { Theme } from "@excalidraw/element/types";
 interface PickerColorListProps {
+    theme: Theme;
     palette: ColorPaletteCustom;
     color: string | null;
     onChange: (color: string) => void;
     activeShade: number;
+    showHotKey?: boolean;
+    /**
+     * palette colors to hide. Hidden entries keep their position in the hotkey
+     * order (their hotkey goes dead instead of remapping the colors after them).
+     */
+    excludedColors?: readonly string[];
 }
-declare const PickerColorList: ({ palette, color, onChange, activeShade, }: PickerColorListProps) => import("react/jsx-runtime").JSX.Element;
+declare const PickerColorList: ({ theme, palette, color, onChange, activeShade, showHotKey, excludedColors, }: PickerColorListProps) => import("react/jsx-runtime").JSX.Element;
 export default PickerColorList;

package/dist/types/excalidraw/components/ColorPicker/ShadeList.d.ts

@@ -1,8 +1,11 @@
-import type { ColorPaletteCustom } from "@excalidraw/common";
+import { type ColorPaletteCustom } from "@excalidraw/common";
+import type { Theme } from "@excalidraw/element/types";
 interface ShadeListProps {
+    theme: Theme;
     color: string | null;
     onChange: (color: string) => void;
     palette: ColorPaletteCustom;
+    showHotKey?: boolean;
 }
-export declare const ShadeList: ({ color, onChange, palette }: ShadeListProps) => import("react/jsx-runtime").JSX.Element;
+export declare const ShadeList: ({ theme, color, onChange, palette, showHotKey, }: ShadeListProps) => import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/types/excalidraw/components/ColorPicker/TopPicks.d.ts

@@ -1,9 +1,16 @@
+import type { Theme } from "@excalidraw/element/types";
 import type { ColorPickerType } from "./colorPickerUtils";
 interface TopPicksProps {
+    theme: Theme;
     onChange: (color: string) => void;
     type: ColorPickerType;
     activeColor: string | null;
     topPicks?: readonly string[];
+    /** present when the strip is user-customizable — enables the right-click
+     * context menu resetting the strip to its default picks */
+    onReset?: () => void;
+    /** whether custom picks are currently applied (enables the reset item) */
+    isCustomized?: boolean;
 }
-export declare const TopPicks: ({ onChange, type, activeColor, topPicks, }: TopPicksProps) => import("react/jsx-runtime").JSX.Element | null;
+export declare const TopPicks: ({ theme, onChange, type, activeColor, topPicks, onReset, isCustomized, }: TopPicksProps) => import("react/jsx-runtime").JSX.Element | null;
 export {};

package/dist/types/excalidraw/components/ColorPicker/colorPickerUtils.d.ts

@@ -14,8 +14,7 @@ export declare const isCustomColor: ({ color, palette, }: {
 }) => boolean;
 export declare const getMostUsedCustomColors: (elements: readonly ExcalidrawElement[], type: "elementBackground" | "elementStroke", palette: ColorPaletteCustom) => string[];
 export type ActiveColorPickerSectionAtomType = "custom" | "baseColors" | "shades" | "hex" | null;
-export declare const activeColorPickerSectionAtom: import("jotai/vanilla/atom").PrimitiveAtom<ActiveColorPickerSectionAtomType> & {
+export declare const activeColorPickerSectionAtom: import("jotai").PrimitiveAtom<ActiveColorPickerSectionAtomType> & {
     init: ActiveColorPickerSectionAtomType;
 };
-export declare const isColorDark: (color: string, threshold?: number) => boolean;
 export type ColorPickerType = "canvasBackground" | "elementBackground" | "elementStroke";

package/dist/types/excalidraw/components/ColorPicker/colorTopPicksDnD.d.ts

@@ -0,0 +1,11 @@
+import type { TopPicksDnD } from "../TopPicksDnD/topPicksDnD";
+export type ColorPickerDnD = TopPicksDnD<string>;
+export declare const ColorPickerDnDContext: import("react").Context<ColorPickerDnD | null>;
+export declare const useColorPickerDnD: () => ColorPickerDnD | null;
+/** pinning colors from the picker popup (palette/shades/custom) or the
+ * active-color trigger to the top-picks strip, and reordering the strip */
+export declare const useColorTopPicksDnD: ({ enabled, picks, onPicksChange, }: {
+    enabled: boolean;
+    picks: readonly string[];
+    onPicksChange: (picks: string[]) => void;
+}) => ColorPickerDnD;

package/dist/types/excalidraw/components/ColorPicker/keyboardNavHandlers.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import type { ColorPaletteCustom } from "@excalidraw/common";
 import type { ActiveColorPickerSectionAtomType } from "./colorPickerUtils";
 interface ColorPickerKeyNavHandlerProps {
@@ -13,9 +12,10 @@ interface ColorPickerKeyNavHandlerProps {
     activeShade: number;
     onEyeDropperToggle: (force?: boolean) => void;
     onEscape: (event: React.KeyboardEvent | KeyboardEvent) => void;
+    excludedColors?: readonly string[];
 }
 /**
  * @returns true if the event was handled
  */
-export declare const colorPickerKeyNavHandler: ({ event, activeColorPickerSection, palette, color, onChange, customColors, setActiveColorPickerSection, updateData, activeShade, onEyeDropperToggle, onEscape, }: ColorPickerKeyNavHandlerProps) => boolean;
+export declare const colorPickerKeyNavHandler: ({ event, activeColorPickerSection, palette, color, onChange, customColors, setActiveColorPickerSection, updateData, activeShade, onEyeDropperToggle, onEscape, excludedColors, }: ColorPickerKeyNavHandlerProps) => boolean;
 export {};

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

@@ -8,6 +8,7 @@ export declare const DEFAULT_CATEGORIES: {
     editor: string;
     elements: string;
     links: string;
+    library: string;
 };
 type CommandPaletteProps = {
     customCommandPaletteItems?: CommandPaletteItem[];

package/dist/types/excalidraw/components/CommandPalette/defaultCommandPaletteItems.d.ts

@@ -1,2 +1 @@
-import type { CommandPaletteItem } from "./types";
-export declare const toggleTheme: CommandPaletteItem;
+export {};

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

@@ -1,7 +1,5 @@
-/// <reference types="react" />
 import type { ActionManager } from "../../actions/manager";
 import type { Action } from "../../actions/types";
-import type { UIAppState } from "../../types";
 export type CommandPaletteItem = {
     label: string;
     /** additional keywords to match against
@@ -12,11 +10,11 @@ export type CommandPaletteItem = {
      * (deburred name + keywords)
      */
     haystack?: string;
-    icon?: React.ReactNode | ((appState: UIAppState) => React.ReactNode);
+    icon?: Action["icon"];
     category: string;
     order?: number;
     predicate?: boolean | Action["predicate"];
-    shortcut?: string;
+    shortcut?: string | null;
     /** if false, command will not show while in view mode */
     viewMode?: boolean;
     perform: (data: {

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

@@ -2,7 +2,7 @@ import type { ConvertibleTypes, ExcalidrawElement, ExcalidrawTextContainer, Exca
 import type { Scene } from "@excalidraw/element";
 import "./ConvertElementTypePopup.scss";
 import type App from "./App";
-export declare const convertElementTypePopupAtom: import("jotai/vanilla/atom").PrimitiveAtom<{
+export declare const convertElementTypePopupAtom: import("jotai").PrimitiveAtom<{
     type: "panel";
 } | null> & {
     init: {
@@ -16,8 +16,8 @@ export declare const adjustBoundTextSize: (container: ExcalidrawTextContainer, b
 type ConversionType = "generic" | "linear" | null;
 export declare const convertElementTypes: (app: App, { conversionType, nextType, direction, }: {
     conversionType: ConversionType;
-    nextType?: ConvertibleTypes | undefined;
-    direction?: "left" | "right" | undefined;
+    nextType?: ConvertibleTypes;
+    direction?: "left" | "right";
 }) => boolean;
-export declare const getConversionTypeFromElements: (elements: ExcalidrawElement[]) => ConversionType;
+export declare const getConversionTypeFromElements: (elements: readonly ExcalidrawElement[]) => ConversionType;
 export default ConvertElementTypePopup;

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

@@ -0,0 +1,46 @@
+import "./CursorHint.scss";
+import type { AppClassProperties, AppState } from "../types";
+/**
+ * While a recently shown hint is still fresh in memory, tool-switch hints
+ * are suppressed (repeatedly re-picking a tool you just used doesn't need
+ * the reminder). Cycling arrow types and numeric shortcuts bypass this.
+ */
+export declare const CURSOR_HINT_COOLDOWN: number;
+export declare const cursorHintAtom: import("jotai").PrimitiveAtom<{
+    content: React.ReactNode;
+    /** unique per trigger so a re-trigger restarts the hide timer */
+    nonce: number;
+} | null> & {
+    init: {
+        content: React.ReactNode;
+        /** unique per trigger so a re-trigger restarts the hide timer */
+        nonce: number;
+    } | null;
+};
+/**
+ * Owns the cursor-hint policy. App reports semantic interaction events
+ * (what the user did); all decisions about whether and what to show —
+ * cooldown, bypasses, hint content — are made here.
+ */
+export declare class CursorHints {
+    private app;
+    private lastShownAt;
+    constructor(app: AppClassProperties);
+    /**
+     * Shows a transient tooltip next to the cursor, hidden automatically
+     * after a short delay. Repeated calls replace the content and restart
+     * the timer.
+     */
+    show: (content: React.ReactNode) => void;
+    private isOnCooldown;
+    /** arrow type cycled via shortcut (arrow tool already active) */
+    onArrowTypeCycled: (arrowType: AppState["currentItemArrowType"]) => void;
+    /** arrow/line tool picked via keyboard shortcut */
+    onToolShortcut: (tool: "arrow" | "line", source: "letter" | "digit") => void;
+}
+/**
+ * Transient tooltip shown next to the cursor for added affordance after
+ * actions that have no other visual feedback near the pointer (e.g. cycling
+ * arrow types via shortcut). Trigger via `app.cursorHints`.
+ */
+export declare const CursorHint: () => import("react/jsx-runtime").JSX.Element | null;

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

@@ -3,5 +3,5 @@ import "./ToolIcon.scss";
 export declare const DarkModeToggle: (props: {
     value: Theme;
     onChange: (value: Theme) => void;
-    title?: string | undefined;
+    title?: string;
 }) => import("react/jsx-runtime").JSX.Element;

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

@@ -1,26 +1,22 @@
-/// <reference types="react" />
 import type { MarkOptional } from "@excalidraw/common/utility-types";
 import "../components/dropdownMenu/DropdownMenu.scss";
 import type { SidebarProps, SidebarTriggerProps } from "./Sidebar/common";
 export declare const DefaultSidebar: import("react").FC<Omit<MarkOptional<Omit<{
-    name: string;
-    children: import("react").ReactNode;
-    onStateChange?: ((state: {
-        name: string;
-        tab?: string | undefined;
-    } | null) => void) | undefined;
-    onDock?: ((docked: boolean) => void) | undefined;
-    docked?: boolean | undefined;
-    className?: string | undefined;
-    __fallback?: boolean | undefined;
+    name: import("../types").SidebarName;
+    children: React.ReactNode;
+    onStateChange?: (state: import("../types").AppState["openSidebar"]) => void;
+    onDock?: (docked: boolean) => void;
+    docked?: boolean;
+    className?: string;
+    __fallback?: boolean;
 }, "name">, "children">, "onDock"> & {
     /** pass `false` to disable docking */
     onDock?: SidebarProps["onDock"] | false;
 } & {
-    __fallback?: boolean | undefined;
+    __fallback?: boolean;
 }> & {
     Trigger: import("react").FC<Omit<SidebarTriggerProps, "name"> & import("react").HTMLAttributes<HTMLDivElement> & {
-        __fallback?: boolean | undefined;
+        __fallback?: boolean;
     }>;
     TabTriggers: {
         ({ children }: {

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

@@ -6,7 +6,7 @@ declare const ElementLinkDialog: ({ sourceElementId, onClose, appState, scene, g
     sourceElementId: ExcalidrawElement["id"];
     appState: UIAppState;
     scene: Scene;
-    onClose?: (() => void) | undefined;
+    onClose?: () => void;
     generateLinkForSelection: AppProps["generateLinkForSelection"];
 }) => import("react/jsx-runtime").JSX.Element;
 export default ElementLinkDialog;

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

@@ -0,0 +1,3 @@
+export declare const Ellipsify: ({ children, ...rest }: {
+    children: React.ReactNode;
+} & React.HTMLAttributes<HTMLSpanElement>) => import("react/jsx-runtime").JSX.Element;

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

@@ -1,5 +1,5 @@
 import React from "react";
 export declare const ErrorDialog: ({ children, onClose, }: {
     children?: React.ReactNode;
-    onClose?: (() => void) | undefined;
+    onClose?: () => void;
 }) => import("react/jsx-runtime").JSX.Element;

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

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import type { ExcalidrawElement } from "@excalidraw/element/types";
 import "./EyeDropper.scss";
 import type { ColorPickerType } from "./ColorPicker/colorPickerUtils";
@@ -14,7 +13,7 @@ export type EyeDropperProperties = {
      **/
     colorPickerType: ColorPickerType;
 };
-export declare const activeEyeDropperAtom: import("jotai/vanilla/atom").PrimitiveAtom<EyeDropperProperties | null> & {
+export declare const activeEyeDropperAtom: import("jotai").PrimitiveAtom<EyeDropperProperties | null> & {
     init: EyeDropperProperties | null;
 };
 export declare const EyeDropper: React.FC<{

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

@@ -0,0 +1,2 @@
+import "./FileDropOverlay.scss";
+export declare const FileDropOverlay: () => import("react/jsx-runtime").JSX.Element | null;

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

@@ -4,7 +4,7 @@ export type ButtonVariant = "filled" | "outlined" | "icon";
 export type ButtonColor = "primary" | "danger" | "warning" | "muted" | "success";
 export type ButtonSize = "medium" | "large";
 export type FilledButtonProps = {
-    label: string;
+    label?: string;
     children?: React.ReactNode;
     onClick?: (event: React.MouseEvent) => void;
     status?: null | "loading" | "success";
@@ -14,5 +14,6 @@ export type FilledButtonProps = {
     className?: string;
     fullWidth?: boolean;
     icon?: React.ReactNode;
+    disabled?: boolean;
 };
 export declare const FilledButton: React.ForwardRefExoticComponent<FilledButtonProps & React.RefAttributes<HTMLButtonElement>>;