@excalidraw/excalidraw 0.17.0-a528769 → 0.17.0-c7ee46e

package/types/actions/actionStyles.d.ts

@@ -28,7 +28,7 @@ export declare const actionCopyStyles: {
             isBindingEnabled: boolean;
             startBoundElement: import("../element/types").NonDeleted<import("../element/types").ExcalidrawBindableElement> | null;
             suggestedBindings: import("../element/binding").SuggestedBinding[];
-            frameToHighlight: import("../element/types").NonDeleted<import("../element/types").ExcalidrawFrameElement> | null;
+            frameToHighlight: import("../element/types").NonDeleted<import("../element/types").ExcalidrawFrameLikeElement> | null;
             frameRendering: {
                 enabled: boolean;
                 name: boolean;
@@ -79,7 +79,7 @@ export declare const actionCopyStyles: {
                 name: string;
                 tab?: string | undefined;
             } | null;
-            openDialog: "mermaid" | "imageExport" | "help" | "jsonExport" | null;
+            openDialog: "mermaid" | "magicSettings" | "imageExport" | "help" | "jsonExport" | null;
             defaultSidebarDockedPreference: boolean;
             lastPointerDownWith: import("../element/types").PointerType;
             selectedElementIds: Readonly<{

package/types/actions/actionToggleGridMode.d.ts

@@ -29,7 +29,7 @@ export declare const actionToggleGridMode: {
             isBindingEnabled: boolean;
             startBoundElement: import("../element/types").NonDeleted<import("../element/types").ExcalidrawBindableElement> | null;
             suggestedBindings: import("../element/binding").SuggestedBinding[];
-            frameToHighlight: import("../element/types").NonDeleted<import("../element/types").ExcalidrawFrameElement> | null;
+            frameToHighlight: import("../element/types").NonDeleted<import("../element/types").ExcalidrawFrameLikeElement> | null;
             frameRendering: {
                 enabled: boolean;
                 name: boolean;
@@ -80,7 +80,7 @@ export declare const actionToggleGridMode: {
                 name: string;
                 tab?: string | undefined;
             } | null;
-            openDialog: "mermaid" | "imageExport" | "help" | "jsonExport" | null;
+            openDialog: "mermaid" | "magicSettings" | "imageExport" | "help" | "jsonExport" | null;
             defaultSidebarDockedPreference: boolean;
             lastPointerDownWith: import("../element/types").PointerType;
             selectedElementIds: Readonly<{

package/types/actions/actionToggleObjectsSnapMode.d.ts

@@ -28,7 +28,7 @@ export declare const actionToggleObjectsSnapMode: {
             isBindingEnabled: boolean;
             startBoundElement: import("../element/types").NonDeleted<import("../element/types").ExcalidrawBindableElement> | null;
             suggestedBindings: import("../element/binding").SuggestedBinding[];
-            frameToHighlight: import("../element/types").NonDeleted<import("../element/types").ExcalidrawFrameElement> | null;
+            frameToHighlight: import("../element/types").NonDeleted<import("../element/types").ExcalidrawFrameLikeElement> | null;
             frameRendering: {
                 enabled: boolean;
                 name: boolean;
@@ -79,7 +79,7 @@ export declare const actionToggleObjectsSnapMode: {
                 name: string;
                 tab?: string | undefined;
             } | null;
-            openDialog: "mermaid" | "imageExport" | "help" | "jsonExport" | null;
+            openDialog: "mermaid" | "magicSettings" | "imageExport" | "help" | "jsonExport" | null;
             defaultSidebarDockedPreference: boolean;
             lastPointerDownWith: import("../element/types").PointerType;
             selectedElementIds: Readonly<{

package/types/actions/actionToggleStats.d.ts

@@ -26,7 +26,7 @@ export declare const actionToggleStats: {
             isBindingEnabled: boolean;
             startBoundElement: import("../element/types").NonDeleted<import("../element/types").ExcalidrawBindableElement> | null;
             suggestedBindings: import("../element/binding").SuggestedBinding[];
-            frameToHighlight: import("../element/types").NonDeleted<import("../element/types").ExcalidrawFrameElement> | null;
+            frameToHighlight: import("../element/types").NonDeleted<import("../element/types").ExcalidrawFrameLikeElement> | null;
             frameRendering: {
                 enabled: boolean;
                 name: boolean;
@@ -77,7 +77,7 @@ export declare const actionToggleStats: {
                 name: string;
                 tab?: string | undefined;
             } | null;
-            openDialog: "mermaid" | "imageExport" | "help" | "jsonExport" | null;
+            openDialog: "mermaid" | "magicSettings" | "imageExport" | "help" | "jsonExport" | null;
             defaultSidebarDockedPreference: boolean;
             lastPointerDownWith: import("../element/types").PointerType;
             selectedElementIds: Readonly<{

package/types/actions/actionToggleViewMode.d.ts

@@ -27,7 +27,7 @@ export declare const actionToggleViewMode: {
             isBindingEnabled: boolean;
             startBoundElement: import("../element/types").NonDeleted<import("../element/types").ExcalidrawBindableElement> | null;
             suggestedBindings: import("../element/binding").SuggestedBinding[];
-            frameToHighlight: import("../element/types").NonDeleted<import("../element/types").ExcalidrawFrameElement> | null;
+            frameToHighlight: import("../element/types").NonDeleted<import("../element/types").ExcalidrawFrameLikeElement> | null;
             frameRendering: {
                 enabled: boolean;
                 name: boolean;
@@ -78,7 +78,7 @@ export declare const actionToggleViewMode: {
                 name: string;
                 tab?: string | undefined;
             } | null;
-            openDialog: "mermaid" | "imageExport" | "help" | "jsonExport" | null;
+            openDialog: "mermaid" | "magicSettings" | "imageExport" | "help" | "jsonExport" | null;
             defaultSidebarDockedPreference: boolean;
             lastPointerDownWith: import("../element/types").PointerType;
             selectedElementIds: Readonly<{

package/types/actions/actionToggleZenMode.d.ts

@@ -27,7 +27,7 @@ export declare const actionToggleZenMode: {
             isBindingEnabled: boolean;
             startBoundElement: import("../element/types").NonDeleted<import("../element/types").ExcalidrawBindableElement> | null;
             suggestedBindings: import("../element/binding").SuggestedBinding[];
-            frameToHighlight: import("../element/types").NonDeleted<import("../element/types").ExcalidrawFrameElement> | null;
+            frameToHighlight: import("../element/types").NonDeleted<import("../element/types").ExcalidrawFrameLikeElement> | null;
             frameRendering: {
                 enabled: boolean;
                 name: boolean;
@@ -78,7 +78,7 @@ export declare const actionToggleZenMode: {
                 name: string;
                 tab?: string | undefined;
             } | null;
-            openDialog: "mermaid" | "imageExport" | "help" | "jsonExport" | null;
+            openDialog: "mermaid" | "magicSettings" | "imageExport" | "help" | "jsonExport" | null;
             defaultSidebarDockedPreference: boolean;
             lastPointerDownWith: import("../element/types").PointerType;
             selectedElementIds: Readonly<{

package/types/appState.d.ts

@@ -1,11 +1,12 @@
 import { AppState, NormalizedZoomValue } from "./types";
 export declare const getDefaultAppState: () => Omit<AppState, "offsetTop" | "offsetLeft" | "width" | "height">;
 export declare const clearAppStateForLocalStorage: (appState: Partial<AppState>) => {
+    theme?: import("./element/types").Theme | undefined;
+    showWelcomeScreen?: boolean | undefined;
     activeTool?: ({
         lastActiveTool: import("./types").ActiveTool | null;
         locked: boolean;
     } & import("./types").ActiveTool) | undefined;
-    showWelcomeScreen?: boolean | undefined;
     penMode?: boolean | undefined;
     penDetected?: boolean | undefined;
     exportBackground?: boolean | undefined;
@@ -49,7 +50,6 @@ export declare const clearAppStateForLocalStorage: (appState: Partial<AppState>)
     } | undefined;
     shouldCacheIgnoreZoom?: boolean | undefined;
     zenModeEnabled?: boolean | undefined;
-    theme?: import("./element/types").Theme | undefined;
     gridSize?: number | null | undefined;
     selectedGroupIds?: {
         [groupId: string]: boolean;

package/types/components/App.d.ts

@@ -4,7 +4,7 @@ import { ActionManager } from "../actions/manager";
 import { EXPORT_IMAGE_TYPES } from "../constants";
 import { ExportedElements } from "../data";
 import { LinearElementEditor } from "../element/linearElementEditor";
-import { ExcalidrawElement, NonDeleted, NonDeletedExcalidrawElement, ExcalidrawFrameElement } from "../element/types";
+import { ExcalidrawElement, NonDeleted, NonDeletedExcalidrawElement, ExcalidrawFrameLikeElement, ExcalidrawIframeElement } from "../element/types";
 import History from "../history";
 import Scene from "../scene/Scene";
 import { AppClassProperties, AppProps, AppState, ExcalidrawImperativeAPI, BinaryFiles, LibraryItems, SceneData, Device, FrameNameBoundsCache, SidebarName, SidebarTabName, ToolType } from "../types";
@@ -45,7 +45,6 @@ declare class App extends React.Component<AppProps, AppState> {
     actionManager: ActionManager;
     device: Device;
     private excalidrawContainerRef;
-    static defaultProps: Partial<AppProps>;
     scene: Scene;
     renderer: Renderer;
     private fonts;
@@ -210,10 +209,10 @@ declare class App extends React.Component<AppProps, AppState> {
     }>, event: PointerEvent]>;
     constructor(props: AppProps);
     private onWindowMessage;
-    private updateEmbeddableRef;
+    private cacheEmbeddableRef;
     private getHTMLIFrameElement;
     private handleEmbeddableCenterClick;
-    private isEmbeddableCenter;
+    private isIframeLikeElementCenter;
     private updateEmbeddables;
     private renderEmbeddables;
     private getFrameNameDOMId;
@@ -225,8 +224,18 @@ declare class App extends React.Component<AppProps, AppState> {
     getSceneElements: () => readonly NonDeletedExcalidrawElement[];
     onInsertElements: (elements: readonly ExcalidrawElement[]) => void;
     onExportImage: (type: keyof typeof EXPORT_IMAGE_TYPES, elements: ExportedElements, opts: {
-        exportingFrame: ExcalidrawFrameElement | null;
+        exportingFrame: ExcalidrawFrameLikeElement | null;
     }) => Promise<void>;
+    private magicGenerations;
+    private updateMagicGeneration;
+    private getTextFromElements;
+    private onMagicFrameGenerate;
+    private onIframeSrcCopy;
+    private OPENAI_KEY;
+    private OPENAI_KEY_IS_PERSISTED;
+    private onOpenAIKeyChange;
+    private onMagicSettingsConfirm;
+    onMagicButtonSelect: () => void;
     private openEyeDropper;
     private syncActionResult;
     private onBlur;
@@ -246,6 +255,8 @@ declare class App extends React.Component<AppProps, AppState> {
     componentWillUnmount(): void;
     private onResize;
     private removeEventListeners;
+    /** generally invoked only if fullscreen was invoked programmatically */
+    private onFullscreenChange;
     private addEventListeners;
     componentDidUpdate(prevProps: AppProps, prevState: AppState): void;
     private renderInteractiveSceneCallback;
@@ -386,7 +397,17 @@ declare class App extends React.Component<AppProps, AppState> {
     private isHittingCommonBoundingBoxOfSelectedElements;
     private handleTextOnPointerDown;
     private handleFreeDrawElementOnPointerDown;
-    private insertEmbeddableElement;
+    insertIframeElement: ({ sceneX, sceneY, width, height, }: {
+        sceneX: number;
+        sceneY: number;
+        width: number;
+        height: number;
+    }) => NonDeleted<ExcalidrawIframeElement>;
+    insertEmbeddableElement: ({ sceneX, sceneY, link, }: {
+        sceneX: number;
+        sceneY: number;
+        link: string;
+    }) => NonDeleted<import("../element/types").ExcalidrawEmbeddableElement> | undefined;
     private createImageElement;
     private handleLinearElementOnPointerDown;
     private getCurrentItemRoundness;

package/types/components/LayerUI.d.ts

@@ -25,6 +25,10 @@ interface LayerUIProps {
     children?: React.ReactNode;
     app: AppClassProperties;
     isCollaborating: boolean;
+    openAIKey: string | null;
+    isOpenAIKeyPersisted: boolean;
+    onOpenAIAPIKeyChange: (apiKey: string, shouldPersist: boolean) => void;
+    onMagicSettingsConfirm: (apiKey: string, shouldPersist: boolean) => void;
 }
-declare const _default: React.MemoExoticComponent<({ actionManager, appState, files, setAppState, elements, canvas, onLockToggle, onHandToolToggle, onPenModeToggle, showExitZenModeBtn, renderTopRightUI, renderCustomStats, UIOptions, onExportImage, renderWelcomeScreen, children, app, isCollaborating, }: LayerUIProps) => JSX.Element>;
+declare const _default: React.MemoExoticComponent<({ actionManager, appState, files, setAppState, elements, canvas, onLockToggle, onHandToolToggle, onPenModeToggle, showExitZenModeBtn, renderTopRightUI, renderCustomStats, UIOptions, onExportImage, renderWelcomeScreen, children, app, isCollaborating, openAIKey, isOpenAIKeyPersisted, onOpenAIAPIKeyChange, onMagicSettingsConfirm, }: LayerUIProps) => JSX.Element>;
 export default _default;

package/types/components/MagicButton.d.ts

@@ -0,0 +1,9 @@
+import "./ToolIcon.scss";
+export declare const ElementCanvasButton: (props: {
+    title?: string;
+    icon: JSX.Element;
+    name?: string;
+    checked: boolean;
+    onChange?(): void;
+    isMobile?: boolean;
+}) => JSX.Element;

package/types/components/MagicSettings.d.ts

@@ -0,0 +1,8 @@
+import "./MagicSettings.scss";
+export declare const MagicSettings: (props: {
+    openAIKey: string | null;
+    isPersisted: boolean;
+    onChange: (key: string, shouldPersist: boolean) => void;
+    onConfirm: (key: string, shouldPersist: boolean) => void;
+    onClose: () => void;
+}) => JSX.Element;

package/types/components/TextField.d.ts

@@ -0,0 +1,16 @@
+import { KeyboardEvent } from "react";
+import "./TextField.scss";
+type TextFieldProps = {
+    value?: string;
+    onChange?: (value: string) => void;
+    onClick?: () => void;
+    onKeyDown?: (event: KeyboardEvent<HTMLInputElement>) => void;
+    readonly?: boolean;
+    fullWidth?: boolean;
+    selectOnRender?: boolean;
+    label?: string;
+    placeholder?: string;
+    isPassword?: boolean;
+};
+export declare const TextField: import("react").ForwardRefExoticComponent<TextFieldProps & import("react").RefAttributes<HTMLInputElement>>;
+export {};

package/types/components/icons.d.ts

@@ -153,4 +153,9 @@ export declare const frameToolIcon: JSX.Element;
 export declare const mermaidLogoIcon: JSX.Element;
 export declare const ArrowRightIcon: JSX.Element;
 export declare const laserPointerToolIcon: JSX.Element;
+export declare const MagicIcon: JSX.Element;
+export declare const OpenAIIcon: JSX.Element;
+export declare const fullscreenIcon: JSX.Element;
+export declare const eyeIcon: JSX.Element;
+export declare const eyeClosedIcon: JSX.Element;
 export {};

package/types/constants.d.ts

@@ -63,7 +63,8 @@ export declare enum EVENT {
     SCROLL = "scroll",
     EXCALIDRAW_LINK = "excalidraw-link",
     MENU_ITEM_SELECT = "menu.itemSelect",
-    MESSAGE = "message"
+    MESSAGE = "message",
+    FULLSCREENCHANGE = "fullscreenchange"
 }
 export declare const YOUTUBE_STATES: {
     readonly UNSTARTED: -1;
@@ -242,4 +243,25 @@ export declare const DEFAULT_SIDEBAR: {
     readonly name: "default";
     readonly defaultTab: "library";
 };
-export declare const LIBRARY_DISABLED_TYPES: Set<"embeddable" | "image">;
+export declare const LIBRARY_DISABLED_TYPES: Set<"image" | "embeddable" | "iframe">;
+export declare const TOOL_TYPE: {
+    readonly selection: "selection";
+    readonly rectangle: "rectangle";
+    readonly diamond: "diamond";
+    readonly ellipse: "ellipse";
+    readonly arrow: "arrow";
+    readonly line: "line";
+    readonly freedraw: "freedraw";
+    readonly text: "text";
+    readonly image: "image";
+    readonly eraser: "eraser";
+    readonly hand: "hand";
+    readonly frame: "frame";
+    readonly magicframe: "magicframe";
+    readonly embeddable: "embeddable";
+    readonly laser: "laser";
+};
+export declare const EDITOR_LS_KEYS: {
+    readonly OAI_API_KEY: "excalidraw-oai-api-key";
+    readonly PUBLISH_LIBRARY: "publish-library-data";
+};

package/types/data/EditorLocalStorage.d.ts

@@ -0,0 +1,8 @@
+import { EDITOR_LS_KEYS } from "../constants";
+import { JSONValue } from "../types";
+export declare class EditorLocalStorage {
+    static has(key: typeof EDITOR_LS_KEYS[keyof typeof EDITOR_LS_KEYS]): boolean;
+    static get<T extends JSONValue>(key: typeof EDITOR_LS_KEYS[keyof typeof EDITOR_LS_KEYS]): T | null;
+    static set: (key: (typeof EDITOR_LS_KEYS)[keyof typeof EDITOR_LS_KEYS], value: JSONValue) => boolean;
+    static delete: (name: (typeof EDITOR_LS_KEYS)[keyof typeof EDITOR_LS_KEYS]) => void;
+}

package/types/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/types/data/index.d.ts

@@ -1,4 +1,4 @@
-import { ExcalidrawElement, ExcalidrawFrameElement, NonDeletedExcalidrawElement } from "../element/types";
+import { ExcalidrawElement, ExcalidrawFrameLikeElement, NonDeletedExcalidrawElement } from "../element/types";
 import { ExportType } from "../scene/types";
 import { AppState, BinaryFiles } from "../types";
 import { FileSystemHandle } from "./filesystem";
@@ -8,7 +8,7 @@ export type ExportedElements = readonly NonDeletedExcalidrawElement[] & {
     _brand: "exportedElements";
 };
 export declare const prepareElementsForExport: (elements: readonly ExcalidrawElement[], { selectedElementIds }: Pick<AppState, "selectedElementIds">, exportSelectionOnly: boolean) => {
-    exportingFrame: ExcalidrawFrameElement | null;
+    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, }: {
@@ -17,5 +17,5 @@ export declare const exportCanvas: (type: Omit<ExportType, "backend">, elements:
     viewBackgroundColor: string;
     name: string;
     fileHandle?: FileSystemHandle | null | undefined;
-    exportingFrame: ExcalidrawFrameElement | null;
+    exportingFrame: ExcalidrawFrameLikeElement | null;
 }) => Promise<FileSystemHandle | null | undefined>;

package/types/data/magic.d.ts

@@ -0,0 +1,23 @@
+import { Theme } from "../element/types";
+import { DataURL } from "../types";
+import { OpenAIOutput } from "./ai/types";
+export type MagicCacheData = {
+    status: "pending";
+} | {
+    status: "done";
+    html: string;
+} | {
+    status: "error";
+    message?: string;
+    code: "ERR_GENERATION_INTERRUPTED" | string;
+};
+export declare function diagramToHTML({ image, apiKey, text, theme, }: {
+    image: DataURL;
+    apiKey: string;
+    text: string;
+    theme?: Theme;
+}): Promise<({
+    ok: true;
+} & OpenAIOutput.ChatCompletion) | ({
+    ok: false;
+} & OpenAIOutput.APIError)>;