@excalidraw/excalidraw 0.17.0-a528769 → 0.17.0-fe75f29

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)>;

package/types/data/transform.d.ts

@@ -1,5 +1,5 @@
 import { ElementConstructorOpts } from "../element/newElement";
-import { ExcalidrawBindableElement, ExcalidrawElement, ExcalidrawEmbeddableElement, ExcalidrawFrameElement, ExcalidrawFreeDrawElement, ExcalidrawGenericElement, ExcalidrawImageElement, ExcalidrawLinearElement, ExcalidrawSelectionElement, ExcalidrawTextElement, FileId, FontFamilyValues, TextAlign, VerticalAlign } from "../element/types";
+import { ExcalidrawBindableElement, ExcalidrawElement, ExcalidrawFrameElement, ExcalidrawFreeDrawElement, ExcalidrawGenericElement, ExcalidrawIframeLikeElement, ExcalidrawImageElement, ExcalidrawLinearElement, ExcalidrawMagicFrameElement, ExcalidrawSelectionElement, ExcalidrawTextElement, FileId, FontFamilyValues, TextAlign, VerticalAlign } from "../element/types";
 import { MarkOptional } from "../utility-types";
 export type ValidLinearElement = {
     type: "arrow" | "line";
@@ -13,11 +13,11 @@ export type ValidLinearElement = {
         verticalAlign?: VerticalAlign;
     } & MarkOptional<ElementConstructorOpts, "x" | "y">;
     end?: (({
-        type: Exclude<ExcalidrawBindableElement["type"], "image" | "text" | "frame" | "embeddable">;
+        type: Exclude<ExcalidrawBindableElement["type"], "image" | "text" | "frame" | "magicframe" | "embeddable" | "iframe">;
         id?: ExcalidrawGenericElement["id"];
     } | {
         id: ExcalidrawGenericElement["id"];
-        type?: Exclude<ExcalidrawBindableElement["type"], "image" | "text" | "frame" | "embeddable">;
+        type?: Exclude<ExcalidrawBindableElement["type"], "image" | "text" | "frame" | "magicframe" | "embeddable" | "iframe">;
     }) | (({
         type: "text";
         text: string;
@@ -27,11 +27,11 @@ export type ValidLinearElement = {
         text: string;
     }) & Partial<ExcalidrawTextElement>)) & MarkOptional<ElementConstructorOpts, "x" | "y">;
     start?: (({
-        type: Exclude<ExcalidrawBindableElement["type"], "image" | "text" | "frame" | "embeddable">;
+        type: Exclude<ExcalidrawBindableElement["type"], "image" | "text" | "frame" | "magicframe" | "embeddable" | "iframe">;
         id?: ExcalidrawGenericElement["id"];
     } | {
         id: ExcalidrawGenericElement["id"];
-        type?: Exclude<ExcalidrawBindableElement["type"], "image" | "text" | "frame" | "embeddable">;
+        type?: Exclude<ExcalidrawBindableElement["type"], "image" | "text" | "frame" | "magicframe" | "embeddable" | "iframe">;
     }) | (({
         type: "text";
         text: string;
@@ -52,7 +52,7 @@ export type ValidContainer = {
         verticalAlign?: VerticalAlign;
     } & MarkOptional<ElementConstructorOpts, "x" | "y">;
 } & ElementConstructorOpts;
-export type ExcalidrawElementSkeleton = Extract<Exclude<ExcalidrawElement, ExcalidrawSelectionElement>, ExcalidrawEmbeddableElement | ExcalidrawFreeDrawElement> | ({
+export type ExcalidrawElementSkeleton = Extract<Exclude<ExcalidrawElement, ExcalidrawSelectionElement>, ExcalidrawIframeLikeElement | ExcalidrawFreeDrawElement> | ({
     type: Extract<ExcalidrawLinearElement["type"], "line">;
     x: number;
     y: number;
@@ -71,7 +71,11 @@ export type ExcalidrawElementSkeleton = Extract<Exclude<ExcalidrawElement, Excal
     type: "frame";
     children: readonly ExcalidrawElement["id"][];
     name?: string;
-} & Partial<ExcalidrawFrameElement>);
+} & Partial<ExcalidrawFrameElement>) | ({
+    type: "magicframe";
+    children: readonly ExcalidrawElement["id"][];
+    name?: string;
+} & Partial<ExcalidrawMagicFrameElement>);
 export declare const convertToExcalidrawElements: (elementsSkeleton: ExcalidrawElementSkeleton[] | null, opts?: {
     regenerateIds: boolean;
 }) => ExcalidrawElement[];

package/types/element/ElementCanvasButtons.d.ts

@@ -0,0 +1,6 @@
+import { NonDeletedExcalidrawElement } from "./types";
+import "./ElementCanvasButtons.scss";
+export declare const ElementCanvasButtons: ({ children, element, }: {
+    children: React.ReactNode;
+    element: NonDeletedExcalidrawElement;
+}) => JSX.Element | null;

package/types/element/Hyperlink.d.ts

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

package/types/element/collision.d.ts

@@ -1,5 +1,5 @@
 import * as GA from "../ga";
-import { NonDeletedExcalidrawElement, ExcalidrawBindableElement, ExcalidrawElement, ExcalidrawRectangleElement, ExcalidrawEmbeddableElement, ExcalidrawDiamondElement, ExcalidrawTextElement, ExcalidrawEllipseElement, NonDeleted, ExcalidrawImageElement, ExcalidrawFrameElement } from "./types";
+import { NonDeletedExcalidrawElement, ExcalidrawBindableElement, ExcalidrawElement, ExcalidrawRectangleElement, ExcalidrawDiamondElement, ExcalidrawTextElement, ExcalidrawEllipseElement, NonDeleted, ExcalidrawImageElement, ExcalidrawFrameLikeElement, ExcalidrawIframeLikeElement } from "./types";
 import { FrameNameBoundsCache, Point } from "../types";
 import { AppState } from "../types";
 export declare const hitTest: (element: NonDeletedExcalidrawElement, appState: AppState, frameNameBoundsCache: FrameNameBoundsCache, x: number, y: number) => boolean;
@@ -18,4 +18,4 @@ export declare const determineFocusPoint: (element: ExcalidrawBindableElement, f
 export declare const intersectElementWithLine: (element: ExcalidrawBindableElement, a: readonly [number, number], b: readonly [number, number], gap?: number) => Point[];
 export declare const getCircleIntersections: (center: readonly [number, number, number, number, number, number, number, number], radius: number, line: readonly [number, number, number, number, number, number, number, number]) => GA.Point[];
 export declare const findFocusPointForEllipse: (ellipse: ExcalidrawEllipseElement, relativeDistance: number, point: readonly [number, number, number, number, number, number, number, number]) => readonly [number, number, number, number, number, number, number, number];
-export declare const findFocusPointForRectangulars: (element: ExcalidrawRectangleElement | ExcalidrawImageElement | ExcalidrawDiamondElement | ExcalidrawTextElement | ExcalidrawEmbeddableElement | ExcalidrawFrameElement, relativeDistance: number, point: readonly [number, number, number, number, number, number, number, number]) => readonly [number, number, number, number, number, number, number, number];
+export declare const findFocusPointForRectangulars: (element: ExcalidrawRectangleElement | ExcalidrawImageElement | ExcalidrawDiamondElement | ExcalidrawTextElement | ExcalidrawIframeLikeElement | ExcalidrawFrameLikeElement, relativeDistance: number, point: readonly [number, number, number, number, number, number, number, number]) => readonly [number, number, number, number, number, number, number, number];

package/types/element/embeddable.d.ts

@@ -1,21 +1,9 @@
 import { ExcalidrawProps } from "../types";
-import { ExcalidrawElement, ExcalidrawEmbeddableElement, NonDeletedExcalidrawElement, Theme } from "./types";
-type EmbeddedLink = ({
-    aspectRatio: {
-        w: number;
-        h: number;
-    };
-    warning?: string;
-} & ({
-    type: "video" | "generic";
-    link: string;
-} | {
-    type: "document";
-    srcdoc: (theme: Theme) => string;
-})) | null;
-export declare const getEmbedLink: (link: string | null | undefined) => EmbeddedLink;
-export declare const isEmbeddableOrLabel: (element: NonDeletedExcalidrawElement) => Boolean;
-export declare const createPlaceholderEmbeddableLabel: (element: ExcalidrawEmbeddableElement) => ExcalidrawElement;
+import { ExcalidrawElement, ExcalidrawIframeLikeElement, IframeData, NonDeletedExcalidrawElement } from "./types";
+export declare const createSrcDoc: (body: string) => string;
+export declare const getEmbedLink: (link: string | null | undefined) => IframeData | null;
+export declare const isIframeLikeOrItsLabel: (element: NonDeletedExcalidrawElement) => Boolean;
+export declare const createPlaceholderEmbeddableLabel: (element: ExcalidrawIframeLikeElement) => ExcalidrawElement;
 export declare const actionSetEmbeddableAsActiveTool: {
     name: "setEmbeddableAsActiveTool";
     trackEvent: {
@@ -47,7 +35,7 @@ export declare const actionSetEmbeddableAsActiveTool: {
             isBindingEnabled: boolean;
             startBoundElement: import("./types").NonDeleted<import("./types").ExcalidrawBindableElement> | null;
             suggestedBindings: import("./binding").SuggestedBinding[];
-            frameToHighlight: import("./types").NonDeleted<import("./types").ExcalidrawFrameElement> | null;
+            frameToHighlight: import("./types").NonDeleted<import("./types").ExcalidrawFrameLikeElement> | null;
             frameRendering: {
                 enabled: boolean;
                 name: boolean;
@@ -94,7 +82,15 @@ export declare const actionSetEmbeddableAsActiveTool: {
                 name: string;
                 tab?: string | undefined;
             } | null;
-            openDialog: "mermaid" | "imageExport" | "help" | "jsonExport" | null;
+            openDialog: {
+                name: "imageExport" | "help" | "jsonExport";
+            } | {
+                name: "magicSettings";
+                source: "tool" | "generation" | "settings";
+            } | {
+                name: "ttd";
+                tab: string;
+            } | null;
             defaultSidebarDockedPreference: boolean;
             lastPointerDownWith: import("./types").PointerType;
             selectedElementIds: Readonly<{
@@ -111,7 +107,7 @@ export declare const actionSetEmbeddableAsActiveTool: {
                 duration?: number | undefined;
             } | null;
             zenModeEnabled: boolean;
-            theme: Theme;
+            theme: import("./types").Theme;
             gridSize: number | null;
             viewModeEnabled: boolean;
             selectedGroupIds: {
@@ -150,4 +146,3 @@ export declare const actionSetEmbeddableAsActiveTool: {
 };
 export declare const extractSrc: (htmlString: string) => string;
 export declare const embeddableURLValidator: (url: string | null | undefined, validateEmbeddable: ExcalidrawProps["validateEmbeddable"]) => boolean;
-export {};

package/types/element/index.d.ts

@@ -1,4 +1,4 @@
-import { ExcalidrawElement, NonDeletedExcalidrawElement, NonDeleted, ExcalidrawFrameElement } from "./types";
+import { ExcalidrawElement, NonDeletedExcalidrawElement, NonDeleted } from "./types";
 export { newElement, newTextElement, updateTextElement, refreshTextDimensions, newLinearElement, newImageElement, duplicateElement, } from "./newElement";
 export { getElementAbsoluteCoords, getElementBounds, getCommonBounds, getDiamondPoints, getArrowheadPoints, getClosestElementBounds, } from "./bounds";
 export { OMIT_SIDES_FOR_MULTIPLE_ELEMENTS, getTransformHandlesFromCoords, getTransformHandles, } from "./transformHandles";
@@ -6,15 +6,14 @@ export { hitTest, isHittingElementBoundingBoxWithoutHittingElement, } from "./co
 export { resizeTest, getCursorForResizingElement, getElementWithTransformHandleType, getTransformHandleTypeFromCoords, } from "./resizeTest";
 export { transformElements, getResizeOffsetXY, getResizeArrowDirection, } from "./resizeElements";
 export { dragSelectedElements, getDragOffsetXY, dragNewElement, } from "./dragElements";
-export { isTextElement, isExcalidrawElement, isFrameElement, } from "./typeChecks";
+export { isTextElement, isExcalidrawElement } from "./typeChecks";
 export { textWysiwyg } from "./textWysiwyg";
 export { redrawTextBoundingBox } from "./textElement";
 export { getPerfectElementSize, getLockedLinearCursorAlignSize, isInvisiblySmallElement, resizePerfectLineForNWHandler, getNormalizedDimensions, } from "./sizeHelpers";
 export { showSelectedShapeActions } from "./showSelectedShapeActions";
 export declare const getSceneVersion: (elements: readonly ExcalidrawElement[]) => number;
 export declare const getVisibleElements: (elements: readonly ExcalidrawElement[]) => readonly NonDeletedExcalidrawElement[];
-export declare const getNonDeletedElements: (elements: readonly ExcalidrawElement[]) => readonly NonDeletedExcalidrawElement[];
-export declare const getNonDeletedFrames: (frames: readonly ExcalidrawFrameElement[]) => readonly NonDeleted<ExcalidrawFrameElement>[];
+export declare const getNonDeletedElements: <T extends ExcalidrawElement>(elements: readonly T[]) => readonly NonDeleted<T>[];
 export declare const isNonDeletedElement: <T extends ExcalidrawElement>(element: T) => element is NonDeleted<T>;
 export declare const clearElementsForDatabase: (elements: readonly ExcalidrawElement[]) => ExcalidrawElement[];
 export declare const clearElementsForExport: (elements: readonly ExcalidrawElement[]) => ExcalidrawElement[];

package/types/element/linearElementEditor.d.ts

@@ -126,7 +126,7 @@ export declare class LinearElementEditor {
             contextMenu: {
                 items: import("../components/ContextMenu").ContextMenuItems;
                 top: number;
-                left: number;
+                left: number; /** @returns whether point was dragged */
             } | null;
             showWelcomeScreen: boolean;
             isLoading: boolean;
@@ -142,7 +142,7 @@ export declare class LinearElementEditor {
             isBindingEnabled: boolean;
             startBoundElement: NonDeleted<ExcalidrawBindableElement> | null;
             suggestedBindings: import("./binding").SuggestedBinding[];
-            frameToHighlight: NonDeleted<import("./types").ExcalidrawFrameElement> | null;
+            frameToHighlight: NonDeleted<import("./types").ExcalidrawFrameLikeElement> | null;
             frameRendering: {
                 enabled: boolean;
                 name: boolean;
@@ -192,7 +192,15 @@ export declare class LinearElementEditor {
                 name: string;
                 tab?: string | undefined;
             } | null;
-            openDialog: "mermaid" | "imageExport" | "help" | "jsonExport" | null;
+            openDialog: {
+                name: "imageExport" | "help" | "jsonExport";
+            } | {
+                name: "magicSettings";
+                source: "tool" | "generation" | "settings";
+            } | {
+                name: "ttd";
+                tab: string;
+            } | null;
             defaultSidebarDockedPreference: boolean;
             lastPointerDownWith: import("./types").PointerType;
             selectedElementIds: Readonly<{

package/types/element/newElement.d.ts

@@ -1,4 +1,4 @@
-import { ExcalidrawElement, ExcalidrawImageElement, ExcalidrawTextElement, ExcalidrawLinearElement, ExcalidrawGenericElement, NonDeleted, TextAlign, GroupId, VerticalAlign, Arrowhead, ExcalidrawFreeDrawElement, FontFamilyValues, ExcalidrawTextContainer, ExcalidrawFrameElement, ExcalidrawEmbeddableElement } from "../element/types";
+import { ExcalidrawElement, ExcalidrawImageElement, ExcalidrawTextElement, ExcalidrawLinearElement, ExcalidrawGenericElement, NonDeleted, TextAlign, GroupId, VerticalAlign, Arrowhead, ExcalidrawFreeDrawElement, FontFamilyValues, ExcalidrawTextContainer, ExcalidrawFrameElement, ExcalidrawEmbeddableElement, ExcalidrawMagicFrameElement, ExcalidrawIframeElement } from "../element/types";
 import { AppState } from "../types";
 import { MarkOptional, Mutable } from "../utility-types";
 export type ElementConstructorOpts = MarkOptional<Omit<ExcalidrawGenericElement, "id" | "type" | "isDeleted" | "updated">, "width" | "height" | "angle" | "groupIds" | "frameId" | "boundElements" | "seed" | "version" | "versionNonce" | "link" | "strokeStyle" | "fillStyle" | "strokeColor" | "backgroundColor" | "roughness" | "strokeWidth" | "roundness" | "locked" | "opacity">;
@@ -9,9 +9,15 @@ export declare const newEmbeddableElement: (opts: {
     type: "embeddable";
     validated: ExcalidrawEmbeddableElement["validated"];
 } & ElementConstructorOpts) => NonDeleted<ExcalidrawEmbeddableElement>;
+export declare const newIframeElement: (opts: {
+    type: "iframe";
+} & ElementConstructorOpts) => NonDeleted<ExcalidrawIframeElement>;
 export declare const newFrameElement: (opts: {
     name?: string;
 } & ElementConstructorOpts) => NonDeleted<ExcalidrawFrameElement>;
+export declare const newMagicFrameElement: (opts: {
+    name?: string;
+} & ElementConstructorOpts) => NonDeleted<ExcalidrawMagicFrameElement>;
 export declare const newTextElement: (opts: {
     text: string;
     fontSize?: number;

package/types/element/textElement.d.ts

@@ -1,4 +1,4 @@
-import { ExcalidrawElement, ExcalidrawTextContainer, ExcalidrawTextElement, ExcalidrawTextElementWithContainer, FontFamilyValues, FontString, NonDeletedExcalidrawElement } from "./types";
+import { ExcalidrawElement, ExcalidrawElementType, ExcalidrawTextContainer, ExcalidrawTextElement, ExcalidrawTextElementWithContainer, FontFamilyValues, FontString, NonDeletedExcalidrawElement } from "./types";
 import { MaybeTransformHandleType } from "./transformHandles";
 import { AppState } from "../types";
 import { ExtractSetType } from "../utility-types";
@@ -66,7 +66,7 @@ export declare const suppportsHorizontalAlign: (selectedElements: NonDeletedExca
 export declare const getTextBindableContainerAtPosition: (elements: readonly ExcalidrawElement[], appState: AppState, x: number, y: number) => ExcalidrawTextContainer | null;
 declare const VALID_CONTAINER_TYPES: Set<string>;
 export declare const isValidTextContainer: (element: {
-    type: ExcalidrawElement["type"];
+    type: ExcalidrawElementType;
 }) => boolean;
 export declare const computeContainerDimensionForBoundText: (dimension: number, containerType: ExtractSetType<typeof VALID_CONTAINER_TYPES>) => number;
 export declare const getBoundTextMaxWidth: (container: ExcalidrawElement, boundTextElement?: ExcalidrawTextElement | null) => number;

package/types/element/typeChecks.d.ts

@@ -1,19 +1,22 @@
-import { AppState } from "../types";
+import { ElementOrToolType } from "../types";
 import { MarkNonNullable } from "../utility-types";
-import { ExcalidrawElement, ExcalidrawTextElement, ExcalidrawEmbeddableElement, ExcalidrawLinearElement, ExcalidrawBindableElement, ExcalidrawGenericElement, ExcalidrawFreeDrawElement, InitializedExcalidrawImageElement, ExcalidrawImageElement, ExcalidrawTextElementWithContainer, ExcalidrawTextContainer, ExcalidrawFrameElement, RoundnessType } from "./types";
-export declare const isGenericElement: (element: ExcalidrawElement | null) => element is ExcalidrawGenericElement;
+import { ExcalidrawElement, ExcalidrawTextElement, ExcalidrawEmbeddableElement, ExcalidrawLinearElement, ExcalidrawBindableElement, ExcalidrawFreeDrawElement, InitializedExcalidrawImageElement, ExcalidrawImageElement, ExcalidrawTextElementWithContainer, ExcalidrawTextContainer, ExcalidrawFrameElement, RoundnessType, ExcalidrawFrameLikeElement, ExcalidrawElementType, ExcalidrawIframeElement, ExcalidrawIframeLikeElement, ExcalidrawMagicFrameElement } from "./types";
 export declare const isInitializedImageElement: (element: ExcalidrawElement | null) => element is InitializedExcalidrawImageElement;
 export declare const isImageElement: (element: ExcalidrawElement | null) => element is ExcalidrawImageElement;
 export declare const isEmbeddableElement: (element: ExcalidrawElement | null | undefined) => element is ExcalidrawEmbeddableElement;
+export declare const isIframeElement: (element: ExcalidrawElement | null) => element is ExcalidrawIframeElement;
+export declare const isIframeLikeElement: (element: ExcalidrawElement | null) => element is ExcalidrawIframeLikeElement;
 export declare const isTextElement: (element: ExcalidrawElement | null) => element is ExcalidrawTextElement;
 export declare const isFrameElement: (element: ExcalidrawElement | null) => element is ExcalidrawFrameElement;
+export declare const isMagicFrameElement: (element: ExcalidrawElement | null) => element is ExcalidrawMagicFrameElement;
+export declare const isFrameLikeElement: (element: ExcalidrawElement | null) => element is ExcalidrawFrameLikeElement;
 export declare const isFreeDrawElement: (element?: ExcalidrawElement | null) => element is ExcalidrawFreeDrawElement;
-export declare const isFreeDrawElementType: (elementType: ExcalidrawElement["type"]) => boolean;
+export declare const isFreeDrawElementType: (elementType: ExcalidrawElementType) => boolean;
 export declare const isLinearElement: (element?: ExcalidrawElement | null) => element is ExcalidrawLinearElement;
 export declare const isArrowElement: (element?: ExcalidrawElement | null) => element is ExcalidrawLinearElement;
-export declare const isLinearElementType: (elementType: AppState["activeTool"]["type"]) => boolean;
+export declare const isLinearElementType: (elementType: ElementOrToolType) => boolean;
 export declare const isBindingElement: (element?: ExcalidrawElement | null, includeLocked?: boolean) => element is ExcalidrawLinearElement;
-export declare const isBindingElementType: (elementType: AppState["activeTool"]["type"]) => boolean;
+export declare const isBindingElementType: (elementType: ElementOrToolType) => boolean;
 export declare const isBindableElement: (element: ExcalidrawElement | null, includeLocked?: boolean) => element is ExcalidrawBindableElement;
 export declare const isTextBindableContainer: (element: ExcalidrawElement | null, includeLocked?: boolean) => element is ExcalidrawTextContainer;
 export declare const isExcalidrawElement: (element: any) => element is ExcalidrawElement;