2.0.2-beta-1

Fixed some typos

docs/API/ExcalidrawAutomate.d.ts

@@ -0,0 +1,772 @@
+/// <reference types="react" />
+import ExcalidrawPlugin from "src/main";
+import { FillStyle, StrokeStyle, ExcalidrawElement, ExcalidrawBindableElement, FileId, NonDeletedExcalidrawElement, ExcalidrawImageElement, StrokeRoundness, RoundnessType } from "@zsviczian/excalidraw/types/element/types";
+import { Editor, OpenViewState, TFile, WorkspaceLeaf } from "obsidian";
+import * as obsidian_module from "obsidian";
+import ExcalidrawView, { ExportSettings } from "src/ExcalidrawView";
+import { AppState, BinaryFileData, DataURL, ExcalidrawImperativeAPI, Point } from "@zsviczian/excalidraw/types/types";
+import { EmbeddedFilesLoader } from "src/EmbeddedFileLoader";
+import { ConnectionPoint, DeviceType } from "src/types";
+import { ColorMaster } from "colormaster";
+import { TInput } from "colormaster/types";
+import { ClipboardData } from "@zsviczian/excalidraw/types/clipboard";
+import { PaneTarget } from "src/utils/ModifierkeyHelper";
+export declare class ExcalidrawAutomate {
+    /**
+     * Utility function that returns the Obsidian Module object.
+     */
+    get obsidian(): typeof obsidian_module;
+    get DEVICE(): DeviceType;
+    getAttachmentFilepath(filename: string): Promise<string>;
+    /**
+     * Prompts the user with a dialog to select new file action.
+     * - create markdown file
+     * - create excalidraw file
+     * - cancel action
+     * The new file will be relative to this.targetView.file.path, unless parentFile is provided.
+     * If shouldOpenNewFile is true, the new file will be opened in a workspace leaf.
+     * targetPane control which leaf will be used for the new file.
+     * Returns the TFile for the new file or null if the user cancelled the action.
+     * @param newFileNameOrPath
+     * @param shouldOpenNewFile
+     * @param targetPane //type PaneTarget = "active-pane"|"new-pane"|"popout-window"|"new-tab"|"md-properties";
+     * @param parentFile
+     * @returns
+     */
+    newFilePrompt(newFileNameOrPath: string, shouldOpenNewFile: boolean, targetPane?: PaneTarget, parentFile?: TFile): Promise<TFile | null>;
+    /**
+     * Generates a new Obsidian Leaf following Excalidraw plugin settings such as open in Main Workspace or not, open in adjacent pane if avaialble, etc.
+     * @param origo // the currently active leaf, the origin of the new leaf
+     * @param targetPane //type PaneTarget = "active-pane"|"new-pane"|"popout-window"|"new-tab"|"md-properties";
+     * @returns
+     */
+    getLeaf(origo: WorkspaceLeaf, targetPane?: PaneTarget): WorkspaceLeaf;
+    /**
+     * Returns the editor or leaf.view of the currently active embedded obsidian file.
+     * If view is not provided, ea.targetView is used.
+     * If the embedded file is a markdown document the function will return
+     * {file:TFile, editor:Editor} otherwise it will return {view:any}. You can check view type with view.getViewType();
+     * @param view
+     * @returns
+     */
+    getActiveEmbeddableViewOrEditor(view?: ExcalidrawView): {
+        view: any;
+    } | {
+        file: TFile;
+        editor: Editor;
+    } | null;
+    plugin: ExcalidrawPlugin;
+    elementsDict: {
+        [key: string]: any;
+    };
+    imagesDict: {
+        [key: FileId]: any;
+    };
+    mostRecentMarkdownSVG: SVGSVGElement;
+    style: {
+        strokeColor: string;
+        backgroundColor: string;
+        angle: number;
+        fillStyle: FillStyle;
+        strokeWidth: number;
+        strokeStyle: StrokeStyle;
+        roughness: number;
+        opacity: number;
+        strokeSharpness?: StrokeRoundness;
+        roundness: null | {
+            type: RoundnessType;
+            value?: number;
+        };
+        fontFamily: number;
+        fontSize: number;
+        textAlign: string;
+        verticalAlign: string;
+        startArrowHead: string;
+        endArrowHead: string;
+    };
+    canvas: {
+        theme: string;
+        viewBackgroundColor: string;
+        gridSize: number;
+    };
+    colorPalette: {};
+    constructor(plugin: ExcalidrawPlugin, view?: ExcalidrawView);
+    /**
+     *
+     * @returns the last recorded pointer position on the Excalidraw canvas
+     */
+    getViewLastPointerPosition(): {
+        x: number;
+        y: number;
+    };
+    /**
+     *
+     * @returns
+     */
+    getAPI(view?: ExcalidrawView): ExcalidrawAutomate;
+    /**
+     * @param val //0:"hachure", 1:"cross-hatch" 2:"solid"
+     * @returns
+     */
+    setFillStyle(val: number): "hachure" | "cross-hatch" | "solid";
+    /**
+     * @param val //0:"solid", 1:"dashed", 2:"dotted"
+     * @returns
+     */
+    setStrokeStyle(val: number): "solid" | "dashed" | "dotted";
+    /**
+     * @param val //0:"round", 1:"sharp"
+     * @returns
+     */
+    setStrokeSharpness(val: number): "round" | "sharp";
+    /**
+     * @param val //1: Virgil, 2:Helvetica, 3:Cascadia
+     * @returns
+     */
+    setFontFamily(val: number): "Virgil, Segoe UI Emoji" | "Helvetica, Segoe UI Emoji" | "Cascadia, Segoe UI Emoji" | "LocalFont";
+    /**
+     * @param val //0:"light", 1:"dark"
+     * @returns
+     */
+    setTheme(val: number): "light" | "dark";
+    /**
+     * @param objectIds
+     * @returns
+     */
+    addToGroup(objectIds: string[]): string;
+    /**
+     * @param templatePath
+     */
+    toClipboard(templatePath?: string): Promise<void>;
+    /**
+     * @param file: TFile
+     * @returns ExcalidrawScene
+     */
+    getSceneFromFile(file: TFile): Promise<{
+        elements: ExcalidrawElement[];
+        appState: AppState;
+    }>;
+    /**
+     * get all elements from ExcalidrawAutomate elementsDict
+     * @returns elements from elemenetsDict
+     */
+    getElements(): ExcalidrawElement[];
+    /**
+     * get single element from ExcalidrawAutomate elementsDict
+     * @param id
+     * @returns
+     */
+    getElement(id: string): ExcalidrawElement;
+    /**
+     * create a drawing and save it to filename
+     * @param params
+     *   filename: if null, default filename as defined in Excalidraw settings
+     *   foldername: if null, default folder as defined in Excalidraw settings
+     * @returns
+     */
+    create(params?: {
+        filename?: string;
+        foldername?: string;
+        templatePath?: string;
+        onNewPane?: boolean;
+        frontmatterKeys?: {
+            "excalidraw-plugin"?: "raw" | "parsed";
+            "excalidraw-link-prefix"?: string;
+            "excalidraw-link-brackets"?: boolean;
+            "excalidraw-url-prefix"?: string;
+            "excalidraw-export-transparent"?: boolean;
+            "excalidraw-export-dark"?: boolean;
+            "excalidraw-export-padding"?: number;
+            "excalidraw-export-pngscale"?: number;
+            "excalidraw-default-mode"?: "view" | "zen";
+            "excalidraw-onload-script"?: string;
+            "excalidraw-linkbutton-opacity"?: number;
+            "excalidraw-autoexport"?: boolean;
+        };
+        plaintext?: string;
+    }): Promise<string>;
+    /**
+     *
+     * @param templatePath
+     * @param embedFont
+     * @param exportSettings use ExcalidrawAutomate.getExportSettings(boolean,boolean)
+     * @param loader use ExcalidrawAutomate.getEmbeddedFilesLoader(boolean?)
+     * @param theme
+     * @returns
+     */
+    createSVG(templatePath?: string, embedFont?: boolean, exportSettings?: ExportSettings, loader?: EmbeddedFilesLoader, theme?: string, padding?: number): Promise<SVGSVGElement>;
+    /**
+     *
+     * @param templatePath
+     * @param scale
+     * @param exportSettings use ExcalidrawAutomate.getExportSettings(boolean,boolean)
+     * @param loader use ExcalidrawAutomate.getEmbeddedFilesLoader(boolean?)
+     * @param theme
+     * @returns
+     */
+    createPNG(templatePath?: string, scale?: number, exportSettings?: ExportSettings, loader?: EmbeddedFilesLoader, theme?: string, padding?: number): Promise<any>;
+    /**
+     *
+     * @param text
+     * @param lineLen
+     * @returns
+     */
+    wrapText(text: string, lineLen: number): string;
+    private boxedElement;
+    addIFrame(topX: number, topY: number, width: number, height: number, url?: string, file?: TFile): string;
+    /**
+   *
+   * @param topX
+   * @param topY
+   * @param width
+   * @param height
+   * @returns
+   */
+    addEmbeddable(topX: number, topY: number, width: number, height: number, url?: string, file?: TFile): string;
+    /**
+     *
+     * @param topX
+     * @param topY
+     * @param width
+     * @param height
+     * @returns
+     */
+    addRect(topX: number, topY: number, width: number, height: number): string;
+    /**
+     *
+     * @param topX
+     * @param topY
+     * @param width
+     * @param height
+     * @returns
+     */
+    addDiamond(topX: number, topY: number, width: number, height: number): string;
+    /**
+     *
+     * @param topX
+     * @param topY
+     * @param width
+     * @param height
+     * @returns
+     */
+    addEllipse(topX: number, topY: number, width: number, height: number): string;
+    /**
+     *
+     * @param topX
+     * @param topY
+     * @param width
+     * @param height
+     * @returns
+     */
+    addBlob(topX: number, topY: number, width: number, height: number): string;
+    /**
+     * Refresh the size of a text element to fit its contents
+     * @param id - the id of the text element
+     */
+    refreshTextElementSize(id: string): void;
+    /**
+     *
+     * @param topX
+     * @param topY
+     * @param text
+     * @param formatting
+     *   box: if !null, text will be boxed
+     * @param id
+     * @returns
+     */
+    addText(topX: number, topY: number, text: string, formatting?: {
+        wrapAt?: number;
+        width?: number;
+        height?: number;
+        textAlign?: "left" | "center" | "right";
+        box?: boolean | "box" | "blob" | "ellipse" | "diamond";
+        boxPadding?: number;
+        boxStrokeColor?: string;
+        textVerticalAlign?: "top" | "middle" | "bottom";
+    }, id?: string): string;
+    /**
+     *
+     * @param points
+     * @returns
+     */
+    addLine(points: [[x: number, y: number]]): string;
+    /**
+     *
+     * @param points
+     * @param formatting
+     * @returns
+     */
+    addArrow(points: [x: number, y: number][], formatting?: {
+        startArrowHead?: string;
+        endArrowHead?: string;
+        startObjectId?: string;
+        endObjectId?: string;
+    }): string;
+    /**
+     *
+     * @param topX
+     * @param topY
+     * @param imageFile
+     * @returns
+     */
+    addImage(topX: number, topY: number, imageFile: TFile | string, scale?: boolean, //default is true which will scale the image to MAX_IMAGE_SIZE, false will insert image at 100% of its size
+    anchor?: boolean): Promise<string>;
+    /**
+     *
+     * @param topX
+     * @param topY
+     * @param tex
+     * @returns
+     */
+    addLaTex(topX: number, topY: number, tex: string): Promise<string>;
+    /**
+     *
+     * @param objectA
+     * @param connectionA type ConnectionPoint = "top" | "bottom" | "left" | "right" | null
+     * @param objectB
+     * @param connectionB when passed null, Excalidraw will automatically decide
+     * @param formatting
+     *   numberOfPoints: points on the line. Default is 0 ie. line will only have a start and end point
+     *   startArrowHead: "triangle"|"dot"|"arrow"|"bar"|null
+     *   endArrowHead: "triangle"|"dot"|"arrow"|"bar"|null
+     *   padding:
+     * @returns
+     */
+    connectObjects(objectA: string, connectionA: ConnectionPoint | null, objectB: string, connectionB: ConnectionPoint | null, formatting?: {
+        numberOfPoints?: number;
+        startArrowHead?: "triangle" | "dot" | "arrow" | "bar" | null;
+        endArrowHead?: "triangle" | "dot" | "arrow" | "bar" | null;
+        padding?: number;
+    }): string;
+    /**
+     * Adds a text label to a line or arrow. Currently only works with a straight (2 point - start & end - line)
+     * @param lineId id of the line or arrow object in elementsDict
+     * @param label the label text
+     * @returns undefined (if unsuccessful) or the id of the new text element
+     */
+    addLabelToLine(lineId: string, label: string): string;
+    /**
+     * clear elementsDict and imagesDict only
+     */
+    clear(): void;
+    /**
+     * clear() + reset all style values to default
+     */
+    reset(): void;
+    /**
+     * returns true if MD file is an Excalidraw file
+     * @param f
+     * @returns
+     */
+    isExcalidrawFile(f: TFile): boolean;
+    targetView: ExcalidrawView;
+    /**
+     * sets the target view for EA. All the view operations and the access to Excalidraw API will be performend on this view
+     * if view is null or undefined, the function will first try setView("active"), then setView("first").
+     * @param view
+     * @returns targetView
+     */
+    setView(view?: ExcalidrawView | "first" | "active"): ExcalidrawView;
+    /**
+     *
+     * @returns https://github.com/excalidraw/excalidraw/tree/master/src/packages/excalidraw#ref
+     */
+    getExcalidrawAPI(): any;
+    /**
+     * get elements in View
+     * @returns
+     */
+    getViewElements(): ExcalidrawElement[];
+    /**
+     *
+     * @param elToDelete
+     * @returns
+     */
+    deleteViewElements(elToDelete: ExcalidrawElement[]): boolean;
+    /**
+     * get the selected element in the view, if more are selected, get the first
+     * @returns
+     */
+    getViewSelectedElement(): any;
+    /**
+     *
+     * @returns
+     */
+    getViewSelectedElements(): any[];
+    /**
+     *
+     * @param el
+     * @returns TFile file handle for the image element
+     */
+    getViewFileForImageElement(el: ExcalidrawElement): TFile | null;
+    /**
+     * copies elements from view to elementsDict for editing
+     * @param elements
+     */
+    copyViewElementsToEAforEditing(elements: ExcalidrawElement[]): void;
+    /**
+     *
+     * @param forceViewMode
+     * @returns
+     */
+    viewToggleFullScreen(forceViewMode?: boolean): void;
+    setViewModeEnabled(enabled: boolean): void;
+    /**
+     * This function gives you a more hands on access to Excalidraw.
+     * @param scene - The scene you want to load to Excalidraw
+     * @param restore - Use this if the scene includes legacy excalidraw file elements that need to be converted to the latest excalidraw data format (not a typical usecase)
+     * @returns
+     */
+    viewUpdateScene(scene: {
+        elements?: ExcalidrawElement[];
+        appState?: AppState;
+        files?: BinaryFileData;
+        commitToHistory?: boolean;
+    }, restore?: boolean): void;
+    /**
+     * connect an object to the selected element in the view
+     * @param objectA ID of the element
+     * @param connectionA
+     * @param connectionB
+     * @param formatting
+     * @returns
+     */
+    connectObjectWithViewSelectedElement(objectA: string, connectionA: ConnectionPoint | null, connectionB: ConnectionPoint | null, formatting?: {
+        numberOfPoints?: number;
+        startArrowHead?: "triangle" | "dot" | "arrow" | "bar" | null;
+        endArrowHead?: "triangle" | "dot" | "arrow" | "bar" | null;
+        padding?: number;
+    }): boolean;
+    /**
+     * zoom tarteView to fit elements provided as input
+     * elements === [] will zoom to fit the entire scene
+     * selectElements toggles whether the elements should be in a selected state at the end of the operation
+     * @param selectElements
+     * @param elements
+     */
+    viewZoomToElements(selectElements: boolean, elements: ExcalidrawElement[]): void;
+    /**
+     * Adds elements from elementsDict to the current view
+     * @param repositionToCursor default is false
+     * @param save default is true
+     * @param newElementsOnTop controls whether elements created with ExcalidrawAutomate
+     *   are added at the bottom of the stack or the top of the stack of elements already in the view
+     *   Note that elements copied to the view with copyViewElementsToEAforEditing retain their
+     *   position in the stack of elements in the view even if modified using EA
+     *   default is false, i.e. the new elements get to the bottom of the stack
+     * @param shouldRestoreElements - restore elements - auto-corrects broken, incomplete or old elements included in the update
+     * @returns
+     */
+    addElementsToView(repositionToCursor?: boolean, save?: boolean, newElementsOnTop?: boolean, shouldRestoreElements?: boolean): Promise<boolean>;
+    /**
+     * Register instance of EA to use for hooks with TargetView
+     * By default ExcalidrawViews will check window.ExcalidrawAutomate for event hooks.
+     * Using this event you can set a different instance of Excalidraw Automate for hooks
+     * @returns true if successful
+     */
+    registerThisAsViewEA(): boolean;
+    /**
+     * Sets the targetView EA to window.ExcalidrawAutomate
+     * @returns true if successful
+     */
+    deregisterThisAsViewEA(): boolean;
+    /**
+     * If set, this callback is triggered when the user closes an Excalidraw view.
+     */
+    onViewUnloadHook: (view: ExcalidrawView) => void;
+    /**
+     * If set, this callback is triggered, when the user changes the view mode.
+     * You can use this callback in case you want to do something additional when the user switches to view mode and back.
+     */
+    onViewModeChangeHook: (isViewModeEnabled: boolean, view: ExcalidrawView, ea: ExcalidrawAutomate) => void;
+    /**
+    * If set, this callback is triggered, when the user hovers a link in the scene.
+    * You can use this callback in case you want to do something additional when the onLinkHover event occurs.
+    * This callback must return a boolean value.
+    * In case you want to prevent the excalidraw onLinkHover action you must return false, it will stop the native excalidraw onLinkHover management flow.
+    */
+    onLinkHoverHook: (element: NonDeletedExcalidrawElement, linkText: string, view: ExcalidrawView, ea: ExcalidrawAutomate) => boolean;
+    /**
+    * If set, this callback is triggered, when the user clicks a link in the scene.
+    * You can use this callback in case you want to do something additional when the onLinkClick event occurs.
+    * This callback must return a boolean value.
+    * In case you want to prevent the excalidraw onLinkClick action you must return false, it will stop the native excalidraw onLinkClick management flow.
+    */
+    onLinkClickHook: (element: ExcalidrawElement, linkText: string, event: MouseEvent, view: ExcalidrawView, ea: ExcalidrawAutomate) => boolean;
+    /**
+     * If set, this callback is triggered, when Excalidraw receives an onDrop event.
+     * You can use this callback in case you want to do something additional when the onDrop event occurs.
+     * This callback must return a boolean value.
+     * In case you want to prevent the excalidraw onDrop action you must return false, it will stop the native excalidraw onDrop management flow.
+     */
+    onDropHook: (data: {
+        ea: ExcalidrawAutomate;
+        event: React.DragEvent<HTMLDivElement>;
+        draggable: any;
+        type: "file" | "text" | "unknown";
+        payload: {
+            files: TFile[];
+            text: string;
+        };
+        excalidrawFile: TFile;
+        view: ExcalidrawView;
+        pointerPosition: {
+            x: number;
+            y: number;
+        };
+    }) => boolean;
+    /**
+     * If set, this callback is triggered, when Excalidraw receives an onPaste event.
+     * You can use this callback in case you want to do something additional when the
+     * onPaste event occurs.
+     * This callback must return a boolean value.
+     * In case you want to prevent the excalidraw onPaste action you must return false,
+     * it will stop the native excalidraw onPaste management flow.
+     */
+    onPasteHook: (data: {
+        ea: ExcalidrawAutomate;
+        payload: ClipboardData;
+        event: ClipboardEvent;
+        excalidrawFile: TFile;
+        view: ExcalidrawView;
+        pointerPosition: {
+            x: number;
+            y: number;
+        };
+    }) => boolean;
+    /**
+     * if set, this callback is triggered, when an Excalidraw file is opened
+     * You can use this callback in case you want to do something additional when the file is opened.
+     * This will run before the file level script defined in the `excalidraw-onload-script` frontmatter.
+     */
+    onFileOpenHook: (data: {
+        ea: ExcalidrawAutomate;
+        excalidrawFile: TFile;
+        view: ExcalidrawView;
+    }) => Promise<void>;
+    /**
+     * if set, this callback is triggered, when an Excalidraw file is created
+     * see also: https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1124
+     */
+    onFileCreateHook: (data: {
+        ea: ExcalidrawAutomate;
+        excalidrawFile: TFile;
+        view: ExcalidrawView;
+    }) => Promise<void>;
+    /**
+     * If set, this callback is triggered whenever the active canvas color changes
+     */
+    onCanvasColorChangeHook: (ea: ExcalidrawAutomate, view: ExcalidrawView, //the excalidraw view 
+    color: string) => void;
+    /**
+     * utility function to generate EmbeddedFilesLoader object
+     * @param isDark
+     * @returns
+     */
+    getEmbeddedFilesLoader(isDark?: boolean): EmbeddedFilesLoader;
+    /**
+     * utility function to generate ExportSettings object
+     * @param withBackground
+     * @param withTheme
+     * @returns
+     */
+    getExportSettings(withBackground: boolean, withTheme: boolean): ExportSettings;
+    /**
+     * get bounding box of elements
+     * bounding box is the box encapsulating all of the elements completely
+     * @param elements
+     * @returns
+     */
+    getBoundingBox(elements: ExcalidrawElement[]): {
+        topX: number;
+        topY: number;
+        width: number;
+        height: number;
+    };
+    /**
+     * elements grouped by the highest level groups
+     * @param elements
+     * @returns
+     */
+    getMaximumGroups(elements: ExcalidrawElement[]): ExcalidrawElement[][];
+    /**
+     * gets the largest element from a group. useful when a text element is grouped with a box, and you want to connect an arrow to the box
+     * @param elements
+     * @returns
+     */
+    getLargestElement(elements: ExcalidrawElement[]): ExcalidrawElement;
+    /**
+     * @param element
+     * @param a
+     * @param b
+     * @param gap
+     * @returns 2 or 0 intersection points between line going through `a` and `b`
+     *   and the `element`, in ascending order of distance from `a`.
+     */
+    intersectElementWithLine(element: ExcalidrawBindableElement, a: readonly [number, number], b: readonly [number, number], gap?: number): Point[];
+    /**
+     * Gets the groupId for the group that contains all the elements, or null if such a group does not exist
+     * @param elements
+     * @returns null or the groupId
+     */
+    getCommonGroupForElements(elements: ExcalidrawElement[]): string;
+    /**
+     * Gets all the elements from elements[] that share one or more groupIds with element.
+     * @param element
+     * @param elements - typically all the non-deleted elements in the scene
+     * @returns
+     */
+    getElementsInTheSameGroupWithElement(element: ExcalidrawElement, elements: ExcalidrawElement[]): ExcalidrawElement[];
+    /**
+     * Gets all the elements from elements[] that are contained in the frame.
+     * @param element
+     * @param elements - typically all the non-deleted elements in the scene
+     * @returns
+     */
+    getElementsInFrame(frameElement: ExcalidrawElement, elements: ExcalidrawElement[]): ExcalidrawElement[];
+    /**
+     * See OCR plugin for example on how to use scriptSettings
+     * Set by the ScriptEngine
+     */
+    activeScript: string;
+    /**
+     *
+     * @returns script settings. Saves settings in plugin settings, under the activeScript key
+     */
+    getScriptSettings(): {};
+    /**
+     * sets script settings.
+     * @param settings
+     * @returns
+     */
+    setScriptSettings(settings: any): Promise<void>;
+    /**
+     * Open a file in a new workspaceleaf or reuse an existing adjacent leaf depending on Excalidraw Plugin Settings
+     * @param file
+     * @param openState - if not provided {active: true} will be used
+     * @returns
+     */
+    openFileInNewOrAdjacentLeaf(file: TFile, openState?: OpenViewState): WorkspaceLeaf;
+    /**
+     * measure text size based on current style settings
+     * @param text
+     * @returns
+     */
+    measureText(text: string): {
+        width: number;
+        height: number;
+    };
+    /**
+     * Returns the size of the image element at 100% (i.e. the original size)
+     * @param imageElement an image element from the active scene on targetView
+     */
+    getOriginalImageSize(imageElement: ExcalidrawImageElement): Promise<{
+        width: number;
+        height: number;
+    }>;
+    /**
+     * verifyMinimumPluginVersion returns true if plugin version is >= than required
+     * recommended use:
+     * if(!ea.verifyMinimumPluginVersion || !ea.verifyMinimumPluginVersion("1.5.20")) {new Notice("message");return;}
+     * @param requiredVersion
+     * @returns
+     */
+    verifyMinimumPluginVersion(requiredVersion: string): boolean;
+    /**
+     * Check if view is instance of ExcalidrawView
+     * @param view
+     * @returns
+     */
+    isExcalidrawView(view: any): boolean;
+    /**
+     * sets selection in view
+     * @param elements
+     * @returns
+     */
+    selectElementsInView(elements: ExcalidrawElement[] | string[]): void;
+    /**
+     * @returns an 8 character long random id
+     */
+    generateElementId(): string;
+    /**
+     * @param element
+     * @returns a clone of the element with a new id
+     */
+    cloneElement(element: ExcalidrawElement): ExcalidrawElement;
+    /**
+     * Moves the element to a specific position in the z-index
+     */
+    moveViewElementToZIndex(elementId: number, newZIndex: number): void;
+    /**
+     * Depricated. Use getCM / ColorMaster instead
+     * @param color
+     * @returns
+     */
+    hexStringToRgb(color: string): number[];
+    /**
+     * Depricated. Use getCM / ColorMaster instead
+     * @param color
+     * @returns
+     */
+    rgbToHexString(color: number[]): string;
+    /**
+     * Depricated. Use getCM / ColorMaster instead
+     * @param color
+     * @returns
+     */
+    hslToRgb(color: number[]): number[];
+    /**
+     * Depricated. Use getCM / ColorMaster instead
+     * @param color
+     * @returns
+     */
+    rgbToHsl(color: number[]): number[];
+    /**
+     *
+     * @param color
+     * @returns
+     */
+    colorNameToHex(color: string): string;
+    /**
+     * https://github.com/lbragile/ColorMaster
+     * @param color
+     * @returns
+     */
+    getCM(color: TInput): ColorMaster;
+    importSVG(svgString: string): boolean;
+}
+export declare function initExcalidrawAutomate(plugin: ExcalidrawPlugin): Promise<ExcalidrawAutomate>;
+export declare function destroyExcalidrawAutomate(): void;
+export declare function _measureText(newText: string, fontSize: number, fontFamily: number, lineHeight: number): {
+    w: number;
+    h: number;
+    baseline: number;
+};
+export declare const generatePlaceholderDataURL: (width: number, height: number) => DataURL;
+export declare function createPNG(templatePath: string, scale: number, exportSettings: ExportSettings, loader: EmbeddedFilesLoader, forceTheme: string, canvasTheme: string, canvasBackgroundColor: string, automateElements: ExcalidrawElement[], plugin: ExcalidrawPlugin, depth: number, padding?: number, imagesDict?: any): Promise<Blob>;
+export declare function createSVG(templatePath: string, embedFont: boolean, exportSettings: ExportSettings, loader: EmbeddedFilesLoader, forceTheme: string, canvasTheme: string, canvasBackgroundColor: string, automateElements: ExcalidrawElement[], plugin: ExcalidrawPlugin, depth: number, padding?: number, imagesDict?: any, convertMarkdownLinksToObsidianURLs?: boolean): Promise<SVGSVGElement>;
+export declare function estimateBounds(elements: ExcalidrawElement[]): [number, number, number, number];
+export declare function repositionElementsToCursor(elements: ExcalidrawElement[], newPosition: {
+    x: number;
+    y: number;
+}, center: boolean, api: ExcalidrawImperativeAPI): ExcalidrawElement[];
+export declare const insertLaTeXToView: (view: ExcalidrawView) => void;
+export declare const search: (view: ExcalidrawView) => Promise<void>;
+/**
+ *
+ * @param elements
+ * @param query
+ * @param exactMatch - when searching for section header exactMatch should be set to true
+ * @returns the elements matching the query
+ */
+export declare const getTextElementsMatchingQuery: (elements: ExcalidrawElement[], query: string[], exactMatch?: boolean) => ExcalidrawElement[];
+/**
+ *
+ * @param elements
+ * @param query
+ * @param exactMatch - when searching for section header exactMatch should be set to true
+ * @returns the elements matching the query
+ */
+export declare const getFrameElementsMatchingQuery: (elements: ExcalidrawElement[], query: string[], exactMatch?: boolean) => ExcalidrawElement[];
+export declare const cloneElement: (el: ExcalidrawElement) => any;
+export declare const verifyMinimumPluginVersion: (requiredVersion: string) => boolean;

docs/API/attributes_functions_overview.md

@@ -2,36 +2,110 @@
 ## Attributes and functions overview
 Here's the interface implemented by ExcalidrawAutomate:
 
-```typescript
-export declare class ExcalidrawAutomate implements ExcalidrawAutomateInterface {
-  plugin: ExcalidrawPlugin;
-  targetView: ExcalidrawView = null; //the view currently edited
-  elementsDict: {[key:string]:any}; //contains the ExcalidrawElements currently edited in Automate indexed by el.id
-  imagesDict: {[key: FileId]: any}; //the images files including DataURL, indexed by fileId
-  mostRecentMarkdownSVG:SVGSVGElement = null; //Markdown renderer will drop a copy of the most recent SVG here for debugging purposes
-  style: {
-    strokeColor: string; //https://www.w3schools.com/colors/default.asp
-    backgroundColor: string;
-    angle: number; //radian
-    fillStyle: FillStyle; //type FillStyle = "hachure" | "cross-hatch" | "solid"
-    strokeWidth: number;
-    strokeStyle: StrokeStyle; //type StrokeStyle = "solid" | "dashed" | "dotted"
-    roughness: number;
-    opacity: number;
-    strokeSharpness: StrokeSharpness; //type StrokeSharpness = "round" | "sharp"
-    fontFamily: number; //1: Virgil, 2:Helvetica, 3:Cascadia, 4:LocalFont
-    fontSize: number;
-    textAlign: string; //"left"|"right"|"center"
-    verticalAlign: string; //"top"|"bottom"|"middle" :for future use, has no effect currently
-    startArrowHead: string; //"triangle"|"dot"|"arrow"|"bar"|null
-    endArrowHead: string;
-  };
-  canvas: {
-    theme: string; //"dark"|"light"
-    viewBackgroundColor: string;
-    gridSize: number;
-  };
+You can find the source file here: [ExcalidrawAutomate.d.ts](ExcalidrawAutomate.d.ts).
+
+```javascript
+/// <reference types="react" />
+import ExcalidrawPlugin from "src/main";
+import { FillStyle, StrokeStyle, ExcalidrawElement, ExcalidrawBindableElement, FileId, NonDeletedExcalidrawElement, ExcalidrawImageElement, StrokeRoundness, RoundnessType } from "@zsviczian/excalidraw/types/element/types";
+import { Editor, OpenViewState, TFile, WorkspaceLeaf } from "obsidian";
+import * as obsidian_module from "obsidian";
+import ExcalidrawView, { ExportSettings } from "src/ExcalidrawView";
+import { AppState, BinaryFileData, DataURL, ExcalidrawImperativeAPI, Point } from "@zsviczian/excalidraw/types/types";
+import { EmbeddedFilesLoader } from "src/EmbeddedFileLoader";
+import { ConnectionPoint, DeviceType } from "src/types";
+import { ColorMaster } from "colormaster";
+import { TInput } from "colormaster/types";
+import { ClipboardData } from "@zsviczian/excalidraw/types/clipboard";
+import { PaneTarget } from "src/utils/ModifierkeyHelper";
+export declare class ExcalidrawAutomate {
+    /**
+     * Utility function that returns the Obsidian Module object.
+     */
+    get obsidian(): typeof obsidian_module;
+    get DEVICE(): DeviceType;
+    getAttachmentFilepath(filename: string): Promise<string>;
+    /**
+     * Prompts the user with a dialog to select new file action.
+     * - create markdown file
+     * - create excalidraw file
+     * - cancel action
+     * The new file will be relative to this.targetView.file.path, unless parentFile is provided.
+     * If shouldOpenNewFile is true, the new file will be opened in a workspace leaf.
+     * targetPane control which leaf will be used for the new file.
+     * Returns the TFile for the new file or null if the user cancelled the action.
+     * @param newFileNameOrPath
+     * @param shouldOpenNewFile
+     * @param targetPane //type PaneTarget = "active-pane"|"new-pane"|"popout-window"|"new-tab"|"md-properties";
+     * @param parentFile
+     * @returns
+     */
+    newFilePrompt(newFileNameOrPath: string, shouldOpenNewFile: boolean, targetPane?: PaneTarget, parentFile?: TFile): Promise<TFile | null>;
+    /**
+     * Generates a new Obsidian Leaf following Excalidraw plugin settings such as open in Main Workspace or not, open in adjacent pane if avaialble, etc.
+     * @param origo // the currently active leaf, the origin of the new leaf
+     * @param targetPane //type PaneTarget = "active-pane"|"new-pane"|"popout-window"|"new-tab"|"md-properties";
+     * @returns
+     */
+    getLeaf(origo: WorkspaceLeaf, targetPane?: PaneTarget): WorkspaceLeaf;
+    /**
+     * Returns the editor or leaf.view of the currently active embedded obsidian file.
+     * If view is not provided, ea.targetView is used.
+     * If the embedded file is a markdown document the function will return
+     * {file:TFile, editor:Editor} otherwise it will return {view:any}. You can check view type with view.getViewType();
+     * @param view
+     * @returns
+     */
+    getActiveEmbeddableViewOrEditor(view?: ExcalidrawView): {
+        view: any;
+    } | {
+        file: TFile;
+        editor: Editor;
+    } | null;
+    plugin: ExcalidrawPlugin;
+    elementsDict: {
+        [key: string]: any;
+    };
+    imagesDict: {
+        [key: FileId]: any;
+    };
+    mostRecentMarkdownSVG: SVGSVGElement;
+    style: {
+        strokeColor: string;
+        backgroundColor: string;
+        angle: number;
+        fillStyle: FillStyle;
+        strokeWidth: number;
+        strokeStyle: StrokeStyle;
+        roughness: number;
+        opacity: number;
+        strokeSharpness?: StrokeRoundness;
+        roundness: null | {
+            type: RoundnessType;
+            value?: number;
+        };
+        fontFamily: number;
+        fontSize: number;
+        textAlign: string;
+        verticalAlign: string;
+        startArrowHead: string;
+        endArrowHead: string;
+    };
+    canvas: {
+        theme: string;
+        viewBackgroundColor: string;
+        gridSize: number;
+    };
+    colorPalette: {};
     constructor(plugin: ExcalidrawPlugin, view?: ExcalidrawView);
+    /**
+     *
+     * @returns the last recorded pointer position on the Excalidraw canvas
+     */
+    getViewLastPointerPosition(): {
+        x: number;
+        y: number;
+    };
     /**
      *
      * @returns
@@ -71,6 +145,14 @@ export declare class ExcalidrawAutomate implements ExcalidrawAutomateInterface {
      * @param templatePath
      */
     toClipboard(templatePath?: string): Promise<void>;
+    /**
+     * @param file: TFile
+     * @returns ExcalidrawScene
+     */
+    getSceneFromFile(file: TFile): Promise<{
+        elements: ExcalidrawElement[];
+        appState: AppState;
+    }>;
     /**
      * get all elements from ExcalidrawAutomate elementsDict
      * @returns elements from elemenetsDict
@@ -101,10 +183,14 @@ export declare class ExcalidrawAutomate implements ExcalidrawAutomateInterface {
             "excalidraw-url-prefix"?: string;
             "excalidraw-export-transparent"?: boolean;
             "excalidraw-export-dark"?: boolean;
-            "excalidraw-export-svgpadding"?: number;
+            "excalidraw-export-padding"?: number;
             "excalidraw-export-pngscale"?: number;
             "excalidraw-default-mode"?: "view" | "zen";
+            "excalidraw-onload-script"?: string;
+            "excalidraw-linkbutton-opacity"?: number;
+            "excalidraw-autoexport"?: boolean;
         };
+        plaintext?: string;
     }): Promise<string>;
     /**
      *
@@ -134,6 +220,16 @@ export declare class ExcalidrawAutomate implements ExcalidrawAutomateInterface {
      */
     wrapText(text: string, lineLen: number): string;
     private boxedElement;
+    addIFrame(topX: number, topY: number, width: number, height: number, url?: string, file?: TFile): string;
+    /**
+   *
+   * @param topX
+   * @param topY
+   * @param width
+   * @param height
+   * @returns
+   */
+    addEmbeddable(topX: number, topY: number, width: number, height: number, url?: string, file?: TFile): string;
     /**
      *
      * @param topX
@@ -170,6 +266,11 @@ export declare class ExcalidrawAutomate implements ExcalidrawAutomateInterface {
      * @returns
      */
     addBlob(topX: number, topY: number, width: number, height: number): string;
+    /**
+     * Refresh the size of a text element to fit its contents
+     * @param id - the id of the text element
+     */
+    refreshTextElementSize(id: string): void;
     /**
      *
      * @param topX
@@ -184,9 +285,11 @@ export declare class ExcalidrawAutomate implements ExcalidrawAutomateInterface {
         wrapAt?: number;
         width?: number;
         height?: number;
-        textAlign?: string;
+        textAlign?: "left" | "center" | "right";
         box?: boolean | "box" | "blob" | "ellipse" | "diamond";
         boxPadding?: number;
+        boxStrokeColor?: string;
+        textVerticalAlign?: "top" | "middle" | "bottom";
     }, id?: string): string;
     /**
      *
@@ -213,7 +316,8 @@ export declare class ExcalidrawAutomate implements ExcalidrawAutomateInterface {
      * @param imageFile
      * @returns
      */
-    addImage(topX: number, topY: number, imageFile: TFile): Promise<string>;
+    addImage(topX: number, topY: number, imageFile: TFile | string, scale?: boolean, //default is true which will scale the image to MAX_IMAGE_SIZE, false will insert image at 100% of its size
+    anchor?: boolean): Promise<string>;
     /**
      *
      * @param topX
@@ -262,12 +366,14 @@ export declare class ExcalidrawAutomate implements ExcalidrawAutomateInterface {
      * @returns
      */
     isExcalidrawFile(f: TFile): boolean;
+    targetView: ExcalidrawView;
     /**
-     *
+     * sets the target view for EA. All the view operations and the access to Excalidraw API will be performend on this view
+     * if view is null or undefined, the function will first try setView("active"), then setView("first").
      * @param view
-     * @returns
+     * @returns targetView
      */
-    setView(view: ExcalidrawView | "first" | "active"): ExcalidrawView;
+    setView(view?: ExcalidrawView | "first" | "active"): ExcalidrawView;
     /**
      *
      * @returns https://github.com/excalidraw/excalidraw/tree/master/src/packages/excalidraw#ref
@@ -311,6 +417,19 @@ export declare class ExcalidrawAutomate implements ExcalidrawAutomateInterface {
      * @returns
      */
     viewToggleFullScreen(forceViewMode?: boolean): void;
+    setViewModeEnabled(enabled: boolean): void;
+    /**
+     * This function gives you a more hands on access to Excalidraw.
+     * @param scene - The scene you want to load to Excalidraw
+     * @param restore - Use this if the scene includes legacy excalidraw file elements that need to be converted to the latest excalidraw data format (not a typical usecase)
+     * @returns
+     */
+    viewUpdateScene(scene: {
+        elements?: ExcalidrawElement[];
+        appState?: AppState;
+        files?: BinaryFileData;
+        commitToHistory?: boolean;
+    }, restore?: boolean): void;
     /**
      * connect an object to the selected element in the view
      * @param objectA ID of the element
@@ -325,6 +444,14 @@ export declare class ExcalidrawAutomate implements ExcalidrawAutomateInterface {
         endArrowHead?: "triangle" | "dot" | "arrow" | "bar" | null;
         padding?: number;
     }): boolean;
+    /**
+     * zoom tarteView to fit elements provided as input
+     * elements === [] will zoom to fit the entire scene
+     * selectElements toggles whether the elements should be in a selected state at the end of the operation
+     * @param selectElements
+     * @param elements
+     */
+    viewZoomToElements(selectElements: boolean, elements: ExcalidrawElement[]): void;
     /**
      * Adds elements from elementsDict to the current view
      * @param repositionToCursor default is false
@@ -334,9 +461,10 @@ export declare class ExcalidrawAutomate implements ExcalidrawAutomateInterface {
      *   Note that elements copied to the view with copyViewElementsToEAforEditing retain their
      *   position in the stack of elements in the view even if modified using EA
      *   default is false, i.e. the new elements get to the bottom of the stack
+     * @param shouldRestoreElements - restore elements - auto-corrects broken, incomplete or old elements included in the update
      * @returns
      */
-    addElementsToView(repositionToCursor?: boolean, save?: boolean, newElementsOnTop?: boolean): Promise<boolean>;
+    addElementsToView(repositionToCursor?: boolean, save?: boolean, newElementsOnTop?: boolean, shouldRestoreElements?: boolean): Promise<boolean>;
     /**
      * Register instance of EA to use for hooks with TargetView
      * By default ExcalidrawViews will check window.ExcalidrawAutomate for event hooks.
@@ -362,7 +490,7 @@ export declare class ExcalidrawAutomate implements ExcalidrawAutomateInterface {
     * If set, this callback is triggered, when the user hovers a link in the scene.
     * You can use this callback in case you want to do something additional when the onLinkHover event occurs.
     * This callback must return a boolean value.
-    * In case you want to prevent the excalidraw onLinkHover action you must return true, it will stop the native excalidraw onLinkHover management flow.
+    * In case you want to prevent the excalidraw onLinkHover action you must return false, it will stop the native excalidraw onLinkHover management flow.
     */
     onLinkHoverHook: (element: NonDeletedExcalidrawElement, linkText: string, view: ExcalidrawView, ea: ExcalidrawAutomate) => boolean;
     /**
@@ -394,6 +522,49 @@ export declare class ExcalidrawAutomate implements ExcalidrawAutomateInterface {
             y: number;
         };
     }) => boolean;
+    /**
+     * If set, this callback is triggered, when Excalidraw receives an onPaste event.
+     * You can use this callback in case you want to do something additional when the
+     * onPaste event occurs.
+     * This callback must return a boolean value.
+     * In case you want to prevent the excalidraw onPaste action you must return false,
+     * it will stop the native excalidraw onPaste management flow.
+     */
+    onPasteHook: (data: {
+        ea: ExcalidrawAutomate;
+        payload: ClipboardData;
+        event: ClipboardEvent;
+        excalidrawFile: TFile;
+        view: ExcalidrawView;
+        pointerPosition: {
+            x: number;
+            y: number;
+        };
+    }) => boolean;
+    /**
+     * if set, this callback is triggered, when an Excalidraw file is opened
+     * You can use this callback in case you want to do something additional when the file is opened.
+     * This will run before the file level script defined in the `excalidraw-onload-script` frontmatter.
+     */
+    onFileOpenHook: (data: {
+        ea: ExcalidrawAutomate;
+        excalidrawFile: TFile;
+        view: ExcalidrawView;
+    }) => Promise<void>;
+    /**
+     * if set, this callback is triggered, when an Excalidraw file is created
+     * see also: https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1124
+     */
+    onFileCreateHook: (data: {
+        ea: ExcalidrawAutomate;
+        excalidrawFile: TFile;
+        view: ExcalidrawView;
+    }) => Promise<void>;
+    /**
+     * If set, this callback is triggered whenever the active canvas color changes
+     */
+    onCanvasColorChangeHook: (ea: ExcalidrawAutomate, view: ExcalidrawView, //the excalidraw view 
+    color: string) => void;
     /**
      * utility function to generate EmbeddedFilesLoader object
      * @param isDark
@@ -431,6 +602,15 @@ export declare class ExcalidrawAutomate implements ExcalidrawAutomateInterface {
      * @returns
      */
     getLargestElement(elements: ExcalidrawElement[]): ExcalidrawElement;
+    /**
+     * @param element
+     * @param a
+     * @param b
+     * @param gap
+     * @returns 2 or 0 intersection points between line going through `a` and `b`
+     *   and the `element`, in ascending order of distance from `a`.
+     */
+    intersectElementWithLine(element: ExcalidrawBindableElement, a: readonly [number, number], b: readonly [number, number], gap?: number): Point[];
     /**
      * Gets the groupId for the group that contains all the elements, or null if such a group does not exist
      * @param elements
@@ -445,14 +625,12 @@ export declare class ExcalidrawAutomate implements ExcalidrawAutomateInterface {
      */
     getElementsInTheSameGroupWithElement(element: ExcalidrawElement, elements: ExcalidrawElement[]): ExcalidrawElement[];
     /**
+     * Gets all the elements from elements[] that are contained in the frame.
      * @param element
-     * @param a
-     * @param b
-     * @param gap
-     * @returns 2 or 0 intersection points between line going through `a` and `b`
-     *   and the `element`, in ascending order of distance from `a`.
+     * @param elements - typically all the non-deleted elements in the scene
+     * @returns
      */
-    intersectElementWithLine(element: ExcalidrawBindableElement, a: readonly [number, number], b: readonly [number, number], gap?: number): Point[];
+    getElementsInFrame(frameElement: ExcalidrawElement, elements: ExcalidrawElement[]): ExcalidrawElement[];
     /**
      * See OCR plugin for example on how to use scriptSettings
      * Set by the ScriptEngine
@@ -472,9 +650,10 @@ export declare class ExcalidrawAutomate implements ExcalidrawAutomateInterface {
     /**
      * Open a file in a new workspaceleaf or reuse an existing adjacent leaf depending on Excalidraw Plugin Settings
      * @param file
+     * @param openState - if not provided {active: true} will be used
      * @returns
      */
-    openFileInNewOrAdjacentLeaf(file: TFile): WorkspaceLeaf;
+    openFileInNewOrAdjacentLeaf(file: TFile, openState?: OpenViewState): WorkspaceLeaf;
     /**
      * measure text size based on current style settings
      * @param text
@@ -484,6 +663,14 @@ export declare class ExcalidrawAutomate implements ExcalidrawAutomateInterface {
         width: number;
         height: number;
     };
+    /**
+     * Returns the size of the image element at 100% (i.e. the original size)
+     * @param imageElement an image element from the active scene on targetView
+     */
+    getOriginalImageSize(imageElement: ExcalidrawImageElement): Promise<{
+        width: number;
+        height: number;
+    }>;
     /**
      * verifyMinimumPluginVersion returns true if plugin version is >= than required
      * recommended use:
@@ -503,7 +690,7 @@ export declare class ExcalidrawAutomate implements ExcalidrawAutomateInterface {
      * @param elements
      * @returns
      */
-    selectElementsInView(elements: ExcalidrawElement[]): void;
+    selectElementsInView(elements: ExcalidrawElement[] | string[]): void;
     /**
      * @returns an 8 character long random id
      */
@@ -518,25 +705,25 @@ export declare class ExcalidrawAutomate implements ExcalidrawAutomateInterface {
      */
     moveViewElementToZIndex(elementId: number, newZIndex: number): void;
     /**
-     *
+     * Depricated. Use getCM / ColorMaster instead
      * @param color
      * @returns
      */
     hexStringToRgb(color: string): number[];
     /**
-     *
+     * Depricated. Use getCM / ColorMaster instead
      * @param color
      * @returns
      */
     rgbToHexString(color: number[]): string;
     /**
-     *
+     * Depricated. Use getCM / ColorMaster instead
      * @param color
      * @returns
      */
     hslToRgb(color: number[]): number[];
     /**
-     *
+     * Depricated. Use getCM / ColorMaster instead
      * @param color
      * @returns
      */
@@ -547,5 +734,47 @@ export declare class ExcalidrawAutomate implements ExcalidrawAutomateInterface {
      * @returns
      */
     colorNameToHex(color: string): string;
-}```
-
+    /**
+     * https://github.com/lbragile/ColorMaster
+     * @param color
+     * @returns
+     */
+    getCM(color: TInput): ColorMaster;
+    importSVG(svgString: string): boolean;
+}
+export declare function initExcalidrawAutomate(plugin: ExcalidrawPlugin): Promise<ExcalidrawAutomate>;
+export declare function destroyExcalidrawAutomate(): void;
+export declare function _measureText(newText: string, fontSize: number, fontFamily: number, lineHeight: number): {
+    w: number;
+    h: number;
+    baseline: number;
+};
+export declare const generatePlaceholderDataURL: (width: number, height: number) => DataURL;
+export declare function createPNG(templatePath: string, scale: number, exportSettings: ExportSettings, loader: EmbeddedFilesLoader, forceTheme: string, canvasTheme: string, canvasBackgroundColor: string, automateElements: ExcalidrawElement[], plugin: ExcalidrawPlugin, depth: number, padding?: number, imagesDict?: any): Promise<Blob>;
+export declare function createSVG(templatePath: string, embedFont: boolean, exportSettings: ExportSettings, loader: EmbeddedFilesLoader, forceTheme: string, canvasTheme: string, canvasBackgroundColor: string, automateElements: ExcalidrawElement[], plugin: ExcalidrawPlugin, depth: number, padding?: number, imagesDict?: any, convertMarkdownLinksToObsidianURLs?: boolean): Promise<SVGSVGElement>;
+export declare function estimateBounds(elements: ExcalidrawElement[]): [number, number, number, number];
+export declare function repositionElementsToCursor(elements: ExcalidrawElement[], newPosition: {
+    x: number;
+    y: number;
+}, center: boolean, api: ExcalidrawImperativeAPI): ExcalidrawElement[];
+export declare const insertLaTeXToView: (view: ExcalidrawView) => void;
+export declare const search: (view: ExcalidrawView) => Promise<void>;
+/**
+ *
+ * @param elements
+ * @param query
+ * @param exactMatch - when searching for section header exactMatch should be set to true
+ * @returns the elements matching the query
+ */
+export declare const getTextElementsMatchingQuery: (elements: ExcalidrawElement[], query: string[], exactMatch?: boolean) => ExcalidrawElement[];
+/**
+ *
+ * @param elements
+ * @param query
+ * @param exactMatch - when searching for section header exactMatch should be set to true
+ * @returns the elements matching the query
+ */
+export declare const getFrameElementsMatchingQuery: (elements: ExcalidrawElement[], query: string[], exactMatch?: boolean) => ExcalidrawElement[];
+export declare const cloneElement: (el: ExcalidrawElement) => any;
+export declare const verifyMinimumPluginVersion: (requiredVersion: string) => boolean;
+```

ea-scripts/Slideshow.md

@@ -288,7 +288,7 @@ let busy = false;
 const scrollToNextRect = async ({left,top,right,bottom,nextZoom},steps = TRANSITION_STEP_COUNT) => {
   const startTimer = Date.now();
   let watchdog = 0;
-  while(busy && watchdog++<15) await(100);
+  while(busy && watchdog++<15) await sleep(100);
   if(busy && watchdog >= 15) return;
   busy = true;
   excalidrawAPI.updateScene({appState:{shouldCacheIgnoreZoom:true}});
@@ -746,4 +746,4 @@ if(window.ExcalidrawSlideshow && (window.ExcalidrawSlideshow.script === utils.sc
     timestamp
   };
   window.ExcalidrawSlideshowStartTimer = window.setTimeout(start,500);
-}
+}

manifest-beta.json

@@ -1,7 +1,7 @@
 {
 	"id": "obsidian-excalidraw-plugin",
 	"name": "Excalidraw",
-	"version": "1.9.19.2",
+	"version": "2.0.1-beta.1",
 	"minAppVersion": "1.1.6",
 	"description": "An Obsidian plugin to edit and view Excalidraw drawings",
 	"author": "Zsolt Viczian",

manifest.json

@@ -1,11 +1,12 @@
 {
   "id": "obsidian-excalidraw-plugin",
   "name": "Excalidraw",
-  "version": "1.9.26",
+  "version": "2.0.1",
   "minAppVersion": "1.1.6",
   "description": "An Obsidian plugin to edit and view Excalidraw drawings",
   "author": "Zsolt Viczian",
   "authorUrl": "https://zsolt.blog",
   "fundingUrl": "https://ko-fi.com/zsolt",
+  "helpUrl": "https://github.com/zsviczian/obsidian-excalidraw-plugin#readme",
   "isDesktopOnly": false
 }

package.json

@@ -18,7 +18,7 @@
   "author": "",
   "license": "MIT",
   "dependencies": {
-    "@zsviczian/excalidraw": "0.16.1-obsidian-6",
+    "@zsviczian/excalidraw": "0.16.1-obsidian-8",
     "chroma-js": "^2.4.2",
     "clsx": "^2.0.0",
     "colormaster": "^1.2.1",

src/EmbeddedFileLoader.ts

@@ -5,7 +5,11 @@ import { ExcalidrawElement, ExcalidrawImageElement, FileId } from "@zsviczian/ex
 import { BinaryFileData, DataURL } from "@zsviczian/excalidraw/types/types";
 import { App, MarkdownRenderer, Notice, TFile } from "obsidian";
 import {
+  ASSISTANT_FONT,
   CASCADIA_FONT,
+  VIRGIL_FONT,
+} from "./constFonts";
+import {  
   DEFAULT_MD_EMBED_CSS,
   fileid,
   FRONTMATTER_KEY_BORDERCOLOR,
@@ -15,7 +19,6 @@ import {
   IMAGE_TYPES,
   nanoid,
   THEME_FILTER,
-  VIRGIL_FONT,
 } from "./constants";
 import { createSVG } from "./ExcalidrawAutomate";
 import { ExcalidrawData, getTransclusion } from "./ExcalidrawData";
@@ -39,7 +42,6 @@ import {
   svgToBase64,
 } from "./utils/Utils";
 import { ValueOf } from "./types";
-import { has } from "./svgToExcalidraw/attributes";
 import { getMermaidImageElements, getMermaidText, shouldRenderMermaid } from "./utils/MermaidUtils";
 import { mermaidToExcalidraw } from "src/constants";
 
@@ -106,8 +108,12 @@ const replaceSVGColors = (svg: SVGSVGElement | string, colorMap: ColorMap | null
     for (const [oldColor, newColor] of Object.entries(colorMap)) {
       const fillRegex = new RegExp(`fill="${oldColor}"`, 'gi');
       svg = svg.replaceAll(fillRegex, `fill="${newColor}"`);
+      const fillStyleRegex = new RegExp(`fill:${oldColor}`, 'gi');
+      svg = svg.replaceAll(fillStyleRegex, `fill:${newColor}`);
       const strokeRegex = new RegExp(`stroke="${oldColor}"`, 'gi');
       svg = svg.replaceAll(strokeRegex, `stroke="${newColor}"`);
+      const strokeStyleRegex = new RegExp(`stroke:${oldColor}`, 'gi');
+      svg = svg.replaceAll(strokeStyleRegex, `stroke:${newColor}`);
     }
     return svg;
   }
@@ -594,7 +600,7 @@ export class EmbeddedFilesLoader {
           continue;
         }
         const data = getMermaidText(element);
-        const result = await mermaidToExcalidraw(data, {fontSize: 20});
+        const result = await mermaidToExcalidraw(data, {fontSize: 20}, true);
         if(!result) {
           continue;
         }
@@ -740,6 +746,9 @@ export class EmbeddedFilesLoader {
       case "Cascadia":
         fontDef = CASCADIA_FONT;
         break;
+      case "Assistant": 
+        fontDef = ASSISTANT_FONT;
+        break;
       case "":
         fontDef = "";
         break;

src/ExcalidrawAutomate.ts

@@ -80,6 +80,7 @@ import { emulateKeysForLinkClick, KeyEvent, PaneTarget } from "src/utils/Modifie
 import { Mutable } from "@zsviczian/excalidraw/types/utility-types";
 import PolyBool from "polybooljs";
 import { compressToBase64, decompressFromBase64 } from "lz-string";
+import { EmbeddableMDCustomProps } from "./dialogs/EmbeddableSettings";
 
 extendPlugins([
   HarmonyPlugin,
@@ -109,6 +110,10 @@ export class ExcalidrawAutomate {
     return obsidian_module;
   };
 
+  get LASERPOINTER() {
+    return this.plugin.settings.laserSettings;
+  }
+
   get DEVICE():DeviceType {
     return DEVICE;
   }
@@ -721,6 +726,7 @@ export class ExcalidrawAutomate {
     w: number,
     h: number,
     link: string | null = null,
+    scale?: [number, number],
   ) {
     return {
       id,
@@ -751,6 +757,7 @@ export class ExcalidrawAutomate {
       boundElements: [] as any,
       link,
       locked: false,
+      ...scale ? {scale} : {},
     };
   }
 
@@ -766,7 +773,15 @@ export class ExcalidrawAutomate {
  * @param height 
  * @returns 
  */
-  public addEmbeddable(topX: number, topY: number, width: number, height: number, url?: string, file?: TFile): string {
+  public addEmbeddable(
+    topX: number,
+    topY: number,
+    width: number,
+    height: number,
+    url?: string,
+    file?: TFile,
+    embeddableCustomData?: EmbeddableMDCustomProps,
+  ): string {
     //@ts-ignore
     if (!this.targetView || !this.targetView?._loaded) {
       errorMessage("targetView not set", "addEmbeddable()");
@@ -793,7 +808,9 @@ export class ExcalidrawAutomate {
           false, //file.extension === "md", //changed this to false because embedable link navigation in ExcaliBrain
         )
       }]]` : "",
+      [1,1],
     );
+    this.elementsDict[id].customData = {mdProps: embeddableCustomData ?? this.plugin.settings.embeddableMarkdownDefaults};
     return id;
   };
 
@@ -1552,11 +1569,7 @@ export class ExcalidrawAutomate {
       errorMessage("targetView not set", "getViewElements()");
       return [];
     }
-    const api = this.targetView.excalidrawAPI;
-    if (!api) {
-      return [];
-    }
-    return api.getSceneElements();
+    return this.targetView.getViewElements();
   };
 
   /**
@@ -1570,12 +1583,12 @@ export class ExcalidrawAutomate {
       errorMessage("targetView not set", "deleteViewElements()");
       return false;
     }
-    const current = this.targetView?.excalidrawRef?.current;
-    if (!current) {
+    const api = this.targetView?.excalidrawAPI as ExcalidrawImperativeAPI;
+    if (!api) {
       return false;
     }
-    const el: ExcalidrawElement[] = current.getSceneElements();
-    const st: AppState = current.getAppState();
+    const el: ExcalidrawElement[] = api.getSceneElements() as ExcalidrawElement[];
+    const st: AppState = api.getAppState();
     this.targetView.updateScene({
       elements: el.filter((e: ExcalidrawElement) => !elToDelete.includes(e)),
       appState: st,
@@ -2599,12 +2612,12 @@ export async function createPNG(
   );
 }
 
-const updateElementLinksToObsidianLinks = ({elements, hostFile}:{
+export const updateElementLinksToObsidianLinks = ({elements, hostFile}:{
   elements: ExcalidrawElement[];
   hostFile: TFile;
 }): ExcalidrawElement[] => {
   return elements.map((el)=>{
-    if(el.type!=="embeddable" && el.link && el.link.startsWith("[")) {
+    if(el.link && el.link.startsWith("[")) {
       const partsArray = REGEX_LINK.getResList(el.link)[0];
       if(!partsArray?.value) return el;
       let linkText = REGEX_LINK.getLink(partsArray);
@@ -2692,6 +2705,7 @@ export async function createSVG(
       withTheme,
     },
     padding,
+    null,
   );
 
   if (withTheme && theme === "dark") addFilterToForeignObjects(svg);

src/ExcalidrawData.ts

@@ -293,8 +293,18 @@ export class ExcalidrawData {
 
       if (el.boundElements) {
         const map = new Map<string, string>();
+        let alreadyHasText:boolean = false;
         el.boundElements.forEach((item: { id: string; type: string }) => {
-          map.set(item.id, item.type);
+          if(item.type === "text") {
+            if(!alreadyHasText) {
+              map.set(item.id, item.type);
+              alreadyHasText = true;
+            } else {
+              elements.find((el:ExcalidrawElement)=>el.id===item.id).containerId = null;
+            }
+          } else {
+            map.set(item.id, item.type);
+          }
         });
         const boundElements = Array.from(map, ([id, type]) => ({ id, type }));
         if (boundElements.length !== el.boundElements.length) {
@@ -616,7 +626,7 @@ export class ExcalidrawData {
     }
 
     //Load Equations
-    const REG_FILEID_EQUATION = /([\w\d]*):\s*\$\$(.*)(\$\$\s*\n)/gm;
+    const REG_FILEID_EQUATION = /([\w\d]*):\s*\$\$([\s\S]*?)(\$\$\s*\n)/gm;
     res = data.matchAll(REG_FILEID_EQUATION);
     while (!(parts = res.next()).done) {
       this.setEquation(parts.value[1] as FileId, {
@@ -1139,7 +1149,7 @@ export class ExcalidrawData {
         } else {
           //https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/829
           const path = ef.file
-            ? ef.linkParts.original.replace(PATHREG,app.metadataCache.fileToLinktext(ef.file,this.file.path))
+            ? ef.linkParts.original.replace(PATHREG,this.app.metadataCache.fileToLinktext(ef.file,this.file.path))
             : ef.linkParts.original;
           const colorMap = ef.colorMap ? " " + JSON.stringify(ef.colorMap) : "";
           outString += `${key}: [[${path}]]${colorMap}\n`;

src/ExcalidrawLib.d.ts

@@ -1,7 +1,7 @@
 import { RestoredDataState } from "@zsviczian/excalidraw/types/data/restore";
 import { ImportedDataState } from "@zsviczian/excalidraw/types/data/types";
 import { BoundingBox } from "@zsviczian/excalidraw/types/element/bounds";
-import { ExcalidrawBindableElement, ExcalidrawElement, ExcalidrawTextElement, FontFamilyValues, FontString, NonDeleted, Theme } from "@zsviczian/excalidraw/types/element/types";
+import { ExcalidrawBindableElement, ExcalidrawElement, ExcalidrawFrameElement, ExcalidrawTextElement, FontFamilyValues, FontString, NonDeleted, NonDeletedExcalidrawElement, Theme } from "@zsviczian/excalidraw/types/element/types";
 import { AppState, BinaryFiles, ExportOpts, Point, Zoom } from "@zsviczian/excalidraw/types/types";
 import { Mutable } from "@zsviczian/excalidraw/types/utility-types";
 
@@ -44,6 +44,7 @@ declare namespace ExcalidrawLib {
     appState?: AppState;
     files?: any;
     exportPadding?: number;
+    exportingFrame: ExcalidrawFrameElement | null | undefined;
     renderEmbeddables?: boolean;
   }): Promise<SVGSVGElement>;
 
@@ -129,6 +130,7 @@ declare namespace ExcalidrawLib {
   function mermaidToExcalidraw(
     mermaidDefinition: string,
     opts: {fontSize: number},
+    forceSVG?: boolean,
   ): Promise<{
     elements: ExcalidrawElement[],
     files:any

src/MarkdownPostProcessor.ts

@@ -20,7 +20,7 @@ import {
   hasExportTheme,
   convertSVGStringToElement,
 } from "./utils/Utils";
-import { getParentOfClass, isObsidianThemeDark } from "./utils/ObsidianUtils";
+import { getParentOfClass, isObsidianThemeDark, getFileCSSClasses } from "./utils/ObsidianUtils";
 import { linkClickModifierType } from "./utils/ModifierkeyHelper";
 import { ImageKey, imageCache } from "./utils/ImageCache";
 import { FILENAMEPARTS, PreviewImageType } from "./utils/UtilTypes";
@@ -30,7 +30,7 @@ interface imgElementAttributes {
   fname: string; //Excalidraw filename
   fwidth: string; //Display width of image
   fheight: string; //Display height of image
-  style: string; //css style to apply to IMG element
+  style: string[]; //css style to apply to IMG element
 }
 
 let plugin: ExcalidrawPlugin;
@@ -123,8 +123,16 @@ const setStyle = ({element,imgAttributes,onCanvas}:{
     style += `height:${imgAttributes.fheight}px;`;
   }
   if(!onCanvas) element.setAttribute("style", style);
-  element.addClass(imgAttributes.style);
-  element.addClass("excalidraw-embedded-img");
+  element.classList.add(...Array.from(imgAttributes.style))
+  if(!element.hasClass("excalidraw-embedded-img")) {
+    element.addClass("excalidraw-embedded-img");
+  }
+  if(
+    window.ExcalidrawAutomate.plugin.settings.canvasImmersiveEmbed &&
+    !element.hasClass("excalidraw-canvas-immersive")
+  ) {
+    element.addClass("excalidraw-canvas-immersive");
+  }
 }
 
 const _getSVGIMG = async ({filenameParts,theme,cacheReady,img,file,exportSettings,loader}:{
@@ -254,7 +262,7 @@ const getIMG = async (
   const filenameParts = getEmbeddedFilenameParts(imgAttributes.fname);
 
   // https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/387
-  imgAttributes.style = imgAttributes.style.replaceAll(" ", "-");
+  imgAttributes.style = imgAttributes.style.map(s=>s.replaceAll(" ", "-"));
 
   const forceTheme = hasExportTheme(plugin, file)
     ? getExportTheme(plugin, file, "light")
@@ -389,7 +397,7 @@ const createImgElement = async (
       fname: fileSource,
       fwidth: imgOrDiv.getAttribute("w"),
       fheight: imgOrDiv.getAttribute("h"),
-      style: imgOrDiv.getAttribute("class"),
+      style: [...Array.from(imgOrDiv.classList)],
     }, onCanvas);
     parent.empty();
     if(!onCanvas) {
@@ -399,6 +407,20 @@ const createImgElement = async (
     newImg.setAttribute("fileSource",fileSource);
     parent.append(newImg);
   });
+  const cssClasses = getFileCSSClasses(attr.file);
+  cssClasses.forEach((cssClass) => {
+    if(imgOrDiv.hasClass(cssClass)) return;
+    imgOrDiv.addClass(cssClass);
+  });
+  if(window.ExcalidrawAutomate.plugin.settings.canvasImmersiveEmbed) {
+    if(!imgOrDiv.hasClass("excalidraw-canvas-immersive")) {
+      imgOrDiv.addClass("excalidraw-canvas-immersive");
+    }
+  } else {
+    if(imgOrDiv.hasClass("excalidraw-canvas-immersive")) {
+      imgOrDiv.removeClass("excalidraw-canvas-immersive");
+    }
+  }
   return imgOrDiv;
 }
 
@@ -407,7 +429,7 @@ const createImageDiv = async (
   onCanvas: boolean = false
 ): Promise<HTMLDivElement> => {
   const img = await createImgElement(attr, onCanvas);
-  return createDiv(attr.style, (el) => el.append(img));
+  return createDiv(attr.style.join(" "), (el) => el.append(img));
 };
 
 const processReadingMode = async (
@@ -449,7 +471,7 @@ const processInternalEmbed = async (internalEmbedEl: Element, file: TFile ):Prom
     fname: "",
     fheight: "",
     fwidth: "",
-    style: "",
+    style: [],
   };
 
   const src = internalEmbedEl.getAttribute("src");
@@ -466,7 +488,7 @@ const processInternalEmbed = async (internalEmbedEl: Element, file: TFile ):Prom
   : getDefaultWidth(plugin);
   attr.fheight = internalEmbedEl.getAttribute("height");
   let alt = internalEmbedEl.getAttribute("alt");
-  attr.style = "excalidraw-svg";
+  attr.style = ["excalidraw-svg"];
   processAltText(src.split("#")[0],alt,attr);
   const fnameParts = getEmbeddedFilenameParts(src);
   attr.fname = file?.path + (fnameParts.hasBlockref||fnameParts.hasSectionref?fnameParts.linkpartReference:"");
@@ -485,14 +507,14 @@ const processAltText = (
     attr.fwidth = parts[2] ?? attr.fwidth;
     attr.fheight = parts[3] ?? attr.fheight;
     if (parts[4] && !parts[4].startsWith(fname)) {
-      attr.style = `excalidraw-svg${`-${parts[4]}`}`;
+      attr.style = [`excalidraw-svg${`-${parts[4]}`}`];
     }
     if (
       (!parts[4] || parts[4]==="") &&
       (!parts[2] || parts[2]==="") &&
       parts[0] && parts[0] !== ""
     ) {
-      attr.style = `excalidraw-svg${`-${parts[0]}`}`;
+      attr.style = [`excalidraw-svg${`-${parts[0]}`}`];
     }
   }
 }
@@ -550,7 +572,7 @@ const tmpObsidianWYSIWYG = async (
     fname: ctx.sourcePath,
     fheight: "",
     fwidth: getDefaultWidth(plugin),
-    style: "excalidraw-svg",
+    style: ["excalidraw-svg"],
   };
   
   attr.file = file;
@@ -729,7 +751,7 @@ export const observer = new MutationObserver(async (m) => {
     fname: file.path,
     fwidth: "300",
     fheight: null,
-    style: "excalidraw-svg",
+    style: ["excalidraw-svg"],
   });
   const div = createDiv("", async (el) => {
     el.appendChild(img);

src/Scripts.ts

@@ -11,6 +11,7 @@ import ExcalidrawPlugin from "./main";
 import { ButtonDefinition, GenericInputPrompt, GenericSuggester } from "./dialogs/Prompt";
 import { getIMGFilename } from "./utils/FileUtils";
 import { splitFolderAndFilename } from "./utils/FileUtils";
+import { getEA } from "src";
 
 export type ScriptIconMap = {
   [key: string]: { name: string; group: string; svgString: string };
@@ -199,27 +200,26 @@ export class ScriptEngine {
 
     const commandId = `${PLUGIN_ID}:${basename}`;
     // @ts-ignore
-    if (!app.commands.commands[commandId]) {
+    if (!this.plugin.app.commands.commands[commandId]) {
       return;
     }
     // @ts-ignore
-    delete app.commands.commands[commandId];
+    delete this.plugin.app.commands.commands[commandId];
   }
 
   async executeScript(view: ExcalidrawView, script: string, title: string, file: TFile) {
     if (!view || !script || !title) {
       return;
     }
-    this.plugin.ea.reset();
-    this.plugin.ea.setView(view);
-    this.plugin.ea.activeScript = title;
+    const ea = getEA(view);
+    ea.activeScript = title;
 
     //https://stackoverflow.com/questions/45381204/get-asyncfunction-constructor-in-typescript changed tsconfig to es2017
     //https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/AsyncFunction
     const AsyncFunction = Object.getPrototypeOf(async () => {}).constructor;
     let result = null;
     //try {
-    result = await new AsyncFunction("ea", "utils", script)(this.plugin.ea, {
+    result = await new AsyncFunction("ea", "utils", script)(ea, {
       inputPrompt: (
         header: string,
         placeholder?: string,
@@ -233,7 +233,7 @@ export class ScriptEngine {
         ScriptEngine.inputPrompt(
           view,
           this.plugin,
-          app,
+          this.plugin.app,
           header,
           placeholder,
           value,
@@ -262,7 +262,7 @@ export class ScriptEngine {
       new Notice(t("SCRIPT_EXECUTION_ERROR"), 4000);
       errorlog({ script: this.plugin.ea.activeScript, error: e });
   }*/
-        this.plugin.ea.activeScript = null;
+        ea.activeScript = null;
         return result;
 }
 

src/customEmbeddable.tsx

@@ -1,4 +1,4 @@
-import { NonDeletedExcalidrawElement } from "@zsviczian/excalidraw/types/element/types";
+import {  NonDeletedExcalidrawElement } from "@zsviczian/excalidraw/types/element/types";
 import ExcalidrawView from "./ExcalidrawView";
 import { Notice, WorkspaceLeaf, WorkspaceSplit } from "obsidian";
 import * as React from "react";
@@ -7,6 +7,7 @@ import { DEVICE, EXTENDED_EVENT_TYPES, KEYBOARD_EVENT_TYPES } from "./constants"
 import { ExcalidrawImperativeAPI, UIAppState } from "@zsviczian/excalidraw/types/types";
 import { ObsidianCanvasNode } from "./utils/CanvasNodeFactory";
 import { processLinkText, patchMobileView } from "./utils/CustomEmbeddableUtils";
+import { EmbeddableMDCustomProps } from "./dialogs/EmbeddableSettings";
 
 declare module "obsidian" {
   interface Workspace {
@@ -18,6 +19,14 @@ declare module "obsidian" {
   }
 }
 
+const getTheme = (view: ExcalidrawView, theme:string): string => view.excalidrawData.embeddableTheme === "dark"
+  ? "theme-dark"
+  : view.excalidrawData.embeddableTheme === "light" 
+    ? "theme-light"
+    : view.excalidrawData.embeddableTheme === "auto"
+      ? theme === "dark" ? "theme-dark" : "theme-light"
+      : isObsidianThemeDark() ? "theme-dark" : "theme-light";
+
 //--------------------------------------------------------------------------------
 //Render webview for anything other than Vimeo and Youtube
 //Vimeo and Youtube are rendered by Excalidraw because of the window messaging
@@ -59,13 +68,15 @@ export const renderWebView = (src: string, view: ExcalidrawView, id: string, app
 //Render WorkspaceLeaf or CanvasNode
 //--------------------------------------------------------------------------------
 function RenderObsidianView(
-  { element, linkText, view, containerRef, appState, theme }:{
+  { mdProps, element, linkText, view, containerRef, activeEmbeddable, theme, canvasColor }:{
+  mdProps: EmbeddableMDCustomProps;
   element: NonDeletedExcalidrawElement;
   linkText: string;
   view: ExcalidrawView;
   containerRef: React.RefObject<HTMLDivElement>;
-  appState: UIAppState;
+  activeEmbeddable: {element: NonDeletedExcalidrawElement; state: string};
   theme: string;
+  canvasColor: string;
 }): JSX.Element {
   
   const { subpath, file } = processLinkText(linkText, view);
@@ -79,8 +90,19 @@ function RenderObsidianView(
   const leafRef = react.useRef<{leaf: WorkspaceLeaf; node?: ObsidianCanvasNode} | null>(null);
   const isEditingRef = react.useRef(false);
   const isActiveRef = react.useRef(false);
+  const themeRef = react.useRef(theme);
+  const elementRef = react.useRef(element);
 
+  // Update themeRef when theme changes
+  react.useEffect(() => {
+    themeRef.current = theme;
+  }, [theme]);
 
+  // Update elementRef when element changes
+  react.useEffect(() => {
+    elementRef.current = element;
+  }, [element]);
+ 
   //--------------------------------------------------------------------------------
   //block propagation of events to the parent if the iframe element is active
   //--------------------------------------------------------------------------------
@@ -192,6 +214,7 @@ function RenderObsidianView(
           //This runs only when the file is added, thus should not be a major performance issue
           await leafRef.current.leaf.setViewState({state: {file:null}})
           leafRef.current.node = view.canvasNodeFactory.createFileNote(file, subpath, containerRef.current, element.id);
+          setColors(containerRef.current, element, mdProps, canvasColor);
         } else {
           const workspaceLeaf:HTMLDivElement = rootSplit.containerEl.querySelector("div.workspace-leaf");
           if(workspaceLeaf) workspaceLeaf.style.borderRadius = "var(--embeddable-radius)";
@@ -205,9 +228,69 @@ function RenderObsidianView(
     return () => {}; //cleanup on unmount
   }, [linkText, subpath, containerRef]);
   
+  const setColors = (canvasNode: HTMLDivElement, element: NonDeletedExcalidrawElement, mdProps: EmbeddableMDCustomProps, canvas: string) => {
+    if(!mdProps) return;
+    if (!leafRef.current?.hasOwnProperty("node")) return;
+
+    const canvasNodeContainer = containerRef.current?.firstElementChild as HTMLElement;
+    
+    if(mdProps.useObsidianDefaults) {
+      canvasNode?.style.removeProperty("--canvas-background");
+      canvasNodeContainer?.style.removeProperty("background-color");
+      canvasNode?.style.removeProperty("--canvas-border");
+      canvasNodeContainer?.style.removeProperty("border-color");
+      return;
+    }
+
+    const ea = view.plugin.ea;
+    if(mdProps.backgroundMatchElement) {
+      const opacity = (mdProps?.backgroundOpacity ?? 50)/100;
+      const color = element?.backgroundColor 
+        ? ea.getCM(element.backgroundColor).alphaTo(opacity).stringHEX()
+        : "transparent";
+      canvasNode?.style.setProperty("--canvas-background", color);
+      canvasNodeContainer?.style.setProperty("background-color", color);
+    } else if (!(mdProps?.backgroundMatchElement ?? true )) {
+      const color = mdProps.backgroundMatchCanvas
+        ? ea.getCM(canvasColor).alphaTo((mdProps.backgroundOpacity??100)/100).stringHEX()
+        : ea.getCM(mdProps.backgroundColor).alphaTo((mdProps.backgroundOpacity??100)/100).stringHEX();
+      containerRef.current?.style.setProperty("--canvas-background", color);
+      canvasNodeContainer?.style.setProperty("background-color", color);
+    }
+
+    if(mdProps.borderMatchElement) {
+      const opacity = (mdProps?.borderOpacity ?? 50)/100;
+      const color = element?.strokeColor
+      ? ea.getCM(element?.strokeColor).alphaTo(opacity).stringHEX()
+      : "transparent";
+      canvasNode?.style.setProperty("--canvas-border", color);
+      canvasNodeContainer?.style.setProperty("border-color", color);
+    } else if(!(mdProps?.borderMatchElement ?? true)) {
+      const color = ea.getCM(mdProps.borderColor).alphaTo((mdProps.borderOpacity??100)/100).stringHEX();
+      canvasNode?.style.setProperty("--canvas-border", color);
+      canvasNodeContainer?.style.setProperty("border-color", color);
+    }
+  }
+
+  react.useEffect(() => {
+    if(!containerRef.current) {
+      return;
+    }
+    const element = elementRef.current;
+    const canvasNode = containerRef.current;
+    if(!canvasNode.hasClass("canvas-node")) return;
+    setColors(canvasNode, element, mdProps, canvasColor);
+  }, [
+    mdProps,
+    elementRef.current,
+    containerRef.current,
+    canvasColor,
+  ])
+
   react.useEffect(() => {
     if(isEditingRef.current) {
       if(leafRef.current?.node) {
+        containerRef.current?.addClasses(["is-editing", "is-focused"]);
         view.canvasNodeFactory.stopEditing(leafRef.current.node);
       }
       isEditingRef.current = false;
@@ -242,10 +325,12 @@ function RenderObsidianView(
         patchMobileView(view);
       } else if (leafRef.current?.node) {
         //Handle canvas node
-        view.canvasNodeFactory.startEditing(leafRef.current.node, theme);
+        const newTheme = getTheme(view, themeRef.current);
+        containerRef.current?.addClasses(["is-editing", "is-focused"]);
+        view.canvasNodeFactory.startEditing(leafRef.current.node, newTheme);
       }
     }
-  }, [leafRef.current?.leaf, element.id]);
+  }, [leafRef.current?.leaf, element.id, view, themeRef.current]);
 
   //--------------------------------------------------------------------------------
   // Set isActiveRef and switch to preview mode when the iframe is not active
@@ -256,7 +341,7 @@ function RenderObsidianView(
     }
 
     const previousIsActive = isActiveRef.current;
-    isActiveRef.current = (appState.activeEmbeddable?.element.id === element.id) && (appState.activeEmbeddable?.state === "active");
+    isActiveRef.current = (activeEmbeddable?.element.id === element.id) && (activeEmbeddable?.state === "active");
 
     if (previousIsActive === isActiveRef.current) {
       return;
@@ -278,20 +363,17 @@ function RenderObsidianView(
       }  
     } else if (leafRef.current?.node) {
       //Handle canvas node
+      containerRef.current?.removeClasses(["is-editing", "is-focused"]);
       view.canvasNodeFactory.stopEditing(leafRef.current.node);
     }
   }, [
     containerRef,
     leafRef,
     isActiveRef,
-    appState.activeEmbeddable?.element,
-    appState.activeEmbeddable?.state,
+    activeEmbeddable?.element,
+    activeEmbeddable?.state,
     element,
     view,
-    linkText,
-    subpath,
-    file,
-    theme,
     isEditingRef,
     view.canvasNodeFactory
   ]);
@@ -299,16 +381,12 @@ function RenderObsidianView(
   return null;
 };
 
+
 export const CustomEmbeddable: React.FC<{element: NonDeletedExcalidrawElement; view: ExcalidrawView; appState: UIAppState; linkText: string}> = ({ element, view, appState, linkText }) => {
   const react = view.plugin.getPackage(view.ownerWindow).react;
   const containerRef: React.RefObject<HTMLDivElement> = react.useRef(null);
-  const theme = view.excalidrawData.embeddableTheme === "dark"
-    ? "theme-dark"
-    : view.excalidrawData.embeddableTheme === "light" 
-      ? "theme-light"
-      : view.excalidrawData.embeddableTheme === "auto"
-        ? appState.theme === "dark" ? "theme-dark" : "theme-light"
-        : isObsidianThemeDark() ? "theme-dark" : "theme-light";
+  const theme = getTheme(view, appState.theme);
+  const mdProps: EmbeddableMDCustomProps = element.customData?.mdProps || null;
 
   return (
     <div
@@ -319,15 +397,19 @@ export const CustomEmbeddable: React.FC<{element: NonDeletedExcalidrawElement; v
         borderRadius: "var(--embeddable-radius)",
         color: `var(--text-normal)`,
       }}
-      className={theme}
+      className={`${theme} canvas-node ${
+        mdProps?.filenameVisible ? "" : "excalidraw-mdEmbed-hideFilename"}`}
     >
       <RenderObsidianView
+        mdProps={mdProps}
         element={element}
         linkText={linkText}
         view={view}
         containerRef={containerRef}
-        appState={appState}
-        theme={theme}/>
+        activeEmbeddable={appState.activeEmbeddable}
+        theme={appState.theme}
+        canvasColor={appState.viewBackgroundColor}
+      />
     </div>
   )
 }

src/dialogs/EmbeddableMDFileCustomDataSettingsComponent.ts

@@ -0,0 +1,175 @@
+import { Setting, ToggleComponent } from "obsidian";
+import { EmbeddableMDCustomProps } from "./EmbeddableSettings";
+import { fragWithHTML } from "src/utils/Utils";
+import { t } from "src/lang/helpers";
+
+export class EmbeddalbeMDFileCustomDataSettingsComponent {
+  constructor (
+    private contentEl: HTMLElement,
+    private mdCustomData: EmbeddableMDCustomProps,
+    private update?: Function,
+  ) { 
+    if(!update) this.update = () => {};
+  }
+
+  render() {
+    let detailsDIV: HTMLDivElement;
+
+    new Setting(this.contentEl)
+      .setName(t("ES_USE_OBSIDIAN_DEFAULTS"))
+      .addToggle(toggle => 
+        toggle
+          .setValue(this.mdCustomData.useObsidianDefaults)
+          .onChange(value => {
+            this.mdCustomData.useObsidianDefaults = value;
+            detailsDIV.style.display = value ? "none" : "block";
+            this.update();
+          })
+      );
+    
+    this.contentEl.createEl("hr", { cls: "excalidraw-setting-hr" });
+    
+    detailsDIV = this.contentEl.createDiv();
+    detailsDIV.style.display = this.mdCustomData.useObsidianDefaults ? "none" : "block";
+
+    const contentEl = detailsDIV
+    new Setting(contentEl)
+        .setName(t("ES_FILENAME_VISIBLE"))
+        .addToggle(toggle => 
+          toggle
+            .setValue(this.mdCustomData.filenameVisible)
+            .onChange(value => {
+              this.mdCustomData.filenameVisible = value;
+            })
+        );
+      
+      contentEl.createEl("h4",{text: t("ES_BACKGROUND_HEAD")});
+      
+      let bgSetting: Setting;  
+      let bgMatchElementToggle: ToggleComponent;
+      let bgMatchCanvasToggle: ToggleComponent;
+      new Setting(contentEl)
+        .setName(t("ES_BACKGROUND_MATCH_ELEMENT"))
+        .addToggle(toggle => {
+          bgMatchElementToggle = toggle;
+          toggle
+            .setValue(this.mdCustomData.backgroundMatchElement)
+            .onChange(value => {
+              this.mdCustomData.backgroundMatchElement = value;
+              if(value) {
+                bgSetting.settingEl.style.display = "none";
+                if(this.mdCustomData.backgroundMatchCanvas) {
+                  bgMatchCanvasToggle.setValue(false);
+                }
+              } else {
+                if(!this.mdCustomData.backgroundMatchCanvas) {
+                  bgSetting.settingEl.style.display = "";
+                }
+              }
+              this.update();
+            })
+          });
+
+      new Setting(contentEl)
+        .setName(t("ES_BACKGROUND_MATCH_CANVAS"))
+        .addToggle(toggle => {
+          bgMatchCanvasToggle = toggle;
+          toggle
+            .setValue(this.mdCustomData.backgroundMatchCanvas)
+            .onChange(value => {
+              this.mdCustomData.backgroundMatchCanvas = value;
+              if(value) {
+                bgSetting.settingEl.style.display = "none";
+                if(this.mdCustomData.backgroundMatchElement) {
+                  bgMatchElementToggle.setValue(false);
+                }
+              } else {
+                if(!this.mdCustomData.backgroundMatchElement) {
+                    bgSetting.settingEl.style.display = "";
+                }
+              }
+              this.update();
+            })
+          });
+
+      if(this.mdCustomData.backgroundMatchElement && this.mdCustomData.backgroundMatchCanvas) {
+        bgMatchCanvasToggle.setValue(false);
+      }
+
+      bgSetting = new Setting(contentEl)
+        .setName(t("ES_BACKGROUND_COLOR"))
+        .addColorPicker(colorPicker =>
+          colorPicker
+            .setValue(this.mdCustomData.backgroundColor)
+            .onChange((value) => {
+              this.mdCustomData.backgroundColor = value;
+              this.update();
+            })
+        );
+      
+      bgSetting.settingEl.style.display = (this.mdCustomData.backgroundMatchElement || this.mdCustomData.backgroundMatchCanvas) ? "none" : "";
+      const opacity = (value:number):DocumentFragment => {
+        return fragWithHTML(`Current transparency is <b>${value}%</b>`);
+      }
+
+      const bgOpacitySetting = new Setting(contentEl)
+        .setName(t("ES_BACKGROUND_OPACITY"))
+        .setDesc(opacity(this.mdCustomData.backgroundOpacity))
+        .addSlider(slider => 
+          slider
+            .setLimits(0,100,5)
+            .setValue(this.mdCustomData.backgroundOpacity)
+            .onChange(value => {
+              this.mdCustomData.backgroundOpacity = value;
+              bgOpacitySetting.setDesc(opacity(value));
+              this.update();
+            })
+        );
+      
+      contentEl.createEl("h4",{text: t("ES_BORDER_HEAD")});
+      let borderSetting: Setting;
+
+      new Setting(contentEl)
+        .setName(t("ES_BORDER_MATCH_ELEMENT"))
+        .addToggle(toggle => 
+          toggle
+            .setValue(this.mdCustomData.borderMatchElement)
+            .onChange(value => {
+              this.mdCustomData.borderMatchElement = value;
+              if(value) {
+                borderSetting.settingEl.style.display = "none";
+              } else {
+                borderSetting.settingEl.style.display = "";
+              }
+              this.update();
+            })
+        );
+
+      borderSetting = new Setting(contentEl)
+        .setName(t("ES_BORDER_COLOR"))
+        .addColorPicker(colorPicker =>
+          colorPicker
+            .setValue(this.mdCustomData.borderColor)
+            .onChange((value) => {
+              this.mdCustomData.borderColor = value;
+              this.update();
+            })
+        );
+
+      borderSetting.settingEl.style.display = this.mdCustomData.borderMatchElement ? "none" : "";
+
+      const borderOpacitySetting = new Setting(contentEl)
+        .setName(t("ES_BORDER_OPACITY"))
+        .setDesc(opacity(this.mdCustomData.borderOpacity))
+        .addSlider(slider => 
+          slider
+            .setLimits(0,100,5)
+            .setValue(this.mdCustomData.borderOpacity)
+            .onChange(value => {
+              this.mdCustomData.borderOpacity = value;
+              borderOpacitySetting.setDesc(opacity(value));
+              this.update();
+            })
+        );
+  }
+} 

src/dialogs/EmbeddableSettings.ts

@@ -0,0 +1,180 @@
+import { ExcalidrawEmbeddableElement } from "@zsviczian/excalidraw/types/element/types";
+import { Mutable } from "@zsviczian/excalidraw/types/utility-types";
+import { Modal, Notice, Setting, TFile, ToggleComponent } from "obsidian";
+import { getEA } from "src";
+import { ExcalidrawAutomate } from "src/ExcalidrawAutomate";
+import ExcalidrawView from "src/ExcalidrawView";
+import { t } from "src/lang/helpers";
+import ExcalidrawPlugin from "src/main";
+import { getNewUniqueFilepath, getPathWithoutExtension, splitFolderAndFilename } from "src/utils/FileUtils";
+import { addAppendUpdateCustomData, fragWithHTML } from "src/utils/Utils";
+import { getYouTubeStartAt, isValidYouTubeStart, isYouTube, updateYouTubeStartTime } from "src/utils/YoutTubeUtils";
+import { EmbeddalbeMDFileCustomDataSettingsComponent } from "./EmbeddableMDFileCustomDataSettingsComponent";
+
+export type EmbeddableMDCustomProps = {
+  useObsidianDefaults: boolean;
+  backgroundMatchCanvas: boolean;
+  backgroundMatchElement: boolean;
+  backgroundColor: string;
+  backgroundOpacity: number;
+  borderMatchElement: boolean;
+  borderColor: string;
+  borderOpacity: number;
+  filenameVisible: boolean;
+}
+
+export class EmbeddableSettings extends Modal {
+  private ea: ExcalidrawAutomate;
+  private updatedFilepath: string = null;
+  private zoomValue: number;
+  private isYouTube: boolean;
+  private youtubeStart: string = null;
+  private isMDFile: boolean;
+  private mdCustomData: EmbeddableMDCustomProps;
+
+  constructor(
+    private plugin: ExcalidrawPlugin,
+    private view: ExcalidrawView,
+    private file: TFile,
+    private element: ExcalidrawEmbeddableElement
+  ) {
+    super(plugin.app);
+    this.ea = getEA(this.view);
+    this.ea.copyViewElementsToEAforEditing([this.element]);
+    this.zoomValue = element.scale[0];
+    this.isYouTube = isYouTube(this.element.link);
+    this.isMDFile = this.file && this.file.extension === "md" && !this.view.plugin.isExcalidrawFile(this.file)
+    if(isYouTube) this.youtubeStart = getYouTubeStartAt(this.element.link);
+
+    this.mdCustomData = element.customData?.mdProps ?? view.plugin.settings.embeddableMarkdownDefaults;
+    if(!element.customData?.mdProps) {
+      const bgCM = this.plugin.ea.getCM(element.backgroundColor);
+      this.mdCustomData.backgroundColor = bgCM.stringHEX({alpha: false});
+      this.mdCustomData.backgroundOpacity = element.opacity;
+      const borderCM = this.plugin.ea.getCM(element.strokeColor);
+      this.mdCustomData.borderColor = borderCM.stringHEX({alpha: false});
+      this.mdCustomData.borderOpacity = element.opacity;
+    }
+    
+  }
+
+  onOpen(): void {
+    this.containerEl.classList.add("excalidraw-release");
+    this.titleEl.setText(t("ES_TITLE"));
+    this.createForm();
+  }
+
+  onClose() {
+
+  }
+
+  async createForm() {
+
+    this.contentEl.createEl("h1",{text: t("ES_TITLE")});
+
+    if(this.file) {
+      new Setting(this.contentEl)
+        .setName(t("ES_RENAME"))
+        .addText(text =>
+          text
+          .setValue(getPathWithoutExtension(this.file))
+          .onChange(async (value) => {
+            this.updatedFilepath = value;
+          })
+        )
+    }
+
+    const zoomValue = ():DocumentFragment => {
+      return fragWithHTML(`Current zoom is <b>${Math.round(this.zoomValue*100)}%</b>`);
+    } 
+    const zoomSetting = new Setting(this.contentEl)
+      .setName(t("ES_ZOOM"))
+      .setDesc(zoomValue())
+      .addSlider(slider => 
+        slider
+          .setLimits(10,400,5)
+          .setValue(this.zoomValue*100)
+          .onChange(value => {
+            this.zoomValue = value/100;
+            zoomSetting.setDesc(zoomValue());
+          })
+      )
+
+    if(this.isYouTube) {
+      new Setting(this.contentEl)
+        .setName(t("ES_YOUTUBE_START"))
+        .setDesc(t("ES_YOUTUBE_START_DESC"))
+        .addText(text =>
+          text
+          .setValue(this.youtubeStart)
+          .onChange(async (value) => {
+            this.youtubeStart = value;
+          })
+        )
+    }
+
+    if(this.isMDFile) {
+      this.contentEl.createEl("h3",{text: t("ES_EMBEDDABLE_SETTINGS")});
+      new EmbeddalbeMDFileCustomDataSettingsComponent(this.contentEl,this.mdCustomData).render();
+    }
+
+    const div = this.contentEl.createDiv({cls: "excalidraw-prompt-buttons-div"});
+    const bOk = div.createEl("button", { text: t("PROMPT_BUTTON_OK"), cls: "excalidraw-prompt-button"});
+    bOk.onclick = async () => {
+      let dirty = false;
+      const el = this.ea.getElement(this.element.id) as Mutable<ExcalidrawEmbeddableElement>;
+      if(this.updatedFilepath) {
+        const newPathWithExt = `${this.updatedFilepath}.${this.file.extension}`;
+        if(newPathWithExt !== this.file.path) {
+          const fnparts = splitFolderAndFilename(newPathWithExt);
+          const newPath = getNewUniqueFilepath(
+            this.app.vault,
+            fnparts.folderpath,
+            fnparts.filename,
+          );
+          await this.app.vault.rename(this.file,newPath);
+          el.link = this.element.link.replace(
+            /(\[\[)([^#\]]*)([^\]]*]])/,`$1${
+              this.plugin.app.metadataCache.fileToLinktext(
+                this.file,this.view.file.path,true)
+            }$3`);
+          dirty = true;
+        }
+      }
+      if(this.isYouTube && this.youtubeStart !== getYouTubeStartAt(this.element.link)) {
+        dirty = true;
+        if(isValidYouTubeStart(this.youtubeStart)) {
+          el.link = updateYouTubeStartTime(el.link,this.youtubeStart);
+        } else {
+          new Notice(t("ES_YOUTUBE_START_INVALID"));
+        }
+      }
+      if(
+        this.isMDFile && (
+          this.mdCustomData.backgroundColor !== this.element.customData?.backgroundColor ||
+          this.mdCustomData.borderColor !== this.element.customData?.borderColor ||
+          this.mdCustomData.backgroundOpacity !== this.element.customData?.backgroundOpacity ||
+          this.mdCustomData.borderOpacity !== this.element.customData?.borderOpacity ||
+          this.mdCustomData.filenameVisible !== this.element.customData?.filenameVisible)
+      ) {
+        addAppendUpdateCustomData(el,{mdProps: this.mdCustomData});
+        dirty = true;
+      }
+
+      if(this.zoomValue !== this.element.scale[0]) {
+        dirty = true;
+        
+        el.scale = [this.zoomValue,this.zoomValue];
+      }
+      if(dirty) {
+        this.ea.addElementsToView();
+      }
+      this.close();
+    };
+    const bCancel = div.createEl("button", { text: t("PROMPT_BUTTON_CANCEL"), cls: "excalidraw-prompt-button" });
+    bCancel.onclick = () => {
+      this.close();
+    };
+  }
+}
+

src/dialogs/InsertLinkDialog.ts

@@ -45,7 +45,7 @@ export class InsertLinkDialog extends FuzzySuggestModal<TFile> {
         true,
       );
     }
-    this.addText(`[[${filepath + (item.alias ? `|${item.alias}` : "")}]]`);
+    this.addText(`[[${filepath + (item.alias ? `|${item.alias}` : "")}]]`, filepath, item.alias);
   }
 
   public start(drawingPath: string, addText: Function) {

src/dialogs/InsertPDFModal.ts

@@ -11,7 +11,10 @@ import { ExcalidrawImperativeAPI } from "@zsviczian/excalidraw/types/types";
 export class InsertPDFModal extends Modal {
   private borderBox: boolean = true;
   private gapSize:number = 20;
+  private groupPages: boolean = false;
+  private direction: "down" | "right" = "right";
   private numColumns: number = 1;
+  private numRows: number = 1;
   private lockAfterImport: boolean = true;
   private pagesToImport:number[] = [];
   private pageDimensions: {width: number, height: number} = {width: 0, height: 0};
@@ -21,7 +24,6 @@ export class InsertPDFModal extends Modal {
   private pdfFile: TFile;
   private dirty: boolean = false;
 
-
   constructor(
     private plugin: ExcalidrawPlugin,
     private view: ExcalidrawView,
@@ -47,7 +49,10 @@ export class InsertPDFModal extends Modal {
       this.plugin.settings.pdfImportScale = this.importScale;
       this.plugin.settings.pdfBorderBox = this.borderBox;
       this.plugin.settings.pdfGapSize = this.gapSize;
+      this.plugin.settings.pdfGroupPages = this.groupPages;
       this.plugin.settings.pdfNumColumns = this.numColumns;
+      this.plugin.settings.pdfNumRows = this.numRows;
+      this.plugin.settings.pdfDirection = this.direction;
       this.plugin.settings.pdfLockAfterImport = this.lockAfterImport;
       this.plugin.saveSettings();
     }
@@ -111,7 +116,10 @@ export class InsertPDFModal extends Modal {
     await this.plugin.loadSettings();
     this.borderBox = this.plugin.settings.pdfBorderBox;
     this.gapSize = this.plugin.settings.pdfGapSize;
+    this.groupPages = this.plugin.settings.pdfGroupPages;
     this.numColumns = this.plugin.settings.pdfNumColumns;
+    this.numRows = this.plugin.settings.pdfNumRows;
+    this.direction = this.plugin.settings.pdfDirection;
     this.lockAfterImport = this.plugin.settings.pdfLockAfterImport;
     this.importScale = this.plugin.settings.pdfImportScale;
 
@@ -211,7 +219,18 @@ export class InsertPDFModal extends Modal {
           this.borderBox = value;
           this.dirty = true;
         }))
-    
+
+    new Setting(ce)
+      .setName("Group pages")
+      .setDesc("This will group all pages into a single group. This is recommended if you are locking the pages after import, because the group will be easier to unlock later rather than unlocking one by one.")
+      .addToggle(toggle => toggle
+        .setValue(this.groupPages)
+        .onChange((value) => {
+          this.groupPages = value
+          this.dirty = true;
+        }))
+  
+        
     new Setting(ce)
       .setName("Lock pages on canvas after import")
       .addToggle(toggle => toggle
@@ -221,8 +240,38 @@ export class InsertPDFModal extends Modal {
           this.dirty = true;
         }))
 
-    let columnsText: HTMLDivElement;
+    let numColumnsSetting: Setting;
+    let numRowsSetting: Setting;
+    const colRowVisibility = () => {
+      switch(this.direction) {
+        case "down":
+          numColumnsSetting.settingEl.style.display = "none";
+          numRowsSetting.settingEl.style.display = "";
+          break;
+        case "right":
+          numColumnsSetting.settingEl.style.display = "";
+          numRowsSetting.settingEl.style.display = "none";
+          break;
+      }
+    }
+    
     new Setting(ce)
+      .setName("Import direction")
+      .addDropdown(dropdown => dropdown
+        .addOptions({
+          "down": "Top > Down",
+          "right": "Left > Right"
+        })
+        .setValue(this.direction)
+        .onChange(value => {
+          this.direction = value as "down" | "right";
+          colRowVisibility();
+          this.dirty = true;
+        }))
+
+    let columnsText: HTMLDivElement;
+    numColumnsSetting = new Setting(ce);
+    numColumnsSetting
       .setName("Number of columns")
       .addSlider(slider => slider
         .setLimits(1, 100, 1)
@@ -239,6 +288,26 @@ export class InsertPDFModal extends Modal {
         el.innerText = ` ${this.numColumns.toString()}`;
       });
 
+    let rowsText: HTMLDivElement;
+    numRowsSetting = new Setting(ce);
+    numRowsSetting
+      .setName("Number of rows")
+      .addSlider(slider => slider
+        .setLimits(1, 100, 1)
+        .setValue(this.numRows)
+        .onChange(value => {
+          this.numRows = value;
+          rowsText.innerText = ` ${value.toString()}`;
+          this.dirty = true;
+        }))
+      .settingEl.createDiv("", (el) => {
+        rowsText = el;
+        el.style.minWidth = "2.3em";
+        el.style.textAlign = "right";
+        el.innerText = ` ${this.numRows.toString()}`;
+      });
+    colRowVisibility();
+
     let gapSizeText: HTMLDivElement;
     new Setting(ce)
       .setName("Size of gap between pages")
@@ -256,7 +325,7 @@ export class InsertPDFModal extends Modal {
         el.style.textAlign = "right";
         el.innerText = ` ${this.gapSize.toString()}`;
       });
-  
+
     const importSizeSetting = new Setting(ce)
       .setName("Imported page size")
       .setDesc(`${this.pageDimensions.width*this.importScale} x ${this.pageDimensions.height*this.importScale}`)
@@ -311,9 +380,21 @@ export class InsertPDFModal extends Modal {
               if(this.lockAfterImport) imgEl.locked = true;
 
               ea.addToGroup([boxID,imageID]);
-
-              column = (column + 1) % this.numColumns;
-              if(column === 0) row++;
+              
+              switch(this.direction) {
+                case "right":
+                  column = (column + 1) % this.numColumns;
+                  if(column === 0) row++;
+                  break;
+                case "down":
+                  row = (row + 1) % this.numRows;
+                  if(row === 0) column++;
+                  break;
+              }
+            }
+            if(this.groupPages) {
+              const ids = ea.getElements().map(el => el.id);
+              ea.addToGroup(ids);
             }
             await ea.addElementsToView(true,true,false);
             const api = ea.getExcalidrawAPI() as ExcalidrawImperativeAPI;

src/dialogs/Messages.ts

@@ -17,6 +17,65 @@ I develop this plugin as a hobby, spending my free time doing this. If you find
 
 <div class="ex-coffee-div"><a href="https://ko-fi.com/zsolt"><img src="https://cdn.ko-fi.com/cdn/kofi3.png?v=3" height=45></a></div>
 `,
+"2.0.1":`
+<div class="excalidraw-videoWrapper"><div>
+<iframe src="https://www.youtube.com/embed/xmqiBTrlbEM" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+</div></div>
+
+## Fixed
+- bug with cssclasses in frontmatter
+- styling of help screen keyboard shortcuts [#1437](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1437)
+`,
+"2.0.0":`
+<div class="excalidraw-videoWrapper"><div>
+<iframe src="https://www.youtube.com/embed/JC1E-jeiWhI" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+</div></div>
+
+## New
+- Added support for applying CSS classes in frontmatter. Now, when embedding Excalidraw drawings into Obsidian Canvas, you can use [Canvas Candy](https://tfthacker.com/canvas-candy) classes. For instance, ${String.fromCharCode(96)}cssclasses: cc-border-none${String.fromCharCode(96)} removes the canvas node border around the drawing.
+- Introduced new context menu actions:
+  - Navigate to link or embedded image.
+  - Add any file from the vault to the canvas.
+  - Convert the selected text element or sticky note to an embedded markdown file.
+  - Add a link from the Vault to the selected element.
+- Frames are now rendered in exported images.
+- SVG Export includes the ${String.fromCharCode(96)}.excalidraw-svg${String.fromCharCode(96)} class, enabling post-processing of SVGs using publish.js when using custom domains with Obsidian Publish. Also, added a command palette action ${String.fromCharCode(96)}Obsidian Publish: Find SVG and PNG exports that are out of date${String.fromCharCode(96)}.
+- Added a new Command palette action to open the corresponding Excalidraw file based on the embedded SVG or PNG file. ${String.fromCharCode(96)}Open Excalidraw Drawing${String.fromCharCode(96)} [Issue #1411](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1411)
+
+## Fixed and Improved
+- Resolved issue with the Mermaid Timeline graph displaying all black. [Issue #1424](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1424)
+- Enabled toggling pen mode off after activation by a pen touch.
+- Now you are able to unlock elements on mobile; previously, locked elements couldn't be selected.
+- Fixed the disabled ${String.fromCharCode(96)}complete line button${String.fromCharCode(96)} for multipoint lines on mobile.
+![Mobile Editing Image](https://github.com/zsviczian/obsidian-excalidraw-plugin/assets/14358394/e7051c75-818f-4800-ba16-ac276e229184)
+
+`,
+"1.9.28":`
+## Fixed & Improved
+- Fixed an issue where the toolbar lost focus, requiring two clicks. This caused a problem when the hand tool was activated from ExcalidrawAutomate script when opening a drawing, causing buttons to stop working. [#1344](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1344)
+- Resolved a caching issue affecting image area-links and group-links, making them work inconsistently. For more details, refer to the discussion on [Discord](https://discord.com/channels/1026825302900494357/1169311900308361318).
+- Improved frame colors with Dynamic Coloring.
+- Added support for multiline LaTeX formulas. [#1403](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1403)
+- Fixed the issue of Chinese characters overlapping in MathJax. [#1406](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1406)
+
+## New
+- Added support for Mermaid to Excalidraw **Sequence Diagrams**.
+- If an image contains an element link, clicking on the image will now open the link chooser, allowing you to decide whether to open the image or follow the element link.
+- When hovering over an image that also has an element link, the hover preview will display the contents of the link.
+- You can now choose to **import PDFs** in columns instead of rows. Additionally, you have the option to group all pages after import, which will improve the unlocking experience if you also lock pages on import.
+- Introduced configuration options for the **Laser Tool**, including pointer color, decay length, and time. ([#1408](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1408), [#1220](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1220))
+
+![image](https://github.com/zsviczian/obsidian-excalidraw-plugin/assets/14358394/c0cad40a-1afc-42af-b41b-f912dd8a4e78)
+`,
+"1.9.27": `
+## New
+- Restructured plugin settings, added additional comments and relevant videos
+- Added setting to change PDF to Image resolution/scale. This has an effect when embedding PDF pages to Excalidraw. A lower value will result in less-sharp pages, but better overall performance. Also, larger pages (higher scale value) were not accepted by Excalidraw.com when copying from Obsidian due to the 2MB image file limit.  Find the "PDF to Image" setting under "Embedding Excalidraw into your Notes and Exporting" setting. [#1393](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1393)
+
+## Fixed
+- When multiple Excalidraw Scripts were executed parallel a race condition occurred causing scripts to override each other
+- I implemented a partial fix to "text detaching from figures when dragging them" [#1400](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1400)
+- Regression: extra thin stroke removed with 1.9.26 [#1399](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/1399)`,
 "1.9.26":`
 ## Fixes and improvements from Excalidraw.com
 - Freedraw shape selection issue, when fill-pattern is not solid [#7193](https://github.com/excalidraw/excalidraw/pull/7193)

src/dialogs/PublishOutOfDateFiles.ts

@@ -0,0 +1,129 @@
+import { Modal, Setting, TFile } from "obsidian";
+import ExcalidrawPlugin from "src/main";
+import { getIMGFilename } from "src/utils/FileUtils";
+import { addIframe } from "src/utils/Utils";
+
+const haveLinkedFilesChanged = (depth: number, mtime: number, path: string, sourceList: Set<string>, plugin: ExcalidrawPlugin):boolean  => {
+  if(depth++ > 5) return false;
+  sourceList.add(path);
+  const links = plugin.app.metadataCache.resolvedLinks[path];
+  if(!links) return false;
+  for(const link of Object.keys(links)) {
+    if(sourceList.has(link)) continue;
+    const file = plugin.app.vault.getAbstractFileByPath(link);
+    if(!file || !(file instanceof TFile)) continue;
+    console.log(path, {mtimeLinked: file.stat.mtime, mtimeSource: mtime, path: file.path});
+    if(file.stat.mtime > mtime) return true;
+    if(plugin.isExcalidrawFile(file)) {
+      if(haveLinkedFilesChanged(depth, mtime, file.path, sourceList, plugin)) return true;
+    }
+  }
+  return false;
+}
+
+const listOfOutOfSyncImgExports = async(plugin: ExcalidrawPlugin, recursive: boolean, statusEl: HTMLParagraphElement):Promise<TFile[]> => {
+  const app = plugin.app;
+
+  const publish = app.internalPlugins.plugins["publish"].instance;
+  if(!publish) return;
+  const list = await app.internalPlugins.plugins["publish"].instance.apiList();
+  if(!list || !list.files) return;
+  const outOfSyncFiles = new Set<TFile>();
+  const allFiles = list.files.filter((f:any)=>(f.path.endsWith(".svg") || f.path.endsWith(".png")))
+  const totalCount = allFiles.length;
+  allFiles.forEach((f:any, idx:number)=>{
+    const maybeExcalidraFilePath = getIMGFilename(f.path,"md");
+    const imgFile = app.vault.getAbstractFileByPath(f.path);
+    const excalidrawFile = app.vault.getAbstractFileByPath(maybeExcalidraFilePath);
+    statusEl.innerText = `Status: ${idx+1}/${totalCount} ${imgFile ? imgFile.name : f.path}`;
+    if(!excalidrawFile || !imgFile || !(excalidrawFile instanceof TFile) || !(imgFile instanceof TFile)) return;
+    if(excalidrawFile.stat.mtime <= imgFile.stat.mtime) {
+      if(!recursive) return;
+      if(!haveLinkedFilesChanged(0, excalidrawFile.stat.mtime, excalidrawFile.path, new Set<string>(), plugin)) return;
+    }
+    outOfSyncFiles.add(excalidrawFile);
+  });
+  return Array.from(outOfSyncFiles);
+}
+
+export class PublishOutOfDateFilesDialog extends Modal {
+  constructor(
+    private plugin: ExcalidrawPlugin,
+  ) {
+    super(plugin.app);
+  }
+
+  async onClose() {}
+
+  onOpen() {
+    this.containerEl.classList.add("excalidraw-release");
+    this.titleEl.setText(`Out of Date SVG Files`); 
+    this.createForm(false);
+  }
+
+  async createForm(recursive: boolean) {
+    const detailsEl = this.contentEl.createEl("details");
+    detailsEl.createEl("summary", { 
+      text: "Video about Obsidian Publish support",
+    });
+    detailsEl.createEl("br");
+    addIframe(detailsEl, "JC1E-jeiWhI");
+    const p = this.contentEl.createEl("p",{text: "Collecting data..."});
+    const statusEl = this.contentEl.createEl("p", {text: "Status: "});
+    const files = await listOfOutOfSyncImgExports(this.plugin, recursive, statusEl);
+    statusEl.style.display = "none";
+
+    if(!files || files.length === 0) {
+      p.innerText = "No out of date files found.";
+      const div = this.contentEl.createDiv({cls: "excalidraw-prompt-buttons-div"});
+      const bClose = div.createEl("button", { text: "Close", cls: "excalidraw-prompt-button"});
+      bClose.onclick = () => {
+        this.close();
+      };
+      if(!recursive) {
+        const bRecursive = div.createEl("button", { text: "Check Recursive", cls: "excalidraw-prompt-button"});
+        bRecursive.onclick = () => {
+          this.contentEl.empty();
+          this.createForm(true);
+        };
+      }
+      return;
+    }
+
+    const filesMap = new Map<TFile,boolean>();
+    p.innerText = "Select files to open.";
+    files.forEach((f:TFile) => {
+      filesMap.set(f,true);
+      new Setting(this.contentEl)
+        .setName(f.path)
+        .addToggle(toggle => toggle
+          .setValue(true)
+          .onChange(value => {
+            filesMap.set(f,value);
+          })
+        )
+    });
+
+    const div = this.contentEl.createDiv({cls: "excalidraw-prompt-buttons-div"});
+    const bClose = div.createEl("button", { text: "Close", cls: "excalidraw-prompt-button"});
+    bClose.onclick = () => {
+      this.close();
+    };
+    if(!recursive) {
+      const bRecursive = div.createEl("button", { text: "Check Recursive", cls: "excalidraw-prompt-button"});
+      bRecursive.onclick = () => {
+        this.contentEl.empty();
+        this.createForm(true);
+      };
+    }
+    const bOpen = div.createEl("button", { text: "Open Selected", cls: "excalidraw-prompt-button" });
+    bOpen.onclick = () => {
+      filesMap.forEach((value:boolean,key:TFile) => {
+        if(value) {
+          this.plugin.openDrawing(key,"new-tab",true);
+        }
+      });
+      this.close();
+    };
+  }
+}

src/lang/locale/en.ts

@@ -9,6 +9,9 @@ import { labelALT, labelCTRL, labelMETA, labelSHIFT } from "src/utils/Modifierke
 // English
 export default {
   // main.ts
+  PUBLISH_SVG_CHECK: "Obsidian Publish: Find SVG and PNG exports that are out of date",
+  EMBEDDABLE_PROPERTIES: "Embeddable Properties",
+  OPEN_IMAGE_SOURCE: "Open Excalidraw drawing",
   INSTALL_SCRIPT: "Install the script",
   UPDATE_SCRIPT: "Update available - Click to install",
   CHECKING_SCRIPT:
@@ -62,7 +65,7 @@ export default {
   IMPORT_SVG: "Import an SVG file as Excalidraw strokes (limited SVG support, TEXT currently not supported)",
   INSERT_MD: "Insert markdown file from vault",
   INSERT_PDF: "Insert PDF file from vault",
-  UNIVERSAL_ADD_FILE: "Insert ANY file from your Vault to the active drawing",
+  UNIVERSAL_ADD_FILE: "Insert ANY file",
   INSERT_LATEX:
     `Insert LaTeX formula (e.g. \\binom{n}{k} = \\frac{n!}{k!(n-k)!}). ${labelALT()}+CLICK to watch a help video.`,
   ENTER_LATEX: "Enter a valid LaTeX expression",
@@ -100,6 +103,7 @@ export default {
   ERROR_SAVING_IMAGE: "Unknown error occured while fetching the image. It could be that for some reason the image is not available or rejected the fetch request from Obsidian",
   WARNING_PASTING_ELEMENT_AS_TEXT: "PASTING EXCALIDRAW ELEMENTS AS A TEXT ELEMENT IS NOT ALLOWED",
   USE_INSERT_FILE_MODAL: "Use 'Insert Any File' to embed a markdown note",
+  CONVERT_TO_MARKDOWN: "Convert to file...",
 
   //settings.ts
   RELEASE_NOTES_NAME: "Display Release Notes after update",
@@ -111,6 +115,8 @@ export default {
       "<b><u>Toggle ON:</u></b> Show a notification when a new version of the plugin is available.<br>" +
       "<b><u>Toggle OFF:</u></b> Silent mode. You need to check for plugin updates in Community Plugins.",
   
+  BASIC_HEAD: "Basic",
+  BASIC_DESC: `In the "Basic" settings, you can configure options such as displaying release notes after updates, receiving plugin update notifications, setting the default location for new drawings, specifying the Excalidraw folder for embedding drawings into active documents, defining an Excalidraw template file, and designating an Excalidraw Automate script folder for managing automation scripts.`,
   FOLDER_NAME: "Excalidraw folder",
   FOLDER_DESC:
     "Default location for new drawings. If empty, drawings will be created in the Vault root.",
@@ -134,6 +140,7 @@ export default {
     "hotkeys to your favorite scripts just like to any other Obsidian command. " +
     "The folder may not be the root folder of your Vault. ",
   SAVING_HEAD: "Saving",
+  SAVING_DESC: "In the 'Saving' section of Excalidraw Settings, you can configure how your drawings are saved. This includes options for compressing Excalidraw JSON in Markdown, setting autosave intervals for both desktop and mobile, defining filename formats, and choosing whether to use the .excalidraw.md or .md file extension. ",
   COMPRESS_NAME: "Compress Excalidraw JSON in Markdown",
   COMPRESS_DESC:
     "By enabling this feature Excalidraw will store the drawing JSON in a Base64 compressed " +
@@ -181,7 +188,8 @@ FILENAME_HEAD: "Filename",
   FILENAME_EXCALIDRAW_EXTENSION_DESC:
     "This setting does not apply if you use Excalidraw in compatibility mode, " +
     "i.e. you are not using Excalidraw markdown files.<br><b><u>Toggle ON:</u></b> filename ends with .excalidraw.md<br><b><u>Toggle OFF:</u></b> filename ends with .md",
-  DISPLAY_HEAD: "Display",
+  DISPLAY_HEAD: "Excalidraw appearance and behavior",
+  DISPLAY_DESC: "In the 'appearance and behavior' section of Excalidraw Settings, you can fine-tune how Excalidraw appears and behaves. This includes options for dynamic styling, left-handed mode, matching Excalidraw and Obsidian themes, default modes, and more.",
   DYNAMICSTYLE_NAME: "Dynamic styling",
   DYNAMICSTYLE_DESC:
     "Change Excalidraw UI colors to match the canvas color",
@@ -214,7 +222,8 @@ FILENAME_HEAD: "Filename",
   DEFAULT_PEN_MODE_NAME: "Pen mode",
   DEFAULT_PEN_MODE_DESC:
     "Should pen mode be automatically enabled when opening Excalidraw?",
-
+  THEME_HEAD: "Theme and styling",
+  ZOOM_HEAD: "Zoom",
   DEFAULT_PINCHZOOM_NAME: "Allow pinch zoom in pen mode",
   DEFAULT_PINCHZOOM_DESC:
     "Pinch zoom in pen mode when using the freedraw tool is disabled by default to prevent unwanted accidental zooming with your palm.<br>" +
@@ -233,7 +242,14 @@ FILENAME_HEAD: "Filename",
   ZOOM_TO_FIT_MAX_LEVEL_NAME: "Zoom to fit max ZOOM level",
   ZOOM_TO_FIT_MAX_LEVEL_DESC:
     "Set the maximum level to which zoom to fit will enlarge the drawing. Minimum is 0.5 (50%) and maximum is 10 (1000%).",
-  LINKS_HEAD: "Links and transclusion",
+  LASER_HEAD: "Laser pointer",
+  LASER_COLOR: "Laser pointer color",
+  LASER_DECAY_TIME_NAME: "Laser pointer decay time",
+  LASER_DECAY_TIME_DESC: "Laser pointer decay time in milliseconds. Default is 1000 (i.e. 1 second).",
+  LASER_DECAY_LENGTH_NAME: "Laser pointer decay length.",
+  LASER_DECAY_LENGTH_DESC: "Laser pointer decay length in line points. Default is 50.",
+  LINKS_HEAD: "Links, transclusion and TODOs",
+  LINKS_HEAD_DESC: "In the 'Links, transclusion and TODOs' section of Excalidraw Settings, you can configure how Excalidraw handles links, transclusions, and TODO items. This includes options for opening links, managing panes, displaying links with brackets, customizing link prefixes, handling TODO items, and more. ",
   LINKS_DESC:
     `${labelCTRL()}+CLICK on <code>[[Text Elements]]</code> to open them as links. ` +
     "If the selected text has more than one <code>[[valid Obsidian links]]</code>, only the first will be opened. " +
@@ -243,13 +259,13 @@ FILENAME_HEAD: "Filename",
     "If you don't want text accidentally changing in your drawings use <code>[[links|with aliases]]</code>.",
   ADJACENT_PANE_NAME: "Reuse adjacent pane",
   ADJACENT_PANE_DESC:
-    `When ${labelCTRL()}+${labelSHIFT()} clicking a link in Excalidraw, by default the plugin will open the link in a new pane. ` +
+    `When ${labelCTRL()}+${labelALT()} clicking a link in Excalidraw, by default the plugin will open the link in a new pane. ` +
     "Turning this setting on, Excalidraw will first look for an existing pane, and try to open the link there. " +
     "Excalidraw will look for the other workspace pane based on your focus/navigation history, i.e. the workpane that was active before you " +
     "activated Excalidraw.",
   MAINWORKSPACE_PANE_NAME: "Open in main workspace",
   MAINWORKSPACE_PANE_DESC:
-    `When ${labelCTRL()}+${labelSHIFT()} clicking a link in Excalidraw, by default the plugin will open the link in a new pane in the current active window. ` +
+    `When ${labelCTRL()}+${labelALT()} clicking a link in Excalidraw, by default the plugin will open the link in a new pane in the current active window. ` +
     "Turning this setting on, Excalidraw will open the link in an existing or new pane in the main workspace. ",  
   LINK_BRACKETS_NAME: "Show <code>[[brackets]]</code> around links",
   LINK_BRACKETS_DESC: `${
@@ -267,7 +283,7 @@ FILENAME_HEAD: "Filename",
     "You can override this setting for a specific drawing by adding <code>"
   }${FRONTMATTER_KEY_CUSTOM_URL_PREFIX}: "🌐 "</code> to the file's frontmatter.`,
   PARSE_TODO_NAME: "Parse todo",
-  PARSE_TODO_DESC: "Convert '- [ ] ' and '- [x] ' to checkpox and tick in the box.",
+  PARSE_TODO_DESC: "Convert '- [ ] ' and '- [x] ' to checkbox and tick in the box.",
   TODO_NAME: "Open TODO icon",
   TODO_DESC: "Icon to use for open TODO items",
   DONE_NAME: "Completed TODO icon",
@@ -305,11 +321,15 @@ FILENAME_HEAD: "Filename",
   GET_URL_TITLE_NAME: "Use iframely to resolve page title",
   GET_URL_TITLE_DESC:
     "Use the <code>http://iframely.server.crestify.com/iframely?url=</code> to get title of page when dropping a link into Excalidraw",
-  MD_HEAD: "Markdown-embed settings",
-  MD_HEAD_DESC:
-    `You can transclude formatted markdown documents into drawings as images ${labelSHIFT()} drop from the file explorer or using ` +
-    "the command palette action.",
-  
+  PDF_TO_IMAGE: "PDF to Image",
+  PDF_TO_IMAGE_SCALE_NAME: "PDF to Image conversion scale",
+  PDF_TO_IMAGE_SCALE_DESC: "Sets the resolution of the image that is generated from the PDF page. Higher resolution will result in bigger images in memory and consequently a higher load on your system (slower performance), but sharper imagee. " +
+    "Additionally, if you want to copy PDF pages (as images) to Excalidraw.com, the bigger image size may result in exceeding the 2MB limit on Excalidraw.com.",
+  EMBED_TOEXCALIDRAW_HEAD: "Embed files into Excalidraw",
+  EMBED_TOEXCALIDRAW_DESC: "In the Embed Files section of Excalidraw Settings, you can configure how various files are embedded into Excalidraw. This includes options for embedding interactive markdown files, PDFs, and markdown files as images.",
+  MD_HEAD: "Embed markdown into Excalidraw as image",
+  MD_EMBED_CUSTOMDATA_HEAD_NAME: "Interactive Markdown Files",
+  MD_EMBED_CUSTOMDATA_HEAD_DESC: `These settings will only effect future embeds. Current embeds remain unchanged. The theme setting of embedded frames is under the "Excalidraw appearance and behavior" section.`,
   MD_TRANSCLUDE_WIDTH_NAME: "Default width of a transcluded markdown document",
   MD_TRANSCLUDE_WIDTH_DESC:
     "The width of the markdown page. This affects the word wrapping when transcluding longer paragraphs, and the width of " +
@@ -345,8 +365,16 @@ FILENAME_HEAD: "Filename",
     "Setting the font-family in the css is has limitations. By default only your operating system's standard fonts are available (see README for details). " +
     "You can add one custom font beyond that using the setting above. " +
     'You can override this css setting by adding the following frontmatter-key to the embedded markdown file: "excalidraw-css: css_file_in_vault|css-snippet".',
-  EMBED_HEAD: "Embed & Export",
+  EMBED_HEAD: "Embedding Excalidraw into your Notes and Exporting",
+  EMBED_DESC: `In the "Embed & Export" settings, you can configure how images and Excalidraw drawings are embedded and exported within your documents. Key settings include choosing the image type for markdown preview (such as Native SVG or PNG), specifying the type of file to insert into the document (original Excalidraw, PNG, or SVG), and managing image caching for embedding in markdown. You can also control image sizing, whether to embed drawings using wiki links or markdown links, and adjust settings related to image themes, background colors, and Obsidian integration. 
+    Additionally, there are settings for auto-export, which automatically generates SVG and/or PNG files to match the title of your Excalidraw drawings, keeping them in sync with file renames and deletions.`,
+  EMBED_CANVAS: "Obsidian Canvas support",
+  EMBED_CANVAS_NAME: "Immersive embedding",
+  EMBED_CANVAS_DESC: 
+    "Hide canvas node border and background when embedding an Excalidraw drawing to Canvas. " +
+    "Note that for a full transparent background for your image, you will still need to configure Excalidraw to export images with transparent background.",
   EMBED_CACHING: "Image caching",
+  EXPORT_SUBHEAD: "Export Settings",
   EMBED_SIZING: "Image sizing",
   EMBED_THEME_BACKGROUND: "Image theme and background color",
   EMBED_IMAGE_CACHE_NAME: "Cache images for embedding in markdown",
@@ -387,6 +415,11 @@ FILENAME_HEAD: "Filename",
     "or a PNG or an SVG copy. You need to enable auto-export PNG / SVG (see below under Export Settings) for those image types to be available in the dropdown. For drawings that do not have a " +
     "a corresponding PNG or SVG readily available the command palette action will insert a broken link. You need to open the original drawing and initiate export manually. " +
     "This option will not autogenerate PNG/SVG files, but will simply reference the already existing files.",
+  EMBED_MARKDOWN_COMMENT_NAME: "Embed link to drawing as comment",
+  EMBED_MARKDOWN_COMMENT_DESC: 
+    "Embed the link to the original Excalidraw file as a markdown link under the image, e.g.:<code>%%[[drawing.excalidraw]]%%</code>.<br>" +
+    "Instead of adding a markdown comment you may also select the embedded SVG or PNG line and use the command palette action: " +
+    "'<code>Excalidraw: Open Excalidraw drawing</code>' to open the drawing.",
   EMBED_WIKILINK_NAME: "Embed Drawing using Wiki link",
   EMBED_WIKILINK_DESC:
     "<b><u>Toggle ON:</u></b> Excalidraw will embed a [[wiki link]].<br><b><u>Toggle OFF:</u></b> Excalidraw will embed a [markdown](link).",
@@ -417,13 +450,14 @@ FILENAME_HEAD: "Filename",
     "Embed the .svg file into your documents instead of Excalidraw making you embeds platform independent. " +
     "While the auto-export switch is on, this file will get updated every time you edit the Excalidraw drawing with the matching name. " + 
     "You can override this setting on a file level by adding the <code>excalidraw-autoexport</code> frontmatter key. Valid values for this key are " +
-    "<code>none</code>,<code>both</code>,<code>svg</code>, and <code>png</code>",
+    "<code>none</code>,<code>both</code>,<code>svg</code>, and <code>png</code>.",
   EXPORT_PNG_NAME: "Auto-export PNG",
   EXPORT_PNG_DESC: "Same as the auto-export SVG, but for *.PNG",
   EXPORT_BOTH_DARK_AND_LIGHT_NAME: "Export both dark- and light-themed image",
   EXPORT_BOTH_DARK_AND_LIGHT_DESC:  "When enabled, Excalidraw will export two files instead of one: filename.dark.png, filename.light.png and/or filename.dark.svg and filename.light.svg<br>"+
     "Double files will be exported both if auto-export SVG or PNG (or both) are enabled, as well as when clicking export on a single image.",
   COMPATIBILITY_HEAD: "Compatibility features",
+  COMPATIBILITY_DESC: "You should only enable these features if you have a strong reason for wanting to work with excalidraw.com files instead of markdown files. Many of the plugin features are not supported on legacy files. Typical usecase would be if you use set your vault up on top of a Visual Studio Code project folder and you have .excalidraw drawings you want to access from Visual Studio Code as well. Another usecase might be using Excalidraw in Logseq and Obsidian in parallel.",
   EXPORT_EXCALIDRAW_NAME: "Auto-export Excalidraw",
   EXPORT_EXCALIDRAW_DESC: "Same as the auto-export SVG, but for *.Excalidraw",
   SYNC_EXCALIDRAW_NAME:
@@ -433,22 +467,24 @@ FILENAME_HEAD: "Filename",
     "then update the drawing in the .md file based on the .excalidraw file",
   COMPATIBILITY_MODE_NAME: "New drawings as legacy files",
   COMPATIBILITY_MODE_DESC:
+    "⚠️ Enable this only if you know what you are doing. In 99.9% of the cases you DO NOT want this on. " +
     "By enabling this feature drawings you create with the ribbon icon, the command palette actions, " +
     "and the file explorer are going to be all legacy *.excalidraw files. This setting will also turn off the reminder message " +
     "when you open a legacy file for editing.",
   MATHJAX_NAME: "MathJax (LaTeX) javascript library host",
-  MATHJAX_DESC: "If you are using LaTeX equiations in Excalidraw then the plugin needs to load a javascript library for that. " + 
-    "Some users are unable to access certain host servers. If you are experiencing issues try changing the host here. You may need to "+
+  MATHJAX_DESC: "If you are using LaTeX equations in Excalidraw, then the plugin needs to load a javascript library for that. " + 
+    "Some users are unable to access certain host servers. If you are experiencing issues, try changing the host here. You may need to "+
     "restart Obsidian after closing settings, for this change to take effect.",
-  LATEX_DEFAULT_NAME: "Default LaTeX formual for new equations",
+  LATEX_DEFAULT_NAME: "Default LaTeX formula for new equations",
   LATEX_DEFAULT_DESC: "Leave empty if you don't want a default formula. You can add default formatting here such as <code>\\color{white}</code>.",
   NONSTANDARD_HEAD: "Non-Excalidraw.com supported features",
-  NONSTANDARD_DESC: "These features are not available on excalidraw.com. When exporting the drawing to Excalidraw.com these features will appear different.",
+  NONSTANDARD_DESC: `These settings in the "Non-Excalidraw.com Supported Features" section provide customization options beyond the default Excalidraw.com features. These features are not available on excalidraw.com. When exporting the drawing to Excalidraw.com these features will appear different.
+    You can configure the number of custom pens displayed next to the Obsidian Menu on the canvas, allowing you to choose from a range of options. Additionally, you can enable a fourth font option, which adds a fourth font button to the properties panel for text elements. `,
+  CUSTOM_PEN_HEAD: "Custom pens",
   CUSTOM_PEN_NAME: "Number of custom pens",
   CUSTOM_PEN_DESC: "You will see these pens next to the Obsidian Menu on the canvas. You can customize the pens on the canvas by long-pressing the pen button.",
-  EXPERIMENTAL_HEAD: "Experimental features",
-  EXPERIMENTAL_DESC:
-    "Some of these setting will not take effect immediately, only when the File Explorer is refreshed, or Obsidian restarted.",
+  EXPERIMENTAL_HEAD: "Miscellaneous features",
+  EXPERIMENTAL_DESC: `These miscellaneous features in Excalidraw include options for setting default LaTeX formulas for new equations, enabling a Field Suggester for autocompletion, displaying type indicators for Excalidraw files, enabling immersive image embedding in live preview editing mode, and experimenting with Taskbone Optical Character Recognition for text extraction from images and drawings. Users can also enter a Taskbone API key for extended usage of the OCR service.`,
   FIELD_SUGGESTER_NAME: "Enable Field Suggester",
   FIELD_SUGGESTER_DESC:
     "Field Suggester borrowed from Breadcrumbs and Templater plugins. The Field Suggester will show an autocomplete menu " +
@@ -464,6 +500,7 @@ FILENAME_HEAD: "Filename",
     "Turn this on to support image embedding styles such as ![[drawing|width|style]] in live preview editing mode. " +
     "The setting will not affect the currently open documents. You need close the open documents and re-open them for the change " +
     "to take effect.",
+  CUSTOM_FONT_HEAD: "Fourth font",
   ENABLE_FOURTH_FONT_NAME: "Enable fourth font option",
   ENABLE_FOURTH_FONT_DESC:
     "By turning this on, you will see a fourth font button on the properties panel for text elements. " +
@@ -475,6 +512,7 @@ FILENAME_HEAD: "Filename",
     "Select a .ttf, .woff or .woff2 font file from your vault to use as the fourth font. " +
     "If no file is selected, Excalidraw will use the Virgil font by default.",
   SCRIPT_SETTINGS_HEAD: "Settings for installed Scripts",
+  SCRIPT_SETTINGS_DESC: "Some of the Excalidraw Automate Scripts include settings. Settings are organized by script. Settings will only become visible in this list after you have executed the newly downloaded script once.",
   TASKBONE_HEAD: "Taskbone Optical Character Recogntion",
   TASKBONE_DESC: "This is an experimental integration of optical character recognition into Excalidraw. Please note, that taskbone is an independent external service not provided by Excalidraw, nor the Excalidraw-Obsidian plugin project. " +
     "The OCR service will grab legible text from freedraw lines and embedded pictures on your canvas and place the recognized text in the frontmatter of your drawing as well as onto clipboard. " +
@@ -524,7 +562,7 @@ FILENAME_HEAD: "Filename",
   TOGGLE_DISABLEBINDING: "Toggle to invert default binding behavior",
   TOGGLE_FRAME_RENDERING: "Toggle frame rendering",
   TOGGLE_FRAME_CLIPPING: "Toggle frame clipping",
-  OPEN_LINK_CLICK: "Navigate to selected element link",
+  OPEN_LINK_CLICK: "Open Link",
   OPEN_LINK_PROPS: "Open markdown-embed properties or open link in new window",
 
   //IFrameActionsMenu.tsx
@@ -534,6 +572,27 @@ FILENAME_HEAD: "Filename",
   ZOOM_TO_FIT: "Zoom to fit",
   RELOAD: "Reload original link",
   OPEN_IN_BROWSER: "Open current link in browser",
+  PROPERTIES: "Properties",
+
+  //EmbeddableSettings.tsx
+  ES_TITLE: "Element Settings",
+  ES_RENAME: "Rename File",
+  ES_ZOOM: "Embedded Content Zoom",
+  ES_YOUTUBE_START: "YouTube Start Time",
+  ES_YOUTUBE_START_DESC: "ss, mm:ss, hh:mm:ss",
+  ES_YOUTUBE_START_INVALID: "The YouTube Start Time is invalid. Please check the format and try again",
+  ES_FILENAME_VISIBLE: "Filename Visible",
+  ES_BACKGROUND_HEAD: "Embedded note background color",
+  ES_BACKGROUND_MATCH_ELEMENT: "Match Element Background Color",
+  ES_BACKGROUND_MATCH_CANVAS: "Match Canvas Background Color",
+  ES_BACKGROUND_COLOR: "Background Color",
+  ES_BORDER_HEAD: "Embedded note border color",
+  ES_BORDER_COLOR: "Border Color",
+  ES_BORDER_MATCH_ELEMENT: "Match Element Border Color",
+  ES_BACKGROUND_OPACITY: "Background Transparency",
+  ES_BORDER_OPACITY: "Border Transparency",
+  ES_EMBEDDABLE_SETTINGS: "Embeddable Markdown Settings",
+  ES_USE_OBSIDIAN_DEFAULTS: "Use Obsidian Defaults",
 
   //Prompts.ts
   PROMPT_FILE_DOES_NOT_EXIST: "File does not exist. Do you want to create it?",

src/main.ts

@@ -21,7 +21,6 @@ import {
   Editor,
   MarkdownFileInfo,
   loadMermaid,
-  moment,
 } from "obsidian";
 import {
   BLANK_DRAWING,
@@ -38,13 +37,15 @@ import {
   DARK_BLANK_DRAWING,
   SCRIPT_INSTALL_CODEBLOCK,
   SCRIPT_INSTALL_FOLDER,
-  VIRGIL_FONT,
-  VIRGIL_DATAURL,
   EXPORT_TYPES,
   EXPORT_IMG_ICON_NAME,
   EXPORT_IMG_ICON,
   LOCALE,
 } from "./constants";
+import {
+  VIRGIL_FONT,
+  VIRGIL_DATAURL,
+} from "./constFonts";
 import ExcalidrawView, { TextMode, getTextMode } from "./ExcalidrawView";
 import {
   changeThemeOfExcalidrawMD,
@@ -90,9 +91,9 @@ import {
   getExportTheme,
   isCallerFromTemplaterPlugin,
 } from "./utils/Utils";
-import { getAttachmentsFolderAndFilePath, getNewOrAdjacentLeaf, getParentOfClass, isObsidianThemeDark } from "./utils/ObsidianUtils";
+import { extractSVGPNGFileName, getAttachmentsFolderAndFilePath, getNewOrAdjacentLeaf, getParentOfClass, isObsidianThemeDark } from "./utils/ObsidianUtils";
 //import { OneOffs } from "./OneOffs";
-import { ExcalidrawElement, ExcalidrawImageElement, FileId } from "@zsviczian/excalidraw/types/element/types";
+import { ExcalidrawElement, ExcalidrawEmbeddableElement, ExcalidrawImageElement, ExcalidrawTextElement, FileId } from "@zsviczian/excalidraw/types/element/types";
 import { ScriptEngine } from "./Scripts";
 import {
   hoverEvent,
@@ -115,6 +116,8 @@ import { UniversalInsertFileModal } from "./dialogs/UniversalInsertFileModal";
 import { imageCache } from "./utils/ImageCache";
 import { StylesManager } from "./utils/StylesManager";
 import { MATHJAX_SOURCE_LZCOMPRESSED } from "./constMathJaxSource";
+import { PublishOutOfDateFilesDialog } from "./dialogs/PublishOutOfDateFiles";
+import { EmbeddableSettings } from "./dialogs/EmbeddableSettings";
 
 declare const EXCALIDRAW_PACKAGES:string;
 declare const react:any;
@@ -154,7 +157,6 @@ export default class ExcalidrawPlugin extends Plugin {
   public equationsMaster: Map<FileId, string> = null; //fileId, formula
   public mermaidsMaster: Map<FileId, string> = null; //fileId, mermaidText
   public mathjax: any = null;
-  private mathjaxDiv: HTMLDivElement = null;
   public mathjaxLoaderFinished: boolean = false;
   public scriptEngine: ScriptEngine;
   public fourthFontDef: string = VIRGIL_FONT;
@@ -294,11 +296,91 @@ export default class ExcalidrawPlugin extends Plugin {
     });
   }
 
+  private removeMathJax() {
+    if("ExcalidrawMathJax" in window) {
+      delete window.ExcalidrawMathJax;
+    }
+    const scriptElement = document.getElementById("ExcalidrawMathJax");
+    if(scriptElement) {
+      scriptElement.parentNode.removeChild(scriptElement);
+    }
+  }
+
   public loadMathJax() {
     const self = this;
     this.app.workspace.onLayoutReady(async () => {
       //loading Obsidian MathJax as fallback
       await loadMathJax();
+      //@ts-ignore
+      const backup = window.MathJax;
+      try {
+        this.removeMathJax();
+        const script = document.createElement("script");
+        script.setAttribute("id","ExcalidrawMathJax");
+        script.type = "text/javascript";
+        script.onload = () => {
+          //@ts-ignore
+          window.ExcalidrawMathJax.startup.pagePromise.then(async () => {
+
+            // Set the 'all' package to load all MathJax modules
+            const mathJaxConfig = {
+              tex: {
+                packages: { '[+]': ['all'] }, //this is required because during runtime loading fails due to the renaming of the package
+                // Add any other configurations you need here
+              },
+            };
+
+            // Set the MathJax configuration
+            //@ts-ignore
+            window.ExcalidrawMathJax = {
+              //@ts-ignore
+              ...window.ExcalidrawMathJax,
+              options: {
+                //@ts-ignore
+                ...window.ExcalidrawMathJax.options,
+                ...mathJaxConfig,
+              },
+            };
+            
+            //https://github.com/xldenis/obsidian-latex/blob/master/main.ts
+            const file = this.app.vault.getAbstractFileByPath("preamble.sty");
+            const preamble: string =
+              file && file instanceof TFile
+                ? await this.app.vault.read(file)
+                : null;
+            try {
+              if (preamble) {
+                //@ts-ignore
+                await window.ExcalidrawMathJax.tex2svg(preamble);
+              }
+            } catch (e) {
+              errorlog({
+                where: self.loadMathJax,
+                description: "Unexpected error while loading preamble.sty",
+                error: e,
+              });
+            }
+            //@ts-ignore
+            self.mathjax = window.ExcalidrawMathJax;
+            self.mathjaxLoaderFinished = true;
+          });
+        };
+        script.src = "data:text/javascript;base64," + decompressFromBase64(MATHJAX_SOURCE_LZCOMPRESSED); //self.settings.mathjaxSourceURL; // "https://cdn.jsdelivr.net/npm/mathjax@3.2.2/es5/tex-svg.js";
+        //script.src = MATHJAX_DATAURL;
+        document.head.appendChild(script);
+      } catch {
+        new Notice("Excalidraw: Error initializing LaTeX support");
+        self.mathjaxLoaderFinished = true;
+      }
+    });
+  }
+
+/*  public loadMathJax() {
+    const self = this;
+    this.app.workspace.onLayoutReady(async () => {
+      //loading Obsidian MathJax as fallback
+      await loadMathJax();
+      //@ts-ignore
       try {
         if(self.mathjaxDiv) {
           document.body.removeChild(self.mathjaxDiv);
@@ -350,7 +432,7 @@ export default class ExcalidrawPlugin extends Plugin {
         self.mathjaxLoaderFinished = true;
       }
     });
-  }
+  }*/
 
   private switchToExcalidarwAfterLoad() {
     const self = this;
@@ -612,7 +694,7 @@ export default class ExcalidrawPlugin extends Plugin {
       const leaves = this.app.workspace.getLeavesOfType(VIEW_TYPE_EXCALIDRAW);
       leaves.forEach((leaf: WorkspaceLeaf) => {
         const excalidrawView = leaf.view as ExcalidrawView;
-        if (excalidrawView.file && excalidrawView.excalidrawRef) {
+        if (excalidrawView.file && excalidrawView.excalidrawAPI) {
           excalidrawView.setTheme(theme);
         }
       });
@@ -757,6 +839,70 @@ export default class ExcalidrawPlugin extends Plugin {
       ),
     );
 
+    this.addCommand({
+      id: "excalidraw-publish-svg-check",
+      name: t("PUBLISH_SVG_CHECK"),
+      checkCallback: (checking: boolean) => {
+        const publish = app.internalPlugins.plugins["publish"].instance;
+        if (!publish) {
+          return false;
+        }
+        if (checking) {
+          return true;
+        }
+        (new PublishOutOfDateFilesDialog(this)).open();
+      }
+    })
+
+    this.addCommand({
+      id: "excalidraw-embeddable-poroperties",
+      name: t("EMBEDDABLE_PROPERTIES"),
+      checkCallback: (checking: boolean) => {
+        const view = this.app.workspace.getActiveViewOfType(ExcalidrawView);
+        if(!view) return false;
+        if(!view.excalidrawAPI) return false;
+        const els = view.getViewSelectedElements().filter(el=>el.type==="embeddable") as ExcalidrawEmbeddableElement[];
+        if(els.length !== 1) {
+          if(checking) return false;
+          new Notice("Select a single embeddable element and try again");
+          return false;
+        }
+        if(checking) return true;
+        new EmbeddableSettings(view.plugin,view,null,els[0]).open();
+      }
+    })
+
+    this.addCommand({
+      id: "open-image-excalidraw-source",
+      name: t("OPEN_IMAGE_SOURCE"),
+      checkCallback: (checking: boolean) => {
+        const view = this.app.workspace.getActiveViewOfType(MarkdownView);
+        if(!view) return false;
+        if(view.leaf !== this.app.workspace.activeLeaf) return false;
+        const editor = view.editor;
+        if(!editor) return false;
+        const cursor = editor.getCursor();
+        const line = editor.getLine(cursor.line);
+        const fname = extractSVGPNGFileName(line);
+        if(!fname) return false;
+        const imgFile = this.app.metadataCache.getFirstLinkpathDest(fname, view.file.path);
+        if(!imgFile) return false;
+        const excalidrawFname = getIMGFilename(imgFile.path, "md");
+        let excalidrawFile = this.app.metadataCache.getFirstLinkpathDest(excalidrawFname, view.file.path);
+        if(!excalidrawFile) {
+          if(excalidrawFname.endsWith(".dark.md")) {
+            excalidrawFile = this.app.metadataCache.getFirstLinkpathDest(excalidrawFname.replace(/\.dark\.md$/,".md"), view.file.path);
+          }
+          if(excalidrawFname.endsWith(".light.md")) {
+            excalidrawFile = this.app.metadataCache.getFirstLinkpathDest(excalidrawFname.replace(/\.light\.md$/,".md"), view.file.path);
+          }
+          if(!excalidrawFile) return false;
+        }
+        if(checking) return true;
+        this.openDrawing(excalidrawFile, "new-tab", true);
+      }
+    });
+
     this.addCommand({
       id: "excalidraw-disable-autosave",
       name: t("TEMPORARY_DISABLE_AUTOSAVE"),
@@ -1162,6 +1308,22 @@ export default class ExcalidrawPlugin extends Plugin {
       },
     });
 
+    this.addCommand({
+      id: "convert-text2MD",
+      name: t("CONVERT_TO_MARKDOWN"),
+      checkCallback: (checking: boolean) => {
+        const view = this.app.workspace.getActiveViewOfType(ExcalidrawView)
+        if(!view) return false;
+        const selectedTextElements = view.getViewSelectedElements().filter(el=>el.type === "text");
+        if(selectedTextElements.length !==1 ) return false;
+        const selectedTextElement = selectedTextElements[0] as ExcalidrawTextElement;
+        const containerElement = (view.getViewElements() as ExcalidrawElement[]).find(el=>el.id === selectedTextElement.containerId);
+        if(containerElement && containerElement.type === "arrow") return false;
+        if(checking) return true;
+        view.convertTextElementToMarkdown(selectedTextElement, containerElement);
+      }
+    })
+
     this.addCommand({
       id: "insert-link",
       hotkeys: [{ modifiers: ["Ctrl" || "Meta", "Shift"], key: "k" }],
@@ -1172,7 +1334,7 @@ export default class ExcalidrawPlugin extends Plugin {
         }
         const view = this.app.workspace.getActiveViewOfType(ExcalidrawView);
         if (view) {
-          this.insertLinkDialog.start(view.file.path, view.addText);
+          this.insertLinkDialog.start(view.file.path, view.addLink);
           return true;
         }
         return false;
@@ -1376,7 +1538,7 @@ export default class ExcalidrawPlugin extends Plugin {
       checkCallback: (checking: boolean) => {
         if (checking) {
           const view = this.app.workspace.getActiveViewOfType(ExcalidrawView);
-          if (!view || !view.excalidrawRef) {
+          if (!view || !view.excalidrawAPI) {
             return false;
           }
           const st = view.excalidrawAPI.getAppState();
@@ -1870,7 +2032,7 @@ export default class ExcalidrawPlugin extends Plugin {
         }
 
         //close excalidraw view where this file is open
-        const leaves = app.workspace.getLeavesOfType(VIEW_TYPE_EXCALIDRAW);
+        const leaves = this.app.workspace.getLeavesOfType(VIEW_TYPE_EXCALIDRAW);
         for (let i = 0; i < leaves.length; i++) {
           if ((leaves[i].view as ExcalidrawView).file.path == file.path) {
             await leaves[i].setViewState({
@@ -2197,9 +2359,11 @@ export default class ExcalidrawPlugin extends Plugin {
     excalidrawLeaves.forEach((leaf) => {
       this.setMarkdownView(leaf);
     });
-    if (this.mathjaxDiv) {
+
+    this.removeMathJax();
+/*    if (this.mathjaxDiv) {
       document.body.removeChild(this.mathjaxDiv);
-    }
+    }*/
 
     Object.values(this.packageMap).forEach((p:Packages)=>{
       delete p.excalidrawLib;
@@ -2246,7 +2410,9 @@ export default class ExcalidrawPlugin extends Plugin {
           )
         : "";
 
-      theme = theme===""?"":theme+".";
+      theme = (theme === "")
+       ? ""
+       : theme + ".";
 
       const imageRelativePath = getIMGFilename(
         excalidrawRelativePath,
@@ -2258,12 +2424,13 @@ export default class ExcalidrawPlugin extends Plugin {
       );
      
       //will hold incorrect value if theme==="", however in that case it won't be used
-      const otherTheme = theme === "dark." ? "light.":"dark.";
-      const otherImageRelativePath = getIMGFilename(
-        excalidrawRelativePath,
-        otherTheme+this.settings.embedType.toLowerCase(),
-      );
-      
+      const otherTheme = theme === "dark." ? "light." : "dark.";
+      const otherImageRelativePath = theme === "" 
+        ? null
+        : getIMGFilename(
+            excalidrawRelativePath,
+            otherTheme+this.settings.embedType.toLowerCase(),
+          );
 
       const imgFile = this.app.vault.getAbstractFileByPath(imageFullpath);
       if (!imgFile) {
@@ -2271,13 +2438,21 @@ export default class ExcalidrawPlugin extends Plugin {
         await sleep(200); //wait for metadata cache to update
       }
 
+      const inclCom = this.settings.embedMarkdownCommentLinks;
+
       editor.replaceSelection(
         this.settings.embedWikiLink
-          ? `![[${imageRelativePath}]]\n%%[[${excalidrawRelativePath}|🖋 Edit in Excalidraw]]${
-            otherImageRelativePath ? ", and the [["+otherImageRelativePath+"|"+otherTheme.split(".")[0]+" exported image]]":""}%%`
-          : `![](${encodeURI(imageRelativePath)})\n%%[🖋 Edit in Excalidraw](${encodeURI(
-            excalidrawRelativePath,
-            )})${otherImageRelativePath?", and the ["+otherTheme.split(".")[0]+" exported image]("+encodeURI(otherImageRelativePath)+")":""}%%`,
+          ? `![[${imageRelativePath}]]\n` +
+            (inclCom
+              ? `%%[[${excalidrawRelativePath}|🖋 Edit in Excalidraw]]${
+                otherImageRelativePath
+                  ? ", and the [["+otherImageRelativePath+"|"+otherTheme.split(".")[0]+" exported image]]"
+                  : ""
+                }%%`
+              : "")
+          : `![](${encodeURI(imageRelativePath)})\n` + 
+            (inclCom ? `%%[🖋 Edit in Excalidraw](${encodeURI(excalidrawRelativePath,
+              )})${otherImageRelativePath?", and the ["+otherTheme.split(".")[0]+" exported image]("+encodeURI(otherImageRelativePath)+")":""}%%` : ""),
       );
       editor.focus();
     }

src/menu/ActionIcons.tsx

@@ -1,4 +1,4 @@
-import { Globe, RotateCcw, Scan } from "lucide-react";
+import { Cog, Globe, RotateCcw, Scan, Settings } from "lucide-react";
 import * as React from "react";
 import { PenStyle } from "src/PenTypes";
 
@@ -29,6 +29,7 @@ export const ICONS = {
   Reload: (<RotateCcw />),
   Globe: (<Globe />),
   ZoomToSelectedElement: (<Scan />),
+  Properties: (<Settings />),
   ZoomToSection: (
     <svg
       xmlns="http://www.w3.org/2000/svg"

src/menu/EmbeddableActionsMenu.tsx

@@ -11,6 +11,7 @@ import { ROOTELEMENTSIZE, mutateElement, nanoid, sceneCoordsToViewportCoords } f
 import { REGEX_LINK, REG_LINKINDEX_HYPERLINK } from "src/ExcalidrawData";
 import { processLinkText, useDefaultExcalidrawFrame } from "src/utils/CustomEmbeddableUtils";
 import { cleanSectionHeading } from "src/utils/ObsidianUtils";
+import { EmbeddableSettings } from "src/dialogs/EmbeddableSettings";
 
 export class EmbeddableMenu {
 
@@ -91,7 +92,8 @@ export class EmbeddableMenu {
 
       if(!isObsidianiFrame) {
         const { subpath, file } = processLinkText(link, view);
-        if(!file || file.extension!=="md") return null;
+        if(!file) return;
+        const isMD = file.extension==="md";
         const { x, y } = sceneCoordsToViewportCoords( { sceneX: element.x, sceneY: element.y }, appState);
         const top = `${y-2.5*ROOTELEMENTSIZE-appState.offsetTop}px`;
         const left = `${x-appState.offsetLeft}px`;
@@ -116,69 +118,73 @@ export class EmbeddableMenu {
                 display: "block",
               }}
             >
-              <ActionButton
-                key={"MarkdownSection"}
-                title={t("NARROW_TO_HEADING")}
-                action={async () => {
-                  const sections = (await app.metadataCache.blockCache
-                    .getForFile({ isCancelled: () => false },file))
-                    .blocks.filter((b: any) => b.display && b.node?.type === "heading");
-                  const values = [""].concat(
-                    sections.map((b: any) => `#${cleanSectionHeading(b.display)}`)
-                  );
-                  const display = [t("SHOW_ENTIRE_FILE")].concat(
-                    sections.map((b: any) => b.display)
-                  );
-                  const newSubpath = await ScriptEngine.suggester(
-                    app, display, values, "Select section from document"
-                  );
-                  if(!newSubpath && newSubpath!=="") return;
-                  if (newSubpath !== subpath) {
-                    this.updateElement(newSubpath, element, file);
-                  }
-                }}
-                icon={ICONS.ZoomToSection}
-                view={view}
-              />
-              <ActionButton
-                key={"MarkdownBlock"}
-                title={t("NARROW_TO_BLOCK")}
-                action={async () => {
-                  if(!file) return;
-                  const paragrphs = (await app.metadataCache.blockCache
-                    .getForFile({ isCancelled: () => false },file))
-                    .blocks.filter((b: any) => b.display && b.node?.type === "paragraph");
-                  const values = ["entire-file"].concat(paragrphs);
-                  const display = [t("SHOW_ENTIRE_FILE")].concat(
-                    paragrphs.map((b: any) => `${b.node?.id ? `#^${b.node.id}: ` : ``}${b.display.trim()}`));
-    
-                  const selectedBlock = await ScriptEngine.suggester(
-                    app, display, values, "Select section from document"
-                  );
-                  if(!selectedBlock) return;
+              {isMD && (
+                <ActionButton
+                  key={"MarkdownSection"}
+                  title={t("NARROW_TO_HEADING")}
+                  action={async () => {
+                    const sections = (await app.metadataCache.blockCache
+                      .getForFile({ isCancelled: () => false },file))
+                      .blocks.filter((b: any) => b.display && b.node?.type === "heading");
+                    const values = [""].concat(
+                      sections.map((b: any) => `#${cleanSectionHeading(b.display)}`)
+                    );
+                    const display = [t("SHOW_ENTIRE_FILE")].concat(
+                      sections.map((b: any) => b.display)
+                    );
+                    const newSubpath = await ScriptEngine.suggester(
+                      app, display, values, "Select section from document"
+                    );
+                    if(!newSubpath && newSubpath!=="") return;
+                    if (newSubpath !== subpath) {
+                      this.updateElement(newSubpath, element, file);
+                    }
+                  }}
+                  icon={ICONS.ZoomToSection}
+                  view={view}
+                />
+              )}
+              {isMD && (
+                <ActionButton
+                  key={"MarkdownBlock"}
+                  title={t("NARROW_TO_BLOCK")}
+                  action={async () => {
+                    if(!file) return;
+                    const paragrphs = (await app.metadataCache.blockCache
+                      .getForFile({ isCancelled: () => false },file))
+                      .blocks.filter((b: any) => b.display && b.node?.type === "paragraph");
+                    const values = ["entire-file"].concat(paragrphs);
+                    const display = [t("SHOW_ENTIRE_FILE")].concat(
+                      paragrphs.map((b: any) => `${b.node?.id ? `#^${b.node.id}: ` : ``}${b.display.trim()}`));
+      
+                    const selectedBlock = await ScriptEngine.suggester(
+                      app, display, values, "Select section from document"
+                    );
+                    if(!selectedBlock) return;
 
-                  if(selectedBlock==="entire-file") {
-                    if(subpath==="") return;
-                    this.updateElement("", element, file);
-                    return;
-                  }
-              
-                  let blockID = selectedBlock.node.id;
-                  if(blockID && (`#^${blockID}` === subpath)) return;
-                  if (!blockID) {
-                    const offset = selectedBlock.node?.position?.end?.offset;
-                    if(!offset) return;
-                    blockID = nanoid();
-                    const fileContents = await app.vault.cachedRead(file);
-                    if(!fileContents) return;
-                    await app.vault.modify(file, fileContents.slice(0, offset) + ` ^${blockID}` + fileContents.slice(offset));
-                    await sleep(200); //wait for cache to update
-                  }
-                  this.updateElement(`#^${blockID}`, element, file);
-                }}
-                icon={ICONS.ZoomToBlock}
-                view={view}
-              />
+                    if(selectedBlock==="entire-file") {
+                      if(subpath==="") return;
+                      this.updateElement("", element, file);
+                      return;
+                    }
+                
+                    let blockID = selectedBlock.node.id;
+                    if(blockID && (`#^${blockID}` === subpath)) return;
+                    if (!blockID) {
+                      const offset = selectedBlock.node?.position?.end?.offset;
+                      if(!offset) return;
+                      blockID = nanoid();
+                      const fileContents = await app.vault.cachedRead(file);
+                      if(!fileContents) return;
+                      await app.vault.modify(file, fileContents.slice(0, offset) + ` ^${blockID}` + fileContents.slice(offset));
+                      await sleep(200); //wait for cache to update
+                    }
+                    this.updateElement(`#^${blockID}`, element, file);
+                  }}
+                  icon={ICONS.ZoomToBlock}
+                  view={view}
+                />
+              )}
               <ActionButton
                 key={"ZoomToElement"}
                 title={t("ZOOM_TO_FIT")}
@@ -189,6 +195,16 @@ export class EmbeddableMenu {
                 icon={ICONS.ZoomToSelectedElement}
                 view={view}
               />
+              <ActionButton
+                key={"Properties"}
+                title={t("PROPERTIES")}
+                action={() => {
+                  if(!element) return;
+                  new EmbeddableSettings(view.plugin,view,file,element).open();
+                }}
+                icon={ICONS.Properties}
+                view={view}
+              />
             </div>
           </div>  
         );
@@ -256,6 +272,16 @@ export class EmbeddableMenu {
               icon={ICONS.ZoomToSelectedElement}
               view={view}
             />
+            <ActionButton
+              key={"Properties"}
+              title={t("PROPERTIES")}
+              action={() => {
+                if(!element) return;
+                new EmbeddableSettings(view.plugin,view,null,element).open();
+              }}
+              icon={ICONS.Properties}
+              view={view}
+            />
           </div>
         </div>  
       );

src/types.d.ts

@@ -32,6 +32,7 @@ declare global {
 
 declare module "obsidian" {
   interface App {
+    internalPlugins: any;
     isMobile(): boolean;
     getObsidianUrl(file:TFile): string;
   }

src/utils/CanvasNodeFactory.ts

@@ -72,8 +72,9 @@ export class CanvasNodeFactory {
     const node = this.canvas.createFileNode({pos: {x:0,y:0}, file, subpath, save: false});
     node.setFilePath(file.path,subpath);
     node.render();
-    containerEl.style.background = "var(--background-primary)";
-    containerEl.appendChild(node.contentEl)
+    //containerEl.style.background = "var(--background-primary)";
+    node.containerEl.querySelector(".canvas-node-content-blocker")?.remove();
+    containerEl.appendChild(node.containerEl)
     this.nodes.set(elementId, node);
     return node;
   }

src/utils/DynamicStyling.ts

@@ -1,7 +1,12 @@
+import { ExcalidrawImperativeAPI } from "@zsviczian/excalidraw/types/types";
 import { ColorMaster } from "colormaster";
 import { ExcalidrawAutomate } from "src/ExcalidrawAutomate";
 import ExcalidrawView from "src/ExcalidrawView";
 import { DynamicStyle } from "src/types";
+import { cloneElement } from "src/ExcalidrawAutomate";
+import { ExcalidrawFrameElement } from "@zsviczian/excalidraw/types/element/types";
+import { addAppendUpdateCustomData } from "./Utils";
+import { mutateElement } from "src/constants";
 
 export const setDynamicStyle = (
   ea: ExcalidrawAutomate,
@@ -55,67 +60,104 @@ export const setDynamicStyle = (
   const cmBlack = () => ea.getCM("#000000").lightnessTo(bgLightness);
 
   
-  const gray1 = isGray
+  const gray1 = () => isGray
     ? isDark ? cmBlack().lighterBy(10) : cmBlack().darkerBy(10)
     : isDark ? cmBG().lighterBy(10).mix({color:cmBlack(),ratio:0.5}) : cmBG().darkerBy(10).mix({color:cmBlack(),ratio:0.5});
-  const gray2 = isGray
+  const gray2 = () => isGray
     ? isDark ? cmBlack().lighterBy(4) : cmBlack().darkerBy(4)
     : isDark ? cmBG().lighterBy(4).mix({color:cmBlack(),ratio:0.5}) : cmBG().darkerBy(4).mix({color:cmBlack(),ratio:0.5});
+  
+  
   const text = cmBG().mix({color:isDark?lighter:darker, ratio:mixRatio});
 
   const str = (cm: ColorMaster) => cm.stringHEX({alpha:false});
-  const style = `--color-primary: ${str(accent())};` +
-    `--color-surface-low: ${str(gray1)};` +
-    `--color-surface-mid: ${str(gray1)};` +
-    `--color-surface-lowest: ${str(gray2)};` +
-    `--color-surface-high: ${str(gray1.lighterBy(step))};` +
-    `--color-on-primary-container: ${str(!isDark?accent().darkerBy(15):accent().lighterBy(15))};` +
-    `--color-surface-primary-container: ${str(isDark?accent().darkerBy(step):accent().lighterBy(step))};` +
-    //`--color-primary-darker: ${str(accent().darkerBy(step))};` +
-    //`--color-primary-darkest: ${str(accent().darkerBy(step))};` +
-    `--button-gray-1: ${str(gray1)};` +
-    `--button-gray-2: ${str(gray2)};` +
-    `--input-border-color: ${str(gray1)};` +
-    `--input-bg-color: ${str(gray2)};` +
-    `--input-label-color: ${str(text)};` +
-    `--island-bg-color: ${gray2.alphaTo(0.93).stringHEX()};` +
-    `--popup-secondary-bg-color: ${gray2.alphaTo(0.93).stringHEX()};` +
-    `--icon-fill-color: ${str(text)};` +
-    `--text-primary-color: ${str(text)};` +
-    `--overlay-bg-color: ${gray2.alphaTo(0.6).stringHEX()};` +
-    `--popup-bg-color: ${str(gray1)};` +
-    `--color-on-surface: ${str(text)};` +
-    //`--color-gray-100: ${str(text)};` +
-    //`--color-gray-40: ${str(text)};` +
-    `--color-surface-highlight: ${str(gray1)};` +
-    //`--color-gray-30: ${str(gray1)};` +
-    `--color-gray-80: ${str(gray1)};` +
-    `--sidebar-border-color: ${str(gray1)};` +
-    `--color-primary-light: ${str(accent().lighterBy(step))};` +
-    `--button-hover-bg: ${str(gray1)};` +
-    `--sidebar-bg-color: ${gray2.alphaTo(0.93).stringHEX()};` +
-    `--sidebar-shadow: ${str(gray1)};` +
-    `--popup-text-color: ${str(text)};` +
-    `--code-normal: ${str(text)};` +
-    `--code-background: ${str(gray2)};` +
-    `--h1-color: ${str(text)};` +
-    `--h2-color: ${str(text)};` +
-    `--h3-color: ${str(text)};` +
-    `--h4-color: ${str(text)};` +
-    `color: ${str(text)};` + 
-    `--select-highlight-color: ${str(gray1)};`;
+  const styleObject:{[x: string]: string;} = {
+    [`--color-primary`]: str(accent()),
+    [`--color-surface-low`]: str(gray1()),
+    [`--color-surface-mid`]: str(gray1()),
+    [`--color-surface-lowest`]: str(gray2()),
+    [`--color-surface-high`]: str(gray1().lighterBy(step)),
+    [`--color-on-primary-container`]: str(!isDark?accent().darkerBy(15):accent().lighterBy(15)),
+    [`--color-surface-primary-container`]: str(isDark?accent().darkerBy(step):accent().lighterBy(step)),
+    //[`--color-primary-darker`]: str(accent().darkerBy(step)),
+    //[`--color-primary-darkest`]: str(accent().darkerBy(step)),
+    [`--button-gray-1`]: str(gray1()),
+    [`--button-gray-2`]: str(gray2()),
+    [`--input-border-color`]: str(gray1()),
+    [`--input-bg-color`]: str(gray2()),
+    [`--input-label-color`]: str(text),
+    [`--island-bg-color`]: gray2().alphaTo(0.93).stringHEX(),
+    [`--popup-secondary-bg-color`]: gray2().alphaTo(0.93).stringHEX(),
+    [`--icon-fill-color`]: str(text),
+    [`--text-primary-color`]: str(text),
+    [`--overlay-bg-color`]: gray2().alphaTo(0.6).stringHEX(),
+    [`--popup-bg-color`]: str(gray1()),
+    [`--color-on-surface`]: str(text),
+    //[`--color-gray-100`]: str(text),
+    [`--color-gray-40`]: str(text), //frame
+    [`--color-gray-50`]: str(text), //frame
+    [`--color-surface-highlight`]: str(gray1()),
+    //[`--color-gray-30`]: str(gray1),
+    [`--color-gray-80`]: str(isDark?text.lighterBy(15):text.darkerBy(15)), //frame
+    [`--sidebar-border-color`]: str(gray1()),
+    [`--color-primary-light`]: str(accent().lighterBy(step)),
+    [`--button-hover-bg`]: str(gray1()),
+    [`--sidebar-bg-color`]: gray2().alphaTo(0.93).stringHEX(),
+    [`--sidebar-shadow`]: str(gray1()),
+    [`--popup-text-color`]: str(text),
+    [`--code-normal`]: str(text),
+    [`--code-background`]: str(gray2()),
+    [`--h1-color`]: str(text),
+    [`--h2-color`]: str(text),
+    [`--h3-color`]: str(text),
+    [`--h4-color`]: str(text),
+    [`color`]: str(text), 
+    [`--select-highlight-color`]: str(gray1()),
+  };
   
-  view.excalidrawContainer?.setAttribute(
-    "style",
-    style
-  )
+    const styleString = Object.keys(styleObject)
+      .map((property) => `${property}: ${styleObject[property]}`)
+      .join("; ");
 
-  setTimeout(()=>view.updateScene({appState:{dynamicStyle: style}}));
+  /*view.excalidrawContainer?.setAttribute(
+    "style",
+    styleString
+  )*/
+
+  setTimeout(()=>{
+    const api = view.excalidrawAPI as ExcalidrawImperativeAPI;
+    if(!api) return;
+    const frameColor = {
+      stroke: str(isDark?gray2().lighterBy(15):gray2().darkerBy(15)),
+      fill: str((isDark?gray2().lighterBy(30):gray2().darkerBy(30)).alphaTo(0.2)),
+      nameColor: str(isDark?gray2().lighterBy(40):gray2().darkerBy(40)),
+    }
+    const scene = api.getSceneElements();
+    scene.filter(el=>el.type==="frame").forEach((e:ExcalidrawFrameElement)=>{
+      const f = cloneElement(e);
+      addAppendUpdateCustomData(f,{frameColor});
+      if(
+        e.customData && e.customData.frameColor &&
+        e.customData.frameColor.stroke    === frameColor.stroke &&
+        e.customData.frameColor.fill      === frameColor.fill &&
+        e.customData.frameColor.nameColor === frameColor.nameColor
+      ) {
+        return;
+      }
+      mutateElement(e,{customData: f.customData});
+    });
+
+    view.updateScene({
+      appState:{
+        frameColor,
+        dynamicStyle: styleObject
+      }
+    });
+  });
   const toolspanel = view.toolsPanelRef?.current?.containerRef?.current;
   if(toolspanel) {
     let toolsStyle = toolspanel.getAttribute("style");
     toolsStyle = toolsStyle.replace(/\-\-color\-primary.*/,"");
-    toolspanel.setAttribute("style",toolsStyle+style);
+    toolspanel.setAttribute("style",toolsStyle+styleString);
   }
-
 }

src/utils/FileUtils.ts

@@ -313,4 +313,9 @@ export const readLocalFileBinary = async (filePath:string): Promise<ArrayBuffer>
       }
     });
   });
+}
+
+export const getPathWithoutExtension = (f:TFile): string => {
+  if(!f) return null;
+  return f.path.substring(0, f.path.lastIndexOf("."));
 }

src/utils/ImageCache.ts

@@ -1,7 +1,7 @@
 import { App, Notice, TFile } from "obsidian";
 import ExcalidrawPlugin from "src/main";
 import { convertSVGStringToElement } from "./Utils";
-import { PreviewImageType } from "./UtilTypes";
+import { FILENAMEPARTS, PreviewImageType } from "./UtilTypes";
 
 //@ts-ignore
 const DB_NAME = "Excalidraw " + app.appId;
@@ -19,10 +19,11 @@ export type ImageKey = {
   isDark: boolean;
   previewImageType: PreviewImageType;
   scale: number;
-};
+} & FILENAMEPARTS;
 
 const getKey = (key: ImageKey): string =>
-  `${key.filepath}#${key.blockref}#${key.sectionref}#${key.isDark ? 1 : 0}#${
+  `${key.filepath}#${key.blockref??""}#${key.sectionref??""}#${key.isDark ? 1 : 0}#${
+    key.hasGroupref}#${key.hasArearef}#${key.hasFrameref}#${key.hasSectionref}#${
     key.previewImageType === PreviewImageType.SVGIMG
       ? 1
       : key.previewImageType === PreviewImageType.PNG
@@ -149,10 +150,11 @@ class ImageCache {
         const cursor = (event.target as IDBRequest<IDBCursorWithValue | null>).result;
         if(cursor) {
           const key = cursor.key as string;
+          const isLegacyKey = key.replaceAll(/[^#]/g,"").length < 9; // introduced hasGroupref, etc. in 1.9.28
           const filepath = key.split("#")[0];
           const fileExists = files.some((f: TFile) => f.path === filepath);
           const file = fileExists ? files.find((f: TFile) => f.path === filepath) : null;
-          if (!file || (file && file.stat.mtime > cursor.value.mtime) || (!cursor.value.blob && !cursor.value.svg)) {
+          if (isLegacyKey || !file || (file && file.stat.mtime > cursor.value.mtime) || (!cursor.value.blob && !cursor.value.svg)) {
             deletePromises.push(
               new Promise<void>((innerResolve, innerReject) => {
                 const deleteRequest = store.delete(cursor.primaryKey);
@@ -268,27 +270,42 @@ class ImageCache {
     return !!this.db && !this.isInitializing && !!this.plugin && this.plugin.settings.allowImageCache;
   }
 
+  private fullyInitialized = false;
+
   public async getImageFromCache(key_: ImageKey): Promise<string | SVGSVGElement | undefined> {
     if (!this.isReady()) {
       return null; // Database not initialized yet
     }
 
     const key = getKey(key_);
-    const cachedData = await this.getCacheData(key);    
-    const file = this.app.vault.getAbstractFileByPath(key_.filepath.split("#")[0]);
-    if (!file || !(file instanceof TFile)) return undefined;
-    if (cachedData && cachedData.mtime === file.stat.mtime) {
-      if(cachedData.svg) {
-        return convertSVGStringToElement(cachedData.svg);
+
+    try {
+      const cachedData = this.fullyInitialized
+      ? await this.getCacheData(key)
+      : await Promise.race([
+          this.getCacheData(key),
+          new Promise<undefined>((_,reject) => setTimeout(() => reject(undefined), 100))
+        ]);
+      this.fullyInitialized = true;
+      if(!cachedData) return undefined;
+
+      const file = this.app.vault.getAbstractFileByPath(key_.filepath.split("#")[0]);
+      if (!file || !(file instanceof TFile)) return undefined;
+      if (cachedData && cachedData.mtime === file.stat.mtime) {
+        if(cachedData.svg) {
+          return convertSVGStringToElement(cachedData.svg);
+        }
+        if(this.obsidanURLCache.has(key)) {
+          return this.obsidanURLCache.get(key);
+        }
+        const obsidianURL = URL.createObjectURL(cachedData.blob);
+        this.obsidanURLCache.set(key, obsidianURL);
+        return obsidianURL;
       }
-      if(this.obsidanURLCache.has(key)) {
-        return this.obsidanURLCache.get(key);
-      }
-      const obsidianURL = URL.createObjectURL(cachedData.blob);
-      this.obsidanURLCache.set(key, obsidianURL);
-      return obsidianURL;
+      return undefined;
+    } catch(e) {
+      return undefined;
     }
-    return undefined;
   }
 
   public async getBAKFromCache(filepath: string): Promise<BackupData | null> {

src/utils/ObsidianUtils.ts

@@ -1,6 +1,6 @@
 import {
   App,
-  normalizePath, Workspace, WorkspaceLeaf, WorkspaceSplit
+  normalizePath, parseFrontMatterEntry, TFile, Workspace, WorkspaceLeaf, WorkspaceSplit
 } from "obsidian";
 import ExcalidrawPlugin from "../main";
 import { checkAndCreateFolder, splitFolderAndFilename } from "./FileUtils";
@@ -233,3 +233,24 @@ export const obsidianPDFQuoteWithRef = (text:string):{quote: string, link: strin
   }
   return null;
 }
+
+export const extractSVGPNGFileName = (text:string) => {
+  const regex = /\[\[([^\]|#^]+\.(?:svg|png))(?:[^\]]+)?\]\]|\[[^\]]+\]\(([^\)]+\.(?:svg|png))\)/;
+  const match = text.match(regex);
+  return match ? (match[1] || match[2]) : null;
+}
+
+export const getFileCSSClasses = (
+  file: TFile,
+): string[] => {
+  if (file) {
+    const plugin = window.ExcalidrawAutomate.plugin;
+    const fileCache = plugin.app.metadataCache.getFileCache(file);
+    if(!fileCache?.frontmatter) return [];
+    const x = parseFrontMatterEntry(fileCache.frontmatter, "cssclasses");
+    if (Array.isArray(x)) return x
+    if (typeof x === "string") return Array.from(new Set(x.split(/[, ]+/).filter(Boolean)));
+    return [];
+  }
+  return [];
+}

src/utils/Utils.ts

@@ -2,6 +2,7 @@
 import {
   App,
   Notice,
+  parseFrontMatterEntry,
   request,
   requestUrl,
   TFile,
@@ -9,8 +10,11 @@ import {
 import { Random } from "roughjs/bin/math";
 import { BinaryFileData, DataURL} from "@zsviczian/excalidraw/types/types";
 import {
+  ASSISTANT_FONT,
   CASCADIA_FONT,
   VIRGIL_FONT,
+} from "src/constFonts";
+import {
   FRONTMATTER_KEY_EXPORT_DARK,
   FRONTMATTER_KEY_EXPORT_TRANSPARENT,
   FRONTMATTER_KEY_EXPORT_SVGPADDING,
@@ -29,7 +33,9 @@ import { generateEmbeddableLink } from "./CustomEmbeddableUtils";
 import ExcalidrawScene from "src/svgToExcalidraw/elements/ExcalidrawScene";
 import { FILENAMEPARTS } from "./UtilTypes";
 import { Mutable } from "@zsviczian/excalidraw/types/utility-types";
-import { cleanBlockRef, cleanSectionHeading } from "./ObsidianUtils";
+import { cleanBlockRef, cleanSectionHeading, getFileCSSClasses } from "./ObsidianUtils";
+import { updateElementLinksToObsidianLinks } from "src/ExcalidrawAutomate";
+
 
 declare const PLUGIN_VERSION:string;
 
@@ -257,6 +263,7 @@ export const getSVG = async (
   scene: any,
   exportSettings: ExportSettings,
   padding: number,
+  srcFile: TFile|null, //if set, will replace markdown links with obsidian links
 ): Promise<SVGSVGElement> => {
   let elements:ExcalidrawElement[] = scene.elements;
   if(elements.some(el => el.type === "embeddable")) {
@@ -267,8 +274,13 @@ export const getSVG = async (
   }
 
   try {
-    return await exportToSvg({
-      elements,
+    const svg = await exportToSvg({
+      elements: srcFile
+        ? updateElementLinksToObsidianLinks({
+            elements,
+            hostFile: srcFile,
+        })
+        : elements,
       appState: {
         exportBackground: exportSettings.withBackground,
         exportWithDarkMode: exportSettings.withTheme
@@ -278,7 +290,17 @@ export const getSVG = async (
       },
       files: scene.files,
       exportPadding: padding,
+      exportingFrame: null,
+      renderEmbeddables: true,
     });
+    if(svg) {
+      svg.addClass("excalidraw-svg");
+      if(srcFile instanceof TFile) {
+        const cssClasses = getFileCSSClasses(srcFile);
+        cssClasses.forEach((cssClass) => svg.addClass(cssClass));      
+      }
+    }
+    return svg;
   } catch (error) {
     return null;
   }
@@ -358,12 +380,15 @@ export const embedFontsInSVG = (
     svg.querySelector("text[font-family^='Virgil']") != null;
   const includesCascadia = !localOnly &&
     svg.querySelector("text[font-family^='Cascadia']") != null;
+  const includesAssistant = !localOnly &&
+    svg.querySelector("text[font-family^='Assistant']") != null;
   const includesLocalFont =
     svg.querySelector("text[font-family^='LocalFont']") != null;
   const defs = svg.querySelector("defs");
-  if (defs && (includesCascadia || includesVirgil || includesLocalFont)) {
+  if (defs && (includesCascadia || includesVirgil || includesLocalFont || includesAssistant)) {
     defs.innerHTML = `<style>${includesVirgil ? VIRGIL_FONT : ""}${
-      includesCascadia ? CASCADIA_FONT : ""
+      includesCascadia ? CASCADIA_FONT : ""}${
+      includesAssistant ? ASSISTANT_FONT : ""
     }${includesLocalFont ? plugin.fourthFontDef : ""}</style>`;
   }
   return svg;
@@ -767,3 +792,17 @@ export const convertSVGStringToElement = (svg: string): SVGSVGElement => {
 }
 
 export const escapeRegExp = (str:string) => str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'); // $& means the whole matched string
+
+export const addIframe = (containerEl: HTMLElement, link:string, startAt?: number, style:string = "settings") => {
+  const wrapper = containerEl.createDiv({cls: `excalidraw-videoWrapper ${style}`})
+  wrapper.createEl("iframe", {
+    attr: {
+      allowfullscreen: true,
+      allow: "encrypted-media;picture-in-picture",
+      frameborder: "0",
+      title: "YouTube video player",
+      src: "https://www.youtube.com/embed/" + link + (startAt ? "?start=" + startAt : ""),
+      sandbox: "allow-forms allow-presentation allow-same-origin allow-scripts allow-modals",
+    },
+  });
+}

src/utils/YoutTubeUtils.ts

@@ -0,0 +1,57 @@
+const REG_YOUTUBE = /^(?:http(?:s)?:\/\/)?(?:www\.)?youtu(?:be\.com|\.be)\/(embed\/|watch\?v=|shorts\/|playlist\?list=|embed\/videoseries\?list=)?([a-zA-Z0-9_-]+)(?:\?t=|.*&t=|\?start=|.*&start=)?([a-zA-Z0-9_-]+)?[^\s]*$/;
+export const isYouTube = (url: string): boolean => {
+  return Boolean(
+    url.match(REG_YOUTUBE)
+  );
+}
+
+export const getYouTubeStartAt = (url: string): string => {
+  const ytLink = url.match(REG_YOUTUBE);
+  if (ytLink?.[2]) {
+    const time = ytLink[3] ? parseInt(ytLink[3]) : 0;
+    const hours = Math.floor(time / 3600);
+    const minutes = Math.floor((time - hours * 3600) / 60);
+    const seconds = time - hours * 3600 - minutes * 60;
+    return `${String(hours).padStart(2, '0')}:${String(minutes).padStart(2, '0')}:${String(seconds).padStart(2, '0')}`;
+  }
+  return "00:00:00";
+};
+
+export const isValidYouTubeStart = (value: string): boolean => {
+  if(/^[0-9]+$/.test(value)) return true; // Matches only numbers (seconds)
+  if(/^[0-9]+:[0-9]+$/.test(value)) return true; // Matches only numbers (minutes and seconds)
+  if(/^[0-9]+:[0-9]+:[0-9]+$/.test(value)) return true; // Matches only numbers (hours, minutes, and seconds
+};
+
+export const updateYouTubeStartTime = (link: string, startTime: string): string => {
+  const match = link.match(REG_YOUTUBE);
+  if (match?.[2]) {
+    const startTimeParam = `t=${timeStringToSeconds(startTime)}`;
+    let updatedLink = link;
+    if (match[3]) {
+      // If start time already exists, update it
+      updatedLink = link.replace(/([?&])t=[a-zA-Z0-9_-]+/, `$1${startTimeParam}`);
+      updatedLink = updatedLink.replace(/([?&])start=[a-zA-Z0-9_-]+/, `$1${startTimeParam}`);
+    } else {
+      // If no start time exists, add it to the link
+      updatedLink += (link.includes('?') ? '&' : '?') + startTimeParam;
+    }
+    return updatedLink;
+  }
+  return link;
+};
+
+const timeStringToSeconds = (time: string): number => {
+  const timeParts = time.split(':').map(Number);
+  const totalParts = timeParts.length;
+
+  if (totalParts === 1) {
+    return timeParts[0]; // Only seconds provided (ss)
+  } else if (totalParts === 2) {
+    return timeParts[0] * 60 + timeParts[1]; // Minutes and seconds provided (mm:ss)
+  } else if (totalParts === 3) {
+    return timeParts[0] * 3600 + timeParts[1] * 60 + timeParts[2]; // Hours, minutes, and seconds provided (hh:mm:ss)
+  }
+
+  return 0; // Invalid format, return 0 or handle accordingly
+};

styles.css

@@ -183,15 +183,24 @@ li[data-testid] {
 }
 
 .excalidraw-videoWrapper {
-  max-width:600px
+  max-width:600px;
 }
-.excalidraw-videoWrapper div {
+.excalidraw-videoWrapper.settings {
+  max-width:340px;
+}
+
+.excalidraw-videoWrapper div{
   position: relative;
   padding-bottom: 56.25%;
   height: 0;
   margin: 0 auto;
 }
 
+.excalidraw-videoWrapper.settings iframe {
+  position: relative;
+  margin-bottom: 1rem;
+}
+
 .excalidraw-videoWrapper iframe {
   position: absolute;
   top: 0;
@@ -336,7 +345,7 @@ label.color-input-container > input {
   padding: 0;
 }
 
-.excalidraw-settings input {
+.excalidraw-settings input:not([type="color"]) {
   min-width: 10em;
 }
 
@@ -362,10 +371,6 @@ div.excalidraw-draginfo {
   background: initial;
 }
 
-.excalidraw .HelpDialog__key {
-  background-color: var(--color-gray-80) !important;
-}
-
 .excalidraw .embeddable-menu {
     width: fit-content;
     height: fit-content;
@@ -423,4 +428,64 @@ div.excalidraw-draginfo {
   max-height: initial;
   width: initial;
   height: initial;
+}
+
+summary.excalidraw-setting-h1 {
+  font-variant: var(--h1-variant);
+  letter-spacing: -0.015em;
+  line-height: var(--h1-line-height);
+  font-size: var(--h1-size);
+  color: var(--h1-color);
+  font-weight: var(--h1-weight);
+  font-style: var(--h1-style);
+  font-family: var(--h1-font);
+  /*margin-block-start: var(--p-spacing);*/
+  margin-block-end: var(--p-spacing);
+}
+
+summary.excalidraw-setting-h3 {
+  font-variant: var(--h3-variant);
+  letter-spacing: -0.015em;
+  line-height: var(--h3-line-height);
+  font-size: var(--h3-size);
+  color: var(--h3-color);
+  font-weight: var(--h3-weight);
+  font-style: var(--h3-style);
+  font-family: var(--h3-font);
+  margin-block-start: var(--p-spacing);
+  margin-block-end: var(--p-spacing);
+}
+
+summary.excalidraw-setting-h4 {
+  font-variant: var(--h4-variant);
+  letter-spacing: -0.015em;
+  line-height: var(--h4-line-height);
+  font-size: var(--h4-size);
+  color: var(--h4-color);
+  font-weight: var(--h4-weight);
+  font-style: var(--h4-style);
+  font-family: var(--h4-font);
+  margin-block-start: var(--p-spacing);
+  margin-block-end: var(--p-spacing);
+}
+
+hr.excalidraw-setting-hr {
+  margin: 1rem 0rem 0rem 0rem;
+}
+
+.excalidraw-mdEmbed-hideFilename .mod-header {
+  display: none;
+}
+
+.canvas-node:not(.is-editing):has(.excalidraw-canvas-immersive) {
+  ::-webkit-scrollbar,
+  ::-webkit-scrollbar-horizontal {
+    display: none;
+  }
+  background-color: transparent !important;
+}
+
+.canvas-node:not(.is-editing) .canvas-node-container:has(.excalidraw-canvas-immersive) {
+  border:       unset;
+  box-shadow:   unset;
 }