@dwelle/excalidraw 0.3.64 → 0.3.65

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dwelle/excalidraw",
-  "version": "0.3.64",
+  "version": "0.3.65",
   "main": "main.js",
   "types": "types/packages/excalidraw/index.d.ts",
   "files": [

package/types/appState.d.ts

@@ -3,7 +3,7 @@ export declare const getDefaultAppState: () => Omit<AppState, "offsetTop" | "off
 export declare const clearAppStateForLocalStorage: (appState: Partial<AppState>) => {
     activeTool?: {
         type: "line" | "arrow" | "text" | "selection" | "rectangle" | "diamond" | "ellipse" | "image" | "freedraw" | "eraser";
-        lastActiveToolBeforeEraser: import("./types").LastActiveToolBeforeEraser; /** server (shareLink/collab/...) */
+        lastActiveToolBeforeEraser: import("./types").LastActiveToolBeforeEraser;
         locked: boolean;
         customType: null;
     } | {

package/types/components/App.d.ts

@@ -48,7 +48,6 @@ declare class App extends React.Component<AppProps, AppState> {
     private onUnload;
     private disableEvent;
     private onFontLoaded;
-    private importLibraryFromUrl;
     private resetHistory;
     /**
      * Resets scene & history.
@@ -90,13 +89,19 @@ declare class App extends React.Component<AppProps, AppState> {
         appState?: Pick<AppState, K> | null | undefined;
         collaborators?: SceneData["collaborators"];
         commitToHistory?: SceneData["commitToHistory"];
-        libraryItems?: LibraryItems | import("../types").LibraryItems_v1 | Promise<LibraryItems | import("../types").LibraryItems_v1> | ((currentLibraryItems: LibraryItems) => Required<SceneData>["libraryItems"] | Promise<Required<SceneData>["libraryItems"]>) | undefined;
     }) => void;
     private onSceneUpdated;
     private updateCurrentCursorPosition;
     private onKeyDown;
     private onKeyUp;
     private setActiveTool;
+    /**
+     * returns whether user is making a gesture with >= 2 fingers (points)
+     * on o touch screen (not on a trackpad). Currently only relates to Darwin
+     * (iOS/iPadOS,MacOS), but may work on other devices in the future if
+     * GestureEvent is standardized.
+     */
+    private isTouchScreenMultiTouchGesture;
     private onGestureStart;
     private onGestureChange;
     private onGestureEnd;

package/types/components/LibraryMenu.d.ts

@@ -1,11 +1,11 @@
 /// <reference types="react" />
 import Library from "../data/library";
-import { LibraryItem, AppState, BinaryFiles, ExcalidrawProps } from "../types";
+import { LibraryItems, LibraryItem, AppState, BinaryFiles, ExcalidrawProps } from "../types";
 import "./LibraryMenu.scss";
-export declare const LibraryMenu: ({ onClose, onInsertShape, pendingElements, onAddToLibrary, theme, setAppState, files, libraryReturnUrl, focusContainer, library, id, appState, }: {
+export declare const LibraryMenu: ({ onClose, onInsertLibraryItems, pendingElements, onAddToLibrary, theme, setAppState, files, libraryReturnUrl, focusContainer, library, id, appState, }: {
     pendingElements: LibraryItem["elements"];
     onClose: () => void;
-    onInsertShape: (elements: LibraryItem["elements"]) => void;
+    onInsertLibraryItems: (libraryItems: LibraryItems) => void;
     onAddToLibrary: () => void;
     theme: AppState["theme"];
     files: BinaryFiles;

package/types/components/LibraryMenuItems.d.ts

@@ -2,12 +2,12 @@ import React from "react";
 import Library from "../data/library";
 import { AppState, BinaryFiles, ExcalidrawProps, LibraryItem, LibraryItems } from "../types";
 import "./LibraryMenuItems.scss";
-declare const LibraryMenuItems: ({ isLoading, libraryItems, onRemoveFromLibrary, onAddToLibrary, onInsertShape, pendingElements, theme, setAppState, libraryReturnUrl, library, files, id, selectedItems, onSelectItems, onPublish, resetLibrary, }: {
+declare const LibraryMenuItems: ({ isLoading, libraryItems, onRemoveFromLibrary, onAddToLibrary, onInsertLibraryItems, pendingElements, theme, setAppState, libraryReturnUrl, library, files, id, selectedItems, onSelectItems, onPublish, resetLibrary, }: {
     isLoading: boolean;
     libraryItems: LibraryItems;
     pendingElements: LibraryItem["elements"];
     onRemoveFromLibrary: () => void;
-    onInsertShape: (elements: LibraryItem["elements"]) => void;
+    onInsertLibraryItems: (libraryItems: LibraryItems) => void;
     onAddToLibrary: (elements: LibraryItem["elements"]) => void;
     theme: AppState["theme"];
     files: BinaryFiles;

package/types/components/LibraryUnit.d.ts

@@ -1,7 +1,7 @@
 /// <reference types="react" />
 import { BinaryFiles, LibraryItem } from "../types";
 import "./LibraryUnit.scss";
-export declare const LibraryUnit: ({ id, elements, files, isPending, onClick, selected, onToggle, }: {
+export declare const LibraryUnit: ({ id, elements, files, isPending, onClick, selected, onToggle, onDrag, }: {
     id: LibraryItem["id"] | /** for pending item */ null;
     elements?: readonly import("../element/types").NonDeleted<import("../element/types").ExcalidrawElement>[] | undefined;
     files: BinaryFiles;
@@ -9,4 +9,5 @@ export declare const LibraryUnit: ({ id, elements, files, isPending, onClick, se
     onClick: () => void;
     selected: boolean;
     onToggle: (id: string, event: React.MouseEvent) => void;
+    onDrag: (id: string, event: React.DragEvent) => void;
 }) => JSX.Element;

package/types/data/blob.d.ts

@@ -18,6 +18,7 @@ export declare const loadSceneOrLibraryFromBlob: (blob: Blob | File, localAppSta
     data: ImportedLibraryData;
 }>;
 export declare const loadFromBlob: (blob: Blob, localAppState: AppState | null, localElements: readonly ExcalidrawElement[] | null, fileHandle?: FileSystemHandle | null | undefined) => Promise<import("./restore").RestoredDataState>;
+export declare const parseLibraryJSON: (json: string, defaultStatus?: LibraryItem["status"]) => LibraryItem[];
 export declare const loadLibraryFromBlob: (blob: Blob, defaultStatus?: LibraryItem["status"]) => Promise<LibraryItem[]>;
 export declare const canvasToBlob: (canvas: HTMLCanvasElement) => Promise<Blob>;
 /** generates SHA-1 digest from supplied file (if not supported, falls back

package/types/data/json.d.ts

@@ -1,7 +1,6 @@
 import { ExcalidrawElement } from "../element/types";
 import { AppState, BinaryFiles, LibraryItems } from "../types";
 import { ImportedDataState, ImportedLibraryData } from "./types";
-import Library from "./library";
 export declare const serializeAsJSON: (elements: readonly ExcalidrawElement[], appState: Partial<AppState>, files: BinaryFiles, type: "local" | "database") => string;
 export declare const saveAsJSON: (elements: readonly ExcalidrawElement[], appState: AppState, files: BinaryFiles) => Promise<{
     fileHandle: import("browser-fs-access").FileSystemHandle | null;
@@ -15,4 +14,3 @@ export declare const isValidExcalidrawData: (data?: {
 export declare const isValidLibrary: (json: any) => json is ImportedLibraryData;
 export declare const serializeLibraryAsJSON: (libraryItems: LibraryItems) => string;
 export declare const saveLibraryAsJSON: (libraryItems: LibraryItems) => Promise<void>;
-export declare const importLibraryFromJSON: (library: Library) => Promise<void>;

package/types/data/library.d.ts

@@ -1,6 +1,6 @@
-import { LibraryItems, LibraryItem } from "../types";
+import { LibraryItems, ExcalidrawImperativeAPI, LibraryItemsSource } from "../types";
 import type App from "../components/App";
-import { ImportedDataState } from "./types";
+import { ExcalidrawElement } from "../element/types";
 export declare const libraryItemsAtom: import("jotai").Atom<{
     status: "loading" | "loaded";
     isInitialized: boolean;
@@ -71,15 +71,26 @@ declare class Library {
     private getLastUpdateTask;
     private notifyListeners;
     resetLibrary: () => Promise<LibraryItems>;
-    /**
-     * imports library (from blob or libraryItems), merging with current library
-     * (attempting to remove duplicates)
-     */
-    importLibrary(library: Blob | Required<ImportedDataState>["libraryItems"] | Promise<Required<ImportedDataState>["libraryItems"]>, defaultStatus?: LibraryItem["status"]): Promise<LibraryItems>;
     /**
      * @returns latest cloned libraryItems. Awaits all in-progress updates first.
      */
     getLatestLibrary: () => Promise<LibraryItems>;
+    updateLibrary: ({ libraryItems, prompt, merge, openLibraryMenu, defaultStatus, }: {
+        libraryItems: LibraryItemsSource;
+        merge?: boolean | undefined;
+        prompt?: boolean | undefined;
+        openLibraryMenu?: boolean | undefined;
+        defaultStatus?: "published" | "unpublished" | undefined;
+    }) => Promise<LibraryItems>;
     setLibrary: (libraryItems: LibraryItems | Promise<LibraryItems> | ((latestLibraryItems: LibraryItems) => LibraryItems | Promise<LibraryItems>)) => Promise<LibraryItems>;
 }
 export default Library;
+export declare const distributeLibraryItemsOnSquareGrid: (libraryItems: LibraryItems) => ExcalidrawElement[];
+export declare const parseLibraryTokensFromUrl: () => {
+    libraryUrl: string;
+    idToken: string | null;
+} | null;
+export declare const useHandleLibrary: ({ excalidrawAPI, getInitialLibraryItems, }: {
+    excalidrawAPI: ExcalidrawImperativeAPI | null;
+    getInitialLibraryItems?: (() => LibraryItemsSource) | undefined;
+}) => void;

package/types/data/types.d.ts

@@ -1,5 +1,5 @@
 import { ExcalidrawElement } from "../element/types";
-import { AppState, BinaryFiles, LibraryItems, LibraryItems_v1 } from "../types";
+import { AppState, BinaryFiles, LibraryItems, LibraryItems_anyVersion } from "../types";
 import type { cleanAppStateForExport } from "../appState";
 import { VERSIONS } from "../constants";
 export interface ExportedDataState {
@@ -17,7 +17,7 @@ export interface ImportedDataState {
     elements?: readonly ExcalidrawElement[] | null;
     appState?: Readonly<Partial<AppState>> | null;
     scrollToContent?: boolean;
-    libraryItems?: LibraryItems | LibraryItems_v1;
+    libraryItems?: LibraryItems_anyVersion;
     files?: BinaryFiles;
 }
 export interface ExportedLibraryData {

package/types/distribute.d.ts

@@ -0,0 +1,6 @@
+import { ExcalidrawElement } from "./element/types";
+export interface Distribution {
+    space: "between";
+    axis: "x" | "y";
+}
+export declare const distributeElements: (selectedElements: ExcalidrawElement[], distribution: Distribution) => ExcalidrawElement[];

package/types/element/linearElementEditor.d.ts

@@ -86,7 +86,10 @@ export declare class LinearElementEditor {
                 startBindingElement: ExcalidrawBindableElement | "keep" | null;
                 endBindingElement: ExcalidrawBindableElement | "keep" | null;
             };
-            isLoading: boolean;
+            isLoading: boolean; /**
+             * @param id the `elementId` from the instance of this class (so that we can
+             *  statically guarantee this method returns an ExcalidrawLinearElement)
+             */
             errorMessage: string | null;
             draggingElement: import("./types").NonDeletedExcalidrawElement | null;
             resizingElement: import("./types").NonDeletedExcalidrawElement | null;

package/types/packages/excalidraw/index.d.ts

@@ -11,7 +11,8 @@ export { exportToBlob, exportToCanvas, exportToSvg, serializeAsJSON, serializeLi
 export { isLinearElement } from "../../element/typeChecks";
 export { FONT_FAMILY, THEME, MIME_TYPES } from "../../constants";
 export { mutateElement, newElementWith, bumpVersion, } from "../../element/mutateElement";
-export { getDefaultAppState } from "../../appState";
-export { cleanAppStateForExport, clearAppStateForLocalStorage, } from "../../appState";
+export { parseLibraryTokensFromUrl, useHandleLibrary, } from "../../data/library";
+export { sceneCoordsToViewportCoords, viewportCoordsToSceneCoords, } from "../../utils";
+export { getDefaultAppState, cleanAppStateForExport, clearAppStateForLocalStorage, } from "../../appState";
 export { jotaiScope, jotaiStore } from "../../jotai";
 export { libraryItemsAtom } from "../../data/library";

package/types/types.d.ts

@@ -29,7 +29,7 @@ export declare type Collaborator = {
         background: string;
         stroke: string;
     };
-    src?: string;
+    avatarUrl?: string;
 };
 export declare type DataURL = string & {
     _brand: "DataURL";
@@ -170,7 +170,7 @@ export declare class GestureEvent extends UIEvent {
 /** @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[];
+declare type LibraryItems_v1 = readonly LibraryItem_v1[];
 /** v2 library item */
 export declare type LibraryItem = {
     id: string;
@@ -182,6 +182,8 @@ export declare type LibraryItem = {
     error?: string;
 };
 export declare type LibraryItems = readonly LibraryItem[];
+export declare type LibraryItems_anyVersion = LibraryItems | LibraryItems_v1;
+export declare type LibraryItemsSource = ((currentLibraryItems: LibraryItems) => Blob | LibraryItems_anyVersion | Promise<LibraryItems_anyVersion | Blob>) | Blob | LibraryItems_anyVersion | Promise<LibraryItems_anyVersion | Blob>;
 export declare type ExcalidrawAPIRefValue = ExcalidrawImperativeAPI | {
     readyPromise?: ResolvablePromise<ExcalidrawImperativeAPI>;
     ready?: false;
@@ -238,7 +240,6 @@ export declare type SceneData = {
     appState?: ImportedDataState["appState"];
     collaborators?: Map<string, Collaborator>;
     commitToHistory?: boolean;
-    libraryItems?: LibraryItems | LibraryItems_v1;
 };
 export declare enum UserIdleState {
     ACTIVE = "active",
@@ -346,6 +347,7 @@ export declare type PointerDownState = Readonly<{
 }>;
 export declare type ExcalidrawImperativeAPI = {
     updateScene: InstanceType<typeof App>["updateScene"];
+    updateLibrary: InstanceType<typeof Library>["updateLibrary"];
     resetScene: InstanceType<typeof App>["resetScene"];
     getSceneElementsIncludingDeleted: InstanceType<typeof App>["getSceneElementsIncludingDeleted"];
     history: {
@@ -356,7 +358,6 @@ export declare type ExcalidrawImperativeAPI = {
     getAppState: () => InstanceType<typeof App>["state"];
     getFiles: () => InstanceType<typeof App>["files"];
     refresh: InstanceType<typeof App>["refresh"];
-    importLibrary: InstanceType<typeof App>["importLibraryFromUrl"];
     setToastMessage: InstanceType<typeof App>["setToastMessage"];
     addFiles: (data: BinaryFileData[]) => void;
     readyPromise: ResolvablePromise<ExcalidrawImperativeAPI>;
@@ -369,3 +370,4 @@ export declare type DeviceType = {
     isMobile: boolean;
     isTouchScreen: boolean;
 };
+export {};