@zsviczian/excalidraw 0.9.0-onTextEditEvents-2 → 0.10.0-fix-container-02

package/types/data/encode.d.ts

@@ -1,25 +1,53 @@
-export declare const toByteString: (data: string | Uint8Array) => Promise<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>;
-declare type EncodedData = {
-    encoded: string;
-    encoding: "bstring";
-    /** whether text is compressed (zlib) */
-    compressed: boolean;
-    /** version for potential migration purposes */
-    version?: string;
-};
-/**
- * Encodes (and potentially compresses via zlib) text to byte string
- */
-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>;
-export {};
+export declare const toByteString: (data: string | Uint8Array | ArrayBuffer) => Promise<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>;
+declare type EncodedData = {
+    encoded: string;
+    encoding: "bstring";
+    /** whether text is compressed (zlib) */
+    compressed: boolean;
+    /** version for potential migration purposes */
+    version?: string;
+};
+/**
+ * Encodes (and potentially compresses via zlib) text to byte string
+ */
+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>;
+/**
+ * The returned buffer has following format:
+ * `[]` refers to a buffers wrapper (see `concatBuffers`)
+ *
+ * [
+ *   encodingMetadataBuffer,
+ *   iv,
+ *   [
+ *      contentsMetadataBuffer
+ *      contentsBuffer
+ *   ]
+ * ]
+ */
+export declare const compressData: <T extends Record<string, any> = never>(dataBuffer: Uint8Array, options: {
+    encryptionKey: string;
+} & ([T] extends [never] ? {
+    metadata?: T | undefined;
+} : {
+    metadata: T;
+})) => Promise<Uint8Array>;
+export declare const decompressData: <T extends Record<string, any>>(bufferView: Uint8Array, options: {
+    decryptionKey: string;
+}) => Promise<{
+    /** metadata source is always JSON so we can decode it here */
+    metadata: T;
+    /** data can be anything so the caller must decode it */
+    data: Uint8Array;
+}>;
+export {};

package/types/data/encryption.d.ts

@@ -0,0 +1,9 @@
+export declare const IV_LENGTH_BYTES = 12;
+export declare const createIV: () => Uint8Array;
+export declare const generateEncryptionKey: <T extends "string" | "cryptoKey" = "string">(returnAs?: T | undefined) => Promise<T extends "cryptoKey" ? CryptoKey : string>;
+export declare const getCryptoKey: (key: string, usage: KeyUsage) => Promise<CryptoKey>;
+export declare const encryptData: (key: string | CryptoKey, data: Uint8Array | ArrayBuffer | Blob | File | string) => Promise<{
+    encryptedBuffer: ArrayBuffer;
+    iv: Uint8Array;
+}>;
+export declare const decryptData: (iv: Uint8Array, encrypted: Uint8Array | ArrayBuffer, privateKey: string) => Promise<ArrayBuffer>;

package/types/data/filesystem.d.ts

@@ -0,0 +1,18 @@
+import { FileWithHandle, FileSystemHandle, supported as nativeFileSystemSupported } from "browser-fs-access";
+declare type FILE_EXTENSION = "gif" | "jpg" | "png" | "svg" | "json" | "excalidraw" | "excalidrawlib";
+export declare const fileOpen: <M extends boolean | undefined = false>(opts: {
+    extensions?: FILE_EXTENSION[] | undefined;
+    description: string;
+    multiple?: M | undefined;
+}) => Promise<M extends false | undefined ? FileWithHandle : FileWithHandle[]>;
+export declare const fileSave: (blob: Blob, opts: {
+    /** supply without the extension */
+    name: string;
+    /** file extension */
+    extension: FILE_EXTENSION;
+    description: string;
+    /** existing FileSystemHandle */
+    fileHandle?: FileSystemHandle | null;
+}) => Promise<FileSystemHandle | null>;
+export type { FileSystemHandle };
+export { nativeFileSystemSupported };

package/types/data/image.d.ts

@@ -1,15 +1,15 @@
-export declare const getTEXtChunk: (blob: Blob) => Promise<{
-    keyword: string;
-    text: string;
-} | null>;
-export declare const encodePngMetadata: ({ blob, metadata, }: {
-    blob: Blob;
-    metadata: string;
-}) => Promise<Blob>;
-export declare const decodePngMetadata: (blob: Blob) => Promise<string>;
-export declare const encodeSvgMetadata: ({ text }: {
-    text: string;
-}) => Promise<string>;
-export declare const decodeSvgMetadata: ({ svg }: {
-    svg: string;
-}) => Promise<string>;
+export declare const getTEXtChunk: (blob: Blob) => Promise<{
+    keyword: string;
+    text: string;
+} | null>;
+export declare const encodePngMetadata: ({ blob, metadata, }: {
+    blob: Blob;
+    metadata: string;
+}) => Promise<Blob>;
+export declare const decodePngMetadata: (blob: Blob) => Promise<string>;
+export declare const encodeSvgMetadata: ({ text }: {
+    text: string;
+}) => Promise<string>;
+export declare const decodeSvgMetadata: ({ svg }: {
+    svg: string;
+}) => Promise<string>;

package/types/data/index.d.ts

@@ -1,13 +1,13 @@
-import { FileSystemHandle } from "browser-fs-access";
-import { NonDeletedExcalidrawElement } from "../element/types";
-import { ExportType } from "../scene/types";
-import { AppState } from "../types";
-export { loadFromBlob } from "./blob";
-export { loadFromJSON, saveAsJSON } from "./json";
-export declare const exportCanvas: (type: ExportType, elements: readonly NonDeletedExcalidrawElement[], appState: AppState, { exportBackground, exportPadding, viewBackgroundColor, name, fileHandle, }: {
-    exportBackground: boolean;
-    exportPadding?: number | undefined;
-    viewBackgroundColor: string;
-    name: string;
-    fileHandle?: FileSystemHandle | null | undefined;
-}) => Promise<FileSystemHandle | undefined>;
+import { NonDeletedExcalidrawElement } from "../element/types";
+import { ExportType } from "../scene/types";
+import { AppState, BinaryFiles } from "../types";
+import { FileSystemHandle } from "./filesystem";
+export { loadFromBlob } from "./blob";
+export { loadFromJSON, saveAsJSON } from "./json";
+export declare const exportCanvas: (type: ExportType, elements: readonly NonDeletedExcalidrawElement[], appState: AppState, files: BinaryFiles, { exportBackground, exportPadding, viewBackgroundColor, name, fileHandle, }: {
+    exportBackground: boolean;
+    exportPadding?: number | undefined;
+    viewBackgroundColor: string;
+    name: string;
+    fileHandle?: FileSystemHandle | null | undefined;
+}) => Promise<FileSystemHandle | null | undefined>;

package/types/data/json.d.ts

@@ -1,17 +1,17 @@
-import { ExcalidrawElement } from "../element/types";
-import { AppState } from "../types";
-import { ImportedDataState } from "./types";
-import Library from "./library";
-export declare const serializeAsJSON: (elements: readonly ExcalidrawElement[], appState: Partial<AppState>) => string;
-export declare const saveAsJSON: (elements: readonly ExcalidrawElement[], appState: AppState) => Promise<{
-    fileHandle: import("browser-fs-access").FileSystemHandle;
-}>;
-export declare const loadFromJSON: (localAppState: AppState, localElements: readonly ExcalidrawElement[] | null) => Promise<import("./restore").RestoredDataState>;
-export declare const isValidExcalidrawData: (data?: {
-    type?: any;
-    elements?: any;
-    appState?: any;
-} | undefined) => data is ImportedDataState;
-export declare const isValidLibrary: (json: any) => any;
-export declare const saveLibraryAsJSON: (library: Library) => Promise<void>;
-export declare const importLibraryFromJSON: (library: Library) => Promise<void>;
+import { ExcalidrawElement } from "../element/types";
+import { AppState, BinaryFiles, LibraryItems } from "../types";
+import { ImportedDataState } from "./types";
+import Library from "./library";
+export declare const serializeAsJSON: (elements: readonly ExcalidrawElement[], appState: Partial<AppState>, files: BinaryFiles, type: "local" | "database") => string;
+export declare const saveAsJSON: (elements: readonly ExcalidrawElement[], appState: AppState, files: BinaryFiles) => Promise<{
+    fileHandle: import("browser-fs-access").FileSystemHandle | null;
+}>;
+export declare const loadFromJSON: (localAppState: AppState, localElements: readonly ExcalidrawElement[] | null) => Promise<import("./restore").RestoredDataState>;
+export declare const isValidExcalidrawData: (data?: {
+    type?: any;
+    elements?: any;
+    appState?: any;
+} | undefined) => data is ImportedDataState;
+export declare const isValidLibrary: (json: any) => any;
+export declare const saveLibraryAsJSON: (libraryItems: LibraryItems) => Promise<void>;
+export declare const importLibraryFromJSON: (library: Library) => Promise<void>;

package/types/data/library.d.ts

@@ -1,14 +1,14 @@
-import { LibraryItems, LibraryItem } from "../types";
-import type App from "../components/App";
-declare class Library {
-    private libraryCache;
-    private app;
-    constructor(app: App);
-    resetLibrary: () => Promise<void>;
-    restoreLibraryItem: (libraryItem: LibraryItem) => LibraryItem | null;
-    /** imports library (currently merges, removing duplicates) */
-    importLibrary(blob: Blob): Promise<void>;
-    loadLibrary: () => Promise<LibraryItems>;
-    saveLibrary: (items: LibraryItems) => Promise<void>;
-}
-export default Library;
+import { LibraryItems, LibraryItem } from "../types";
+import type App from "../components/App";
+declare class Library {
+    private libraryCache;
+    private app;
+    constructor(app: App);
+    resetLibrary: () => Promise<void>;
+    restoreLibraryItem: (libraryItem: LibraryItem) => LibraryItem | null;
+    /** imports library (currently merges, removing duplicates) */
+    importLibrary(blob: Blob, defaultStatus?: string): Promise<void>;
+    loadLibrary: () => Promise<LibraryItems>;
+    saveLibrary: (items: LibraryItems) => Promise<void>;
+}
+export default Library;

package/types/data/resave.d.ts

@@ -1,5 +1,5 @@
-import { ExcalidrawElement } from "../element/types";
-import { AppState } from "../types";
-export declare const resaveAsImageWithScene: (elements: readonly ExcalidrawElement[], appState: AppState) => Promise<{
-    fileHandle: import("browser-fs-access").FileSystemHandle;
-}>;
+import { ExcalidrawElement } from "../element/types";
+import { AppState, BinaryFiles } from "../types";
+export declare const resaveAsImageWithScene: (elements: readonly ExcalidrawElement[], appState: AppState, files: BinaryFiles) => Promise<{
+    fileHandle: import("browser-fs-access").FileSystemHandle;
+}>;

package/types/data/restore.d.ts

@@ -1,13 +1,15 @@
-import { ExcalidrawElement } from "../element/types";
-import { AppState } from "../types";
-import { ImportedDataState } from "./types";
-declare type RestoredAppState = Omit<AppState, "offsetTop" | "offsetLeft" | "width" | "height">;
-export declare const AllowedExcalidrawElementTypes: Record<ExcalidrawElement["type"], true>;
-export declare type RestoredDataState = {
-    elements: ExcalidrawElement[];
-    appState: RestoredAppState;
-};
-export declare const restoreElements: (elements: ImportedDataState["elements"], localElements: readonly ExcalidrawElement[] | null | undefined) => ExcalidrawElement[];
-export declare const restoreAppState: (appState: ImportedDataState["appState"], localAppState: Partial<AppState> | null | undefined) => RestoredAppState;
-export declare const restore: (data: ImportedDataState | null, localAppState: Partial<AppState> | null | undefined, localElements: readonly ExcalidrawElement[] | null | undefined) => RestoredDataState;
-export {};
+import { ExcalidrawElement } from "../element/types";
+import { AppState, BinaryFiles, LibraryItem } from "../types";
+import { ImportedDataState } from "./types";
+declare type RestoredAppState = Omit<AppState, "offsetTop" | "offsetLeft" | "width" | "height">;
+export declare const AllowedExcalidrawElementTypes: Record<ExcalidrawElement["type"], true>;
+export declare type RestoredDataState = {
+    elements: ExcalidrawElement[];
+    appState: RestoredAppState;
+    files: BinaryFiles;
+};
+export declare const restoreElements: (elements: ImportedDataState["elements"], localElements: readonly ExcalidrawElement[] | null | undefined) => ExcalidrawElement[];
+export declare const restoreAppState: (appState: ImportedDataState["appState"], localAppState: Partial<AppState> | null | undefined) => RestoredAppState;
+export declare const restore: (data: ImportedDataState | null, localAppState: Partial<AppState> | null | undefined, localElements: readonly ExcalidrawElement[] | null | undefined) => RestoredDataState;
+export declare const restoreLibraryItems: (libraryItems: NonOptional<ImportedDataState["libraryItems"]>, defaultStatus: LibraryItem["status"]) => LibraryItem[];
+export {};

package/types/data/types.d.ts

@@ -1,27 +1,32 @@
-import { ExcalidrawElement } from "../element/types";
-import { AppState, LibraryItems } from "../types";
-import type { cleanAppStateForExport } from "../appState";
-export interface ExportedDataState {
-    type: string;
-    version: number;
-    source: string;
-    elements: readonly ExcalidrawElement[];
-    appState: ReturnType<typeof cleanAppStateForExport>;
-}
-export interface ImportedDataState {
-    type?: string;
-    version?: number;
-    source?: string;
-    elements?: readonly ExcalidrawElement[] | null;
-    appState?: Readonly<Partial<AppState>> | null;
-    scrollToContent?: boolean;
-    libraryItems?: LibraryItems;
-}
-export interface ExportedLibraryData {
-    type: string;
-    version: number;
-    source: string;
-    library: LibraryItems;
-}
-export interface ImportedLibraryData extends Partial<ExportedLibraryData> {
-}
+import { ExcalidrawElement } from "../element/types";
+import { AppState, BinaryFiles, LibraryItems, LibraryItems_v1 } from "../types";
+import type { cleanAppStateForExport } from "../appState";
+import { VERSIONS } from "../constants";
+export interface ExportedDataState {
+    type: string;
+    version: number;
+    source: string;
+    elements: readonly ExcalidrawElement[];
+    appState: ReturnType<typeof cleanAppStateForExport>;
+    files: BinaryFiles | undefined;
+}
+export interface ImportedDataState {
+    type?: string;
+    version?: number;
+    source?: string;
+    elements?: readonly ExcalidrawElement[] | null;
+    appState?: Readonly<Partial<AppState>> | null;
+    scrollToContent?: boolean;
+    libraryItems?: LibraryItems | LibraryItems_v1;
+    files?: BinaryFiles;
+}
+export interface ExportedLibraryData {
+    type: string;
+    version: typeof VERSIONS.excalidrawLibrary;
+    source: string;
+    libraryItems: LibraryItems;
+}
+export interface ImportedLibraryData extends Partial<ExportedLibraryData> {
+    /** @deprecated v1 */
+    library?: LibraryItems;
+}

package/types/disitrubte.d.ts

@@ -1,7 +1,7 @@
-import { ExcalidrawElement } from "./element/types";
-export interface Distribution {
-    space: "between";
-    axis: "x" | "y";
-}
-export declare const distributeElements: (selectedElements: ExcalidrawElement[], distribution: Distribution) => ExcalidrawElement[];
-export declare const getMaximumGroups: (elements: ExcalidrawElement[]) => ExcalidrawElement[][];
+import { ExcalidrawElement } from "./element/types";
+export interface Distribution {
+    space: "between";
+    axis: "x" | "y";
+}
+export declare const distributeElements: (selectedElements: ExcalidrawElement[], distribution: Distribution) => ExcalidrawElement[];
+export declare const getMaximumGroups: (elements: ExcalidrawElement[]) => ExcalidrawElement[][];

package/types/element/binding.d.ts

@@ -1,33 +1,33 @@
-import { ExcalidrawLinearElement, ExcalidrawBindableElement, NonDeleted, NonDeletedExcalidrawElement, ExcalidrawElement } from "./types";
-import { AppState } from "../types";
-import Scene from "../scene/Scene";
-export declare type SuggestedBinding = NonDeleted<ExcalidrawBindableElement> | SuggestedPointBinding;
-export declare type SuggestedPointBinding = [
-    NonDeleted<ExcalidrawLinearElement>,
-    "start" | "end" | "both",
-    NonDeleted<ExcalidrawBindableElement>
-];
-export declare const shouldEnableBindingForPointerEvent: (event: React.PointerEvent<HTMLCanvasElement>) => boolean;
-export declare const isBindingEnabled: (appState: AppState) => boolean;
-export declare const bindOrUnbindLinearElement: (linearElement: NonDeleted<ExcalidrawLinearElement>, startBindingElement: ExcalidrawBindableElement | null | "keep", endBindingElement: ExcalidrawBindableElement | null | "keep") => void;
-export declare const bindOrUnbindSelectedElements: (elements: NonDeleted<ExcalidrawElement>[]) => void;
-export declare const maybeBindLinearElement: (linearElement: NonDeleted<ExcalidrawLinearElement>, appState: AppState, scene: Scene, pointerCoords: {
-    x: number;
-    y: number;
-}) => void;
-export declare const isLinearElementSimpleAndAlreadyBound: (linearElement: NonDeleted<ExcalidrawLinearElement>, alreadyBoundToId: ExcalidrawBindableElement["id"] | undefined, bindableElement: ExcalidrawBindableElement) => boolean;
-export declare const unbindLinearElements: (elements: NonDeleted<ExcalidrawElement>[]) => void;
-export declare const getHoveredElementForBinding: (pointerCoords: {
-    x: number;
-    y: number;
-}, scene: Scene) => NonDeleted<ExcalidrawBindableElement> | null;
-export declare const updateBoundElements: (changedElement: NonDeletedExcalidrawElement, options?: {
-    simultaneouslyUpdated?: readonly ExcalidrawElement[] | undefined;
-    newSize?: {
-        width: number;
-        height: number;
-    } | undefined;
-} | undefined) => void;
-export declare const getEligibleElementsForBinding: (elements: NonDeleted<ExcalidrawElement>[]) => SuggestedBinding[];
-export declare const fixBindingsAfterDuplication: (sceneElements: readonly ExcalidrawElement[], oldElements: readonly ExcalidrawElement[], oldIdToDuplicatedId: Map<ExcalidrawElement["id"], ExcalidrawElement["id"]>, duplicatesServeAsOld?: "duplicatesServeAsOld" | undefined) => void;
-export declare const fixBindingsAfterDeletion: (sceneElements: readonly ExcalidrawElement[], deletedElements: readonly ExcalidrawElement[]) => void;
+import { ExcalidrawLinearElement, ExcalidrawBindableElement, NonDeleted, NonDeletedExcalidrawElement, ExcalidrawElement } from "./types";
+import { AppState } from "../types";
+import Scene from "../scene/Scene";
+export declare type SuggestedBinding = NonDeleted<ExcalidrawBindableElement> | SuggestedPointBinding;
+export declare type SuggestedPointBinding = [
+    NonDeleted<ExcalidrawLinearElement>,
+    "start" | "end" | "both",
+    NonDeleted<ExcalidrawBindableElement>
+];
+export declare const shouldEnableBindingForPointerEvent: (event: React.PointerEvent<HTMLCanvasElement>) => boolean;
+export declare const isBindingEnabled: (appState: AppState) => boolean;
+export declare const bindOrUnbindLinearElement: (linearElement: NonDeleted<ExcalidrawLinearElement>, startBindingElement: ExcalidrawBindableElement | null | "keep", endBindingElement: ExcalidrawBindableElement | null | "keep") => void;
+export declare const bindOrUnbindSelectedElements: (elements: NonDeleted<ExcalidrawElement>[]) => void;
+export declare const maybeBindLinearElement: (linearElement: NonDeleted<ExcalidrawLinearElement>, appState: AppState, scene: Scene, pointerCoords: {
+    x: number;
+    y: number;
+}) => void;
+export declare const isLinearElementSimpleAndAlreadyBound: (linearElement: NonDeleted<ExcalidrawLinearElement>, alreadyBoundToId: ExcalidrawBindableElement["id"] | undefined, bindableElement: ExcalidrawBindableElement) => boolean;
+export declare const unbindLinearElements: (elements: NonDeleted<ExcalidrawElement>[]) => void;
+export declare const getHoveredElementForBinding: (pointerCoords: {
+    x: number;
+    y: number;
+}, scene: Scene) => NonDeleted<ExcalidrawBindableElement> | null;
+export declare const updateBoundElements: (changedElement: NonDeletedExcalidrawElement, options?: {
+    simultaneouslyUpdated?: readonly ExcalidrawElement[] | undefined;
+    newSize?: {
+        width: number;
+        height: number;
+    } | undefined;
+} | undefined) => void;
+export declare const getEligibleElementsForBinding: (elements: NonDeleted<ExcalidrawElement>[]) => SuggestedBinding[];
+export declare const fixBindingsAfterDuplication: (sceneElements: readonly ExcalidrawElement[], oldElements: readonly ExcalidrawElement[], oldIdToDuplicatedId: Map<ExcalidrawElement["id"], ExcalidrawElement["id"]>, duplicatesServeAsOld?: "duplicatesServeAsOld" | undefined) => void;
+export declare const fixBindingsAfterDeletion: (sceneElements: readonly ExcalidrawElement[], deletedElements: readonly ExcalidrawElement[]) => void;

package/types/element/bounds.d.ts

@@ -1,16 +1,23 @@
-import { ExcalidrawElement, ExcalidrawLinearElement, Arrowhead } from "./types";
-import { Drawable, Op } from "roughjs/bin/core";
-export declare type Bounds = readonly [number, number, number, number];
-export declare const getElementAbsoluteCoords: (element: ExcalidrawElement) => Bounds;
-export declare const pointRelativeTo: (element: ExcalidrawElement, absoluteCoords: readonly [number, number]) => readonly [number, number];
-export declare const getDiamondPoints: (element: ExcalidrawElement) => number[];
-export declare const getCurvePathOps: (shape: Drawable) => Op[];
-export declare const getArrowheadPoints: (element: ExcalidrawLinearElement, shape: Drawable[], position: "start" | "end", arrowhead: Arrowhead) => number[] | null;
-export declare const getElementBounds: (element: ExcalidrawElement) => [number, number, number, number];
-export declare const getCommonBounds: (elements: readonly ExcalidrawElement[]) => [number, number, number, number];
-export declare const getResizedElementAbsoluteCoords: (element: ExcalidrawElement, nextWidth: number, nextHeight: number) => [number, number, number, number];
-export declare const getElementPointsCoords: (element: ExcalidrawLinearElement, points: readonly (readonly [number, number])[], sharpness: ExcalidrawElement["strokeSharpness"]) => [number, number, number, number];
-export declare const getClosestElementBounds: (elements: readonly ExcalidrawElement[], from: {
-    x: number;
-    y: number;
-}) => [number, number, number, number];
+import { ExcalidrawElement, ExcalidrawLinearElement, Arrowhead, NonDeleted } from "./types";
+import { Drawable, Op } from "roughjs/bin/core";
+export declare type Bounds = readonly [number, number, number, number];
+export declare const getElementAbsoluteCoords: (element: ExcalidrawElement) => Bounds;
+export declare const pointRelativeTo: (element: ExcalidrawElement, absoluteCoords: readonly [number, number]) => readonly [number, number];
+export declare const getDiamondPoints: (element: ExcalidrawElement) => number[];
+export declare const getCurvePathOps: (shape: Drawable) => Op[];
+export declare const getArrowheadPoints: (element: ExcalidrawLinearElement, shape: Drawable[], position: "start" | "end", arrowhead: Arrowhead) => number[] | null;
+export declare const getElementBounds: (element: ExcalidrawElement) => [number, number, number, number];
+export declare const getCommonBounds: (elements: readonly ExcalidrawElement[]) => [number, number, number, number];
+export declare const getResizedElementAbsoluteCoords: (element: ExcalidrawElement, nextWidth: number, nextHeight: number) => [number, number, number, number];
+export declare const getElementPointsCoords: (element: ExcalidrawLinearElement, points: readonly (readonly [number, number])[], sharpness: ExcalidrawElement["strokeSharpness"]) => [number, number, number, number];
+export declare const getClosestElementBounds: (elements: readonly ExcalidrawElement[], from: {
+    x: number;
+    y: number;
+}) => [number, number, number, number];
+export interface Box {
+    minX: number;
+    minY: number;
+    maxX: number;
+    maxY: number;
+}
+export declare const getCommonBoundingBox: (elements: ExcalidrawElement[] | readonly NonDeleted<ExcalidrawElement>[]) => Box;

package/types/element/collision.d.ts

@@ -1,19 +1,20 @@
-import * as GA from "../ga";
-import { NonDeletedExcalidrawElement, ExcalidrawBindableElement, ExcalidrawElement, ExcalidrawRectangleElement, ExcalidrawDiamondElement, ExcalidrawTextElement, ExcalidrawEllipseElement, NonDeleted } from "./types";
-import { Point } from "../types";
-import { AppState } from "../types";
-export declare const hitTest: (element: NonDeletedExcalidrawElement, appState: AppState, x: number, y: number) => boolean;
-export declare const isHittingElementBoundingBoxWithoutHittingElement: (element: NonDeletedExcalidrawElement, appState: AppState, x: number, y: number) => boolean;
-export declare const bindingBorderTest: (element: NonDeleted<ExcalidrawBindableElement>, { x, y }: {
-    x: number;
-    y: number;
-}) => boolean;
-export declare const maxBindingGap: (element: ExcalidrawElement, elementWidth: number, elementHeight: number) => number;
-export declare const distanceToBindableElement: (element: ExcalidrawBindableElement, point: readonly [number, number]) => number;
-export declare const pointInAbsoluteCoords: (element: ExcalidrawElement, point: readonly [number, number]) => readonly [number, number];
-export declare const determineFocusDistance: (element: ExcalidrawBindableElement, a: readonly [number, number], b: readonly [number, number]) => number;
-export declare const determineFocusPoint: (element: ExcalidrawBindableElement, focus: number, adjecentPoint: readonly [number, number]) => readonly [number, number];
-export declare const intersectElementWithLine: (element: ExcalidrawBindableElement, a: readonly [number, number], b: readonly [number, number], gap?: number) => Point[];
-export declare const getCircleIntersections: (center: readonly [number, number, number, number, number, number, number, number], radius: number, line: readonly [number, number, number, number, number, number, number, number]) => GA.Point[];
-export declare const findFocusPointForEllipse: (ellipse: ExcalidrawEllipseElement, relativeDistance: number, point: readonly [number, number, number, number, number, number, number, number]) => readonly [number, number, number, number, number, number, number, number];
-export declare const findFocusPointForRectangulars: (element: ExcalidrawRectangleElement | ExcalidrawDiamondElement | ExcalidrawTextElement, relativeDistance: number, point: readonly [number, number, number, number, number, number, number, number]) => readonly [number, number, number, number, number, number, number, number];
+import * as GA from "../ga";
+import { NonDeletedExcalidrawElement, ExcalidrawBindableElement, ExcalidrawElement, ExcalidrawRectangleElement, ExcalidrawDiamondElement, ExcalidrawTextElement, ExcalidrawEllipseElement, NonDeleted, ExcalidrawImageElement } from "./types";
+import { Point } from "../types";
+import { AppState } from "../types";
+export declare const hitTest: (element: NonDeletedExcalidrawElement, appState: AppState, x: number, y: number) => boolean;
+export declare const isHittingElementBoundingBoxWithoutHittingElement: (element: NonDeletedExcalidrawElement, appState: AppState, x: number, y: number) => boolean;
+export declare const isHittingElementNotConsideringBoundingBox: (element: NonDeletedExcalidrawElement, appState: AppState, point: readonly [number, number]) => boolean;
+export declare const bindingBorderTest: (element: NonDeleted<ExcalidrawBindableElement>, { x, y }: {
+    x: number;
+    y: number;
+}) => boolean;
+export declare const maxBindingGap: (element: ExcalidrawElement, elementWidth: number, elementHeight: number) => number;
+export declare const distanceToBindableElement: (element: ExcalidrawBindableElement, point: readonly [number, number]) => number;
+export declare const pointInAbsoluteCoords: (element: ExcalidrawElement, point: readonly [number, number]) => readonly [number, number];
+export declare const determineFocusDistance: (element: ExcalidrawBindableElement, a: readonly [number, number], b: readonly [number, number]) => number;
+export declare const determineFocusPoint: (element: ExcalidrawBindableElement, focus: number, adjecentPoint: readonly [number, number]) => readonly [number, number];
+export declare const intersectElementWithLine: (element: ExcalidrawBindableElement, a: readonly [number, number], b: readonly [number, number], gap?: number) => Point[];
+export declare const getCircleIntersections: (center: readonly [number, number, number, number, number, number, number, number], radius: number, line: readonly [number, number, number, number, number, number, number, number]) => GA.Point[];
+export declare const findFocusPointForEllipse: (ellipse: ExcalidrawEllipseElement, relativeDistance: number, point: readonly [number, number, number, number, number, number, number, number]) => readonly [number, number, number, number, number, number, number, number];
+export declare const findFocusPointForRectangulars: (element: ExcalidrawRectangleElement | ExcalidrawImageElement | ExcalidrawDiamondElement | ExcalidrawTextElement, relativeDistance: number, point: readonly [number, number, number, number, number, number, number, number]) => readonly [number, number, number, number, number, number, number, number];

package/types/element/dragElements.d.ts

@@ -1,7 +1,6 @@
-import { SHAPES } from "../shapes";
-import Scene from "../scene/Scene";
-import { NonDeletedExcalidrawElement } from "./types";
-import { PointerDownState } from "../types";
-export declare const dragSelectedElements: (pointerDownState: PointerDownState, selectedElements: NonDeletedExcalidrawElement[], pointerX: number, pointerY: number, scene: Scene, lockDirection?: boolean, distanceX?: number, distanceY?: number) => void;
-export declare const getDragOffsetXY: (selectedElements: NonDeletedExcalidrawElement[], x: number, y: number) => [number, number];
-export declare const dragNewElement: (draggingElement: NonDeletedExcalidrawElement, elementType: typeof SHAPES[number]["value"], originX: number, originY: number, x: number, y: number, width: number, height: number, isResizeWithSidesSameLength: boolean, isResizeCenterPoint: boolean) => void;
+import { SHAPES } from "../shapes";
+import { NonDeletedExcalidrawElement } from "./types";
+import { PointerDownState } from "../types";
+export declare const dragSelectedElements: (pointerDownState: PointerDownState, selectedElements: NonDeletedExcalidrawElement[], pointerX: number, pointerY: number, lockDirection?: boolean, distanceX?: number, distanceY?: number) => void;
+export declare const getDragOffsetXY: (selectedElements: NonDeletedExcalidrawElement[], x: number, y: number) => [number, number];
+export declare const dragNewElement: (draggingElement: NonDeletedExcalidrawElement, elementType: typeof SHAPES[number]["value"], originX: number, originY: number, x: number, y: number, width: number, height: number, shouldMaintainAspectRatio: boolean, shouldResizeFromCenter: boolean, widthAspectRatio?: number | null | undefined) => void;

package/types/element/image.d.ts

@@ -0,0 +1,22 @@
+import { AppClassProperties, DataURL, BinaryFiles } from "../types";
+import { ExcalidrawElement, FileId, InitializedExcalidrawImageElement } from "./types";
+export declare const loadHTMLImageElement: (dataURL: DataURL) => Promise<HTMLImageElement>;
+/** NOTE: updates cache even if already populated with given image. Thus,
+ * you should filter out the images upstream if you want to optimize this. */
+export declare const updateImageCache: ({ fileIds, files, imageCache, }: {
+    fileIds: FileId[];
+    files: BinaryFiles;
+    imageCache: AppClassProperties["imageCache"];
+}) => Promise<{
+    imageCache: Map<FileId, {
+        image: HTMLImageElement | Promise<HTMLImageElement>;
+        mimeType: "image/svg+xml" | "image/png" | "image/jpeg" | "image/gif";
+    }>;
+    /** includes errored files because they cache was updated nonetheless */
+    updatedFiles: Map<FileId, true>;
+    /** files that failed when creating HTMLImageElement */
+    erroredFiles: Map<FileId, true>;
+}>;
+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>;

package/types/element/index.d.ts

@@ -1,22 +1,20 @@
-import { ExcalidrawElement, NonDeletedExcalidrawElement, NonDeleted } from "./types";
-export { newElement, newTextElement, updateTextElement, newLinearElement, duplicateElement, } from "./newElement";
-export { getElementAbsoluteCoords, getElementBounds, getCommonBounds, getDiamondPoints, getArrowheadPoints, getClosestElementBounds, } from "./bounds";
-export { OMIT_SIDES_FOR_MULTIPLE_ELEMENTS, getTransformHandlesFromCoords, getTransformHandles, } from "./transformHandles";
-export { hitTest, isHittingElementBoundingBoxWithoutHittingElement, } from "./collision";
-export { resizeTest, getCursorForResizingElement, getElementWithTransformHandleType, getTransformHandleTypeFromCoords, } from "./resizeTest";
-export { transformElements, getResizeOffsetXY, getResizeArrowDirection, } from "./resizeElements";
-export { dragSelectedElements, getDragOffsetXY, dragNewElement, } from "./dragElements";
-export { isTextElement, isExcalidrawElement } from "./typeChecks";
-export { textWysiwyg } from "./textWysiwyg";
-export { redrawTextBoundingBox } from "./textElement";
-export { getPerfectElementSize, isInvisiblySmallElement, resizePerfectLineForNWHandler, getNormalizedDimensions, } from "./sizeHelpers";
-export { showSelectedShapeActions } from "./showSelectedShapeActions";
-export declare const getElementMap: (elements: readonly ExcalidrawElement[]) => {
-    [key: string]: ExcalidrawElement;
-};
-export declare const getSceneVersion: (elements: readonly ExcalidrawElement[]) => number;
-export declare const getVisibleElements: (elements: readonly ExcalidrawElement[]) => readonly NonDeletedExcalidrawElement[];
-export declare const getNonDeletedElements: (elements: readonly ExcalidrawElement[]) => readonly NonDeletedExcalidrawElement[];
-export declare const isNonDeletedElement: <T extends ExcalidrawElement>(element: T) => element is NonDeleted<T>;
-export declare const clearElementsForExport: (elements: readonly ExcalidrawElement[]) => ExcalidrawElement[];
-export declare const clearElementsForLocalStorage: (elements: readonly ExcalidrawElement[]) => ExcalidrawElement[];
+import { ExcalidrawElement, NonDeletedExcalidrawElement, NonDeleted } from "./types";
+export { newElement, newTextElement, updateTextElement, newLinearElement, newImageElement, duplicateElement, } from "./newElement";
+export { getElementAbsoluteCoords, getElementBounds, getCommonBounds, getDiamondPoints, getArrowheadPoints, getClosestElementBounds, } from "./bounds";
+export { OMIT_SIDES_FOR_MULTIPLE_ELEMENTS, getTransformHandlesFromCoords, getTransformHandles, } from "./transformHandles";
+export { hitTest, isHittingElementBoundingBoxWithoutHittingElement, } from "./collision";
+export { resizeTest, getCursorForResizingElement, getElementWithTransformHandleType, getTransformHandleTypeFromCoords, } from "./resizeTest";
+export { transformElements, getResizeOffsetXY, getResizeArrowDirection, } from "./resizeElements";
+export { dragSelectedElements, getDragOffsetXY, dragNewElement, } from "./dragElements";
+export { isTextElement, isExcalidrawElement } from "./typeChecks";
+export { textWysiwyg } from "./textWysiwyg";
+export { redrawTextBoundingBox } from "./textElement";
+export { getPerfectElementSize, isInvisiblySmallElement, resizePerfectLineForNWHandler, getNormalizedDimensions, } from "./sizeHelpers";
+export { showSelectedShapeActions } from "./showSelectedShapeActions";
+export declare const getSceneVersion: (elements: readonly ExcalidrawElement[]) => number;
+export declare const getVisibleElements: (elements: readonly ExcalidrawElement[]) => readonly NonDeletedExcalidrawElement[];
+export declare const getNonDeletedElements: (elements: readonly ExcalidrawElement[]) => readonly NonDeletedExcalidrawElement[];
+export declare const isNonDeletedElement: <T extends ExcalidrawElement>(element: T) => element is NonDeleted<T>;
+export declare const clearElementsForDatabase: (elements: readonly ExcalidrawElement[]) => ExcalidrawElement[];
+export declare const clearElementsForExport: (elements: readonly ExcalidrawElement[]) => ExcalidrawElement[];
+export declare const clearElementsForLocalStorage: (elements: readonly ExcalidrawElement[]) => ExcalidrawElement[];