@excalidraw/excalidraw 0.7.0 → 0.11.0

package/types/element/newElement.d.ts

@@ -1,26 +1,36 @@
-import { ExcalidrawElement, ExcalidrawTextElement, ExcalidrawLinearElement, ExcalidrawGenericElement, NonDeleted, TextAlign, FontFamily, GroupId, VerticalAlign, Arrowhead } from "../element/types";
+import { ExcalidrawElement, ExcalidrawImageElement, ExcalidrawTextElement, ExcalidrawLinearElement, ExcalidrawGenericElement, NonDeleted, TextAlign, GroupId, VerticalAlign, Arrowhead, ExcalidrawFreeDrawElement, FontFamilyValues, ExcalidrawRectangleElement } from "../element/types";
 import { AppState } from "../types";
-declare type ElementConstructorOpts = MarkOptional<Omit<ExcalidrawGenericElement, "id" | "type" | "isDeleted">, "width" | "height" | "angle" | "groupIds" | "boundElementIds" | "seed" | "version" | "versionNonce">;
+declare type ElementConstructorOpts = MarkOptional<Omit<ExcalidrawGenericElement, "id" | "type" | "isDeleted" | "updated">, "width" | "height" | "angle" | "groupIds" | "boundElements" | "seed" | "version" | "versionNonce" | "link">;
 export declare const newElement: (opts: {
     type: ExcalidrawGenericElement["type"];
 } & ElementConstructorOpts) => NonDeleted<ExcalidrawGenericElement>;
 export declare const newTextElement: (opts: {
     text: string;
     fontSize: number;
-    fontFamily: FontFamily;
+    fontFamily: FontFamilyValues;
     textAlign: TextAlign;
     verticalAlign: VerticalAlign;
+    containerId?: ExcalidrawRectangleElement["id"];
 } & ElementConstructorOpts) => NonDeleted<ExcalidrawTextElement>;
-export declare const updateTextElement: (element: ExcalidrawTextElement, { text, isDeleted }: {
+export declare const updateTextElement: (element: ExcalidrawTextElement, { text, isDeleted, originalText, }: {
     text: string;
     isDeleted?: boolean | undefined;
+    originalText: string;
 }) => ExcalidrawTextElement;
+export declare const newFreeDrawElement: (opts: {
+    type: "freedraw";
+    points?: ExcalidrawFreeDrawElement["points"];
+    simulatePressure: boolean;
+} & ElementConstructorOpts) => NonDeleted<ExcalidrawFreeDrawElement>;
 export declare const newLinearElement: (opts: {
     type: ExcalidrawLinearElement["type"];
     startArrowhead: Arrowhead | null;
     endArrowhead: Arrowhead | null;
     points?: ExcalidrawLinearElement["points"];
 } & ElementConstructorOpts) => NonDeleted<ExcalidrawLinearElement>;
+export declare const newImageElement: (opts: {
+    type: ExcalidrawImageElement["type"];
+} & ElementConstructorOpts) => NonDeleted<ExcalidrawImageElement>;
 export declare const deepCopyElement: (val: any, depth?: number) => any;
 /**
  * Duplicate an element, often used in the alt-drag operation.

package/types/element/resizeElements.d.ts

@@ -1,9 +1,9 @@
 import { ExcalidrawLinearElement, NonDeletedExcalidrawElement, NonDeleted } from "./types";
 import { MaybeTransformHandleType, TransformHandleDirection } from "./transformHandles";
-import { PointerDownState } from "../components/App";
+import { PointerDownState } from "../types";
 export declare const normalizeAngle: (angle: number) => number;
-export declare const transformElements: (pointerDownState: PointerDownState, transformHandleType: MaybeTransformHandleType, selectedElements: readonly NonDeletedExcalidrawElement[], resizeArrowDirection: "origin" | "end", isRotateWithDiscreteAngle: boolean, isResizeCenterPoint: boolean, shouldKeepSidesRatio: boolean, pointerX: number, pointerY: number, centerX: number, centerY: number) => boolean;
-export declare const reshapeSingleTwoPointElement: (element: NonDeleted<ExcalidrawLinearElement>, resizeArrowDirection: "origin" | "end", isRotateWithDiscreteAngle: boolean, pointerX: number, pointerY: number) => void;
-export declare const resizeSingleElement: (stateAtResizeStart: NonDeletedExcalidrawElement, shouldKeepSidesRatio: boolean, element: NonDeletedExcalidrawElement, transformHandleDirection: TransformHandleDirection, isResizeFromCenter: boolean, pointerX: number, pointerY: number) => void;
+export declare const transformElements: (pointerDownState: PointerDownState, transformHandleType: MaybeTransformHandleType, selectedElements: readonly NonDeletedExcalidrawElement[], resizeArrowDirection: "origin" | "end", shouldRotateWithDiscreteAngle: boolean, shouldResizeFromCenter: boolean, shouldMaintainAspectRatio: boolean, pointerX: number, pointerY: number, centerX: number, centerY: number) => boolean;
+export declare const reshapeSingleTwoPointElement: (element: NonDeleted<ExcalidrawLinearElement>, resizeArrowDirection: "origin" | "end", shouldRotateWithDiscreteAngle: boolean, pointerX: number, pointerY: number) => void;
+export declare const resizeSingleElement: (stateAtResizeStart: NonDeletedExcalidrawElement, shouldMaintainAspectRatio: boolean, element: NonDeletedExcalidrawElement, transformHandleDirection: TransformHandleDirection, shouldResizeFromCenter: boolean, pointerX: number, pointerY: number) => void;
 export declare const getResizeOffsetXY: (transformHandleType: MaybeTransformHandleType, selectedElements: NonDeletedExcalidrawElement[], x: number, y: number) => [number, number];
 export declare const getResizeArrowDirection: (transformHandleType: MaybeTransformHandleType, element: NonDeleted<ExcalidrawLinearElement>) => "origin" | "end";

package/types/element/textElement.d.ts

@@ -1,2 +1,26 @@
-import { ExcalidrawTextElement } from "./types";
-export declare const redrawTextBoundingBox: (element: ExcalidrawTextElement) => void;
+import { ExcalidrawElement, ExcalidrawTextElement, ExcalidrawTextElementWithContainer, FontString, NonDeletedExcalidrawElement } from "./types";
+import { MaybeTransformHandleType } from "./transformHandles";
+import { AppState } from "../types";
+export declare const redrawTextBoundingBox: (element: ExcalidrawTextElement, container: ExcalidrawElement | null, appState: AppState) => void;
+export declare const bindTextToShapeAfterDuplication: (sceneElements: ExcalidrawElement[], oldElements: ExcalidrawElement[], oldIdToDuplicatedId: Map<ExcalidrawElement["id"], ExcalidrawElement["id"]>) => void;
+export declare const handleBindTextResize: (elements: readonly NonDeletedExcalidrawElement[], transformHandleType: MaybeTransformHandleType) => void;
+export declare const measureText: (text: string, font: FontString, maxWidth?: number | null | undefined) => {
+    width: number;
+    height: number;
+    baseline: number;
+};
+export declare const getApproxLineHeight: (font: FontString) => number;
+export declare const wrapText: (text: string, font: FontString, containerWidth: number) => string;
+export declare const charWidth: {
+    calculate: (char: string, font: FontString) => number;
+    getCache: (font: FontString) => number[];
+};
+export declare const getApproxMinLineWidth: (font: FontString) => number;
+export declare const getApproxMinLineHeight: (font: FontString) => number;
+export declare const getMinCharWidth: (font: FontString) => number;
+export declare const getApproxCharsToFitInWidth: (font: FontString, width: number) => number;
+export declare const getBoundTextElementId: (container: ExcalidrawElement | null) => string | undefined;
+export declare const getBoundTextElement: (element: ExcalidrawElement | null) => ExcalidrawTextElementWithContainer | null;
+export declare const getContainerElement: (element: (ExcalidrawElement & {
+    containerId: ExcalidrawElement["id"] | null;
+}) | null) => ExcalidrawElement | null;

package/types/element/textWysiwyg.d.ts

@@ -1,15 +1,16 @@
-import { ExcalidrawElement } from "./types";
-import { AppState } from "../types";
-export declare const textWysiwyg: ({ id, appState, onChange, onSubmit, getViewportCoords, element, canvas, excalidrawContainer, }: {
+import { ExcalidrawElement, ExcalidrawTextElement } from "./types";
+import App from "../components/App";
+export declare const textWysiwyg: ({ id, onChange, onSubmit, getViewportCoords, element, canvas, excalidrawContainer, app, }: {
     id: ExcalidrawElement["id"];
-    appState: AppState;
     onChange?: ((text: string) => void) | undefined;
     onSubmit: (data: {
         text: string;
         viaKeyboard: boolean;
+        originalText: string;
     }) => void;
     getViewportCoords: (x: number, y: number) => [number, number];
-    element: ExcalidrawElement;
+    element: ExcalidrawTextElement;
     canvas: HTMLCanvasElement | null;
     excalidrawContainer: HTMLDivElement | null;
+    app: App;
 }) => void;

package/types/element/typeChecks.d.ts

@@ -1,9 +1,16 @@
-import { ExcalidrawElement, ExcalidrawTextElement, ExcalidrawLinearElement, ExcalidrawBindableElement, ExcalidrawGenericElement } from "./types";
+import { ExcalidrawElement, ExcalidrawTextElement, ExcalidrawLinearElement, ExcalidrawBindableElement, ExcalidrawGenericElement, ExcalidrawFreeDrawElement, InitializedExcalidrawImageElement, ExcalidrawImageElement, ExcalidrawTextElementWithContainer } from "./types";
 export declare const isGenericElement: (element: ExcalidrawElement | null) => element is ExcalidrawGenericElement;
+export declare const isInitializedImageElement: (element: ExcalidrawElement | null) => element is InitializedExcalidrawImageElement;
+export declare const isImageElement: (element: ExcalidrawElement | null) => element is ExcalidrawImageElement;
 export declare const isTextElement: (element: ExcalidrawElement | null) => element is ExcalidrawTextElement;
+export declare const isFreeDrawElement: (element?: ExcalidrawElement | null | undefined) => element is ExcalidrawFreeDrawElement;
+export declare const isFreeDrawElementType: (elementType: ExcalidrawElement["type"]) => boolean;
 export declare const isLinearElement: (element?: ExcalidrawElement | null | undefined) => element is ExcalidrawLinearElement;
 export declare const isLinearElementType: (elementType: ExcalidrawElement["type"]) => boolean;
 export declare const isBindingElement: (element?: ExcalidrawElement | null | undefined) => element is ExcalidrawLinearElement;
 export declare const isBindingElementType: (elementType: ExcalidrawElement["type"]) => boolean;
 export declare const isBindableElement: (element: ExcalidrawElement | null) => element is ExcalidrawBindableElement;
+export declare const isTextBindableContainer: (element: ExcalidrawElement | null) => boolean;
 export declare const isExcalidrawElement: (element: any) => boolean;
+export declare const hasBoundTextElement: (element: ExcalidrawElement | null) => element is ExcalidrawBindableElement;
+export declare const isBoundToContainer: (element: ExcalidrawElement | null) => element is ExcalidrawTextElementWithContainer;

package/types/element/types.d.ts

@@ -1,8 +1,10 @@
 import { Point } from "../types";
-import { FONT_FAMILY } from "../constants";
+import { FONT_FAMILY, THEME } from "../constants";
 export declare type ChartType = "bar" | "line";
 export declare type FillStyle = "hachure" | "cross-hatch" | "solid";
-export declare type FontFamily = keyof typeof FONT_FAMILY;
+export declare type FontFamilyKeys = keyof typeof FONT_FAMILY;
+export declare type FontFamilyValues = typeof FONT_FAMILY[FontFamilyKeys];
+export declare type Theme = typeof THEME[keyof typeof THEME];
 export declare type FontString = string & {
     _brand: "fontString";
 };
@@ -41,8 +43,14 @@ declare type _ExcalidrawElementBase = Readonly<{
     /** List of groups the element belongs to.
         Ordered from deepest to shallowest. */
     groupIds: readonly GroupId[];
-    /** Ids of (linear) elements that are bound to this element. */
-    boundElementIds: readonly ExcalidrawLinearElement["id"][] | null;
+    /** other elements that are bound to this element */
+    boundElements: readonly Readonly<{
+        id: ExcalidrawLinearElement["id"];
+        type: "arrow" | "text";
+    }>[] | null;
+    /** epoch (ms) timestamp of last element update */
+    updated: number;
+    link: string | null;
 }>;
 export declare type ExcalidrawSelectionElement = _ExcalidrawElementBase & {
     type: "selection";
@@ -56,6 +64,15 @@ export declare type ExcalidrawDiamondElement = _ExcalidrawElementBase & {
 export declare type ExcalidrawEllipseElement = _ExcalidrawElementBase & {
     type: "ellipse";
 };
+export declare type ExcalidrawImageElement = _ExcalidrawElementBase & Readonly<{
+    type: "image";
+    fileId: FileId | null;
+    /** whether respective file is persisted */
+    status: "pending" | "saved" | "error";
+    /** X and Y scale factors <-1, 1>, used for image axis flipping */
+    scale: [number, number];
+}>;
+export declare type InitializedExcalidrawImageElement = MarkNonNullable<ExcalidrawImageElement, "fileId">;
 /**
  * These are elements that don't have any additional properties.
  */
@@ -65,29 +82,34 @@ export declare type ExcalidrawGenericElement = ExcalidrawSelectionElement | Exca
  * no computed data. The list of all ExcalidrawElements should be shareable
  * between peers and contain no state local to the peer.
  */
-export declare type ExcalidrawElement = ExcalidrawGenericElement | ExcalidrawTextElement | ExcalidrawLinearElement;
+export declare type ExcalidrawElement = ExcalidrawGenericElement | ExcalidrawTextElement | ExcalidrawLinearElement | ExcalidrawFreeDrawElement | ExcalidrawImageElement;
 export declare type NonDeleted<TElement extends ExcalidrawElement> = TElement & {
-    isDeleted: false;
+    isDeleted: boolean;
 };
 export declare type NonDeletedExcalidrawElement = NonDeleted<ExcalidrawElement>;
 export declare type ExcalidrawTextElement = _ExcalidrawElementBase & Readonly<{
     type: "text";
     fontSize: number;
-    fontFamily: FontFamily;
+    fontFamily: FontFamilyValues;
     text: string;
     baseline: number;
     textAlign: TextAlign;
     verticalAlign: VerticalAlign;
+    containerId: ExcalidrawGenericElement["id"] | null;
+    originalText: string;
 }>;
-export declare type ExcalidrawBindableElement = ExcalidrawRectangleElement | ExcalidrawDiamondElement | ExcalidrawEllipseElement | ExcalidrawTextElement;
+export declare type ExcalidrawBindableElement = ExcalidrawRectangleElement | ExcalidrawDiamondElement | ExcalidrawEllipseElement | ExcalidrawTextElement | ExcalidrawImageElement;
+export declare type ExcalidrawTextElementWithContainer = {
+    containerId: ExcalidrawGenericElement["id"];
+} & ExcalidrawTextElement;
 export declare type PointBinding = {
     elementId: ExcalidrawBindableElement["id"];
     focus: number;
     gap: number;
 };
-export declare type Arrowhead = "arrow" | "bar" | "dot";
+export declare type Arrowhead = "arrow" | "bar" | "dot" | "triangle";
 export declare type ExcalidrawLinearElement = _ExcalidrawElementBase & Readonly<{
-    type: "line" | "draw" | "arrow";
+    type: "line" | "arrow";
     points: readonly Point[];
     lastCommittedPoint: Point | null;
     startBinding: PointBinding | null;
@@ -95,4 +117,14 @@ export declare type ExcalidrawLinearElement = _ExcalidrawElementBase & Readonly<
     startArrowhead: Arrowhead | null;
     endArrowhead: Arrowhead | null;
 }>;
+export declare type ExcalidrawFreeDrawElement = _ExcalidrawElementBase & Readonly<{
+    type: "freedraw";
+    points: readonly Point[];
+    pressures: readonly number[];
+    simulatePressure: boolean;
+    lastCommittedPoint: Point | null;
+}>;
+export declare type FileId = string & {
+    _brand: "FileId";
+};
 export {};

package/types/errors.d.ts

@@ -2,4 +2,7 @@ declare type CANVAS_ERROR_NAMES = "CANVAS_ERROR" | "CANVAS_POSSIBLY_TOO_BIG";
 export declare class CanvasError extends Error {
     constructor(message?: string, name?: CANVAS_ERROR_NAMES);
 }
+export declare class AbortError extends DOMException {
+    constructor(message?: string);
+}
 export {};

package/types/groups.d.ts

@@ -24,3 +24,4 @@ export declare const addToGroup: (prevGroupIds: ExcalidrawElement["groupIds"], n
 export declare const removeFromSelectedGroups: (groupIds: ExcalidrawElement["groupIds"], selectedGroupIds: {
     [groupId: string]: boolean;
 }) => string[];
+export declare const getMaximumGroups: (elements: ExcalidrawElement[]) => ExcalidrawElement[][];

package/types/history.d.ts

@@ -8,6 +8,9 @@ declare const clearAppStatePropertiesForHistory: (appState: AppState) => {
     selectedElementIds: {
         [id: string]: boolean;
     };
+    selectedGroupIds: {
+        [groupId: string]: boolean;
+    };
     viewBackgroundColor: string;
     editingLinearElement: import("./element/linearElementEditor").LinearElementEditor | null;
     editingGroupId: string | null;

package/types/i18n.d.ts

@@ -11,5 +11,5 @@ export declare const languages: Language[];
 export declare const setLanguage: (lang: Language) => Promise<void>;
 export declare const getLanguage: () => Language;
 export declare const t: (path: string, replacement?: {
-    [key: string]: string;
+    [key: string]: string | number;
 } | undefined) => string;

package/types/keys.d.ts

@@ -1,5 +1,6 @@
 export declare const isDarwin: boolean;
 export declare const isWindows: boolean;
+export declare const isAndroid: boolean;
 export declare const CODES: {
     readonly EQUAL: "Equal";
     readonly MINUS: "Minus";
@@ -13,7 +14,9 @@ export declare const CODES: {
     readonly NINE: "Digit9";
     readonly QUOTE: "Quote";
     readonly ZERO: "Digit0";
+    readonly SLASH: "Slash";
     readonly C: "KeyC";
+    readonly D: "KeyD";
     readonly G: "KeyG";
     readonly F: "KeyF";
     readonly H: "KeyH";
@@ -36,9 +39,15 @@ export declare const KEYS: {
     readonly QUESTION_MARK: "?";
     readonly SPACE: " ";
     readonly TAB: "Tab";
+    readonly CHEVRON_LEFT: "<";
+    readonly CHEVRON_RIGHT: ">";
+    readonly PERIOD: ".";
+    readonly COMMA: ",";
     readonly A: "a";
     readonly D: "d";
     readonly E: "e";
+    readonly G: "g";
+    readonly I: "i";
     readonly L: "l";
     readonly O: "o";
     readonly P: "p";
@@ -50,9 +59,10 @@ export declare const KEYS: {
     readonly X: "x";
     readonly Y: "y";
     readonly Z: "z";
+    readonly K: "k";
 };
 export declare type Key = keyof typeof KEYS;
 export declare const isArrowKey: (key: string) => boolean;
-export declare const getResizeCenterPointKey: (event: MouseEvent | KeyboardEvent) => boolean;
-export declare const getResizeWithSidesSameLengthKey: (event: MouseEvent | KeyboardEvent) => boolean;
-export declare const getRotateWithDiscreteAngleKey: (event: MouseEvent | KeyboardEvent) => boolean;
+export declare const shouldResizeFromCenter: (event: MouseEvent | KeyboardEvent) => boolean;
+export declare const shouldMaintainAspectRatio: (event: MouseEvent | KeyboardEvent) => boolean;
+export declare const shouldRotateWithDiscreteAngle: (event: MouseEvent | KeyboardEvent) => boolean;

package/types/packages/excalidraw/dist/bundle.d.ts

@@ -0,0 +1,2 @@
+export = __WEBPACK_EXTERNAL_MODULE_react_dom__;
+export = __WEBPACK_EXTERNAL_MODULE_react_dom__;