@excalidraw/math 0.18.0-2b0e4c9 → 0.18.0-2b1c2a9

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

@@ -1,30 +1,438 @@
-import type { ExcalidrawElement, NonDeletedExcalidrawElement } from "@excalidraw/element/types";
+import type { NonDeletedExcalidrawElement } from "@excalidraw/element/types";
 import type { Scene } from "@excalidraw/element";
 import type { RenderableElementsMap } from "./types";
 import type { AppState } from "../types";
+type GetRenderableElementsOpts = {
+    zoom: AppState["zoom"];
+    offsetLeft: AppState["offsetLeft"];
+    offsetTop: AppState["offsetTop"];
+    scrollX: AppState["scrollX"];
+    scrollY: AppState["scrollY"];
+    height: AppState["height"];
+    width: AppState["width"];
+    editingTextElement: AppState["editingTextElement"];
+    newElement: AppState["newElement"];
+    selectedElements: readonly NonDeletedExcalidrawElement[];
+    selectedElementsAreBeingDragged: AppState["selectedElementsAreBeingDragged"];
+    frameToHighlight: AppState["frameToHighlight"];
+};
 export declare class Renderer {
     private scene;
     constructor(scene: Scene);
-    getRenderableElements: ((opts: {
-        zoom: Readonly<{
-            value: import("../types").NormalizedZoomValue;
-        }>;
-        offsetLeft: AppState["offsetLeft"];
-        offsetTop: AppState["offsetTop"];
-        scrollX: AppState["scrollX"];
-        scrollY: AppState["scrollY"];
-        height: AppState["height"];
-        width: AppState["width"];
-        editingTextElement: AppState["editingTextElement"];
-        /** note: first render of newElement will always bust the cache
-         * (we'd have to prefilter elements outside of this function) */
-        newElementId: ExcalidrawElement["id"] | undefined;
-        sceneNonce: ReturnType<InstanceType<typeof Scene>["getSceneNonce"]>;
-    }) => {
+    private getVisibleCanvasElements;
+    private getRenderableElementsMap;
+    private sortSelectedElementsIntoHighlightedFrame;
+    private _getRenderableElements;
+    getRenderableElements: (opts: GetRenderableElementsOpts) => {
         elementsMap: RenderableElementsMap;
         visibleElements: readonly NonDeletedExcalidrawElement[];
-    }) & {
-        clear: () => void;
+        newElementCanvasElement: (Readonly<{
+            id: string;
+            x: number;
+            y: number;
+            strokeColor: string;
+            backgroundColor: string;
+            fillStyle: import("@excalidraw/element/types").FillStyle;
+            strokeWidth: number;
+            strokeStyle: import("@excalidraw/element/types").StrokeStyle;
+            roundness: null | {
+                type: import("@excalidraw/element/types").RoundnessType;
+                value?: number;
+            };
+            roughness: number;
+            opacity: number;
+            width: number;
+            height: number;
+            angle: import("@excalidraw/math").Radians;
+            seed: number;
+            version: number;
+            versionNonce: number;
+            index: import("@excalidraw/element/types").FractionalIndex | null;
+            isDeleted: boolean;
+            groupIds: readonly import("@excalidraw/element/types").GroupId[];
+            frameId: string | null;
+            boundElements: readonly import("@excalidraw/element/types").BoundElement[] | null;
+            updated: number;
+            link: string | null;
+            locked: boolean;
+            customData?: Record<string, any>;
+        }> & Readonly<{
+            type: "line" | "arrow";
+            points: readonly import("@excalidraw/math").LocalPoint[];
+            startBinding: import("@excalidraw/element/types").FixedPointBinding | null;
+            endBinding: import("@excalidraw/element/types").FixedPointBinding | null;
+            startArrowhead: import("@excalidraw/element/types").Arrowhead | null;
+            endArrowhead: import("@excalidraw/element/types").Arrowhead | null;
+        }> & {
+            isDeleted: false;
+        }) | (Readonly<{
+            id: string;
+            x: number;
+            y: number;
+            strokeColor: string;
+            backgroundColor: string;
+            fillStyle: import("@excalidraw/element/types").FillStyle;
+            strokeWidth: number;
+            strokeStyle: import("@excalidraw/element/types").StrokeStyle;
+            roundness: null | {
+                type: import("@excalidraw/element/types").RoundnessType;
+                value?: number;
+            };
+            roughness: number;
+            opacity: number;
+            width: number;
+            height: number;
+            angle: import("@excalidraw/math").Radians;
+            seed: number;
+            version: number;
+            versionNonce: number;
+            index: import("@excalidraw/element/types").FractionalIndex | null;
+            isDeleted: boolean;
+            groupIds: readonly import("@excalidraw/element/types").GroupId[];
+            frameId: string | null;
+            boundElements: readonly import("@excalidraw/element/types").BoundElement[] | null;
+            updated: number;
+            link: string | null;
+            locked: boolean;
+            customData?: Record<string, any>;
+        }> & {
+            type: "rectangle";
+        } & {
+            isDeleted: false;
+        }) | (Readonly<{
+            id: string;
+            x: number;
+            y: number;
+            strokeColor: string;
+            backgroundColor: string;
+            fillStyle: import("@excalidraw/element/types").FillStyle;
+            strokeWidth: number;
+            strokeStyle: import("@excalidraw/element/types").StrokeStyle;
+            roundness: null | {
+                type: import("@excalidraw/element/types").RoundnessType;
+                value?: number;
+            };
+            roughness: number;
+            opacity: number;
+            width: number;
+            height: number;
+            angle: import("@excalidraw/math").Radians;
+            seed: number;
+            version: number;
+            versionNonce: number;
+            index: import("@excalidraw/element/types").FractionalIndex | null;
+            isDeleted: boolean;
+            groupIds: readonly import("@excalidraw/element/types").GroupId[];
+            frameId: string | null;
+            boundElements: readonly import("@excalidraw/element/types").BoundElement[] | null;
+            updated: number;
+            link: string | null;
+            locked: boolean;
+            customData?: Record<string, any>;
+        }> & {
+            type: "diamond";
+        } & {
+            isDeleted: false;
+        }) | (Readonly<{
+            id: string;
+            x: number;
+            y: number;
+            strokeColor: string;
+            backgroundColor: string;
+            fillStyle: import("@excalidraw/element/types").FillStyle;
+            strokeWidth: number;
+            strokeStyle: import("@excalidraw/element/types").StrokeStyle;
+            roundness: null | {
+                type: import("@excalidraw/element/types").RoundnessType;
+                value?: number;
+            };
+            roughness: number;
+            opacity: number;
+            width: number;
+            height: number;
+            angle: import("@excalidraw/math").Radians;
+            seed: number;
+            version: number;
+            versionNonce: number;
+            index: import("@excalidraw/element/types").FractionalIndex | null;
+            isDeleted: boolean;
+            groupIds: readonly import("@excalidraw/element/types").GroupId[];
+            frameId: string | null;
+            boundElements: readonly import("@excalidraw/element/types").BoundElement[] | null;
+            updated: number;
+            link: string | null;
+            locked: boolean;
+            customData?: Record<string, any>;
+        }> & {
+            type: "ellipse";
+        } & {
+            isDeleted: false;
+        }) | (Readonly<{
+            id: string;
+            x: number;
+            y: number;
+            strokeColor: string;
+            backgroundColor: string;
+            fillStyle: import("@excalidraw/element/types").FillStyle;
+            strokeWidth: number;
+            strokeStyle: import("@excalidraw/element/types").StrokeStyle;
+            roundness: null | {
+                type: import("@excalidraw/element/types").RoundnessType;
+                value?: number;
+            };
+            roughness: number;
+            opacity: number;
+            width: number;
+            height: number;
+            angle: import("@excalidraw/math").Radians;
+            seed: number;
+            version: number;
+            versionNonce: number;
+            index: import("@excalidraw/element/types").FractionalIndex | null;
+            isDeleted: boolean;
+            groupIds: readonly import("@excalidraw/element/types").GroupId[];
+            frameId: string | null;
+            boundElements: readonly import("@excalidraw/element/types").BoundElement[] | null;
+            updated: number;
+            link: string | null;
+            locked: boolean;
+            customData?: Record<string, any>;
+        }> & Readonly<{
+            type: "embeddable";
+        }> & {
+            isDeleted: false;
+        }) | (Readonly<{
+            id: string;
+            x: number;
+            y: number;
+            strokeColor: string;
+            backgroundColor: string;
+            fillStyle: import("@excalidraw/element/types").FillStyle;
+            strokeWidth: number;
+            strokeStyle: import("@excalidraw/element/types").StrokeStyle;
+            roundness: null | {
+                type: import("@excalidraw/element/types").RoundnessType;
+                value?: number;
+            };
+            roughness: number;
+            opacity: number;
+            width: number;
+            height: number;
+            angle: import("@excalidraw/math").Radians;
+            seed: number;
+            version: number;
+            versionNonce: number;
+            index: import("@excalidraw/element/types").FractionalIndex | null;
+            isDeleted: boolean;
+            groupIds: readonly import("@excalidraw/element/types").GroupId[];
+            frameId: string | null;
+            boundElements: readonly import("@excalidraw/element/types").BoundElement[] | null;
+            updated: number;
+            link: string | null;
+            locked: boolean;
+            customData?: Record<string, any>;
+        }> & Readonly<{
+            type: "iframe";
+            customData?: {
+                generationData?: import("@excalidraw/element/types").MagicGenerationData;
+            };
+        }> & {
+            isDeleted: false;
+        }) | (Readonly<{
+            id: string;
+            x: number;
+            y: number;
+            strokeColor: string;
+            backgroundColor: string;
+            fillStyle: import("@excalidraw/element/types").FillStyle;
+            strokeWidth: number;
+            strokeStyle: import("@excalidraw/element/types").StrokeStyle;
+            roundness: null | {
+                type: import("@excalidraw/element/types").RoundnessType;
+                value?: number;
+            };
+            roughness: number;
+            opacity: number;
+            width: number;
+            height: number;
+            angle: import("@excalidraw/math").Radians;
+            seed: number;
+            version: number;
+            versionNonce: number;
+            index: import("@excalidraw/element/types").FractionalIndex | null;
+            isDeleted: boolean;
+            groupIds: readonly import("@excalidraw/element/types").GroupId[];
+            frameId: string | null;
+            boundElements: readonly import("@excalidraw/element/types").BoundElement[] | null;
+            updated: number;
+            link: string | null;
+            locked: boolean;
+            customData?: Record<string, any>;
+        }> & Readonly<{
+            type: "image";
+            fileId: import("@excalidraw/element/types").FileId | null;
+            status: "pending" | "saved" | "error";
+            scale: [number, number];
+            crop: import("@excalidraw/element/types").ImageCrop | null;
+        }> & {
+            isDeleted: false;
+        }) | (Readonly<{
+            id: string;
+            x: number;
+            y: number;
+            strokeColor: string;
+            backgroundColor: string;
+            fillStyle: import("@excalidraw/element/types").FillStyle;
+            strokeWidth: number;
+            strokeStyle: import("@excalidraw/element/types").StrokeStyle;
+            roundness: null | {
+                type: import("@excalidraw/element/types").RoundnessType;
+                value?: number;
+            };
+            roughness: number;
+            opacity: number;
+            width: number;
+            height: number;
+            angle: import("@excalidraw/math").Radians;
+            seed: number;
+            version: number;
+            versionNonce: number;
+            index: import("@excalidraw/element/types").FractionalIndex | null;
+            isDeleted: boolean;
+            groupIds: readonly import("@excalidraw/element/types").GroupId[];
+            frameId: string | null;
+            boundElements: readonly import("@excalidraw/element/types").BoundElement[] | null;
+            updated: number;
+            link: string | null;
+            locked: boolean;
+            customData?: Record<string, any>;
+        }> & {
+            type: "frame";
+            name: string | null;
+        } & {
+            isDeleted: false;
+        }) | (Readonly<{
+            id: string;
+            x: number;
+            y: number;
+            strokeColor: string;
+            backgroundColor: string;
+            fillStyle: import("@excalidraw/element/types").FillStyle;
+            strokeWidth: number;
+            strokeStyle: import("@excalidraw/element/types").StrokeStyle;
+            roundness: null | {
+                type: import("@excalidraw/element/types").RoundnessType;
+                value?: number;
+            };
+            roughness: number;
+            opacity: number;
+            width: number;
+            height: number;
+            angle: import("@excalidraw/math").Radians;
+            seed: number;
+            version: number;
+            versionNonce: number;
+            index: import("@excalidraw/element/types").FractionalIndex | null;
+            isDeleted: boolean;
+            groupIds: readonly import("@excalidraw/element/types").GroupId[];
+            frameId: string | null;
+            boundElements: readonly import("@excalidraw/element/types").BoundElement[] | null;
+            updated: number;
+            link: string | null;
+            locked: boolean;
+            customData?: Record<string, any>;
+        }> & {
+            type: "magicframe";
+            name: string | null;
+        } & {
+            isDeleted: false;
+        }) | (Readonly<{
+            id: string;
+            x: number;
+            y: number;
+            strokeColor: string;
+            backgroundColor: string;
+            fillStyle: import("@excalidraw/element/types").FillStyle;
+            strokeWidth: number;
+            strokeStyle: import("@excalidraw/element/types").StrokeStyle;
+            roundness: null | {
+                type: import("@excalidraw/element/types").RoundnessType;
+                value?: number;
+            };
+            roughness: number;
+            opacity: number;
+            width: number;
+            height: number;
+            angle: import("@excalidraw/math").Radians;
+            seed: number;
+            version: number;
+            versionNonce: number;
+            index: import("@excalidraw/element/types").FractionalIndex | null;
+            isDeleted: boolean;
+            groupIds: readonly import("@excalidraw/element/types").GroupId[];
+            frameId: string | null;
+            boundElements: readonly import("@excalidraw/element/types").BoundElement[] | null;
+            updated: number;
+            link: string | null;
+            locked: boolean;
+            customData?: Record<string, any>;
+        }> & Readonly<{
+            type: "text";
+            fontSize: number;
+            fontFamily: import("@excalidraw/element/types").FontFamilyValues;
+            text: string;
+            textAlign: import("@excalidraw/element/types").TextAlign;
+            verticalAlign: import("@excalidraw/element/types").VerticalAlign;
+            containerId: import("@excalidraw/element/types").ExcalidrawGenericElement["id"] | null;
+            originalText: string;
+            autoResize: boolean;
+            lineHeight: number & {
+                _brand: "unitlessLineHeight";
+            };
+            labelPosition?: number | null;
+        }> & {
+            isDeleted: false;
+        }) | (Readonly<{
+            id: string;
+            x: number;
+            y: number;
+            strokeColor: string;
+            backgroundColor: string;
+            fillStyle: import("@excalidraw/element/types").FillStyle;
+            strokeWidth: number;
+            strokeStyle: import("@excalidraw/element/types").StrokeStyle;
+            roundness: null | {
+                type: import("@excalidraw/element/types").RoundnessType;
+                value?: number;
+            };
+            roughness: number;
+            opacity: number;
+            width: number;
+            height: number;
+            angle: import("@excalidraw/math").Radians;
+            seed: number;
+            version: number;
+            versionNonce: number;
+            index: import("@excalidraw/element/types").FractionalIndex | null;
+            isDeleted: boolean;
+            groupIds: readonly import("@excalidraw/element/types").GroupId[];
+            frameId: string | null;
+            boundElements: readonly import("@excalidraw/element/types").BoundElement[] | null;
+            updated: number;
+            link: string | null;
+            locked: boolean;
+            customData?: Record<string, any>;
+        }> & Readonly<{
+            type: "freedraw";
+            points: readonly import("@excalidraw/math").LocalPoint[];
+            pressures: readonly number[];
+            simulatePressure: boolean;
+            strokeOptions: import("@excalidraw/element/types").StrokeOptions;
+        }> & {
+            isDeleted: false;
+        }) | null;
+        canvasNonce: string;
     };
     destroy(): void;
 }
+export {};

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

@@ -1,10 +1,10 @@
-import type { ExcalidrawFrameLikeElement, NonDeletedExcalidrawElement } from "@excalidraw/element/types";
+import type { ExcalidrawFrameLikeElement, NonDeleted, NonDeletedExcalidrawElement } from "@excalidraw/element/types";
 import type { AppState, BinaryFiles } from "../types";
 export declare const exportToCanvas: (elements: readonly NonDeletedExcalidrawElement[], appState: AppState, files: BinaryFiles, { exportBackground, exportPadding, viewBackgroundColor, exportingFrame, }: {
     exportBackground: boolean;
     exportPadding?: number;
     viewBackgroundColor: string;
-    exportingFrame?: ExcalidrawFrameLikeElement | null;
+    exportingFrame?: NonDeleted<ExcalidrawFrameLikeElement> | null;
 }, createCanvas?: (width: number, height: number) => {
     canvas: HTMLCanvasElement;
     scale: number;
@@ -22,7 +22,7 @@ export declare const exportToSvg: (elements: readonly NonDeletedExcalidrawElemen
      * if true, all embeddables passed in will be rendered when possible.
      */
     renderEmbeddables?: boolean;
-    exportingFrame?: ExcalidrawFrameLikeElement | null;
+    exportingFrame?: NonDeleted<ExcalidrawFrameLikeElement> | null;
     skipInliningFonts?: true;
     reuseImages?: boolean;
 }) => Promise<SVGSVGElement>;

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

@@ -1,4 +1,4 @@
 export { isSomeElementSelected, getElementsWithinSelection, getSelectedElements, getTargetElements, } from "@excalidraw/element";
-export { calculateScrollCenter } from "./scroll";
-export { hasBackground, hasStrokeWidth, hasStrokeStyle, canHaveArrowheads, canChangeRoundness, } from "@excalidraw/element";
+export { getScrollToContentState } from "../viewport";
+export { hasBackground, hasStrokeWidth, hasStrokeStyle, hasFreedrawMode, canHaveArrowheads, canChangeRoundness, } from "@excalidraw/element";
 export { getNormalizedZoom, getNormalizedGridSize, getNormalizedGridStep, } from "./normalize";

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

@@ -9,6 +9,9 @@ export type StaticCanvasRenderConfig = {
     canvasBackgroundColor: AppState["viewBackgroundColor"];
     imageCache: AppClassProperties["imageCache"];
     renderGrid: boolean;
+    /** whether to render link icons on elements with links (never rendered
+     when exporting). @default true */
+    renderLinks?: boolean;
     /** when exporting the behavior is slightly different (e.g. we can't use
      CSS filters), and we disable render optimizations for best output */
     isExporting: boolean;
@@ -52,8 +55,6 @@ export type InteractiveCanvasRenderConfig = {
     renderScrollbars?: boolean;
 };
 export type RenderInteractiveSceneCallback = {
-    atLeastOneVisibleElement: boolean;
-    elementsMap: RenderableElementsMap;
     scrollBars?: ScrollBars;
 };
 export type StaticSceneRenderConfig = {
@@ -89,7 +90,7 @@ export type InteractiveSceneRenderConfig = {
 export type NewElementSceneRenderConfig = {
     canvas: HTMLCanvasElement | null;
     rc: RoughCanvas;
-    newElement: ExcalidrawElement | null;
+    newElement: NonDeletedExcalidrawElement | null;
     elementsMap: RenderableElementsMap;
     allElementsMap: NonDeletedSceneElementsMap;
     scale: number;

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

@@ -66,19 +66,19 @@ export declare const isGridModeEnabled: (app: AppClassProperties) => boolean;
 export declare const isSnappingEnabled: ({ event, app, selectedElements, }: {
     app: AppClassProperties;
     event: KeyboardModifiersObject;
-    selectedElements: NonDeletedExcalidrawElement[];
+    selectedElements: readonly NonDeletedExcalidrawElement[];
 }) => boolean;
 export declare const areRoughlyEqual: (a: number, b: number, precision?: number) => boolean;
-export declare const getElementsCorners: (elements: ExcalidrawElement[], elementsMap: ElementsMap, { omitCenter, boundingBoxCorners, dragOffset, }?: {
+export declare const getElementsCorners: (elements: readonly NonDeletedExcalidrawElement[], elementsMap: ElementsMap, { omitCenter, boundingBoxCorners, dragOffset, }?: {
     omitCenter?: boolean;
     boundingBoxCorners?: boolean;
     dragOffset?: Vector2D;
 }) => GlobalPoint[];
-export declare const getVisibleGaps: (elements: readonly NonDeletedExcalidrawElement[], selectedElements: ExcalidrawElement[], appState: AppState, elementsMap: ElementsMap) => {
+export declare const getVisibleGaps: (elements: readonly NonDeletedExcalidrawElement[], selectedElements: readonly NonDeletedExcalidrawElement[], appState: AppState, elementsMap: ElementsMap) => {
     horizontalGaps: Gap[];
     verticalGaps: Gap[];
 };
-export declare const getReferenceSnapPoints: (elements: readonly NonDeletedExcalidrawElement[], selectedElements: ExcalidrawElement[], appState: AppState, elementsMap: ElementsMap) => GlobalPoint[];
+export declare const getReferenceSnapPoints: (elements: readonly NonDeletedExcalidrawElement[], selectedElements: readonly NonDeletedExcalidrawElement[], appState: AppState, elementsMap: ElementsMap) => GlobalPoint[];
 export declare const snapDraggedElements: (elements: ExcalidrawElement[], dragOffset: Vector2D, app: AppClassProperties, event: KeyboardModifiersObject, elementsMap: ElementsMap) => {
     snapOffset: {
         x: number;
@@ -86,21 +86,21 @@ export declare const snapDraggedElements: (elements: ExcalidrawElement[], dragOf
     };
     snapLines: (PointSnapLine | GapSnapLine)[];
 };
-export declare const snapResizingElements: (selectedElements: ExcalidrawElement[], selectedOriginalElements: ExcalidrawElement[], app: AppClassProperties, event: KeyboardModifiersObject, dragOffset: Vector2D, transformHandle: MaybeTransformHandleType) => {
+export declare const snapResizingElements: (selectedElements: readonly NonDeletedExcalidrawElement[], selectedOriginalElements: readonly NonDeletedExcalidrawElement[], app: AppClassProperties, event: KeyboardModifiersObject, dragOffset: Vector2D, transformHandle: MaybeTransformHandleType) => {
     snapOffset: {
         x: number;
         y: number;
     };
     snapLines: PointSnapLine[];
 };
-export declare const snapNewElement: (newElement: ExcalidrawElement, app: AppClassProperties, event: KeyboardModifiersObject, origin: Vector2D, dragOffset: Vector2D, elementsMap: ElementsMap) => {
+export declare const snapNewElement: (newElement: NonDeletedExcalidrawElement, app: AppClassProperties, event: KeyboardModifiersObject, origin: Vector2D, dragOffset: Vector2D, elementsMap: ElementsMap) => {
     snapOffset: {
         x: number;
         y: number;
     };
     snapLines: PointSnapLine[];
 };
-export declare const getSnapLinesAtPointer: (elements: readonly ExcalidrawElement[], app: AppClassProperties, pointer: Vector2D, event: KeyboardModifiersObject, elementsMap: ElementsMap) => {
+export declare const getSnapLinesAtPointer: (elements: readonly NonDeletedExcalidrawElement[], app: AppClassProperties, pointer: Vector2D, event: KeyboardModifiersObject, elementsMap: ElementsMap) => {
     originOffset: {
         x: number;
         y: number;

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

@@ -0,0 +1,15 @@
+import { type GlobalPoint } from "@excalidraw/math";
+import type { EditorInterface } from "@excalidraw/common";
+import type { ExcalidrawTextElement } from "@excalidraw/element/types";
+export declare const getTextBoxPadding: (zoomValue: number) => number;
+export declare const getTextAutoResizeHandle: (textElement: ExcalidrawTextElement, zoomValue: number, formFactor: EditorInterface["formFactor"]) => {
+    center: GlobalPoint | import("@excalidraw/math").LocalPoint;
+    start: GlobalPoint;
+    end: GlobalPoint;
+    hitboxWidth: number;
+    hitboxHeight: number;
+} | null;
+export declare const isPointHittingTextAutoResizeHandle: (point: Readonly<{
+    x: number;
+    y: number;
+}>, textElement: ExcalidrawTextElement, zoomValue: number, formFactor: EditorInterface["formFactor"]) => boolean;