@zsviczian/excalidraw 0.18.0-65 → 0.18.0-67

package/types/excalidraw/data/library.d.ts

@@ -0,0 +1,127 @@
+import type { ExcalidrawElement } from "@excalidraw/element/types";
+import type { MaybePromise } from "@excalidraw/common/utility-types";
+import type App from "../components/App";
+import type { LibraryItems, ExcalidrawImperativeAPI, LibraryItemsSource, LibraryItems_anyVersion } from "../types";
+export type LibraryPersistedData = {
+    libraryItems: LibraryItems;
+};
+export type LibraryAdatapterSource = "load" | "save";
+export interface LibraryPersistenceAdapter {
+    /**
+     * Should load data that were previously saved into the database using the
+     * `save` method. Should throw if saving fails.
+     *
+     * Will be used internally in multiple places, such as during save to
+     * in order to reconcile changes with latest store data.
+     */
+    load(metadata: {
+        /**
+         * Indicates whether we're loading data for save purposes, or reading
+         * purposes, in which case host app can implement more aggressive caching.
+         */
+        source: LibraryAdatapterSource;
+    }): MaybePromise<{
+        libraryItems: LibraryItems_anyVersion;
+    } | null>;
+    /** Should persist to the database as is (do no change the data structure). */
+    save(libraryData: LibraryPersistedData): MaybePromise<void>;
+}
+export interface LibraryMigrationAdapter {
+    /**
+     * loads data from legacy data source. Returns `null` if no data is
+     * to be migrated.
+     */
+    load(): MaybePromise<{
+        libraryItems: LibraryItems_anyVersion;
+    } | null>;
+    /** clears entire storage afterwards */
+    clear(): MaybePromise<void>;
+}
+export declare const libraryItemsAtom: import("jotai/vanilla/atom").PrimitiveAtom<{
+    status: "loading" | "loaded";
+    /** indicates whether library is initialized with library items (has gone
+     * through at least one update). Used in UI. Specific to this atom only. */
+    isInitialized: boolean;
+    libraryItems: LibraryItems;
+}> & {
+    init: {
+        status: "loading" | "loaded";
+        /** indicates whether library is initialized with library items (has gone
+         * through at least one update). Used in UI. Specific to this atom only. */
+        isInitialized: boolean;
+        libraryItems: LibraryItems;
+    };
+};
+/** Merges otherItems into localItems. Unique items in otherItems array are
+    sorted first. */
+export declare const mergeLibraryItems: (localItems: LibraryItems, otherItems: LibraryItems) => LibraryItems;
+declare class Library {
+    /** latest libraryItems */
+    private currLibraryItems;
+    /** snapshot of library items since last onLibraryChange call */
+    private prevLibraryItems;
+    private app;
+    constructor(app: App);
+    private updateQueue;
+    private getLastUpdateTask;
+    private notifyListeners;
+    /** call on excalidraw instance unmount */
+    destroy: () => void;
+    resetLibrary: () => 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;
+        prompt?: boolean;
+        openLibraryMenu?: boolean;
+        defaultStatus?: "unpublished" | "published";
+    }) => Promise<LibraryItems>;
+    setLibrary: (
+    /**
+     * LibraryItems that will replace current items. Can be a function which
+     * will be invoked after all previous tasks are resolved
+     * (this is the prefered way to update the library to avoid race conditions,
+     * but you'll want to manually merge the library items in the callback
+     *  - which is what we're doing in Library.importLibrary()).
+     *
+     * If supplied promise is rejected with AbortError, we swallow it and
+     * do not update the library.
+     */
+    libraryItems: LibraryItems | Promise<LibraryItems> | ((latestLibraryItems: LibraryItems) => LibraryItems | Promise<LibraryItems>)) => Promise<LibraryItems>;
+}
+export default Library;
+export declare const distributeLibraryItemsOnSquareGrid: (libraryItems: LibraryItems) => ExcalidrawElement[];
+export declare const validateLibraryUrl: (libraryUrl: string, 
+/**
+ * @returns `true` if the URL is valid, throws otherwise.
+ */
+validator?: ((libraryUrl: string) => boolean) | string[]) => true;
+export declare const parseLibraryTokensFromUrl: () => {
+    libraryUrl: string;
+    idToken: string | null;
+} | null;
+export declare const getLibraryItemsHash: (items: LibraryItems) => number;
+export declare const useHandleLibrary: (opts: {
+    excalidrawAPI: ExcalidrawImperativeAPI | null;
+    /**
+     * Return `true` if the library install url should be allowed.
+     * If not supplied, only the excalidraw.com base domain is allowed.
+     */
+    validateLibraryUrl?: (libraryUrl: string) => boolean;
+} & ({
+    /** @deprecated we recommend using `opts.adapter` instead */
+    getInitialLibraryItems?: () => MaybePromise<LibraryItemsSource>;
+} | {
+    adapter: LibraryPersistenceAdapter;
+    /**
+     * Adapter that takes care of loading data from legacy data store.
+     * Supply this if you want to migrate data on initial load from legacy
+     * data store.
+     *
+     * Can be a different LibraryPersistenceAdapter.
+     */
+    migrationAdapter?: LibraryMigrationAdapter;
+})) => void;

package/types/excalidraw/data/reconcile.d.ts

@@ -0,0 +1,7 @@
+import type { OrderedExcalidrawElement } from "@excalidraw/element/types";
+import type { MakeBrand } from "@excalidraw/common/utility-types";
+import type { AppState } from "../types";
+export type ReconciledExcalidrawElement = OrderedExcalidrawElement & MakeBrand<"ReconciledElement">;
+export type RemoteExcalidrawElement = OrderedExcalidrawElement & MakeBrand<"RemoteExcalidrawElement">;
+export declare const shouldDiscardRemoteElement: (localAppState: AppState, local: OrderedExcalidrawElement | undefined, remote: RemoteExcalidrawElement) => boolean;
+export declare const reconcileElements: (localElements: readonly OrderedExcalidrawElement[], remoteElements: readonly RemoteExcalidrawElement[], localAppState: AppState) => ReconciledExcalidrawElement[];

package/types/excalidraw/data/resave.d.ts

@@ -0,0 +1,5 @@
+import type { ExcalidrawElement } from "@excalidraw/element/types";
+import type { AppState, BinaryFiles } from "../types";
+export declare const resaveAsImageWithScene: (elements: readonly ExcalidrawElement[], appState: AppState, files: BinaryFiles, name: string) => Promise<{
+    fileHandle: import("browser-fs-access").FileSystemHandle;
+}>;

package/types/excalidraw/data/restore.d.ts

@@ -0,0 +1,35 @@
+import type { ElementsMap, ElementsMapOrArray, ExcalidrawElement, ExcalidrawSelectionElement, OrderedExcalidrawElement } from "@excalidraw/element/types";
+import type { AppState, BinaryFiles, LibraryItem } from "../types";
+import type { ImportedDataState } from "./types";
+type RestoredAppState = Omit<AppState, "offsetTop" | "offsetLeft" | "width" | "height">;
+export declare const AllowedExcalidrawActiveTools: Record<AppState["activeTool"]["type"], boolean>;
+export type RestoredDataState = {
+    elements: OrderedExcalidrawElement[];
+    appState: RestoredAppState;
+    files: BinaryFiles;
+};
+export declare const restoreElement: (element: Exclude<ExcalidrawElement, ExcalidrawSelectionElement>, targetElementsMap: Readonly<ElementsMap>, localElementsMap: Readonly<ElementsMap> | null | undefined, opts?: {
+    deleteInvisibleElements?: boolean;
+}) => typeof element | null;
+export declare const restoreElements: (targetElements: ImportedDataState["elements"], 
+/** NOTE doesn't serve for reconciliation */
+localElements: Readonly<ElementsMapOrArray> | null | undefined, opts?: {
+    refreshDimensions?: boolean;
+    repairBindings?: boolean;
+    deleteInvisibleElements?: boolean;
+} | undefined) => OrderedExcalidrawElement[];
+export declare const restoreAppState: (appState: ImportedDataState["appState"], localAppState: Partial<AppState> | null | undefined) => RestoredAppState;
+export declare const restore: (data: Pick<ImportedDataState, "appState" | "elements" | "files"> | null, 
+/**
+ * Local AppState (`this.state` or initial state from localStorage) so that we
+ * don't overwrite local state with default values (when values not
+ * explicitly specified).
+ * Supply `null` if you can't get access to it.
+ */
+localAppState: Partial<AppState> | null | undefined, localElements: readonly ExcalidrawElement[] | null | undefined, elementsConfig?: {
+    refreshDimensions?: boolean;
+    repairBindings?: boolean;
+    deleteInvisibleElements?: boolean;
+}) => RestoredDataState;
+export declare const restoreLibraryItems: (libraryItems: ImportedDataState["libraryItems"], defaultStatus: LibraryItem["status"]) => LibraryItem[];
+export {};

package/types/excalidraw/data/transform.d.ts

@@ -0,0 +1,81 @@
+import type { ElementConstructorOpts } from "@excalidraw/element";
+import type { ExcalidrawBindableElement, ExcalidrawElement, ExcalidrawFrameElement, ExcalidrawFreeDrawElement, ExcalidrawGenericElement, ExcalidrawIframeLikeElement, ExcalidrawImageElement, ExcalidrawLinearElement, ExcalidrawMagicFrameElement, ExcalidrawSelectionElement, ExcalidrawTextElement, FileId, FontFamilyValues, TextAlign, VerticalAlign } from "@excalidraw/element/types";
+import type { MarkOptional } from "@excalidraw/common/utility-types";
+export type ValidLinearElement = {
+    type: "arrow" | "line";
+    x: number;
+    y: number;
+    label?: {
+        text: string;
+        fontSize?: number;
+        fontFamily?: FontFamilyValues;
+        textAlign?: TextAlign;
+        verticalAlign?: VerticalAlign;
+    } & MarkOptional<ElementConstructorOpts, "x" | "y">;
+    end?: (({
+        type: Exclude<ExcalidrawBindableElement["type"], "image" | "text" | "frame" | "magicframe" | "embeddable" | "iframe">;
+        id?: ExcalidrawGenericElement["id"];
+    } | {
+        id: ExcalidrawGenericElement["id"];
+        type?: Exclude<ExcalidrawBindableElement["type"], "image" | "text" | "frame" | "magicframe" | "embeddable" | "iframe">;
+    }) | (({
+        type: "text";
+        text: string;
+    } | {
+        type?: "text";
+        id: ExcalidrawTextElement["id"];
+        text: string;
+    }) & Partial<ExcalidrawTextElement>)) & MarkOptional<ElementConstructorOpts, "x" | "y">;
+    start?: (({
+        type: Exclude<ExcalidrawBindableElement["type"], "image" | "text" | "frame" | "magicframe" | "embeddable" | "iframe">;
+        id?: ExcalidrawGenericElement["id"];
+    } | {
+        id: ExcalidrawGenericElement["id"];
+        type?: Exclude<ExcalidrawBindableElement["type"], "image" | "text" | "frame" | "magicframe" | "embeddable" | "iframe">;
+    }) | (({
+        type: "text";
+        text: string;
+    } | {
+        type?: "text";
+        id: ExcalidrawTextElement["id"];
+        text: string;
+    }) & Partial<ExcalidrawTextElement>)) & MarkOptional<ElementConstructorOpts, "x" | "y">;
+} & Partial<ExcalidrawLinearElement>;
+export type ValidContainer = {
+    type: Exclude<ExcalidrawGenericElement["type"], "selection">;
+    id?: ExcalidrawGenericElement["id"];
+    label?: {
+        text: string;
+        fontSize?: number;
+        fontFamily?: FontFamilyValues;
+        textAlign?: TextAlign;
+        verticalAlign?: VerticalAlign;
+    } & MarkOptional<ElementConstructorOpts, "x" | "y">;
+} & ElementConstructorOpts;
+export type ExcalidrawElementSkeleton = Extract<Exclude<ExcalidrawElement, ExcalidrawSelectionElement>, ExcalidrawIframeLikeElement | ExcalidrawFreeDrawElement> | ({
+    type: Extract<ExcalidrawLinearElement["type"], "line">;
+    x: number;
+    y: number;
+} & Partial<ExcalidrawLinearElement>) | ValidContainer | ValidLinearElement | ({
+    type: "text";
+    text: string;
+    x: number;
+    y: number;
+    id?: ExcalidrawTextElement["id"];
+} & Partial<ExcalidrawTextElement>) | ({
+    type: Extract<ExcalidrawImageElement["type"], "image">;
+    x: number;
+    y: number;
+    fileId: FileId;
+} & Partial<ExcalidrawImageElement>) | ({
+    type: "frame";
+    children: readonly ExcalidrawElement["id"][];
+    name?: string;
+} & Partial<ExcalidrawFrameElement>) | ({
+    type: "magicframe";
+    children: readonly ExcalidrawElement["id"][];
+    name?: string;
+} & Partial<ExcalidrawMagicFrameElement>);
+export declare const convertToExcalidrawElements: (elementsSkeleton: ExcalidrawElementSkeleton[] | null, opts?: {
+    regenerateIds: boolean;
+}) => import("@excalidraw/element/types").OrderedExcalidrawElement[];

package/types/excalidraw/data/types.d.ts

@@ -0,0 +1,48 @@
+import type { VERSIONS } from "@excalidraw/common";
+import type { ExcalidrawElement } from "@excalidraw/element/types";
+import type { cleanAppStateForExport } from "../appState";
+import type { AppState, BinaryFiles, LibraryItem, LibraryItems, LibraryItems_anyVersion } from "../types";
+export interface ExportedDataState {
+    type: string;
+    version: number;
+    source: string;
+    elements: readonly ExcalidrawElement[];
+    appState: ReturnType<typeof cleanAppStateForExport>;
+    files: BinaryFiles | undefined;
+}
+/**
+ * Map of legacy AppState keys, with values of:
+ *  [<legacy type>, <new AppState proeprty>]
+ *
+ * This is a helper type used in downstream abstractions.
+ * Don't consume on its own.
+ */
+export type LegacyAppState = {
+    /** @deprecated #6213 TODO remove 23-06-01 */
+    isSidebarDocked: [boolean, "defaultSidebarDockedPreference"];
+};
+export interface ImportedDataState {
+    type?: string;
+    version?: number;
+    source?: string;
+    elements?: readonly ExcalidrawElement[] | null;
+    appState?: Readonly<Partial<AppState & {
+        [T in keyof LegacyAppState]: LegacyAppState[T][0];
+    }>> | null;
+    scrollToContent?: boolean;
+    libraryItems?: LibraryItems_anyVersion;
+    files?: BinaryFiles;
+}
+export interface ExportedLibraryData {
+    type: string;
+    version: typeof VERSIONS.excalidrawLibrary;
+    source: string;
+    libraryItems: LibraryItems;
+}
+export interface ImportedLibraryData extends Partial<ExportedLibraryData> {
+    /** @deprecated v1 */
+    library?: LibraryItems;
+}
+export type ExcalidrawLibraryIds = {
+    itemIds: LibraryItem["id"][];
+};

package/types/excalidraw/deburr.d.ts

@@ -0,0 +1 @@
+export declare const deburr: (str: string) => string;

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

@@ -0,0 +1,2 @@
+export = __WEBPACK_EXTERNAL_MODULE_react_jsx_runtime__;
+export = __WEBPACK_EXTERNAL_MODULE_react_jsx_runtime__;

package/types/excalidraw/dist/excalidraw.production.min.d.ts

@@ -0,0 +1,2 @@
+declare const _exports: any;
+export = _exports;

package/types/excalidraw/editor-jotai.d.ts

@@ -0,0 +1,56 @@
+import { atom, createStore, type PrimitiveAtom, type WritableAtom } from "jotai";
+import { createIsolation } from "jotai-scope";
+export { atom, PrimitiveAtom, WritableAtom };
+export declare const useAtom: typeof import("jotai").useAtom, useSetAtom: typeof import("jotai").useSetAtom, useAtomValue: typeof import("jotai").useAtomValue, useStore: (options?: {
+    store?: {
+        get: <Value>(atom: import("jotai").Atom<Value>) => Value;
+        set: <Value_1, Args extends unknown[], Result>(atom: WritableAtom<Value_1, Args, Result>, ...args: Args) => Result;
+        sub: (atom: import("jotai").Atom<unknown>, listener: () => void) => () => void;
+    } | ({
+        get: <Value>(atom: import("jotai").Atom<Value>) => Value;
+        set: <Value_1, Args extends unknown[], Result>(atom: WritableAtom<Value_1, Args, Result>, ...args: Args) => Result;
+        sub: (atom: import("jotai").Atom<unknown>, listener: () => void) => () => void;
+    } & {
+        dev4_get_internal_weak_map: () => WeakMap<import("jotai").Atom<unknown>, {
+            readonly d: Map<import("jotai").Atom<unknown>, number>;
+            readonly p: Set<import("jotai").Atom<unknown>>;
+            n: number;
+            m?: {
+                readonly l: Set<() => void>;
+                readonly d: Set<import("jotai").Atom<unknown>>;
+                readonly t: Set<import("jotai").Atom<unknown>>;
+                u?: () => void;
+            };
+            v?: unknown;
+            e?: unknown;
+        }>;
+        dev4_get_mounted_atoms: () => Set<import("jotai").Atom<unknown>>;
+        dev4_restore_atoms: (values: Iterable<readonly [import("jotai").Atom<unknown>, unknown]>) => void;
+    });
+} | undefined) => {
+    get: <Value>(atom: import("jotai").Atom<Value>) => Value;
+    set: <Value_1, Args extends unknown[], Result>(atom: WritableAtom<Value_1, Args, Result>, ...args: Args) => Result;
+    sub: (atom: import("jotai").Atom<unknown>, listener: () => void) => () => void;
+} | ({
+    get: <Value>(atom: import("jotai").Atom<Value>) => Value;
+    set: <Value_1, Args extends unknown[], Result>(atom: WritableAtom<Value_1, Args, Result>, ...args: Args) => Result;
+    sub: (atom: import("jotai").Atom<unknown>, listener: () => void) => () => void;
+} & {
+    dev4_get_internal_weak_map: () => WeakMap<import("jotai").Atom<unknown>, {
+        readonly d: Map<import("jotai").Atom<unknown>, number>;
+        readonly p: Set<import("jotai").Atom<unknown>>;
+        n: number;
+        m?: {
+            readonly l: Set<() => void>;
+            readonly d: Set<import("jotai").Atom<unknown>>;
+            readonly t: Set<import("jotai").Atom<unknown>>;
+            u?: () => void;
+        };
+        v?: unknown;
+        e?: unknown;
+    }>;
+    dev4_get_mounted_atoms: () => Set<import("jotai").Atom<unknown>>;
+    dev4_restore_atoms: (values: Iterable<readonly [import("jotai").Atom<unknown>, unknown]>) => void;
+});
+export declare const EditorJotaiProvider: ReturnType<typeof createIsolation>["Provider"];
+export declare const editorJotaiStore: ReturnType<typeof createStore>;

package/types/excalidraw/entry.d.ts

@@ -0,0 +1 @@
+export * from "./index";

package/types/excalidraw/env.d.cts

@@ -0,0 +1 @@
+export function parseEnvVariables(filepath: any): {};

package/types/excalidraw/env.d.ts

@@ -0,0 +1 @@
+export function parseEnvVariables(filepath: any): {};

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

@@ -0,0 +1,12 @@
+import { AnimatedTrail } from "../animated-trail";
+import type { AnimationFrameHandler } from "../animation-frame-handler";
+import type App from "../components/App";
+export declare class EraserTrail extends AnimatedTrail {
+    private elementsToErase;
+    private groupsToErase;
+    constructor(animationFrameHandler: AnimationFrameHandler, app: App);
+    startPath(x: number, y: number): void;
+    addPointToPath(x: number, y: number, restore?: boolean): string[];
+    private updateElementsToBeErased;
+    endPath(): void;
+}

package/types/excalidraw/errors.d.ts

@@ -0,0 +1,29 @@
+type CANVAS_ERROR_NAMES = "CANVAS_ERROR" | "CANVAS_POSSIBLY_TOO_BIG";
+export declare class CanvasError extends Error {
+    constructor(message?: string, name?: CANVAS_ERROR_NAMES);
+}
+export declare class AbortError extends DOMException {
+    constructor(message?: string);
+}
+type ImageSceneDataErrorCode = "IMAGE_NOT_CONTAINS_SCENE_DATA" | "IMAGE_SCENE_DATA_ERROR";
+export declare class ImageSceneDataError extends Error {
+    code: ImageSceneDataErrorCode;
+    constructor(message?: string, code?: ImageSceneDataErrorCode);
+}
+type WorkerErrorCodes = "WORKER_URL_NOT_DEFINED" | "WORKER_IN_THE_MAIN_CHUNK";
+export declare class WorkerUrlNotDefinedError extends Error {
+    code: WorkerErrorCodes;
+    constructor(message?: string, code?: WorkerErrorCodes);
+}
+export declare class WorkerInTheMainChunkError extends Error {
+    code: WorkerErrorCodes;
+    constructor(message?: string, code?: WorkerErrorCodes);
+}
+/**
+ * Use this for generic, handled errors, so you can check against them
+ * and rethrow if needed
+ */
+export declare class ExcalidrawError extends Error {
+    constructor(message: string);
+}
+export {};

package/types/excalidraw/fonts/Cascadia/index.d.ts

@@ -0,0 +1,2 @@
+import { type ExcalidrawFontFaceDescriptor } from "../Fonts";
+export declare const CascadiaFontFaces: ExcalidrawFontFaceDescriptor[];

package/types/excalidraw/fonts/ComicShanns/index.d.ts

@@ -0,0 +1,2 @@
+import { type ExcalidrawFontFaceDescriptor } from "../Fonts";
+export declare const ComicShannsFontFaces: ExcalidrawFontFaceDescriptor[];

package/types/excalidraw/fonts/Emoji/index.d.ts

@@ -0,0 +1,2 @@
+import { type ExcalidrawFontFaceDescriptor } from "../Fonts";
+export declare const EmojiFontFaces: ExcalidrawFontFaceDescriptor[];

package/types/excalidraw/fonts/ExcalidrawFontFace.d.ts

@@ -0,0 +1,29 @@
+type DataURL = string;
+export declare class ExcalidrawFontFace {
+    readonly urls: URL[] | DataURL[];
+    readonly fontFace: FontFace;
+    private static readonly ASSETS_FALLBACK_URL;
+    constructor(family: string, uri: string, descriptors?: FontFaceDescriptors);
+    /**
+     * Generates CSS `@font-face` definition with the (subsetted) font source as a data url for the characters within the unicode range.
+     *
+     * Retrieves `undefined` otherwise.
+     */
+    toCSS(characters: string): Promise<string> | undefined;
+    /**
+     * Tries to fetch woff2 content, based on the registered urls (from first to last, treated as fallbacks).
+     *
+     * @returns base64 with subsetted glyphs based on the passed codepoint, last defined url otherwise
+     */
+    getContent(codePoints: Array<number>): Promise<string>;
+    fetchFont(url: URL | DataURL): Promise<ArrayBuffer>;
+    private getUnicodeRangeRegex;
+    private static createUrls;
+    private static getFormat;
+    private static normalizeBaseUrl;
+    /**
+     * zsviczian https://github.com/zsviczian/excalidraw/commit/b4cfaaa4b4f46ca01f94e27fb7bf651a9da99daa
+     */
+    getContentLegacy(): Promise<string>;
+}
+export {};

package/types/excalidraw/fonts/Excalifont/index.d.ts

@@ -0,0 +1,2 @@
+import { type ExcalidrawFontFaceDescriptor } from "../Fonts";
+export declare const ExcalifontFontFaces: ExcalidrawFontFaceDescriptor[];

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

@@ -0,0 +1,90 @@
+import { type FontMetadata } from "@excalidraw/common";
+import type { ExcalidrawElement, ExcalidrawTextElement } from "@excalidraw/element/types";
+import type { Scene } from "@excalidraw/element";
+import { ExcalidrawFontFace } from "./ExcalidrawFontFace";
+export declare class Fonts {
+    static readonly loadedFontsCache: Set<string>;
+    private static _registered;
+    private static _initialized;
+    static get registered(): Map<number, {
+        metadata: FontMetadata;
+        fontFaces: ExcalidrawFontFace[];
+    }>;
+    get registered(): Map<number, {
+        metadata: FontMetadata;
+        fontFaces: ExcalidrawFontFace[];
+    }>;
+    private readonly scene;
+    constructor(scene: Scene);
+    /**
+     * Get all the font families for the given scene.
+     */
+    getSceneFamilies: () => number[];
+    /**
+     * if we load a (new) font, it's likely that text elements using it have
+     * already been rendered using a fallback font. Thus, we want invalidate
+     * their shapes and rerender. See #637.
+     *
+     * Invalidates text elements and rerenders scene, provided that at least one
+     * of the supplied fontFaces has not already been processed.
+     */
+    onLoaded: (fontFaces: readonly FontFace[]) => void;
+    /**
+     * Load font faces for a given scene and trigger scene update.
+     */
+    loadSceneFonts: () => Promise<FontFace[]>;
+    /**
+     * Load font faces for passed elements - use when the scene is unavailable (i.e. export).
+     */
+    static loadElementsFonts: (elements: readonly ExcalidrawElement[]) => Promise<FontFace[]>;
+    /**
+     * Generate CSS @font-face declarations for the given elements.
+     */
+    static generateFontFaceDeclarations(elements: readonly ExcalidrawElement[]): Promise<string[]>;
+    static loadFontFaces(fontFamilies: Array<ExcalidrawTextElement["fontFamily"]>, charsPerFamily: Record<number, Set<string>>): Promise<FontFace[]>;
+    private static fontFacesLoader;
+    private static fontFacesStylesGenerator;
+    /**
+     * Register a new font.
+     *
+     * @param family font family
+     * @param metadata font metadata
+     * @param fontFacesDecriptors font faces descriptors
+     */
+    static register(this: Fonts | {
+        registered: Map<number, {
+            metadata: FontMetadata;
+            fontFaces: ExcalidrawFontFace[];
+        }>;
+    }, family: string, metadata: FontMetadata, ...fontFacesDecriptors: ExcalidrawFontFaceDescriptor[]): Map<number, {
+        metadata: FontMetadata;
+        fontFaces: ExcalidrawFontFace[];
+    }> | Map<number, {
+        metadata: FontMetadata;
+        fontFaces: ExcalidrawFontFace[];
+    }>;
+    /**
+     * WARN: should be called just once on init, even across multiple instances.
+     */
+    private static init;
+    /**
+     * Get all the unique font families for the given elements.
+     */
+    static getUniqueFamilies(elements: ReadonlyArray<ExcalidrawElement>): Array<ExcalidrawTextElement["fontFamily"]>;
+    /**
+     * Get all the unique characters per font family for the given scene.
+     */
+    private static getCharsPerFamily;
+    /**
+     * Get characters for a given family.
+     */
+    private static getCharacters;
+    /**
+     * Get all registered font families.
+     */
+    private static getAllFamilies;
+}
+export interface ExcalidrawFontFaceDescriptor {
+    uri: string;
+    descriptors?: FontFaceDescriptors;
+}

package/types/excalidraw/fonts/Helvetica/index.d.ts

@@ -0,0 +1,2 @@
+import { type ExcalidrawFontFaceDescriptor } from "../Fonts";
+export declare const HelveticaFontFaces: ExcalidrawFontFaceDescriptor[];

package/types/excalidraw/fonts/Liberation/index.d.ts

@@ -0,0 +1,2 @@
+import { type ExcalidrawFontFaceDescriptor } from "../Fonts";
+export declare const LiberationFontFaces: ExcalidrawFontFaceDescriptor[];

package/types/excalidraw/fonts/Lilita/index.d.ts

@@ -0,0 +1,2 @@
+import { type ExcalidrawFontFaceDescriptor } from "../Fonts";
+export declare const LilitaFontFaces: ExcalidrawFontFaceDescriptor[];

package/types/excalidraw/fonts/Nunito/index.d.ts

@@ -0,0 +1,2 @@
+import { type ExcalidrawFontFaceDescriptor } from "../Fonts";
+export declare const NunitoFontFaces: ExcalidrawFontFaceDescriptor[];

package/types/excalidraw/fonts/Virgil/index.d.ts

@@ -0,0 +1,2 @@
+import { type ExcalidrawFontFaceDescriptor } from "../Fonts";
+export declare const VirgilFontFaces: ExcalidrawFontFaceDescriptor[];

package/types/excalidraw/fonts/Xiaolai/index.d.ts

@@ -0,0 +1,8 @@
+import { type ExcalidrawFontFaceDescriptor } from "../Fonts";
+/**
+ * The original font was modified with the following changes:
+ * - removed non-CJK codepoints
+ * - reduced any Hangul side-bearings to 40%
+ * - centered in width of inproperly centered CJK codepoints
+ */
+export declare const XiaolaiFontFaces: ExcalidrawFontFaceDescriptor[];

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

@@ -0,0 +1 @@
+export * from "./Fonts";

package/types/excalidraw/gesture.d.ts

@@ -0,0 +1,6 @@
+import type { PointerCoords } from "./types";
+export declare const getCenter: (pointers: Map<number, PointerCoords>) => {
+    x: number;
+    y: number;
+};
+export declare const getDistance: ([a, b]: readonly PointerCoords[]) => number;