@dwelle/excalidraw 0.3.72 → 0.3.74

package/types/actions/actionToggleZenMode.d.ts

@@ -72,7 +72,11 @@ export declare const actionToggleZenMode: {
             };
             shouldCacheIgnoreZoom: boolean;
             showHelpDialog: boolean;
-            toastMessage: string | null;
+            toast: {
+                message: string;
+                closable?: boolean | undefined;
+                duration?: number | undefined;
+            } | null;
             theme: string;
             gridSize: number | null;
             viewModeEnabled: boolean;

package/types/components/App.d.ts

@@ -6,6 +6,7 @@ import History from "../history";
 import Scene from "../scene/Scene";
 import { AppClassProperties, AppProps, AppState, ExcalidrawImperativeAPI, BinaryFiles, LibraryItems, SceneData, Device } from "../types";
 import { FileSystemHandle } from "../data/filesystem";
+import { Emitter } from "../emitter";
 export declare const useDevice: () => Readonly<{
     isSmScreen: boolean;
     isMobile: boolean;
@@ -43,6 +44,7 @@ declare class App extends React.Component<AppProps, AppState> {
         x: number;
         y: number;
     } | null;
+    onChangeEmitter: Emitter<[elements: readonly ExcalidrawElement[], appState: AppState, files: BinaryFiles]>;
     constructor(props: AppProps);
     private renderCanvas;
     render(): JSX.Element;
@@ -64,6 +66,7 @@ declare class App extends React.Component<AppProps, AppState> {
     private refreshDeviceState;
     componentDidMount(): Promise<void>;
     componentWillUnmount(): void;
+    private checkIfBrowserZoomed;
     private onResize;
     private removeEventListeners;
     private addEventListeners;
@@ -83,10 +86,12 @@ declare class App extends React.Component<AppProps, AppState> {
     removePointer: (event: React.PointerEvent<HTMLElement> | PointerEvent) => void;
     toggleLock: (source?: "keyboard" | "ui") => void;
     togglePenMode: () => void;
-    toggleZenMode: () => void;
     scrollToContent: (target?: ExcalidrawElement | readonly ExcalidrawElement[]) => void;
-    clearToast: () => void;
-    setToastMessage: (toastMessage: string) => void;
+    setToast: (toast: {
+        message: string;
+        closable?: boolean;
+        duration?: number;
+    } | null) => void;
     restoreFileFromShare: () => Promise<void>;
     /** adds supplied files to existing files in the appState */
     addFiles: ExcalidrawImperativeAPI["addFiles"];
@@ -99,6 +104,7 @@ declare class App extends React.Component<AppProps, AppState> {
     private onSceneUpdated;
     private updateCurrentCursorPosition;
     private onKeyDown;
+    private onWheel;
     private onKeyUp;
     private setActiveTool;
     private setCursor;

package/types/components/LayerUI.d.ts

@@ -18,16 +18,13 @@ interface LayerUIProps {
     onLockToggle: () => void;
     onPenModeToggle: () => void;
     onInsertElements: (elements: readonly NonDeletedExcalidrawElement[]) => void;
-    zenModeEnabled: boolean;
     showExitZenModeBtn: boolean;
     showThemeBtn: boolean;
-    toggleZenMode: () => void;
     langCode: Language["code"];
     isCollaborating: boolean;
     renderTopRightUI?: ExcalidrawProps["renderTopRightUI"];
     renderCustomFooter?: ExcalidrawProps["renderFooter"];
     renderCustomStats?: ExcalidrawProps["renderCustomStats"];
-    viewModeEnabled: boolean;
     libraryReturnUrl: ExcalidrawProps["libraryReturnUrl"];
     UIOptions: AppProps["UIOptions"];
     focusContainer: () => void;
@@ -37,5 +34,5 @@ interface LayerUIProps {
         insertOnCanvasDirectly: boolean;
     }) => void;
 }
-declare const _default: React.MemoExoticComponent<({ onHomeButtonClick, actionManager, appState, files, setAppState, canvas, elements, onCollabButtonClick, onLockToggle, onPenModeToggle, onInsertElements, zenModeEnabled, showExitZenModeBtn, showThemeBtn, toggleZenMode, isCollaborating, renderTopRightUI, renderCustomFooter, renderCustomStats, viewModeEnabled, libraryReturnUrl, UIOptions, focusContainer, library, id, onImageAction, }: LayerUIProps) => JSX.Element>;
+declare const _default: React.MemoExoticComponent<({ onHomeButtonClick, actionManager, appState, files, setAppState, canvas, elements, onCollabButtonClick, onLockToggle, onPenModeToggle, onInsertElements, showExitZenModeBtn, showThemeBtn, isCollaborating, renderTopRightUI, renderCustomFooter, renderCustomStats, libraryReturnUrl, UIOptions, focusContainer, library, id, onImageAction, }: LayerUIProps) => JSX.Element>;
 export default _default;

package/types/components/MobileMenu.d.ts

@@ -17,7 +17,6 @@ declare type MobileMenuProps = {
     canvas: HTMLCanvasElement | null;
     isCollaborating: boolean;
     renderCustomFooter?: (isMobile: boolean, appState: AppState) => JSX.Element | null;
-    viewModeEnabled: boolean;
     showThemeBtn: boolean;
     onImageAction: (data: {
         insertOnCanvasDirectly: boolean;
@@ -26,5 +25,5 @@ declare type MobileMenuProps = {
     renderStats: () => JSX.Element | null;
     UIOptions: AppProps["UIOptions"];
 };
-export declare const MobileMenu: ({ onHomeButtonClick, appState, elements, libraryMenu, actionManager, renderJSONExportDialog, renderImageExportDialog, setAppState, onCollabButtonClick, onLockToggle, onPenModeToggle, canvas, isCollaborating, renderCustomFooter, viewModeEnabled, showThemeBtn, onImageAction, renderTopRightUI, renderStats, UIOptions, }: MobileMenuProps) => JSX.Element;
+export declare const MobileMenu: ({ onHomeButtonClick, appState, elements, libraryMenu, actionManager, renderJSONExportDialog, renderImageExportDialog, setAppState, onCollabButtonClick, onLockToggle, onPenModeToggle, canvas, isCollaborating, renderCustomFooter, showThemeBtn, onImageAction, renderTopRightUI, renderStats, UIOptions, }: MobileMenuProps) => JSX.Element;
 export {};

package/types/components/Toast.d.ts

@@ -1,6 +1,8 @@
 /// <reference types="react" />
 import "./Toast.scss";
-export declare const Toast: ({ message, clearToast, }: {
+export declare const Toast: ({ message, onClose, closable, duration, }: {
     message: string;
-    clearToast: () => void;
+    onClose: () => void;
+    closable?: boolean | undefined;
+    duration?: number | undefined;
 }) => JSX.Element;

package/types/constants.d.ts

@@ -96,7 +96,6 @@ export declare const IMAGE_RENDER_TIMEOUT = 500;
 export declare const TAP_TWICE_TIMEOUT = 300;
 export declare const TOUCH_CTX_MENU_TIMEOUT = 500;
 export declare const TITLE_TIMEOUT = 10000;
-export declare const TOAST_TIMEOUT = 5000;
 export declare const VERSION_TIMEOUT = 30000;
 export declare const SCROLL_TIMEOUT = 100;
 export declare const ZOOM_STEP = 0.1;

package/types/data/filesystem.d.ts

@@ -1,10 +1,10 @@
-import { FileWithHandle, FileSystemHandle, supported as nativeFileSystemSupported } from "browser-fs-access";
+import { FileSystemHandle, supported as nativeFileSystemSupported } from "browser-fs-access";
 declare type FILE_EXTENSION = "gif" | "jpg" | "png" | "excalidraw.png" | "svg" | "excalidraw.svg" | "json" | "excalidraw" | "excalidrawlib";
 export declare const fileOpen: <M extends boolean | undefined = false>(opts: {
     extensions?: FILE_EXTENSION[] | undefined;
     description: string;
     multiple?: M | undefined;
-}) => Promise<M extends false | undefined ? FileWithHandle : FileWithHandle[]>;
+}) => Promise<M extends false | undefined ? File : File[]>;
 export declare const fileSave: (blob: Blob, opts: {
     /** supply without the extension */
     name: string;

package/types/element/Hyperlink.d.ts

@@ -82,7 +82,11 @@ export declare const actionLink: {
             };
             shouldCacheIgnoreZoom: boolean;
             showHelpDialog: boolean;
-            toastMessage: string | null;
+            toast: {
+                message: string;
+                closable?: boolean | undefined;
+                duration?: number | undefined;
+            } | null;
             zenModeEnabled: boolean;
             theme: string;
             gridSize: number | null;

package/types/element/linearElementEditor.d.ts

@@ -149,7 +149,11 @@ export declare class LinearElementEditor {
             };
             shouldCacheIgnoreZoom: boolean;
             showHelpDialog: boolean;
-            toastMessage: string | null;
+            toast: {
+                message: string;
+                closable?: boolean | undefined;
+                duration?: number | undefined;
+            } | null;
             zenModeEnabled: boolean;
             theme: string;
             gridSize: number | null;

package/types/emitter.d.ts

@@ -0,0 +1,21 @@
+declare type Subscriber<T extends any[]> = (...payload: T) => void;
+export declare class Emitter<T extends any[] = []> {
+    subscribers: Subscriber<T>[];
+    value: T | undefined;
+    private updateOnChangeOnly;
+    constructor(opts?: {
+        initialState?: T;
+        updateOnChangeOnly?: boolean;
+    });
+    /**
+     * Attaches subscriber
+     *
+     * @returns unsubscribe function
+     */
+    on(...handlers: Subscriber<T>[] | Subscriber<T>[][]): () => void;
+    once(...handlers: Subscriber<T>[] | Subscriber<T>[][]): () => void;
+    off(...handlers: Subscriber<T>[] | Subscriber<T>[][]): void;
+    trigger(...payload: T): any[];
+    destroy(): void;
+}
+export {};

package/types/jotai.d.ts

@@ -1,8 +1,9 @@
+import { WritableAtom } from "jotai";
 export declare const jotaiScope: unique symbol;
 export declare const jotaiStore: {
     get: <Value>(atom: import("jotai").Atom<Value>) => (Value extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? any : V : V : V : V : V : V : V : V : V : V : Value) | undefined;
     asyncGet: <Value_1>(atom: import("jotai").Atom<Value_1>) => Promise<Value_1 extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? any : V : V : V : V : V : V : V : V : V : V : Value_1>;
-    set: <Value_2, Update, Result extends void | Promise<void>>(atom: import("jotai").WritableAtom<Value_2, Update, Result>, update: Update) => Result;
+    set: <Value_2, Update, Result extends void | Promise<void>>(atom: WritableAtom<Value_2, Update, Result>, update: Update) => Result;
     sub: (atom: {
         toString: () => string;
         debugLabel?: string | undefined;
@@ -14,7 +15,7 @@ export declare const jotaiStore: {
     }, callback: () => void) => () => void;
     SECRET_INTERNAL_store: {
         r: <Value_6>(readingAtom: import("jotai").Atom<Value_6>, version?: import("jotai/core/store").VersionObject | undefined) => import("jotai/core/store").AtomState<Value_6>;
-        w: <Value_1_1, Update_1, Result_1 extends void | Promise<void>>(writingAtom: import("jotai").WritableAtom<Value_1_1, Update_1, Result_1>, update: Update_1, version?: import("jotai/core/store").VersionObject | undefined) => Result_1;
+        w: <Value_1_1, Update_1, Result_1 extends void | Promise<void>>(writingAtom: WritableAtom<Value_1_1, Update_1, Result_1>, update: Update_1, version?: import("jotai/core/store").VersionObject | undefined) => Result_1;
         c: (_atom: {
             toString: () => string;
             debugLabel?: string | undefined;
@@ -84,7 +85,7 @@ export declare const jotaiStore: {
         } | undefined;
     } | {
         r: <Value_7>(readingAtom: import("jotai").Atom<Value_7>, version?: import("jotai/core/store").VersionObject | undefined) => import("jotai/core/store").AtomState<Value_7>;
-        w: <Value_1_2, Update_2, Result_2 extends void | Promise<void>>(writingAtom: import("jotai").WritableAtom<Value_1_2, Update_2, Result_2>, update: Update_2, version?: import("jotai/core/store").VersionObject | undefined) => Result_2;
+        w: <Value_1_2, Update_2, Result_2 extends void | Promise<void>>(writingAtom: WritableAtom<Value_1_2, Update_2, Result_2>, update: Update_2, version?: import("jotai/core/store").VersionObject | undefined) => Result_2;
         c: (_atom: {
             toString: () => string;
             debugLabel?: string | undefined;
@@ -118,3 +119,4 @@ export declare const jotaiStore: {
         m?: undefined;
     };
 };
+export declare const useAtomWithInitialValue: <T extends unknown, A extends WritableAtom<T, T, void>>(atom: A, initialValue: T | (() => T)) => readonly [T extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? any : V : V : V : V : V : V : V : V : V : V : T, import("jotai/core/atom").SetAtom<T, void>];

package/types/renderer/renderScene.d.ts

@@ -3,7 +3,15 @@ import { RoughSVG } from "roughjs/bin/svg";
 import { AppState, BinaryFiles } from "../types";
 import { NonDeletedExcalidrawElement } from "../element/types";
 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) => {
+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;
+};
+/** renderScene throttled to animation framerate */
+export declare const renderScene: <T extends boolean = false>(elements: readonly NonDeletedExcalidrawElement[], appState: AppState, selectionElement: NonDeletedExcalidrawElement | null, scale: number, rc: RoughCanvas, canvas: HTMLCanvasElement, renderConfig: RenderConfig, callback?: ((data: ReturnType<typeof _renderScene>) => void) | undefined, throttle?: T | undefined) => T extends true ? void : {
     atLeastOneVisibleElement: boolean;
     scrollBars?: undefined;
 } | {

package/types/types.d.ts

@@ -113,7 +113,11 @@ export declare type AppState = {
     };
     shouldCacheIgnoreZoom: boolean;
     showHelpDialog: boolean;
-    toastMessage: string | null;
+    toast: {
+        message: string;
+        closable?: boolean;
+        duration?: number;
+    } | null;
     zenModeEnabled: boolean;
     theme: Theme;
     gridSize: number | null;
@@ -352,6 +356,7 @@ export declare type PointerDownState = Readonly<{
         };
     };
 }>;
+declare type UnsubscribeCallback = () => void;
 export declare type ExcalidrawImperativeAPI = {
     updateScene: InstanceType<typeof App>["updateScene"];
     updateLibrary: InstanceType<typeof Library>["updateLibrary"];
@@ -365,7 +370,7 @@ export declare type ExcalidrawImperativeAPI = {
     getAppState: () => InstanceType<typeof App>["state"];
     getFiles: () => InstanceType<typeof App>["files"];
     refresh: InstanceType<typeof App>["refresh"];
-    setToastMessage: InstanceType<typeof App>["setToastMessage"];
+    setToast: InstanceType<typeof App>["setToast"];
     addFiles: (data: BinaryFileData[]) => void;
     readyPromise: ResolvablePromise<ExcalidrawImperativeAPI>;
     ready: true;
@@ -374,6 +379,7 @@ export declare type ExcalidrawImperativeAPI = {
     setCursor: InstanceType<typeof App>["setCursor"];
     resetCursor: InstanceType<typeof App>["resetCursor"];
     app: InstanceType<typeof App>;
+    onChange: (callback: (elements: readonly ExcalidrawElement[], appState: AppState, files: BinaryFiles) => void) => UnsubscribeCallback;
 };
 export declare type Device = Readonly<{
     isSmScreen: boolean;

package/types/utils.d.ts

@@ -21,7 +21,9 @@ export declare const debounce: <T extends any[]>(fn: (...args: T) => void, timeo
     flush(): void;
     cancel(): void;
 };
-export declare const throttleRAF: <T extends any[]>(fn: (...args: T) => void) => {
+export declare const throttleRAF: <T extends any[]>(fn: (...args: T) => void, opts?: {
+    trailing?: boolean | undefined;
+} | undefined) => {
     (...args: T): void;
     flush(): void;
     cancel(): void;