@excalidraw/element 0.18.0-91c7748 → 0.18.0-a52cd20

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

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 export declare const Ellipsify: ({ children, ...rest }: {
     children: React.ReactNode;
-} & import("react").HTMLAttributes<HTMLSpanElement>) => import("react/jsx-runtime").JSX.Element;
+} & 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>>;

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

@@ -12,11 +12,14 @@ interface FontPickerProps {
     isOpened: boolean;
     selectedFontFamily: FontFamilyValues | null;
     hoveredFontFamily: FontFamilyValues | null;
+    /** user-customized top picks (`appState.fontTopPicks`) */
+    topPicks: readonly FontFamilyValues[] | null;
     onSelect: (fontFamily: FontFamilyValues) => void;
+    onTopPicksChange: (fontTopPicks: FontFamilyValues[] | null) => void;
     onHover: (fontFamily: FontFamilyValues) => void;
     onLeave: () => void;
     onPopupChange: (open: boolean) => void;
     compactMode?: boolean;
 }
-export declare const FontPicker: React.MemoExoticComponent<({ isOpened, selectedFontFamily, hoveredFontFamily, onSelect, onHover, onLeave, onPopupChange, compactMode, }: FontPickerProps) => import("react/jsx-runtime").JSX.Element>;
+export declare const FontPicker: React.MemoExoticComponent<({ isOpened, selectedFontFamily, hoveredFontFamily, topPicks, onSelect, onTopPicksChange, onHover, onLeave, onPopupChange, compactMode, }: FontPickerProps) => import("react/jsx-runtime").JSX.Element>;
 export {};

package/dist/types/excalidraw/components/FontPicker/FontPickerList.d.ts

@@ -3,6 +3,7 @@ import { type FontFamilyValues } from "@excalidraw/element/types";
 import type { ValueOf } from "@excalidraw/common/utility-types";
 import { DropDownMenuItemBadgeType } from "../dropdownMenu/DropdownMenuItem";
 import type { JSX } from "react";
+import type { ExcalidrawFontFace } from "../../fonts/ExcalidrawFontFace";
 export interface FontDescriptor {
     value: number;
     icon: JSX.Element;
@@ -21,6 +22,10 @@ interface FontPickerListProps {
     onLeave: () => void;
     onOpen: () => void;
     onClose: () => void;
+    /** present only while the top picks are customized */
+    onResetTopPicks?: () => void;
 }
-export declare const FontPickerList: React.MemoExoticComponent<({ selectedFontFamily, hoveredFontFamily, onSelect, onHover, onLeave, onOpen, onClose, }: FontPickerListProps) => import("react/jsx-runtime").JSX.Element>;
+export declare const getFontFamilyIcon: (fontFamily: FontFamilyValues) => JSX.Element;
+export declare const getFontFamilyLabel: (fontFamily: FontFamilyValues, fontFaces: ExcalidrawFontFace[]) => string;
+export declare const FontPickerList: React.MemoExoticComponent<({ selectedFontFamily, hoveredFontFamily, onSelect, onHover, onLeave, onOpen, onClose, onResetTopPicks, }: FontPickerListProps) => import("react/jsx-runtime").JSX.Element>;
 export {};

package/dist/types/excalidraw/components/FontPicker/FontPickerTrigger.d.ts

@@ -2,6 +2,7 @@ import type { FontFamilyValues } from "@excalidraw/element/types";
 interface FontPickerTriggerProps {
     selectedFontFamily: FontFamilyValues | null;
     isOpened?: boolean;
+    compactMode?: boolean;
 }
-export declare const FontPickerTrigger: ({ selectedFontFamily, isOpened, }: FontPickerTriggerProps) => import("react/jsx-runtime").JSX.Element;
+export declare const FontPickerTrigger: ({ selectedFontFamily, isOpened, compactMode, }: FontPickerTriggerProps) => import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/types/excalidraw/components/FontPicker/fontTopPicksDnD.d.ts

@@ -0,0 +1,12 @@
+import type { FontFamilyValues } from "@excalidraw/element/types";
+import type { TopPicksDnD } from "../TopPicksDnD/topPicksDnD";
+export type FontPickerDnD = TopPicksDnD<FontFamilyValues>;
+export declare const FontPickerDnDContext: import("react").Context<FontPickerDnD | null>;
+export declare const useFontPickerDnD: () => FontPickerDnD | null;
+/** pinning fonts from the font picker list to the top-picks strip, and
+ * reordering the strip */
+export declare const useFontTopPicksDnD: ({ enabled, picks, onPicksChange, }: {
+    enabled: boolean;
+    picks: readonly FontFamilyValues[];
+    onPicksChange: (picks: FontFamilyValues[]) => void;
+}) => FontPickerDnD;

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

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import type { Node } from "@excalidraw/common";
 import { type FontDescriptor } from "./FontPickerList";
 interface FontPickerKeyNavHandlerProps {

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

@@ -1,4 +1,4 @@
 import "./HelpDialog.scss";
 export declare const HelpDialog: ({ onClose }: {
-    onClose?: (() => void) | undefined;
+    onClose?: () => void;
 }) => import("react/jsx-runtime").JSX.Element;

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

@@ -1,10 +1,11 @@
+import type { EditorInterface } from "@excalidraw/common";
 import "./HintViewer.scss";
-import type { AppClassProperties, Device, UIAppState } from "../types";
+import type { AppClassProperties, UIAppState } from "../types";
 interface HintViewerProps {
     appState: UIAppState;
     isMobile: boolean;
-    device: Device;
+    editorInterface: EditorInterface;
     app: AppClassProperties;
 }
-export declare const HintViewer: ({ appState, isMobile, device, app, }: HintViewerProps) => import("react/jsx-runtime").JSX.Element | null;
+export declare const HintViewer: ({ appState, isMobile, editorInterface, app, }: HintViewerProps) => import("react/jsx-runtime").JSX.Element | null;
 export {};

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

@@ -0,0 +1,48 @@
+import React from "react";
+import type { PointerType } from "@excalidraw/element/types";
+import "./ToolIcon.scss";
+import type { CSSProperties } from "react";
+export type IconButtonSize = "small" | "medium";
+type IconButtonBaseProps = {
+    icon?: React.ReactNode;
+    "aria-label": string;
+    "aria-keyshortcuts"?: string;
+    "data-testid"?: string;
+    label?: string;
+    title?: string;
+    size?: IconButtonSize;
+    keyBindingLabel?: string | null;
+    showAriaLabel?: boolean;
+    hidden?: boolean;
+    visible?: boolean;
+    disabled?: boolean;
+    className?: string;
+    style?: CSSProperties;
+    isLoading?: boolean;
+};
+type IconButtonProps = (IconButtonBaseProps & {
+    type: "button";
+    children?: React.ReactNode;
+    onClick?(event: React.MouseEvent): void;
+}) | (IconButtonBaseProps & {
+    type: "icon";
+    children?: React.ReactNode;
+    onClick?(): void;
+}) | (IconButtonBaseProps & {
+    type: "toggle";
+    checked: boolean;
+    /**
+     * Fired on activation — a completed pointer gesture (via `click`, so a
+     * press canceled by sliding off the button doesn't select) or
+     * keyboard/AT activation, in which case pointerType is null.
+     * pointerType is captured on pointer-down, where it's reliable
+     * (unlike the click event's own pointerType on iOS).
+     */
+    onSelect?(data: {
+        pointerType: PointerType | null;
+    }): void;
+    /** the press that may become a click — e.g. to arm a drag out of the toolbar */
+    onPointerDown?(event: React.PointerEvent<HTMLButtonElement>): void;
+});
+export declare const IconButton: React.ForwardRefExoticComponent<IconButtonProps & React.RefAttributes<unknown>>;
+export {};

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

@@ -1,15 +1,20 @@
 import "./IconPicker.scss";
 import type { JSX } from "react";
-export declare function IconPicker<T>({ value, label, options, onChange, group, numberOfOptionsToAlwaysShow, }: {
+type Option<T> = {
+    value: T;
+    text: string;
+    icon: JSX.Element;
+    keyBinding: string | null;
+};
+type PickerSection<T> = {
+    name: string;
+    options: readonly Option<T>[];
+};
+export declare function IconPicker<T>({ value, label, visibleSections, hiddenSections, onChange, }: {
     label: string;
     value: T;
-    options: readonly {
-        value: T;
-        text: string;
-        icon: JSX.Element;
-        keyBinding: string | null;
-    }[];
+    visibleSections: readonly PickerSection<T>[];
+    hiddenSections?: readonly PickerSection<T>[];
     onChange: (value: T) => void;
-    numberOfOptionsToAlwaysShow?: number;
-    group?: string;
 }): import("react/jsx-runtime").JSX.Element;
+export {};

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

@@ -1,3 +1,5 @@
-export declare const InlineIcon: ({ icon }: {
+export declare const InlineIcon: ({ className, icon, size, }: {
+    className?: string;
     icon: React.ReactNode;
+    size?: string;
 }) => import("react/jsx-runtime").JSX.Element;

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/LaserPointerButton.d.ts

@@ -1,10 +1,8 @@
-import "./ToolIcon.scss";
-type LaserPointerIconProps = {
+type LaserPointerButtonProps = {
     title?: string;
-    name?: string;
     checked: boolean;
     onChange?(): void;
     isMobile?: boolean;
 };
-export declare const LaserPointerButton: (props: LaserPointerIconProps) => import("react/jsx-runtime").JSX.Element;
+export declare const LaserPointerButton: (props: LaserPointerButtonProps) => import("react/jsx-runtime").JSX.Element;
 export {};

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

@@ -13,10 +13,10 @@ interface LayerUIProps {
     setAppState: React.Component<any, AppState>["setState"];
     elements: readonly NonDeletedExcalidrawElement[];
     onLockToggle: () => void;
-    onHandToolToggle: () => void;
     onPenModeToggle: AppClassProperties["togglePenMode"];
     showExitZenModeBtn: boolean;
     langCode: Language["code"];
+    renderTopLeftUI?: ExcalidrawProps["renderTopLeftUI"];
     renderTopRightUI?: ExcalidrawProps["renderTopRightUI"];
     renderCustomStats?: ExcalidrawProps["renderCustomStats"];
     UIOptions: AppProps["UIOptions"];
@@ -24,8 +24,12 @@ interface LayerUIProps {
     renderWelcomeScreen: boolean;
     children?: React.ReactNode;
     app: AppClassProperties;
+    defaultUIEnabled: boolean;
+    zoomUIEnabled: boolean;
+    scrollBackToContentUIEnabled: boolean;
     isCollaborating: boolean;
     generateLinkForSelection?: AppProps["generateLinkForSelection"];
+    currentUserControls?: ExcalidrawProps["currentUserControls"];
 }
-declare const _default: React.MemoExoticComponent<({ actionManager, appState, files, setAppState, elements, canvas, onLockToggle, onHandToolToggle, onPenModeToggle, showExitZenModeBtn, renderTopRightUI, renderCustomStats, UIOptions, onExportImage, renderWelcomeScreen, children, app, isCollaborating, generateLinkForSelection, }: LayerUIProps) => import("react/jsx-runtime").JSX.Element>;
+declare const _default: React.MemoExoticComponent<({ actionManager, appState, files, setAppState, elements, canvas, onLockToggle, onPenModeToggle, showExitZenModeBtn, renderTopLeftUI, renderTopRightUI, renderCustomStats, UIOptions, onExportImage, renderWelcomeScreen, children, app, defaultUIEnabled, zoomUIEnabled, scrollBackToContentUIEnabled, isCollaborating, generateLinkForSelection, currentUserControls, }: LayerUIProps) => import("react/jsx-runtime").JSX.Element>;
 export default _default;

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/LibraryMenuControlButtons.d.ts

@@ -5,5 +5,5 @@ export declare const LibraryMenuControlButtons: ({ libraryReturnUrl, theme, id,
     id: string;
     style: React.CSSProperties;
     children?: React.ReactNode;
-    className?: string | undefined;
+    className?: string;
 }) => import("react/jsx-runtime").JSX.Element;

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

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import type Library from "../data/library";
 import type { LibraryItem, UIAppState } from "../types";
 export declare const LibraryDropdownMenuButton: React.FC<{
@@ -14,5 +13,5 @@ export declare const LibraryDropdownMenuButton: React.FC<{
 export declare const LibraryDropdownMenu: ({ selectedItems, onSelectItems, className, }: {
     selectedItems: LibraryItem["id"][];
     onSelectItems: (id: LibraryItem["id"][]) => void;
-    className?: string | undefined;
+    className?: string;
 }) => import("react/jsx-runtime").JSX.Element;

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

@@ -3,7 +3,7 @@ import type { ExcalidrawElement, NonDeleted } from "@excalidraw/element/types";
 import type { SvgCache } from "../hooks/useLibraryItemSvg";
 import type { LibraryItem } from "../types";
 import type { ReactNode } from "react";
-type LibraryOrPendingItem = (LibraryItem | /* pending library item */ {
+type LibraryOrPendingItem = readonly (LibraryItem | /* pending library item */ {
     id: null;
     elements: readonly NonDeleted<ExcalidrawElement>[];
 })[];
@@ -15,9 +15,13 @@ interface Props {
     isItemSelected: (id: LibraryItem["id"] | null) => boolean;
     svgCache: SvgCache;
     itemsRenderedPerBatch: number;
+    /** larger items with their name below */
+    showNames?: boolean;
 }
-export declare const LibraryMenuSectionGrid: ({ children, }: {
+export declare const LibraryMenuSectionGrid: ({ children, showNames, }: {
     children: ReactNode;
+    /** fewer columns, for items rendered with `showNames` */
+    showNames?: boolean;
 }) => import("react/jsx-runtime").JSX.Element;
-export declare const LibraryMenuSection: React.MemoExoticComponent<({ items, onItemSelectToggle, onItemDrag, isItemSelected, onClick, svgCache, itemsRenderedPerBatch, }: Props) => import("react/jsx-runtime").JSX.Element>;
+export declare const LibraryMenuSection: React.MemoExoticComponent<({ items, onItemSelectToggle, onItemDrag, isItemSelected, onClick, svgCache, itemsRenderedPerBatch, showNames, }: Props) => import("react/jsx-runtime").JSX.Element>;
 export {};

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

@@ -1,15 +1,19 @@
-/// <reference types="react" />
 import "./LibraryUnit.scss";
 import type { LibraryItem } from "../types";
 import type { SvgCache } from "../hooks/useLibraryItemSvg";
-export declare const LibraryUnit: import("react").MemoExoticComponent<({ id, elements, isPending, onClick, selected, onToggle, onDrag, svgCache, }: {
+export declare const LibraryUnit: import("react").MemoExoticComponent<({ id, name, showName, elements, isPending, onClick, selected, onToggle, onDrag, svgCache, }: {
     id: LibraryItem["id"] | /** for pending item */ null;
-    elements?: readonly import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawElement>[] | undefined;
-    isPending?: boolean | undefined;
+    name?: LibraryItem["name"];
+    /** render larger, with the name below the item */
+    showName?: boolean;
+    elements?: LibraryItem["elements"];
+    isPending?: boolean;
     onClick: (id: LibraryItem["id"] | null) => void;
     selected: boolean;
     onToggle: (id: string, event: React.MouseEvent) => void;
     onDrag: (id: string, event: React.DragEvent) => void;
     svgCache: SvgCache;
 }) => import("react/jsx-runtime").JSX.Element>;
-export declare const EmptyLibraryUnit: () => import("react/jsx-runtime").JSX.Element;
+export declare const EmptyLibraryUnit: ({ showName }: {
+    showName?: boolean;
+}) => import("react/jsx-runtime").JSX.Element;