@zsviczian/excalidraw 0.17.6-2 → 0.17.6-21

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

@@ -14,7 +14,7 @@ export type ActionResult = {
 type ActionFn = (elements: readonly OrderedExcalidrawElement[], appState: Readonly<AppState>, formData: any, 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" | "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" | "toggleLaserPointerTool" | "commandPalette" | "autoResize" | "elementStats" | "searchMenu";
+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" | "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" | "toggleLaserPointerTool" | "commandPalette" | "autoResize" | "elementStats" | "searchMenu" | "copyElementLink" | "linkToElement" | "cropEditor";
 export type PanelComponentProps = {
     elements: readonly ExcalidrawElement[];
     appState: AppState;

package/types/excalidraw/change.d.ts

@@ -1,5 +1,5 @@
 import type { ElementUpdate } from "./element/mutateElement";
-import type { OrderedExcalidrawElement, SceneElementsMap } from "./element/types";
+import type { ExcalidrawElement, Ordered, OrderedExcalidrawElement, SceneElementsMap } from "./element/types";
 import type { AppState, ObservedAppState } from "./types";
 import type { ValueOf } from "./utility-types";
 /**
@@ -116,7 +116,7 @@ export declare class AppStateChange implements Change<AppState> {
     private static stripElementsProps;
     private static stripStandaloneProps;
 }
-type ElementPartial = Omit<ElementUpdate<OrderedExcalidrawElement>, "seed">;
+type ElementPartial<T extends ExcalidrawElement = ExcalidrawElement> = Omit<ElementUpdate<Ordered<T>>, "seed">;
 /**
  * Elements change is a low level primitive to capture a change between two sets of elements.
  * It does so by encapsulating forward and backward `Delta`s, allowing to time-travel in both directions.

package/types/excalidraw/clipboard.d.ts

@@ -21,8 +21,17 @@ export declare const probablySupportsClipboardWriteText: boolean;
 export declare const probablySupportsClipboardBlob: boolean;
 export declare const createPasteEvent: ({ types, files, }: {
     types?: {
-        "text/html"?: string | undefined;
-        "text/plain"?: string | undefined;
+        "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;
 }) => ClipboardEvent;
@@ -31,12 +40,25 @@ export declare const serializeAsClipboardJSON: ({ elements, files, }: {
     files: BinaryFiles | null;
 }) => string;
 export declare const copyToClipboard: (elements: readonly NonDeletedExcalidrawElement[], files: BinaryFiles | null, clipboardEvent?: ClipboardEvent | null) => Promise<void>;
+/**
+ * Reads OS clipboard programmatically. May not work on all browsers.
+ * Will prompt user for permission if not granted.
+ */
 export declare const readSystemClipboard: () => Promise<{
-    "text/html"?: string | undefined;
-    "text/plain"?: string | undefined;
+    "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;
 }>;
 /**
- * Attempts to parse clipboard. Prefers system clipboard.
+ * Attempts to parse clipboard event.
  */
 export declare const parseClipboard: (event: ClipboardEvent, isPlainPaste?: boolean) => Promise<ClipboardData>;
 export declare const copyBlobToClipboardAsPng: (blob: Blob | Promise<Blob>) => Promise<void>;

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

@@ -5,7 +5,7 @@ import type { ActionResult } from "../actions/types";
 import { type EXPORT_IMAGE_TYPES } from "../constants";
 import type { ExportedElements } from "../data";
 import { LinearElementEditor } from "../element/linearElementEditor";
-import type { ExcalidrawElement, ExcalidrawLinearElement, NonDeleted, NonDeletedExcalidrawElement, ExcalidrawFrameLikeElement, ExcalidrawIframeElement, ExcalidrawEmbeddableElement, Ordered } from "../element/types";
+import type { ExcalidrawElement, ExcalidrawLinearElement, NonDeleted, InitializedExcalidrawImageElement, ExcalidrawImageElement, NonDeletedExcalidrawElement, ExcalidrawFrameLikeElement, ExcalidrawIframeElement, ExcalidrawEmbeddableElement, Ordered } from "../element/types";
 import { History } from "../history";
 import Scene from "../scene/Scene";
 import type { AppClassProperties, AppProps, AppState, ExcalidrawImperativeAPI, BinaryFiles, LibraryItems, SceneData, Device, FrameNameBoundsCache, SidebarName, SidebarTabName, ToolType, OnUserFollowedPayload, GenerateDiagramToCode, NullableGridSize, Offsets } from "../types";
@@ -86,6 +86,10 @@ declare class App extends React.Component<AppProps, AppState> {
     lastPointerDownEvent: React.PointerEvent<HTMLElement> | null;
     lastPointerUpEvent: React.PointerEvent<HTMLElement> | PointerEvent | null;
     lastPointerMoveEvent: PointerEvent | null;
+    lastPointerMoveCoords: {
+        x: number;
+        y: number;
+    } | null;
     lastViewportPosition: {
         x: number;
         y: number;
@@ -328,7 +332,7 @@ declare class App extends React.Component<AppProps, AppState> {
      */
     zoomCanvas: (value: number) => void;
     private cancelInProgressAnimation;
-    scrollToContent: (target?: ExcalidrawElement | readonly ExcalidrawElement[], opts?: ({
+    scrollToContent: (target?: string | ExcalidrawElement | readonly ExcalidrawElement[], opts?: ({
         fitToContent?: boolean;
         fitToViewport?: never;
         viewportZoomFactor?: number;
@@ -352,6 +356,10 @@ declare class App extends React.Component<AppProps, AppState> {
     /** use when changing scrollX/scrollY/zoom based on user interaction */
     private translateCanvas;
     zoomToFit: (target?: readonly ExcalidrawElement[], maxZoom?: number, margin?: number) => void;
+    getColorAtScenePoint: ({ sceneX, sceneY }: {
+        sceneX: number;
+        sceneY: number;
+    }) => string | null;
     startLineEditor: (el: ExcalidrawLinearElement, selectedPointsIndices?: number[] | null) => void;
     updateContainerSize: (containers: NonDeletedExcalidrawElement[]) => void;
     setToast: (toast: {
@@ -360,7 +368,10 @@ declare class App extends React.Component<AppProps, AppState> {
         duration?: number;
     } | null) => void;
     restoreFileFromShare: () => Promise<void>;
-    /** adds supplied files to existing files in the appState */
+    /**
+     * adds supplied files to existing files in the appState.
+     * NOTE if file already exists in editor state, the file data is not updated
+     * */
     addFiles: ExcalidrawImperativeAPI["addFiles"];
     setMobileModeAllowed: ExcalidrawImperativeAPI["setMobileModeAllowed"];
     private debounceClearHighlightSearchResults;
@@ -369,6 +380,7 @@ declare class App extends React.Component<AppProps, AppState> {
     bringForward: ExcalidrawImperativeAPI["bringForward"];
     sendToBack: ExcalidrawImperativeAPI["sendToBack"];
     sendBackward: ExcalidrawImperativeAPI["sendBackward"];
+    private addMissingFiles;
     updateScene: <K extends keyof AppState>(sceneData: {
         elements?: SceneData["elements"];
         appState?: Pick<AppState, K> | null | undefined;
@@ -426,6 +438,8 @@ declare class App extends React.Component<AppProps, AppState> {
     private getTextBindableContainerAtPosition;
     private startTextEditing;
     private debounceDoubleClickTimestamp;
+    private startImageCropping;
+    private finishImageCropping;
     private handleCanvasDoubleClick;
     private getElementLinkAtPosition;
     private redirectToLink;
@@ -486,10 +500,10 @@ declare class App extends React.Component<AppProps, AppState> {
     /**
      * inserts image into elements array and rerenders
      */
-    private insertImageElement;
+    insertImageElement: (imageElement: ExcalidrawImageElement, imageFile: File, showCursorImagePreview?: boolean) => Promise<NonDeleted<InitializedExcalidrawImageElement> | null | undefined>;
     private setImagePreviewCursor;
     private onImageAction;
-    private initializeImageDimensions;
+    initializeImageDimensions: (imageElement: ExcalidrawImageElement, forceNaturalSize?: boolean) => void;
     /** updates image cache, refreshing updated elements and/or setting status
         to error for images that fail during <img> element creation */
     private updateImageCache;
@@ -508,6 +522,7 @@ declare class App extends React.Component<AppProps, AppState> {
     loadFileToCanvas: (file: File, fileHandle: FileSystemHandle | null) => Promise<void>;
     private handleCanvasContextMenu;
     private maybeDragNewGenericElement;
+    private maybeHandleCrop;
     private maybeHandleResize;
     private getContextMenuItems;
     private handleWheel;

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

@@ -0,0 +1,11 @@
+import type { AppProps, UIAppState } from "../types";
+import type { ElementsMap, ExcalidrawElement } from "../element/types";
+import "./ElementLinkDialog.scss";
+declare const ElementLinkDialog: ({ sourceElementId, onClose, elementsMap, appState, generateLinkForSelection, }: {
+    sourceElementId: ExcalidrawElement["id"];
+    elementsMap: ElementsMap;
+    appState: UIAppState;
+    onClose?: (() => void) | undefined;
+    generateLinkForSelection: AppProps["generateLinkForSelection"];
+}) => JSX.Element;
+export default ElementLinkDialog;

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

@@ -25,6 +25,7 @@ interface LayerUIProps {
     children?: React.ReactNode;
     app: AppClassProperties;
     isCollaborating: boolean;
+    generateLinkForSelection?: AppProps["generateLinkForSelection"];
 }
-declare const _default: React.MemoExoticComponent<({ actionManager, appState, files, setAppState, elements, canvas, onLockToggle, onHandToolToggle, onPenModeToggle, showExitZenModeBtn, renderTopRightUI, renderCustomStats, UIOptions, onExportImage, renderWelcomeScreen, children, app, isCollaborating, }: LayerUIProps) => JSX.Element>;
+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) => JSX.Element>;
 export default _default;

package/types/excalidraw/components/TTDDialog/MermaidToExcalidraw.d.ts

@@ -1,14 +1,8 @@
-import type { ExcalidrawElement, NonDeletedExcalidrawElement } from "../../element/types";
+import type { NonDeletedExcalidrawElement } from "../../element/types";
 import "./MermaidToExcalidraw.scss";
 import type { MermaidToExcalidrawLibProps } from "./common";
-import type { MermaidOptions } from "@zsviczian/mermaid-to-excalidraw";
 declare const MermaidToExcalidraw: ({ mermaidToExcalidrawLib, selectedElements, }: {
     mermaidToExcalidrawLib: MermaidToExcalidrawLibProps;
     selectedElements: readonly NonDeletedExcalidrawElement[];
 }) => JSX.Element;
 export default MermaidToExcalidraw;
-export declare const mermaidToExcalidraw: (mermaidDefinition: string, opts?: MermaidOptions, forceSVG?: boolean) => Promise<{
-    elements?: ExcalidrawElement[];
-    files?: any;
-    error?: string;
-} | undefined>;

package/types/excalidraw/components/TTDDialog/MermaidToExcalidrawLib.d.ts

@@ -0,0 +1,9 @@
+import { MermaidConfig } from "@zsviczian/mermaid-to-excalidraw";
+import { ExcalidrawElement } from "../../element/types";
+import { MermaidToExcalidrawLibProps } from "./common";
+export declare const loadMermaidToExcalidrawLib: () => Promise<MermaidToExcalidrawLibProps>;
+export declare const mermaidToExcalidraw: (mermaidDefinition: string, opts: MermaidConfig, forceSVG?: boolean) => Promise<{
+    elements?: ExcalidrawElement[];
+    files?: any;
+    error?: string;
+} | undefined>;

package/types/excalidraw/components/TTDDialog/common.d.ts

@@ -1,11 +1,11 @@
-import type { MermaidOptions } from "@zsviczian/mermaid-to-excalidraw";
+import type { MermaidConfig } from "@zsviczian/mermaid-to-excalidraw";
 import type { MermaidToExcalidrawResult } from "@zsviczian/mermaid-to-excalidraw/dist/interfaces";
 import type { NonDeletedExcalidrawElement } from "../../element/types";
 import type { AppClassProperties, BinaryFiles } from "../../types";
 export interface MermaidToExcalidrawLibProps {
     loaded: boolean;
     api: Promise<{
-        parseMermaidToExcalidraw: (definition: string, options: MermaidOptions) => Promise<MermaidToExcalidrawResult>;
+        parseMermaidToExcalidraw: (definition: string, config?: MermaidConfig, forceSVG?: boolean) => Promise<MermaidToExcalidrawResult>;
     }>;
 }
 interface ConvertMermaidToExcalidrawFormatProps {

package/types/excalidraw/components/hyperlink/Hyperlink.d.ts

@@ -13,6 +13,6 @@ export declare const Hyperlink: ({ element, elementsMap, setAppState, onLinkOpen
     } | null) => void;
     updateEmbedValidationStatus: (element: ExcalidrawEmbeddableElement, status: boolean) => void;
 }) => JSX.Element | null;
-export declare const getContextMenuLabel: (elements: readonly NonDeletedExcalidrawElement[], appState: UIAppState) => "labels.link.editEmbed" | "labels.link.edit" | "labels.link.createEmbed" | "labels.link.create";
+export declare const getContextMenuLabel: (elements: readonly NonDeletedExcalidrawElement[], appState: UIAppState) => "labels.link.editEmbed" | "labels.link.edit" | "labels.link.create";
 export declare const showHyperlinkTooltip: (element: NonDeletedExcalidrawElement, appState: AppState, elementsMap: ElementsMap) => void;
 export declare const hideHyperlinkToolip: () => void;

package/types/excalidraw/components/hyperlink/helpers.d.ts

@@ -3,6 +3,7 @@ import type { Bounds } from "../../element/bounds";
 import type { ElementsMap, NonDeletedExcalidrawElement } from "../../element/types";
 import type { AppState, UIAppState } from "../../types";
 export declare const EXTERNAL_LINK_IMG: HTMLImageElement;
+export declare const ELEMENT_LINK_IMG: HTMLImageElement;
 export declare const getLinkHandleFromCoords: ([x1, y1, x2, y2]: Bounds, angle: Radians, appState: Pick<UIAppState, "zoom">) => Bounds;
 export declare const isPointHittingLinkIcon: (element: NonDeletedExcalidrawElement, elementsMap: ElementsMap, appState: AppState, [x, y]: GlobalPoint) => boolean;
 export declare const isPointHittingLink: (element: NonDeletedExcalidrawElement, elementsMap: ElementsMap, appState: AppState, [x, y]: GlobalPoint, isMobile: boolean) => boolean;

package/types/excalidraw/components/icons.d.ts

@@ -209,4 +209,6 @@ export declare const roundArrowIcon: JSX.Element;
 export declare const collapseDownIcon: JSX.Element;
 export declare const collapseUpIcon: JSX.Element;
 export declare const upIcon: JSX.Element;
+export declare const cropIcon: JSX.Element;
+export declare const elementLinkIcon: JSX.Element;
 export {};

package/types/excalidraw/constants.d.ts

@@ -164,7 +164,6 @@ export declare const IMAGE_MIME_TYPES: {
     readonly avif: "image/avif";
     readonly jfif: "image/jfif";
 };
-export declare const ALLOWED_PASTE_MIME_TYPES: readonly ["text/plain", "text/html"];
 export declare const MIME_TYPES: {
     readonly svg: "image/svg+xml";
     readonly png: "image/png";
@@ -175,6 +174,8 @@ export declare const MIME_TYPES: {
     readonly ico: "image/x-icon";
     readonly avif: "image/avif";
     readonly jfif: "image/jfif";
+    readonly text: "text/plain";
+    readonly html: "text/html";
     readonly json: "application/json";
     readonly excalidraw: "application/vnd.excalidraw+json";
     readonly excalidrawlib: "application/vnd.excalidrawlib+json";
@@ -182,6 +183,7 @@ export declare const MIME_TYPES: {
     readonly "excalidraw.png": "image/png";
     readonly binary: "application/octet-stream";
 };
+export declare const ALLOWED_PASTE_MIME_TYPES: readonly ["text/plain", "text/html", ...("image/svg+xml" | "image/png" | "image/jpeg" | "image/gif" | "image/webp" | "image/bmp" | "image/x-icon" | "image/avif" | "image/jfif")[]];
 export declare const EXPORT_IMAGE_TYPES: {
     readonly png: "png";
     readonly svg: "svg";
@@ -320,3 +322,5 @@ export declare const MIN_WIDTH_OR_HEIGHT = 1;
 export declare const ARROW_TYPE: {
     [T in AppState["currentItemArrowType"]]: T;
 };
+export declare const DEFAULT_REDUCED_GLOBAL_ALPHA = 0.3;
+export declare const ELEMENT_LINK_KEY = "element";

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

@@ -8,6 +8,7 @@ export declare const getMimeType: (blob: Blob | string) => string;
 export declare const getFileHandleType: (handle: FileSystemHandle | null) => string | null;
 export declare const isImageFileHandleType: (type: string | null) => type is "png" | "svg";
 export declare const isImageFileHandle: (handle: FileSystemHandle | null) => boolean;
+export declare const isSupportedImageFileType: (type: string | null | undefined) => boolean;
 export declare const isSupportedImageFile: (blob: Blob | null | undefined) => blob is Blob & {
     type: ValueOf<typeof IMAGE_MIME_TYPES>;
 };
@@ -25,8 +26,11 @@ export declare const canvasToBlob: (canvas: HTMLCanvasElement | Promise<HTMLCanv
 /** generates SHA-1 digest from supplied file (if not supported, falls back
     to a 40-char base64 random id) */
 export declare const generateIdFromFile: (file: File) => Promise<FileId>;
+/** async. For sync variant, use getDataURL_sync */
 export declare const getDataURL: (file: Blob | File) => Promise<DataURL>;
+export declare const getDataURL_sync: (data: string | Uint8Array | ArrayBuffer, mimeType: ValueOf<typeof MIME_TYPES>) => DataURL;
 export declare const dataURLToFile: (dataURL: DataURL, filename?: string) => File;
+export declare const dataURLToString: (dataURL: DataURL) => string;
 export declare const resizeImageFile: (file: File, opts: {
     /** undefined indicates auto */
     outputType?: (typeof MIME_TYPES)["jpg"];

package/types/excalidraw/data/encode.d.ts

@@ -1,11 +1,12 @@
-export declare const toByteString: (data: string | Uint8Array | ArrayBuffer) => Promise<string>;
+export declare const toByteString: (data: string | Uint8Array | ArrayBuffer) => string;
 /**
  * @param isByteString set to true if already byte string to prevent bloat
  *  due to reencoding
  */
-export declare const stringToBase64: (str: string, isByteString?: boolean) => Promise<string>;
-export declare const base64ToString: (base64: string, isByteString?: boolean) => Promise<string>;
+export declare const stringToBase64: (str: string, isByteString?: boolean) => string;
+export declare const base64ToString: (base64: string, isByteString?: boolean) => string;
 export declare const base64ToArrayBuffer: (base64: string) => ArrayBuffer;
+export declare const base64urlToString: (str: string) => string;
 type EncodedData = {
     encoded: string;
     encoding: "bstring";
@@ -21,8 +22,8 @@ export declare const encode: ({ text, compress, }: {
     text: string;
     /** defaults to `true`. If compression fails, falls back to bstring alone. */
     compress?: boolean | undefined;
-}) => Promise<EncodedData>;
-export declare const decode: (data: EncodedData) => Promise<string>;
+}) => EncodedData;
+export declare const decode: (data: EncodedData) => string;
 /**
  * The returned buffer has following format:
  * `[]` refers to a buffers wrapper (see `concatBuffers`)

package/types/excalidraw/data/image.d.ts

@@ -9,7 +9,7 @@ export declare const encodePngMetadata: ({ blob, metadata, }: {
 export declare const decodePngMetadata: (blob: Blob) => Promise<string>;
 export declare const encodeSvgMetadata: ({ text }: {
     text: string;
-}) => Promise<string>;
+}) => string;
 export declare const decodeSvgMetadata: ({ svg }: {
     svg: string;
-}) => Promise<string>;
+}) => string;

package/types/excalidraw/dist/excalidraw.production.min.d.ts

@@ -1 +1,3 @@
-export const ExcalidrawLib: {};
+declare const _exports: any;
+export = _exports;
+export const ExcalidrawLib: any;

package/types/excalidraw/element/binding.d.ts

@@ -30,7 +30,7 @@ export declare const getHoveredElementForBinding: (pointerCoords: {
 }, elements: readonly NonDeletedExcalidrawElement[], elementsMap: NonDeletedSceneElementsMap, fullShape?: boolean) => NonDeleted<ExcalidrawBindableElement> | null;
 export declare const updateBoundElements: (changedElement: NonDeletedExcalidrawElement, elementsMap: NonDeletedSceneElementsMap | SceneElementsMap, options?: {
     simultaneouslyUpdated?: readonly ExcalidrawElement[];
-    oldSize?: {
+    newSize?: {
         width: number;
         height: number;
     };

package/types/excalidraw/element/cropElement.d.ts

@@ -0,0 +1,14 @@
+import type { TransformHandleType } from "./transformHandles";
+import type { ElementsMap, ExcalidrawImageElement, ImageCrop } from "./types";
+export declare const cropElement: (element: ExcalidrawImageElement, transformHandle: TransformHandleType, naturalWidth: number, naturalHeight: number, pointerX: number, pointerY: number, widthAspectRatio?: number) => {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    crop: ImageCrop | null;
+};
+export declare const getUncroppedImageElement: (element: ExcalidrawImageElement, elementsMap: ElementsMap) => ExcalidrawImageElement;
+export declare const getUncroppedWidthAndHeight: (element: ExcalidrawImageElement) => {
+    width: number;
+    height: number;
+};

package/types/excalidraw/element/elementLink.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Create and link between shapes.
+ */
+import type { AppProps, AppState } from "../types";
+import type { ExcalidrawElement } from "./types";
+export declare const defaultGetElementLinkFromSelection: Exclude<AppProps["generateLinkForSelection"], undefined>;
+export declare const getLinkIdAndTypeFromSelection: (selectedElements: ExcalidrawElement[], appState: AppState) => {
+    id: string;
+    type: "element" | "group";
+} | null;
+export declare const canCreateLinkFromElements: (selectedElements: ExcalidrawElement[]) => boolean;
+export declare const isElementLink: (url: string) => boolean;
+export declare const parseElementLinkFromURL: (url: string) => string | null;

package/types/excalidraw/element/embeddable.d.ts

@@ -94,12 +94,18 @@ export declare const actionSetEmbeddableAsActiveTool: {
                 tab: "mermaid" | "text-to-diagram";
             } | {
                 name: "commandPalette";
+            } | {
+                name: "elementLinkSelector";
+                sourceElementId: string;
             } | null;
             defaultSidebarDockedPreference: boolean;
             lastPointerDownWith: import("./types").PointerType;
             selectedElementIds: Readonly<{
                 [id: string]: true;
             }>;
+            hoveredElementIds: Readonly<{
+                [id: string]: true;
+            }>;
             previousSelectedElementIds: {
                 [id: string]: true;
             };
@@ -200,6 +206,8 @@ export declare const actionSetEmbeddableAsActiveTool: {
             objectsSnapModeEnabled: boolean;
             userToFollow: import("../types").UserToFollow | null;
             followedBy: Set<import("../types").SocketId>;
+            isCropping: boolean;
+            croppingElementId: string | null;
             searchMatches: readonly {
                 id: string;
                 focus: boolean;

package/types/excalidraw/element/image.d.ts

@@ -29,4 +29,4 @@ export declare const updateImageCache: ({ fileIds, files, imageCache, }: {
 }>;
 export declare const getInitializedImageElements: (elements: readonly ExcalidrawElement[]) => InitializedExcalidrawImageElement[];
 export declare const isHTMLSVGElement: (node: Node | null) => node is SVGElement;
-export declare const normalizeSVG: (SVGString: string) => Promise<string>;
+export declare const normalizeSVG: (SVGString: string) => string;

package/types/excalidraw/element/newElement.d.ts

@@ -58,6 +58,7 @@ export declare const newImageElement: (opts: {
     status?: ExcalidrawImageElement["status"];
     fileId?: ExcalidrawImageElement["fileId"];
     scale?: ExcalidrawImageElement["scale"];
+    crop?: ExcalidrawImageElement["crop"];
 } & ElementConstructorOpts) => NonDeleted<ExcalidrawImageElement>;
 /**
  * Clones ExcalidrawElement data structure. Does not regenerate id, nonce, or

package/types/excalidraw/element/textElement.d.ts

@@ -2,8 +2,6 @@ import type { ElementsMap, ExcalidrawElement, ExcalidrawElementType, ExcalidrawT
 import type { MaybeTransformHandleType } from "./transformHandles";
 import type { AppState } from "../types";
 import type { ExtractSetType } from "../utility-types";
-export declare const containsCJK: (text: string) => boolean;
-export declare const containsEmoji: (text: string) => boolean;
 export declare const normalizeText: (text: string) => string;
 export declare const redrawTextBoundingBox: (textElement: ExcalidrawTextElement, container: ExcalidrawElement | null, elementsMap: ElementsMap, informMutation?: boolean) => void;
 export declare const bindTextToShapeAfterDuplication: (newElements: ExcalidrawElement[], oldElements: ExcalidrawElement[], oldIdToDuplicatedId: Map<ExcalidrawElement["id"], ExcalidrawElement["id"]>) => void;
@@ -29,10 +27,22 @@ export declare const detectLineHeight: (textElement: ExcalidrawTextElement) => n
  */
 export declare const getLineHeightInPx: (fontSize: ExcalidrawTextElement["fontSize"], lineHeight: ExcalidrawTextElement["lineHeight"]) => number;
 export declare const getApproxMinLineHeight: (fontSize: ExcalidrawTextElement["fontSize"], lineHeight: ExcalidrawTextElement["lineHeight"]) => number;
+/**
+ * @param forceAdvanceWidth use to force retrieve the "advance width" ~ `metrics.width`, instead of the actual boundind box width.
+ *
+ * > The advance width is the distance between the glyph's initial pen position and the next glyph's initial pen position.
+ *
+ * We need to use the advance width as that's the closest thing to the browser wrapping algo, hence using it for:
+ * - text wrapping
+ * - wysiwyg editor (+padding)
+ *
+ * Everything else should be based on the actual bounding box width.
+ *
+ * `Math.ceil` of the final width adds additional buffer which stabilizes slight wrapping incosistencies.
+ */
+export declare const getLineWidth: (text: string, font: FontString, forceAdvanceWidth?: true) => number;
 export declare const getTextWidth: (text: string, font: FontString, forceAdvanceWidth?: true) => number;
 export declare const getTextHeight: (text: string, fontSize: number, lineHeight: ExcalidrawTextElement["lineHeight"]) => number;
-export declare const parseTokens: (line: string) => string[];
-export declare const wrapText: (text: string, font: FontString, maxWidth: number) => string;
 export declare const charWidth: {
     calculate: (char: string, font: FontString) => number;
     getCache: (font: FontString) => number[];

package/types/excalidraw/element/textWrapping.d.ts

@@ -0,0 +1,13 @@
+import type { FontString } from "./types";
+/**
+ * Test if a given text contains any CJK characters (including symbols, punctuation, etc,).
+ */
+export declare const containsCJK: (text: string) => boolean;
+/**
+ * Breaks the line into the tokens based on the found line break opporutnities.
+ */
+export declare const parseTokens: (line: string) => string[];
+/**
+ * Wraps the original text into the lines based on the given width.
+ */
+export declare const wrapText: (text: string, font: FontString, maxWidth: number) => string;

package/types/excalidraw/element/transformHandles.d.ts

@@ -40,7 +40,7 @@ export declare const getTransformHandlesFromCoords: ([x1, y1, x2, y2, cx, cy]: [
     sw?: boolean | undefined;
     se?: boolean | undefined;
     rotation?: boolean | undefined;
-}, margin?: number) => TransformHandles;
+}, margin?: number, spacing?: number) => TransformHandles;
 export declare const getTransformHandles: (element: ExcalidrawElement, zoom: Zoom, elementsMap: ElementsMap, pointerType?: PointerType, omitSides?: {
     e?: boolean | undefined;
     s?: boolean | undefined;

package/types/excalidraw/element/types.d.ts

@@ -120,6 +120,14 @@ export type IframeData = ({
     type: "document";
     srcdoc: (theme: Theme) => string;
 }));
+export type ImageCrop = {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    naturalWidth: number;
+    naturalHeight: number;
+};
 export type ExcalidrawImageElement = _ExcalidrawElementBase & Readonly<{
     type: "image";
     fileId: FileId | null;
@@ -127,6 +135,8 @@ export type ExcalidrawImageElement = _ExcalidrawElementBase & Readonly<{
     status: "pending" | "saved" | "error";
     /** X and Y scale factors <-1, 1>, used for image axis flipping */
     scale: [number, number];
+    /** whether an element is cropped */
+    crop: ImageCrop | null;
 }>;
 export type InitializedExcalidrawImageElement = MarkNonNullable<ExcalidrawImageElement, "fileId">;
 export type ExcalidrawFrameElement = _ExcalidrawElementBase & {

package/types/excalidraw/errors.d.ts

@@ -22,4 +22,11 @@ export declare class WorkerInTheMainChunkError extends Error {
     code: WorkerErrorCodes;
     constructor(message?: string, code?: WorkerErrorCodes);
 }
+/**
+ * Use this for generic, handled errors, so you can check against them
+ * and rethrow if needed
+ */
+export declare class ExcalidrawError extends Error {
+    constructor(message: string);
+}
 export {};

package/types/excalidraw/fonts/{woff2/Cascadia → Cascadia}/index.d.ts

@@ -1,2 +1,2 @@
-import { type ExcalidrawFontFaceDescriptor } from "../..";
+import { type ExcalidrawFontFaceDescriptor } from "../Fonts";
 export declare const CascadiaFontFaces: ExcalidrawFontFaceDescriptor[];

package/types/excalidraw/fonts/ComicShanns/index.d.ts

@@ -0,0 +1,2 @@
+import { type ExcalidrawFontFaceDescriptor } from "../Fonts";
+export declare const ComicShannsFontFaces: ExcalidrawFontFaceDescriptor[];

package/types/excalidraw/fonts/{woff2/Emoji → Emoji}/index.d.ts

@@ -1,2 +1,2 @@
-import { type ExcalidrawFontFaceDescriptor } from "../..";
+import { type ExcalidrawFontFaceDescriptor } from "../Fonts";
 export declare const EmojiFontFaces: ExcalidrawFontFaceDescriptor[];

package/types/excalidraw/fonts/ExcalidrawFontFace.d.ts

@@ -1,11 +1,5 @@
 type DataURL = string;
-export interface IExcalidrawFontFace {
-    urls: URL[] | DataURL[];
-    fontFace: FontFace;
-    toCSS(characters: string, codePoints: Array<number>): Promise<string> | undefined;
-    getContentLegacy(): Promise<string>;
-}
-export declare class ExcalidrawFontFace implements IExcalidrawFontFace {
+export declare class ExcalidrawFontFace {
     readonly urls: URL[] | DataURL[];
     readonly fontFace: FontFace;
     private static readonly UNPKG_FALLBACK_URL;
@@ -15,7 +9,7 @@ export declare class ExcalidrawFontFace implements IExcalidrawFontFace {
      *
      * Retrieves `undefined` otherwise.
      */
-    toCSS(characters: string, codePoints: Array<number>): Promise<string> | undefined;
+    toCSS(characters: string): Promise<string> | undefined;
     /**
      * Tries to fetch woff2 content, based on the registered urls (from first to last, treated as fallbacks).
      *

package/types/excalidraw/fonts/{woff2/Excalifont → Excalifont}/index.d.ts

@@ -1,2 +1,2 @@
-import { type ExcalidrawFontFaceDescriptor } from "../..";
+import { type ExcalidrawFontFaceDescriptor } from "../Fonts";
 export declare const ExcalifontFontFaces: ExcalidrawFontFaceDescriptor[];