@excalidraw/math 0.18.0-4ce38fb → 0.18.0-4ce8305

package/dist/types/excalidraw/components/TopPicksDnD/topPicksDnD.d.ts

@@ -17,7 +17,7 @@ export type TopPicksDragState<T> = {
     slotSpan: number;
 } | null;
 export type TopPicksGhost = {
-    /** the ghost's visual. Rendered into `document.body` — outside the
+    /** the ghost's visual. Rendered into the source's `document.body` — outside the
      * editor's CSS scope, so theme-dependent styling must be resolved from the
      * rendered DOM (computed styles) rather than CSS variables */
     content: HTMLElement;

package/dist/types/excalidraw/components/canvases/InteractiveCanvas.d.ts

@@ -31,6 +31,5 @@ type InteractiveCanvasProps = {
     onPointerDown: Exclude<DOMAttributes<HTMLCanvasElement>["onPointerDown"], undefined>;
     onDoubleClick: Exclude<DOMAttributes<HTMLCanvasElement>["onDoubleClick"], undefined>;
 };
-export declare const INTERACTIVE_SCENE_ANIMATION_KEY = "animateInteractiveScene";
 declare const _default: React.MemoExoticComponent<(props: InteractiveCanvasProps) => import("react/jsx-runtime").JSX.Element>;
 export default _default;

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

@@ -2,6 +2,7 @@ import type { Scene } from "@excalidraw/element";
 import type { ElementsMap, ExcalidrawEmbeddableElement, NonDeletedExcalidrawElement } from "@excalidraw/element/types";
 import "./Hyperlink.scss";
 import type { AppState, ExcalidrawProps, UIAppState } from "../../types";
+export type HyperlinkTooltipOwner = Record<string, unknown>;
 export declare const Hyperlink: ({ element, scene, setAppState, onLinkOpen, setToast, updateEmbedValidationStatus, }: {
     element: NonDeletedExcalidrawElement;
     scene: Scene;
@@ -15,5 +16,5 @@ export declare const Hyperlink: ({ element, scene, setAppState, onLinkOpen, setT
     updateEmbedValidationStatus: (element: ExcalidrawEmbeddableElement, status: boolean) => void;
 }) => import("react/jsx-runtime").JSX.Element | null;
 export declare const getContextMenuLabel: (elements: readonly NonDeletedExcalidrawElement[], appState: UIAppState) => "labels.link.editEmbed" | "labels.link.edit" | "labels.link.create";
-export declare const showHyperlinkTooltip: (element: NonDeletedExcalidrawElement, appState: AppState, elementsMap: ElementsMap) => void;
-export declare const hideHyperlinkToolip: () => void;
+export declare const showHyperlinkTooltip: (element: NonDeletedExcalidrawElement, appState: AppState, elementsMap: ElementsMap, ownerDocument: Document, owner: HyperlinkTooltipOwner) => void;
+export declare const hideHyperlinkToolip: (owner?: HyperlinkTooltipOwner) => void;

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

@@ -1,10 +1,21 @@
+import type { RenderEnvironment } from "@excalidraw/element/renderEnvironment";
 import type { GlobalPoint, Radians } from "@excalidraw/math";
 import type { Bounds } from "@excalidraw/common";
 import type { ElementsMap, NonDeletedExcalidrawElement } from "@excalidraw/element/types";
 import type { AppState } from "../../types";
 export declare const DEFAULT_LINK_SIZE = 12;
-export declare const EXTERNAL_LINK_IMG: HTMLImageElement;
-export declare const ELEMENT_LINK_IMG: HTMLImageElement;
+type SettledLinkImgStatus = Exclude<LinkImgStatus, "decoding">;
+export type LinkImgStatus = "decoding" | "decoded" | "failed";
+export type LinkImg = {
+    /** Only safe as a `drawImage` source while `status` is `decoded`. */
+    img: HTMLImageElement;
+    status: LinkImgStatus;
+    settled: Promise<SettledLinkImgStatus>;
+};
+export declare const getExternalLinkImg: (renderEnvironment: RenderEnvironment) => LinkImg;
+export declare const getElementLinkImg: (renderEnvironment: RenderEnvironment) => LinkImg;
+export declare const startLinkImgDecoding: (renderEnvironment: RenderEnvironment) => Promise<boolean>;
 export declare const getLinkHandleFromCoords: ([x1, y1, x2, y2]: Bounds, angle: Radians, appState: Pick<AppState, "zoom">) => Bounds;
 export declare const isPointHittingLinkIcon: (element: NonDeletedExcalidrawElement, elementsMap: ElementsMap, appState: AppState, [x, y]: GlobalPoint) => boolean;
 export declare const isPointHittingLink: (element: NonDeletedExcalidrawElement, elementsMap: ElementsMap, appState: AppState, [x, y]: GlobalPoint, isMobile: boolean) => boolean;
+export {};

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

@@ -30,6 +30,11 @@ fileHandle?: FileSystemFileHandle | null) => Promise<{
             };
             name: string | null;
             zoom: import("../types").Zoom;
+            isBindingEnabled: boolean;
+            isMidpointSnappingEnabled: boolean;
+            selectedElementIds: Readonly<{
+                [id: string]: true;
+            }>;
             scrollX: number;
             scrollY: number;
             viewModeEnabled: boolean;
@@ -51,9 +56,6 @@ fileHandle?: FileSystemFileHandle | null) => Promise<{
                 rawText: string;
             };
             editingGroupId: import("@excalidraw/element/types").GroupId | null;
-            selectedElementIds: Readonly<{
-                [id: string]: true;
-            }>;
             frameToHighlight: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawFrameLikeElement> | null;
             activeTool: {
                 lastActiveTool: import("../types").ActiveTool | null;
@@ -71,8 +73,6 @@ fileHandle?: FileSystemFileHandle | null) => Promise<{
             selectedLinearElement: import("@excalidraw/element").LinearElementEditor | null;
             multiElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawLinearElement> | null;
             newElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawNonSelectionElement> | null;
-            isBindingEnabled: boolean;
-            isMidpointSnappingEnabled: boolean;
             gridModeEnabled: boolean;
             suggestedBinding: {
                 element: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawBindableElement>;
@@ -108,8 +108,6 @@ fileHandle?: FileSystemFileHandle | null) => Promise<{
             shouldCacheIgnoreZoom: boolean;
             exportScale: number;
             currentItemArrowType: "sharp" | "round" | "elbow";
-            gridSize: number;
-            bindMode: import("@excalidraw/element/types").BindMode;
             contextMenu: {
                 items: import("../components/ContextMenu").ContextMenuItems;
                 top: number;
@@ -171,6 +169,7 @@ fileHandle?: FileSystemFileHandle | null) => Promise<{
                 closable?: boolean;
                 duration?: number;
             } | null;
+            gridSize: number;
             gridStep: number;
             fileHandle: FileSystemFileHandle | null;
             stats: {
@@ -186,6 +185,7 @@ fileHandle?: FileSystemFileHandle | null) => Promise<{
             lockedMultiSelections: {
                 [groupId: string]: true;
             };
+            bindMode: import("@excalidraw/element/types").BindMode;
             colorTopPicks: {
                 elementStroke: readonly string[] | null;
                 elementBackground: readonly string[] | null;
@@ -218,6 +218,11 @@ fileHandle?: FileSystemFileHandle | null) => Promise<{
         };
         name: string | null;
         zoom: import("../types").Zoom;
+        isBindingEnabled: boolean;
+        isMidpointSnappingEnabled: boolean;
+        selectedElementIds: Readonly<{
+            [id: string]: true;
+        }>;
         scrollX: number;
         scrollY: number;
         viewModeEnabled: boolean;
@@ -239,9 +244,6 @@ fileHandle?: FileSystemFileHandle | null) => Promise<{
             rawText: string;
         };
         editingGroupId: import("@excalidraw/element/types").GroupId | null;
-        selectedElementIds: Readonly<{
-            [id: string]: true;
-        }>;
         frameToHighlight: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawFrameLikeElement> | null;
         activeTool: {
             lastActiveTool: import("../types").ActiveTool | null;
@@ -259,8 +261,6 @@ fileHandle?: FileSystemFileHandle | null) => Promise<{
         selectedLinearElement: import("@excalidraw/element").LinearElementEditor | null;
         multiElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawLinearElement> | null;
         newElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawNonSelectionElement> | null;
-        isBindingEnabled: boolean;
-        isMidpointSnappingEnabled: boolean;
         gridModeEnabled: boolean;
         suggestedBinding: {
             element: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawBindableElement>;
@@ -296,8 +296,6 @@ fileHandle?: FileSystemFileHandle | null) => Promise<{
         shouldCacheIgnoreZoom: boolean;
         exportScale: number;
         currentItemArrowType: "sharp" | "round" | "elbow";
-        gridSize: number;
-        bindMode: import("@excalidraw/element/types").BindMode;
         contextMenu: {
             items: import("../components/ContextMenu").ContextMenuItems;
             top: number;
@@ -359,6 +357,7 @@ fileHandle?: FileSystemFileHandle | null) => Promise<{
             closable?: boolean;
             duration?: number;
         } | null;
+        gridSize: number;
         gridStep: number;
         fileHandle: FileSystemFileHandle | null;
         stats: {
@@ -374,6 +373,7 @@ fileHandle?: FileSystemFileHandle | null) => Promise<{
         lockedMultiSelections: {
             [groupId: string]: true;
         };
+        bindMode: import("@excalidraw/element/types").BindMode;
         colorTopPicks: {
             elementStroke: readonly string[] | null;
             elementBackground: readonly string[] | null;

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

@@ -1,4 +1,5 @@
 import type { ExcalidrawElement, ExcalidrawFrameLikeElement, NonDeleted, NonDeletedExcalidrawElement } from "@excalidraw/element/types";
+import type { RenderEnvironment } from "@excalidraw/element";
 import type { ExportType } from "../scene/types";
 import type { AppState, BinaryFiles } from "../types";
 export { loadFromBlob } from "./blob";
@@ -10,12 +11,11 @@ export declare const prepareElementsForExport: (allElements: readonly Excalidraw
     exportingFrame: NonDeleted<ExcalidrawFrameLikeElement> | null;
     exportedElements: ExportedElements;
 };
-export declare const exportCanvas: (type: Omit<ExportType, "backend">, elements: ExportedElements, appState: AppState, files: BinaryFiles, { exportBackground, exportPadding, viewBackgroundColor, name, fileHandle, exportingFrame, }: {
-    exportBackground: boolean;
+export declare const exportCanvas: (type: Omit<ExportType, "backend">, elements: ExportedElements, appState: AppState, files: BinaryFiles, { exportPadding, name, fileHandle, exportingFrame, renderEnvironment, }: {
     exportPadding?: number;
-    viewBackgroundColor: string;
     /** filename, if applicable */
     name?: string;
     fileHandle?: FileSystemFileHandle | null;
     exportingFrame: NonDeleted<ExcalidrawFrameLikeElement> | null;
+    renderEnvironment?: RenderEnvironment;
 }) => Promise<FileSystemFileHandle | null | undefined>;

package/dist/types/excalidraw/data/json.d.ts

@@ -28,6 +28,11 @@ export declare const loadFromJSON: (localAppState: AppState, localElements: read
         };
         name: string | null;
         zoom: import("../types").Zoom;
+        isBindingEnabled: boolean;
+        isMidpointSnappingEnabled: boolean;
+        selectedElementIds: Readonly<{
+            [id: string]: true;
+        }>;
         scrollX: number;
         scrollY: number;
         viewModeEnabled: boolean;
@@ -49,9 +54,6 @@ export declare const loadFromJSON: (localAppState: AppState, localElements: read
             rawText: string;
         };
         editingGroupId: import("@excalidraw/element/types").GroupId | null;
-        selectedElementIds: Readonly<{
-            [id: string]: true;
-        }>;
         frameToHighlight: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawFrameLikeElement> | null;
         activeTool: {
             lastActiveTool: import("../types").ActiveTool | null;
@@ -69,8 +71,6 @@ export declare const loadFromJSON: (localAppState: AppState, localElements: read
         selectedLinearElement: import("@excalidraw/element").LinearElementEditor | null;
         multiElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawLinearElement> | null;
         newElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawNonSelectionElement> | null;
-        isBindingEnabled: boolean;
-        isMidpointSnappingEnabled: boolean;
         gridModeEnabled: boolean;
         suggestedBinding: {
             element: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawBindableElement>;
@@ -106,8 +106,6 @@ export declare const loadFromJSON: (localAppState: AppState, localElements: read
         shouldCacheIgnoreZoom: boolean;
         exportScale: number;
         currentItemArrowType: "sharp" | "round" | "elbow";
-        gridSize: number;
-        bindMode: import("@excalidraw/element/types").BindMode;
         contextMenu: {
             items: import("../components/ContextMenu").ContextMenuItems;
             top: number;
@@ -169,6 +167,7 @@ export declare const loadFromJSON: (localAppState: AppState, localElements: read
             closable?: boolean;
             duration?: number;
         } | null;
+        gridSize: number;
         gridStep: number;
         fileHandle: FileSystemFileHandle | null;
         stats: {
@@ -184,6 +183,7 @@ export declare const loadFromJSON: (localAppState: AppState, localElements: read
         lockedMultiSelections: {
             [groupId: string]: true;
         };
+        bindMode: import("@excalidraw/element/types").BindMode;
         colorTopPicks: {
             elementStroke: readonly string[] | null;
             elementBackground: readonly string[] | null;

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

@@ -1,5 +1,5 @@
 import { type FontMetadata } from "@excalidraw/common";
-import type { ExcalidrawElement } from "@excalidraw/element/types";
+import type { ExcalidrawElement, ExcalidrawTextElement } from "@excalidraw/element/types";
 import type { Scene } from "@excalidraw/element";
 import { ExcalidrawFontFace } from "./ExcalidrawFontFace";
 export declare class Fonts {
@@ -16,6 +16,7 @@ export declare class Fonts {
     }>;
     private readonly scene;
     private readonly ownerDocument;
+    private readonly loadedFonts;
     constructor(scene: Scene, ownerDocument?: Document);
     /**
      * Get all the font families for the given scene.
@@ -33,9 +34,15 @@ export declare class Fonts {
     /**
      * Load font faces for a given scene and trigger scene update.
      */
-    loadSceneFonts: () => Promise<FontFace[]>;
+    loadSceneFonts: (defaultFontFamily?: ExcalidrawTextElement["fontFamily"]) => Promise<FontFace[]>;
     /**
      * Load font faces for passed elements - use when the scene is unavailable (i.e. export).
+     *
+     * Loads into the document's font set, or in a worker into the worker's own
+     * (`self.fonts`, what an `OffscreenCanvas` there measures with). Where there
+     * is neither -- e.g. a DOM shim without `FontFaceSet` (`linkedom`), or Node
+     * -- nothing is loaded: the host makes the fonts available itself, and is
+     * warned once if the elements use fonts that would need loading.
      */
     static loadElementsFonts: (elements: readonly ExcalidrawElement[], ownerDocument?: Document) => Promise<FontFace[]>;
     /**
@@ -69,10 +76,6 @@ export declare class Fonts {
      * Get characters for a given family.
      */
     private static getCharacters;
-    /**
-     * Get all registered font families.
-     */
-    private static getAllFamilies;
 }
 export interface ExcalidrawFontFaceDescriptor {
     uri: string;

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

@@ -1,13 +1,15 @@
 import { Emitter } from "@excalidraw/common";
 import { StoreDelta } from "@excalidraw/element";
-import type { StoreSnapshot, Store } from "@excalidraw/element";
+import type { RenderEnvironment, StoreSnapshot, Store } from "@excalidraw/element";
 import type { SceneElementsMap } from "@excalidraw/element/types";
 import type { AppState } from "./types";
 export declare class HistoryDelta extends StoreDelta {
     /**
      * Apply the delta to the passed elements and appState, does not modify the snapshot.
      */
-    applyTo(elements: SceneElementsMap, appState: AppState, snapshot: StoreSnapshot): [SceneElementsMap, AppState, boolean];
+    applyTo(elements: SceneElementsMap, appState: AppState, snapshot: StoreSnapshot, 
+    /** measures the labels re-laid out after applying */
+    renderEnvironment?: RenderEnvironment): [SceneElementsMap, AppState, boolean];
     /**
      * Overriding once to avoid type casting everywhere.
      */
@@ -40,8 +42,12 @@ export declare class History {
      * Do not re-record history entries, which were already pushed to undo / redo stack, as part of history action.
      */
     record(delta: StoreDelta): void;
-    undo(elements: SceneElementsMap, appState: AppState): void | [SceneElementsMap, AppState];
-    redo(elements: SceneElementsMap, appState: AppState): void | [SceneElementsMap, AppState];
+    undo(elements: SceneElementsMap, appState: AppState, 
+    /** measures the labels re-laid out after undoing (the host's, in the editor) */
+    renderEnvironment?: RenderEnvironment): void | [SceneElementsMap, AppState];
+    redo(elements: SceneElementsMap, appState: AppState, 
+    /** measures the labels re-laid out after redoing (the host's, in the editor) */
+    renderEnvironment?: RenderEnvironment): void | [SceneElementsMap, AppState];
     private perform;
     private static pop;
     private static push;

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

@@ -6,7 +6,7 @@ export declare const withBatchedUpdates: <TFunction extends ((event: any) => voi
  * barches React state updates and throttles the calls to a single call per
  * animation frame
  */
-export declare const withBatchedUpdatesThrottled: <TFunction extends ((event: any) => void) | (() => void)>(func: Parameters<TFunction>["length"] extends 0 | 1 ? TFunction : never) => {
+export declare const withBatchedUpdatesThrottled: <TFunction extends ((event: any) => void) | (() => void)>(func: Parameters<TFunction>["length"] extends 0 | 1 ? TFunction : never, ownerWindow?: Window) => {
     (...args: Parameters<TFunction>): void;
     flush(): void;
     cancel(): void;

package/dist/types/excalidraw/renderer/animation.d.ts

@@ -1,16 +1,23 @@
+/** String keys are shared process-wide; symbols are created per owning
+ * instance, which lets concurrent instances run the same named animation
+ * independently. */
+export type AnimationKey = string | symbol;
 export type Animation<R extends object> = (params: {
     deltaTime: number;
     state?: R;
 }) => R | null | undefined;
+export type AnimationScheduler = Pick<Window, "requestAnimationFrame" | "cancelAnimationFrame" | "setTimeout" | "clearTimeout">;
 export declare class AnimationController {
-    private static scheduledFrame;
+    private static scheduledFrames;
     private static animations;
-    static start<R extends object>(key: string, animation: Animation<R>): void;
+    private static readonly schedulerCleanups;
+    static start<R extends object>(key: AnimationKey, animation: Animation<R>, scheduler?: AnimationScheduler): void;
     private static scheduleNextFrame;
     private static cancelScheduledFrame;
     private static cancelScheduledFrameIfIdle;
+    private static registerSchedulerCleanup;
     private static tick;
-    static running(key: string): boolean;
-    static cancel(key: string): void;
+    static running(key: AnimationKey): boolean;
+    static cancel(key: AnimationKey): void;
     static reset(): void;
 }

package/dist/types/excalidraw/renderer/staticScene.d.ts

@@ -2,12 +2,17 @@ import type { ExcalidrawFrameLikeElement } from "@excalidraw/element/types";
 import type { StaticCanvasRenderConfig, StaticSceneRenderConfig } from "../scene/types";
 import type { StaticCanvasAppState } from "../types";
 export declare const frameClip: (frame: ExcalidrawFrameLikeElement, context: CanvasRenderingContext2D, renderConfig: StaticCanvasRenderConfig, appState: StaticCanvasAppState) => void;
-/** throttled to animation framerate */
-export declare const renderStaticSceneThrottled: {
-    (config: StaticSceneRenderConfig): void;
-    flush(): void;
-    cancel(): void;
-};
+/**
+ * Throttled to animation framerate, one throttle per canvas. A shared
+ * throttle drops all but the last caller's pending frame when multiple
+ * editors render in the same frame, and a module-realm scheduler would run
+ * popout renders on the main window's rAF, which freezes while that window
+ * is hidden.
+ */
+export declare const renderStaticSceneThrottled: (config: StaticSceneRenderConfig) => void;
+/** Drops the canvas' pending frame; the throttle itself is dropped with the
+ * canvas. */
+export declare const cancelStaticSceneThrottle: (canvas: HTMLCanvasElement) => void;
 /**
  * Static scene is the non-ui canvas where we render elements.
  */

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

@@ -494,6 +494,6 @@ export declare class Renderer {
         }) | null;
         canvasNonce: string;
     };
-    destroy(): void;
+    destroy(staticCanvas: HTMLCanvasElement): void;
 }
 export {};