@wildmio/excalidraw 0.18.0-custom-1

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

@@ -0,0 +1,242 @@
+export declare namespace OpenAIInput {
+    type ChatCompletionContentPart = ChatCompletionContentPartText | ChatCompletionContentPartImage;
+    interface ChatCompletionContentPartImage {
+        image_url: ChatCompletionContentPartImage.ImageURL;
+        /**
+         * The type of the content part.
+         */
+        type: "image_url";
+    }
+    namespace ChatCompletionContentPartImage {
+        interface ImageURL {
+            /**
+             * Either a URL of the image or the base64 encoded image data.
+             */
+            url: string;
+            /**
+             * Specifies the detail level of the image.
+             */
+            detail?: "auto" | "low" | "high";
+        }
+    }
+    interface ChatCompletionContentPartText {
+        /**
+         * The text content.
+         */
+        text: string;
+        /**
+         * The type of the content part.
+         */
+        type: "text";
+    }
+    interface ChatCompletionUserMessageParam {
+        /**
+         * The contents of the user message.
+         */
+        content: string | Array<ChatCompletionContentPart> | null;
+        /**
+         * The role of the messages author, in this case `user`.
+         */
+        role: "user";
+    }
+    interface ChatCompletionSystemMessageParam {
+        /**
+         * The contents of the system message.
+         */
+        content: string | null;
+        /**
+         * The role of the messages author, in this case `system`.
+         */
+        role: "system";
+    }
+    export interface ChatCompletionCreateParamsBase {
+        /**
+         * A list of messages comprising the conversation so far.
+         * [Example Python code](https://cookbook.openai.com/examples/how_to_format_inputs_to_chatgpt_models).
+         */
+        messages: Array<ChatCompletionUserMessageParam | ChatCompletionSystemMessageParam>;
+        /**
+         * ID of the model to use. See the
+         * [model endpoint compatibility](https://platform.openai.com/docs/models/model-endpoint-compatibility)
+         * table for details on which models work with the Chat API.
+         */
+        model: (string & {}) | "gpt-4-1106-preview" | "gpt-4-vision-preview" | "gpt-4" | "gpt-4-0314" | "gpt-4-0613" | "gpt-4-32k" | "gpt-4-32k-0314" | "gpt-4-32k-0613" | "gpt-3.5-turbo" | "gpt-3.5-turbo-16k" | "gpt-3.5-turbo-0301" | "gpt-3.5-turbo-0613" | "gpt-3.5-turbo-16k-0613";
+        /**
+         * Number between -2.0 and 2.0. Positive values penalize new tokens based on their
+         * existing frequency in the text so far, decreasing the model's likelihood to
+         * repeat the same line verbatim.
+         *
+         * [See more information about frequency and presence penalties.](https://platform.openai.com/docs/guides/gpt/parameter-details)
+         */
+        frequency_penalty?: number | null;
+        /**
+         * Modify the likelihood of specified tokens appearing in the completion.
+         *
+         * Accepts a JSON object that maps tokens (specified by their token ID in the
+         * tokenizer) to an associated bias value from -100 to 100. Mathematically, the
+         * bias is added to the logits generated by the model prior to sampling. The exact
+         * effect will vary per model, but values between -1 and 1 should decrease or
+         * increase likelihood of selection; values like -100 or 100 should result in a ban
+         * or exclusive selection of the relevant token.
+         */
+        logit_bias?: Record<string, number> | null;
+        /**
+         * The maximum number of [tokens](/tokenizer) to generate in the chat completion.
+         *
+         * The total length of input tokens and generated tokens is limited by the model's
+         * context length.
+         * [Example Python code](https://cookbook.openai.com/examples/how_to_count_tokens_with_tiktoken)
+         * for counting tokens.
+         */
+        max_tokens?: number | null;
+        /**
+         * How many chat completion choices to generate for each input message.
+         */
+        n?: number | null;
+        /**
+         * Number between -2.0 and 2.0. Positive values penalize new tokens based on
+         * whether they appear in the text so far, increasing the model's likelihood to
+         * talk about new topics.
+         *
+         * [See more information about frequency and presence penalties.](https://platform.openai.com/docs/guides/gpt/parameter-details)
+         */
+        presence_penalty?: number | null;
+        /**
+         * This feature is in Beta. If specified, our system will make a best effort to
+         * sample deterministically, such that repeated requests with the same `seed` and
+         * parameters should return the same result. Determinism is not guaranteed, and you
+         * should refer to the `system_fingerprint` response parameter to monitor changes
+         * in the backend.
+         */
+        seed?: number | null;
+        /**
+         * Up to 4 sequences where the API will stop generating further tokens.
+         */
+        stop?: string | null | Array<string>;
+        /**
+         * If set, partial message deltas will be sent, like in ChatGPT. Tokens will be
+         * sent as data-only
+         * [server-sent events](https://developer.mozilla.org/en-US/docs/Web/API/Server-sent_events/Using_server-sent_events#Event_stream_format)
+         * as they become available, with the stream terminated by a `data: [DONE]`
+         * message.
+         * [Example Python code](https://cookbook.openai.com/examples/how_to_stream_completions).
+         */
+        stream?: boolean | null;
+        /**
+         * What sampling temperature to use, between 0 and 2. Higher values like 0.8 will
+         * make the output more random, while lower values like 0.2 will make it more
+         * focused and deterministic.
+         *
+         * We generally recommend altering this or `top_p` but not both.
+         */
+        temperature?: number | null;
+        /**
+         * An alternative to sampling with temperature, called nucleus sampling, where the
+         * model considers the results of the tokens with top_p probability mass. So 0.1
+         * means only the tokens comprising the top 10% probability mass are considered.
+         *
+         * We generally recommend altering this or `temperature` but not both.
+         */
+        top_p?: number | null;
+        /**
+         * A unique identifier representing your end-user, which can help OpenAI to monitor
+         * and detect abuse.
+         * [Learn more](https://platform.openai.com/docs/guides/safety-best-practices/end-user-ids).
+         */
+        user?: string;
+    }
+    export {};
+}
+export declare namespace OpenAIOutput {
+    export interface ChatCompletion {
+        /**
+         * A unique identifier for the chat completion.
+         */
+        id: string;
+        /**
+         * A list of chat completion choices. Can be more than one if `n` is greater
+         * than 1.
+         */
+        choices: Array<Choice>;
+        /**
+         * The Unix timestamp (in seconds) of when the chat completion was created.
+         */
+        created: number;
+        /**
+         * The model used for the chat completion.
+         */
+        model: string;
+        /**
+         * The object type, which is always `chat.completion`.
+         */
+        object: "chat.completion";
+        /**
+         * This fingerprint represents the backend configuration that the model runs with.
+         *
+         * Can be used in conjunction with the `seed` request parameter to understand when
+         * backend changes have been made that might impact determinism.
+         */
+        system_fingerprint?: string;
+        /**
+         * Usage statistics for the completion request.
+         */
+        usage?: CompletionUsage;
+    }
+    export interface Choice {
+        /**
+         * The reason the model stopped generating tokens. This will be `stop` if the model
+         * hit a natural stop point or a provided stop sequence, `length` if the maximum
+         * number of tokens specified in the request was reached, `content_filter` if
+         * content was omitted due to a flag from our content filters, `tool_calls` if the
+         * model called a tool, or `function_call` (deprecated) if the model called a
+         * function.
+         */
+        finish_reason: "stop" | "length" | "tool_calls" | "content_filter" | "function_call";
+        /**
+         * The index of the choice in the list of choices.
+         */
+        index: number;
+        /**
+         * A chat completion message generated by the model.
+         */
+        message: ChatCompletionMessage;
+    }
+    interface ChatCompletionMessage {
+        /**
+         * The contents of the message.
+         */
+        content: string | null;
+        /**
+         * The role of the author of this message.
+         */
+        role: "assistant";
+    }
+    /**
+     * Usage statistics for the completion request.
+     */
+    interface CompletionUsage {
+        /**
+         * Number of tokens in the generated completion.
+         */
+        completion_tokens: number;
+        /**
+         * Number of tokens in the prompt.
+         */
+        prompt_tokens: number;
+        /**
+         * Total number of tokens used in the request (prompt + completion).
+         */
+        total_tokens: number;
+    }
+    export interface APIError {
+        readonly status: 400 | 401 | 403 | 404 | 409 | 422 | 429 | 500 | undefined;
+        readonly headers: Headers | undefined;
+        readonly error: {
+            message: string;
+        } | undefined;
+        readonly code: string | null | undefined;
+        readonly param: string | null | undefined;
+        readonly type: string | undefined;
+    }
+    export {};
+}

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

@@ -0,0 +1,57 @@
+import { IMAGE_MIME_TYPES, MIME_TYPES } from "@excalidraw/common";
+import type { ValueOf } from "@excalidraw/common/utility-types";
+import type { ExcalidrawElement, FileId } from "@excalidraw/element/types";
+import type { AppState, DataURL, LibraryItem } from "../types";
+import type { FileSystemHandle } from "browser-fs-access";
+import type { ImportedLibraryData } from "./types";
+export declare const getMimeType: (blob: Blob | string) => string;
+export declare const getFileHandleType: (handle: FileSystemHandle | null) => string | null;
+export declare const isImageFileHandleType: (type: string | null) => type is "png" | "svg";
+export declare const isImageFileHandle: (handle: FileSystemHandle | null) => boolean;
+export declare const isSupportedImageFileType: (type: string | null | undefined) => boolean;
+export declare const isSupportedImageFile: (blob: Blob | null | undefined) => blob is Blob & {
+    type: ValueOf<typeof IMAGE_MIME_TYPES>;
+};
+export declare const loadSceneOrLibraryFromBlob: (blob: Blob | File, 
+/** @see restore.localAppState */
+localAppState: AppState | null, localElements: readonly ExcalidrawElement[] | null, 
+/** FileSystemHandle. Defaults to `blob.handle` if defined, otherwise null. */
+fileHandle?: FileSystemHandle | null) => Promise<{
+    type: "application/vnd.excalidraw+json";
+    data: import("./restore").RestoredDataState;
+} | {
+    type: "application/vnd.excalidrawlib+json";
+    data: ImportedLibraryData;
+}>;
+export declare const loadFromBlob: (blob: Blob, 
+/** @see restore.localAppState */
+localAppState: AppState | null, localElements: readonly ExcalidrawElement[] | null, 
+/** FileSystemHandle. Defaults to `blob.handle` if defined, otherwise null. */
+fileHandle?: FileSystemHandle | null) => 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<HTMLCanvasElement>) => Promise<Blob>;
+/** generates SHA-1 digest from supplied file (if not supported, falls back
+    to a 40-char base64 random id) */
+export declare const generateIdFromFile: (file: File) => Promise<FileId>;
+/** async. For sync variant, use getDataURL_sync */
+export declare const getDataURL: (file: Blob | File) => Promise<DataURL>;
+export declare const getDataURL_sync: (data: string | Uint8Array | ArrayBuffer, mimeType: ValueOf<typeof MIME_TYPES>) => DataURL;
+export declare const dataURLToFile: (dataURL: DataURL, filename?: string) => File;
+export declare const dataURLToString: (dataURL: DataURL) => string;
+export declare const resizeImageFile: (file: File, opts: {
+    /** undefined indicates auto */
+    outputType?: (typeof MIME_TYPES)["jpg"];
+    maxWidthOrHeight: number;
+}) => Promise<File>;
+export declare const SVGStringToFile: (SVGString: string, filename?: string) => File & {
+    type: typeof MIME_TYPES.svg;
+};
+export declare const ImageURLToFile: (imageUrl: string, filename?: string) => Promise<File | undefined>;
+export declare const getFileHandle: (event: DragEvent | React.DragEvent | DataTransferItem) => Promise<FileSystemHandle | null>;
+export declare const createFile: (blob: File | Blob | ArrayBuffer, mimeType: string, name: string | undefined) => File;
+/** attempts to detect correct mimeType if none is set, or if an image
+ * has an incorrect extension.
+ * Note: doesn't handle missing .excalidraw/.excalidrawlib extension  */
+export declare const normalizeFile: (file: File) => Promise<File>;
+export declare const blobToArrayBuffer: (blob: Blob) => Promise<ArrayBuffer>;

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

@@ -0,0 +1,55 @@
+export declare const toByteString: (data: string | Uint8Array | ArrayBuffer) => string;
+/**
+ * @param isByteString set to true if already byte string to prevent bloat
+ *  due to reencoding
+ */
+export declare const stringToBase64: (str: string, isByteString?: boolean) => string;
+export declare const base64ToString: (base64: string, isByteString?: boolean) => string;
+export declare const base64ToArrayBuffer: (base64: string) => ArrayBuffer;
+export declare const base64urlToString: (str: string) => string;
+type EncodedData = {
+    encoded: string;
+    encoding: "bstring";
+    /** whether text is compressed (zlib) */
+    compressed: boolean;
+    /** version for potential migration purposes */
+    version?: string;
+};
+/**
+ * Encodes (and potentially compresses via zlib) text to byte string
+ */
+export declare const encode: ({ text, compress, }: {
+    text: string;
+    /** defaults to `true`. If compression fails, falls back to bstring alone. */
+    compress?: boolean;
+}) => EncodedData;
+export declare const decode: (data: EncodedData) => string;
+/**
+ * The returned buffer has following format:
+ * `[]` refers to a buffers wrapper (see `concatBuffers`)
+ *
+ * [
+ *   encodingMetadataBuffer,
+ *   iv,
+ *   [
+ *      contentsMetadataBuffer
+ *      contentsBuffer
+ *   ]
+ * ]
+ */
+export declare const compressData: <T extends Record<string, any> = never>(dataBuffer: Uint8Array, options: {
+    encryptionKey: string;
+} & ([T] extends [never] ? {
+    metadata?: T;
+} : {
+    metadata: T;
+})) => Promise<Uint8Array<ArrayBuffer>>;
+export declare const decompressData: <T extends Record<string, any>>(bufferView: Uint8Array, options: {
+    decryptionKey: string;
+}) => Promise<{
+    /** metadata source is always JSON so we can decode it here */
+    metadata: T;
+    /** data can be anything so the caller must decode it */
+    data: Uint8Array<ArrayBuffer>;
+}>;
+export {};

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

@@ -0,0 +1,9 @@
+export declare const IV_LENGTH_BYTES = 12;
+export declare const createIV: () => Uint8Array<ArrayBuffer>;
+export declare const generateEncryptionKey: <T extends "string" | "cryptoKey" = "string">(returnAs?: T) => Promise<T extends "cryptoKey" ? CryptoKey : string>;
+export declare const getCryptoKey: (key: string, usage: KeyUsage) => Promise<CryptoKey>;
+export declare const encryptData: (key: string | CryptoKey, data: Uint8Array<ArrayBuffer> | ArrayBuffer | Blob | File | string) => Promise<{
+    encryptedBuffer: ArrayBuffer;
+    iv: Uint8Array<ArrayBuffer>;
+}>;
+export declare const decryptData: (iv: Uint8Array<ArrayBuffer>, encrypted: Uint8Array<ArrayBuffer> | ArrayBuffer, privateKey: string) => Promise<ArrayBuffer>;

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

@@ -0,0 +1,21 @@
+import { supported as nativeFileSystemSupported } from "browser-fs-access";
+import { MIME_TYPES } from "@excalidraw/common";
+import type { FileSystemHandle } from "browser-fs-access";
+type FILE_EXTENSION = Exclude<keyof typeof MIME_TYPES, "binary">;
+export declare const fileOpen: <M extends boolean | undefined = false>(opts: {
+    extensions?: FILE_EXTENSION[];
+    description: string;
+    multiple?: M;
+}) => Promise<M extends false | undefined ? File : File[]>;
+export declare const fileSave: (blob: Blob | Promise<Blob>, opts: {
+    /** supply without the extension */
+    name: string;
+    /** file extension */
+    extension: FILE_EXTENSION;
+    mimeTypes?: string[];
+    description: string;
+    /** existing FileSystemHandle */
+    fileHandle?: FileSystemHandle | null;
+}) => Promise<FileSystemHandle | null>;
+export { nativeFileSystemSupported };
+export type { FileSystemHandle };

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

@@ -0,0 +1,9 @@
+export declare const getTEXtChunk: (blob: Blob) => Promise<{
+    keyword: string;
+    text: string;
+} | null>;
+export declare const encodePngMetadata: ({ blob, metadata, }: {
+    blob: Blob;
+    metadata: string;
+}) => Promise<Blob>;
+export declare const decodePngMetadata: (blob: Blob) => Promise<string>;

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

@@ -0,0 +1,22 @@
+import type { ExcalidrawElement, ExcalidrawFrameLikeElement, NonDeletedExcalidrawElement } from "@excalidraw/element/types";
+import type { FileSystemHandle } from "./filesystem";
+import type { ExportType } from "../scene/types";
+import type { AppState, BinaryFiles } from "../types";
+export { loadFromBlob } from "./blob";
+export { loadFromJSON, saveAsJSON } from "./json";
+export type ExportedElements = readonly NonDeletedExcalidrawElement[] & {
+    _brand: "exportedElements";
+};
+export declare const prepareElementsForExport: (elements: readonly ExcalidrawElement[], { selectedElementIds }: Pick<AppState, "selectedElementIds">, exportSelectionOnly: boolean) => {
+    exportingFrame: ExcalidrawFrameLikeElement | null;
+    exportedElements: ExportedElements;
+};
+export declare const exportCanvas: (type: Omit<ExportType, "backend">, elements: ExportedElements, appState: AppState, files: BinaryFiles, { exportBackground, exportPadding, viewBackgroundColor, name, fileHandle, exportingFrame, }: {
+    exportBackground: boolean;
+    exportPadding?: number;
+    viewBackgroundColor: string;
+    /** filename, if applicable */
+    name?: string;
+    fileHandle?: FileSystemHandle | null;
+    exportingFrame: ExcalidrawFrameLikeElement | null;
+}) => Promise<FileSystemHandle | null | undefined>;

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

@@ -0,0 +1,18 @@
+import type { ExcalidrawElement } from "@excalidraw/element/types";
+import type { AppState, BinaryFiles, LibraryItems } from "../types";
+import type { ImportedDataState, ImportedLibraryData } from "./types";
+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, 
+/** filename */
+name?: string) => Promise<{
+    fileHandle: import("browser-fs-access").FileSystemHandle | null;
+}>;
+export declare const loadFromJSON: (localAppState: AppState, localElements: readonly ExcalidrawElement[] | null) => Promise<import("./restore").RestoredDataState>;
+export declare const isValidExcalidrawData: (data?: {
+    type?: any;
+    elements?: any;
+    appState?: any;
+}) => data is ImportedDataState;
+export declare const isValidLibrary: (json: any) => json is ImportedLibraryData;
+export declare const serializeLibraryAsJSON: (libraryItems: LibraryItems) => string;
+export declare const saveLibraryAsJSON: (libraryItems: LibraryItems) => Promise<void>;

package/dist/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/dist/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/dist/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/dist/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/dist/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"][];
+};