@excalidraw/element 0.18.0-9ba0f5d → 0.18.0-a52cd20

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

@@ -15,7 +15,8 @@ export declare class Fonts {
         fontFaces: ExcalidrawFontFace[];
     }>;
     private readonly scene;
-    constructor(scene: Scene);
+    private readonly ownerDocument;
+    constructor(scene: Scene, ownerDocument?: Document);
     /**
      * Get all the font families for the given scene.
      */
@@ -36,7 +37,7 @@ export declare class Fonts {
     /**
      * Load font faces for passed elements - use when the scene is unavailable (i.e. export).
      */
-    static loadElementsFonts: (elements: readonly ExcalidrawElement[]) => Promise<FontFace[]>;
+    static loadElementsFonts: (elements: readonly ExcalidrawElement[], ownerDocument?: Document) => Promise<FontFace[]>;
     /**
      * Generate CSS @font-face declarations for the given elements.
      */

package/dist/types/excalidraw/hooks/useAppStateValue.d.ts

@@ -0,0 +1,29 @@
+import type { AppState } from "../types";
+/**
+ * Subscribes to specific appState changes. The component re-renders
+ * only when the specified prop(s) change — not on every appState update.
+ *
+ * Works both inside and outside the <Excalidraw> tree, as long as
+ * ExcalidrawAPIContext.Provider is an ancestor (automatically provided
+ * inside <Excalidraw>, or manually by the host app).
+ *
+ * Returns the narrowed value depending on prop form:
+ *  - `keyof AppState` → `AppState[K]`
+ *  - `(keyof AppState)[]` → whole `AppState`
+ *  - selector function → selector's return type `T`
+ *
+ * If excalidrawAPI is not ready yet (host apps), hook is rerendered with latest
+ * value once available.
+ */
+export declare function useAppStateValue<K extends keyof AppState>(prop: K, _internal?: boolean): AppState[K];
+export declare function useAppStateValue(props: (keyof AppState)[], _internal?: boolean): AppState;
+export declare function useAppStateValue<T>(selector: (appState: AppState) => T, _internal?: boolean): T;
+/**
+ * Subscribes to specific appState changes without causing component rerenders.
+ *
+ * The callback is called on every matching change, but also on initial render
+ * so you can initialize your state.
+ */
+export declare function useOnAppStateChange<K extends keyof AppState>(prop: K, callback: (value: AppState[K], appState: AppState) => void): undefined;
+export declare function useOnAppStateChange(props: (keyof AppState)[], callback: (props: AppState, appState: AppState) => void): undefined;
+export declare function useOnAppStateChange<T>(selector: (appState: AppState) => T, callback: (value: T, appState: AppState) => void): undefined;

package/dist/types/excalidraw/hooks/useLibraryItemSvg.d.ts

@@ -1,6 +1,6 @@
 import type { LibraryItem } from "../types";
 export type SvgCache = Map<LibraryItem["id"], SVGSVGElement>;
-export declare const libraryItemSvgsCache: import("jotai/vanilla/atom").PrimitiveAtom<SvgCache> & {
+export declare const libraryItemSvgsCache: import("jotai").PrimitiveAtom<SvgCache> & {
     init: SvgCache;
 };
 export declare const useLibraryItemSvg: (id: LibraryItem["id"] | null, elements: LibraryItem["elements"] | undefined, svgCache: SvgCache, ref: React.RefObject<HTMLDivElement | null>) => SVGSVGElement | undefined;

package/dist/types/excalidraw/hooks/useTextEditorFocus.d.ts

@@ -2,13 +2,13 @@ export type CaretPosition = {
     start: number;
     end: number;
 };
-export declare const saveCaretPosition: () => CaretPosition | null;
-export declare const restoreCaretPosition: (position: CaretPosition | null) => void;
-export declare const withCaretPositionPreservation: (callback: () => void, isCompactMode: boolean, isEditingText: boolean, onPreventClose?: () => void) => void;
-export declare const useTextEditorFocus: () => {
+export declare const saveCaretPosition: (ownerDocument?: Document) => CaretPosition | null;
+export declare const restoreCaretPosition: (position: CaretPosition | null, ownerDocument?: Document) => void;
+export declare const withCaretPositionPreservation: (callback: () => void, isCompactMode: boolean, isEditingText: boolean, onPreventClose?: () => void, ownerDocument?: Document) => void;
+export declare const useTextEditorFocus: (ownerDocument?: Document) => {
     saveCaretPosition: () => void;
     restoreCaretPosition: () => void;
     clearSavedPosition: () => void;
     hasSavedPosition: boolean;
 };
-export declare const temporarilyDisableTextEditorBlur: (duration?: number) => void;
+export declare const temporarilyDisableTextEditorBlur: (ownerDocument?: Document, duration?: number) => void;

package/dist/types/excalidraw/{laser-trails.d.ts → laserTrails.d.ts}

@@ -1,20 +1,18 @@
-import { AnimatedTrail } from "./animated-trail";
-import type { Trail } from "./animated-trail";
-import type { AnimationFrameHandler } from "./animation-frame-handler";
+import { AnimatedTrail } from "./animatedTrail";
+import type { Trail } from "./animatedTrail";
 import type App from "./components/App";
 export declare class LaserTrails implements Trail {
-    private animationFrameHandler;
     private app;
     localTrail: AnimatedTrail;
     private collabTrails;
     private container?;
-    constructor(animationFrameHandler: AnimationFrameHandler, app: App);
+    constructor(app: App);
     private getTrailOptions;
     startPath(x: number, y: number): void;
     addPointToPath(x: number, y: number): void;
     endPath(): void;
     start(container: SVGSVGElement): void;
     stop(): void;
-    onFrame(): void;
-    private updateCollabTrails;
+    private stopCollabTrails;
+    updateCollabTrails(collaborators: App["state"]["collaborators"]): void;
 }

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

@@ -1,5 +1,4 @@
-import { type AnimationFrameHandler } from "../animation-frame-handler";
-import { AnimatedTrail } from "../animated-trail";
+import { AnimatedTrail } from "../animatedTrail";
 import type App from "../components/App";
 export declare class LassoTrail extends AnimatedTrail {
     private intersectedElements;
@@ -7,7 +6,7 @@ export declare class LassoTrail extends AnimatedTrail {
     private elementsSegments;
     private canvasTranslate;
     private keepPreviousSelection;
-    constructor(animationFrameHandler: AnimationFrameHandler, app: App);
+    constructor(app: App);
     startPath(x: number, y: number, keepPreviousSelection?: boolean): void;
     selectElementsFromIds: (ids: string[]) => void;
     addPointToPath: (x: number, y: number, keepPreviousSelection?: boolean) => void;

package/dist/types/excalidraw/lasso/utils.d.ts

@@ -1,5 +1,6 @@
 import type { ElementsSegmentsMap, GlobalPoint } from "@excalidraw/math/types";
 import type { ElementsMap, ExcalidrawElement } from "@excalidraw/element/types";
+import type { BoxSelectionMode } from "../types";
 export declare const getLassoSelectedElementIds: (input: {
     lassoPath: GlobalPoint[];
     elements: readonly ExcalidrawElement[];
@@ -8,6 +9,7 @@ export declare const getLassoSelectedElementIds: (input: {
     intersectedElements: Set<ExcalidrawElement["id"]>;
     enclosedElements: Set<ExcalidrawElement["id"]>;
     simplifyDistance?: number;
+    mode?: BoxSelectionMode;
 }) => {
     selectedElementIds: string[];
 };

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

@@ -0,0 +1,9 @@
+import type { ElementRenderOffsets, ElementRenderOverrides } from "./types";
+/** Validate and copy before publishing, so a rejected snapshot changes nothing. */
+export declare const copyElementRenderOverrides: (overrides: ElementRenderOverrides | null) => ElementRenderOverrides;
+/**
+ * Extracts the offsets of a snapshot, returning `previous` when they are the
+ * same. Visibility is memoized on this map's identity, so a snapshot that only
+ * changes opacities (a fade) never re-runs viewport geometry.
+ */
+export declare const getElementRenderOffsets: (overrides: ElementRenderOverrides, previous: ElementRenderOffsets) => ElementRenderOffsets;

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

@@ -3,10 +3,14 @@ export type Animation<R extends object> = (params: {
     state?: R;
 }) => R | null | undefined;
 export declare class AnimationController {
-    private static isRunning;
+    private static scheduledFrame;
     private static animations;
     static start<R extends object>(key: string, animation: Animation<R>): void;
+    private static scheduleNextFrame;
+    private static cancelScheduledFrame;
+    private static cancelScheduledFrameIfIdle;
     private static tick;
     static running(key: string): boolean;
     static cancel(key: string): void;
+    static reset(): void;
 }

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

@@ -1,6 +1,31 @@
 import type { StaticCanvasRenderConfig } from "../scene/types";
 import type { AppState, StaticCanvasAppState } from "../types";
+export declare const DEFAULT_SELECTION_COLOR = "#6965db";
+/**
+ * Returns the theme's selection color (`--color-selection`), read from the
+ * computed style of any element inside the editor container so that host
+ * overrides are respected. Falls back to the default when unavailable.
+ */
+export declare const getSelectionColor: (element: Element | null | undefined) => string;
 export declare const fillCircle: (context: CanvasRenderingContext2D, cx: number, cy: number, radius: number, stroke: boolean, fill?: boolean) => void;
+/**
+ * The scroll the renderers draw at: the real one, rounded to whole device
+ * pixels. Panning writes a fractional scroll (pointer delta ÷ zoom), and an
+ * element's cached bitmap blitted at a fractional device offset gets
+ * resampled — so as the fraction drifts under a pan, every element pulses
+ * between crisp and soft. A whole-pixel scroll moves the scene the way a
+ * browser scrolls a page: each element keeps its own, constant sub-pixel
+ * phase and a pan never changes how anything is filtered. The difference
+ * stays under half a device pixel, so hit-testing and DOM overlays keep
+ * using the real scroll. Identity when nothing needs to change.
+ */
+export declare const snapScrollToDevicePixels: <T extends {
+    scrollX: number;
+    scrollY: number;
+    zoom: {
+        value: number;
+    };
+}>(appState: T, scale: number) => T;
 export declare const getNormalizedCanvasDimensions: (canvas: HTMLCanvasElement, scale: number) => [number, number];
 export declare const bootstrapCanvas: ({ canvas, scale, normalizedWidth, normalizedHeight, theme, isExporting, viewBackgroundColor, }: {
     canvas: HTMLCanvasElement;

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

@@ -1,9 +1,7 @@
 import { getScrollBars } from "../scene/scrollbars";
-import type { InteractiveSceneRenderConfig, RenderableElementsMap } from "../scene/types";
-declare const _renderInteractiveScene: ({ app, canvas, elementsMap, visibleElements, selectedElements, allElementsMap, scale, appState, renderConfig, editorInterface, animationState, deltaTime, }: InteractiveSceneRenderConfig) => {
+import type { InteractiveSceneRenderConfig } from "../scene/types";
+declare const _renderInteractiveScene: ({ app, canvas, elementsMap, visibleElements, selectedElements, allElementsMap, scale, appState: unsnappedAppState, renderConfig, editorInterface, animationState, deltaTime, }: InteractiveSceneRenderConfig) => {
     scrollBars?: ReturnType<typeof getScrollBars>;
-    atLeastOneVisibleElement: boolean;
-    elementsMap: RenderableElementsMap;
     animationState?: typeof animationState;
 };
 /**