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

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

@@ -11,30 +11,30 @@ export type ActionResult = {
     captureUpdate: CaptureUpdateActionType;
     replaceFiles?: boolean;
 } | false;
-type ActionFn = (elements: readonly OrderedExcalidrawElement[], appState: Readonly<AppState>, formData: any, app: AppClassProperties) => ActionResult | Promise<ActionResult>;
+type ActionFn<TData = any> = (elements: readonly OrderedExcalidrawElement[], appState: Readonly<AppState>, formData: TData | undefined, app: AppClassProperties) => ActionResult | Promise<ActionResult>;
 export type UpdaterFn = (res: ActionResult) => void;
 export type ActionFilterFn = (action: Action) => void;
-export type ActionName = "copy" | "cut" | "paste" | "copyAsPng" | "copyAsSvg" | "copyText" | "sendBackward" | "bringForward" | "sendToBack" | "bringToFront" | "copyStyles" | "selectAll" | "pasteStyles" | "gridMode" | "zenMode" | "objectsSnapMode" | "stats" | "changeStrokeColor" | "changeBackgroundColor" | "changeFillStyle" | "changeStrokeWidth" | "changeStrokeShape" | "changeSloppiness" | "changeStrokeStyle" | "changeArrowhead" | "changeArrowType" | "changeArrowProperties" | "changeOpacity" | "changeFontSize" | "toggleCanvasMenu" | "toggleEditMenu" | "undo" | "redo" | "finalize" | "changeProjectName" | "changeExportBackground" | "changeExportEmbedScene" | "changeExportScale" | "saveToActiveFile" | "saveFileToDisk" | "loadScene" | "duplicateSelection" | "deleteSelectedElements" | "changeViewBackgroundColor" | "clearCanvas" | "zoomIn" | "zoomOut" | "resetZoom" | "zoomToFit" | "zoomToFitSelection" | "zoomToFitSelectionInViewport" | "changeFontFamily" | "changeTextAlign" | "changeVerticalAlign" | "toggleFullScreen" | "toggleShortcuts" | "group" | "ungroup" | "goToCollaborator" | "addToLibrary" | "changeRoundness" | "alignTop" | "alignBottom" | "alignLeft" | "alignRight" | "alignVerticallyCentered" | "alignHorizontallyCentered" | "distributeHorizontally" | "distributeVertically" | "flipHorizontal" | "flipVertical" | "viewMode" | "exportWithDarkMode" | "toggleTheme" | "increaseFontSize" | "decreaseFontSize" | "unbindText" | "hyperlink" | "bindText" | "unlockAllElements" | "toggleElementLock" | "toggleLinearEditor" | "toggleEraserTool" | "toggleHandTool" | "selectAllElementsInFrame" | "removeAllElementsFromFrame" | "updateFrameRendering" | "setFrameAsActiveTool" | "setEmbeddableAsActiveTool" | "createContainerFromText" | "wrapTextInContainer" | "commandPalette" | "autoResize" | "elementStats" | "searchMenu" | "copyElementLink" | "linkToElement" | "cropEditor" | "wrapSelectionInFrame" | "toggleLassoTool" | "toggleShapeSwitch" | "togglePolygon";
+export type ActionName = "copy" | "cut" | "paste" | "copyAsPng" | "copyAsSvg" | "copyText" | "sendBackward" | "bringForward" | "sendToBack" | "bringToFront" | "copyStyles" | "selectAll" | "pasteStyles" | "gridMode" | "zenMode" | "objectsSnapMode" | "arrowBinding" | "midpointSnapping" | "stats" | "changeStrokeColor" | "changeBackgroundColor" | "changeBucketFillBackgroundColor" | "changeFillStyle" | "changeStrokeWidth" | "changeSloppiness" | "changeFreedrawMode" | "changeStrokeStyle" | "changeArrowhead" | "changeArrowType" | "changeArrowProperties" | "changeOpacity" | "changeFontSize" | "undo" | "redo" | "finalize" | "changeProjectName" | "changeExportBackground" | "changeExportEmbedScene" | "changeExportScale" | "saveToActiveFile" | "saveFileToDisk" | "loadScene" | "duplicateSelection" | "deleteSelectedElements" | "changeViewBackgroundColor" | "clearCanvas" | "zoomIn" | "zoomOut" | "resetZoom" | "zoomToFit" | "zoomToFitSelection" | "zoomToFitSelectionInViewport" | "changeFontFamily" | "changeTextAlign" | "changeVerticalAlign" | "toggleFullScreen" | "toggleShortcuts" | "group" | "ungroup" | "goToCollaborator" | "addToLibrary" | "changeRoundness" | "alignTop" | "alignBottom" | "alignLeft" | "alignRight" | "alignVerticallyCentered" | "alignHorizontallyCentered" | "distributeHorizontally" | "distributeVertically" | "flipHorizontal" | "flipVertical" | "deselect" | "viewMode" | "exportWithDarkMode" | "toggleTheme" | "increaseFontSize" | "decreaseFontSize" | "unbindText" | "hyperlink" | "bindText" | "unlockAllElements" | "toggleElementLock" | "toggleLinearEditor" | "selectAllElementsInFrame" | "removeAllElementsFromFrame" | "updateFrameRendering" | "createContainerFromText" | "wrapTextInContainer" | "commandPalette" | "autoResize" | "elementStats" | "searchMenu" | "copyElementLink" | "linkToElement" | "cropEditor" | "wrapSelectionInFrame" | "toggleShapeSwitch" | "togglePolygon";
 export type PanelComponentProps = {
     elements: readonly ExcalidrawElement[];
-    appState: AppState;
+    appState: UIAppState;
     updateData: <T = any>(formData?: T) => void;
     appProps: ExcalidrawProps;
     data?: Record<string, any>;
     app: AppClassProperties;
     renderAction: (name: ActionName, data?: PanelComponentProps["data"]) => React.JSX.Element | null;
 };
-export interface Action {
+export interface Action<TData = any> {
     name: ActionName;
-    label: string | ((elements: readonly ExcalidrawElement[], appState: Readonly<AppState>, app: AppClassProperties) => string);
+    label: string | ((elements: readonly ExcalidrawElement[], appState: Readonly<UIAppState>, app: AppClassProperties) => string);
     keywords?: string[];
     icon?: React.ReactNode | ((appState: UIAppState, elements: readonly ExcalidrawElement[]) => React.ReactNode);
     PanelComponent?: React.FC<PanelComponentProps>;
-    perform: ActionFn;
+    perform: ActionFn<TData>;
     keyPriority?: number;
     keyTest?: (event: React.KeyboardEvent | KeyboardEvent, appState: AppState, elements: readonly ExcalidrawElement[], app: AppClassProperties) => boolean;
     predicate?: (elements: readonly ExcalidrawElement[], appState: AppState, appProps: ExcalidrawProps, app: AppClassProperties) => boolean;
-    checked?: (appState: Readonly<AppState>) => boolean;
+    checked?: (appState: Readonly<UIAppState>) => boolean;
     trackEvent: false | {
         category: "toolbar" | "element" | "canvas" | "export" | "history" | "menu" | "collab" | "hyperlink" | "search_menu" | "shape_switch";
         action?: string;
@@ -43,5 +43,9 @@ export interface Action {
     /** if set to `true`, allow action to be performed in viewMode.
      *  Defaults to `false` */
     viewMode?: boolean;
+    /** if set to `true`, the action counts as canvas navigation and remains
+     *  available in the non-interactive editor when
+     *  `interaction: { enabled: { navigation: true } }`. Defaults to `false` */
+    navigation?: boolean;
 }
 export {};

package/dist/types/excalidraw/{animated-trail.d.ts → animatedTrail.d.ts}

@@ -1,6 +1,5 @@
 import { LaserPointer } from "@excalidraw/laser-pointer";
 import type { LaserPointerOptions } from "@excalidraw/laser-pointer";
-import type { AnimationFrameHandler } from "./animation-frame-handler";
 import type App from "./components/App";
 export interface Trail {
     start(container: SVGSVGElement): void;
@@ -15,7 +14,6 @@ export interface AnimatedTrailOptions {
     animateTrail?: boolean;
 }
 export declare class AnimatedTrail implements Trail {
-    private animationFrameHandler;
     protected app: App;
     private options;
     private currentTrail?;
@@ -23,9 +21,12 @@ export declare class AnimatedTrail implements Trail {
     private container?;
     private trailElement;
     private trailAnimation?;
-    constructor(animationFrameHandler: AnimationFrameHandler, app: App, options: Partial<LaserPointerOptions> & Partial<AnimatedTrailOptions>);
+    private key;
+    private static counter;
+    constructor(app: App, options: Partial<LaserPointerOptions> & Partial<AnimatedTrailOptions>);
     get hasCurrentTrail(): boolean;
     hasLastPoint(x: number, y: number): boolean;
+    private cleanup;
     start(container?: SVGSVGElement): void;
     stop(): void;
     startPath(x: number, y: number): void;

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

@@ -1,7 +1,8 @@
-import type { AppState, NormalizedZoomValue } from "./types";
+import type { AppState, InputDevice, NormalizedZoomValue } from "./types";
 export declare const getDefaultAppState: () => Omit<AppState, "offsetTop" | "offsetLeft" | "width" | "height">;
 export declare const clearAppStateForLocalStorage: (appState: Partial<AppState>) => {
     viewBackgroundColor?: string | undefined;
+    theme?: import("@excalidraw/element/types").Theme | undefined;
     name?: string | null | undefined;
     zoom?: Readonly<{
         value: NormalizedZoomValue;
@@ -12,30 +13,47 @@ export declare const clearAppStateForLocalStorage: (appState: Partial<AppState>)
     selectedElementIds?: Readonly<{
         [id: string]: true;
     }> | undefined;
-    theme?: import("@excalidraw/element/types").Theme | undefined;
+    activeTool?: ({
+        lastActiveTool: import("./types").ActiveTool | null;
+        locked: boolean;
+        fromSelection: boolean;
+    } & import("./types").ActiveTool) | undefined;
     selectedGroupIds?: {
         [groupId: string]: boolean;
     } | undefined;
     selectedLinearElement?: import("@excalidraw/element").LinearElementEditor | null | undefined;
+    isBindingEnabled?: boolean | undefined;
+    isMidpointSnappingEnabled?: boolean | undefined;
+    gridModeEnabled?: boolean | undefined;
     zenModeEnabled?: boolean | undefined;
+    shouldCacheIgnoreZoom?: boolean | undefined;
+    exportScale?: number | undefined;
+    currentItemArrowType?: "round" | "sharp" | "elbow" | undefined;
+    gridSize?: number | undefined;
+    bindMode?: import("@excalidraw/element/types").BindMode | undefined;
     showWelcomeScreen?: boolean | undefined;
-    activeTool?: ({
-        lastActiveTool: import("./types").ActiveTool | null;
-        locked: boolean;
-        fromSelection: boolean;
-    } & import("./types").ActiveTool) | undefined;
+    boxSelectionMode?: import("./types").BoxSelectionMode | undefined;
+    bindingPreference?: "enabled" | "disabled" | undefined;
+    showHints?: boolean | undefined;
+    inputDevice?: InputDevice | undefined;
+    preferredSelectionTool?: {
+        type: "selection" | "lasso";
+        initialized: boolean;
+    } | undefined;
     penMode?: boolean | undefined;
     penDetected?: boolean | undefined;
     exportBackground?: boolean | undefined;
     exportEmbedScene?: boolean | undefined;
     exportWithDarkMode?: boolean | undefined;
-    exportScale?: number | undefined;
     currentItemStrokeColor?: string | undefined;
+    currentItemStickynoteStrokeColor?: string | undefined;
+    currentItemStickynoteBackgroundColor?: string | undefined;
     currentItemBackgroundColor?: string | undefined;
     currentItemFillStyle?: import("@excalidraw/element/types").FillStyle | undefined;
-    currentItemStrokeWidth?: number | undefined;
+    currentItemStrokeWidthKey?: import("@excalidraw/common").StrokeWidthKey | undefined;
     currentItemStrokeStyle?: import("@excalidraw/element/types").StrokeStyle | undefined;
     currentItemRoughness?: number | undefined;
+    currentItemStrokeVariability?: import("@excalidraw/element/types").StrokeVariability | undefined;
     currentItemOpacity?: number | undefined;
     currentItemFontFamily?: number | undefined;
     currentItemFontSize?: number | undefined;
@@ -43,48 +61,50 @@ export declare const clearAppStateForLocalStorage: (appState: Partial<AppState>)
     currentItemStartArrowhead?: import("@excalidraw/element/types").Arrowhead | null | undefined;
     currentItemEndArrowhead?: import("@excalidraw/element/types").Arrowhead | null | undefined;
     currentItemRoundness?: import("@excalidraw/element/types").StrokeRoundness | undefined;
-    currentItemArrowType?: "round" | "sharp" | "elbow" | undefined;
     cursorButton?: "up" | "down" | undefined;
     scrolledOutside?: boolean | undefined;
-    openMenu?: "canvas" | "shape" | null | undefined;
+    openMenu?: "canvas" | null | undefined;
     openSidebar?: {
-        name: string;
-        tab?: string | undefined;
+        name: import("./types").SidebarName;
+        tab?: import("./types").SidebarTabName;
     } | null | undefined;
     defaultSidebarDockedPreference?: boolean | undefined;
     lastPointerDownWith?: import("@excalidraw/element/types").PointerType | undefined;
     previousSelectedElementIds?: {
         [id: string]: true;
     } | undefined;
-    shouldCacheIgnoreZoom?: boolean | undefined;
-    gridSize?: number | undefined;
     gridStep?: number | undefined;
-    gridModeEnabled?: boolean | undefined;
     stats?: {
         open: boolean;
         panels: number;
     } | undefined;
-    currentChartType?: import("@excalidraw/element/types").ChartType | undefined;
     objectsSnapModeEnabled?: boolean | undefined;
     lockedMultiSelections?: {
         [groupId: string]: true;
     } | undefined;
-    stylesPanelMode?: "compact" | "full" | undefined;
+    colorTopPicks?: {
+        elementStroke: readonly string[] | null;
+        elementBackground: readonly string[] | null;
+        bucketFill: readonly string[] | null;
+        stickyNoteStroke: readonly string[] | null;
+        stickyNoteBackground: readonly string[] | null;
+    } | undefined;
+    fontTopPicks?: readonly number[] | null | undefined;
 };
 export declare const cleanAppStateForExport: (appState: Partial<AppState>) => {
     viewBackgroundColor?: string | undefined;
+    gridModeEnabled?: boolean | undefined;
     gridSize?: number | undefined;
     gridStep?: number | undefined;
-    gridModeEnabled?: boolean | undefined;
     lockedMultiSelections?: {
         [groupId: string]: true;
     } | undefined;
 };
 export declare const clearAppStateForDatabase: (appState: Partial<AppState>) => {
     viewBackgroundColor?: string | undefined;
+    gridModeEnabled?: boolean | undefined;
     gridSize?: number | undefined;
     gridStep?: number | undefined;
-    gridModeEnabled?: boolean | undefined;
     lockedMultiSelections?: {
         [groupId: string]: true;
     } | undefined;
@@ -95,3 +115,13 @@ export declare const isEraserActive: ({ activeTool, }: {
 export declare const isHandToolActive: ({ activeTool, }: {
     activeTool: AppState["activeTool"];
 }) => boolean;
+/**
+ * The device the wheel mappings follow for the given preference.
+ *
+ * `auto` is meant to detect the device from the wheel events themselves
+ * (line vs. pixel delta modes, whole vs. fractional deltas, one vs. two axes
+ * moving, event cadence and momentum tails). That is not implemented yet, so
+ * it resolves to `trackpad` — the mapping the editor has always had, and the
+ * default to keep until detection exists.
+ */
+export declare const resolveInputDevice: (inputDevice: InputDevice) => Exclude<InputDevice, "auto">;

package/dist/types/excalidraw/charts/charts.bar.d.ts

@@ -0,0 +1,2 @@
+import type { ChartElements, Spreadsheet } from "./charts.types";
+export declare const renderBarChart: (spreadsheet: Spreadsheet, x: number, y: number, colorSeed?: number) => ChartElements;

package/dist/types/excalidraw/charts/charts.constants.d.ts

@@ -0,0 +1,48 @@
+import type { Radians } from "@excalidraw/math";
+export declare const CARTESIAN_BASE_SLOT_WIDTH = 44;
+export declare const CARTESIAN_BAR_SLOT_EXTRA_PER_SERIES = 22;
+export declare const CARTESIAN_BAR_SLOT_EXTRA_MAX = 66;
+export declare const CARTESIAN_LINE_SLOT_WIDTH = 48;
+export declare const CARTESIAN_GAP = 14;
+export declare const CARTESIAN_BAR_HEIGHT = 304;
+export declare const CARTESIAN_LINE_HEIGHT = 320;
+export declare const CARTESIAN_LABEL_ROTATION: Radians;
+export declare const CARTESIAN_LABEL_MIN_WIDTH = 28;
+export declare const CARTESIAN_LABEL_SLOT_PADDING = 4;
+export declare const CARTESIAN_LABEL_AXIS_CLEARANCE = 2;
+export declare const CARTESIAN_LABEL_MAX_WIDTH_BUFFER = 10;
+export declare const CARTESIAN_LABEL_ROTATED_WIDTH_BUFFER = 10;
+export declare const CARTESIAN_LABEL_OVERFLOW_PREFERENCE_BUFFER = 8;
+export declare const BAR_GAP = 12;
+export declare const BAR_HEIGHT = 256;
+export declare const GRID_OPACITY = 10;
+export declare const RADAR_GRID_LEVELS = 4;
+export declare const RADAR_LABEL_OFFSET: number;
+export declare const RADAR_PADDING: number;
+export declare const RADAR_SINGLE_SERIES_LOG_SCALE_THRESHOLD = 100;
+export declare const RADAR_AXIS_LABEL_MAX_WIDTH = 140;
+export declare const RADAR_AXIS_LABEL_ALIGNMENT_THRESHOLD = 0.35;
+export declare const RADAR_AXIS_LABEL_CLEARANCE: number;
+export declare const RADAR_LEGEND_SWATCH_SIZE = 20;
+export declare const RADAR_LEGEND_ITEM_GAP: number;
+export declare const RADAR_LEGEND_TEXT_GAP = 12;
+export declare const commonProps: {
+    readonly fillStyle: "hachure";
+    readonly fontFamily: number;
+    readonly fontSize: 20;
+    readonly opacity: 100;
+    readonly roughness: 1;
+    readonly strokeColor: "#1e1e1e";
+    readonly roundness: null;
+    readonly strokeStyle: "solid";
+    readonly strokeWidth: 1;
+    readonly verticalAlign: string;
+    readonly locked: false;
+};
+export type CartesianChartType = "bar" | "line";
+export type CartesianChartLayout = {
+    slotWidth: number;
+    gap: number;
+    chartHeight: number;
+    xLabelMaxWidth: number;
+};

package/dist/types/excalidraw/charts/charts.helpers.d.ts

@@ -0,0 +1,32 @@
+import { getFontString } from "@excalidraw/common";
+import type { ChartType } from "@excalidraw/element/types";
+import type { NonDeletedExcalidrawElement } from "@excalidraw/element/types";
+import { type CartesianChartLayout, type CartesianChartType } from "./charts.constants";
+import type { ChartElements, Spreadsheet, SpreadsheetSeries } from "./charts.types";
+export declare const isSpreadsheetValidForChartType: (spreadsheet: Spreadsheet | null, chartType: ChartType) => boolean;
+export declare const getCartesianChartLayout: (chartType: CartesianChartType, seriesCount: number) => CartesianChartLayout;
+export declare const getChartDimensions: (spreadsheet: Spreadsheet, layout: CartesianChartLayout) => {
+    chartWidth: number;
+    chartHeight: number;
+};
+export declare const getRadarDimensions: () => {
+    chartWidth: number;
+    chartHeight: number;
+};
+export declare const getSeriesColors: (seriesCount: number, colorOffset: number) => readonly string[];
+export declare const getColorOffset: (colorSeed?: number) => number;
+export declare const getBackgroundColor: (colorOffset: number) => "#fff5f5" | "#ffc9c9" | "#ff8787" | "#fa5252" | "#e03131" | "#fff0f6" | "#fcc2d7" | "#f783ac" | "#e64980" | "#c2255c" | "#f8f0fc" | "#eebefa" | "#da77f2" | "#be4bdb" | "#9c36b5" | "#f3f0ff" | "#d0bfff" | "#9775fa" | "#7950f2" | "#6741d9" | "#e7f5ff" | "#a5d8ff" | "#4dabf7" | "#228be6" | "#1971c2" | "#e3fafc" | "#99e9f2" | "#3bc9db" | "#15aabf" | "#0c8599" | "#e6fcf5" | "#96f2d7" | "#38d9a9" | "#12b886" | "#099268" | "#ebfbee" | "#b2f2bb" | "#69db7c" | "#40c057" | "#2f9e44" | "#fff9db" | "#ffec99" | "#ffd43b" | "#fab005" | "#f08c00" | "#fff4e6" | "#ffd8a8" | "#ffa94d" | "#fd7e14" | "#e8590c";
+export declare const getRadarValueScale: (series: SpreadsheetSeries[], _labelsLength: number) => {
+    renderSteps: boolean;
+    normalize: (value: number, _axisIndex: number) => number;
+};
+export declare const getRadarDisplayText: (text: string, fontString: ReturnType<typeof getFontString>, maxWidth: number) => string;
+export declare const createRadarAxisLabels: (labels: readonly string[], angles: readonly number[], centerX: number, centerY: number, radius: number, backgroundColor: string) => {
+    axisLabels: ChartElements;
+    axisLabelTopY: number;
+    axisLabelBottomY: number;
+};
+export declare const createSeriesLegend: (series: SpreadsheetSeries[], seriesColors: readonly string[], centerX: number, minLegendTopY: number, fallbackLegendY: number, backgroundColor: string) => ChartElements;
+export declare const getRotatedTextElementBottom: (element: NonDeletedExcalidrawElement) => number;
+export declare const chartXLabels: (spreadsheet: Spreadsheet, x: number, y: number, backgroundColor: string, layout: CartesianChartLayout) => ChartElements;
+export declare const chartBaseElements: (spreadsheet: Spreadsheet, x: number, y: number, backgroundColor: string, layout: CartesianChartLayout, maxValue?: number, debug?: boolean) => ChartElements;

package/dist/types/excalidraw/charts/charts.line.d.ts

@@ -0,0 +1,2 @@
+import type { ChartElements, Spreadsheet } from "./charts.types";
+export declare const renderLineChart: (spreadsheet: Spreadsheet, x: number, y: number, colorSeed?: number) => ChartElements;

package/dist/types/excalidraw/charts/charts.parse.d.ts

@@ -0,0 +1,10 @@
+import { type ParseSpreadsheetResult } from "./charts.types";
+/**
+ * @private exported for testing
+ */
+export declare const tryParseNumber: (s: string) => number | null;
+/**
+ * @private exported for testing
+ */
+export declare const tryParseCells: (cells: string[][]) => ParseSpreadsheetResult;
+export declare const tryParseSpreadsheet: (text: string) => ParseSpreadsheetResult;

package/dist/types/excalidraw/charts/charts.radar.d.ts

@@ -0,0 +1,2 @@
+import type { ChartElements, Spreadsheet } from "./charts.types";
+export declare const renderRadarChart: (spreadsheet: Spreadsheet, x: number, y: number, colorSeed?: number) => ChartElements | null;

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

@@ -0,0 +1,18 @@
+import type { NonDeletedExcalidrawElement } from "@excalidraw/element/types";
+export type ChartElements = readonly NonDeletedExcalidrawElement[];
+export interface Spreadsheet {
+    title: string | null;
+    labels: string[] | null;
+    series: SpreadsheetSeries[];
+}
+export interface SpreadsheetSeries {
+    title: string | null;
+    values: number[];
+}
+export type ParseSpreadsheetResult = {
+    ok: false;
+    reason: string;
+} | {
+    ok: true;
+    data: Spreadsheet;
+};

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

@@ -0,0 +1,7 @@
+import type { ChartType } from "@excalidraw/element/types";
+import { tryParseCells, tryParseNumber, tryParseSpreadsheet } from "./charts.parse";
+import type { ChartElements, Spreadsheet } from "./charts.types";
+export { type ParseSpreadsheetResult, type Spreadsheet, type SpreadsheetSeries, type ChartElements, } from "./charts.types";
+export { isSpreadsheetValidForChartType } from "./charts.helpers";
+export { tryParseCells, tryParseNumber, tryParseSpreadsheet };
+export declare const renderSpreadsheet: (chartType: ChartType, spreadsheet: Spreadsheet, x: number, y: number, colorSeed?: number) => ChartElements | null;

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

@@ -2,15 +2,12 @@ import { ALLOWED_PASTE_MIME_TYPES } from "@excalidraw/common";
 import type { ValueOf } from "@excalidraw/common/utility-types";
 import type { IMAGE_MIME_TYPES, STRING_MIME_TYPES } from "@excalidraw/common";
 import type { ExcalidrawElement, NonDeletedExcalidrawElement } from "@excalidraw/element/types";
-import type { FileSystemHandle } from "./data/filesystem";
-import type { Spreadsheet } from "./charts";
 import type { BinaryFiles } from "./types";
 export type PastedMixedContent = {
     type: "text" | "imageUrl";
     value: string;
 }[];
 export interface ClipboardData {
-    spreadsheet?: Spreadsheet;
     elements?: readonly ExcalidrawElement[];
     files?: BinaryFiles;
     text?: string;
@@ -23,26 +20,16 @@ export declare const probablySupportsClipboardReadText: boolean;
 export declare const probablySupportsClipboardWriteText: boolean;
 export declare const probablySupportsClipboardBlob: boolean;
 export declare const createPasteEvent: ({ types, files, }: {
-    types?: {
-        "text/plain"?: string | File | undefined;
-        "text/html"?: string | File | undefined;
-        "image/svg+xml"?: string | File | undefined;
-        "image/png"?: string | File | undefined;
-        "image/jpeg"?: string | File | undefined;
-        "image/gif"?: string | File | undefined;
-        "image/webp"?: string | File | undefined;
-        "image/bmp"?: string | File | undefined;
-        "image/x-icon"?: string | File | undefined;
-        "image/avif"?: string | File | undefined;
-        "image/jfif"?: string | File | undefined;
-    } | undefined;
-    files?: File[] | undefined;
+    types?: { [key in AllowedPasteMimeTypes]?: string | File; };
+    files?: File[];
 }) => ClipboardEvent;
 export declare const serializeAsClipboardJSON: ({ elements, files, }: {
     elements: readonly NonDeletedExcalidrawElement[];
     files: BinaryFiles | null;
 }) => string;
-export declare const copyToClipboard: (elements: readonly NonDeletedExcalidrawElement[], files: BinaryFiles | null, clipboardEvent?: ClipboardEvent | null) => Promise<void>;
+export declare const copyToClipboard: (elements: readonly NonDeletedExcalidrawElement[], files: BinaryFiles | null, 
+/** supply if available to make the operation more certain to succeed */
+clipboardEvent?: ClipboardEvent | null) => Promise<void>;
 /**
  * Reads OS clipboard programmatically. May not work on all browsers.
  * Will prompt user for permission if not granted.
@@ -64,7 +51,7 @@ type AllowedParsedDataTransferItem = {
     type: ValueOf<typeof IMAGE_MIME_TYPES>;
     kind: "file";
     file: File;
-    fileHandle: FileSystemHandle | null;
+    fileHandle: FileSystemFileHandle | null;
 } | {
     type: ValueOf<typeof STRING_MIME_TYPES>;
     kind: "string";
@@ -74,7 +61,7 @@ type ParsedDataTransferItem = {
     type: string;
     kind: "file";
     file: File;
-    fileHandle: FileSystemHandle | null;
+    fileHandle: FileSystemFileHandle | null;
 } | {
     type: string;
     kind: "string";
@@ -86,7 +73,7 @@ type ParsedDataTransferItemType<T extends AllowedParsedDataTransferItem["type"]>
 export type ParsedDataTransferFile = Extract<AllowedParsedDataTransferItem, {
     kind: "file";
 }>;
-type ParsedDataTranferList = ParsedDataTransferItem[] & {
+export type ParsedDataTranferList = ParsedDataTransferItem[] & {
     /**
      * Only allows filtering by known `string` data types, since `file`
      * types can have multiple items of the same type (e.g. multiple image files)
@@ -101,29 +88,17 @@ type ParsedDataTranferList = ParsedDataTransferItem[] & {
     getData: typeof getDataTransferItemData;
     getFiles: typeof getDataTransferFiles;
 };
-declare const findDataTransferItemType: <T extends ValueOf<{
-    readonly text: "text/plain";
-    readonly html: "text/html";
-    readonly json: "application/json";
-    readonly excalidraw: "application/vnd.excalidraw+json";
-    readonly excalidrawlib: "application/vnd.excalidrawlib+json";
-    readonly excalidrawlibIds: "application/vnd.excalidrawlib.ids+json";
-}>>(this: ParsedDataTranferList, type: T) => ParsedDataTransferItemType<T> | null;
-declare const getDataTransferItemData: <T extends ValueOf<{
-    readonly text: "text/plain";
-    readonly html: "text/html";
-    readonly json: "application/json";
-    readonly excalidraw: "application/vnd.excalidraw+json";
-    readonly excalidrawlib: "application/vnd.excalidrawlib+json";
-    readonly excalidrawlibIds: "application/vnd.excalidrawlib.ids+json";
-}>>(this: ParsedDataTranferList, type: T) => ParsedDataTransferItemType<ValueOf<typeof STRING_MIME_TYPES>>["value"] | null;
+declare const findDataTransferItemType: <T extends ValueOf<typeof STRING_MIME_TYPES>>(this: ParsedDataTranferList, type: T) => ParsedDataTransferItemType<T> | null;
+declare const getDataTransferItemData: <T extends ValueOf<typeof STRING_MIME_TYPES>>(this: ParsedDataTranferList, type: T) => ParsedDataTransferItemType<ValueOf<typeof STRING_MIME_TYPES>>["value"] | null;
 declare const getDataTransferFiles: (this: ParsedDataTranferList) => ParsedDataTransferFile[];
+/** @returns list of MIME types, synchronously */
+export declare const parseDataTransferEventMimeTypes: (event: ClipboardEvent | DragEvent | React.DragEvent<HTMLDivElement>) => Set<string>;
 export declare const parseDataTransferEvent: (event: ClipboardEvent | DragEvent | React.DragEvent<HTMLDivElement>) => Promise<ParsedDataTranferList>;
 /**
  * Attempts to parse clipboard event.
  */
 export declare const parseClipboard: (dataList: ParsedDataTranferList, isPlainPaste?: boolean) => Promise<ClipboardData>;
 export declare const copyBlobToClipboardAsPng: (blob: Blob | Promise<Blob>) => Promise<void>;
-export declare const copyTextToSystemClipboard: (text: string | null, clipboardEvent?: ClipboardEvent | null) => Promise<void>;
+export declare const copyTextToSystemClipboard: <MimeType extends ValueOf<typeof STRING_MIME_TYPES>>(text: string | { [K in MimeType]: string; } | null, clipboardEvent?: ClipboardEvent | null) => Promise<void>;
 export declare const isClipboardEvent: (event: React.SyntheticEvent | Event) => event is ClipboardEvent;
 export {};

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

@@ -1,15 +1,22 @@
-import type { ExcalidrawElement, NonDeletedElementsMap, NonDeletedSceneElementsMap } from "@excalidraw/element/types";
+import type { NonDeletedElementsMap, NonDeletedSceneElementsMap } from "@excalidraw/element/types";
 import "./Actions.scss";
-import type { AppClassProperties, AppProps, UIAppState, Zoom, AppState } from "../types";
+import type { AppClassProperties, UIAppState, AppState } from "../types";
 import type { ActionManager } from "../actions/manager";
-export declare const canChangeStrokeColor: (appState: UIAppState, targetElements: ExcalidrawElement[]) => boolean;
-export declare const canChangeBackgroundColor: (appState: UIAppState, targetElements: ExcalidrawElement[]) => boolean;
+export { canChangeStrokeColor, canChangeBackgroundColor, } from "./shapeActionPredicates";
+/**
+ * Full styles panel: the wide, always-expanded layout used on desktop when the
+ * UI is in "full" mode.
+ */
 export declare const SelectedShapeActions: ({ appState, elementsMap, renderAction, app, }: {
     appState: UIAppState;
     elementsMap: NonDeletedElementsMap | NonDeletedSceneElementsMap;
     renderAction: ActionManager["renderAction"];
     app: AppClassProperties;
 }) => import("react/jsx-runtime").JSX.Element;
+/**
+ * Compact styles panel — the collapsed, popover-driven layout used on tablets
+ * and on desktop when the UI is in "compact" mode.
+ */
 export declare const CompactShapeActions: ({ appState, elementsMap, renderAction, app, setAppState, }: {
     appState: UIAppState;
     elementsMap: NonDeletedElementsMap | NonDeletedSceneElementsMap;
@@ -17,21 +24,29 @@ export declare const CompactShapeActions: ({ appState, elementsMap, renderAction
     app: AppClassProperties;
     setAppState: React.Component<any, AppState>["setState"];
 }) => import("react/jsx-runtime").JSX.Element;
-export declare const ShapesSwitcher: ({ activeTool, appState, app, UIOptions, }: {
-    activeTool: UIAppState["activeTool"];
+/**
+ * Mobile styles panel — the horizontal action bar used on phones, with an
+ * overflow measurement that promotes duplicate/delete out of the popover when
+ * there is room.
+ */
+export declare const MobileShapeActions: ({ appState, elementsMap, renderAction, app, setAppState, }: {
     appState: UIAppState;
+    elementsMap: NonDeletedElementsMap | NonDeletedSceneElementsMap;
+    renderAction: ActionManager["renderAction"];
     app: AppClassProperties;
-    UIOptions: AppProps["UIOptions"];
+    setAppState: React.Component<any, AppState>["setState"];
 }) => import("react/jsx-runtime").JSX.Element;
-export declare const ZoomActions: ({ renderAction, zoom, }: {
+export declare const ZoomActions: ({ renderAction, }: {
     renderAction: ActionManager["renderAction"];
-    zoom: Zoom;
 }) => import("react/jsx-runtime").JSX.Element;
 export declare const UndoRedoActions: ({ renderAction, className, }: {
     renderAction: ActionManager["renderAction"];
-    className?: string | undefined;
+    className?: string;
 }) => import("react/jsx-runtime").JSX.Element;
-export declare const ExitZenModeAction: ({ actionManager, showExitZenModeBtn, }: {
+export declare const ExitZenModeButton: ({ actionManager, showExitZenModeBtn, }: {
     actionManager: ActionManager;
     showExitZenModeBtn: boolean;
 }) => import("react/jsx-runtime").JSX.Element;
+export declare const ExitViewModeButton: ({ actionManager, }: {
+    actionManager: ActionManager;
+}) => import("react/jsx-runtime").JSX.Element;

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

@@ -1,4 +1,4 @@
-export declare const activeConfirmDialogAtom: import("jotai/vanilla/atom").PrimitiveAtom<"clearCanvas" | null> & {
+export declare const activeConfirmDialogAtom: import("jotai").PrimitiveAtom<"clearCanvas" | null> & {
     init: "clearCanvas" | null;
 };
 export declare const ActiveConfirmDialog: () => import("react/jsx-runtime").JSX.Element | null;

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

@@ -0,0 +1,70 @@
+import { LinearElementEditor } from "@excalidraw/element";
+import type { ArrowEndpoint } from "@excalidraw/element";
+import type { ExcalidrawElement, ExcalidrawTextElement, FixedPoint, NonDeleted, NonDeletedExcalidrawElement } from "@excalidraw/element/types";
+import type App from "./App";
+import type { PointerDownState } from "../types";
+/**
+ * Text ↔ arrow interactions.
+ *
+ * With the text tool: the free endpoint a click would bind a new text to
+ * (`AppTextTool` resolves and shows it), the binding itself, and the
+ * endpoint-bound flavor of drag-sizing a new text.
+ *
+ * With the selection tool: dragging an arrow's existing label along the arrow
+ * — the grab affordance and the drag itself.
+ *
+ * The scene-level logic lives in `@excalidraw/element`'s
+ * `arrowEndpointText.ts` and `linearElementEditor.ts`.
+ */
+export declare class AppArrowText {
+    private app;
+    constructor(app: App);
+    /**
+     * A free arrow endpoint a new text could be bound to. Binding an endpoint is
+     * an arrow binding, so it follows the binding toggle (ctrl/cmd) like every
+     * other one — holding it makes the text tool drop plain text instead.
+     */
+    getBindableEndpointAtPosition(x: number, y: number): ArrowEndpoint | null;
+    /**
+     * How a text should be created to read as a label for this endpoint — the
+     * side midpoint to bind, the alignment that pins it, and the scene position
+     * it must sit at. `targetStrokeWidth` is the caller's to provide so it can
+     * guarantee it matches the stroke width the text is then created with — the
+     * binding gap derives from it (see `getTextBindingForArrowEndpoint`).
+     */
+    getTextBinding({ arrow, startOrEnd }: ArrowEndpoint, targetStrokeWidth: number): {
+        fixedPoint: FixedPoint;
+        textAlign: import("@excalidraw/element/types").TextAlign;
+        verticalAlign: import("@excalidraw/element/types").VerticalAlign;
+        anchor: import("@excalidraw/math").GlobalPoint;
+    } | null;
+    /**
+     * Binds the arrow endpoint to the created text, at the side midpoint the
+     * placement resolved (`getTextBinding`'s `fixedPoint`).
+     */
+    bindText({ arrow, startOrEnd }: ArrowEndpoint, text: NonDeleted<ExcalidrawTextElement>, fixedPoint: FixedPoint): void;
+    /**
+     * A text bound to an arrow endpoint can't be positioned by the drag — the
+     * binding already placed it — so only its width is dragged out. Returns
+     * whether it owned the drag.
+     */
+    maybeDragNewText(newElement: ExcalidrawElement, pointerCoords: {
+        x: number;
+        y: number;
+    }): boolean;
+    /**
+     * Whether the arrow's label is what a grab at this position would pick up:
+     * the pointer is over the label, and no element stacked above the arrow
+     * owns the hit instead.
+     */
+    isBoundTextGrabbable(element: NonDeletedExcalidrawElement, x: number, y: number): boolean;
+    /**
+     * The pointer-move half of dragging a label along its arrow. Owns the move
+     * whenever the gesture started on the label (`pointerDownState.hit.arrowLabel`),
+     * dragging only once past the threshold. Returns whether it owned it.
+     */
+    maybeDragLabel(linearElementEditor: LinearElementEditor, pointerDownState: PointerDownState, pointerCoords: {
+        x: number;
+        y: number;
+    }): boolean;
+}