@zsviczian/excalidraw 0.17.6-2 → 0.17.6-21

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

@@ -0,0 +1,117 @@
+import { ExcalidrawFontFace } from "./ExcalidrawFontFace";
+import { type FontMetadata } from "./FontMetadata";
+import type { ExcalidrawElement, ExcalidrawTextElement, FontFamilyValues } from "../element/types";
+import type Scene from "../scene/Scene";
+export declare class Fonts {
+    static readonly loadedFontsCache: Set<string>;
+    private static _registered;
+    private static _initialized;
+    static get registered(): Map<number, {
+        metadata: FontMetadata;
+        fontFaces: ExcalidrawFontFace[];
+    }>;
+    get registered(): Map<number, {
+        metadata: FontMetadata;
+        fontFaces: ExcalidrawFontFace[];
+    }>;
+    private readonly scene;
+    constructor(scene: Scene);
+    /**
+     * Get all the font families for the given scene.
+     */
+    getSceneFamilies: () => number[];
+    /**
+     * if we load a (new) font, it's likely that text elements using it have
+     * already been rendered using a fallback font. Thus, we want invalidate
+     * their shapes and rerender. See #637.
+     *
+     * Invalidates text elements and rerenders scene, provided that at least one
+     * of the supplied fontFaces has not already been processed.
+     */
+    onLoaded: (fontFaces: readonly FontFace[]) => void;
+    /**
+     * Load font faces for a given scene and trigger scene update.
+     *
+     * FontFaceSet loadingdone event we listen on may not always
+     * fire (looking at you Safari), so on init we manually load all
+     * fonts and rerender scene text elements once done.
+     *
+     * For Safari we make sure to check against each loaded font face
+     * with the unique characters per family in the scene,
+     * otherwise fonts might remain unloaded.
+     */
+    loadSceneFonts: () => Promise<FontFace[]>;
+    /**
+     * Load font faces for passed elements - use when the scene is unavailable (i.e. export).
+     *
+     * For Safari we make sure to check against each loaded font face,
+     * with the unique characters per family in the elements
+     * otherwise fonts might remain unloaded.
+     */
+    static loadElementsFonts: (elements: readonly ExcalidrawElement[]) => Promise<FontFace[]>;
+    /**
+     * Load all registered font faces.
+     */
+    static loadAllFonts: () => Promise<FontFace[]>;
+    /**
+     * Generate CSS @font-face declarations for the given elements.
+     */
+    static generateFontFaceDeclarations(elements: readonly ExcalidrawElement[]): Promise<string[]>;
+    static loadFontFaces(fontFamilies: Array<ExcalidrawTextElement["fontFamily"]>, charsPerFamily?: Record<number, Set<string>>): Promise<FontFace[]>;
+    private static fontFacesLoader;
+    private static fontFacesStylesGenerator;
+    /**
+     * Register a new font.
+     *
+     * @param family font family
+     * @param metadata font metadata
+     * @param fontFacesDecriptors font faces descriptors
+     */
+    static register(//zsviczian made public
+    this: Fonts | {
+        registered: Map<number, {
+            metadata: FontMetadata;
+            fontFaces: ExcalidrawFontFace[];
+        }>;
+    }, family: string, metadata: FontMetadata, ...fontFacesDecriptors: ExcalidrawFontFaceDescriptor[]): Map<number, {
+        metadata: FontMetadata;
+        fontFaces: ExcalidrawFontFace[];
+    }> | Map<number, {
+        metadata: FontMetadata;
+        fontFaces: ExcalidrawFontFace[];
+    }>;
+    /**
+     * WARN: should be called just once on init, even across multiple instances.
+     */
+    private static init;
+    /**
+     * Get all the unique font families for the given elements.
+     */
+    static getUniqueFamilies(elements: ReadonlyArray<ExcalidrawElement>): Array<ExcalidrawTextElement["fontFamily"]>;
+    /**
+     * Get all the unique characters per font family for the given scene.
+     */
+    private static getCharsPerFamily;
+    /**
+     * Get characters for a given family.
+     */
+    private static getCharacters;
+    /**
+     * Get all registered font families.
+     */
+    private static getAllFamilies;
+}
+/**
+ * Calculates vertical offset for a text with alphabetic baseline.
+ */
+export declare const getVerticalOffset: (fontFamily: ExcalidrawTextElement["fontFamily"], fontSize: ExcalidrawTextElement["fontSize"], lineHeightPx: number) => number;
+/**
+ * Gets line height forr a selected family.
+ */
+export declare const getLineHeight: (fontFamily: FontFamilyValues) => number & {
+    _brand: "unitlessLineHeight";
+};
+export interface ExcalidrawFontFaceDescriptor {
+    uri: string;
+    descriptors?: FontFaceDescriptors;
+}

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

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

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

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

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

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

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

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

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

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

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

@@ -1,4 +1,4 @@
-import { type ExcalidrawFontFaceDescriptor } from "../..";
+import { type ExcalidrawFontFaceDescriptor } from "../Fonts";
 /**
  * The original font was modified with the following changes:
  * - removed non-CJK codepoints

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

@@ -1,87 +1 @@
-import type Scene from "../scene/Scene";
-import type { ExcalidrawElement, ExcalidrawTextElement, FontFamilyValues } from "../element/types";
-import { type FontMetadata } from "./metadata";
-import { type IExcalidrawFontFace } from "./ExcalidrawFontFace";
-export declare class Fonts {
-    static readonly loadedFontsCache: Set<string>;
-    private static _registered;
-    private static _initialized;
-    static get registered(): Map<number, {
-        metadata: FontMetadata;
-        fontFaces: IExcalidrawFontFace[];
-    }>;
-    get registered(): Map<number, {
-        metadata: FontMetadata;
-        fontFaces: IExcalidrawFontFace[];
-    }>;
-    private readonly scene;
-    constructor({ scene }: {
-        scene: Scene;
-    });
-    /**
-     * if we load a (new) font, it's likely that text elements using it have
-     * already been rendered using a fallback font. Thus, we want invalidate
-     * their shapes and rerender. See #637.
-     *
-     * Invalidates text elements and rerenders scene, provided that at least one
-     * of the supplied fontFaces has not already been processed.
-     */
-    onLoaded: (fontFaces: readonly FontFace[]) => void;
-    /**
-     * Load font faces for a given scene and trigger scene update.
-     */
-    loadSceneFonts: () => Promise<FontFace[]>;
-    /**
-     * Load all registered font faces.
-     */
-    static loadAllFonts: () => Promise<FontFace[]>;
-    /**
-     * Load font faces for passed elements - use when the scene is unavailable (i.e. export).
-     */
-    static loadElementsFonts: (elements: readonly ExcalidrawElement[]) => Promise<FontFace[]>;
-    static loadFontFaces(fontFamilies: Array<ExcalidrawTextElement["fontFamily"]>): Promise<FontFace[]>;
-    /**
-     * WARN: should be called just once on init, even across multiple instances.
-     */
-    private static init;
-    /**
-     * Gets all the font families for the given scene.
-     */
-    getSceneFamilies: () => number[];
-    private static getAllFamilies;
-    static getElementsFamilies(elements: ReadonlyArray<ExcalidrawElement>): Array<ExcalidrawTextElement["fontFamily"]>;
-}
-/**
- * Register a new font.
- *
- * @param family font family
- * @param metadata font metadata
- * @param fontFacesDecriptors font faces descriptors
- */
-export declare function register(//zsviczian (changed from private to export)
-this: Fonts | {
-    registered: Map<number, {
-        metadata: FontMetadata;
-        fontFaces: IExcalidrawFontFace[];
-    }>;
-}, family: string, metadata: FontMetadata, ...fontFacesDecriptors: ExcalidrawFontFaceDescriptor[]): Map<number, {
-    metadata: FontMetadata;
-    fontFaces: IExcalidrawFontFace[];
-}> | Map<number, {
-    metadata: FontMetadata;
-    fontFaces: IExcalidrawFontFace[];
-}>;
-/**
- * Calculates vertical offset for a text with alphabetic baseline.
- */
-export declare const getVerticalOffset: (fontFamily: ExcalidrawTextElement["fontFamily"], fontSize: ExcalidrawTextElement["fontSize"], lineHeightPx: number) => number;
-/**
- * Gets line height forr a selected family.
- */
-export declare const getLineHeight: (fontFamily: FontFamilyValues) => number & {
-    _brand: "unitlessLineHeight";
-};
-export interface ExcalidrawFontFaceDescriptor {
-    uri: string;
-    descriptors?: FontFaceDescriptors;
-}
+export * from "./Fonts";

package/types/excalidraw/index.d.ts

@@ -1,7 +1,7 @@
 import React from "react";
 import "./css/app.scss";
 import "./css/styles.scss";
-import "./fonts/css/fonts.css";
+import "./fonts/fonts.css";
 import type { ExcalidrawProps } from "./types";
 import Footer from "./components/footer/FooterCenter";
 import MainMenu from "./components/main-menu/MainMenu";
@@ -60,3 +60,4 @@ export { getCommonBounds, getVisibleSceneBounds } from "./element/bounds";
 export { elementsOverlappingBBox, isElementInsideBBox, elementPartiallyOverlapsWithOrContainsBBox, } from "../utils/withinBounds";
 export { DiagramToCodePlugin } from "./components/DiagramToCodePlugin/DiagramToCodePlugin";
 export { getDataURL } from "./data/blob";
+export { isElementLink } from "./element/elementLink";

package/types/excalidraw/keys.d.ts

@@ -1,3 +1,4 @@
+import type { ValueOf } from "./utility-types";
 export declare const CODES: {
     readonly EQUAL: "Equal";
     readonly MINUS: "Minus";
@@ -18,6 +19,7 @@ export declare const CODES: {
     readonly H: "KeyH";
     readonly V: "KeyV";
     readonly Z: "KeyZ";
+    readonly Y: "KeyY";
     readonly R: "KeyR";
     readonly S: "KeyS";
 };
@@ -76,6 +78,111 @@ export declare const KEYS: {
     readonly 9: "9";
 };
 export type Key = keyof typeof KEYS;
+export declare const KeyCodeMap: Map<ValueOf<{
+    readonly ARROW_DOWN: "ArrowDown";
+    readonly ARROW_LEFT: "ArrowLeft";
+    readonly ARROW_RIGHT: "ArrowRight";
+    readonly ARROW_UP: "ArrowUp";
+    readonly PAGE_UP: "PageUp";
+    readonly PAGE_DOWN: "PageDown";
+    readonly BACKSPACE: "Backspace";
+    readonly ALT: "Alt";
+    readonly CTRL_OR_CMD: "metaKey" | "ctrlKey";
+    readonly DELETE: "Delete";
+    readonly ENTER: "Enter";
+    readonly ESCAPE: "Escape";
+    readonly QUESTION_MARK: "?";
+    readonly SPACE: " ";
+    readonly TAB: "Tab";
+    readonly CHEVRON_LEFT: "<";
+    readonly CHEVRON_RIGHT: ">";
+    readonly PERIOD: ".";
+    readonly COMMA: ",";
+    readonly SUBTRACT: "-";
+    readonly SLASH: "/";
+    readonly A: "a";
+    readonly C: "c";
+    readonly D: "d";
+    readonly E: "e";
+    readonly F: "f";
+    readonly G: "g";
+    readonly H: "h";
+    readonly I: "i";
+    readonly L: "l";
+    readonly O: "o";
+    readonly P: "p";
+    readonly Q: "q";
+    readonly R: "r";
+    readonly S: "s";
+    readonly T: "t";
+    readonly V: "v";
+    readonly X: "x";
+    readonly Y: "y";
+    readonly Z: "z";
+    readonly K: "k";
+    readonly W: "w";
+    readonly 0: "0";
+    readonly 1: "1";
+    readonly 2: "2";
+    readonly 3: "3";
+    readonly 4: "4";
+    readonly 5: "5";
+    readonly 6: "6";
+    readonly 7: "7";
+    readonly 8: "8";
+    readonly 9: "9";
+}>, ValueOf<{
+    readonly EQUAL: "Equal";
+    readonly MINUS: "Minus";
+    readonly NUM_ADD: "NumpadAdd";
+    readonly NUM_SUBTRACT: "NumpadSubtract";
+    readonly NUM_ZERO: "Numpad0";
+    readonly BRACKET_RIGHT: "BracketRight";
+    readonly BRACKET_LEFT: "BracketLeft";
+    readonly ONE: "Digit1";
+    readonly TWO: "Digit2";
+    readonly THREE: "Digit3";
+    readonly NINE: "Digit9";
+    readonly QUOTE: "Quote";
+    readonly ZERO: "Digit0";
+    readonly SLASH: "Slash";
+    readonly C: "KeyC";
+    readonly D: "KeyD";
+    readonly H: "KeyH";
+    readonly V: "KeyV";
+    readonly Z: "KeyZ";
+    readonly Y: "KeyY";
+    readonly R: "KeyR";
+    readonly S: "KeyS";
+}>>;
+export declare const isLatinChar: (key: string) => boolean;
+/**
+ * Used to match key events for any keyboard layout, especially on Windows and Linux,
+ * where non-latin character with modified (CMD) is not substituted with latin-based alternative.
+ *
+ * Uses `event.key` when it's latin, otherwise fallbacks to `event.code` (if mapping exists).
+ *
+ * Example of pressing "z" on different layouts, with the chosen key or code highlighted in []:
+ *
+ * Layout                | Code  | Key | Comment
+ * --------------------- | ----- | --- | -------
+ * U.S.                  |  KeyZ  | [z] |
+ * Czech                 |  KeyY  | [z] |
+ * Turkish               |  KeyN  | [z] |
+ * French                |  KeyW  | [z] |
+ * Macedonian            | [KeyZ] |  з  | z with cmd; з is Cyrillic equivalent of z
+ * Russian               | [KeyZ] |  я  | z with cmd
+ * Serbian               | [KeyZ] |  ѕ  | z with cmd
+ * Greek                 | [KeyZ] |  ζ  | z with cmd; also ζ is Greek equivalent of z
+ * Hebrew                | [KeyZ] |  ז  | z with cmd; also ז is Hebrew equivalent of z
+ * Pinyin - Simplified   |  KeyZ  | [z] | due to IME
+ * Cangije - Traditional | [KeyZ] |  重 | z with cmd
+ * Japanese              | [KeyZ] |  つ | z with cmd
+ * 2-Set Korean          | [KeyZ] |  ㅋ | z with cmd
+ *
+ * More details in https://github.com/excalidraw/excalidraw/pull/5944
+ */
+export declare const matchKey: (event: KeyboardEvent | React.KeyboardEvent<Element>, key: ValueOf<typeof KEYS>) => boolean;
 export declare const isArrowKey: (key: string) => boolean;
 export declare const shouldResizeFromCenter: (event: MouseEvent | KeyboardEvent) => boolean;
 export declare const shouldMaintainAspectRatio: (event: MouseEvent | KeyboardEvent) => boolean;

package/types/excalidraw/obsidianUtils.d.ts

@@ -1,8 +1,9 @@
 import { NonDeletedExcalidrawElement } from "./element/types";
-import type { FontMetadata } from "./fonts/metadata";
+import type { FontMetadata } from "./fonts/FontMetadata";
+import { AppState } from "./types";
 export declare let hostPlugin: any;
 export declare function destroyObsidianUtils(): void;
-export declare function initializeObsidianUtils(obsidianPlugin: any): void;
+export declare function initializeObsidianUtils(): void;
 export declare function getAreaLimit(): any;
 export declare function getWidthHeightLimit(): any;
 export declare function allowDoubleTapEraser(): any;
@@ -17,5 +18,6 @@ export declare function registerLocalFont(fontMetrics: FontMetadata & {
 export declare function getFontFamilies(): string[];
 export declare function registerFontsInCSS(): Promise<void>;
 export declare function getCSSFontDefinition(fontFamily: number): Promise<string>;
-export declare function loadSceneFonts(elements: NonDeletedExcalidrawElement[]): Promise<void>;
+export declare function loadSceneFonts(elements: NonDeletedExcalidrawElement[]): Promise<FontFace[]>;
 export declare function fetchFontFromVault(url: string | URL): Promise<ArrayBuffer | undefined>;
+export declare function isTouchInPenMode(appState: AppState, event: React.PointerEvent<HTMLElement> | MouseEvent): boolean;

package/types/excalidraw/renderer/renderElement.d.ts

@@ -1,9 +1,9 @@
-import type { ExcalidrawElement, ExcalidrawTextElement, NonDeletedExcalidrawElement, ExcalidrawFreeDrawElement, ExcalidrawFrameLikeElement, NonDeletedSceneElementsMap } from "../element/types";
+import type { ExcalidrawElement, ExcalidrawTextElement, NonDeletedExcalidrawElement, ExcalidrawFreeDrawElement, ExcalidrawImageElement, ExcalidrawFrameLikeElement, NonDeletedSceneElementsMap } from "../element/types";
 import type { RoughCanvas } from "roughjs/bin/canvas";
 import type { StaticCanvasRenderConfig, RenderableElementsMap, InteractiveCanvasRenderConfig } from "../scene/types";
 import type { AppState, StaticCanvasAppState, InteractiveCanvasAppState, ElementsPendingErasure, PendingExcalidrawElements } from "../types";
 export declare const IMAGE_INVERT_FILTER = "invert(100%) hue-rotate(180deg) saturate(1.25)";
-export declare const getRenderOpacity: (element: ExcalidrawElement, containingFrame: ExcalidrawFrameLikeElement | null, elementsPendingErasure: ElementsPendingErasure, pendingNodes: Readonly<PendingExcalidrawElements> | null) => number;
+export declare const getRenderOpacity: (element: ExcalidrawElement, containingFrame: ExcalidrawFrameLikeElement | null, elementsPendingErasure: ElementsPendingErasure, pendingNodes: Readonly<PendingExcalidrawElements> | null, globalAlpha?: number) => number;
 export interface ExcalidrawElementWithCanvas {
     element: ExcalidrawElement | ExcalidrawTextElement;
     canvas: HTMLCanvasElement;
@@ -14,6 +14,7 @@ export interface ExcalidrawElementWithCanvas {
     canvasOffsetX: number;
     canvasOffsetY: number;
     boundTextElementVersion: number | null;
+    imageCrop: ExcalidrawImageElement["crop"] | null;
     containingFrameOpacity: number;
     boundTextCanvas: HTMLCanvasElement;
 }

package/types/excalidraw/scene/Scene.d.ts

@@ -74,5 +74,6 @@ declare class Scene {
     getContainerElement: (element: (ExcalidrawElement & {
         containerId: ExcalidrawElement["id"] | null;
     }) | null) => import("../element/types").ExcalidrawSelectionElement | import("../element/types").ExcalidrawRectangleElement | import("../element/types").ExcalidrawDiamondElement | import("../element/types").ExcalidrawEllipseElement | import("../element/types").ExcalidrawTextElement | import("../element/types").ExcalidrawLinearElement | import("../element/types").ExcalidrawFreeDrawElement | import("../element/types").ExcalidrawImageElement | import("../element/types").ExcalidrawFrameElement | import("../element/types").ExcalidrawMagicFrameElement | import("../element/types").ExcalidrawIframeElement | import("../element/types").ExcalidrawEmbeddableElement | null;
+    getElementsFromId: (id: string) => ExcalidrawElement[];
 }
 export default Scene;

package/types/excalidraw/scene/comparisons.d.ts

@@ -289,6 +289,7 @@ export declare const getElementAtPosition: (elements: readonly NonDeletedExcalid
     fileId: import("../element/types").FileId | null;
     status: "pending" | "saved" | "error";
     scale: [number, number];
+    crop: import("../element/types").ImageCrop | null;
 }> & {
     isDeleted: boolean;
 }) | (Readonly<{

package/types/excalidraw/scene/export.d.ts

@@ -25,5 +25,6 @@ export declare const exportToSvg: (elements: readonly NonDeletedExcalidrawElemen
     renderEmbeddables?: boolean;
     exportingFrame?: ExcalidrawFrameLikeElement | null;
     skipInliningFonts?: true;
+    reuseImages?: boolean;
 }) => Promise<SVGSVGElement>;
 export declare const getExportSize: (elements: readonly NonDeletedExcalidrawElement[], exportPadding: number, scale: number) => [number, number];

package/types/excalidraw/scene/types.d.ts

@@ -26,6 +26,13 @@ export type SVGRenderConfig = {
     canvasBackgroundColor: AppState["viewBackgroundColor"];
     frameColor?: AppState["frameColor"];
     embedsValidationStatus: EmbedsValidationStatus;
+    /**
+     * whether to attempt to reuse images as much as possible through symbols
+     * (reduces SVG size, but may be incompoatible with some SVG renderers)
+     *
+     * @default true
+     */
+    reuseImages: boolean;
 };
 export type InteractiveCanvasRenderConfig = {
     remoteSelectedElementIds: Map<ExcalidrawElement["id"], SocketId[]>;

package/types/excalidraw/types.d.ts

@@ -77,6 +77,11 @@ export type BinaryFileData = {
      * Epoch timestamp in milliseconds.
      */
     lastRetrieved?: number;
+    /**
+     * indicates the version of the file. This can be used to determine whether
+     * the file dataURL has changed e.g. as part of restore due to schema update.
+     */
+    version?: number;
 };
 export type BinaryFileMetadata = Omit<BinaryFileData, "dataURL">;
 export type BinaryFiles = Record<ExcalidrawElement["id"], BinaryFileData>;
@@ -102,6 +107,7 @@ type _CommonCanvasAppState = {
     width: AppState["width"];
     height: AppState["height"];
     viewModeEnabled: AppState["viewModeEnabled"];
+    openDialog: AppState["openDialog"];
     editingGroupId: AppState["editingGroupId"];
     selectedElementIds: AppState["selectedElementIds"];
     frameToHighlight: AppState["frameToHighlight"];
@@ -123,6 +129,8 @@ export type StaticCanvasAppState = Readonly<_CommonCanvasAppState & {
     gridColor: AppState["gridColor"];
     frameColor: AppState["frameColor"];
     currentHoveredFontFamily: AppState["currentHoveredFontFamily"];
+    hoveredElementIds: AppState["hoveredElementIds"];
+    croppingElementId: AppState["croppingElementId"];
 }>;
 export type InteractiveCanvasAppState = Readonly<_CommonCanvasAppState & {
     activeEmbeddable: AppState["activeEmbeddable"];
@@ -141,6 +149,8 @@ export type InteractiveCanvasAppState = Readonly<_CommonCanvasAppState & {
     editingTextElement: AppState["editingTextElement"];
     gridColor: AppState["gridColor"];
     highlightSearchResult: AppState["highlightSearchResult"];
+    isCropping: AppState["isCropping"];
+    croppingElementId: AppState["croppingElementId"];
     searchMatches: AppState["searchMatches"];
 }>;
 export type ObservedAppState = ObservedStandaloneAppState & ObservedElementsAppState;
@@ -154,6 +164,7 @@ export type ObservedElementsAppState = {
     selectedGroupIds: AppState["selectedGroupIds"];
     editingLinearElementId: LinearElementEditor["elementId"] | null;
     selectedLinearElementId: LinearElementEditor["elementId"] | null;
+    croppingElementId: AppState["croppingElementId"];
 };
 export interface AppState {
     contextMenu: {
@@ -256,6 +267,9 @@ export interface AppState {
         tab: "text-to-diagram" | "mermaid";
     } | {
         name: "commandPalette";
+    } | {
+        name: "elementLinkSelector";
+        sourceElementId: ExcalidrawElement["id"];
     };
     /**
      * Reflects user preference for whether the default sidebar should be docked.
@@ -269,6 +283,9 @@ export interface AppState {
     selectedElementIds: Readonly<{
         [id: string]: true;
     }>;
+    hoveredElementIds: Readonly<{
+        [id: string]: true;
+    }>;
     previousSelectedElementIds: {
         [id: string]: true;
     };
@@ -358,6 +375,9 @@ export interface AppState {
     userToFollow: UserToFollow | null;
     /** the socket ids of the users following the current user */
     followedBy: Set<SocketId>;
+    /** image cropping */
+    isCropping: boolean;
+    croppingElementId: ExcalidrawElement["id"] | null;
     searchMatches: readonly SearchMatch[];
 }
 type SearchMatch = {
@@ -450,7 +470,7 @@ export interface ExcalidrawProps {
     handleKeyboardGlobally?: boolean;
     onLibraryChange?: (libraryItems: LibraryItems) => void | Promise<any>;
     autoFocus?: boolean;
-    onBeforeTextEdit?: (textElement: ExcalidrawTextElement) => string;
+    onBeforeTextEdit?: (textElement: ExcalidrawTextElement, isExistingElement: boolean) => string;
     onBeforeTextSubmit?: (textElement: ExcalidrawTextElement, nextText: string, //wrapped
     nextOriginalText: string, isDeleted: boolean) => {
         updatedNextOriginalText: string;
@@ -459,6 +479,7 @@ export interface ExcalidrawProps {
     generateIdForFile?: (file: File) => string | Promise<string>;
     onThemeChange?: (newTheme: string) => void;
     onViewModeChange?: (isViewModeEnabled: boolean) => void;
+    generateLinkForSelection?: (id: string, type: "element" | "group") => string;
     onLinkOpen?: (element: NonDeletedExcalidrawElement, event: CustomEvent<{
         nativeEvent: MouseEvent | React.PointerEvent<HTMLCanvasElement>;
     }>) => void;
@@ -475,8 +496,8 @@ export interface ExcalidrawProps {
     renderMermaid?: boolean;
     onContextMenu?: (element: readonly NonDeletedExcalidrawElement[], appState: AppState, onClose: (callback?: () => void) => void) => JSX.Element | null;
     aiEnabled?: boolean;
-    obsidianHostPlugin: WeakRef<any>;
     showDeprecatedFonts?: boolean;
+    insertLinkAction?: (linkVal: string) => void;
 }
 export type SceneData = {
     elements?: ImportedDataState["elements"];
@@ -631,6 +652,7 @@ export interface ExcalidrawImperativeAPI {
         clear: InstanceType<typeof App>["resetHistory"];
     };
     zoomToFit: InstanceType<typeof App>["zoomToFit"];
+    getColorAtScenePoint: InstanceType<typeof App>["getColorAtScenePoint"];
     startLineEditor: InstanceType<typeof App>["startLineEditor"];
     getSceneElements: InstanceType<typeof App>["getSceneElements"];
     getAppState: () => InstanceType<typeof App>["state"];

package/types/math/utils.d.ts

@@ -4,3 +4,4 @@ export declare const round: (value: number, precision: number, func?: "round" |
 export declare const roundToStep: (value: number, step: number, func?: "round" | "floor" | "ceil") => number;
 export declare const average: (a: number, b: number) => number;
 export declare const isFiniteNumber: (value: any) => value is number;
+export declare const isCloseTo: (a: number, b: number, precision?: number) => boolean;

package/types/math/vector.d.ts

@@ -86,3 +86,7 @@ export declare function vectorMagnitude(v: Vector): number;
  * @returns The new normalized vector
  */
 export declare const vectorNormalize: (v: Vector) => Vector;
+/**
+ * Project the first vector onto the second vector
+ */
+export declare const vectorProjection: (a: Vector, b: Vector) => Vector;

package/types/utils/export.d.ts

@@ -22,10 +22,11 @@ export declare const exportToBlob: (opts: ExportOpts & {
     quality?: number;
     exportPadding?: number;
 }) => Promise<Blob>;
-export declare const exportToSvg: ({ elements, appState, files, exportPadding, renderEmbeddables, exportingFrame, skipInliningFonts, }: Omit<ExportOpts, "getDimensions"> & {
+export declare const exportToSvg: ({ elements, appState, files, exportPadding, renderEmbeddables, exportingFrame, skipInliningFonts, reuseImages, }: Omit<ExportOpts, "getDimensions"> & {
     exportPadding?: number | undefined;
     renderEmbeddables?: boolean | undefined;
     skipInliningFonts?: true | undefined;
+    reuseImages?: boolean | undefined;
 }) => Promise<SVGSVGElement>;
 export declare const exportToClipboard: (opts: ExportOpts & {
     mimeType?: string;
@@ -36,9 +37,10 @@ export { getCommonBoundingBox } from "../excalidraw/element/bounds";
 export { getMaximumGroups } from "../excalidraw/groups";
 export { intersectElementWithLine } from "../excalidraw/element/binding";
 export { determineFocusDistance } from "../excalidraw/element/binding";
-export { measureText, wrapText } from "../excalidraw/element/textElement";
+export { measureText } from "../excalidraw/element/textElement";
+export { wrapText } from "../excalidraw/element/textWrapping";
 export { getLineHeight } from "../excalidraw/fonts/index";
 export { getFontString, getFontFamilyString } from "../excalidraw/utils";
 export { getBoundTextMaxWidth } from "../excalidraw/element/textElement";
-export { mermaidToExcalidraw } from "../excalidraw/components/TTDDialog/MermaidToExcalidraw";
+export { mermaidToExcalidraw } from "../excalidraw/components/TTDDialog/MermaidToExcalidrawLib";
 export { destroyObsidianUtils, registerLocalFont, getFontFamilies, registerFontsInCSS, getCSSFontDefinition, loadSceneFonts, } from "../excalidraw/obsidianUtils";