@dwelle/excalidraw 0.3.16 → 0.3.20

package/types/renderer/renderElement.d.ts

@@ -2,12 +2,12 @@ import { ExcalidrawElement, ExcalidrawTextElement, NonDeletedExcalidrawElement,
 import { RoughCanvas } from "roughjs/bin/canvas";
 import { Drawable, Options } from "roughjs/bin/core";
 import { RoughSVG } from "roughjs/bin/svg";
-import { SceneState } from "../scene/types";
+import { RenderConfig } from "../scene/types";
 import { BinaryFiles, Zoom } from "../types";
 export interface ExcalidrawElementWithCanvas {
     element: ExcalidrawElement | ExcalidrawTextElement;
     canvas: HTMLCanvasElement;
-    theme: SceneState["theme"];
+    theme: RenderConfig["theme"];
     canvasZoom: Zoom["value"];
     canvasOffsetX: number;
     canvasOffsetY: number;
@@ -16,8 +16,8 @@ export declare const getShapeForElement: (element: ExcalidrawElement) => Drawabl
 export declare const invalidateShapeForElement: (element: ExcalidrawElement) => boolean;
 export declare const clearRenderCache: () => void;
 export declare const generateRoughOptions: (element: ExcalidrawElement, continuousPath?: boolean) => Options;
-export declare const renderElement: (element: NonDeletedExcalidrawElement, rc: RoughCanvas, context: CanvasRenderingContext2D, renderOptimizations: boolean, sceneState: SceneState) => void;
-export declare const renderElementToSvg: (element: NonDeletedExcalidrawElement, rsvg: RoughSVG, svgRoot: SVGElement, files: BinaryFiles, offsetX?: number | undefined, offsetY?: number | undefined) => void;
+export declare const renderElement: (element: NonDeletedExcalidrawElement, rc: RoughCanvas, context: CanvasRenderingContext2D, renderConfig: RenderConfig) => void;
+export declare const renderElementToSvg: (element: NonDeletedExcalidrawElement, rsvg: RoughSVG, svgRoot: SVGElement, files: BinaryFiles, offsetX?: number | undefined, offsetY?: number | undefined, exportWithDarkMode?: boolean | undefined) => void;
 export declare let pathsCache: WeakMap<ExcalidrawFreeDrawElement, Path2D>;
 export declare function generateFreeDrawShape(element: ExcalidrawFreeDrawElement): Path2D;
 export declare function getFreeDrawPath2D(element: ExcalidrawFreeDrawElement): Path2D | undefined;

package/types/renderer/renderScene.d.ts

@@ -2,21 +2,16 @@ import { RoughCanvas } from "roughjs/bin/canvas";
 import { RoughSVG } from "roughjs/bin/svg";
 import { AppState, BinaryFiles } from "../types";
 import { NonDeletedExcalidrawElement } from "../element/types";
-import { SceneState } from "../scene/types";
-export declare const renderScene: (elements: readonly NonDeletedExcalidrawElement[], appState: AppState, selectionElement: NonDeletedExcalidrawElement | null, scale: number, rc: RoughCanvas, canvas: HTMLCanvasElement, sceneState: SceneState, { renderScrollbars, renderSelection, renderOptimizations, renderGrid, isExport, }?: {
-    renderScrollbars?: boolean | undefined;
-    renderSelection?: boolean | undefined;
-    renderOptimizations?: boolean | undefined;
-    renderGrid?: boolean | undefined;
-    isExport?: boolean | undefined;
-}) => {
+import { RenderConfig } from "../scene/types";
+export declare const renderScene: (elements: readonly NonDeletedExcalidrawElement[], appState: AppState, selectionElement: NonDeletedExcalidrawElement | null, scale: number, rc: RoughCanvas, canvas: HTMLCanvasElement, renderConfig: RenderConfig) => {
     atLeastOneVisibleElement: boolean;
     scrollBars?: undefined;
 } | {
     atLeastOneVisibleElement: boolean;
     scrollBars: import("../scene/types").ScrollBars | undefined;
 };
-export declare const renderSceneToSvg: (elements: readonly NonDeletedExcalidrawElement[], rsvg: RoughSVG, svgRoot: SVGElement, files: BinaryFiles, { offsetX, offsetY, }?: {
+export declare const renderSceneToSvg: (elements: readonly NonDeletedExcalidrawElement[], rsvg: RoughSVG, svgRoot: SVGElement, files: BinaryFiles, { offsetX, offsetY, exportWithDarkMode, }?: {
     offsetX?: number | undefined;
     offsetY?: number | undefined;
+    exportWithDarkMode?: boolean | undefined;
 }) => void;

package/types/scene/types.d.ts

@@ -1,11 +1,13 @@
 import { ExcalidrawTextElement } from "../element/types";
-import { AppClassProperties, AppState, Zoom } from "../types";
-export declare type SceneState = {
-    scrollX: number;
-    scrollY: number;
-    viewBackgroundColor: string | null;
-    zoom: Zoom;
-    shouldCacheIgnoreZoom: boolean;
+import { AppClassProperties, AppState } from "../types";
+export declare type RenderConfig = {
+    scrollX: AppState["scrollX"];
+    scrollY: AppState["scrollY"];
+    /** null indicates transparent bg */
+    viewBackgroundColor: AppState["viewBackgroundColor"] | null;
+    zoom: AppState["zoom"];
+    shouldCacheIgnoreZoom: AppState["shouldCacheIgnoreZoom"];
+    theme: AppState["theme"];
     remotePointerViewportCoords: {
         [id: string]: {
             x: number;
@@ -24,8 +26,13 @@ export declare type SceneState = {
     remotePointerUserStates: {
         [id: string]: string;
     };
-    theme: AppState["theme"];
     imageCache: AppClassProperties["imageCache"];
+    renderScrollbars?: boolean;
+    renderSelection?: boolean;
+    renderGrid?: 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;
 };
 export declare type SceneScroll = {
     scrollX: number;

package/types/types.d.ts

@@ -152,7 +152,20 @@ export declare class GestureEvent extends UIEvent {
     readonly rotation: number;
     readonly scale: number;
 }
-export declare type LibraryItem = readonly NonDeleted<ExcalidrawElement>[];
+/** @deprecated legacy: do not use outside of migration paths */
+export declare type LibraryItem_v1 = readonly NonDeleted<ExcalidrawElement>[];
+/** @deprecated legacy: do not use outside of migration paths */
+export declare type LibraryItems_v1 = readonly LibraryItem_v1[];
+/** v2 library item */
+export declare type LibraryItem = {
+    id: string;
+    status: "published" | "unpublished";
+    elements: readonly NonDeleted<ExcalidrawElement>[];
+    /** timestamp in epoch (ms) */
+    created: number;
+    name?: string;
+    error?: string;
+};
 export declare type LibraryItems = readonly LibraryItem[];
 export declare type ExcalidrawAPIRefValue = ExcalidrawImperativeAPI | {
     readyPromise?: ResolvablePromise<ExcalidrawImperativeAPI>;

package/types/utils.d.ts

@@ -24,6 +24,7 @@ export declare const debounce: <T extends any[]>(fn: (...args: T) => void, timeo
     flush(): void;
     cancel(): void;
 };
+export declare const chunk: <T extends unknown>(array: readonly T[], size: number) => T[][];
 export declare const selectNode: (node: Element) => void;
 export declare const removeSelection: () => void;
 export declare const distance: (x: number, y: number) => number;
@@ -92,3 +93,12 @@ export declare const supportsEmoji: () => boolean;
 export declare const getNearestScrollableContainer: (element: HTMLElement) => HTMLElement | Document;
 export declare const focusNearestParent: (element: HTMLInputElement) => void;
 export declare const preventUnload: (event: BeforeUnloadEvent) => void;
+export declare const bytesToHexString: (bytes: Uint8Array) => string;
+export declare const getUpdatedTimestamp: () => number;
+/**
+ * Transforms array of objects containing `id` attribute,
+ * or array of ids (strings), into a Map, keyd by `id`.
+ */
+export declare const arrayToMap: <T extends string | {
+    id: string;
+}>(items: readonly T[]) => Map<string, T>;