@excalidraw/math 0.18.0-d2463f87d → 0.18.0-d9e8a33

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

@@ -2,6 +2,7 @@ import type { AppState, 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,59 +13,66 @@ export declare const clearAppStateForLocalStorage: (appState: Partial<AppState>)
     selectedElementIds?: Readonly<{
         [id: string]: true;
     }> | undefined;
-    theme?: import("../element/src/types").Theme | undefined;
-    selectedGroupIds?: {
-        [groupId: string]: boolean;
-    } | undefined;
-    selectedLinearElement?: import("../element/src").LinearElementEditor | null | undefined;
-    zenModeEnabled?: boolean | undefined;
-    showWelcomeScreen?: boolean | 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;
+    zenModeEnabled?: boolean | undefined;
+    shouldCacheIgnoreZoom?: boolean | undefined;
+    exportScale?: number | undefined;
+    currentItemArrowType?: "round" | "sharp" | "elbow" | undefined;
+    bindMode?: import("@excalidraw/element/types").BindMode | undefined;
+    gridSize?: number | undefined;
+    showWelcomeScreen?: boolean | undefined;
+    boxSelectionMode?: import("./types").BoxSelectionMode | undefined;
+    bindingPreference?: "enabled" | "disabled" | 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;
     currentItemBackgroundColor?: string | undefined;
-    currentItemFillStyle?: import("../element/src/types").FillStyle | undefined;
+    currentItemFillStyle?: import("@excalidraw/element/types").FillStyle | undefined;
     currentItemStrokeWidth?: number | undefined;
-    currentItemStrokeStyle?: import("../element/src/types").StrokeStyle | undefined;
+    currentItemStrokeStyle?: import("@excalidraw/element/types").StrokeStyle | undefined;
     currentItemRoughness?: number | undefined;
     currentItemOpacity?: number | undefined;
     currentItemFontFamily?: number | undefined;
     currentItemFontSize?: number | undefined;
     currentItemTextAlign?: string | undefined;
-    currentItemStartArrowhead?: import("../element/src/types").Arrowhead | null | undefined;
-    currentItemEndArrowhead?: import("../element/src/types").Arrowhead | null | undefined;
-    currentItemRoundness?: import("../element/src/types").StrokeRoundness | undefined;
-    currentItemArrowType?: "round" | "sharp" | "elbow" | undefined;
+    currentItemStartArrowhead?: import("@excalidraw/element/types").Arrowhead | null | undefined;
+    currentItemEndArrowhead?: import("@excalidraw/element/types").Arrowhead | null | undefined;
+    currentItemRoundness?: import("@excalidraw/element/types").StrokeRoundness | 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("../element/src/types").PointerType | 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("../element/src/types").ChartType | undefined;
     objectsSnapModeEnabled?: boolean | undefined;
     lockedMultiSelections?: {
         [groupId: string]: true;

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

@@ -1,13 +1,13 @@
 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 { 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;
@@ -20,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.
@@ -57,10 +47,58 @@ export declare const readSystemClipboard: () => Promise<{
     "image/avif"?: string | File | undefined;
     "image/jfif"?: string | File | undefined;
 }>;
+type AllowedParsedDataTransferItem = {
+    type: ValueOf<typeof IMAGE_MIME_TYPES>;
+    kind: "file";
+    file: File;
+    fileHandle: FileSystemFileHandle | null;
+} | {
+    type: ValueOf<typeof STRING_MIME_TYPES>;
+    kind: "string";
+    value: string;
+};
+type ParsedDataTransferItem = {
+    type: string;
+    kind: "file";
+    file: File;
+    fileHandle: FileSystemFileHandle | null;
+} | {
+    type: string;
+    kind: "string";
+    value: string;
+};
+type ParsedDataTransferItemType<T extends AllowedParsedDataTransferItem["type"]> = AllowedParsedDataTransferItem & {
+    type: T;
+};
+export type ParsedDataTransferFile = Extract<AllowedParsedDataTransferItem, {
+    kind: "file";
+}>;
+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)
+     * unlike `string` data transfer items.
+     */
+    findByType: typeof findDataTransferItemType;
+    /**
+     * Only allows filtering by known `string` data types, since `file`
+     * types can have multiple items of the same type (e.g. multiple image files)
+     * unlike `string` data transfer items.
+     */
+    getData: typeof getDataTransferItemData;
+    getFiles: typeof getDataTransferFiles;
+};
+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: (event: ClipboardEvent, isPlainPaste?: boolean) => Promise<ClipboardData>;
+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,6 +1,6 @@
 import type { ExcalidrawElement, NonDeletedElementsMap, NonDeletedSceneElementsMap } from "@excalidraw/element/types";
 import "./Actions.scss";
-import type { AppClassProperties, AppProps, UIAppState, Zoom } from "../types";
+import type { AppClassProperties, AppProps, UIAppState, Zoom, 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;
@@ -10,9 +10,23 @@ export declare const SelectedShapeActions: ({ appState, elementsMap, renderActio
     renderAction: ActionManager["renderAction"];
     app: AppClassProperties;
 }) => import("react/jsx-runtime").JSX.Element;
-export declare const ShapesSwitcher: ({ activeTool, appState, app, UIOptions, }: {
-    activeTool: UIAppState["activeTool"];
+export declare const CompactShapeActions: ({ appState, elementsMap, renderAction, app, setAppState, }: {
     appState: UIAppState;
+    elementsMap: NonDeletedElementsMap | NonDeletedSceneElementsMap;
+    renderAction: ActionManager["renderAction"];
+    app: AppClassProperties;
+    setAppState: React.Component<any, AppState>["setState"];
+}) => import("react/jsx-runtime").JSX.Element;
+export declare const MobileShapeActions: ({ appState, elementsMap, renderAction, app, setAppState, }: {
+    appState: UIAppState;
+    elementsMap: NonDeletedElementsMap | NonDeletedSceneElementsMap;
+    renderAction: ActionManager["renderAction"];
+    app: AppClassProperties;
+    setAppState: React.Component<any, AppState>["setState"];
+}) => import("react/jsx-runtime").JSX.Element;
+export declare const ShapesSwitcher: ({ activeTool, setAppState, app, UIOptions, }: {
+    activeTool: UIAppState["activeTool"];
+    setAppState: React.Component<any, AppState>["setState"];
     app: AppClassProperties;
     UIOptions: AppProps["UIOptions"];
 }) => import("react/jsx-runtime").JSX.Element;
@@ -22,13 +36,12 @@ export declare const ZoomActions: ({ renderAction, 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 FinalizeAction: ({ renderAction, className, }: {
-    renderAction: ActionManager["renderAction"];
-    className?: string | undefined;
+export declare const ExitViewModeButton: ({ actionManager, }: {
+    actionManager: ActionManager;
 }) => import("react/jsx-runtime").JSX.Element;