@excalidraw/excalidraw 0.17.0-a528769 → 0.17.0-c7ee46e

package/types/types.d.ts

@@ -1,5 +1,6 @@
 import React from "react";
-import { PointerType, ExcalidrawLinearElement, NonDeletedExcalidrawElement, NonDeleted, TextAlign, ExcalidrawElement, GroupId, ExcalidrawBindableElement, Arrowhead, ChartType, FontFamilyValues, FileId, ExcalidrawImageElement, Theme, StrokeRoundness, ExcalidrawFrameElement, ExcalidrawEmbeddableElement } from "./element/types";
+import { PointerType, ExcalidrawLinearElement, NonDeletedExcalidrawElement, NonDeleted, TextAlign, ExcalidrawElement, GroupId, ExcalidrawBindableElement, Arrowhead, ChartType, FontFamilyValues, FileId, ExcalidrawImageElement, Theme, StrokeRoundness, ExcalidrawEmbeddableElement, ExcalidrawMagicFrameElement, ExcalidrawFrameLikeElement, ExcalidrawElementType } from "./element/types";
+import { Action } from "./actions/types";
 import { Point as RoughPoint } from "roughjs/bin/geometry";
 import { LinearElementEditor } from "./element/linearElementEditor";
 import { SuggestedBinding } from "./element/binding";
@@ -58,7 +59,8 @@ export type BinaryFileData = {
 };
 export type BinaryFileMetadata = Omit<BinaryFileData, "dataURL">;
 export type BinaryFiles = Record<ExcalidrawElement["id"], BinaryFileData>;
-export type ToolType = "selection" | "rectangle" | "diamond" | "ellipse" | "arrow" | "line" | "freedraw" | "text" | "image" | "eraser" | "hand" | "frame" | "embeddable" | "laser";
+export type ToolType = "selection" | "rectangle" | "diamond" | "ellipse" | "arrow" | "line" | "freedraw" | "text" | "image" | "eraser" | "hand" | "frame" | "magicframe" | "embeddable" | "laser";
+export type ElementOrToolType = ExcalidrawElementType | ToolType | "custom";
 export type ActiveTool = {
     type: ToolType;
     customType: null;
@@ -103,13 +105,11 @@ export type InteractiveCanvasAppState = Readonly<_CommonCanvasAppState & {
     suggestedBindings: AppState["suggestedBindings"];
     isRotating: AppState["isRotating"];
     elementsToHighlight: AppState["elementsToHighlight"];
-    openSidebar: AppState["openSidebar"];
-    showHyperlinkPopup: AppState["showHyperlinkPopup"];
     collaborators: AppState["collaborators"];
     snapLines: AppState["snapLines"];
     zenModeEnabled: AppState["zenModeEnabled"];
 }>;
-export type AppState = {
+export interface AppState {
     contextMenu: {
         items: ContextMenuItems;
         top: number;
@@ -129,7 +129,7 @@ export type AppState = {
     isBindingEnabled: boolean;
     startBoundElement: NonDeleted<ExcalidrawBindableElement> | null;
     suggestedBindings: SuggestedBinding[];
-    frameToHighlight: NonDeleted<ExcalidrawFrameElement> | null;
+    frameToHighlight: NonDeleted<ExcalidrawFrameLikeElement> | null;
     frameRendering: {
         enabled: boolean;
         name: boolean;
@@ -182,7 +182,7 @@ export type AppState = {
         name: SidebarName;
         tab?: SidebarTabName;
     } | null;
-    openDialog: "imageExport" | "help" | "jsonExport" | "mermaid" | null;
+    openDialog: "imageExport" | "help" | "jsonExport" | "mermaid" | "magicSettings" | null;
     /**
      * Reflects user preference for whether the default sidebar should be docked.
      *
@@ -241,7 +241,7 @@ export type AppState = {
         y: number;
     } | null;
     objectsSnapModeEnabled: boolean;
-};
+}
 export type UIAppState = Omit<AppState, "suggestedBindings" | "startBoundElement" | "cursorButton" | "scrollX" | "scrollY">;
 export type NormalizedZoomValue = number & {
     _brand: "normalizedZoom";
@@ -325,6 +325,7 @@ export interface ExcalidrawProps {
     children?: React.ReactNode;
     validateEmbeddable?: boolean | string[] | RegExp | RegExp[] | ((link: string) => boolean | undefined);
     renderEmbeddable?: (element: NonDeleted<ExcalidrawEmbeddableElement>, appState: AppState) => JSX.Element | null;
+    aiEnabled?: boolean;
 }
 export type SceneData = {
     elements?: ImportedDataState["elements"];
@@ -370,6 +371,7 @@ export type AppProps = Merge<ExcalidrawProps, {
     handleKeyboardGlobally: boolean;
     isCollaborating: boolean;
     children?: React.ReactNode;
+    aiEnabled: boolean;
 }>;
 /** A subset of App class properties that we need to use elsewhere
  * in the app, eg Manager. Factored out into a separate type to keep DRY. */
@@ -398,6 +400,8 @@ export type AppClassProperties = {
     togglePenMode: App["togglePenMode"];
     setActiveTool: App["setActiveTool"];
     setOpenDialog: App["setOpenDialog"];
+    insertEmbeddableElement: App["insertEmbeddableElement"];
+    onMagicButtonSelect: App["onMagicButtonSelect"];
 };
 export type PointerDownState = Readonly<{
     origin: Readonly<{
@@ -471,6 +475,7 @@ export type ExcalidrawImperativeAPI = {
     getSceneElements: InstanceType<typeof App>["getSceneElements"];
     getAppState: () => InstanceType<typeof App>["state"];
     getFiles: () => InstanceType<typeof App>["files"];
+    registerAction: (action: Action) => void;
     refresh: InstanceType<typeof App>["refresh"];
     setToast: InstanceType<typeof App>["setToast"];
     addFiles: (data: BinaryFileData[]) => void;
@@ -508,10 +513,10 @@ type FrameNameBounds = {
     angle: number;
 };
 export type FrameNameBoundsCache = {
-    get: (frameElement: ExcalidrawFrameElement) => FrameNameBounds | null;
+    get: (frameElement: ExcalidrawFrameLikeElement | ExcalidrawMagicFrameElement) => FrameNameBounds | null;
     _cache: Map<string, FrameNameBounds & {
         zoom: AppState["zoom"]["value"];
-        versionNonce: ExcalidrawFrameElement["versionNonce"];
+        versionNonce: ExcalidrawFrameLikeElement["versionNonce"];
     }>;
 };
 export type KeyboardModifiersObject = {
@@ -521,4 +526,5 @@ export type KeyboardModifiersObject = {
     metaKey: boolean;
 };
 export type Primitive = number | string | boolean | bigint | symbol | null | undefined;
+export type JSONValue = string | number | boolean | null | object;
 export {};

package/types/utils.d.ts

@@ -1,5 +1,5 @@
 import { EVENT } from "./constants";
-import { FontFamilyValues, FontString, NonDeletedExcalidrawElement } from "./element/types";
+import { FontFamilyValues, FontString } from "./element/types";
 import { ActiveTool, AppState, ToolType, Zoom } from "./types";
 export declare const setDateTimeForTests: (dateTime: string) => void;
 export declare const getDateTime: () => string;
@@ -186,7 +186,6 @@ export declare const isShallowEqual: <T extends Record<string, any>, I extends k
 export declare const composeEventHandlers: <E>(originalEventHandler?: ((event: E) => void) | undefined, ourEventHandler?: ((event: E) => void) | undefined, { checkForDefaultPrevented }?: {
     checkForDefaultPrevented?: boolean | undefined;
 }) => (event: E) => void;
-export declare const isOnlyExportingSingleFrame: (elements: readonly NonDeletedExcalidrawElement[]) => boolean;
 /**
  * supply `null` as message if non-never value is valid, you just need to
  * typecheck against it