@excalidraw/excalidraw 0.17.1-a38e82f → 0.17.1-b7babe5

package/dist/excalidraw/index.js

@@ -95,14 +95,14 @@ const areEqual = (prevProps, nextProps) => {
 };
 export const Excalidraw = React.memo(ExcalidrawBase, areEqual);
 Excalidraw.displayName = "Excalidraw";
-export { getSceneVersion, isInvisiblySmallElement, getNonDeletedElements, } from "./element";
+export { getSceneVersion, hashElementsVersion, hashString, isInvisiblySmallElement, getNonDeletedElements, } from "./element";
 export { defaultLang, useI18n, languages } from "./i18n";
 export { restore, restoreAppState, restoreElements, restoreLibraryItems, } from "./data/restore";
 export { exportToCanvas, exportToBlob, exportToSvg, exportToClipboard, } from "../utils/export";
 export { serializeAsJSON, serializeLibraryAsJSON } from "./data/json";
 export { loadFromBlob, loadSceneOrLibraryFromBlob, loadLibraryFromBlob, } from "./data/blob";
 export { getFreeDrawSvgPath } from "./renderer/renderElement";
-export { mergeLibraryItems } from "./data/library";
+export { mergeLibraryItems, getLibraryItemsHash } from "./data/library";
 export { isLinearElement } from "./element/typeChecks";
 export { FONT_FAMILY, THEME, MIME_TYPES, ROUNDNESS } from "./constants";
 export { mutateElement, newElementWith, bumpVersion, } from "./element/mutateElement";

package/dist/excalidraw/locales/en.json

@@ -216,6 +216,7 @@
         "failedToFetchImage": "Failed to fetch image.",
         "cannotResolveCollabServer": "Couldn't connect to the collab server. Please reload the page and try again.",
         "importLibraryError": "Couldn't load library",
+        "saveLibraryError": "Couldn't save library to storage. Please save your library to a file locally to make sure you don't lose changes.",
         "collabSaveFailed": "Couldn't save to the backend database. If problems persist, you should save your file locally to ensure you don't lose your work.",
         "collabSaveFailed_sizeExceeded": "Couldn't save to the backend database, the canvas seems to be too big. You should save the file locally to ensure you don't lose your work.",
         "imageToolNotSupported": "Images are disabled.",

package/dist/excalidraw/queue.d.ts

@@ -0,0 +1,9 @@
+import { MaybePromise } from "./utility-types";
+type Job<T, TArgs extends unknown[]> = (...args: TArgs) => MaybePromise<T>;
+export declare class Queue {
+    private jobs;
+    private running;
+    private tick;
+    push<TValue, TArgs extends unknown[]>(jobFactory: Job<TValue, TArgs>, ...args: TArgs): Promise<TValue>;
+}
+export {};

package/dist/excalidraw/queue.js

@@ -0,0 +1,27 @@
+import { promiseTry, resolvablePromise } from "./utils";
+export class Queue {
+    jobs = [];
+    running = false;
+    tick() {
+        if (this.running) {
+            return;
+        }
+        const job = this.jobs.shift();
+        if (job) {
+            this.running = true;
+            job.promise.resolve(promiseTry(job.jobFactory, ...job.args).finally(() => {
+                this.running = false;
+                this.tick();
+            }));
+        }
+        else {
+            this.running = false;
+        }
+    }
+    push(jobFactory, ...args) {
+        const promise = resolvablePromise();
+        this.jobs.push({ jobFactory, promise, args });
+        this.tick();
+        return promise;
+    }
+}

package/dist/excalidraw/types.d.ts

@@ -17,7 +17,7 @@ import type { FileSystemHandle } from "./data/filesystem";
 import type { IMAGE_MIME_TYPES, MIME_TYPES } from "./constants";
 import { ContextMenuItems } from "./components/ContextMenu";
 import { SnapLine } from "./snapping";
-import { Merge, ValueOf } from "./utility-types";
+import { Merge, MaybePromise, ValueOf } from "./utility-types";
 export type Point = Readonly<RoughPoint>;
 export type SocketId = string & {
     _brand: "SocketId";
@@ -304,9 +304,9 @@ export type LibraryItem = {
 };
 export type LibraryItems = readonly LibraryItem[];
 export type LibraryItems_anyVersion = LibraryItems | LibraryItems_v1;
-export type LibraryItemsSource = ((currentLibraryItems: LibraryItems) => Blob | LibraryItems_anyVersion | Promise<LibraryItems_anyVersion | Blob>) | Blob | LibraryItems_anyVersion | Promise<LibraryItems_anyVersion | Blob>;
+export type LibraryItemsSource = ((currentLibraryItems: LibraryItems) => MaybePromise<LibraryItems_anyVersion | Blob>) | MaybePromise<LibraryItems_anyVersion | Blob>;
 export type ExcalidrawInitialDataState = Merge<ImportedDataState, {
-    libraryItems?: Required<ImportedDataState>["libraryItems"] | Promise<Required<ImportedDataState>["libraryItems"]>;
+    libraryItems?: MaybePromise<Required<ImportedDataState>["libraryItems"]>;
 }>;
 export type OnUserFollowedPayload = {
     userToFollow: UserToFollow;
@@ -314,7 +314,7 @@ export type OnUserFollowedPayload = {
 };
 export interface ExcalidrawProps {
     onChange?: (elements: readonly ExcalidrawElement[], appState: AppState, files: BinaryFiles) => void;
-    initialData?: ExcalidrawInitialDataState | null | Promise<ExcalidrawInitialDataState | null>;
+    initialData?: MaybePromise<ExcalidrawInitialDataState | null>;
     excalidrawAPI?: (api: ExcalidrawImperativeAPI) => void;
     isCollaborating?: boolean;
     onPointerUpdate?: (payload: {
@@ -486,7 +486,7 @@ export type PointerDownState = Readonly<{
     };
 }>;
 export type UnsubscribeCallback = () => void;
-export type ExcalidrawImperativeAPI = {
+export interface ExcalidrawImperativeAPI {
     updateScene: InstanceType<typeof App>["updateScene"];
     updateLibrary: InstanceType<typeof Library>["updateLibrary"];
     resetScene: InstanceType<typeof App>["resetScene"];
@@ -519,7 +519,7 @@ export type ExcalidrawImperativeAPI = {
     onPointerUp: (callback: (activeTool: AppState["activeTool"], pointerDownState: PointerDownState, event: PointerEvent) => void) => UnsubscribeCallback;
     onScrollChange: (callback: (scrollX: number, scrollY: number, zoom: Zoom) => void) => UnsubscribeCallback;
     onUserFollow: (callback: (payload: OnUserFollowedPayload) => void) => UnsubscribeCallback;
-};
+}
 export type Device = Readonly<{
     viewport: {
         isMobile: boolean;

package/dist/excalidraw/utility-types.d.ts

@@ -28,3 +28,5 @@ export type ReadonlySetLike<T> = ReadonlySet<T> | readonly T[];
 export type MakeBrand<T extends string> = {
     [K in `~brand~${T}`]: T;
 };
+/** Maybe just promise or already fulfilled one! */
+export type MaybePromise<T> = T | Promise<T>;

package/dist/excalidraw/utils.d.ts

@@ -1,6 +1,7 @@
 import { EVENT } from "./constants";
 import { FontFamilyValues, FontString } from "./element/types";
 import { ActiveTool, AppState, ToolType, UnsubscribeCallback, Zoom } from "./types";
+import { MaybePromise } from "./utility-types";
 export declare const setDateTimeForTests: (dateTime: string) => void;
 export declare const getDateTime: () => string;
 export declare const capitalizeString: (str: string) => string;
@@ -137,7 +138,7 @@ export declare const findIndex: <T>(array: readonly T[], cb: (element: T, index:
 export declare const findLastIndex: <T>(array: readonly T[], cb: (element: T, index: number, array: readonly T[]) => boolean, fromIndex?: number) => number;
 export declare const isTransparent: (color: string) => boolean;
 export type ResolvablePromise<T> = Promise<T> & {
-    resolve: [T] extends [undefined] ? (value?: T) => void : (value: T) => void;
+    resolve: [T] extends [undefined] ? (value?: MaybePromise<Awaited<T>>) => void : (value: MaybePromise<Awaited<T>>) => void;
     reject: (error: Error) => void;
 };
 export declare const resolvablePromise: <T>() => ResolvablePromise<T>;
@@ -219,4 +220,5 @@ type Unbrand<T> = T extends Map<infer E, infer F> ? Map<E, F> : T extends Set<in
  * compose branded types which are not composite themselves.)
  */
 export declare const toBrandedType: <BrandedType, CurrentType = BrandedType>(value: Unbrand<BrandedType>) => CurrentType & BrandedType;
+export declare const promiseTry: <TValue, TArgs extends unknown[]>(fn: (...args: TArgs) => TValue | PromiseLike<TValue>, ...args: TArgs) => Promise<TValue>;
 export {};

package/dist/excalidraw/utils.js

@@ -673,3 +673,9 @@ export const toBrandedType = (value) => {
     return value;
 };
 // -----------------------------------------------------------------------------
+// Promise.try, adapted from https://github.com/sindresorhus/p-try
+export const promiseTry = async (fn, ...args) => {
+    return new Promise((resolve) => {
+        resolve(fn(...args));
+    });
+};

package/dist/{dev/en-TDNWCAOT.json → prod/en-EY7E2L5O.json}

@@ -216,6 +216,7 @@
     "failedToFetchImage": "Failed to fetch image.",
     "cannotResolveCollabServer": "Couldn't connect to the collab server. Please reload the page and try again.",
     "importLibraryError": "Couldn't load library",
+    "saveLibraryError": "Couldn't save library to storage. Please save your library to a file locally to make sure you don't lose changes.",
     "collabSaveFailed": "Couldn't save to the backend database. If problems persist, you should save your file locally to ensure you don't lose your work.",
     "collabSaveFailed_sizeExceeded": "Couldn't save to the backend database, the canvas seems to be too big. You should save the file locally to ensure you don't lose your work.",
     "imageToolNotSupported": "Images are disabled.",