migrated old color functions to CM

Fix spelling of embed

AutomateHowTo.md

@@ -6,7 +6,7 @@ With a little work, using Excalidraw Automate you can generate simple mindmaps,
 
 You can access Excalidraw Automate via the ExcalidrawAutomate object. I recommend starting your Automate scripts with the following code.
 
-*Use CTRL+Shift+V to paste code into Obsidian!*
+*Use <kbd>CTRL+Shift+V</kbd> to paste code into Obsidian!*
 ```javascript
 const ea = ExcalidrawAutomate;
 ea.reset();
@@ -27,7 +27,7 @@ You can change styling between adding different elements. My logic for separatin
 #### Create a new drawing with custom name, in a custom folder, using a template
 This simple script gives you significant additional flexibility over Excalidraw Plugin settings to name your drawings, place them into folders, and to apply templates.
 
-*Use CTRL+Shift+V to paste code into Obsidian!*
+*Use <kbd>CTRL+Shift+V</kbd> to paste code into Obsidian!*
 ```javascript
 <%*
   const ea = ExcalidrawAutomate;
@@ -42,7 +42,7 @@ This simple script gives you significant additional flexibility over Excalidraw
 ```
 
 #### Create a simple drawing
-*Use CTRL+Shift+V to paste code into Obsidian!*
+*Use <kbd>CTRL+Shift+V</kbd> to paste code into Obsidian!*
 ```javascript
 <%*
   const ea = ExcalidrawAutomate;
@@ -63,7 +63,7 @@ The script will generate the following drawing:
 
 ## Attributes and functions at a glance
 Here's the interface implemented by ExcalidrawAutomate:
-*Use CTRL+Shift+V to paste code into Obsidian!*
+*Use <kbd>CTRL+Shift+V</kbd> to paste code into Obsidian!*
 ```javascript
 ExcalidrawAutomate: {
   style: {
@@ -324,7 +324,7 @@ Returns a blob containing a PNG image of the generated drawing.
 ### Insert new drawing into currently edited document
 This template will prompt you for the title of the drawing. It will create a new drawing with the provided title, and in the folder of the document you were editing. It will then transclude the new drawing at the cursor location and open the new drawing in a new workspace leaf by splitting the current leaf.
 
-*Use CTRL+Shift+V to paste code into Obsidian!*
+*Use <kbd>CTRL+Shift+V</kbd> to paste code into Obsidian!*
 ```javascript
 <%*
   const defaultTitle = tp.date.now("HHmm")+' '+tp.file.title;
@@ -345,7 +345,7 @@ This template will prompt you for the title of the drawing. It will create a new
 ```
 
 ### Connect objects
-*Use CTRL+Shift+V to paste code into Obsidian!*
+*Use <kbd>CTRL+Shift+V</kbd> to paste code into Obsidian!*
 ```javascript
 <%*
   const ea = ExcalidrawAutomate;
@@ -362,7 +362,7 @@ This template will prompt you for the title of the drawing. It will create a new
 ### Using a template
 This example is similar to the first one, but rotated 90°, and using a template, plus specifying a filename and folder to save the drawing, and opening the new drawing in a new pane.
 
-*Use CTRL+Shift+V to paste code into Obsidian!*
+*Use <kbd>CTRL+Shift+V</kbd> to paste code into Obsidian!*
 ```javascript
 <%*
   const ea = ExcalidrawAutomate;
@@ -402,7 +402,7 @@ Example input:
 
 The script:
 
-*Use CTRL+Shift+V to paste code into Obsidian!*
+*Use <kbd>CTRL+Shift+V</kbd> to paste code into Obsidian!*
 ```javascript
 <%*
 const IDX = Object.freeze({"depth":0, "text":1, "parent":2, "size":3, "children": 4, "objectId":5});

README.md

@@ -17,23 +17,22 @@ Please upgrade to Obsidian v0.12.19 or higher to get the latest release.
 |[![fourtfont](https://user-images.githubusercontent.com/14358394/149659524-2a4e0a24-40c9-4e66-a6b1-c92f3b88ecd5.jpg)](https://youtu.be/eKFmrSQhFA4)|[![thumbnail](https://user-images.githubusercontent.com/14358394/151705333-54e9ffd2-0bd7-4d02-b99e-0bd4e4708d4d.jpg)](https://youtu.be/qbPIAZguJeo)|[![Thumbnail](https://user-images.githubusercontent.com/14358394/152585752-7eb0371f-0bab-40f6-a194-3b48e5811735.jpg)](https://youtu.be/2Y8OhkGiTHg)|
 |[![Thumbnail](https://user-images.githubusercontent.com/14358394/153676009-6f86b2d7-c248-49a2-b802-be21c6999e4f.jpg)](https://youtu.be/2v9TZmQNO8c)|[![Thumbnail](https://user-images.githubusercontent.com/14358394/154821232-a404b6cf-72fb-4ce4-9d53-619132dce491.jpg)](https://youtu.be/xHPGWR3m0c8)|[![Thumbnail](https://user-images.githubusercontent.com/14358394/156931428-b2269fd9-87bd-43ab-8558-5572f40dff93.jpg)](https://youtu.be/gMIKXyhS-dM)|
 |[![thumbnail](https://user-images.githubusercontent.com/14358394/156931461-0979b821-315a-41dd-86f1-31d169b7c127.jpg)](https://youtu.be/Etskjw7a5zo)|[![Thumbnail](https://user-images.githubusercontent.com/14358394/158008902-12c6a851-237e-4edd-a631-d48e81c904b2.jpg)](https://youtu.be/4N6efq1DtH0)|[![thumbnail](https://user-images.githubusercontent.com/14358394/159369910-6371f08d-b5fa-454d-9c6c-948f7e7a7d26.jpg)](https://youtu.be/U2LkBRBk4LY)|
-| [![6 strategies for linking your visual thoughts v4](https://user-images.githubusercontent.com/14358394/171635214-30533c45-94fa-436e-83a9-b2ec99f190e2.jpg)](https://youtu.be/qiKuqMcNWgU)| | |
-
-
+| [![6 strategies for linking your visual thoughts v4](https://user-images.githubusercontent.com/14358394/171635214-30533c45-94fa-436e-83a9-b2ec99f190e2.jpg)](https://youtu.be/qiKuqMcNWgU)|[![Video thumbnail small](https://user-images.githubusercontent.com/14358394/185791706-3d9983ab-7cb1-4b27-a016-30c039d84e34.jpg)](https://youtu.be/yZQoJg2RCKI)| |
 
 
 # Key features
-- The plugin aims to integrate Excalidraw seamlessly into Obsidian including Command Palette actions, File Explorer features, Option Menu commands, and the Ribbon Button.
-- CTRL/CMD+Click on the ribbon button, or in the file explorer to create / open drawings in a new pane.
+- The plugin integrates Excalidraw seamlessly into Obsidian including Command Palette actions, File Explorer features, Option Menu commands, and the Ribbon Button.
+- <kbd>CTRL/CMD+Click</kbd> on the ribbon button, or in the file explorer to create / open drawings in a new pane.
 - Settings will allow you to customize Excalidraw to your needs:
   - Default folder for new drawings and define custom filename pattern for new drawings.
   - Template for new drawings. The template will restore stroke properties. This means you can set up defaults in your template for stroke color, stroke width, opacity, font family, font size, fill style, stroke style, etc. This also applies to ExcalidrawAutomate.
-  - If portability is important to you: Auto-export SVG and/or PNG files including keep-in-sync feature so you can embed SVG/PNG into your documents instead of embedding excalidraw files.
+    - Via the template you can customize the color palette used by Excalidraw. Switch to Markdown view. Scroll down to the bottom of the file and find `"AppState": {`. Find `"customColorPalette": {` at the end of the AppState section. You may specify the 3 palettes used in Excalidraw by adding any or all of the following 3 variables: `"canvasBackground":[], "elementBackground":[], "elementStroke": []`. Add a comma separated list of valid HTML colors (e.g. `#FF0000` for red) in the array for each of the variables. See my videos above for further help.
+  - If portability is important to you: Auto-export SVG and/or PNG files including keep-in-sync feature so you can embed SVG/PNG into your documents instead of embedding excalidraw files. You can override export settings for an individual file by adding the `excalidraw-autoexport` frontmatter key. Valid values for this key are `none`, `both`, `png` and `svg`.
   - Specify the default width of embedded drawings.
   - Compatibility features to auto-export and keep in sync markdown excalidraw files and legacy .excalidraw files.
   - Experimental feature to add custom TAG to file explorer to mark drawing files.
   - Enable / disable autosave.
-- You can customize the size and position of the embedded images using the `![[image.excalidraw|100]]`, `![[image.excalidraw|100x100]]`, `![[image.excalidraw|100|left]]`, `![[image.excalidraw|right-wrap]]`, formatting options. `![[<filename.excalidraw>|<width>x<height>|<alignment>]]`. You can add your custom alignment via CSS. Any text that appears in `<alignment>` will be added to the rendered SVG element style and to the wrapper DIV element. See [styles.css](https://github.com/zsviczian/obsidian-excalidraw-plugin/blob/master/styles.css) for more insight.
+- You can customize the size and position of the embedded images using the `![[image.excalidraw|100]]`, `![[image.excalidraw|100x100]]`, `![[image.excalidraw|100|left]]`, `![[image.excalidraw|right-wrap]]`, formatting options. `![[<filename.excalidraw>|<width>x<height>|<alignment>]]`. You can add your custom [alignment via CSS](https://www.scaler.com/topics/align-image-in-html/). Any text that appears in `<alignment>` will be added to the rendered SVG element style and to the wrapper DIV element. See [styles.css](https://github.com/zsviczian/obsidian-excalidraw-plugin/blob/master/styles.css) for more insight.
 - Supports hyperlinks e.g. `https://zsolt.blog`, `[Obsidian](https://obsidian.md)`, and internal links e.g. `[[My file in vault|Alias]]` in drawing text. 
   - Links will update when files are moved or renamed, if you have the Obsidian setting Files & Links/Automatically Update Internal Links enabled.
   - Links in drawings will show up in backlinks of documents
@@ -42,23 +41,29 @@ Please upgrade to Obsidian v0.12.19 or higher to get the latest release.
     - `![[myfile#section]]` also works, this will transclude the section
     - you can also specify word wrapping for transcluded text by adding the max character count in curly brackets right after the transclusion e.g. `![[myfile#^blockref]]{40}` will wrap text at 40 characters.
   - For convenience you can also use the command palette to insert links into drawings
-  - CTRL/CMD + hover to bring up the Obsidian quick preview for the link. (On Mac it is CTRL+CMD+hover).
-  - CTRL/CMD + CLICK a text element to open it as a link.
-  - CTRL/CMD + ALT + CLICK to create the file (if it does not yet exist) and open it
-  - CTRL/CMD + SHIFT + CLICK to open the file in a new pane
-  - CTRL/CMD + ALT + SHIFT + CLICK to create the file (if it does not yet exist) and open it in a new pane
+  - <kbd>CTRL/CMD + hover</kbd> to bring up the Obsidian quick preview for the link. (On Mac it is <kbd>CTRL+CMD+hover</kbd>).
+  - <kbd>CTRL/CMD + CLICK</kbd> a text element to open it as a link.
+  - <kbd>CTRL/CMD + ALT + CLICK</kbd> to create the file (if it does not yet exist) and open it
+  - <kbd>CTRL/CMD + SHIFT + CLICK</kbd> to open the file in a new pane
+  - <kbd>CTRL/CMD + ALT + SHIFT + CLICK</kbd> to create the file (if it does not yet exist) and open it in a new pane
 - Using the block reference you can also reference & transclude text that appears on drawings, in other documents
-- Insert LaTeX formulas using the Command Palette action "Insert LaTeX formula". You can edit formulas either in Markdown view, or by CTRL/CMD + Click on the formula.
+- Insert LaTeX formulas using the Command Palette action "Insert LaTeX formula". You can edit formulas either in Markdown view, or by <kbd>CTRL/CMD + Click</kbd> on the formula.
 - Drag & Drop support
   - You can drag files from the Obsidian file explorer and they will become links to those files in Excalidraw.
-  - Dragging image files (PNG, SVG, JPG, Excalidraw) from obsidian files explorer while pressing the CTRL/CMD button will embed the image into your drawing.
-  - You can drag and drop images from outside obsidian onto Excalidraw. These images will be embedded into your drawing and saved to Obsidian.
+  - Dragging image files (PNG, SVG, JPG, Excalidraw) from Obsidian's file explorer while pressing the <kbd>CTRL/CMD</kbd> button will embed the image into your drawing.
+  - You can drag and drop images from outside Obsidian onto Excalidraw. These images will be embedded into your drawing and saved to Obsidian.
   - You can drag and drop text from Markdown views onto Excalidraw.
   - You can drag and drop web addresses from your browser and they will become links.
 - Image support
   - On iOS and Android you can add images from your camera by pressing the add image button in Excalidraw.
   - You can copy/paste images into your drawing. Images will be saved in your vault.
   - You can drag and drop images as explained above.
+- Block referencing parts of images
+  - When referencing an element on the canvas in a link pointing to an Excalidraw file using the elementId or the section header (i.e. a Text Element containing the `# <Section title>`) - e.g. `[[file#^elementID]]`, you can add the `group=` prefix, e.g. `[[file#^group=elementID]]` or the `area=` prefix, e.g. `[[file#area=Section heading]]`.
+    - If the `group=` prefix is found Excalidraw will select the group of elements in the same group as the element referenced by the elementID (block reference) or the section heading.
+    - If the `area=` prefix is found Excalidraw will insert a cutout of the image around the referenced element.
+    - Note that the `area=` selector is not supported when embedding Excalidraw as PNG into your markdown documents.
+    - Referencing the elementID of a text element without the `group=` or `area=` prefix will transclude the element as plain text. Referencing a non-Text Element (e.g. rectangle, ellipse, etc.) without the `group=` or `area=` prefix will result in an Obsidian error since these elementIds are not present in the Excalidraw markdown file as block references.
 - Since 1.2.0 Drawing files are stored in Markdown files
   - You can add tags to drawings
   - You can add metadata to the YAML front matter of drawings
@@ -72,20 +77,20 @@ Please upgrade to Obsidian v0.12.19 or higher to get the latest release.
   - Frontmatter tags to customize image export at a file level [519](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/519). If these keys are present they will override the default excalidraw embed and export settings.
     - `excalidraw-export-transparent: true`:  true == Transparent / false == with background. 
     - `excalidraw-export-dark`: true == Dark mode / false == light mode.
-    - `excalidraw-export-svgpadding`: This only affects export to SVG. Specify the export padding for the image
+    - `excalidraw-export-padding`: Specify the export padding for the image
     - `excalidraw-export-pngscale`: This only affects export to PNG. Specify the export scale for the image. The typical range is between 0.5 and 5, but you can experiment with other values as well.
 - Embed complete markdown files into your drawings
-  - Drag from the desired file from the Obsidian file explorer and hold down CTRL/CMD while dropping the file onto the canvas.
+  - Drag from the desired file from the Obsidian file explorer and hold down <kbd>CTRL/CMD</kbd> while dropping the file onto the canvas.
   - Use the command palette action: `Insert markdown file from vault`
   - Use custom woff, woff2 or TTF font to display the document, you can set the default font to use under Excalidraw Settings.
   - You can set a custom css for rendering the snapshot image of your markdown document. Only operating system standard fonts are supported as the font-family ([Win10](https://docs.microsoft.com/en-us/typography/fonts/windows_10_font_list), [Mac & iOS](https://developer.apple.com/fonts/system-fonts/)), plus you can set one additional custom font using the setting explained above. (for a demonstration watch this [video](https://youtu.be/K6qZkTz8GHs) and check out this [sample css](https://github.com/zsviczian/obsidian-excalidraw-plugin/discussions/281)).
-    - To help with styling you can observe the SVG snapshot of the markdown document created by Excalidraw. Open Obsidian Developer Console (CTRL+Shift+i) and execute the following command: `ExcalidrawAutomate.mostRecentMarkdownSVG`
+    - To help with styling you can observe the SVG snapshot of the markdown document created by Excalidraw. Open Obsidian Developer Console (<kbd>CTRL+Shift+i</kbd>) and execute the following command: `ExcalidrawAutomate.mostRecentMarkdownSVG`
   - You can control appearance of the embedded markdown file on a file by file bases by adding the following front matter keys to your markdown document:
     - `excalidraw-font: Virgil|Cascadia|font_file_name.extension`
     - `excalidraw-font-color: css-color-name|#HEXcolor|any-other-html-standard-format`, you can find css color names [here](https://www.w3schools.com/colors/colors_names.asp).
     - `excalidraw-border-color: css-color-name|#HEXcolor|any-other-html-standard-format`
     - `excalidraw-css: "css-filename|css snippet"`
-  - Switch to markdown view or use CTRL/CMD+ALT/OPT click on the image to edit properties of the embed: `[[filename#^blockref|WIDTHxMAXHEIGHT]]`
+  - Switch to markdown view or use <kbd>CTRL/CMD+ALT/OPT</kbd> click on the image to edit properties of the embed: `[[filename#^blockref|WIDTHxMAXHEIGHT]]`
 - Includes full [QuickAdd](https://github.com/chhoumann/quickadd), [Templater](https://silentvoid13.github.io/Templater/) and [Dataview](https://blacksmithgu.github.io/obsidian-dataview/docs/api/intro/) support through ExcalidrawAutomate. Check out the [detailed help + examples](https://zsviczian.github.io/obsidian-excalidraw-plugin/). I also have a [YouTube ExcalidrawAutomate Playlist](https://www.youtube.com/playlist?list=PL6mqgtMZ4NP1IR4nXxSlMA4PA5E-qpyHZ) with lots of examples.
   - Since 1.5.0 you can easily execute ExcalidrawAutomate macros and assign command palette shortcuts to them, using the ScriptEngine. You will find an intro video and a growing library of ready to install scripts [here](https://github.com/zsviczian/obsidian-excalidraw-plugin/tree/master/ea-scripts).
 - REQUIRES AN OBSIDIAN SYNC SUBSCRIPTION: Full drawing file history and synchronization between devices

docs/API/attributes_functions_overview.md

@@ -3,10 +3,12 @@
 Here's the interface implemented by ExcalidrawAutomate:
 
 ```typescript
-export interface ExcalidrawAutomate {
+export declare class ExcalidrawAutomate implements ExcalidrawAutomateInterface {
   plugin: ExcalidrawPlugin;
-  elementsDict: {}; //contains the ExcalidrawElements currently edited in Automate indexed by el.id
-  imagesDict: {}; //the images files including DataURL, indexed by fileId
+  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;
@@ -29,178 +31,521 @@ export interface ExcalidrawAutomate {
     viewBackgroundColor: string;
     gridSize: number;
   };
-  setFillStyle(val: number): void; //0:"hachure", 1:"cross-hatch" 2:"solid"
-  setStrokeStyle(val: number): void; //0:"solid", 1:"dashed", 2:"dotted"
-  setStrokeSharpness(val: number): void; //0:"round", 1:"sharp"
-  setFontFamily(val: number): void; //1: Virgil, 2:Helvetica, 3:Cascadia
-  setTheme(val: number): void; //0:"light", 1:"dark"
-  addToGroup(objectIds: []): string;
-  toClipboard(templatePath?: string): void;
-  getElements(): ExcalidrawElement[]; //get all elements from ExcalidrawAutomate elementsDict
-  getElement(id: string): ExcalidrawElement; //get single element from ExcalidrawAutomate elementsDict
-  create(params?: {
-    //create a drawing and save it to filename
-    filename?: string; //if null: default filename as defined in Excalidraw settings
-    foldername?: string; //if null: default folder as defined in Excalidraw settings
-    templatePath?: string;
-    onNewPane?: boolean;
-    frontmatterKeys?: {
-      "excalidraw-plugin"?: "raw" | "parsed";
-      "excalidraw-link-prefix"?: string;
-      "excalidraw-link-brackets"?: boolean;
-      "excalidraw-url-prefix"?: string;
+    constructor(plugin: ExcalidrawPlugin, view?: ExcalidrawView);
+    /**
+     *
+     * @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>;
+    /**
+     * 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-svgpadding"?: number;
+            "excalidraw-export-pngscale"?: number;
+            "excalidraw-default-mode"?: "view" | "zen";
+        };
+    }): 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;
+    /**
+     *
+     * @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;
+    /**
+     *
+     * @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?: string;
+        box?: boolean | "box" | "blob" | "ellipse" | "diamond";
+        boxPadding?: number;
+    }, 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): 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;
+    /**
+     *
+     * @param view
+     * @returns
+     */
+    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;
+    /**
+     * 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;
+    /**
+     * 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
+     * @returns
+     */
+    addElementsToView(repositionToCursor?: boolean, save?: boolean, newElementsOnTop?: 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;
+    /**
+     * 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;
     };
-  }): Promise<string>;
-  createSVG(
-    templatePath?: string,
-    embedFont?: boolean,
-    exportSettings?: ExportSettings, //use ExcalidrawAutomate.getExportSettings(boolean,boolean)
-    loader?: EmbeddedFilesLoader, //use ExcalidrawAutomate.getEmbeddedFilesLoader(boolean?)
-    theme?: string,
-  ): Promise<SVGSVGElement>;
-  createPNG(
-    templatePath?: string,
-    scale?: number,
-    exportSettings?: ExportSettings, //use ExcalidrawAutomate.getExportSettings(boolean,boolean)
-    loader?: EmbeddedFilesLoader, //use ExcalidrawAutomate.getEmbeddedFilesLoader(boolean?)
-    theme?: string,
-  ): Promise<any>;
-  wrapText(text: string, lineLen: number): string;
-  addRect(topX: number, topY: number, width: number, height: number): string;
-  addDiamond(topX: number, topY: number, width: number, height: number): string;
-  addEllipse(topX: number, topY: number, width: number, height: number): string;
-  addBlob(topX: number, topY: number, width: number, height: number): string;
-  addText(
-    topX: number,
-    topY: number,
-    text: string,
-    formatting?: {
-      wrapAt?: number;
-      width?: number;
-      height?: number;
-      textAlign?: string;
-      box?: boolean | "box" | "blob" | "ellipse" | "diamond"; //if !null, text will be boxed
-      boxPadding?: number;
-    },
-    id?: string,
-  ): string;
-  addLine(points: [[x: number, y: number]]): string;
-  addArrow(
-    points: [[x: number, y: number]],
-    formatting?: {
-      startArrowHead?: string;
-      endArrowHead?: string;
-      startObjectId?: string;
-      endObjectId?: string;
-    },
-  ): string;
-  addImage(topX: number, topY: number, imageFile: TFile): Promise<string>;
-  addLaTex(topX: number, topY: number, tex: string): Promise<string>;
-  connectObjects(
-    objectA: string,
-    connectionA: ConnectionPoint, //type ConnectionPoint = "top" | "bottom" | "left" | "right" | null
-    objectB: string,
-    connectionB: ConnectionPoint, //when passed null, Excalidraw will automatically decide
-    formatting?: {
-      numberOfPoints?: number; //points on the line. Default is 0 ie. line will only have a start and end point
-      startArrowHead?: string; //"triangle"|"dot"|"arrow"|"bar"|null
-      endArrowHead?: string; //"triangle"|"dot"|"arrow"|"bar"|null
-      padding?: number;
-    },
-  ): void;
-  clear(): void; //clear elementsDict and imagesDict only
-  reset(): void; //clear() + reset all style values to default
-  isExcalidrawFile(f: TFile): boolean; //returns true if MD file is an Excalidraw file
-  //view manipulation
-  targetView: ExcalidrawView; //the view currently edited
-  setView(view: ExcalidrawView | "first" | "active"): ExcalidrawView;
-  getExcalidrawAPI(): any; //https://github.com/excalidraw/excalidraw/tree/master/src/packages/excalidraw#ref
-  getViewElements(): ExcalidrawElement[]; //get elements in View
-  deleteViewElements(el: ExcalidrawElement[]): boolean;
-  getViewSelectedElement(): ExcalidrawElement; //get the selected element in the view, if more are selected, get the first
-  getViewSelectedElements(): ExcalidrawElement[];
-  getViewFileForImageElement(el: ExcalidrawElement): TFile | null; //Returns the TFile file handle for the image element
-  copyViewElementsToEAforEditing(elements: ExcalidrawElement[]): void; //copies elements from view to elementsDict for editing
-  viewToggleFullScreen(forceViewMode?: boolean): void;
-  connectObjectWithViewSelectedElement( //connect an object to the selected element in the view
-    objectA: string, //see connectObjects
-    connectionA: ConnectionPoint,
-    connectionB: ConnectionPoint,
-    formatting?: {
-      numberOfPoints?: number;
-      startArrowHead?: string;
-      endArrowHead?: string;
-      padding?: number;
-    },
-  ): boolean;
-  addElementsToView( //Adds elements from elementsDict to the current view
-    repositionToCursor?: boolean, //default is false
-    save?: boolean, //default is true
-    //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
-    newElementsOnTop?: boolean, //default is false, i.e. the new elements get to the bottom of the stack
-  ): Promise<boolean>;
-  onDropHook(data: {
-    //if set Excalidraw will call this function onDrop events
-    ea: ExcalidrawAutomate;
-    event: React.DragEvent<HTMLDivElement>;
-    draggable: any; //Obsidian draggable object
-    type: "file" | "text" | "unknown";
-    payload: {
-      files: TFile[]; //TFile[] array of dropped files
-      text: string; //string
+    /**
+     * 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;
+    /**
+     * 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[];
+    /**
+     * @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[];
+    /**
+     * 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
+     * @returns
+     */
+    openFileInNewOrAdjacentLeaf(file: TFile): WorkspaceLeaf;
+    /**
+     * measure text size based on current style settings
+     * @param text
+     * @returns
+     */
+    measureText(text: string): {
+        width: number;
+        height: number;
     };
-    excalidrawFile: TFile; //the file receiving the drop event
-    view: ExcalidrawView; //the excalidraw view receiving the drop
-    pointerPosition: { x: number; y: number }; //the pointer position on canvas at the time of drop
-  }): boolean; //a return of true will stop the default onDrop processing in Excalidraw
-  mostRecentMarkdownSVG: SVGSVGElement; //Markdown renderer will drop a copy of the most recent SVG here for debugging purposes
-  getEmbeddedFilesLoader(isDark?: boolean): EmbeddedFilesLoader; //utility function to generate EmbeddedFilesLoader object
-  getExportSettings( //utility function to generate ExportSettings object
-    withBackground: boolean,
-    withTheme: boolean,
-  ): ExportSettings;
-  getBoundingBox(elements: ExcalidrawElement[]): {
-    //get bounding box of elements
-    topX: number; //bounding box is the box encapsulating all of the elements completely
-    topY: number;
-    width: number;
-    height: number;
-  };
-  //elements grouped by the highest level groups
-  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
-  getLargestElement(elements: ExcalidrawElement[]): ExcalidrawElement;
-  // 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, //if given, element is inflated by this value
-  ): Point[];
-
-  //See OCR plugin for example on how to use scriptSettings
-  activeScript: string; //Set automatically by the ScriptEngine
-  getScriptSettings(): {}; //Returns script settings. Saves settings in plugin settings, under the activeScript key
-  setScriptSettings(settings: any): Promise<void>; //sets script settings.
-  openFileInNewOrAdjacentLeaf(file: TFile): WorkspaceLeaf; //Open a file in a new workspaceleaf or reuse an existing adjacent leaf depending on Excalidraw Plugin Settings
-  measureText(text: string): { width: number; height: number }; //measure text size based on current style settings
-  //verifyMinimumPluginVersion returns true if plugin version is >= than required
-  //recommended use:
-  //if(!ea.verifyMinimumPluginVersion || !ea.verifyMinimumPluginVersion("1.5.20")) {new Notice("message");return;}
-  verifyMinimumPluginVersion(requiredVersion: string): boolean;
-  selectElementsInView(elements: ExcalidrawElement[]): void; //sets selection in view
-  generateElementId(): string; //returns an 8 character long random id
-  cloneElement(element: ExcalidrawElement): ExcalidrawElement; //Returns a clone of the element with a new id
-  moveViewElementToZIndex(elementId:number, newZIndex:number): void; //Moves the element to a specific position in the z-index
-  hexStringToRgb(color: string):number[];
-  rgbToHexString(color: number[]):string;
-  hslToRgb(color: number[]):number[];
-  rgbToHsl(color:number[]):number[];  
-  colorNameToHex(color:string):string;
-}
-```
+    /**
+     * 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[]): 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;
+    /**
+     *
+     * @param color
+     * @returns
+     */
+    hexStringToRgb(color: string): number[];
+    /**
+     *
+     * @param color
+     * @returns
+     */
+    rgbToHexString(color: number[]): string;
+    /**
+     *
+     * @param color
+     * @returns
+     */
+    hslToRgb(color: number[]): number[];
+    /**
+     *
+     * @param color
+     * @returns
+     */
+    rgbToHsl(color: number[]): number[];
+    /**
+     *
+     * @param color
+     * @returns
+     */
+    colorNameToHex(color: string): string;
+}```
 

docs/API/introduction.md

@@ -2,7 +2,7 @@
 ## Introduction to the API
 You can access Excalidraw Automate via the ExcalidrawAutomate object. I recommend starting Templater, DataView and QuickAdd scripts with the following code:
 
-*Use CTRL+Shift+V to paste code into Obsidian!*
+*Use <kbd>CTRL+Shift+V</kbd> to paste code into Obsidian!*
 ```javascript
 const ea = ExcalidrawAutomate;
 ea.reset();
@@ -25,7 +25,7 @@ You can change the styling between adding different elements. My logic for separ
 #### Create a new drawing with custom name, in a custom folder, using a template
 This simple script gives you significant additional flexibility over Excalidraw Plugin settings to name your drawings, place them into folders, and to apply templates.
 
-*Use CTRL+Shift+V to paste code into Obsidian!*
+*Use <kbd>CTRL+Shift+V</kbd> to paste code into Obsidian!*
 ```javascript
 <%*
   const ea = ExcalidrawAutomate;
@@ -40,7 +40,7 @@ This simple script gives you significant additional flexibility over Excalidraw
 ```
 
 #### Create a simple drawing
-*Use CTRL+Shift+V to paste code into Obsidian!*
+*Use <kbd>CTRL+Shift+V</kbd> to paste code into Obsidian!*
 ```javascript
 <%*
   const ea = ExcalidrawAutomate;
@@ -62,7 +62,7 @@ The script will generate the following drawing:
 #### Add a TextElement in a box to an open Excalidraw View. 
 Position the new element under the currently selected element, with an arrow from the selected element to the added text.
 
-*Use CTRL+Shift+V to paste code into Obsidian!*
+*Use <kbd>CTRL+Shift+V</kbd> to paste code into Obsidian!*
 ```javascript
 <%*
   const ea = ExcalidrawAutomate;

docs/API/utility.md

@@ -143,7 +143,7 @@ getViewSelectedElement():ExcalidrawElement
 
 You first need to set the view calling `setView()`.
 
-If an element is selected in the targetView the function returns the selected element. If multiple elements are selected, either by SHIFT+Clicking to select multiple elements, or by selecting a group, the first of the elements will be selected. If you want to specify which element to select from a group, double click the desired element in the group.
+If an element is selected in the targetView the function returns the selected element. If multiple elements are selected, either by <kbd>SHIFT+Clicking</kbd> to select multiple elements, or by selecting a group, the first of the elements will be selected. If you want to specify which element to select from a group, double click the desired element in the group.
 
 This function is helpful if you want to add a new element in relation to an existing element in your drawing.
 
@@ -218,4 +218,4 @@ ea.onDropHook = (data) => {
   console.log(data); 
   return false;
 }
-```
+```

docs/Examples/apply_template.md

@@ -2,7 +2,7 @@
 ## Applying an Excalidraw Template to a New Drawing
 This example is similar to the one in the introduction, only rotated 90°, and using a template, plus specifying a filename and folder to save the drawing, and opening the new drawing in a new pane.
 
-*Use CTRL+Shift+V to paste code into Obsidian!*
+*Use <kbd>CTRL+Shift+V</kbd> to paste code into Obsidian!*
 ```javascript
 <%*
   const ea = ExcalidrawAutomate;

docs/Examples/connect_objects.md

@@ -2,7 +2,7 @@
 ## Connect Objects
 This [Templater](https://github.com/SilentVoid13/Templater) template demonstrates how to connect two objects using ExcalidrawAutomate.
 
-*Use CTRL+Shift+V to paste code into Obsidian!*
+*Use <kbd>CTRL+Shift+V</kbd> to paste code into Obsidian!*
 ```javascript
 <%*
   const ea = ExcalidrawAutomate;

docs/Examples/dataviewjs_mindmap.md

@@ -19,7 +19,7 @@ The input file is `Demo.md` with the following contents:
 
 ### dataviewjs script
 The `dataviewjs` script looks like this: 
-*Use CTRL+Shift+V to paste code into Obsidian!*
+*Use <kbd>CTRL+Shift+V</kbd> to paste code into Obsidian!*
 ```javascript
 function crawl(subtasks) {
   let size = subtasks.length > 0 ? 0 : 1; //if no children then a leaf with size 1

docs/Examples/insert_new_drawing.md

@@ -2,7 +2,7 @@
 ## Insert new drawing into currently edited document
 This [Templater](https://github.com/SilentVoid13/Templater) template will prompt you for the title of the drawing. It will create a new drawing with the provided title, and in the folder of the document you were editing. It will then transclude the new drawing at the cursor location and open the new drawing in a new workspace leaf by splitting the current leaf.
 
-*Use CTRL+Shift+V to paste code into Obsidian!*
+*Use <kbd>CTRL+Shift+V</kbd> to paste code into Obsidian!*
 ```javascript
 <%*
   const defaultTitle = tp.date.now("HHmm")+' '+tp.file.title;

docs/Examples/templater_mindmap.md

@@ -22,7 +22,7 @@ Example input:
 ```
 
 ### Templater script
-*Use CTRL+Shift+V to paste code into Obsidian!*
+*Use <kbd>CTRL+Shift+V</kbd> to paste code into Obsidian!*
 ```javascript
 <%*
 const IDX = Object.freeze({"depth":0, "text":1, "parent":2, "size":3, "children": 4, "objectId":5});

ea-scripts/Convert selected text elements to sticky notes.md

@@ -15,7 +15,7 @@ settings = ea.getScriptSettings();
 if(!settings["Border color"]) {
 	settings = {
 	  "Border color" : {
-			value: "#000000",
+			value: "transparent",
       description: "Any legal HTML color (#000000, rgb, color-name, etc.). Set to 'transparent' for transparent color."
 		},
 		"Background color" : {

ea-scripts/Expand rectangles vertically.md

@@ -58,9 +58,9 @@ for (var i = 0; i < topGroups.length; i++) {
     .filter((el) => el.type === "rectangle")
     .sort((lha, rha) => lha.y - rha.y);
     
-  const groupWith = groupHeights[i].height;
-  if (groupWith < maxGroupHeight) {
-    const distance = maxGroupHeight - groupWith;
+  const groupWidth = groupHeights[i].height;
+  if (groupWidth < maxGroupHeight) {
+    const distance = maxGroupHeight - groupWidth;
     const perRectDistance = distance / rects.length;
     for (var j = 0; j < rects.length; j++) {
       const rect = rects[j];
@@ -128,4 +128,4 @@ function recalculateEndPointOfLine(line, el) {
     if(intersectA.length > 0) {
     	line.points[line.points.length - 1] = [intersectA[0][0] - line.x, intersectA[0][1] - line.y];
 	}
-}
+}

ea-scripts/Mindmap connector.md

@@ -0,0 +1,113 @@
+/*
+
+![](https://github.com/xllowl/obsidian-excalidraw-plugin/blob/master/images/mindmap%20connector.png)
+
+![](https://github.com/xllowl/obsidian-excalidraw-plugin/blob/master/images/Mindmap%20connector1.png)
+This script creates mindmap like lines(only right and down side are available). The line will starts according to the creation time of the elements. So you may need to create the header element first.
+
+```javascript
+*/
+const elements = ea.getViewSelectedElements();
+ea.copyViewElementsToEAforEditing(elements);
+groups = ea.getMaximumGroups(elements);
+
+els=[];
+elsx=[];
+elsy=[];
+for (i = 0, len =groups.length; i < len; i++) {
+  els.push(ea.getLargestElement(groups[i]));
+  elsx.push(ea.getLargestElement(groups[i]).x);
+  elsy.push(ea.getLargestElement(groups[i]).y);
+}
+//line style setting
+ea.style.strokeColor = els[0].strokeColor;
+ea.style.strokeWidth = els[0].strokeWidth;
+ea.style.strokeStyle = els[0].strokeStyle;
+ea.style.strokeSharpness = els[0].strokeSharpness;
+//all min max x y
+let maxy = Math.max.apply(null, elsy);
+let indexmaxy=elsy.indexOf(maxy);
+let miny = Math.min.apply(null, elsy);
+let indexminy = elsy.indexOf(miny);
+let maxx = Math.max.apply(null, elsx);
+let indexmaxx = elsx.indexOf(maxx);
+let minx = Math.min.apply(null, elsx);
+let indexminx = elsx.indexOf(minx);
+//child max min x y
+let gmaxy = Math.max.apply(null, elsy.slice(1));
+let gindexmaxy=elsy.indexOf(gmaxy);
+let gminy = Math.min.apply(null, elsy.slice(1));
+let gindexminy = elsy.indexOf(gminy);
+let gmaxx = Math.max.apply(null, elsx.slice(1));
+let gindexmaxx = elsx.indexOf(gmaxx);
+let gminx = Math.min.apply(null, elsx.slice(1));
+let gindexminx = elsx.indexOf(gminx);
+let s=0;//Set line direction down as default 
+if (indexminx==0 &&  els[0].x + els[0].width<=gminx) {
+  s=1; 
+}
+else if (indexminy == 0) {
+  s=0;
+}
+var length_left;
+if(els[0].x + els[0].width * 2<=gminx){length_left=els[0].x + els[0].width * 1.5;}
+else {length_left=(els[0].x + els[0].width+gminx)/2;}
+
+var length_down;
+if(els[0].y + els[0].height* 2.5<=gminy){length_down=els[0].y + els[0].height * 2;}
+else {length_down=(els[0].y + els[0].height+gminy)/2;}
+if(s) {
+  ea.addLine(
+    [[length_left,
+    maxy + els[indexmaxy].height / 2],
+    [length_left,
+    miny + els[indexminy].height / 2]]
+  );
+  for (i = 1, len = groups.length; i < len; i++) {
+    ea.addLine(
+      [[els[i].x,
+      els[i].y + els[i].height/2],
+      [length_left,
+      els[i].y + els[i].height/2]]
+    );
+  }
+  ea.addArrow(
+    [[els[0].x+els[0].width,
+    els[0].y + els[0].height / 2],
+    [length_left,
+    els[0].y + els[0].height / 2]],
+    {
+      startArrowHead: "none",
+      endArrowHead: "dot"
+    }
+  )
+}
+
+else {
+  ea.addLine(
+    [[maxx + els[indexmaxx].width / 2,
+    length_down],
+    [minx + els[indexminx].width / 2,
+    length_down]]
+  );
+  for (i = 1, len = groups.length; i < len; i++) {
+    ea.addLine(
+      [[els[i].x + els[i].width / 2,
+      els[i].y],
+      [els[i].x + els[i].width / 2,
+      length_down]]
+    );
+  }
+  ea.addArrow(
+    [[els[0].x + els[0].width / 2,
+    els[0].y + els[0].height],
+    [els[0].x + els[0].width / 2,
+    length_down]],
+    {
+      startArrowHead: "none",
+      endArrowHead: "dot"
+    }
+  );
+}
+
+await ea.addElementsToView(false,false,true);

ea-scripts/Mindmap connector.svg

@@ -0,0 +1,12 @@
+<svg width="607" height="541" viewBox="0 0 607 541" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M280 43.355V253.355H140V206.687L0 206.691V346.691H140V300.023H280V510.023C280 522.925 290.453 533.355 303.332 533.355H490.002C502.904 533.355 513.334 522.925 513.334 510.023C513.334 497.144 502.904 486.691 490.002 486.691H326.672V300.021H490.002C502.904 300.021 513.334 289.568 513.334 276.689C513.334 263.81 502.904 253.357 490.002 253.357H326.672V66.6869H490.002C502.904 66.6869 513.334 56.2569 513.334 43.3549C513.334 30.4529 502.904 20.0229 490.002 20.0229H303.332C290.453 20.019 280 30.4489 280 43.3509V43.355ZM46.67 300.025V253.357H93.338V300.025H46.67Z" fill="black"/>
+<rect x="540" y="23" width="39" height="39" fill="#D9D9D9"/>
+<rect x="503" width="104" height="95" fill="#D9D9D9"/>
+<rect x="503.5" y="0.5" width="103" height="94" fill="black" stroke="black"/>
+<rect x="503" y="223" width="104" height="95" fill="black"/>
+<rect x="503.5" y="446.5" width="103" height="94" fill="black" stroke="black"/>
+<path d="M532 243H580V291H532V243Z" fill="white"/>
+<path d="M532 475H580V523H532V475Z" fill="white"/>
+<path d="M532 243H580V291H532V243Z" fill="white"/>
+<path d="M532 23H580V71H532V23Z" fill="white"/>
+</svg>

ea-scripts/README.md

@@ -3,13 +3,28 @@ Click to watch the intro video:
 
 [![Script Engine](https://user-images.githubusercontent.com/14358394/145684531-8d9c2992-59ac-4ebc-804a-4cce1777ded2.jpg)](https://youtu.be/hePJcObHIso)
 
+> **Warning**
+> There is an easier way to install/manage scripts than what is shown in this video
+
 See the [Excalidraw Script Engine](https://zsviczian.github.io/obsidian-excalidraw-plugin/ExcalidrawScriptsEngine.html) documentation for more details.
 
 ## How to install scripts into your Obsidian Vault
+To install one of the built-in scripts:
+- Open up an excalidraw drawing in Obsidian
+- In the pane dropdown menu select "Install or update Excalidraw Scripts"
+- Click on one of the available scripts
+- Click on "Install this script" (note if the script is already installed you will instead see an option to update it)
+- Restart Obsidian so the script will be picked up
+
+Note: By default this will install the script into your vault in the `Excalidraw/Scripts/Downloaded` folder
+
+<details><summary>Manual installation of scripts</summary>
+
 Open the script you are interested in and save it to your Obsidian Vault including the first line `/*`, or open it in "Raw" and copy the entire contents to Obsidian.
 
 ![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-download-raw.jpg)
 
+</details>
 
 ## List of available scripts
 |Title|Description|Icon|Contributor|
@@ -39,6 +54,7 @@ Open the script you are interested in and save it to your Obsidian Vault includi
 |[Fixed vertical distance between centers](Fixed%20vertical%20distance%20between%20centers.md)|This script arranges the selected elements vertically with a fixed center spacing.|![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-fixed-vertical-distance-between-centers.png)|[@1-2-3](https://github.com/1-2-3)|
 |[Fixed vertical distance](Fixed%20vertical%20distance.md)|The script arranges the selected elements vertically with a fixed spacing. When we create an architecture diagram or mind map, we often need to arrange a large number of elements in a fixed spacing. `Fixed spacing` and `Fixed vertical Distance` scripts can save us a lot of time.|![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-fixed-vertical-distance.png)|[@1-2-3](https://github.com/1-2-3)|
 |[Lighten background color](Lighten%20background%20color.md)|This script lightens the background color of the selected element by 2% at a time. You can use this script several times until you are satisfied. It is recommended to set a shortcut key for this script so that you can quickly try to DARKEN and LIGHTEN the color effect.In contrast to the `Modify background color opacity` script, the advantage is that the background color of the element is not affected by the canvas color, and the color value does not appear in a strange rgba() form.|![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/darken-lighten-background-color.png)|[@1-2-3](https://github.com/1-2-3)|
+|[Mindmap connector](Mindmap%20connector.md)|This script creates mindmap like lines (only right side and down available currently) for selected elements. The line will start according to the creation time of the elements. So you should create the header element first.|![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/mindmap%20connector.png)|[@xllowl](https://github.com/xllowl)|
 |[Modify background color opacity](Modify%20background%20color%20opacity.md)|This script changes the opacity of the background color of the selected boxes. The default background color in Excalidraw is so dark that the text is hard to read. You can lighten the color a bit by setting transparency. And you can tweak the transparency over and over again until you're happy with it. Although excalidraw has the opacity option in its native property Settings, it also changes the transparency of the border. Use this script to change only the opacity of the background color without affecting the border.|![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-modify-background-color-opacity.png)|[@1-2-3](https://github.com/1-2-3)|
 |[Normalize Selected Arrows](Normalize%20Selected%20Arrows.md)|This script will reset the start and end positions of the selected arrows. The arrow will point to the center of the connected box and will have a gap of 8px from the box.|![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-normalize-selected-arrows.png)|[@1-2-3](https://github.com/1-2-3)|
 |[OCR - Optical Character Recognition](OCR%20-%20Optical%20Character%20Recognition.md)|The script will  1) send the selected image file to [taskbone.com](https://taskbone.com) to exctract the text from the image, and 2) will add the text to your drawing as a text element.|![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-ocr.jpg)|[@zsviczian](https://github.com/zsviczian)|
@@ -58,4 +74,4 @@ Open the script you are interested in and save it to your Obsidian Vault includi
 |[TheBrain-navigation](TheBrain-navigation.md)|An Excalidraw based graph user interface for your Vault. Requires the [Dataview plugin](https://github.com/blacksmithgu/obsidian-dataview). Generates a graph view similar to that of [TheBrain](https://TheBrain.com) plex. Watch introduction to this script on [YouTube](https://youtu.be/plYobK-VufM).|![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/TheBrain.jpg)|[@zsviczian](https://github.com/zsviczian)|
 |[Toggle Fullscreen on Mobile](Toggle%20Fullscreen%20on%20Mobile.md)|Hides Obsidian workspace leaf padding and header (based on option in settings, default is "hide header" = false) which will take Excalidraw to full screen. ⚠ Note that if the header is not visible, it will be very difficult to invoke the command palette to end full screen. Only hide the header if you have a keyboard or you've practiced opening command palette!|![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/ea-toggle-fullscreen.jpg)|[@zsviczian](https://github.com/zsviczian)|
 |[Transfer TextElements to Excalidraw markdown metadata](Transfer%20TextElements%20to%20Excalidraw%20markdown%20metadata.md)|The script will delete the selected text elements from the canvas and will copy the text from these text elements into the Excalidraw markdown file as metadata. This means, that the text will no longer be visible in the drawing, however you will be able to search for the text in Obsidian and find the drawing containing this image.|![](https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-text-to-metadata.jpg)|[@zsviczian](https://github.com/zsviczian)|
-|[Zoom to Fit Selected Elements](Zoom%20to%20Fit%20Selected%20Elements.md)|Similar to Excalidraw standard SHIFT+2 feature: Zoom to fit selected elements, but with the ability to zoom to 1000%. Inspiration: [#272](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/272)||[@zsviczian](https://github.com/zsviczian)|
+|[Zoom to Fit Selected Elements](Zoom%20to%20Fit%20Selected%20Elements.md)|Similar to Excalidraw standard <kbd>SHIFT+2</kbd> feature: Zoom to fit selected elements, but with the ability to zoom to 1000%. Inspiration: [#272](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/272)||[@zsviczian](https://github.com/zsviczian)|

ea-scripts/Zoom to Fit Selected Elements.md

@@ -3,7 +3,7 @@
 
 Download this file and save to your Obsidian Vault including the first line, or open it in "Raw" and copy the entire contents to Obsidian.
 
-Similar to Excalidraw standard SHIFT+2 feature: Zoom to fit selected elements, but with the ability to zoom to 1000%. Inspiration: [#272](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/272)
+Similar to Excalidraw standard <kbd>SHIFT+2</kbd> feature: Zoom to fit selected elements, but with the ability to zoom to 1000%. Inspiration: [#272](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/272)
 
 See documentation for more details:
 https://zsviczian.github.io/obsidian-excalidraw-plugin/ExcalidrawScriptsEngine.html

ea-scripts/index-new.md

@@ -6,7 +6,7 @@ If you are enjoying the Excalidraw plugin then please support my work and enthus
 
 Jump ahead to the [[#List of available scripts]]
 
-# Intorducing Excalidraw Automate Script Engine
+# Introducing Excalidraw Automate Script Engine
 <iframe width="560" height="315" src="https://www.youtube.com/embed/hePJcObHIso" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
 
 Script Engine scripts are installed in the `Downloaded` subfolder of the `Excalidraw Automate script folder` specified in plugin settings.
@@ -52,6 +52,7 @@ I would love to include your contribution in the script library. If you have a s
 |<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Fixed%20vertical%20distance%20between%20centers.svg"/></div>|[[#Fixed vertical distance between centers]]|
 |<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Fixed%20vertical%20distance.svg"/></div>|[[#Fixed vertical distance]]|
 |<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Lighten%20background%20color.svg"/></div>|[[#Lighten background color]]|
+|<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Mindmap%20connector.svg"/></div>|[[#Mindmap connector]]|
 |<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Modify%20background%20color%20opacity.svg"/></div>|[[#Modify background color opacity]]|
 |<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Normalize%20Selected%20Arrows.svg"/></div>|[[#Normalize Selected Arrows]]|
 |<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/OCR%20-%20Optical%20Character%20Recognition.svg"/></div>|[[#OCR - Optical Character Recognition]]|
@@ -68,7 +69,6 @@ I would love to include your contribution in the script library. If you have a s
 |<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Set%20Stroke%20Width%20of%20Selected%20Elements.svg"/></div>|[[#Set Stroke Width of Selected Elements]]|
 |<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Set%20Text%20Alignment.svg"/></div>|[[#Set Text Alignment]]|
 |<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Split%20text%20by%20lines.svg"/></div>|[[#Split text by lines]]|
-|<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/TheBrain-navigation.svg"/></div>|[[#TheBrain-navigation]]|
 |<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Transfer%20TextElements%20to%20Excalidraw%20markdown%20metadata.svg"/></div>|[[#Transfer TextElements to Excalidraw markdown metadata]]|
 |<div><img src="https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Zoom%20to%20Fit%20Selected%20Elements.svg"/></div>|[[#Zoom to Fit Selected Elements]]|
 
@@ -222,6 +222,12 @@ https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea
 ```
 <table><tr  valign='top'><td class="label">Author</td><td class="data"><a href='https://github.com/1-2-3'>@1-2-3</a></td></tr><tr valign='top'><td class="label">Source</td><td class="data"><a href='https://github.com/zsviczian/obsidian-excalidraw-plugin/blob/master/ea-scripts/Lighten%20background%20color.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">This script lightens the background color of the selected element by 2% at a time. You can use this script several times until you are satisfied. It is recommended to set a shortcut key for this script so that you can quickly try to DARKEN and LIGHTEN the color effect.In contrast to the `Modify background color opacity` script, the advantage is that the background color of the element is not affected by the canvas color, and the color value does not appear in a strange rgba() form.<br><img src='https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/darken-lighten-background-color.png'></td></tr></table>
 
+## Mindmap connector
+```excalidraw-script-install
+https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Mindmap%20connector.md
+```
+<table><tr  valign='top'><td class="label">Author</td><td class="data"><a href='https://github.com/xllowl'>@xllowl</a></td></tr><tr valign='top'><td class="label">Source</td><td class="data"><a href='https://github.com/zsviczian/obsidian-excalidraw-plugin/blob/master/ea-scripts/Mindmap%20connector.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">This script creates mindmap like lines (only right side and down available currently) for selected elements. The line will start according to the creation time of the elements. So you should create the header element first.<br><img src='https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/mindmap%20connector.png'></td></tr></table>
+
 ## Modify background color opacity
 ```excalidraw-script-install
 https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Modify%20background%20color%20opacity.md
@@ -318,12 +324,6 @@ https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea
 ```
 <table><tr  valign='top'><td class="label">Author</td><td class="data"><a href='https://github.com/zsviczian'>@zsviczian</a></td></tr><tr valign='top'><td class="label">Source</td><td class="data"><a href='https://github.com/zsviczian/obsidian-excalidraw-plugin/blob/master/ea-scripts/Split%20text%20by%20lines.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">Split lines of text into separate text elements for easier reorganization<br><img src='https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/scripts-split-lines.jpg'></td></tr></table>
 
-## TheBrain-navigation
-```excalidraw-script-install
-https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/TheBrain-navigation.md
-```
-<table><tr  valign='top'><td class="label">Author</td><td class="data"><a href='https://github.com/zsviczian'>@zsviczian</a></td></tr><tr valign='top'><td class="label">Source</td><td class="data"><a href='https://github.com/zsviczian/obsidian-excalidraw-plugin/blob/master/ea-scripts/TheBrain-navigation.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">An Excalidraw based graph user interface for your Vault. Requires the <a href="https://github.com/blacksmithgu/obsidian-dataview">Dataview plugin</a>. Generates a graph view similar to that of <a href="https://TheBrain.com">TheBrain</a> plex.<br>Watch an introduction to this script on <a href="https://youtu.be/plYobK-VufM">YouTube</a>.<br><img src='https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/TheBrain.jpg'></td></tr></table>
-
 ## Transfer TextElements to Excalidraw markdown metadata
 ```excalidraw-script-install
 https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Transfer%20TextElements%20to%20Excalidraw%20markdown%20metadata.md
@@ -334,4 +334,4 @@ https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea
 ```excalidraw-script-install
 https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Zoom%20to%20Fit%20Selected%20Elements.md
 ```
-<table><tr  valign='top'><td class="label">Author</td><td class="data"><a href='https://github.com/zsviczian'>@zsviczian</a></td></tr><tr valign='top'><td class="label">Source</td><td class="data"><a href='https://github.com/zsviczian/obsidian-excalidraw-plugin/blob/master/ea-scripts/Zoom%20to%20Fit%20Selected%20Elements.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">Similar to Excalidraw standard SHIFT+2 feature: Zoom to fit selected elements, but with the ability to zoom to 1000%. Inspiration: [#272](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/272)</td></tr></table>
+<table><tr  valign='top'><td class="label">Author</td><td class="data"><a href='https://github.com/zsviczian'>@zsviczian</a></td></tr><tr valign='top'><td class="label">Source</td><td class="data"><a href='https://github.com/zsviczian/obsidian-excalidraw-plugin/blob/master/ea-scripts/Zoom%20to%20Fit%20Selected%20Elements.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">Similar to Excalidraw standard <kbd>SHIFT+2</kbd> feature: Zoom to fit selected elements, but with the ability to zoom to 1000%. Inspiration: [#272](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/272)</td></tr></table>

ea-scripts/index.md

@@ -6,7 +6,7 @@ If you are enjoying the Excalidraw plugin then please support my work and enthus
 
 Jump ahead to the [[#List of available scripts]]
 
-# Intorducing Excalidraw Automate Script Engine
+# Introducing Excalidraw Automate Script Engine
 <iframe width="560" height="315" src="https://www.youtube.com/embed/hePJcObHIso" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
 
 Script Engine scripts are installed in the `Downloaded` subfolder of the `Excalidraw Automate script folder` specified in plugin settings.
@@ -50,6 +50,7 @@ I would love to include your contribution in the script library. If you have a s
 - [[#Fixed vertical distance between centers]]
 - [[#Fixed vertical distance]]
 - [[#Lighten background color]]
+- [[Mindmap connector]]
 - [[#Modify background color opacity]]
 - [[#Normalize Selected Arrows]]
 - [[#OCR - Optical Character Recognition]]
@@ -220,6 +221,12 @@ https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea
 ```
 <table><tr  valign='top'><td class="label">Author</td><td class="data"><a href='https://github.com/1-2-3'>@1-2-3</a></td></tr><tr valign='top'><td class="label">Source</td><td class="data"><a href='https://github.com/zsviczian/obsidian-excalidraw-plugin/blob/master/ea-scripts/Lighten%20background%20color.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">This script lightens the background color of the selected element by 2% at a time. You can use this script several times until you are satisfied. It is recommended to set a shortcut key for this script so that you can quickly try to DARKEN and LIGHTEN the color effect.In contrast to the `Modify background color opacity` script, the advantage is that the background color of the element is not affected by the canvas color, and the color value does not appear in a strange rgba() form.<br><img src='https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/images/darken-lighten-background-color.png'></td></tr></table>
 
+## Mindmap connector
+```excalidraw-script-install
+https://github.com/xllowl/obsidian-excalidraw-plugin/blob/master/ea-scripts/Mindmap%20connector.md
+```
+<table><tr  valign='top'><td class="label">Author</td><td class="data"><a href='https://github.com/xllowl'>@xllowl</a></td></tr><tr valign='top'><td class="label">Source</td><td class="data"><a href='https://github.com/xllowl/obsidian-excalidraw-plugin/blob/master/ea-scripts/Mindmap%20connector.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">This script creates mindmap like lines(only right side available). The line will starts according to the creation time of the elements. So you may need to create the header element first.<br><img src='https://github.com/xllowl/obsidian-excalidraw-plugin/blob/master/images/mindmap%20connector.png'></td></tr></table>
+
 ## Modify background color opacity
 ```excalidraw-script-install
 https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Modify%20background%20color%20opacity.md
@@ -338,4 +345,4 @@ https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea
 ```excalidraw-script-install
 https://raw.githubusercontent.com/zsviczian/obsidian-excalidraw-plugin/master/ea-scripts/Zoom%20to%20Fit%20Selected%20Elements.md
 ```
-<table><tr  valign='top'><td class="label">Author</td><td class="data"><a href='https://github.com/zsviczian'>@zsviczian</a></td></tr><tr valign='top'><td class="label">Source</td><td class="data"><a href='https://github.com/zsviczian/obsidian-excalidraw-plugin/blob/master/ea-scripts/Zoom%20to%20Fit%20Selected%20Elements.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">Similar to Excalidraw standard SHIFT+2 feature: Zoom to fit selected elements, but with the ability to zoom to 1000%. Inspiration: [#272](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/272)</td></tr></table>
+<table><tr  valign='top'><td class="label">Author</td><td class="data"><a href='https://github.com/zsviczian'>@zsviczian</a></td></tr><tr valign='top'><td class="label">Source</td><td class="data"><a href='https://github.com/zsviczian/obsidian-excalidraw-plugin/blob/master/ea-scripts/Zoom%20to%20Fit%20Selected%20Elements.md'>File on GitHub</a></td></tr><tr valign='top'><td class="label">Description</td><td class="data">Similar to Excalidraw standard <kbd>SHIFT+2</kbd> feature: Zoom to fit selected elements, but with the ability to zoom to 1000%. Inspiration: [#272](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/272)</td></tr></table>

manifest.json

@@ -1,8 +1,8 @@
 {
 	"id": "obsidian-excalidraw-plugin",
 	"name": "Excalidraw",
-	"version": "1.7.2",
-	"minAppVersion": "0.15.2",
+	"version": "1.7.18",
+	"minAppVersion": "0.15.6",
 	"description": "An Obsidian plugin to edit and view Excalidraw drawings",
 	"author": "Zsolt Viczian",
 	"authorUrl": "https://zsolt.blog",

package.json

@@ -1,6 +1,6 @@
 {
   "name": "obsidian-excalidraw-plugin",
-  "version": "1.6.33",
+  "version": "1.7.11",
   "description": "This is an Obsidian.md plugin that lets you view and edit Excalidraw drawings",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -18,14 +18,15 @@
   "license": "MIT",
   "dependencies": {
     "@types/lz-string": "^1.3.34",
-    "@zsviczian/excalidraw": "0.11.0-obsidian-21-namedexport",
-    "clsx": "1.1.1",
+    "@zsviczian/excalidraw": "0.12.0-obsidian-8",
+    "clsx": "^1.1.1",
     "lz-string": "^1.4.4",
     "monkey-around": "^2.3.0",
     "react": "^17.0.2",
     "react-dom": "^17.0.2",
-    "react-scripts": "^5.0.0",
-    "roughjs": "^4.5.2"
+    "react-scripts": "^5.0.1",
+    "roughjs": "^4.5.2",
+    "colormaster": "1.2.1"
   },
   "devDependencies": {
     "@babel/core": "^7.16.12",
@@ -33,7 +34,7 @@
     "@babel/preset-react": "^7.16.7",
     "@excalidraw/eslint-config": "1.0.0",
     "@excalidraw/prettier-config": "1.0.2",
-    "@popperjs/core": "^2.11.2",
+    "@popperjs/core": "^2.11.5",
     "@rollup/plugin-babel": "^5.3.0",
     "@rollup/plugin-commonjs": "^21.0.1",
     "@rollup/plugin-node-resolve": "^13.1.3",
@@ -41,14 +42,14 @@
     "@rollup/plugin-typescript": "^8.3.0",
     "@types/js-beautify": "^1.13.3",
     "@types/node": "^15.12.4",
-    "@types/react-dom": "^17.0.11",
+    "@types/react-dom": "^17.0.2",
     "@zerollup/ts-transform-paths": "^1.7.18",
     "cross-env": "^7.0.3",
     "eslint-config-prettier": "8.3.0",
     "eslint-plugin-prettier": "^4.0.0",
     "html2canvas": "^1.4.0",
-    "nanoid": "^3.1.31",
-    "obsidian": "^0.15.1",
+    "nanoid": "^4.0.0",
+    "obsidian": "^0.15.4",
     "prettier": "^2.5.1",
     "rollup": "^2.70.1",
     "rollup-plugin-copy": "^3.4.0",

rollup.config.js

@@ -14,7 +14,6 @@ import LZString from 'lz-string';
 import postprocess from 'rollup-plugin-postprocess';
 
 const isProd = (process.env.NODE_ENV === "production");
-console.log("Is production", isProd);
 
 const excalidraw_pkg = isProd
   ? fs.readFileSync("./node_modules/@zsviczian/excalidraw/dist/excalidraw.production.min.js", "utf8")
@@ -71,15 +70,17 @@ const BUILD_CONFIG = {
     commonjs(),
     nodeResolve({ browser: true, preferBuiltins: false }),
     typescript({inlineSources: !isProd}),
-    ...isProd ? [
+    ...isProd 
+    ? [
       terser({toplevel: false, compress: {passes: 2}}),
-      //!postprocess: 
+      //!postprocess - the version available on npmjs does not work, need this update: 
       //  npm install brettz9/rollup-plugin-postprocess#update --save-dev
       //  https://github.com/developit/rollup-plugin-postprocess/issues/10
       postprocess([
         [/,React=require\("react"\);/, packageString],
       ])
-    ] : [
+    ] 
+    : [
       postprocess([
         [/var React = require\('react'\);/, packageString],
       ])

src/EmbeddedFileLoader.ts

@@ -26,7 +26,7 @@ import {
   getFontDataURL,
   getImageSize,
   getLinkParts,
-  getSVGPadding,
+  getExportPadding,
   getWithBackground,
   hasExportBackground,
   hasExportTheme,
@@ -34,6 +34,8 @@ import {
   svgToBase64,
 } from "./utils/Utils";
 
+const THEME_FILTER = "invert(100%) hue-rotate(180deg) saturate(1.25)";
+
 export declare type MimeType =
   | "image/svg+xml"
   | "image/png"
@@ -90,7 +92,7 @@ export class EmbeddedFile {
     if (!this.linkParts.height) {
       this.linkParts.height = this.plugin.settings.mdSVGmaxHeight;
     }
-    this.file = this.plugin.app.metadataCache.getFirstLinkpathDest(
+    this.file = app.metadataCache.getFirstLinkpathDest(
       this.linkParts.path,
       hostPath,
     );
@@ -106,7 +108,7 @@ export class EmbeddedFile {
 
   private fileChanged(): boolean {
     if (!this.file) {
-      this.file = this.plugin.app.metadataCache.getFirstLinkpathDest(
+      this.file = app.metadataCache.getFirstLinkpathDest(
         this.linkParts.path,
         this.hostPath,
       ); // maybe the file has synchronized in the mean time
@@ -147,7 +149,7 @@ export class EmbeddedFile {
 
   public isLoaded(isDark: boolean): boolean {
     if (!this.file) {
-      this.file = this.plugin.app.metadataCache.getFirstLinkpathDest(
+      this.file = app.metadataCache.getFirstLinkpathDest(
         this.linkParts.path,
         this.hostPath,
       ); // maybe the file has synchronized in the mean time
@@ -216,7 +218,6 @@ export class EmbeddedFilesLoader {
           };
 
     let hasSVGwithBitmap = false;
-    const app = this.plugin.app;
     const isExcalidrawFile = this.plugin.isExcalidrawFile(file);
     if (
       !(
@@ -251,7 +252,7 @@ export class EmbeddedFilesLoader {
         [],
         this.plugin,
         depth+1,
-        getSVGPadding(this.plugin, file),
+        getExportPadding(this.plugin, file),
       );
       //https://stackoverflow.com/questions/51154171/remove-css-filter-on-child-elements
       const imageList = svg.querySelectorAll(
@@ -260,8 +261,7 @@ export class EmbeddedFilesLoader {
       if (imageList.length > 0) {
         hasSVGwithBitmap = true;
       }
-      if (hasSVGwithBitmap && isDark) {
-        const THEME_FILTER = "invert(100%) hue-rotate(180deg) saturate(1.25)";
+      if (hasSVGwithBitmap && isDark) { 
         imageList.forEach((i) => {
           const id = i.parentElement?.id;
           svg.querySelectorAll(`use[href='#${id}']`).forEach((u) => {
@@ -302,17 +302,20 @@ export class EmbeddedFilesLoader {
           mimeType = "application/octet-stream";
       }
     }
-    const dataURL =
+    let dataURL =
       excalidrawSVG ??
       (file.extension === "svg"
         ? await getSVGData(app, file)
         : file.extension === "md"
-        ? await convertMarkdownToSVG(this.plugin, file, linkParts)
+        ? null
         : await getDataURL(ab, mimeType));
-    const size = await getImageSize(
-      excalidrawSVG ??
-        (file.extension === "md" ? dataURL : app.vault.getResourcePath(file)),
-    );
+
+    if(!dataURL) {
+      const result = await this.convertMarkdownToSVG(this.plugin, file, linkParts);
+      dataURL = result.dataURL;
+      hasSVGwithBitmap = result.hasSVGwithBitmap;
+    }
+    const size = await getImageSize(dataURL);
     return {
       mimeType,
       fileId: await generateIdFromFile(ab),
@@ -396,6 +399,224 @@ export class EmbeddedFilesLoader {
       errorlog({ where: "EmbeddedFileLoader.loadSceneFiles", error: e });
     }
   }
+
+  private async convertMarkdownToSVG(
+    plugin: ExcalidrawPlugin,
+    file: TFile,
+    linkParts: LinkParts,
+  ): Promise<{dataURL: DataURL, hasSVGwithBitmap:boolean}> {
+    //1.
+    //get the markdown text
+    let hasSVGwithBitmap = false;
+    const transclusion = await getTransclusion(linkParts, plugin.app, file);
+    let text = (transclusion.leadingHashes??"") + transclusion.contents;
+    if (text === "") {
+      text =
+        "# Empty markdown file\nCTRL+Click here to open the file for editing in the current active pane, or CTRL+SHIFT+Click to open it in an adjacent pane.";
+    }
+  
+    //2.
+    //get styles
+    const fileCache = plugin.app.metadataCache.getFileCache(file);
+    let fontDef: string;
+    let fontName = plugin.settings.mdFont;
+    if (
+      fileCache?.frontmatter &&
+      fileCache.frontmatter[FRONTMATTER_KEY_FONT] != null
+    ) {
+      fontName = fileCache.frontmatter[FRONTMATTER_KEY_FONT];
+    }
+    switch (fontName) {
+      case "Virgil":
+        fontDef = VIRGIL_FONT;
+        break;
+      case "Cascadia":
+        fontDef = CASCADIA_FONT;
+        break;
+      case "":
+        fontDef = "";
+        break;
+      default:
+        const font = await getFontDataURL(plugin.app, fontName, file.path);
+        fontDef = font.fontDef;
+        fontName = font.fontName;
+    }
+  
+    const fontColor = fileCache?.frontmatter
+      ? fileCache.frontmatter[FRONTMATTER_KEY_FONTCOLOR] ??
+        plugin.settings.mdFontColor
+      : plugin.settings.mdFontColor;
+  
+    let style = fileCache?.frontmatter
+      ? fileCache.frontmatter[FRONTMATTER_KEY_MD_STYLE] ?? ""
+      : "";
+    let frontmatterCSSisAfile = false;
+    if (style && style != "") {
+      const f = plugin.app.metadataCache.getFirstLinkpathDest(style, file.path);
+      if (f) {
+        style = await plugin.app.vault.read(f);
+        frontmatterCSSisAfile = true;
+      }
+    }
+    if (!frontmatterCSSisAfile) {
+      if (plugin.settings.mdCSS && plugin.settings.mdCSS !== "") {
+        const f = plugin.app.metadataCache.getFirstLinkpathDest(
+          plugin.settings.mdCSS,
+          file.path,
+        );
+        style += f ? `\n${await plugin.app.vault.read(f)}` : DEFAULT_MD_EMBED_CSS;
+      } else {
+        style += DEFAULT_MD_EMBED_CSS;
+      }
+    }
+  
+    const borderColor = fileCache?.frontmatter
+      ? fileCache.frontmatter[FRONTMATTER_KEY_BORDERCOLOR] ??
+        plugin.settings.mdBorderColor
+      : plugin.settings.mdBorderColor;
+  
+    if (borderColor && borderColor !== "" && !style.match(/svg/i)) {
+      style += `svg{border:2px solid;color:${borderColor};transform:scale(.95)}`;
+    }
+  
+    //3.
+    //SVG helper functions
+    //the SVG will first have ~infinite height. After sizing this will be reduced
+    let svgStyle = ` width="${linkParts.width}px" height="100000"`;
+    let foreignObjectStyle = ` width="${linkParts.width}px" height="100%"`;
+  
+    const svg = (xml: string, xmlFooter: string, style?: string) =>
+      `<svg xmlns="http://www.w3.org/2000/svg"${svgStyle}>${
+        style ? `<style>${style}</style>` : ""
+      }<foreignObject x="0" y="0"${foreignObjectStyle}>${xml}${
+        xmlFooter //https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/286#issuecomment-982179639
+      }</foreignObject>${
+        fontDef !== "" ? `<defs><style>${fontDef}</style></defs>` : ""
+      }</svg>`;
+  
+    //4.
+    //create document div - this will be the contents of the foreign object
+    const mdDIV = createDiv();
+    mdDIV.setAttribute("xmlns", "http://www.w3.org/1999/xhtml");
+    mdDIV.setAttribute("class", "excalidraw-md-host");
+    //  mdDIV.setAttribute("style",style);
+    if (fontName !== "") {
+      mdDIV.style.fontFamily = fontName;
+    }
+    mdDIV.style.overflow = "auto";
+    mdDIV.style.display = "block";
+    mdDIV.style.color = fontColor && fontColor !== "" ? fontColor : "initial";
+  
+    await MarkdownRenderer.renderMarkdown(text, mdDIV, file.path, plugin);
+  
+    mdDIV
+      .querySelectorAll(":scope > *[class^='frontmatter']")
+      .forEach((el) => mdDIV.removeChild(el));
+  
+    const internalEmbeds = Array.from(mdDIV.querySelectorAll("span[class='internal-embed']"))
+    for(let i=0;i<internalEmbeds.length;i++) {
+      const el = internalEmbeds[i];
+      const src = el.getAttribute("src");
+      if(!src) continue;
+      const width = el.getAttribute("width");
+      const height = el.getAttribute("height");
+      const ef = new EmbeddedFile(plugin,file.path,src);
+      //const f = app.metadataCache.getFirstLinkpathDest(src.split("#")[0],file.path);
+      if(!ef.file) continue;
+      const embeddedFile = await this.getObsidianImage(ef,1);
+      const img = createEl("img");
+      if(width) img.setAttribute("width", width);
+      if(height) img.setAttribute("height", height);
+      img.src = embeddedFile.dataURL;
+      el.replaceWith(img);  
+    }
+  
+    //5.1
+    //get SVG size.
+    //First I need to create a fully self contained copy of the document to convert
+    //blank styles into inline styles using computedStyle
+    const iframeHost = document.body.createDiv();
+    iframeHost.style.display = "none";
+    const iframe = iframeHost.createEl("iframe");
+    const iframeDoc = iframe.contentWindow.document;
+    if (style) {
+      const styleEl = iframeDoc.createElement("style");
+      styleEl.type = "text/css";
+      styleEl.innerHTML = style;
+      iframeDoc.head.appendChild(styleEl);
+    }
+    const stylingDIV = iframeDoc.importNode(mdDIV, true);
+    iframeDoc.body.appendChild(stylingDIV);
+    const footerDIV = createDiv();
+    footerDIV.setAttribute("class", "excalidraw-md-footer");
+    iframeDoc.body.appendChild(footerDIV);
+  
+    iframeDoc.body.querySelectorAll("*").forEach((el: HTMLElement) => {
+      const elementStyle = el.style;
+      const computedStyle = window.getComputedStyle(el);
+      let style = "";
+      for (const prop in elementStyle) {
+        if (elementStyle.hasOwnProperty(prop)) {
+          style += `${prop}: ${computedStyle[prop]};`;
+        }
+      }
+      el.setAttribute("style", style);
+    });
+  
+    const xmlINiframe = new XMLSerializer().serializeToString(stylingDIV);
+    const xmlFooter = new XMLSerializer().serializeToString(footerDIV);
+    document.body.removeChild(iframeHost);
+  
+    //5.2
+    //get SVG size
+    const parser = new DOMParser();
+    const doc = parser.parseFromString(
+      svg(xmlINiframe, xmlFooter),
+      "image/svg+xml",
+    );
+    const svgEl = doc.firstElementChild;
+    const host = createDiv();
+    host.appendChild(svgEl);
+    document.body.appendChild(host);
+    const footerHeight = svgEl.querySelector(
+      ".excalidraw-md-footer",
+    ).scrollHeight;
+    const height =
+      svgEl.querySelector(".excalidraw-md-host").scrollHeight + footerHeight;
+    const svgHeight = height <= linkParts.height ? height : linkParts.height;
+    document.body.removeChild(host);
+  
+    //finalize SVG
+    svgStyle = ` width="${linkParts.width}px" height="${svgHeight}px"`;
+    foreignObjectStyle = ` width="${linkParts.width}px" height="${svgHeight}px"`;
+    mdDIV.style.height = `${svgHeight - footerHeight}px`;
+    mdDIV.style.overflow = "hidden";
+
+    const imageList = mdDIV.querySelectorAll(
+      "img:not([src^='data:image/svg+xml'])",
+    );
+    if (imageList.length > 0) {
+      hasSVGwithBitmap = true;
+    }
+    if (hasSVGwithBitmap && this.isDark) { 
+      imageList.forEach(img => {
+        if(img instanceof HTMLImageElement) {
+          img.style.filter = THEME_FILTER;
+        }
+      });
+    }
+
+    const xml = new XMLSerializer().serializeToString(mdDIV);
+    const finalSVG = svg(xml, '<div class="excalidraw-md-footer"></div>', style);
+    plugin.ea.mostRecentMarkdownSVG = parser.parseFromString(
+      finalSVG,
+      "image/svg+xml",
+    ).firstElementChild as SVGSVGElement;
+    return {
+      dataURL: svgToBase64(finalSVG) as DataURL,
+      hasSVGwithBitmap
+    };
+  };
 }
 
 const getSVGData = async (app: App, file: TFile): Promise<DataURL> => {
@@ -403,186 +624,6 @@ const getSVGData = async (app: App, file: TFile): Promise<DataURL> => {
   return svgToBase64(svg) as DataURL;
 };
 
-const convertMarkdownToSVG = async (
-  plugin: ExcalidrawPlugin,
-  file: TFile,
-  linkParts: LinkParts,
-): Promise<DataURL> => {
-  //1.
-  //get the markdown text
-  const transclusion = await getTransclusion(linkParts, plugin.app, file);
-  let text = (transclusion.leadingHashes??"") + transclusion.contents;
-  if (text === "") {
-    text =
-      "# Empty markdown file\nCTRL+Click here to open the file for editing in the current active pane, or CTRL+SHIFT+Click to open it in an adjacent pane.";
-  }
-
-  //2.
-  //get styles
-  const fileCache = plugin.app.metadataCache.getFileCache(file);
-  let fontDef: string;
-  let fontName = plugin.settings.mdFont;
-  if (
-    fileCache?.frontmatter &&
-    fileCache.frontmatter[FRONTMATTER_KEY_FONT] != null
-  ) {
-    fontName = fileCache.frontmatter[FRONTMATTER_KEY_FONT];
-  }
-  switch (fontName) {
-    case "Virgil":
-      fontDef = VIRGIL_FONT;
-      break;
-    case "Cascadia":
-      fontDef = CASCADIA_FONT;
-      break;
-    case "":
-      fontDef = "";
-      break;
-    default:
-      const font = await getFontDataURL(plugin.app, fontName, file.path);
-      fontDef = font.fontDef;
-      fontName = font.fontName;
-  }
-
-  const fontColor = fileCache?.frontmatter
-    ? fileCache.frontmatter[FRONTMATTER_KEY_FONTCOLOR] ??
-      plugin.settings.mdFontColor
-    : plugin.settings.mdFontColor;
-
-  let style = fileCache?.frontmatter
-    ? fileCache.frontmatter[FRONTMATTER_KEY_MD_STYLE] ?? ""
-    : "";
-  let frontmatterCSSisAfile = false;
-  if (style && style != "") {
-    const f = plugin.app.metadataCache.getFirstLinkpathDest(style, file.path);
-    if (f) {
-      style = await plugin.app.vault.read(f);
-      frontmatterCSSisAfile = true;
-    }
-  }
-  if (!frontmatterCSSisAfile) {
-    if (plugin.settings.mdCSS && plugin.settings.mdCSS !== "") {
-      const f = plugin.app.metadataCache.getFirstLinkpathDest(
-        plugin.settings.mdCSS,
-        file.path,
-      );
-      style += f ? `\n${await plugin.app.vault.read(f)}` : DEFAULT_MD_EMBED_CSS;
-    } else {
-      style += DEFAULT_MD_EMBED_CSS;
-    }
-  }
-
-  const borderColor = fileCache?.frontmatter
-    ? fileCache.frontmatter[FRONTMATTER_KEY_BORDERCOLOR] ??
-      plugin.settings.mdBorderColor
-    : plugin.settings.mdBorderColor;
-
-  if (borderColor && borderColor !== "" && !style.match(/svg/i)) {
-    style += `svg{border:2px solid;color:${borderColor};transform:scale(.95)}`;
-  }
-
-  //3.
-  //SVG helper functions
-  //the SVG will first have ~infinite height. After sizing this will be reduced
-  let svgStyle = ` width="${linkParts.width}px" height="100000"`;
-  let foreignObjectStyle = ` width="${linkParts.width}px" height="100%"`;
-
-  const svg = (xml: string, xmlFooter: string, style?: string) =>
-    `<svg xmlns="http://www.w3.org/2000/svg"${svgStyle}>${
-      style ? `<style>${style}</style>` : ""
-    }<foreignObject x="0" y="0"${foreignObjectStyle}>${xml}${
-      xmlFooter //https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/286#issuecomment-982179639
-    }</foreignObject>${
-      fontDef !== "" ? `<defs><style>${fontDef}</style></defs>` : ""
-    }</svg>`;
-
-  //4.
-  //create document div - this will be the contents of the foreign object
-  const mdDIV = createDiv();
-  mdDIV.setAttribute("xmlns", "http://www.w3.org/1999/xhtml");
-  mdDIV.setAttribute("class", "excalidraw-md-host");
-  //  mdDIV.setAttribute("style",style);
-  if (fontName !== "") {
-    mdDIV.style.fontFamily = fontName;
-  }
-  mdDIV.style.overflow = "auto";
-  mdDIV.style.display = "block";
-  mdDIV.style.color = fontColor && fontColor !== "" ? fontColor : "initial";
-
-  await MarkdownRenderer.renderMarkdown(text, mdDIV, file.path, plugin);
-  mdDIV
-    .querySelectorAll(":scope > *[class^='frontmatter']")
-    .forEach((el) => mdDIV.removeChild(el));
-
-  //5.1
-  //get SVG size.
-  //First I need to create a fully self contained copy of the document to convert
-  //blank styles into inline styles using computedStyle
-  const iframeHost = document.body.createDiv();
-  iframeHost.style.display = "none";
-  const iframe = iframeHost.createEl("iframe");
-  const iframeDoc = iframe.contentWindow.document;
-  if (style) {
-    const styleEl = iframeDoc.createElement("style");
-    styleEl.type = "text/css";
-    styleEl.innerHTML = style;
-    iframeDoc.head.appendChild(styleEl);
-  }
-  const stylingDIV = iframeDoc.importNode(mdDIV, true);
-  iframeDoc.body.appendChild(stylingDIV);
-  const footerDIV = createDiv();
-  footerDIV.setAttribute("class", "excalidraw-md-footer");
-  iframeDoc.body.appendChild(footerDIV);
-
-  iframeDoc.body.querySelectorAll("*").forEach((el: HTMLElement) => {
-    const elementStyle = el.style;
-    const computedStyle = window.getComputedStyle(el);
-    let style = "";
-    for (const prop in elementStyle) {
-      if (elementStyle.hasOwnProperty(prop)) {
-        style += `${prop}: ${computedStyle[prop]};`;
-      }
-    }
-    el.setAttribute("style", style);
-  });
-
-  const xmlINiframe = new XMLSerializer().serializeToString(stylingDIV);
-  const xmlFooter = new XMLSerializer().serializeToString(footerDIV);
-  document.body.removeChild(iframeHost);
-
-  //5.2
-  //get SVG size
-  const parser = new DOMParser();
-  const doc = parser.parseFromString(
-    svg(xmlINiframe, xmlFooter),
-    "image/svg+xml",
-  );
-  const svgEl = doc.firstElementChild;
-  const host = createDiv();
-  host.appendChild(svgEl);
-  document.body.appendChild(host);
-  const footerHeight = svgEl.querySelector(
-    ".excalidraw-md-footer",
-  ).scrollHeight;
-  const height =
-    svgEl.querySelector(".excalidraw-md-host").scrollHeight + footerHeight;
-  const svgHeight = height <= linkParts.height ? height : linkParts.height;
-  document.body.removeChild(host);
-
-  //finalize SVG
-  svgStyle = ` width="${linkParts.width}px" height="${svgHeight}px"`;
-  foreignObjectStyle = ` width="${linkParts.width}px" height="${svgHeight}px"`;
-  mdDIV.style.height = `${svgHeight - footerHeight}px`;
-  mdDIV.style.overflow = "hidden";
-  const xml = new XMLSerializer().serializeToString(mdDIV);
-  const finalSVG = svg(xml, '<div class="excalidraw-md-footer"></div>', style);
-  plugin.ea.mostRecentMarkdownSVG = parser.parseFromString(
-    finalSVG,
-    "image/svg+xml",
-  ).firstElementChild as SVGSVGElement;
-  return svgToBase64(finalSVG) as DataURL;
-};
-
 const generateIdFromFile = async (file: ArrayBuffer): Promise<FileId> => {
   let id: FileId;
   try {

src/ExcalidrawData.ts

@@ -16,6 +16,7 @@ import {
   REG_BLOCK_REF_CLEAN,
   FRONTMATTER_KEY_LINKBUTTON_OPACITY,
   FRONTMATTER_KEY_ONLOAD_SCRIPT,
+  FRONTMATTER_KEY_AUTOEXPORT,
 } from "./Constants";
 import { _measureText } from "./ExcalidrawAutomate";
 import ExcalidrawPlugin from "./main";
@@ -51,6 +52,14 @@ declare module "obsidian" {
   }
 }
 
+export enum AutoexportPreference {
+  none,
+  both,
+  png,
+  svg,
+  inherit
+}
+
 export const REGEX_LINK = {
   //![[link|alias]] [alias](link){num}
   //      1   2    3           4             5         67         8  9
@@ -224,6 +233,7 @@ export class ExcalidrawData {
   private showLinkBrackets: boolean;
   private linkPrefix: string;
   private urlPrefix: string;
+  public autoexportPreference: AutoexportPreference = AutoexportPreference.inherit;
   private textMode: TextMode = TextMode.raw;
   public loaded: boolean = false;
   private files: Map<FileId, EmbeddedFile> = null; //fileId, path
@@ -401,6 +411,7 @@ export class ExcalidrawData {
     this.setShowLinkBrackets();
     this.setLinkPrefix();
     this.setUrlPrefix();
+    this.setAutoexportPreferences();
 
     this.scene = null;
 
@@ -577,6 +588,7 @@ export class ExcalidrawData {
   }
 
   public async setTextMode(textMode: TextMode, forceupdate: boolean = false) {
+    if(!this.scene) return;
     this.textMode = textMode;
     await this.updateSceneTextElements(forceupdate);
   }
@@ -728,7 +740,13 @@ export class ExcalidrawData {
           this.textElements.set(id, { raw, parsed: null, wrapAt });
           this.parseasync(id, raw, wrapAt);
         }
+      } else if (!this.textElements.has(te.id)) {
+        const raw = te.rawText && te.rawText !== "" ? te.rawText : te.text; //this is for compatibility with drawings created before the rawText change on ExcalidrawTextElement
+        const wrapAt = estimateMaxLineLen(te.text, te.originalText);
+        this.textElements.set(id, { raw, parsed: null, wrapAt });
+        this.parseasync(id, raw, wrapAt);
       }
+      
     }
     if (dirty) {
       //reload scene json in case it has changed
@@ -770,11 +788,14 @@ export class ExcalidrawData {
         this.textElements.delete(key); //if no longer in the scene, delete the text element
       } else {
         const text = await this.getText(key, false);
+        const raw = this.scene.prevTextMode === TextMode.parsed
+          ? el[0].rawText
+          : (el[0].originalText ?? el[0].text);
         if (text !== (el[0].originalText ?? el[0].text)) {
           const wrapAt = estimateMaxLineLen(el[0].text, el[0].originalText);
           this.textElements.set(key, {
-            raw: el[0].originalText ?? el[0].text,
-            parsed: (await this.parse(el[0].originalText ?? el[0].text)).parsed,
+            raw,
+            parsed: (await this.parse(raw)).parsed,
             wrapAt,
           });
         }
@@ -1039,10 +1060,12 @@ export class ExcalidrawData {
     const processedIds = new Set<string>();
     fileIds.forEach(fileId=>{
       if(processedIds.has(fileId)) {
-        const file = this.files.get(fileId as FileId);
-        const equation = this.equations.get(fileId as FileId);
+        const file = this.getFile(fileId);
+        //const file = this.files.get(fileId as FileId);
+        const equation = this.getEquation(fileId);
+        //const equation = this.equations.get(fileId as FileId);
         //images should have a single reference, but equations and markdown embeds should have as many as instances of the file in the scene
-        if(file && file.file.extension !== "md") {
+        if(file && (file.file.extension !== "md" || this.plugin.isExcalidrawFile(file.file))) {
           return;
         }
         const newId = fileid();
@@ -1051,10 +1074,12 @@ export class ExcalidrawData {
         dirty = true;
         processedIds.add(newId);
         if(file) {
-           this.files.set(newId as FileId,new EmbeddedFile(this.plugin,this.file.path,file.linkParts.original))
+          this.setFile(newId as FileId,new EmbeddedFile(this.plugin,this.file.path,file.linkParts.original));
+           //this.files.set(newId as FileId,new EmbeddedFile(this.plugin,this.file.path,file.linkParts.original))
         }
         if(equation) {
-          this.equations.set(newId as FileId, equation);
+          this.setEquation(newId as FileId, {latex:equation.latex, isLoaded:false});
+          //this.equations.set(newId as FileId, equation);
         }
       }
       processedIds.add(fileId);
@@ -1316,6 +1341,24 @@ export class ExcalidrawData {
     return urlPrefix != this.urlPrefix;
   }
 
+  private setAutoexportPreferences() {
+    const fileCache = this.app.metadataCache.getFileCache(this.file);
+    if (
+      fileCache?.frontmatter &&
+      fileCache.frontmatter[FRONTMATTER_KEY_AUTOEXPORT] != null
+    ) {
+      switch ((fileCache.frontmatter[FRONTMATTER_KEY_AUTOEXPORT]).toLowerCase()) {
+        case "none": this.autoexportPreference = AutoexportPreference.none; break;
+        case "both": this.autoexportPreference = AutoexportPreference.both; break;
+        case "png": this.autoexportPreference = AutoexportPreference.png; break;
+        case "svg": this.autoexportPreference = AutoexportPreference.svg; break;
+        default: this.autoexportPreference = AutoexportPreference.inherit;
+      };
+    } else {
+      this.autoexportPreference = AutoexportPreference.inherit;
+    }
+  }
+
   private setShowLinkBrackets(): boolean {
     const showLinkBrackets = this.showLinkBrackets;
     const fileCache = this.app.metadataCache.getFileCache(this.file);
@@ -1350,8 +1393,13 @@ export class ExcalidrawData {
     if (!data.file) {
       return;
     }
+
+    const parts = data.linkParts.original.split("#");
     this.plugin.filesMaster.set(fileId, {
-      path: data.file.path,
+      path:data.file.path,
+      blockrefData: parts.length === 1
+        ? null
+        : parts[1],
       hasSVGwithBitmap: data.isSVGwithBitmap,
     });
   }
@@ -1361,7 +1409,19 @@ export class ExcalidrawData {
   }
 
   public getFile(fileId: FileId): EmbeddedFile {
-    return this.files.get(fileId);
+    let embeddedFile = this.files.get(fileId);
+    if(embeddedFile) return embeddedFile;
+    const masterFile = this.plugin.filesMaster.get(fileId);
+    if(!masterFile) return embeddedFile;
+    embeddedFile = new EmbeddedFile(
+      this.plugin,
+      this.file.path,
+      masterFile.blockrefData
+        ? masterFile.path + "#" + masterFile.blockrefData
+        : masterFile.path
+    );
+    this.files.set(fileId,embeddedFile);
+    return embeddedFile;
   }
 
   public getFileEntries() {
@@ -1380,15 +1440,17 @@ export class ExcalidrawData {
       return true;
     }
     if (this.plugin.filesMaster.has(fileId)) {
-      const fileMaster = this.plugin.filesMaster.get(fileId);
-      if (!this.app.vault.getAbstractFileByPath(fileMaster.path)) {
+      const masterFile = this.plugin.filesMaster.get(fileId);
+      if (!this.app.vault.getAbstractFileByPath(masterFile.path)) {
         this.plugin.filesMaster.delete(fileId);
         return true;
       } // the file no longer exists
       const embeddedFile = new EmbeddedFile(
         this.plugin,
         this.file.path,
-        fileMaster.path,
+        masterFile.blockrefData
+          ? masterFile.path + "#" + masterFile.blockrefData
+          : masterFile.path
       );
       this.files.set(fileId, embeddedFile);
       return true;
@@ -1405,7 +1467,12 @@ export class ExcalidrawData {
   }
 
   public getEquation(fileId: FileId): { latex: string; isLoaded: boolean } {
-    return this.equations.get(fileId);
+    let result = this.equations.get(fileId);
+    if(result) return result;
+    const latex = this.plugin.equationsMaster.get(fileId);
+    if(!latex) return result;
+    this.equations.set(fileId, {latex, isLoaded: false});
+    return {latex, isLoaded: false};
   }
 
   public getEquationEntries() {
@@ -1504,7 +1571,7 @@ export const getTransclusion = async (
           lineNum
         };    
       }
-      endPos = headings[i].node.position.start.offset - 1;
+      endPos = headings[j].node.position.start.offset - 1;
       return {
         leadingHashes: "#".repeat(depth)+" ",
         contents: contents.substring(startPos, endPos).trim(),
@@ -1514,6 +1581,7 @@ export const getTransclusion = async (
     const c = headings[i].node.children[0];
     const dataHeading = headings[i].node.data?.hProperties?.dataHeading;
     const cc = c?.children;
+    //const refNoSpace = linkParts.ref.replaceAll(" ","");
     if (
       !startPos &&
       (c?.value?.replaceAll(REG_BLOCK_REF_CLEAN, "") === linkParts.ref ||

src/MarkdownPostProcessor.ts

@@ -12,15 +12,15 @@ import ExcalidrawPlugin from "./main";
 import {getIMGFilename,} from "./utils/FileUtils";
 import {
   embedFontsInSVG,
+  getEmbeddedFilenameParts,
   getExportTheme,
   getQuickImagePreview,
-  getSVGPadding,
+  getExportPadding,
   getWithBackground,
   hasExportTheme,
   svgToBase64,
 } from "./utils/Utils";
 import { isObsidianThemeDark } from "./utils/ObsidianUtils";
-import { splitFolderAndFilename } from "./utils/FileUtils";
 
 interface imgElementAttributes {
   file?: TFile;
@@ -58,13 +58,15 @@ const getIMG = async (
 ): Promise<HTMLElement> => {
   let file = imgAttributes.file;
   if (!imgAttributes.file) {
-    const f = vault.getAbstractFileByPath(imgAttributes.fname);
+    const f = vault.getAbstractFileByPath(imgAttributes.fname?.split("#")[0]);
     if (!(f && f instanceof TFile)) {
       return null;
     }
     file = f;
   }
 
+  const filenameParts = getEmbeddedFilenameParts(imgAttributes.fname);
+
   // https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/387
   imgAttributes.style = imgAttributes.style.replaceAll(" ", "-");
 
@@ -103,24 +105,28 @@ const getIMG = async (
 
   if (!plugin.settings.displaySVGInPreview) {
     const width = parseInt(imgAttributes.fwidth);
-    let scale = 1;
-    if (width >= 600) {
-      scale = 2;
-    }
-    if (width >= 1200) {
-      scale = 3;
-    }
-    if (width >= 1800) {
-      scale = 4;
-    }
-    if (width >= 2400) {
-      scale = 5;
-    }
+    const scale = width >= 2400
+      ? 5
+      : width >= 1800
+        ? 4
+        : width >= 1200
+          ? 3
+          : width >= 600
+            ? 2
+            : 1;
+
+    //In case of PNG I cannot change the viewBox to select the area of the element
+    //being referenced. For PNG only the group reference works
+    const quickPNG = !filenameParts.hasGroupref
+      ? await getQuickImagePreview(plugin, file.path, "png")
+      : undefined;
 
     const png =
-      (await getQuickImagePreview(plugin, file.path, "png")) ??
+      quickPNG ??
       (await createPNG(
-        file.path,
+        filenameParts.hasGroupref
+          ? filenameParts.filepath + filenameParts.linkpartReference
+          : file.path,
         scale,
         exportSettings,
         loader,
@@ -137,14 +143,19 @@ const getIMG = async (
     img.src = URL.createObjectURL(png);
     return img;
   }
-  const quickSVG = await getQuickImagePreview(plugin, file.path, "svg");
-  if (quickSVG) {
-    img.setAttribute("src", svgToBase64(quickSVG));
-    return img;
+
+  if(!(filenameParts.hasBlockref || filenameParts.hasSectionref)) {
+    const quickSVG = await getQuickImagePreview(plugin, file.path, "svg");
+    if (quickSVG) {
+      img.setAttribute("src", svgToBase64(quickSVG));
+      return img;
+    }
   }
   const svgSnapshot = (
     await createSVG(
-      file.path,
+      filenameParts.hasGroupref || filenameParts.hasBlockref || filenameParts.hasSectionref
+        ? filenameParts.filepath + filenameParts.linkpartReference
+        : file.path,
       true,
       exportSettings,
       loader,
@@ -154,7 +165,7 @@ const getIMG = async (
       [],
       plugin,
       0,
-      getSVGPadding(plugin, file),
+      getExportPadding(plugin, file),
     )
   ).outerHTML;
   let svg: SVGSVGElement = null;
@@ -180,7 +191,7 @@ const createImageDiv = async (
   const img = await getIMG(attr);
   return createDiv(attr.style, (el) => {
     el.append(img);
-    el.setAttribute("src", attr.file.path);
+    el.setAttribute("src", attr.fname);
     if (attr.fwidth) {
       el.setAttribute("w", attr.fwidth);
     }
@@ -196,9 +207,17 @@ const createImageDiv = async (
       }
       const src = el.getAttribute("src");
       if (src) {
+        const srcParts = src.match(/([^#]*)(.*)/);
+        if(!srcParts) return;
         plugin.openDrawing(
-          vault.getAbstractFileByPath(src) as TFile,
-          ev[CTRL_OR_CMD]?"new-pane":"active-pane",
+          vault.getAbstractFileByPath(srcParts[1]) as TFile,
+          ev[CTRL_OR_CMD]
+            ? "new-pane"
+            : (ev.metaKey && !app.isMobile)
+              ? "popout-window"
+              : "active-pane",
+          true,
+          srcParts[2],
         );
       } //.ctrlKey||ev.metaKey);
     });
@@ -216,106 +235,108 @@ const createImageDiv = async (
   });
 };
 
-const processInternalEmbeds = async (
+const processReadingMode = async (
   embeddedItems: NodeListOf<Element> | [HTMLElement],
   ctx: MarkdownPostProcessorContext,
 ) => {
-  //if not, then we are processing a non-excalidraw file in reading mode
-  //in that cases embedded files will be displayed in an .internal-embed container
+  //We are processing a non-excalidraw file in reading mode
+  //Embedded files will be displayed in an .internal-embed container
+
+  //Iterating all the containers in the file to check which one is an excalidraw drawing
+  //This is a for loop instead of embeddedItems.forEach() because processInternalEmbed at the end
+  //is awaited, otherwise excalidraw images would not display in the Kanban plugin
+  for (const maybeDrawing of embeddedItems) {
+    //check to see if the file in the src attribute exists
+    const fname = maybeDrawing.getAttribute("src")?.split("#")[0];
+    if(!fname) continue;
+
+    const file = metadataCache.getFirstLinkpathDest(fname, ctx.sourcePath);
+
+    //if the embeddedFile exits and it is an Excalidraw file
+    //then lets replace the .internal-embed with the generated PNG or SVG image
+    if (file && file instanceof TFile && plugin.isExcalidrawFile(file)) {
+      if(isTextOnlyEmbed(maybeDrawing)) {
+        //legacy reference to a block or section as text
+        //should be embedded as legacy text
+        continue;
+      }
+  
+      maybeDrawing.parentElement.replaceChild(
+        await processInternalEmbed(maybeDrawing,file),
+        maybeDrawing
+      );
+    }
+  }
+};
+
+const processInternalEmbed = async (internalEmbedEl: Element, file: TFile ):Promise<HTMLDivElement> => {
   const attr: imgElementAttributes = {
     fname: "",
     fheight: "",
     fwidth: "",
     style: "",
   };
-  let alt: string;
-  let parts;
-  let file: TFile;
 
-  //Iterating through all the containers to check which one is an excalidraw drawing
-  //This is a for loop instead of embeddedItems.forEach() because createImageDiv at the end
-  //is awaited, otherwise excalidraw images would not display in the Kanban plugin
-  for (const maybeDrawing of embeddedItems) {
-    //check to see if the file in the src attribute exists
-    attr.fname = maybeDrawing.getAttribute("src");
-    file = metadataCache.getFirstLinkpathDest(
-      attr.fname?.split("#")[0],
-      ctx.sourcePath,
-    );
+  const src = internalEmbedEl.getAttribute("src");
+  if(!src) return;
+  attr.fwidth = internalEmbedEl.getAttribute("width")
+  ? internalEmbedEl.getAttribute("width")
+  : getDefaultWidth(plugin);
+  attr.fheight = internalEmbedEl.getAttribute("height");
+  let alt = internalEmbedEl.getAttribute("alt");
+  attr.style = "excalidraw-svg";
+  processAltText(src.split("#")[0],alt,attr);
+  const fnameParts = getEmbeddedFilenameParts(src);
+  attr.fname = file?.path + (fnameParts.hasBlockref||fnameParts.hasSectionref?fnameParts.linkpartReference:"");
+  attr.file = file;
+  return await createImageDiv(attr);
+}
 
-    //if the embeddedFile exits and it is an Excalidraw file
-    //then lets replace the .internal-embed with the generated PNG or SVG image
-    if (file && file instanceof TFile && plugin.isExcalidrawFile(file)) {
-      attr.fwidth = maybeDrawing.getAttribute("width")
-        ? maybeDrawing.getAttribute("width")
-        : getDefaultWidth(plugin);
-      attr.fheight = maybeDrawing.getAttribute("height");
-      alt = maybeDrawing.getAttribute("alt");
-      if (alt == attr.fname) {
-        alt = "";
-      } //when the filename starts with numbers followed by a space Obsidian recognizes the filename as alt-text
-      attr.style = "excalidraw-svg";
-      if (alt) {
-        //for some reason Obsidian renders ![]() in a DIV and ![[]] in a SPAN
-        //also the alt-text of the DIV does not include the alt-text of the image
-        //thus need to add an additional "|" character when its a SPAN
-        if (maybeDrawing.tagName.toLowerCase() == "span") {
-          alt = `|${alt}`;
-        }
-        //1:width, 2:height, 3:style  1      2      3
-        parts = alt.match(/[^\|]*\|?(\d*%?)x?(\d*%?)\|?(.*)/);
-        attr.fwidth = parts[1] ? parts[1] : getDefaultWidth(plugin);
-        attr.fheight = parts[2];
-        if (parts[3] != attr.fname) {
-          attr.style = `excalidraw-svg${parts[3] ? `-${parts[3]}` : ""}`;
-        }
-      }
-      attr.fname = file?.path;
-      attr.file = file;
-      const div = await createImageDiv(attr);
-      maybeDrawing.parentElement.replaceChild(div, maybeDrawing);
+const processAltText = (
+  fname: string,
+  alt:string,
+  attr: imgElementAttributes
+) => {
+  if (alt && !alt.startsWith(fname)) {
+    //2:width, 3:height, 4:style  12        3           4
+    const parts = alt.match(/[^\|\d]*\|?((\d*%?)x?(\d*%?))?\|?(.*)/);
+    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]}`}`;
+    }
+    if (
+      (!parts[4] || parts[4]==="") &&
+      (!parts[2] || parts[2]==="") &&
+      parts[0] && parts[0] !== ""
+    ) {
+      attr.style = `excalidraw-svg${`-${parts[0]}`}`;
     }
   }
-};
+}
+
+const isTextOnlyEmbed = (internalEmbedEl: Element):boolean => {
+  const src = internalEmbedEl.getAttribute("src");
+  if(!src) return true; //technically this does not mean this is a text only embed, but still should abort further processing
+  const fnameParts = getEmbeddedFilenameParts(src);
+  return !(fnameParts.hasArearef || fnameParts.hasGroupref) &&
+    (fnameParts.hasBlockref || fnameParts.hasSectionref)
+}
 
 const tmpObsidianWYSIWYG = async (
   el: HTMLElement,
   ctx: MarkdownPostProcessorContext,
 ) => {
-  if (!ctx.frontmatter) {
-    return;
-  }
-  if (!ctx.frontmatter.hasOwnProperty("excalidraw-plugin")) {
-    return;
-  }
+  const file = app.vault.getAbstractFileByPath(ctx.sourcePath);
+  if(!(file instanceof TFile)) return;
+  if(!plugin.isExcalidrawFile(file)) return;
+
   //@ts-ignore
   if (ctx.remainingNestLevel < 4) {
     return;
   }
-  if (!el.querySelector(".frontmatter")) {
-    el.style.display = "none";
-    return;
-  }
-  const attr: imgElementAttributes = {
-    fname: ctx.sourcePath,
-    fheight: "",
-    fwidth: getDefaultWidth(plugin),
-    style: "excalidraw-svg",
-  };
 
-  attr.file = metadataCache.getFirstLinkpathDest(ctx.sourcePath, "");
-
-  el.empty();
-
-  if (!plugin.settings.experimentalLivePreview) {
-    el.appendChild(await createImageDiv(attr));
-    return;
-  }
-
-  const div = createDiv();
-  el.appendChild(div);
-
-  //The timeout gives time for obsidian to attach el to the displayed document
+  //The timeout gives time for Obsidian to attach el to the displayed document
   //Once the element is attached, I can traverse up the dom tree to find .internal-embed
   //If internal embed is not found, it means the that the excalidraw.md file
   //is being rendered in "reading" mode. In that case, the image with the default width
@@ -323,7 +344,12 @@ const tmpObsidianWYSIWYG = async (
   //if .internal-embed is found, then contents is replaced with the image using the
   //alt, width, and height attributes of .internal-embed to size and style the image
   setTimeout(async () => {
-    let internalEmbedDiv: HTMLElement = div;
+    //wait for el to be attached to the displayed document
+    let counter = 0;
+    while(!el.parentElement && counter++<=50) await sleep(50);
+    if(!el.parentElement) return;
+
+    let internalEmbedDiv: HTMLElement = el;
     while (
       !internalEmbedDiv.hasClass("internal-embed") &&
       internalEmbedDiv.parentElement
@@ -331,52 +357,49 @@ const tmpObsidianWYSIWYG = async (
       internalEmbedDiv = internalEmbedDiv.parentElement;
     }
 
+    const attr: imgElementAttributes = {
+      fname: ctx.sourcePath,
+      fheight: "",
+      fwidth: getDefaultWidth(plugin),
+      style: "excalidraw-svg",
+    };
+    
+    attr.file = file;
+
     if (!internalEmbedDiv.hasClass("internal-embed")) {
+      //We are processing the markdown preview of an actual Excalidraw file
+      //This could be in a hover preview of the file
+      //Or the file could be in markdown mode and the user switched markdown
+      //view of the drawing to reading mode
       el.empty();
-      el.appendChild(await createImageDiv(attr));
+      const mdPreviewSection = el.parentElement;
+      if(!mdPreviewSection.hasClass("markdown-preview-section")) return;
+      if(mdPreviewSection.hasAttribute("ready")) {
+        mdPreviewSection.removeChild(el);
+        return;
+      }
+      mdPreviewSection.setAttribute("ready","");
+      const imgDiv = await createImageDiv(attr);
+      el.appendChild(imgDiv);
       return;
     }
 
+    if(isTextOnlyEmbed(internalEmbedDiv)) {
+      //legacy reference to a block or section as text
+      //should be embedded as legacy text
+      return;
+    }
+
+    el.empty();
+
+    if(internalEmbedDiv.hasAttribute("ready")) {  
+      return;
+    }
+    internalEmbedDiv.setAttribute("ready","");
+
     internalEmbedDiv.empty();
-
-    const basename = splitFolderAndFilename(attr.fname).basename;
-    const setAttr = () => {
-      const hasWidth = internalEmbedDiv.getAttribute("width") && (internalEmbedDiv.getAttribute("width") !== "");
-      const hasHeight = internalEmbedDiv.getAttribute("height") && (internalEmbedDiv.getAttribute("height") !== "");
-      if (hasWidth) {
-        attr.fwidth = internalEmbedDiv.getAttribute("width");
-      }
-      if (hasHeight) {
-        attr.fheight = internalEmbedDiv.getAttribute("height");
-      }
-      const alt = internalEmbedDiv.getAttribute("alt");
-      const hasAttr =
-        alt &&
-        alt !== "" &&
-        alt !== basename &&
-        alt !== internalEmbedDiv.getAttribute("src");
-      if (hasAttr) {
-        //1:width, 2:height, 3:style  1      2      3
-        const parts = alt.match(/(\d*%?)x?(\d*%?)\|?(.*)/);
-        attr.fwidth = parts[1] ? parts[1] : getDefaultWidth(plugin);
-        attr.fheight = parts[2];
-        if (parts[3] != attr.fname) {
-          attr.style = `excalidraw-svg${parts[3] ? `-${parts[3]}` : ""}`;
-        }
-      }
-      if (!hasWidth && !hasHeight && !hasAttr) {
-        attr.fheight = "";
-        attr.fwidth = getDefaultWidth(plugin);
-        attr.style = "excalidraw-svg";
-      }
-    };
-
-    const createImgElement = async () => {
-      setAttr();
-      const imgDiv = await createImageDiv(attr);
-      internalEmbedDiv.appendChild(imgDiv);
-    };
-    await createImgElement();
+    const imgDiv = await processInternalEmbed(internalEmbedDiv,file);
+    internalEmbedDiv.appendChild(imgDiv);
 
     //timer to avoid the image flickering when the user is typing
     let timer: NodeJS.Timeout = null;
@@ -387,17 +410,17 @@ const tmpObsidianWYSIWYG = async (
       if (timer) {
         clearTimeout(timer);
       }
-      timer = setTimeout(() => {
+      timer = setTimeout(async () => {
         timer = null;
-        setAttr();
         internalEmbedDiv.empty();
-        createImgElement();
+        const imgDiv = await processInternalEmbed(internalEmbedDiv,file);
+        internalEmbedDiv.appendChild(imgDiv);    
       }, 500);
     });
     observer.observe(internalEmbedDiv, {
       attributes: true, //configure it to listen to attribute changes
     });
-  }, 300);
+  });
 };
 
 /**
@@ -409,7 +432,8 @@ export const markdownPostProcessor = async (
   el: HTMLElement,
   ctx: MarkdownPostProcessorContext,
 ) => {
-  //check to see if we are rendering in editing mode of live preview
+
+  //check to see if we are rendering in editing mode or live preview
   //if yes, then there should be no .internal-embed containers
   const embeddedItems = el.querySelectorAll(".internal-embed");
   if (embeddedItems.length === 0) {
@@ -421,12 +445,13 @@ export const markdownPostProcessor = async (
   //then I want to hide all embedded items as these will be
   //transcluded text element or some other transcluded content inside the Excalidraw file
   //in reading mode these elements should be hidden
-  if (ctx.frontmatter?.hasOwnProperty("excalidraw-plugin")) {
+  const excalidrawFile = Boolean(ctx.frontmatter?.hasOwnProperty("excalidraw-plugin"));
+  if (excalidrawFile) {
     el.style.display = "none";
     return;
   }
 
-  await processInternalEmbeds(embeddedItems, ctx);
+  await processReadingMode(embeddedItems, ctx);
 };
 
 /**
@@ -514,7 +539,11 @@ export const observer = new MutationObserver(async (m) => {
       if (src) {
         plugin.openDrawing(
           vault.getAbstractFileByPath(src) as TFile,
-          ev[CTRL_OR_CMD]?"new-pane":"active-pane",
+          ev[CTRL_OR_CMD]
+            ? "new-pane"
+            : (ev.metaKey && !app.isMobile) 
+              ? "popout-window"
+              : "active-pane",
         );
       } //.ctrlKey||ev.metaKey);
     });

src/Scripts.ts

@@ -34,7 +34,7 @@ export class ScriptEngine {
       if (!path.endsWith(".svg")) {
         return;
       }
-      const scriptFile = this.plugin.app.vault.getAbstractFileByPath(
+      const scriptFile = app.vault.getAbstractFileByPath(
         getIMGFilename(path, "md"),
       );
       if (scriptFile && scriptFile instanceof TFile) {
@@ -53,7 +53,7 @@ export class ScriptEngine {
       handleSvgFileChange(file.path);
     };
     this.plugin.registerEvent(
-      this.plugin.app.vault.on("delete", deleteEventHandler),
+      app.vault.on("delete", deleteEventHandler),
     );
 
     const createEventHandler = async (file: TFile) => {
@@ -67,7 +67,7 @@ export class ScriptEngine {
       handleSvgFileChange(file.path);
     };
     this.plugin.registerEvent(
-      this.plugin.app.vault.on("create", createEventHandler),
+      app.vault.on("create", createEventHandler),
     );
 
     const renameEventHandler = async (file: TAbstractFile, oldPath: string) => {
@@ -86,7 +86,7 @@ export class ScriptEngine {
       }
     };
     this.plugin.registerEvent(
-      this.plugin.app.vault.on("rename", renameEventHandler),
+      app.vault.on("rename", renameEventHandler),
     );
   }
 
@@ -101,7 +101,6 @@ export class ScriptEngine {
   }
 
   public getListofScripts(): TFile[] {
-    const app = this.plugin.app;
     this.scriptPath = this.plugin.settings.scriptFolderPath;
     if (!app.vault.getAbstractFileByPath(this.scriptPath)) {
       this.scriptPath = null;
@@ -140,10 +139,10 @@ export class ScriptEngine {
 
   async addScriptIconToMap(scriptPath: string, name: string) {
     const svgFilePath = getIMGFilename(scriptPath, "svg");
-    const file = this.plugin.app.vault.getAbstractFileByPath(svgFilePath);
+    const file = app.vault.getAbstractFileByPath(svgFilePath);
     const svgString: string =
       file && file instanceof TFile
-        ? await this.plugin.app.vault.read(file)
+        ? await app.vault.read(file)
         : null;
     this.scriptIconMap = {
       ...this.scriptIconMap,
@@ -168,7 +167,7 @@ export class ScriptEngine {
         const view = app.workspace.getActiveViewOfType(ExcalidrawView);
         if (view) {
           (async()=>{
-            const script = await this.plugin.app.vault.read(f);
+            const script = await app.vault.read(f);
             if(script) {
               this.executeScript(view, script, scriptName);
             }
@@ -181,7 +180,6 @@ export class ScriptEngine {
   }
 
   unloadScripts() {
-    const app = this.plugin.app;
     const scripts = app.vault
       .getFiles()
       .filter((f: TFile) => f.path.startsWith(this.scriptPath));
@@ -198,7 +196,6 @@ export class ScriptEngine {
     this.scriptIconMap = { ...this.scriptIconMap };
     this.updateToolPannels();
 
-    const app = this.plugin.app;
     const commandId = `${PLUGIN_ID}:${basename}`;
     // @ts-ignore
     if (!app.commands.commands[commandId]) {
@@ -229,7 +226,7 @@ export class ScriptEngine {
         buttons?: [{ caption: string; action: Function }],
       ) =>
         ScriptEngine.inputPrompt(
-          this.plugin.app,
+          app,
           header,
           placeholder,
           value,
@@ -242,7 +239,7 @@ export class ScriptEngine {
         instructions?: Instruction[],
       ) =>
         ScriptEngine.suggester(
-          this.plugin.app,
+          app,
           displayItems,
           items,
           hint,
@@ -259,7 +256,7 @@ export class ScriptEngine {
 
   private updateToolPannels() {
     const leaves =
-      this.plugin.app.workspace.getLeavesOfType(VIEW_TYPE_EXCALIDRAW);
+      app.workspace.getLeavesOfType(VIEW_TYPE_EXCALIDRAW);
     leaves.forEach((leaf: WorkspaceLeaf) => {
       const excalidrawView = leaf.view as ExcalidrawView;
       excalidrawView.toolsPanelRef?.current?.updateScriptIconMap(

src/constants.ts

@@ -18,14 +18,17 @@ export const SCRIPT_INSTALL_FOLDER = "Downloaded";
 export const fileid = customAlphabet("1234567890abcdef", 40);
 export const REG_LINKINDEX_INVALIDCHARS = /[<>:"\\|?*#]/g;
 export const REG_BLOCK_REF_CLEAN =
-  /\+|\/|~|=|%|\(|\)|{|}|,|\.|\$|!|\?|;|\[|]|\^|#|\*|<|>|&|@|\||\\|"|:/g;
+  /[!"#$%&()*+,.:;<=>?@^`{|}~\/\[\]\\]/g; //https://discord.com/channels/686053708261228577/989603365606531104/1000128926619816048
+  // /\+|\/|~|=|%|\(|\)|{|}|,|&|\.|\$|!|\?|;|\[|]|\^|#|\*|<|>|&|@|\||\\|"|:|\s/g;
 export const IMAGE_TYPES = ["jpeg", "jpg", "png", "gif", "svg"];
+export const EXPORT_TYPES = ["svg", "dark.svg", "light.svg", "png", "dark.png", "light.png"];
 export const MAX_IMAGE_SIZE = 500;
 export const FRONTMATTER_KEY = "excalidraw-plugin";
 export const FRONTMATTER_KEY_EXPORT_TRANSPARENT =
   "excalidraw-export-transparent";
 export const FRONTMATTER_KEY_EXPORT_DARK = "excalidraw-export-dark";
-export const FRONTMATTER_KEY_EXPORT_SVGPADDING = "excalidraw-export-svgpadding";
+export const FRONTMATTER_KEY_EXPORT_SVGPADDING = "excalidraw-export-svgpadding"; //depricated
+export const FRONTMATTER_KEY_EXPORT_PADDING = "excalidraw-export-padding";
 export const FRONTMATTER_KEY_EXPORT_PNGSCALE = "excalidraw-export-pngscale";
 export const FRONTMATTER_KEY_CUSTOM_PREFIX = "excalidraw-link-prefix";
 export const FRONTMATTER_KEY_CUSTOM_URL_PREFIX = "excalidraw-url-prefix";
@@ -37,6 +40,7 @@ export const FRONTMATTER_KEY_FONT = "excalidraw-font";
 export const FRONTMATTER_KEY_FONTCOLOR = "excalidraw-font-color";
 export const FRONTMATTER_KEY_BORDERCOLOR = "excalidraw-border-color";
 export const FRONTMATTER_KEY_MD_STYLE = "excalidraw-css";
+export const FRONTMATTER_KEY_AUTOEXPORT = "excalidraw-autoexport"
 export const LOCAL_PROTOCOL = "md://";
 export const VIEW_TYPE_EXCALIDRAW = "excalidraw";
 export const ICON_NAME = "excalidraw-icon";

src/dialogs/Messages.ts

@@ -17,6 +17,214 @@ I develop this plugin as a hobby, spending most of my free time doing this. If y
 
 <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>
 `,
+"1.7.18":`
+## Critical fix
+- duplicating text elements, adding text elements from the library, and pasting excalidraw text elements results in a corrupted file!!`,
+"1.7.17":`
+## Fixed
+- Block transclusions sometimes got lost when switching between RAW mode and PREVIEW mode. [#769](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/769)
+
+## New
+- Added feature to disable "new Excalidraw version" notification [#770](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/770)
+- Added option to export both light- and dark-themed images at the same time. If this is enabled Excalidraw will create two files "filename.dark.png" and "filename.light.png" (or .svg depending on your other settings). See practical use case here: [Aadam's Notes](https://notes.aadam.dev/SBYNtPHqsTW9Ck1Kuoxsu/)
+- Added custom export padding for PNG images. Use the frontmatter key ${String.fromCharCode(96)}excalidraw-export-padding${String.fromCharCode(96)} to set the padding at a file level, or set padding for all your files in plugin settings. The new feature replaces the old "SVG Padding" option and applies to both SVG and PNG exports.
+
+## ExcalidrawAutomate
+- Added ${String.fromCharCode(96)}padding${String.fromCharCode(96)} to the createPNG function call.
+${String.fromCharCode(96, 96, 96)}typescript
+async createPNG(
+  templatePath?: string,
+  scale: number = 1,
+  exportSettings?: ExportSettings,
+  loader?: EmbeddedFilesLoader,
+  theme?: string,
+  padding?: number,
+)
+${String.fromCharCode(96, 96, 96)}
+`,
+"1.7.16":`
+## Fixed
+- Excalidraw canvas is empty after saving the drawing and re-opening it at a later time. If you accidentally paste Excalidraw elements from the clipboard as the contents of a text element, in certain situations this can corrupt the Excalidraw file and as a result, Excalidraw will load an empty-looking drawing the next time.  Changing to markdown view, these files can be repaired, however, to avoid accidental data loss, I have prevented pasting of excalidraw clipboard contents as text elements. [#768](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/768)
+
+## New
+- Add zoom % display in tray-mode [737](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/737)
+`,
+"1.7.15":`
+## Fixed
+- Canvas turns white when adding point for curved line [#760](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/760), [#738](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/738), [#5602](https://github.com/excalidraw/excalidraw/issues/5602)
+`,
+"1.7.14": `
+<div class="excalidraw-videoWrapper"><div>
+<iframe src="https://www.youtube.com/embed/yZQoJg2RCKI" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+</div></div>
+
+## New
+- The ${String.fromCharCode(96)}Copy markdown link for selected element to clipboard${String.fromCharCode(96)} action in the Obsidian menu is now more intelligent. If multiple elements are selected it will copy the Element Reference for the largest element. 
+- When referencing an element in a link pointing to an Excalidraw file using the elementId or the section header as the block reference e.g. ${String.fromCharCode(96)}[[file#^elementID]]${String.fromCharCode(96)}, you can now add the ${String.fromCharCode(96)}group=${String.fromCharCode(96)} prefix, e.g. ${String.fromCharCode(96)}[[file#^group=elementID]]${String.fromCharCode(96)} and the ${String.fromCharCode(96)}area=${String.fromCharCode(96)} prefix, e.g. ${String.fromCharCode(96)}[[file#area=Section heading]]${String.fromCharCode(96)}.
+  - If the ${String.fromCharCode(96)}group=${String.fromCharCode(96)} prefix is found, Excalidraw will select the group of elements in the same group as the element referenced by the elementID or heading section.
+  - If the ${String.fromCharCode(96)}area=${String.fromCharCode(96)} prefix is found, excalidraw will insert a cutout of the image around the referenced element.
+  - The ${String.fromCharCode(96)}area=${String.fromCharCode(96)} selector is not supported when embedding Excalidraw as PNG into your markdown documents.
+- I added "Toggle left-handed mode" to the Command Palette. The action is only visible if tray-mode is enabled. It will move the tray from left to right and back. [749](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/749)
+
+## Fixed
+- Zooming with CTRL+Wheel will no longer trigger hover preview.
+- When editing text in a text element CTRL+C will not launch the hover preview in case the mouse pointer is over the text element being edited. Hover preview will only show if the element is not in editing mode.
+- ExcalidrawAutomate did not reliably save changes. This caused issues for example in the "Add link to an existing file and open" script. [#747](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/747)
+- Create a new folder not working when clicking on a link in Erxcalidraw that points to a file that is in a folder that does not yet exist. [741](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/741)
+- Downgraded to React 17 due to various stability issues, including [#738](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/738) and [#747](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/747)
+
+## New in Excalidraw Automate
+- I added two new Excalidraw Automate functions
+${String.fromCharCode(96, 96, 96)}typescript
+/**
+ * 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[];
+${String.fromCharCode(96, 96, 96)}`,
+"1.7.13": `
+## Fix from Excalidraw.com
+- Resize multiple elements from center ([#5560](https://github.com/excalidraw/excalidraw/pull/5560))
+
+## Obsidian 0.16.0 compatibility (getting ready, because 0.16.0 will be available to insiders soon)
+- ${String.fromCharCode(96)}Install or update Excalidraw Scripts${String.fromCharCode(96)} was only available via the page header button. Because the page header is hidden by default, the install script action is now available through the pane menu and through the command palette as well.
+- ${String.fromCharCode(96)}Open selected text as link${String.fromCharCode(96)} page header button is now also available via the pane menu
+- ${String.fromCharCode(96)}Open in Adjacent Pane${String.fromCharCode(96)} and ${String.fromCharCode(96)}Open in Main Workspace${String.fromCharCode(96)} Excalidraw plugin settings is fixed
+`,
+"1.7.12": `
+## New from Excalidraw.com:
+- Showing a mid-point for lines and arrows. By touching the mid-point you can easily add an additional point to a two-point line. This is especially helpful when working on a tablet with touch input. ([#5534](https://github.com/excalidraw/excalidraw/pull/5534))
+- Lock angle when editing a line or an arrow with SHIFT pressed. Pressing SHIFT will restrict the edited point to snap to certain discrete angles. ([#5527](https://github.com/excalidraw/excalidraw/pull/5527))
+
+## Fixed:
+- Clicking Obsidian search-results pointing to an element on the canvas works again ([#734](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/734))
+- The feature to allow resizing and rotation of lines and arrows consisting of 3 or more points by showing the bounding box when selected is back ([#5554](https://github.com/excalidraw/excalidraw/pull/5554))
+
+## New
+- You can now use the following frontmatter key to allow/prevent automatic export of PNG/SVG images at a file level. This frontmatter will override export settings for the given file.  ([#732](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/732)
+${String.fromCharCode(96)}excalidraw-autoexport: none|both|svg|png${String.fromCharCode(96)}
+`,
+"1.7.11": `
+## Fixed
+- Markdown files embed into the Excalidraw canvas crashed when the embedded markdown file included a nested Markdown embed with a block reference (i.e. the markdown document you are dropping into Excalidraw included a quote you referenced from another file using a ${String.fromCharCode(96)}[[other-file#^blockref]]${String.fromCharCode(96)} block or section reference. 
+- Horizontal flipping of arrows and lines broke in 1.7.10. ([#726](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/726))
+`,
+"1.7.10": `
+## New from Excalidraw.com
+- Improved handling of arrows and lines. ([#5501](https://github.com/excalidraw/excalidraw/pull/5501))
+
+## Fixed
+- When opening a document in view-mode or zen-mode the panel buttons no longer flash up for a moment before switching to the desired mode. ([#479](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/479))
+- The "blinding white screen" no longer flashes up while loading the scene if the scene is dark ([#241](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/241))
+
+## Under the hood
+- Finalized migration to React 18 (no longer showing an error about React 17 compatibility mode in console log)
+`,
+"1.7.9": `
+## New features and fixes from Excalidraw.com:
+- The right-click context menu is now scrollable on smaller screens ([#4030](https://github.com/excalidraw/excalidraw/pull/4030), [#5520](https://github.com/excalidraw/excalidraw/pull/5520))
+- Holding down the shift key while rotating an object will rotate it at discrete angles. Rotation is continuous without the SHIFT key. ([#5500](https://github.com/excalidraw/excalidraw/pull/5500))
+- Improved cursor alignment when resizing an element proportionally (maintain aspect ratio) by holding SHIFT during resizing. ([#5513](https://github.com/excalidraw/excalidraw/pull/5515))
+- Improved freedraw performance during editing (now has proper canvas caching), and no more blurry freedraw shapes when exporting on a higher scale. ([#5481](https://github.com/excalidraw/excalidraw/pull/5481))
+- Sidebar stencil library now correctly scrolls vertically ([#5459](https://github.com/excalidraw/excalidraw/pull/5459))
+
+## New in Obsidian:
+- Fullscreen mode on iPad. When there are multiple work panes open, clicking the fullscreen action in the Excalidraw Obsidian menu will hide the other work panes and make Excalidraw fullscreen.
+
+## Fixes in Obsidian:
+- Drag&Drop an image from a web browser into Excalidraw ([#697](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/697))
+- On Obsidian Mobile 1.3.0, when the drawing included an embedded image, switching from markdown-view to Excalidraw-view caused the drawing to disappear (it had to be recovered from backup or synchronization history).  ([#715](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/715))
+- When working on a mobile device (tablet and phone) and using two work panes (one for drawing and the other for editing a markdown document) if you switched focus from the drawing to the markdown document auto-zoom changed the zoom level of the drawing. ([#723](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/723)), ([#705](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/705))
+- Actions on the Command Palette to create a new drawing in a new pane or reusing an existing adjacent pane; on the main workspace or in the Hover Editor or Popout window, were not working well. See related settings in plugin settings under "Links and transclusions" ([#718](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/718))
+- There was a problem with links with section references when the header contained space characters ([#704](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/704))
+- I added additional controls to avoid the fantom warnings about a problem with saving the Excalidraw file. Hopefully, from now on, you'll see this error less frequently ([#701](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/701))
+`,
+"1.7.8": `
+# Optimized for Obsidian 0.15.5
+- I reworked how the plugin treats the "More options" menu because the old approach was interfering with Obsidian
+- Did thorough testing of handling of work panes on link click. There are two settings (open in the adjacent pane, and open in the main workspace), and three broad scenarios (Excalidraw in a work pane in the main Obsidian window, Excalidraw in a hover editor, and Excalidraw in an Obsidian popout window). All should work correctly now.
+`,
+"1.7.7": `
+# New
+- Optimized for Obsidian 0.15.4
+- On a desktop, you can now use the META key when clicking on a link and it will open the link in a new popout Window.
+- ([#685](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/685)) Markdown embeds will now display correctly in Excalidraw even if they include photos and recursive markdown embeds. Unfortunately due to the limitations of Safari the inversion of colors on iPads in dark mode will not work well.
+See an 18 second long demo video [here](https://user-images.githubusercontent.com/14358394/177213263-2a7ef1ca-0614-4190-8955-e830ca6b424b.mp4).
+
+
+# Fixed
+- ([#683](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/683)) Copy/Paste Markdown embeds to create another instance of the embed, thus you can reference different sections of the document in your drawing (something I broke in 1.7.6)
+- ([#684](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/684)) Transclusions incorrectly did not pick up subsections of a section. To understand this change, imagine for example the following document:
+${String.fromCharCode(96, 96, 96)}markdown
+# A
+abc
+# B
+xyz
+## b1
+123
+## b2
+456
+# C
+${String.fromCharCode(96, 96, 96)}
+When you transclude ${String.fromCharCode(96)}![[document#B]]${String.fromCharCode(96)} you expect the following result
+${String.fromCharCode(96, 96, 96)}markdown
+B
+xyz
+
+b1
+123
+
+b2
+456
+${String.fromCharCode(96, 96, 96)}
+Until this fix you only got
+${String.fromCharCode(96, 96, 96)}markdown
+B
+xyz
+${String.fromCharCode(96, 96, 96)}`,
+"1.7.6": `
+This release is the same as 1.7.5 except for two minor fixes
+- a fix for ExcaliBrain, becuase 1.7.5 broke ExcaliBrain.
+- I left out the release note from 1.7.5.
+
+# New
+- Deployed sidebar for libraries panel from excalidraw.com ([#5274](https://github.com/excalidraw/excalidraw/pull/5274)). You can dock the library to the right side depending on the screen real estate available (i.e. does not work on mobiles).
+
+# Fixed
+- When copying 2 identical images from one drawing to another, the second image got corrupted in the process ([#672]https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/672)).
+- When making a copy of an equation in a drawing and then without first closing/opening the file, immediately copying the new equation to another drawing, the equation did not get displayed until the file was closed and reopened.
+- Copying a markdown embed from one drawing to another, in the destination the markdown embed appeared without the section/block reference and without the width & height (i.e. these settings had to be done again)
+- Improved the parsing of section references in embeds. When you had ${String.fromCharCode(96)}&${String.fromCharCode(96)} in the section name in a markdown file, when embedding that markdown document into Excalidraw, the section reference did not work as expected ([#681 ](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/681)).
+- Improved the logic for autosave to better detect changes to the document, and to reduce too frequent export of ${String.fromCharCode(96)}.png${String.fromCharCode(96)} and/or ${String.fromCharCode(96)}.svg${String.fromCharCode(96)} files, when auto export is enabled in plugin settings.
+`,
+"1.7.5": `
+# New
+- Deployed sidebar for libraries panel from excalidraw.com ([#5274](https://github.com/excalidraw/excalidraw/pull/5274)). You can dock the library to the right side depending on the screen real estate available (i.e. does not work on mobiles).
+
+# Fixed
+- When copying 2 identical images from one drawing to another, the second image got corrupted in the process ([#672]https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/672)).
+- When making a copy of an equation in a drawing and then without first closing/opening the file, immediately copying the new equation to another drawing, the equation did not get displayed until the file was closed and reopened.
+- Copying a markdown embed from one drawing to another, in the destination the markdown embed appeared without the section/block reference and without the width & height (i.e. these settings had to be done again)
+- Improved the parsing of section references in embeds. When you had ${String.fromCharCode(96)}&${String.fromCharCode(96)} in the section name in a markdown file, when embedding that markdown document into Excalidraw, the section reference did not work as expected ([#681 ](https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/681)).
+- Improved the logic for autosave to better detect changes to the document, and to reduce too frequent export of ${String.fromCharCode(96)}.png${String.fromCharCode(96)} and/or ${String.fromCharCode(96)}.svg${String.fromCharCode(96)} files, when auto export is enabled in plugin settings.
+`,
+"1.7.4": `
+- Obsidian 0.15.3 support dragging and dropping work panes between Obsidian windows.
+- Addressed Obsidian changes affecting the more-options menu.
+- Addressed incompatibility with Obsidian Mobile 1.2.2.
+`,
+"1.7.3": `
+Obsidian 0.15.3 support for dragging and dropping work panes between Obsidian windows.
+`,
 "1.7.2": `
 Due to some of the changes to the code, I highly recommend restarting Obsidian after installing this update to Excalidraw.
 

src/dialogs/OpenDrawing.ts

@@ -55,7 +55,7 @@ export class OpenFileDialog extends FuzzySuggestModal<TFile> {
   onChooseItem(item: TFile): void {
     switch (this.action) {
       case openDialogAction.openFile:
-        this.plugin.openDrawing(item, this.onNewPane?"new-pane":"active-pane");
+        this.plugin.openDrawing(item, this.onNewPane?"new-pane":"active-pane",true);
         break;
       case openDialogAction.insertLinkToDrawing:
         this.plugin.embedDrawing(item);

src/dialogs/Prompt.ts

@@ -13,6 +13,7 @@ import ExcalidrawView from "../ExcalidrawView";
 import ExcalidrawPlugin from "../main";
 import { sleep } from "../utils/Utils";
 import { getNewOrAdjacentLeaf } from "../utils/ObsidianUtils";
+import { checkAndCreateFolder, splitFolderAndFilename } from "src/utils/FileUtils";
 
 export class Prompt extends Modal {
   private promptEl: HTMLInputElement;
@@ -370,6 +371,7 @@ export class NewFileActions extends Modal {
     private plugin: ExcalidrawPlugin,
     private path: string,
     private newPane: boolean,
+    private newWindow: boolean,
     private view: ExcalidrawView,
   ) {
     super(plugin.app);
@@ -385,11 +387,14 @@ export class NewFileActions extends Modal {
     if (!file) {
       return;
     }
-    const leaf = this.newPane
-      ? getNewOrAdjacentLeaf(this.plugin, this.view.leaf)
-      : this.view.leaf;
-    leaf.openFile(file);
-    this.app.workspace.setActiveLeaf(leaf, true, true);
+    const leaf = this.newWindow
+      //@ts-ignore
+      ? app.workspace.openPopoutLeaf()
+      : this.newPane
+        ? getNewOrAdjacentLeaf(this.plugin, this.view.leaf)
+        : this.view.leaf;
+    leaf.openFile(file, {active:true});
+    //this.app.workspace.setActiveLeaf(leaf, true, true);
   }
 
   createForm(): void {
@@ -430,6 +435,8 @@ export class NewFileActions extends Modal {
         if (!this.path.match(/\.md$/)) {
           this.path = `${this.path}.md`;
         }
+        const folderpath = splitFolderAndFilename(this.path).folderpath;
+        checkAndCreateFolder(folderpath);
         const f = await this.app.vault.create(this.path, data);
         return f;
       };

src/dialogs/ReleaseNotes.ts

@@ -1,4 +1,5 @@
 import { App, MarkdownRenderer, Modal } from "obsidian";
+import { isVersionNewerThanOther } from "src/utils/Utils";
 import ExcalidrawPlugin from "../main";
 import { FIRST_RUN, RELEASE_NOTES } from "./Messages";
 
@@ -11,13 +12,12 @@ export class ReleaseNotes extends Modal {
   constructor(app: App, plugin: ExcalidrawPlugin, version: string) {
     super(app);
     this.plugin = plugin;
-    //@ts-ignore
     this.version = version;
   }
 
   onOpen(): void {
-    this.contentEl.classList.add("excalidraw-release");
-    this.containerEl.classList.add(".excalidraw-release");
+    //this.contentEl.classList.add("excalidraw-release");
+    this.containerEl.classList.add("excalidraw-release");
     this.titleEl.setText(`Welcome to Excalidraw ${this.version ?? ""}`);
     this.createForm();
   }
@@ -31,10 +31,10 @@ export class ReleaseNotes extends Modal {
 
   async createForm() {
     let prevRelease = this.plugin.settings.previousRelease;
-    prevRelease = this.version === prevRelease ? "0" : prevRelease;
+    prevRelease = this.version === prevRelease ? "0.0.0" : prevRelease;
     const message = this.version
       ? Object.keys(RELEASE_NOTES)
-          .filter((key) => key > prevRelease)
+          .filter((key) => key === "Intro" || isVersionNewerThanOther(key,prevRelease))
           .map((key: string) => `# ${key}\n${RELEASE_NOTES[key]}`)
           .slice(0, 10)
           .join("\n\n---\n")

src/dialogs/SuggesterInfo.ts

@@ -385,11 +385,17 @@ export const EXCALIDRAW_AUTOMATE_INFO: SuggesterInfo[] = [
     after: "",
   },
   {
-    field: "getLargestElement",
-    code: "getLargestElement(elements: ExcalidrawElement[]): ExcalidrawElement;",
-    desc: "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",
+    field: "getCommonGroupForElements",
+    code: "getCommonGroupForElements(elements: ExcalidrawElement[]): string;",
+    desc: "Gets the groupId for the group that contains all the elements, or null if such a group does not exist",
     after: "",
   },
+  {
+    field: "getElementsInTheSameGroupWithElement",
+    code: "getElementsInTheSameGroupWithElement(element: ExcalidrawElement, elements: ExcalidrawElement[]): ExcalidrawElement[];",
+    desc: "Gets all the elements from elements[] that share one or more groupIds with element.",
+    after: ""
+  },
   {
     field: "activeScript",
     code: "activeScript: string;",
@@ -581,9 +587,9 @@ export const FRONTMATTER_KEYS_INFO: SuggesterInfo[] = [
     after: ": true",
   },
   {
-    field: "export-svgpadding",
+    field: "export-padding",
     code: null,
-    desc: "If this key is present it will override the default excalidraw embed and export setting. This only affects export to SVG. Specify the export padding for the image.",
+    desc: "If this key is present it will override the default excalidraw embed and export setting. This only affects both SVG and PNG export. Specify the export padding for the image.",
     after: ": 5",
   },
   {
@@ -592,4 +598,11 @@ export const FRONTMATTER_KEYS_INFO: SuggesterInfo[] = [
     desc: "If this key is present it will override the default excalidraw embed and export setting. This only affects export to PNG. Specify the export scale for the image. The typical range is between 0.5 and 5, but you can experiment with other values as well.",
     after: ": 1",
   },
+  {
+    field: "autoexport",
+    code: null,
+    desc: "Override autoexport settings for this file. Valid values are\nnone\nboth\npng\nsvg",
+    after: ": png",
+  },
+  
 ];

src/lang/locale/en.ts

@@ -28,6 +28,7 @@ export default {
     "Open an existing drawing - IN THE CURRENT ACTIVE PANE",
   TRANSCLUDE: "Transclude (embed) a drawing",
   TRANSCLUDE_MOST_RECENT: "Transclude (embed) the most recently edited drawing",
+  TOGGLE_LEFTHANDED_MODE: "Toggle left-handed mode",
   NEW_IN_NEW_PANE: "Create a new drawing - IN A NEW PANE",
   NEW_IN_ACTIVE_PANE: "Create a new drawing - IN THE CURRENT ACTIVE PANE",
   NEW_IN_POPOUT_WINDOW: "Create a new drawing - IN A POPOUT WINDOW",
@@ -35,13 +36,19 @@ export default {
     "Create a new drawing - IN A NEW PANE - and embed into active document",
   NEW_IN_ACTIVE_PANE_EMBED:
     "Create a new drawing - IN THE CURRENT ACTIVE PANE - and embed into active document",
-  NEW_IN_POPOUT_WINDOW_EMBED: "Create a new drawing - IN A POPOUT WINDOW - and embedd into active document",
+  NEW_IN_POPOUT_WINDOW_EMBED: "Create a new drawing - IN A POPOUT WINDOW - and embed into active document",
   EXPORT_SVG: "Save as SVG next to the current file",
   EXPORT_PNG: "Save as PNG next to the current file",
   TOGGLE_LOCK: "Toggle Text Element edit RAW/PREVIEW",
   DELETE_FILE: "Delete selected Image or Markdown file from Obsidian Vault",
   INSERT_LINK_TO_ELEMENT:
-    "Copy markdown link for selected element to clipboard",
+    "Copy markdown link for selected element to clipboard. CTRL/CMD+Click to copy group link. SHIFT+click to copy an area link.",
+  INSERT_LINK_TO_ELEMENT_GROUP:
+    "Copy 'group=' markdown link for selected element to clipboard.",
+  INSERT_LINK_TO_ELEMENT_AREA:
+    "Copy 'area=' markdown link for selected element to clipboard.",
+  INSERT_LINK_TO_ELEMENT_NORMAL:
+    "Copy markdown link for selected element to clipboard.",
   INSERT_LINK_TO_ELEMENT_ERROR: "Select a single element in the scene",
   INSERT_LINK_TO_ELEMENT_READY: "Link is READY and available on the clipboard",
   INSERT_LINK: "Insert link to file",
@@ -84,6 +91,11 @@ export default {
   RELEASE_NOTES_DESC:
     "<b>Toggle ON:</b> Display release notes each time you update Excalidraw to a newer version.<br>" +
     "<b>Toggle OFF:</b> Silent mode. You can still read release notes on <a href='https://github.com/zsviczian/obsidian-excalidraw-plugin/releases'>GitHub</a>.",
+  NEWVERSION_NOTIFICATION_NAME: "Plugin update notification",
+  NEWVERSION_NOTIFICATION_DESC:
+      "<b>Toggle ON:</b> Show a notification when a new version of the plugin is avaiable.<br>" +
+      "<b>Toggle OFF:</b> Silent mode. You need to check for plugin updates in Community Plugins.",
+  
   FOLDER_NAME: "Excalidraw folder",
   FOLDER_DESC:
     "Default location for new drawings. If empty, drawings will be created in the Vault root.",
@@ -91,8 +103,8 @@ export default {
     "Use Excalidraw folder when embedding a drawing into the active document",
   FOLDER_EMBED_DESC:
     "Define which folder to place the newly inserted drawing into " +
-    "when using the command palette action: 'Create a new drawing and embed into active document'. " +
-    "ON: Use Excalidraw folder; OFF: use attachments folder defined in Obsidian settings",
+    "when using the command palette action: 'Create a new drawing and embed into active document'.<br>" +
+    "<b>Toggle ON:</b> Use Excalidraw folder<br><b>Toggle OFF:</b> use the attachments folder defined in Obsidian settings.",
   TEMPLATE_NAME: "Excalidraw template file",
   TEMPLATE_DESC:
     "Full filepath to the Excalidraw template. " +
@@ -116,7 +128,7 @@ export default {
     "be saved without compression, so that you can read and edit the JSON string. The drawing will be compressed again " +
     "once you switch back to Excalidraw view. " +
     "The setting only has effect 'point forward', meaning, existing drawings will not be effected by the setting " +
-    "until you open them and save them. ",
+    "until you open them and save them.<br><b>Toggle ON:</b> Compress drawing JSON<br><b>Toggle OFF:</b> Leave drawing JSON uncompressed",
   AUTOSAVE_NAME: "Enable Autosave",
   AUTOSAVE_DESC:
     "Automatically save the active drawing, in case there are changes, every 15, 30 seconds, or 1, 2, 3, 4, or 5 minute. Save normally happens when you close Excalidraw or Obsidian, or move " +
@@ -137,8 +149,8 @@ export default {
     "Filename prefix when embedding a new drawing into a markdown note",
   FILENAME_PREFIX_EMBED_DESC:
     "Should the filename of the newly inserted drawing start with the name of the active markdown note " +
-    "when using the command palette action: <code>Create a new drawing and embed into active document</code>? " +
-    "ON: Yes, OFF: Not",
+    "when using the command palette action: <code>Create a new drawing and embed into active document</code>?<br>" +
+    "<b>Toggle ON:</b> Yes, the filename of a new drawing should start with filename of the active document<br><b>Toggle OFF:</b> No, filename of a new drawing should not include the filename of the active document",
   FILENAME_POSTFIX_NAME:
     "Custom text after markdown Note's name when embedding",
   FILENAME_POSTFIX_DESC:
@@ -149,26 +161,25 @@ export default {
   FILENAME_EXCALIDRAW_EXTENSION_NAME: ".excalidraw.md or .md",
   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. Toggle ON = filename ends with .excalidraw.md, Toggle OFF = filename ends with .md",
-  /*SVG_IN_MD_NAME: "SVG Snapshot to markdown file",
-  SVG_IN_MD_DESC: "If the switch is 'on' Excalidraw will include an SVG snapshot in the markdown file. "+
-                  "When SVG snapshots are saved to the Excalidraw.md file, drawings that include large png, jpg, gif images may take extreme long time to open in markdown view. " +
-                  "On the other hand, SVG snapshots provide some level of platform independence and longevity to your drawings. Even if Excalidraw will no longer exist, the snapshot " +
-                  "can be opened with an app that reads SVGs. In addition hover previews will be less resource intensive if SVG snapshots are enabled.",*/
+    "i.e. you are not using Excalidraw markdown files.<br><b>Toggle ON:</b> filename ends with .excalidraw.md<br><b>Toggle OFF:</b> filename ends with .md",
   DISPLAY_HEAD: "Display",
   LEFTHANDED_MODE_NAME: "Left-handed mode",
   LEFTHANDED_MODE_DESC:
-    "Currently only has effect in tray-mode. If turned on, the tray will be on the right side.",
+    "Currently only has effect in tray-mode. If turned on, the tray will be on the right side." +
+    "<br><b>Toggle ON:</b> Left-handed mode.<br><b>Toggle OFF:</b> Right-handed moded",
   MATCH_THEME_NAME: "New drawing to match Obsidian theme",
   MATCH_THEME_DESC:
     "If theme is dark, new drawing will be created in dark mode. This does not apply when you use a template for new drawings. " +
-    "Also this will not effect when you open an existing drawing. Those will follow the theme of the template/drawing respectively.",
+    "Also this will not effect when you open an existing drawing. Those will follow the theme of the template/drawing respectively." +
+    "<br><b>Toggle ON:</b> Follow Obsidian Theme<br><b>Toggle OFF:</b>Follow theme defined in your template",
   MATCH_THEME_ALWAYS_NAME: "Existing drawings to match Obsidian theme",
   MATCH_THEME_ALWAYS_DESC:
-    "If theme is dark, drawings will be opened in dark mode. If your theme is light, they will be opened in light mode. ",
+    "If theme is dark, drawings will be opened in dark mode. If your theme is light, they will be opened in light mode. " +
+    "<br><b>Toggle ON:</b> Match Obsidian theme<br><b>Toggle OFF:</b> Open with the same theme as last saved",
   MATCH_THEME_TRIGGER_NAME: "Excalidraw to follow when Obsidian Theme changes",
   MATCH_THEME_TRIGGER_DESC:
-    "If this option is enabled open Excalidraw pane will switch to light/dark mode when Obsidian theme changes. ",
+    "If this option is enabled open Excalidraw pane will switch to light/dark mode when Obsidian theme changes. " +
+    "<br><b>Toggle ON:</b> Follow theme changes<br><b>Toggle OFF:</b> Drawings are not effected by Obsidian theme changes",
   DEFAULT_OPEN_MODE_NAME: "Default mode when opening Excalidraw",
   DEFAULT_OPEN_MODE_DESC:
     "Specifies the mode how Excalidraw opens: Normal, Zen, or View mode. You may also set this behavior on a file level by " +
@@ -177,7 +188,8 @@ export default {
   DEFAULT_PEN_MODE_DESC:
     "Should pen mode be automatically enabled when opening Excalidraw?",
   ZOOM_TO_FIT_NAME: "Zoom to fit on view resize",
-  ZOOM_TO_FIT_DESC: "Zoom to fit drawing when the pane is resized",
+  ZOOM_TO_FIT_DESC: "Zoom to fit drawing when the pane is resized" +
+    "<br><b>Toggle ON:</b> Zoom to fit<br><b>Toggle OFF:</b> Auto zoom disabled",
   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%).",
@@ -294,7 +306,8 @@ export default {
     "For a number of reasons, the same approach cannot be used to expedite the loading of drawings with many embedded objects. See demonstration <a href='https://github.com/zsviczian/obsidian-excalidraw-plugin/releases/tag/1.6.23' target='_blank'>here</a>.",
   EMBED_PREVIEW_SVG_NAME: "Display SVG in markdown preview",
   EMBED_PREVIEW_SVG_DESC:
-    "The default is to display drawings as SVG images in the markdown preview. Turning this feature off, the markdown preview will display the drawing as an embedded PNG image.",
+    "<b>Toggle ON</b>: Embed drawing as an <a href='https://en.wikipedia.org/wiki/Scalable_Vector_Graphics' target='_blank'>SVG</a> image into the markdown preview.<br>" +
+    "<b>Toggle OFF</b>: Embedd drawing as a <a href='' target='_blank'>PNG</a> image. Note, that some of the <a href='https://www.youtube.com/watch?v=yZQoJg2RCKI&t=633s' target='_blank'>image block referencing features</a> do not work with PNG embeds.",
   PREVIEW_MATCH_OBSIDIAN_NAME: "Excalidraw preview to match Obsidian theme",
   PREVIEW_MATCH_OBSIDIAN_DESC:
     "Image preview in documents should match the Obsidian theme. If enabled, when Obsidian is in dark mode, Excalidraw images will render in dark mode. " +
@@ -318,9 +331,11 @@ export default {
   EXPORT_BACKGROUND_NAME: "Export image with background",
   EXPORT_BACKGROUND_DESC:
     "If turned off, the exported image will be transparent.",
-  EXPORT_SVG_PADDING_NAME: "SVG Padding",
-  EXPORT_SVG_PADDING_DESC:
-    "The padding (in pixels) around the exported SVG image. If you have curved lines close to the edge of the image they might get cropped during SVG export. You can increase this value to avoid cropping.",
+  EXPORT_PADDING_NAME: "Image Padding",
+  EXPORT_PADDING_DESC:
+    "The padding (in pixels) around the exported SVG or PNG image. " +
+    "If you have curved lines close to the edge of the image they might get cropped during image export. You can increase this value to avoid cropping. " +
+    "You can also override this setting at a file level by adding the <code>excalidraw-export-padding: 5<code> frontmatter key.",
   EXPORT_THEME_NAME: "Export image with theme",
   EXPORT_THEME_DESC:
     "Export the image matching the dark/light theme of your drawing. If turned off, " +
@@ -336,9 +351,14 @@ export default {
     "Automatically create an SVG export of your drawing matching the title of your file. " +
     "The plugin will save the *.SVG file in the same folder as the drawing. " +
     "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.",
+    "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>",
   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",
   EXPORT_EXCALIDRAW_NAME: "Auto-export Excalidraw",
   EXPORT_EXCALIDRAW_DESC: "Same as the auto-export SVG, but for *.Excalidraw",

src/main.ts

@@ -41,6 +41,7 @@ import {
   SCRIPT_INSTALL_FOLDER,
   VIRGIL_FONT,
   VIRGIL_DATAURL,
+  EXPORT_TYPES,
 } from "./Constants";
 import ExcalidrawView, { TextMode, getTextMode } from "./ExcalidrawView";
 import {
@@ -73,7 +74,6 @@ import {
   getDrawingFilename,
   getEmbedFilename,
   getIMGFilename,
-  getIMGPathFromExcalidrawFile,
   getNewUniqueFilepath,
 } from "./utils/FileUtils";
 import {
@@ -82,6 +82,9 @@ import {
   log,
   setLeftHandedMode,
   sleep,
+  debug,
+  isVersionNewerThanOther,
+  getExportTheme,
 } from "./utils/Utils";
 import { getAttachmentsFolderAndFilePath, getNewOrAdjacentLeaf, getParentOfClass, isObsidianThemeDark } from "./utils/ObsidianUtils";
 //import { OneOffs } from "./OneOffs";
@@ -98,6 +101,8 @@ import { ReleaseNotes } from "./dialogs/ReleaseNotes";
 import { decompressFromBase64 } from "lz-string";
 import { Packages } from "./types";
 import * as React from "react";
+import { ScriptInstallPrompt } from "./dialogs/ScriptInstallPrompt";
+
 
 declare module "obsidian" {
   interface App {
@@ -119,6 +124,9 @@ declare module "obsidian" {
 }
 
 declare const EXCALIDRAW_PACKAGES:string;
+declare const react:any;
+declare const reactDOM:any;
+declare const excalidrawLib: any;
 declare const PLUGIN_VERSION:string;
 
 export default class ExcalidrawPlugin extends Plugin {
@@ -145,7 +153,7 @@ export default class ExcalidrawPlugin extends Plugin {
   public opencount: number = 0;
   public ea: ExcalidrawAutomate;
   //A master list of fileIds to facilitate copy / paste
-  public filesMaster: Map<FileId, { path: string; hasSVGwithBitmap: boolean }> =
+  public filesMaster: Map<FileId, { path: string; hasSVGwithBitmap: boolean; blockrefData: string }> =
     null; //fileId, path
   public equationsMaster: Map<FileId, string> = null; //fileId, formula
   public mathjax: any = null;
@@ -154,12 +162,13 @@ export default class ExcalidrawPlugin extends Plugin {
   public scriptEngine: ScriptEngine;
   public fourthFontDef: string = VIRGIL_FONT;
   private packageMap: WeakMap<Window,Packages> = new WeakMap<Window,Packages>();
+  public leafChangeTimeout: NodeJS.Timeout = null;
 
   constructor(app: App, manifest: PluginManifest) {
     super(app, manifest);
     this.filesMaster = new Map<
       FileId,
-      { path: string; hasSVGwithBitmap: boolean }
+      { path: string; hasSVGwithBitmap: boolean; blockrefData: string }
     >();
     this.equationsMaster = new Map<FileId, string>();
   }
@@ -168,7 +177,6 @@ export default class ExcalidrawPlugin extends Plugin {
 
   public getPackage(win:Window):Packages {
     if(win===window) {
-      //@ts-ignore
       return {react, reactDOM, excalidrawLib};
     }
     if(this.packageMap.has(win)) {
@@ -221,8 +229,8 @@ export default class ExcalidrawPlugin extends Plugin {
     if (this.settings.showReleaseNotes) {
       //I am repurposing imageElementNotice, if the value is true, this means the plugin was just newly installed to Obsidian.
       const obsidianJustInstalled = this.settings.imageElementNotice;
-
-      if (PLUGIN_VERSION > this.settings.previousRelease) {
+     
+      if (isVersionNewerThanOther(PLUGIN_VERSION, this.settings.previousRelease)) {
         new ReleaseNotes(
           this.app,
           this,
@@ -305,10 +313,10 @@ export default class ExcalidrawPlugin extends Plugin {
           //@ts-ignore
           win.MathJax.startup.pagePromise.then(async () => {
             //https://github.com/xldenis/obsidian-latex/blob/master/main.ts
-            const file = self.app.vault.getAbstractFileByPath("preamble.sty");
+            const file = app.vault.getAbstractFileByPath("preamble.sty");
             const preamble: string =
               file && file instanceof TFile
-                ? await self.app.vault.read(file)
+                ? await app.vault.read(file)
                 : null;
             try {
               if (preamble) {
@@ -341,7 +349,7 @@ export default class ExcalidrawPlugin extends Plugin {
     const self = this;
     this.app.workspace.onLayoutReady(() => {
       let leaf: WorkspaceLeaf;
-      for (leaf of self.app.workspace.getLeavesOfType("markdown")) {
+      for (leaf of app.workspace.getLeavesOfType("markdown")) {
         if (
           leaf.view instanceof MarkdownView &&
           self.isExcalidrawFile(leaf.view.file)
@@ -448,7 +456,7 @@ export default class ExcalidrawPlugin extends Plugin {
             if (file) {
               await this.app.vault.modify(file as TFile, data);
             } else {
-              await checkAndCreateFolder(this.app.vault, folder);
+              await checkAndCreateFolder(folder);
               file = await this.app.vault.create(localPath, data);
             }
             return file;
@@ -798,7 +806,10 @@ export default class ExcalidrawPlugin extends Plugin {
     this.addCommand({
       id: "excalidraw-autocreate-popout",
       name: t("NEW_IN_POPOUT_WINDOW"),
-      callback: () => {
+      checkCallback: (checking: boolean) => {
+        if (checking) {
+          return !app.isMobile
+        }
         this.createAndOpenDrawing(getDrawingFilename(this.settings), "popout-window");
       },
     });
@@ -825,7 +836,7 @@ export default class ExcalidrawPlugin extends Plugin {
           ).folder;
       const file = await this.createDrawing(filename, folder);
       await this.embedDrawing(file);
-      this.openDrawing(file, location);
+      this.openDrawing(file, location, true);
     };
 
     this.addCommand({
@@ -857,7 +868,7 @@ export default class ExcalidrawPlugin extends Plugin {
       name: t("NEW_IN_POPOUT_WINDOW_EMBED"),
       checkCallback: (checking: boolean) => {
         if (checking) {
-          return Boolean(this.app.workspace.getActiveViewOfType(MarkdownView));
+          return !app.isMobile && Boolean(this.app.workspace.getActiveViewOfType(MarkdownView));
         }
         insertDrawingToDoc("popout-window");
         return true;
@@ -955,7 +966,7 @@ export default class ExcalidrawPlugin extends Plugin {
           return false;
         }
         const view = this.app.workspace.getActiveViewOfType(ExcalidrawView);
-        if (view) {
+        if (view && !view.compatibilityMode) {
           view.changeTextMode(
             view.textMode === TextMode.parsed ? TextMode.raw : TextMode.parsed,
           );
@@ -965,6 +976,20 @@ export default class ExcalidrawPlugin extends Plugin {
       },
     });
 
+    this.addCommand({
+      id: "scriptengine-store",
+      name: t("INSTALL_SCRIPT_BUTTON"),
+      checkCallback: (checking: boolean) => {
+        if (checking) {
+          return (
+            Boolean(this.app.workspace.getActiveViewOfType(ExcalidrawView))
+          );
+        }
+        new ScriptInstallPrompt(this).open();
+        return true;
+      },
+    });
+
     this.addCommand({
       id: "delete-file",
       name: t("DELETE_FILE"),
@@ -1020,20 +1045,82 @@ export default class ExcalidrawPlugin extends Plugin {
     this.addCommand({
       id: "insert-link-to-element",
       hotkeys: [{ modifiers: ["Ctrl" || "Meta", "Shift"], key: "k" }],
-      name: t("INSERT_LINK_TO_ELEMENT"),
+      name: t("INSERT_LINK_TO_ELEMENT_NORMAL"),
       checkCallback: (checking: boolean) => {
         if (checking) {
           return Boolean(this.app.workspace.getActiveViewOfType(ExcalidrawView))
         }
         const view = this.app.workspace.getActiveViewOfType(ExcalidrawView);
         if (view) {
-          view.copyLinkToSelectedElementToClipboard();
+          view.copyLinkToSelectedElementToClipboard("");
           return true;
         }
         return false;
       },
     });
 
+    this.addCommand({
+      id: "insert-link-to-element-group",
+      name: t("INSERT_LINK_TO_ELEMENT_GROUP"),
+      checkCallback: (checking: boolean) => {
+        if (checking) {
+          return Boolean(this.app.workspace.getActiveViewOfType(ExcalidrawView))
+        }
+        const view = this.app.workspace.getActiveViewOfType(ExcalidrawView);
+        if (view) {
+          view.copyLinkToSelectedElementToClipboard("group=");
+          return true;
+        }
+        return false;
+      },
+    });
+
+    this.addCommand({
+      id: "insert-link-to-element-area",
+      name: t("INSERT_LINK_TO_ELEMENT_AREA"),
+      checkCallback: (checking: boolean) => {
+        if (checking) {
+          return Boolean(this.app.workspace.getActiveViewOfType(ExcalidrawView))
+        }
+        const view = this.app.workspace.getActiveViewOfType(ExcalidrawView);
+        if (view) {
+          view.copyLinkToSelectedElementToClipboard("area=");
+          return true;
+        }
+        return false;
+      },
+    });
+
+    this.addCommand({
+      id: "toggle-lefthanded-mode",
+      name: t("TOGGLE_LEFTHANDED_MODE"),
+      checkCallback: (checking: boolean) => {
+        if (checking) {
+          if(this.app.workspace.getActiveViewOfType(ExcalidrawView)) {
+            const view = this.app.workspace.getActiveViewOfType(ExcalidrawView);
+            const api = view?.excalidrawAPI;
+            if(!api) return false;
+            const st = api.getAppState();
+            if(!st.trayModeEnabled) return false;
+            return true;
+          }
+          return false;
+        }
+        const view = this.app.workspace.getActiveViewOfType(ExcalidrawView);
+        (async()=>{
+          const isLeftHanded = this.settings.isLeftHanded;
+          await this.loadSettings(false);
+          this.settings.isLeftHanded = !isLeftHanded;
+          this.saveSettings();
+          //not clear why I need to do this. If I don't double apply the stylesheet changes 
+          //then the style won't be applied in the popout windows
+          setLeftHandedMode(!isLeftHanded);
+          setTimeout(()=>setLeftHandedMode(!isLeftHanded));
+        })()
+        return true;
+      },
+    });
+
     this.addCommand({
       id: "insert-image",
       name: t("INSERT_IMAGE"),
@@ -1223,7 +1310,7 @@ export default class ExcalidrawPlugin extends Plugin {
       FRONTMATTER + (await this.exportSceneToMD(data)),
     );
     if (this.settings.keepInSync) {
-      [".svg", ".png"].forEach((ext: string) => {
+      EXPORT_TYPES.forEach((ext: string) => {
         const oldIMGpath =
           file.path.substring(0, file.path.lastIndexOf(".excalidraw")) + ext;
         const imgFile = this.app.vault.getAbstractFileByPath(
@@ -1255,8 +1342,52 @@ export default class ExcalidrawPlugin extends Plugin {
   }
 
   private registerMonkeyPatches() {
-    const self = this;
+    this.registerEvent(
+      app.workspace.on("editor-menu", (menu, editor, view) => {
+        if(!view || !(view instanceof MarkdownView)) return;
+        const file = view.file;
+        const leaf = view.leaf;
+        if (!view.file) return;
+        const cache = this.app.metadataCache.getFileCache(file);
+        if (!cache?.frontmatter || !cache.frontmatter[FRONTMATTER_KEY]) return;
+        
+        menu.addItem(item => item
+          .setTitle(t("OPEN_AS_EXCALIDRAW"))
+          .setIcon(ICON_NAME)
+          .setSection("excalidraw")
+          .onClick(() => {
+            //@ts-ignore
+            this.excalidrawFileModes[leaf.id || file.path] = VIEW_TYPE_EXCALIDRAW;
+            this.setExcalidrawView(leaf);
+          }));
+        },
+      ),
+    );
 
+    this.registerEvent(      
+      app.workspace.on("file-menu", (menu, file, source, leaf) => {
+        if (!leaf || !(leaf.view instanceof MarkdownView)) return;
+        if (!(file instanceof TFile)) return;
+        const cache = this.app.metadataCache.getFileCache(file);
+        if (!cache?.frontmatter || !cache.frontmatter[FRONTMATTER_KEY]) return;
+        
+        menu.addItem(item => {
+          item
+          .setTitle(t("OPEN_AS_EXCALIDRAW"))
+          .setIcon(ICON_NAME)
+          .setSection("pane")
+          .onClick(() => {
+            //@ts-ignore
+            this.excalidrawFileModes[leaf.id || file.path] = VIEW_TYPE_EXCALIDRAW;
+            this.setExcalidrawView(leaf);
+          })});
+        //@ts-ignore
+        menu.items.unshift(menu.items.pop());
+        },
+      ),
+    );
+    
+    const self = this;
     // Monkey patch WorkspaceLeaf to open Excalidraw drawings with ExcalidrawView by default
     this.register(
       around(WorkspaceLeaf.prototype, {
@@ -1290,7 +1421,7 @@ export default class ExcalidrawPlugin extends Plugin {
                 "markdown"
             ) {
               // Then check for the excalidraw frontMatterKey
-              const cache = self.app.metadataCache.getCache(state.state.file);
+              const cache = app.metadataCache.getCache(state.state.file);
 
               if (cache?.frontmatter && cache.frontmatter[FRONTMATTER_KEY]) {
                 // If we have it, force the view type to excalidraw
@@ -1311,43 +1442,6 @@ export default class ExcalidrawPlugin extends Plugin {
         },
       }),
     );
-
-    // Add a menu item to go back to Excalidraw view
-    this.register(
-      around(MarkdownView.prototype, {
-        onMoreOptionsMenu(next) {
-          return function (menu: Menu) {
-            const file = this.file;
-            const cache = file
-              ? self.app.metadataCache.getFileCache(file)
-              : null;
-
-            if (
-              !file ||
-              !cache?.frontmatter ||
-              !cache.frontmatter[FRONTMATTER_KEY]
-            ) {
-              return next.call(this, menu);
-            }
-
-            menu
-              .addItem((item) => {
-                item
-                  .setTitle(t("OPEN_AS_EXCALIDRAW"))
-                  .setIcon(ICON_NAME)
-                  .onClick(() => {
-                    self.excalidrawFileModes[this.leaf.id || file.path] =
-                      VIEW_TYPE_EXCALIDRAW;
-                    self.setExcalidrawView(this.leaf);
-                  });
-              })
-              .addSeparator();
-
-            next.call(this, menu);
-          };
-        },
-      }),
-    );
   }
 
   private popScope: Function = null;
@@ -1369,21 +1463,21 @@ export default class ExcalidrawPlugin extends Plugin {
         if (!self.settings.keepInSync) {
           return;
         }
-        [".svg", ".png", ".excalidraw"].forEach(async (ext: string) => {
-          const oldIMGpath = getIMGPathFromExcalidrawFile(oldPath, ext);
-          const imgFile = self.app.vault.getAbstractFileByPath(
+        [EXPORT_TYPES, "excalidraw"].flat().forEach(async (ext: string) => {
+          const oldIMGpath = getIMGFilename(oldPath, ext);
+          const imgFile = app.vault.getAbstractFileByPath(
             normalizePath(oldIMGpath),
           );
           if (imgFile && imgFile instanceof TFile) {
-            const newIMGpath = getIMGPathFromExcalidrawFile(file.path, ext);
-            await self.app.fileManager.renameFile(imgFile, newIMGpath);
+            const newIMGpath = getIMGFilename(file.path, ext);
+            await app.fileManager.renameFile(imgFile, newIMGpath);
           }
         });
       };
-      self.registerEvent(self.app.vault.on("rename", renameEventHandler));
+      self.registerEvent(app.vault.on("rename", renameEventHandler));
 
       const modifyEventHandler = async (file: TFile) => {
-        const leaves = self.app.workspace.getLeavesOfType(VIEW_TYPE_EXCALIDRAW);
+        const leaves = app.workspace.getLeavesOfType(VIEW_TYPE_EXCALIDRAW);
         leaves.forEach(async (leaf: WorkspaceLeaf) => {
           const excalidrawView = leaf.view as ExcalidrawView;
           if (
@@ -1416,7 +1510,7 @@ export default class ExcalidrawPlugin extends Plugin {
           }
         });
       };
-      self.registerEvent(self.app.vault.on("modify", modifyEventHandler));
+      self.registerEvent(app.vault.on("modify", modifyEventHandler));
 
       //watch file delete and delete corresponding .svg and .png
       const deleteEventHandler = async (file: TFile) => {
@@ -1431,7 +1525,7 @@ export default class ExcalidrawPlugin extends Plugin {
         }
 
         //close excalidraw view where this file is open
-        const leaves = self.app.workspace.getLeavesOfType(VIEW_TYPE_EXCALIDRAW);
+        const leaves = 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({
@@ -1444,32 +1538,38 @@ export default class ExcalidrawPlugin extends Plugin {
         //delete PNG and SVG files as well
         if (self.settings.keepInSync) {
           setTimeout(() => {
-            [".svg", ".png", ".excalidraw"].forEach(async (ext: string) => {
-              const imgPath = getIMGPathFromExcalidrawFile(file.path, ext);
-              const imgFile = self.app.vault.getAbstractFileByPath(
+            [EXPORT_TYPES, "excalidraw"].flat().forEach(async (ext: string) => {
+              const imgPath = getIMGFilename(file.path, ext);
+              const imgFile = app.vault.getAbstractFileByPath(
                 normalizePath(imgPath),
               );
               if (imgFile && imgFile instanceof TFile) {
-                await self.app.vault.delete(imgFile);
+                await app.vault.delete(imgFile);
               }
             });
           }, 500);
         }
       };
-      self.registerEvent(self.app.vault.on("delete", deleteEventHandler));
+      self.registerEvent(app.vault.on("delete", deleteEventHandler));
 
       //save open drawings when user quits the application
       //Removing because it is not guaranteed to run, and frequently gets terminated mid flight, causing file consistency issues
       /*const quitEventHandler = async () => {
-        const leaves = self.app.workspace.getLeavesOfType(VIEW_TYPE_EXCALIDRAW);
+        const leaves = app.workspace.getLeavesOfType(VIEW_TYPE_EXCALIDRAW);
         for (let i = 0; i < leaves.length; i++) {
           await (leaves[i].view as ExcalidrawView).save(true);
         }
       };
-      self.registerEvent(self.app.workspace.on("quit", quitEventHandler));*/
+      self.registerEvent(app.workspace.on("quit", quitEventHandler));*/
 
       //save Excalidraw leaf and update embeds when switching to another leaf
       const activeLeafChangeEventHandler = async (leaf: WorkspaceLeaf) => {
+        //https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/723
+        if(self.leafChangeTimeout) {
+          clearTimeout(this.leafChangeTimeout);
+        }
+        self.leafChangeTimeout = setTimeout(()=>{self.leafChangeTimeout = null;},1000);
+
         const previouslyActiveEV = self.activeExcalidrawView;
         const newActiveviewEV: ExcalidrawView =
           leaf.view instanceof ExcalidrawView ? leaf.view : null;
@@ -1483,7 +1583,9 @@ export default class ExcalidrawPlugin extends Plugin {
           if (previouslyActiveEV.leaf != leaf) {
             //if loading new view to same leaf then don't save. Excalidarw view will take care of saving anyway.
             //avoid double saving
-            await previouslyActiveEV.save(true); //this will update transclusions in the drawing
+            if(previouslyActiveEV.semaphores.dirty) {
+              await previouslyActiveEV.save(true); //this will update transclusions in the drawing
+            }
           }
           if (previouslyActiveEV.file) {
             self.triggerEmbedUpdates(previouslyActiveEV.file.path);
@@ -1527,7 +1629,7 @@ export default class ExcalidrawPlugin extends Plugin {
         }
       };
       self.registerEvent(
-        self.app.workspace.on(
+        app.workspace.on(
           "active-leaf-change",
           activeLeafChangeEventHandler,
         ),
@@ -1535,7 +1637,7 @@ export default class ExcalidrawPlugin extends Plugin {
 
       self.addFileSaveTriggerEventHandlers();
 
-      const metaCache: MetadataCache = self.app.metadataCache;
+      const metaCache: MetadataCache = app.metadataCache;
       //@ts-ignore
       metaCache.getCachedFiles().forEach((filename: string) => {
         const fm = metaCache.getCache(filename)?.frontmatter;
@@ -1544,7 +1646,7 @@ export default class ExcalidrawPlugin extends Plugin {
           filename.match(/\.excalidraw$/)
         ) {
           self.updateFileCache(
-            self.app.vault.getAbstractFileByPath(filename) as TFile,
+            app.vault.getAbstractFileByPath(filename) as TFile,
             fm,
           );
         }
@@ -1700,50 +1802,75 @@ export default class ExcalidrawPlugin extends Plugin {
   public async embedDrawing(file: TFile) {
     const activeView = this.app.workspace.getActiveViewOfType(MarkdownView);
     if (activeView && activeView.file) {
-      const data = this.app.metadataCache.fileToLinktext(
+      const excalidrawRelativePath = this.app.metadataCache.fileToLinktext(
         file,
         activeView.file.path,
         this.settings.embedType === "excalidraw",
       );
       const editor = activeView.editor;
+
+      //embed Excalidraw
       if (this.settings.embedType === "excalidraw") {
         editor.replaceSelection(
           this.settings.embedWikiLink
-            ? `![[${data}]]`
-            : `![](${encodeURI(data)})`,
+            ? `![[${excalidrawRelativePath}]]`
+            : `![](${encodeURI(excalidrawRelativePath)})`,
         );
         editor.focus();
         return;
       }
 
-      const filename = getIMGPathFromExcalidrawFile(
-        data,
-        `.${this.settings.embedType.toLowerCase()}`,
-      );
-      const filepath = getIMGPathFromExcalidrawFile(
-        file.path,
-        `.${this.settings.embedType.toLowerCase()}`,
-      );
+      //embed image
+      let theme = this.settings.autoExportLightAndDark
+        ? getExportTheme (
+          this,
+          file,
+          this.settings.exportWithTheme
+            ? isObsidianThemeDark() ? "dark":"light"
+            : "light"
+          )
+        : "";
 
-      const imgFile = this.app.vault.getAbstractFileByPath(filepath);
+      theme = theme===""?"":theme+".";
+
+      const imageRelativePath = getIMGFilename(
+        excalidrawRelativePath,
+        theme+this.settings.embedType.toLowerCase(),
+      );
+      const imageFullpath = getIMGFilename(
+        file.path,
+        theme+this.settings.embedType.toLowerCase(),
+      );
+     
+      //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 imgFile = this.app.vault.getAbstractFileByPath(imageFullpath);
       if (!imgFile) {
-        await this.app.vault.create(filepath, "");
+        await this.app.vault.create(imageFullpath, "");
         await sleep(200);
       }
+
       editor.replaceSelection(
         this.settings.embedWikiLink
-          ? `![[${filename}]]\n%%[[${data}|🖋 Edit in Excalidraw]]%%`
-          : `![](${encodeURI(filename)})\n%%[🖋 Edit in Excalidraw](${encodeURI(
-              data,
-            )})%%`,
+          ? `![[${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)+")":""}%%`,
       );
       editor.focus();
     }
   }
 
-  public async loadSettings() {
+  public async loadSettings(applyLefthandedMode:boolean = true) {
     this.settings = Object.assign({}, DEFAULT_SETTINGS, await this.loadData());
-    setLeftHandedMode(this.settings.isLeftHanded);
+    if(applyLefthandedMode) setLeftHandedMode(this.settings.isLeftHanded);
     this.settings.autosave = true;
     this.settings.autosaveInterval = 10000;
   }
@@ -1788,7 +1915,9 @@ export default class ExcalidrawPlugin extends Plugin {
 
   public openDrawing(
     drawingFile: TFile,
-    location: "active-pane"|"new-pane"|"popout-window"
+    location: "active-pane"|"new-pane"|"popout-window",
+    active: boolean = false,
+    subpath?: string
   ) {
     let leaf: WorkspaceLeaf;
     if(location === "popout-window") {
@@ -1802,10 +1931,17 @@ export default class ExcalidrawPlugin extends Plugin {
       }
     }
 
-    leaf.setViewState({
+    leaf.openFile(
+      drawingFile, 
+      !subpath || subpath === "" 
+        ? {active}
+        : { active, eState: { subpath } }
+    );
+
+/*    leaf.setViewState({
       type: VIEW_TYPE_EXCALIDRAW,
-      state: { file: drawingFile.path },
-    });
+      state: { file: drawingFile.path, eState: {subpath}},
+    });*/
   }
 
   public async getBlankDrawing(): Promise<string> {
@@ -1884,7 +2020,7 @@ export default class ExcalidrawPlugin extends Plugin {
     const folderpath = normalizePath(
       foldername ? foldername : this.settings.folder,
     );
-    await checkAndCreateFolder(this.app.vault, folderpath); //create folder if it does not exist
+    await checkAndCreateFolder(folderpath); //create folder if it does not exist
     const fname = getNewUniqueFilepath(this.app.vault, filename, folderpath);
     const file = await this.app.vault.create(
       fname,
@@ -1911,7 +2047,7 @@ export default class ExcalidrawPlugin extends Plugin {
     initData?: string,
   ): Promise<string> {
     const file = await this.createDrawing(filename, foldername, initData);
-    this.openDrawing(file, location);
+    this.openDrawing(file, location, true);
     return file.path;
   }
 
@@ -1963,7 +2099,7 @@ export default class ExcalidrawPlugin extends Plugin {
         }
         filename = `${filename}.excalidrawlib`;
         const folderpath = normalizePath(this.settings.folder);
-        await checkAndCreateFolder(this.app.vault, folderpath); //create folder if it does not exist
+        await checkAndCreateFolder(folderpath); //create folder if it does not exist
         const fname = getNewUniqueFilepath(
           this.app.vault,
           filename,

src/menu/ToolsPanel.tsx

@@ -3,7 +3,7 @@ import { Notice, TFile } from "obsidian";
 import * as React from "react";
 import { ActionButton } from "./ActionButton";
 import { ICONS } from "./ActionIcons";
-import { SCRIPT_INSTALL_FOLDER } from "../Constants";
+import { SCRIPT_INSTALL_FOLDER, CTRL_OR_CMD } from "../Constants";
 import { insertLaTeXToView, search } from "../ExcalidrawAutomate";
 import ExcalidrawView, { TextMode } from "../ExcalidrawView";
 import { t } from "../lang/helpers";
@@ -194,7 +194,7 @@ export class ToolsPanel extends React.Component<PanelProps, PanelState> {
                 : "none",
             height: "fit-content",
             maxHeight: "400px",
-            zIndex: 3,
+            zIndex: 5,
           }}
         >
           <div
@@ -464,8 +464,10 @@ export class ToolsPanel extends React.Component<PanelProps, PanelState> {
                   <ActionButton
                     key={"link-to-element"}
                     title={t("INSERT_LINK_TO_ELEMENT")}
-                    action={() => {
-                      this.props.view.copyLinkToSelectedElementToClipboard();
+                    action={(e:React.MouseEvent<HTMLButtonElement, MouseEvent>) => {
+                      this.props.view.copyLinkToSelectedElementToClipboard(
+                        e[CTRL_OR_CMD] ? "group=" : (e.shiftKey ? "area=" : "")
+                      );
                     }}
                     icon={ICONS.copyElementLink}
                     view={this.props.view}

src/settings.ts

@@ -62,6 +62,7 @@ export interface ExcalidrawSettings {
   keepInSync: boolean;
   autoexportSVG: boolean;
   autoexportPNG: boolean;
+  autoExportLightAndDark: boolean;
   autoexportExcalidraw: boolean;
   embedType: "excalidraw" | "PNG" | "SVG";
   embedWikiLink: boolean;
@@ -101,6 +102,7 @@ export interface ExcalidrawSettings {
   defaultTrayMode: boolean;
   previousRelease: string;
   showReleaseNotes: boolean;
+  showNewVersionNotification: boolean;
   mathjaxSourceURL: string;
 }
 
@@ -144,10 +146,11 @@ export const DEFAULT_SETTINGS: ExcalidrawSettings = {
   pngExportScale: 1,
   exportWithTheme: true,
   exportWithBackground: true,
-  exportPaddingSVG: 10,
+  exportPaddingSVG: 10, //since 1.6.17, not only SVG but also PNG
   keepInSync: false,
   autoexportSVG: false,
   autoexportPNG: false,
+  autoExportLightAndDark: false,
   autoexportExcalidraw: false,
   embedType: "excalidraw",
   embedWikiLink: true,
@@ -182,6 +185,7 @@ export const DEFAULT_SETTINGS: ExcalidrawSettings = {
   defaultTrayMode: false,
   previousRelease: "1.6.13",
   showReleaseNotes: true,
+  showNewVersionNotification: true,
   mathjaxSourceURL: "https://cdn.jsdelivr.net/npm/mathjax@3.2.1/es5/tex-svg.js"
 };
 
@@ -219,7 +223,7 @@ export class ExcalidrawSettingTab extends PluginSettingTab {
     this.plugin.saveSettings();
     if (this.requestReloadDrawings) {
       const exs =
-        this.plugin.app.workspace.getLeavesOfType(VIEW_TYPE_EXCALIDRAW);
+        app.workspace.getLeavesOfType(VIEW_TYPE_EXCALIDRAW);
       for (const v of exs) {
         if (v.view instanceof ExcalidrawView) {
           await v.view.save(false);
@@ -269,6 +273,18 @@ export class ExcalidrawSettingTab extends PluginSettingTab {
           }),
       );
 
+    new Setting(containerEl)
+    .setName(t("NEWVERSION_NOTIFICATION_NAME"))
+    .setDesc(fragWithHTML(t("NEWVERSION_NOTIFICATION_DESC")))
+    .addToggle((toggle) =>
+      toggle
+        .setValue(this.plugin.settings.showNewVersionNotification)
+        .onChange(async (value) => {
+          this.plugin.settings.showNewVersionNotification = value;
+          this.applySettingsUpdate();
+        }),
+    );
+
     new Setting(containerEl)
       .setName(t("FOLDER_NAME"))
       .setDesc(fragWithHTML(t("FOLDER_DESC")))
@@ -443,7 +459,10 @@ export class ExcalidrawSettingTab extends PluginSettingTab {
           .setValue(this.plugin.settings.isLeftHanded)
           .onChange(async (value) => {
             this.plugin.settings.isLeftHanded = value;
-            setLeftHandedMode(value);
+            //not clear why I need to do this. If I don't double apply the stylesheet changes 
+            //then the style won't be applied in the popout windows
+            setLeftHandedMode(value); 
+            setTimeout(()=>setLeftHandedMode(value));
             this.applySettingsUpdate();
           }),
       );
@@ -563,7 +582,7 @@ export class ExcalidrawSettingTab extends PluginSettingTab {
           .setValue(this.plugin.settings.openInAdjacentPane)
           .onChange(async (value) => {
             this.plugin.settings.openInAdjacentPane = value;
-            this.applySettingsUpdate(true);
+            this.applySettingsUpdate();
           }),
       );
 
@@ -576,12 +595,12 @@ export class ExcalidrawSettingTab extends PluginSettingTab {
           .setValue(this.plugin.settings.openInMainWorkspace)
           .onChange(async (value) => {
             this.plugin.settings.openInMainWorkspace = value;
-            this.applySettingsUpdate(true);
+            this.applySettingsUpdate();
           }),
       );
 
     new Setting(containerEl)
-      .setName(t("LINK_BRACKETS_NAME"))
+      .setName(fragWithHTML(t("LINK_BRACKETS_NAME")))
       .setDesc(fragWithHTML(t("LINK_BRACKETS_DESC")))
       .addToggle((toggle) =>
         toggle
@@ -993,8 +1012,8 @@ export class ExcalidrawSettingTab extends PluginSettingTab {
     let exportPadding: HTMLDivElement;
 
     new Setting(containerEl)
-      .setName(t("EXPORT_SVG_PADDING_NAME"))
-      .setDesc(fragWithHTML(t("EXPORT_SVG_PADDING_DESC")))
+      .setName(t("EXPORT_PADDING_NAME"))
+      .setDesc(fragWithHTML(t("EXPORT_PADDING_DESC")))
       .addSlider((slider) =>
         slider
           .setLimits(0, 50, 5)
@@ -1090,6 +1109,18 @@ export class ExcalidrawSettingTab extends PluginSettingTab {
           }),
       );
 
+    new Setting(containerEl)
+      .setName(t("EXPORT_BOTH_DARK_AND_LIGHT_NAME"))
+      .setDesc(fragWithHTML(t("EXPORT_BOTH_DARK_AND_LIGHT_DESC")))
+      .addToggle((toggle) =>
+        toggle
+          .setValue(this.plugin.settings.autoExportLightAndDark)
+          .onChange(async (value) => {
+            this.plugin.settings.autoExportLightAndDark = value;
+            this.applySettingsUpdate();
+          }),
+      );
+
     this.containerEl.createEl("h1", { text: t("COMPATIBILITY_HEAD") });
 
     new Setting(containerEl)

src/types.d.ts

@@ -6,12 +6,13 @@ import { ExcalidrawAutomate } from "./ExcalidrawAutomate";
 import ExcalidrawView, { ExportSettings } from "./ExcalidrawView";
 import ExcalidrawPlugin from "./main";
 
+
 export type ConnectionPoint = "top" | "bottom" | "left" | "right" | null;
 
 export type Packages = {
   react: any,
   reactDOM: any,
-  excalidrawLib: any
+  excalidrawLib: any,
 }
 
 export interface ExcalidrawAutomateInterface {

src/utils/FileUtils.ts

@@ -42,7 +42,7 @@ export function splitFolderAndFilename(filepath: string): {
  * @param newExtension - extension of IMG file in ".extension" format
  * @returns
  */
-export function getIMGPathFromExcalidrawFile(
+/*export function getIMGPathFromExcalidrawFile(
   excalidrawPath: string,
   newExtension: string,
 ): string {
@@ -52,6 +52,16 @@ export function getIMGPathFromExcalidrawFile(
     excalidrawPath.substring(0, excalidrawPath.lastIndexOf(replaceExtension)) +
     newExtension
   );
+}*/
+
+/**
+ * Generates the image filename based on the excalidraw filename
+ * @param path - path to the excalidraw file
+ * @param extension - extension without the preceeding "."
+ * @returns 
+ */
+export function getIMGFilename(path: string, extension: string): string {
+  return `${path.substring(0, path.lastIndexOf("."))}.${extension}`;
 }
 
 /**
@@ -120,7 +130,8 @@ export function getEmbedFilename(
  * Open or create a folderpath if it does not exist
  * @param folderpath
  */
-export async function checkAndCreateFolder(vault: Vault, folderpath: string) {
+export async function checkAndCreateFolder(folderpath: string) {
+  const vault = app.vault;
   folderpath = normalizePath(folderpath);
   //https://github.com/zsviczian/obsidian-excalidraw-plugin/issues/658
   //@ts-ignore
@@ -134,6 +145,3 @@ export async function checkAndCreateFolder(vault: Vault, folderpath: string) {
   await vault.createFolder(folderpath);
 }
 
-export function getIMGFilename(path: string, extension: string): string {
-  return `${path.substring(0, path.lastIndexOf("."))}.${extension}`;
-}

src/utils/ObsidianUtils.ts

@@ -1,6 +1,7 @@
+import { main } from "@popperjs/core";
 import {
   App,
-  normalizePath, WorkspaceLeaf
+  normalizePath, Notice, WorkspaceLeaf
 } from "obsidian";
 import ExcalidrawPlugin from "../main";
 import { checkAndCreateFolder, splitFolderAndFilename } from "./FileUtils";
@@ -17,41 +18,110 @@ export const getParentOfClass = (element: HTMLElement, cssClass: string):HTMLEle
   return parent?.classList?.contains(cssClass) ? parent : null;
 };
 
+
+/*
+| Setting                 |                                       Originating Leaf                                                       |
+|                         | Main Workspace                   | Hover Editor                           | Popout Window                    |
+| ----------------------- | -------------------------------- | -------------------------------------- | -------------------------------- |
+| InMain  && InAdjacent   | 1.1 Reuse Leaf in Main Workspace | 1.1 Reuse Leaf in Main Workspace       | 1.1 Reuse Leaf in Main Workspace |
+| InMain  && !InAdjacent  | 1.2 New Leaf in Main Workspace   | 1.2 New Leaf in Main Workspace         | 1.2 New Leaf in Main Workspace   |
+| !InMain && InAdjacent   | 1.1 Reuse Leaf in Main Workspace | 3   Reuse Leaf in Current Hover Editor | 4   Reuse Leaf in Current Popout |
+| !InMain && !InAdjacent  | 1.2 New Leaf in Main Workspace   | 2   New Leaf in Current Hover Editor   | 2   New Leaf in Current Popout   |
+*/
+
 export const getNewOrAdjacentLeaf = (
   plugin: ExcalidrawPlugin,
   leaf: WorkspaceLeaf
 ): WorkspaceLeaf => {
-  if(plugin.settings.openInMainWorkspace) {
-    leaf.view.navigation = false;
-    const mainLeaf = app.workspace.getLeaf(false)
-    leaf.view.navigation = true;
-    if(plugin.settings.openInAdjacentPane || mainLeaf.view.getViewType() === 'empty') {
+    //@ts-ignore
+    const leafId = leaf.id;
+    const layout = app.workspace.getLayout();
+    const getLeaves = (l:any)=> l.children
+      .filter((c:any)=>c.type!=="leaf")
+      .map((c:any)=>getLeaves(c))
+      .flat()
+      .concat(l.children.filter((c:any)=>c.type==="leaf").map((c:any)=>c.id))
+    
+    const mainLeavesIds = getLeaves(layout.main);
+
+    const leafLoc = 
+      layout.main && mainLeavesIds.contains(leafId)
+      ? "main"
+      : layout.floating && getLeaves(layout.floating).contains(leafId)
+        ? "popout"
+        : layout.left && getLeaves(layout.left).contains(leafId)
+          ? "left"
+          : layout.right && getLeaves(layout.right).contains(leafId)
+            ? "right"
+            : "hover";
+
+  const getMainLeaf = ():WorkspaceLeaf => {
+    let mainLeaf = app.workspace.getMostRecentLeaf();
+    if(mainLeaf && mainLeaf !== leaf && mainLeaf.view?.containerEl.ownerDocument === document) {
       return mainLeaf;
     }
-    return app.workspace.createLeafBySplit(mainLeaf);
+    mainLeaf = null;
+    mainLeavesIds
+      .forEach((id:any)=> {
+        const l = app.workspace.getLeafById(id);
+        if(mainLeaf ||
+          !l.view?.navigation || 
+          leaf === l
+        ) return;
+        mainLeaf = l;
+    })
+    return mainLeaf;
   }
 
-  if (plugin.settings.openInAdjacentPane) {
-    //if in popout window
-    if(leaf.view.containerEl.ownerDocument !== document) {
-      const popoutLeaves = new Set<WorkspaceLeaf>();  
-      app.workspace.iterateAllLeaves(l=>{
-        if(l !== leaf && l.view.navigation && l.view.containerEl.ownerDocument === leaf.view.containerEl.ownerDocument) {
-          popoutLeaves.add(l);
-        }
-      });
-      if(popoutLeaves.size === 0) {
-        return app.workspace.getLeaf(true);
+  //1
+  if(plugin.settings.openInMainWorkspace || ["main","left","right"].contains(leafLoc)) {
+    //1.1
+    if(!plugin.settings.openInAdjacentPane) {
+      if(leafLoc === "main") {
+        return app.workspace.createLeafBySplit(leaf);
       }
-      return Array.from(popoutLeaves)[0];
+      const ml = getMainLeaf();
+      return ml
+        ? (ml.view.getViewType() === "empty" ? ml : app.workspace.createLeafBySplit(ml))
+        : app.workspace.getLeaf(true);
     }
 
-    leaf.view.navigation = false;
-    const leafToUse = app.workspace.getLeaf(false)
-    leaf.view.navigation = true;
-    return leafToUse
+    //1.2
+    const ml = getMainLeaf();
+    return ml ?? app.workspace.getLeaf(true);
   }
 
+  //2
+  if(!plugin.settings.openInAdjacentPane) {
+    return app.workspace.createLeafBySplit(leaf);
+  }
+
+  //3
+  if(leafLoc === "hover") {
+    const leaves = new Set<WorkspaceLeaf>();
+    app.workspace.iterateAllLeaves(l=>{
+      //@ts-ignore
+      if(l!==leaf && leaf.containerEl.parentElement === l.containerEl.parentElement) leaves.add(l);
+    })
+    if(leaves.size === 0) {
+      return plugin.app.workspace.createLeafBySplit(leaf);      
+    }
+    return Array.from(leaves)[0];  
+  }
+
+  //4
+  if(leafLoc === "popout") {
+    const popoutLeaves = new Set<WorkspaceLeaf>();  
+    app.workspace.iterateAllLeaves(l=>{
+      if(l !== leaf && l.view.navigation && l.view.containerEl.ownerDocument === leaf.view.containerEl.ownerDocument) {
+        popoutLeaves.add(l);
+      }
+    });
+    if(popoutLeaves.size === 0) {
+      return app.workspace.createLeafBySplit(leaf);
+    }
+    return Array.from(popoutLeaves)[0];
+  }
 
   return plugin.app.workspace.createLeafBySplit(leaf);
 };
@@ -74,7 +144,7 @@ export const getAttachmentsFolderAndFilePath = async (
   if (!folder || folder === "/") {
     folder = "";
   }
-  await checkAndCreateFolder(app.vault, folder);
+  await checkAndCreateFolder(folder);
   return {
     folder,
     filepath: normalizePath(

src/utils/Utils.ts

@@ -16,6 +16,7 @@ import {
   FRONTMATTER_KEY_EXPORT_TRANSPARENT,
   FRONTMATTER_KEY_EXPORT_SVGPADDING,
   FRONTMATTER_KEY_EXPORT_PNGSCALE,
+  FRONTMATTER_KEY_EXPORT_PADDING,
 } from "../Constants";
 import ExcalidrawPlugin from "../main";
 import { ExcalidrawElement } from "@zsviczian/excalidraw/types/element/types";
@@ -69,7 +70,7 @@ export const checkExcalidrawVersion = async (app: App) => {
       .filter((el: any) => el.version.match(/^\d+\.\d+\.\d+$/))
       .sort((el1: any, el2: any) => el2.published - el1.published)[0].version;
 
-    if (latestVersion > PLUGIN_VERSION) {
+    if (isVersionNewerThanOther(latestVersion,PLUGIN_VERSION)) {
       new Notice(
         `A newer version of Excalidraw is available in Community Plugins.\n\nYou are using ${PLUGIN_VERSION}.\nThe latest is ${latestVersion}`,
       );
@@ -287,6 +288,7 @@ export const getSVG = async (
 export const getPNG = async (
   scene: any,
   exportSettings: ExportSettings,
+  padding: number,
   scale: number = 1,
 ) => {
   try {
@@ -300,6 +302,7 @@ export const getPNG = async (
         ...scene.appState,
       },
       files: scene.files,
+      exportPadding: padding,
       mimeType: "image/png",
       getDimensions: (width: number, height: number) => ({
         width: width * scale,
@@ -359,7 +362,7 @@ export const getImageSize = async (
 ): Promise<{ height: number; width: number }> => {
   return new Promise((resolve, reject) => {
     const img = new Image();
-    img.onload = () => resolve({ height: img.height, width: img.width });
+    img.onload = () => resolve({ height: img.naturalHeight, width: img.naturalWidth });
     img.onerror = reject;
     img.src = src;
   });
@@ -395,6 +398,19 @@ export const scaleLoadedImage = (
   }
 };
 
+export const setDocLeftHandedMode = (isLeftHanded: boolean, ownerDocument:Document) => {
+  const newStylesheet = ownerDocument.createElement("style");
+  newStylesheet.id = "excalidraw-left-handed";
+  newStylesheet.textContent = `.excalidraw .App-bottom-bar{justify-content:flex-end;}`;
+  const oldStylesheet = ownerDocument.getElementById(newStylesheet.id);
+  if (oldStylesheet) {
+    ownerDocument.head.removeChild(oldStylesheet);
+  }
+  if (isLeftHanded) {
+    ownerDocument.head.appendChild(newStylesheet);
+  }
+}
+
 export const setLeftHandedMode = (isLeftHanded: boolean) => {
   const visitedDocs = new Set<Document>();
   app.workspace.iterateAllLeaves((leaf) => {
@@ -402,17 +418,8 @@ export const setLeftHandedMode = (isLeftHanded: boolean) => {
     if(!ownerDocument) return;
     if(visitedDocs.has(ownerDocument)) return;
     visitedDocs.add(ownerDocument);
-    const newStylesheet = ownerDocument.createElement("style");
-    newStylesheet.id = "excalidraw-letf-handed";
-    newStylesheet.textContent = `.excalidraw .App-bottom-bar{justify-content:flex-end;}`;
-    const oldStylesheet = ownerDocument.getElementById(newStylesheet.id);
-    if (oldStylesheet) {
-      ownerDocument.head.removeChild(oldStylesheet);
-    }
-    if (isLeftHanded) {
-      ownerDocument.head.appendChild(newStylesheet);
-    }
-  })
+    setDocLeftHandedMode(isLeftHanded,ownerDocument);
+  })  
 };
 
 export type LinkParts = {
@@ -512,16 +519,25 @@ export const getWithBackground = (
   return plugin.settings.exportWithBackground;
 };
 
-export const getSVGPadding = (
+export const getExportPadding = (
   plugin: ExcalidrawPlugin,
   file: TFile,
 ): number => {
   if (file) {
     const fileCache = plugin.app.metadataCache.getFileCache(file);
-    if (
-      fileCache?.frontmatter &&
-      fileCache.frontmatter[FRONTMATTER_KEY_EXPORT_SVGPADDING] != null
-    ) {
+    if(!fileCache?.frontmatter) return plugin.settings.exportPaddingSVG;
+
+    if (fileCache.frontmatter[FRONTMATTER_KEY_EXPORT_PADDING] != null) {
+      const val = parseInt(
+        fileCache.frontmatter[FRONTMATTER_KEY_EXPORT_PADDING],
+      );
+      if (!isNaN(val)) {
+        return val;
+      }
+    }
+
+    //depricated. Retained for backward compatibility
+    if (fileCache.frontmatter[FRONTMATTER_KEY_EXPORT_SVGPADDING] != null) {
       const val = parseInt(
         fileCache.frontmatter[FRONTMATTER_KEY_EXPORT_SVGPADDING],
       );
@@ -529,6 +545,7 @@ export const getSVGPadding = (
         return val;
       }
     }
+    
   }
   return plugin.settings.exportPaddingSVG;
 };
@@ -551,12 +568,72 @@ export const getPNGScale = (plugin: ExcalidrawPlugin, file: TFile): number => {
   return plugin.settings.pngExportScale;
 };
 
+export const isVersionNewerThanOther = (version: string, otherVersion: string): boolean => {
+  const v = version.match(/(\d*)\.(\d*)\.(\d*)/);
+  const o = otherVersion.match(/(\d*)\.(\d*)\.(\d*)/);
+  
+  return Boolean(v && v.length === 4 && o && o.length === 4 &&
+    !(isNaN(parseInt(v[1])) || isNaN(parseInt(v[2])) || isNaN(parseInt(v[3]))) &&
+    !(isNaN(parseInt(o[1])) || isNaN(parseInt(o[2])) || isNaN(parseInt(o[3]))) && 
+    (
+      parseInt(v[1])>parseInt(o[1]) ||
+      (parseInt(v[1]) >= parseInt(o[1]) && parseInt(v[2]) > parseInt(o[2])) ||
+      (parseInt(v[1]) >= parseInt(o[1]) && parseInt(v[2]) >= parseInt(o[2]) && parseInt(v[3]) > parseInt(o[3]))
+    )
+  ) 
+}
+
+export const getEmbeddedFilenameParts = (fname:string):{
+  filepath: string,
+  hasBlockref: boolean,
+  hasGroupref: boolean,
+  hasArearef: boolean,
+  blockref: string,
+  hasSectionref: boolean,
+  sectionref: string,
+  linkpartReference: string,
+  linkpartAlias: string
+} => {
+  //                        0 1        23    4              5         6  7             8          9
+  const parts = fname?.match(/([^#\^]*)((#\^)(group=|area=)?([^\|]*)|(#)(group=|area=)?([^\^\|]*))(.*)/);
+  if(!parts) {
+    return {
+      filepath: fname,
+      hasBlockref: false,
+      hasGroupref: false,
+      hasArearef: false,
+      blockref: "",
+      hasSectionref: false,
+      sectionref: "",
+      linkpartReference: "",
+      linkpartAlias: ""
+    }
+  }
+  return {
+    filepath: parts[1],
+    hasBlockref: Boolean(parts[3]),
+    hasGroupref: (parts[4]==="group=") || (parts[7]==="group="),
+    hasArearef: (parts[4]==="area=") || (parts[7]==="area="),
+    blockref: parts[5],
+    hasSectionref: Boolean(parts[6]),
+    sectionref: parts[8],
+    linkpartReference: parts[2],
+    linkpartAlias: parts[9]
+  }
+}
+
 export const errorlog = (data: {}) => {
   console.error({ plugin: "Excalidraw", ...data });
 };
 
 export const sleep = async (ms: number) => new Promise((resolve) => setTimeout(resolve, ms));
 
+/**REACT 18 
+  //see also: https://github.com/zsviczian/obsidian-excalidraw-plugin/commit/b67d70c5196f30e2968f9da919d106ee66f2a5eb
+  //https://github.com/zsviczian/obsidian-excalidraw-plugin/commit/cc9d7828c7ee7755c1ef942519c43df32eae249f
+export const awaitNextAnimationFrame = async () => new Promise(requestAnimationFrame);
+*/
+
 export const log = console.log.bind(window.console);
 export const debug = console.log.bind(window.console);
 //export const debug = function(){};

styles.css

@@ -127,17 +127,22 @@ li[data-testid] {
   width: 100%;
 }
 
-.modal-content.excalidraw-scriptengine-install {
+.excalidraw-scriptengine-install .modal-content {
   max-width: 130ch;
   user-select: text;
 }
 
 .excalidraw-scriptengine-install .modal {
   max-height:90%;
+  width: auto;
 }
 
 .excalidraw-prompt-center {
-  text-align: center;
+  text-align: center !important;
+}
+
+.excalidraw-prompt-center button {
+  margin: 0 10px;
 }
 
 .excalidraw-prompt-center.filepath {
@@ -172,15 +177,16 @@ li[data-testid] {
   height: 100%;
 }
 
-.excalidraw-release {
+.excalidraw-release .modal-content{
   padding-right: 5px;
   margin-right: -5px;
-  max-width: 130ch;
   user-select: text;
 }
 
 .excalidraw-release .modal {
-  max-height:90%;
+  max-height: 90%;
+  width: auto;
+  max-width: 130ch;
 }
 
 .excalidraw .Island .scrollbar {
@@ -204,4 +210,17 @@ li[data-testid] {
 
 .excalidraw-release p>a>img {
   width: 100%
+}
+
+.excalidraw .context-menu-option {
+  box-shadow: none;
+}
+
+textarea.excalidraw-wysiwyg {
+  border: none;
+  outline: none;
+  -webkit-box-shadow: none;
+  -moz-box-shadow: none;
+  box-shadow: none;
+  border-radius: 0;  
 }

versions.json

@@ -1,4 +1,8 @@
 {
+  "1.7.13": "0.15.6",
+  "1.7.8": "0.15.5",
+  "1.7.7": "0.15.4",
+  "1.7.6": "0.15.3",
   "1.7.2": "0.15.2",
   "1.6.34": "0.12.16",
   "1.4.2": "0.11.13"